pod/perltoc.pod

   1
   2 =head1 NAME
   3
   4 perltoc - perl documentation table of contents
   5
   6 =head1 DESCRIPTION
   7
   8 This page provides a brief table of contents for the rest of the Perl
   9 documentation set.  It is meant to be scanned quickly or grepped
  10 through to locate the proper section you're looking for.
  11
  12 =head1 BASIC DOCUMENTATION
  13
  14 =head2 perl - Practical Extraction and Report Language
  15
  16 =over 4
  17
  18 =item SYNOPSIS
  19
  20 =over 4
  21
  22 =item Overview
  23
  24 =item Tutorials
  25
  26 =item Reference Manual
  27
  28 =item Internals and C Language Interface
  29
  30 =item Miscellaneous
  31
  32 =item Language-Specific
  33
  34 =item Platform-Specific
  35
  36 =back
  37
  38 =item DESCRIPTION
  39
  40 =item AVAILABILITY
  41
  42 =item ENVIRONMENT
  43
  44 =item AUTHOR
  45
  46 =item FILES
  47
  48 =item SEE ALSO
  49
  50 =item DIAGNOSTICS
  51
  52 =item BUGS
  53
  54 =item NOTES
  55
  56 =back
  57
  58 =head2 perlintro -- a brief introduction and overview of Perl
  59
  60 =over 4
  61
  62 =item DESCRIPTION
  63
  64 =over 4
  65
  66 =item What is Perl?
  67
  68 =item Running Perl programs
  69
  70 =item Basic syntax overview
  71
  72 =item Perl variable types
  73
  74 Scalars, Arrays, Hashes
  75
  76 =item Variable scoping
  77
  78 =item Conditional and looping constructs
  79
  80 if, while, for, foreach
  81
  82 =item Builtin operators and functions
  83
  84 Arithmetic, Numeric comparison, String comparison, Boolean logic,
  85 Miscellaneous
  86
  87 =item Files and I/O
  88
  89 =item Regular expressions
  90
  91 Simple matching, Simple substitution, More complex regular expressions,
  92 Parentheses for capturing, Other regexp features
  93
  94 =item Writing subroutines
  95
  96 =item OO Perl
  97
  98 =item Using Perl modules
  99
 100 =back
 101
 102 =item AUTHOR
 103
 104 =back
 105
 106 =head2 perlfaq - frequently asked questions about Perl ($Date: 2002/03/11
 107 21:32:23 $)
 108
 109 =over 4
 110
 111 =item DESCRIPTION
 112
 113 =over 4
 114
 115 =item perlfaq: Structural overview of the FAQ.
 116
 117 =item L<perlfaq1>: General Questions About Perl
 118
 119 =item L<perlfaq2>: Obtaining and Learning about Perl
 120
 121 =item L<perlfaq3>: Programming Tools
 122
 123 =item L<perlfaq4>: Data Manipulation
 124
 125 =item L<perlfaq5>: Files and Formats
 126
 127 =item L<perlfaq6>: Regular Expressions
 128
 129 =item L<perlfaq7>: General Perl Language Issues
 130
 131 =item L<perlfaq8>: System Interaction
 132
 133 =item L<perlfaq9>: Networking
 134
 135 =back
 136
 137 =item About the perlfaq documents
 138
 139 =over 4
 140
 141 =item Where to get the perlfaq
 142
 143 =item How to contribute to the perlfaq
 144
 145 =item What will happen if you mail your Perl programming problems to the
 146 authors
 147
 148 =back
 149
 150 =item Credits
 151
 152 =item Author and Copyright Information
 153
 154 =over 4
 155
 156 =item Bundled Distributions
 157
 158 =item Disclaimer
 159
 160 =back
 161
 162 =item Changes
 163
 164 1/November/2000, 23/May/99, 13/April/99, 7/January/99, 22/June/98,
 165 24/April/97, 23/April/97, 25/March/97, 18/March/97, 17/March/97 Version,
 166 Initial Release: 11/March/97
 167
 168 =back
 169
 170 =head2 perlbook - Perl book information
 171
 172 =over 4
 173
 174 =item DESCRIPTION
 175
 176 =back
 177
 178 =head2 perlsyn - Perl syntax
 179
 180 =over 4
 181
 182 =item DESCRIPTION
 183
 184 =over 4
 185
 186 =item Declarations
 187
 188 =item Simple statements
 189
 190 =item Compound statements
 191
 192 =item Loop Control
 193
 194 =item For Loops
 195
 196 =item Foreach Loops
 197
 198 =item Basic BLOCKs and Switch Statements
 199
 200 =item Goto
 201
 202 =item PODs: Embedded Documentation
 203
 204 =item Plain Old Comments (Not!)
 205
 206 =back
 207
 208 =back
 209
 210 =head2 perldata - Perl data types
 211
 212 =over 4
 213
 214 =item DESCRIPTION
 215
 216 =over 4
 217
 218 =item Variable names
 219
 220 =item Context
 221
 222 =item Scalar values
 223
 224 =item Scalar value constructors
 225
 226 =item List value constructors
 227
 228 =item Slices
 229
 230 =item Typeglobs and Filehandles
 231
 232 =back
 233
 234 =item SEE ALSO
 235
 236 =back
 237
 238 =head2 perlop - Perl operators and precedence
 239
 240 =over 4
 241
 242 =item SYNOPSIS
 243
 244 =item DESCRIPTION
 245
 246 =over 4
 247
 248 =item Terms and List Operators (Leftward)
 249
 250 =item The Arrow Operator
 251
 252 =item Auto-increment and Auto-decrement
 253
 254 =item Exponentiation
 255
 256 =item Symbolic Unary Operators
 257
 258 =item Binding Operators
 259
 260 =item Multiplicative Operators
 261
 262 =item Additive Operators
 263
 264 =item Shift Operators
 265
 266 =item Named Unary Operators
 267
 268 =item Relational Operators
 269
 270 =item Equality Operators
 271
 272 =item Bitwise And
 273
 274 =item Bitwise Or and Exclusive Or
 275
 276 =item C-style Logical And
 277
 278 =item C-style Logical Or
 279
 280 =item Range Operators
 281
 282 =item Conditional Operator
 283
 284 =item Assignment Operators
 285
 286 =item Comma Operator
 287
 288 =item List Operators (Rightward)
 289
 290 =item Logical Not
 291
 292 =item Logical And
 293
 294 =item Logical or and Exclusive Or
 295
 296 =item C Operators Missing From Perl
 297
 298 unary &, unary *, (TYPE)
 299
 300 =item Quote and Quote-like Operators
 301
 302 =item Regexp Quote-Like Operators
 303
 304 ?PATTERN?, m/PATTERN/cgimosx, /PATTERN/cgimosx, q/STRING/, C<'STRING'>,
 305 qq/STRING/, "STRING", qr/STRING/imosx, qx/STRING/, `STRING`, qw/STRING/,
 306 s/PATTERN/REPLACEMENT/egimosx, tr/SEARCHLIST/REPLACEMENTLIST/cds,
 307 y/SEARCHLIST/REPLACEMENTLIST/cds, <<EOF
 308
 309 =item Gory details of parsing quoted constructs
 310
 311 Finding the end, Removal of backslashes before delimiters, Interpolation,
 312 C<<<'EOF'>, C<m''>, C<s'''>, C<tr///>, C<y///>, C<''>, C<q//>, C<"">,
 313 C<``>, C<qq//>, C<qx//>, C<< <file*glob> >>, C<?RE?>, C</RE/>, C<m/RE/>,
 314 C<s/RE/foo/>,, Interpolation of regular expressions, Optimization of
 315 regular expressions
 316
 317 =item I/O Operators
 318
 319 =item Constant Folding
 320
 321 =item Bitwise String Operators
 322
 323 =item Integer Arithmetic
 324
 325 =item Floating-point Arithmetic
 326
 327 =item Bigger Numbers
 328
 329 =back
 330
 331 =back
 332
 333 =head2 perlsub - Perl subroutines
 334
 335 =over 4
 336
 337 =item SYNOPSIS
 338
 339 =item DESCRIPTION
 340
 341 =over 4
 342
 343 =item Private Variables via my()
 344
 345 =item Persistent Private Variables
 346
 347 =item Temporary Values via local()
 348
 349 =item Lvalue subroutines
 350
 351 Lvalue subroutines are EXPERIMENTAL
 352
 353 =item Passing Symbol Table Entries (typeglobs)
 354
 355 =item When to Still Use local()
 356
 357 =item Pass by Reference
 358
 359 =item Prototypes
 360
 361 =item Constant Functions
 362
 363 =item Overriding Built-in Functions
 364
 365 =item Autoloading
 366
 367 =item Subroutine Attributes
 368
 369 =back
 370
 371 =item SEE ALSO
 372
 373 =back
 374
 375 =head2 perlfunc - Perl builtin functions
 376
 377 =over 4
 378
 379 =item DESCRIPTION
 380
 381 =over 4
 382
 383 =item Perl Functions by Category
 384
 385 Functions for SCALARs or strings, Regular expressions and pattern matching,
 386 Numeric functions, Functions for real @ARRAYs, Functions for list data,
 387 Functions for real %HASHes, Input and output functions, Functions for fixed
 388 length data or records, Functions for filehandles, files, or directories,
 389 Keywords related to the control flow of your perl program, Keywords related
 390 to scoping, Miscellaneous functions, Functions for processes and process
 391 groups, Keywords related to perl modules, Keywords related to classes and
 392 object-orientedness, Low-level socket functions, System V interprocess
 393 communication functions, Fetching user and group info, Fetching network
 394 info, Time-related functions, Functions new in perl5, Functions obsoleted
 395 in perl5
 396
 397 =item Portability
 398
 399 =item Alphabetical Listing of Perl Functions
 400
 401 I<-X> FILEHANDLE, I<-X> EXPR, I<-X>, abs VALUE, abs, accept
 402 NEWSOCKET,GENERICSOCKET, alarm SECONDS, alarm, atan2 Y,X, bind SOCKET,NAME,
 403 binmode FILEHANDLE, LAYER, binmode FILEHANDLE, bless REF,CLASSNAME, bless
 404 REF, caller EXPR, caller, chdir EXPR, chmod LIST, chomp VARIABLE, chomp(
 405 LIST ), chomp, chop VARIABLE, chop( LIST ), chop, chown LIST, chr NUMBER,
 406 chr, chroot FILENAME, chroot, close FILEHANDLE, close, closedir DIRHANDLE,
 407 connect SOCKET,NAME, continue BLOCK, cos EXPR, cos, crypt PLAINTEXT,SALT,
 408 dbmclose HASH, dbmopen HASH,DBNAME,MASK, defined EXPR, defined, delete
 409 EXPR, die LIST, do BLOCK, do SUBROUTINE(LIST), do EXPR, dump LABEL, dump,
 410 each HASH, eof FILEHANDLE, eof (), eof, eval EXPR, eval BLOCK, exec LIST,
 411 exec PROGRAM LIST, exists EXPR, exit EXPR, exp EXPR, exp, fcntl
 412 FILEHANDLE,FUNCTION,SCALAR, fileno FILEHANDLE, flock FILEHANDLE,OPERATION,
 413 fork, format, formline PICTURE,LIST, getc FILEHANDLE, getc, getlogin,
 414 getpeername SOCKET, getpgrp PID, getppid, getpriority WHICH,WHO, getpwnam
 415 NAME, getgrnam NAME, gethostbyname NAME, getnetbyname NAME, getprotobyname
 416 NAME, getpwuid UID, getgrgid GID, getservbyname NAME,PROTO, gethostbyaddr
 417 ADDR,ADDRTYPE, getnetbyaddr ADDR,ADDRTYPE, getprotobynumber NUMBER,
 418 getservbyport PORT,PROTO, getpwent, getgrent, gethostent, getnetent,
 419 getprotoent, getservent, setpwent, setgrent, sethostent STAYOPEN, setnetent
 420 STAYOPEN, setprotoent STAYOPEN, setservent STAYOPEN, endpwent, endgrent,
 421 endhostent, endnetent, endprotoent, endservent, getsockname SOCKET,
 422 getsockopt SOCKET,LEVEL,OPTNAME, glob EXPR, glob, gmtime EXPR, goto LABEL,
 423 goto EXPR, goto &NAME, grep BLOCK LIST, grep EXPR,LIST, hex EXPR, hex,
 424 import, index STR,SUBSTR,POSITION, index STR,SUBSTR, int EXPR, int, ioctl
 425 FILEHANDLE,FUNCTION,SCALAR, join EXPR,LIST, keys HASH, kill SIGNAL, LIST,
 426 last LABEL, last, lc EXPR, lc, lcfirst EXPR, lcfirst, length EXPR, length,
 427 link OLDFILE,NEWFILE, listen SOCKET,QUEUESIZE, local EXPR, localtime EXPR,
 428 lock THING, log EXPR, log, lstat EXPR, lstat, m//, map BLOCK LIST, map
 429 EXPR,LIST, mkdir FILENAME,MASK, mkdir FILENAME, msgctl ID,CMD,ARG, msgget
 430 KEY,FLAGS, msgrcv ID,VAR,SIZE,TYPE,FLAGS, msgsnd ID,MSG,FLAGS, my EXPR, my
 431 TYPE EXPR, my EXPR : ATTRS, my TYPE EXPR : ATTRS, next LABEL, next, no
 432 Module VERSION LIST, no Module VERSION, no Module LIST, no Module, oct
 433 EXPR, oct, open FILEHANDLE,EXPR, open FILEHANDLE,MODE,EXPR, open
 434 FILEHANDLE,MODE,EXPR,LIST, open FILEHANDLE,MODE,REFERENCE, open FILEHANDLE,
 435 opendir DIRHANDLE,EXPR, ord EXPR, ord, our EXPR, our EXPR TYPE, our EXPR :
 436 ATTRS, our TYPE EXPR : ATTRS, pack TEMPLATE,LIST, package NAMESPACE,
 437 package, pipe READHANDLE,WRITEHANDLE, pop ARRAY, pop, pos SCALAR, pos,
 438 print FILEHANDLE LIST, print LIST, print, printf FILEHANDLE FORMAT, LIST,
 439 printf FORMAT, LIST, prototype FUNCTION, push ARRAY,LIST, q/STRING/,
 440 qq/STRING/, qr/STRING/, qx/STRING/, qw/STRING/, quotemeta EXPR, quotemeta,
 441 rand EXPR, rand, read FILEHANDLE,SCALAR,LENGTH,OFFSET, read
 442 FILEHANDLE,SCALAR,LENGTH, readdir DIRHANDLE, readline EXPR, readlink EXPR,
 443 readlink, readpipe EXPR, recv SOCKET,SCALAR,LENGTH,FLAGS, redo LABEL, redo,
 444 ref EXPR, ref, rename OLDNAME,NEWNAME, require VERSION, require EXPR,
 445 require, reset EXPR, reset, return EXPR, return, reverse LIST, rewinddir
 446 DIRHANDLE, rindex STR,SUBSTR,POSITION, rindex STR,SUBSTR, rmdir FILENAME,
 447 rmdir, s///, scalar EXPR, seek FILEHANDLE,POSITION,WHENCE, seekdir
 448 DIRHANDLE,POS, select FILEHANDLE, select, select RBITS,WBITS,EBITS,TIMEOUT,
 449 semctl ID,SEMNUM,CMD,ARG, semget KEY,NSEMS,FLAGS, semop KEY,OPSTRING, send
 450 SOCKET,MSG,FLAGS,TO, send SOCKET,MSG,FLAGS, setpgrp PID,PGRP, setpriority
 451 WHICH,WHO,PRIORITY, setsockopt SOCKET,LEVEL,OPTNAME,OPTVAL, shift ARRAY,
 452 shift, shmctl ID,CMD,ARG, shmget KEY,SIZE,FLAGS, shmread ID,VAR,POS,SIZE,
 453 shmwrite ID,STRING,POS,SIZE, shutdown SOCKET,HOW, sin EXPR, sin, sleep
 454 EXPR, sleep, socket SOCKET,DOMAIN,TYPE,PROTOCOL, socketpair
 455 SOCKET1,SOCKET2,DOMAIN,TYPE,PROTOCOL, sort SUBNAME LIST, sort BLOCK LIST,
 456 sort LIST, splice ARRAY,OFFSET,LENGTH,LIST, splice ARRAY,OFFSET,LENGTH,
 457 splice ARRAY,OFFSET, splice ARRAY, split /PATTERN/,EXPR,LIMIT, split
 458 /PATTERN/,EXPR, split /PATTERN/, split, sprintf FORMAT, LIST, format
 459 parameter index, flags, vector flag, (minimum) width, precision, or maximum
 460 width, size, sqrt EXPR, sqrt, srand EXPR, srand, stat FILEHANDLE, stat
 461 EXPR, stat, study SCALAR, study, sub NAME BLOCK, sub NAME (PROTO) BLOCK,
 462 sub NAME : ATTRS BLOCK, sub NAME (PROTO) : ATTRS BLOCK, substr
 463 EXPR,OFFSET,LENGTH,REPLACEMENT, substr EXPR,OFFSET,LENGTH, substr
 464 EXPR,OFFSET, symlink OLDFILE,NEWFILE, syscall LIST, sysopen
 465 FILEHANDLE,FILENAME,MODE, sysopen FILEHANDLE,FILENAME,MODE,PERMS, sysread
 466 FILEHANDLE,SCALAR,LENGTH,OFFSET, sysread FILEHANDLE,SCALAR,LENGTH, sysseek
 467 FILEHANDLE,POSITION,WHENCE, system LIST, system PROGRAM LIST, syswrite
 468 FILEHANDLE,SCALAR,LENGTH,OFFSET, syswrite FILEHANDLE,SCALAR,LENGTH,
 469 syswrite FILEHANDLE,SCALAR, tell FILEHANDLE, tell, telldir DIRHANDLE, tie
 470 VARIABLE,CLASSNAME,LIST, tied VARIABLE, time, times, tr///, truncate
 471 FILEHANDLE,LENGTH, truncate EXPR,LENGTH, uc EXPR, uc, ucfirst EXPR,
 472 ucfirst, umask EXPR, umask, undef EXPR, undef, unlink LIST, unlink, unpack
 473 TEMPLATE,EXPR, untie VARIABLE, unshift ARRAY,LIST, use Module VERSION LIST,
 474 use Module VERSION, use Module LIST, use Module, use VERSION, utime LIST,
 475 values HASH, vec EXPR,OFFSET,BITS, wait, waitpid PID,FLAGS, wantarray, warn
 476 LIST, write FILEHANDLE, write EXPR, write, y///
 477
 478 =back
 479
 480 =back
 481
 482 =head2 perlreftut - Mark's very short tutorial about references
 483
 484 =over 4
 485
 486 =item DESCRIPTION
 487
 488 =item Who Needs Complicated Data Structures?
 489
 490 =item The Solution
 491
 492 =item Syntax
 493
 494 =over 4
 495
 496 =item Making References
 497
 498 =item Using References
 499
 500 =back
 501
 502 =item An Example
 503
 504 =item Arrow Rule
 505
 506 =item Solution
 507
 508 =item The Rest
 509
 510 =item Summary
 511
 512 =item Credits
 513
 514 =over 4
 515
 516 =item Distribution Conditions
 517
 518 =back
 519
 520 =back
 521
 522 =head2 perldsc - Perl Data Structures Cookbook
 523
 524 =over 4
 525
 526 =item DESCRIPTION
 527
 528 arrays of arrays, hashes of arrays, arrays of hashes, hashes of hashes,
 529 more elaborate constructs
 530
 531 =item REFERENCES
 532
 533 =item COMMON MISTAKES
 534
 535 =item CAVEAT ON PRECEDENCE
 536
 537 =item WHY YOU SHOULD ALWAYS C<use strict>
 538
 539 =item DEBUGGING
 540
 541 =item CODE EXAMPLES
 542
 543 =item ARRAYS OF ARRAYS
 544
 545 =over 4
 546
 547 =item Declaration of an ARRAY OF ARRAYS
 548
 549 =item Generation of an ARRAY OF ARRAYS
 550
 551 =item Access and Printing of an ARRAY OF ARRAYS
 552
 553 =back
 554
 555 =item HASHES OF ARRAYS
 556
 557 =over 4
 558
 559 =item Declaration of a HASH OF ARRAYS
 560
 561 =item Generation of a HASH OF ARRAYS
 562
 563 =item Access and Printing of a HASH OF ARRAYS
 564
 565 =back
 566
 567 =item ARRAYS OF HASHES
 568
 569 =over 4
 570
 571 =item Declaration of an ARRAY OF HASHES
 572
 573 =item Generation of an ARRAY OF HASHES
 574
 575 =item Access and Printing of an ARRAY OF HASHES
 576
 577 =back
 578
 579 =item HASHES OF HASHES
 580
 581 =over 4
 582
 583 =item Declaration of a HASH OF HASHES
 584
 585 =item Generation of a HASH OF HASHES
 586
 587 =item Access and Printing of a HASH OF HASHES
 588
 589 =back
 590
 591 =item MORE ELABORATE RECORDS
 592
 593 =over 4
 594
 595 =item Declaration of MORE ELABORATE RECORDS
 596
 597 =item Declaration of a HASH OF COMPLEX RECORDS
 598
 599 =item Generation of a HASH OF COMPLEX RECORDS
 600
 601 =back
 602
 603 =item Database Ties
 604
 605 =item SEE ALSO
 606
 607 =item AUTHOR
 608
 609 =back
 610
 611 =head2 perlrequick - Perl regular expressions quick start
 612
 613 =over 4
 614
 615 =item DESCRIPTION
 616
 617 =item The Guide
 618
 619 =over 4
 620
 621 =item Simple word matching
 622
 623 =item Using character classes
 624
 625 =item Matching this or that
 626
 627 =item Grouping things and hierarchical matching
 628
 629 =item Extracting matches
 630
 631 =item Matching repetitions
 632
 633 =item More matching
 634
 635 =item Search and replace
 636
 637 =item The split operator
 638
 639 =back
 640
 641 =item BUGS
 642
 643 =item SEE ALSO
 644
 645 =item AUTHOR AND COPYRIGHT
 646
 647 =over 4
 648
 649 =item Acknowledgments
 650
 651 =back
 652
 653 =back
 654
 655 =head2 perlpod - the Plain Old Documentation format
 656
 657 =over 4
 658
 659 =item DESCRIPTION
 660
 661 =over 4
 662
 663 =item Ordinary Paragraph
 664
 665 =item Verbatim Paragraph
 666
 667 =item Command Paragraph
 668
 669 C<=head1 I<Heading Text>>, C<=head2 I<Heading Text>>, C<=head3 I<Heading
 670 Text>>, C<=head4 I<Heading Text>>, C<=over I<indentlevel>>, C<=item
 671 I<stuff...>>, C<=back>, C<=cut>, C<=pod>, C<=begin I<formatname>>, C<=end
 672 I<formatname>>, C<=for I<formatname> I<text...>>
 673
 674 =item Formatting Codes
 675
 676 C<IE<lt>textE<gt>> -- italic text, C<BE<lt>textE<gt>> -- bold text,
 677 C<CE<lt>codeE<gt>> -- code text, C<LE<lt>nameE<gt>> -- a hyperlink,
 678 C<EE<lt>escapeE<gt>> -- a character escape, C<FE<lt>filenameE<gt>> -- used
 679 for filenames, C<SE<lt>textE<gt>> -- text contains non-breaking spaces,
 680 C<XE<lt>topic nameE<gt>> -- an index entry, C<ZE<lt>E<gt>> -- a null
 681 (zero-effect) formatting code
 682
 683 =item The Intent
 684
 685 =item Embedding Pods in Perl Modules
 686
 687 =item Hints for Writing Pod
 688
 689 =back
 690
 691 =item SEE ALSO
 692
 693 =item AUTHOR
 694
 695 =back
 696
 697 =head2 perlpodspec - Plain Old Documentation: format specification and
 698 notes
 699
 700 =over 4
 701
 702 =item DESCRIPTION
 703
 704 =item Pod Definitions
 705
 706 =item Pod Commands
 707
 708 "=head1", "=head2", "=head3", "=head4", "=pod", "=cut", "=over", "=item",
 709 "=back", "=begin formatname", "=end formatname", "=for formatname text..."
 710
 711 =item Pod Formatting Codes
 712
 713 C<IE<lt>textE<gt>> -- italic text, C<BE<lt>textE<gt>> -- bold text,
 714 C<CE<lt>codeE<gt>> -- code text, C<FE<lt>filenameE<gt>> -- style for
 715 filenames, C<XE<lt>topic nameE<gt>> -- an index entry, C<ZE<lt>E<gt>> -- a
 716 null (zero-effect) formatting code, C<LE<lt>nameE<gt>> -- a hyperlink,
 717 C<EE<lt>escapeE<gt>> -- a character escape, C<SE<lt>textE<gt>> -- text
 718 contains non-breaking spaces
 719
 720 =item Notes on Implementing Pod Processors
 721
 722 =item About LE<lt>...E<gt> Codes
 723
 724 First:, Second:, Third:, Fourth:, Fifth:, Sixth:
 725
 726 =item About =over...=back Regions
 727
 728 =item About Data Paragraphs and "=begin/=end" Regions
 729
 730 =item SEE ALSO
 731
 732 =item AUTHOR
 733
 734 =back
 735
 736 =head2 perlstyle - Perl style guide
 737
 738 =over 4
 739
 740 =item DESCRIPTION
 741
 742 =back
 743
 744 =head2 perltrap - Perl traps for the unwary
 745
 746 =over 4
 747
 748 =item DESCRIPTION
 749
 750 =over 4
 751
 752 =item Awk Traps
 753
 754 =item C Traps
 755
 756 =item Sed Traps
 757
 758 =item Shell Traps
 759
 760 =item Perl Traps
 761
 762 =item Perl4 to Perl5 Traps
 763
 764 Discontinuance, Deprecation, and BugFix traps, Parsing Traps, Numerical
 765 Traps, General data type traps, Context Traps - scalar, list contexts,
 766 Precedence Traps, General Regular Expression Traps using s///, etc,
 767 Subroutine, Signal, Sorting Traps, OS Traps, DBM Traps, Unclassified Traps
 768
 769 =item Discontinuance, Deprecation, and BugFix traps
 770
 771 Discontinuance, Deprecation, BugFix, Discontinuance, Discontinuance,
 772 Discontinuance, BugFix, Discontinuance, Discontinuance, BugFix,
 773 Discontinuance, Deprecation, Discontinuance, Discontinuance
 774
 775 =item Parsing Traps
 776
 777 Parsing, Parsing, Parsing, Parsing, Parsing
 778
 779 =item Numerical Traps
 780
 781 Numerical, Numerical, Numerical, Bitwise string ops
 782
 783 =item General data type traps
 784
 785 (Arrays), (Arrays), (Hashes), (Globs), (Globs), (Scalar String),
 786 (Constants), (Scalars), (Variable Suicide)
 787
 788 =item Context Traps - scalar, list contexts
 789
 790 (list context), (scalar context), (scalar context), (list, builtin)
 791
 792 =item Precedence Traps
 793
 794 Precedence, Precedence, Precedence, Precedence, Precedence, Precedence,
 795 Precedence
 796
 797 =item General Regular Expression Traps using s///, etc.
 798
 799 Regular Expression, Regular Expression, Regular Expression, Regular
 800 Expression, Regular Expression, Regular Expression, Regular Expression,
 801 Regular Expression
 802
 803 =item Subroutine, Signal, Sorting Traps
 804
 805 (Signals), (Sort Subroutine), warn() won't let you specify a filehandle
 806
 807 =item OS Traps
 808
 809 (SysV), (SysV)
 810
 811 =item Interpolation Traps
 812
 813 Interpolation, Interpolation, Interpolation, Interpolation, Interpolation,
 814 Interpolation, Interpolation, Interpolation, Interpolation
 815
 816 =item DBM Traps
 817
 818 DBM, DBM
 819
 820 =item Unclassified Traps
 821
 822 C<require>/C<do> trap using returned value, C<split> on empty string with
 823 LIMIT specified
 824
 825 =back
 826
 827 =back
 828
 829 =head2 perlrun - how to execute the Perl interpreter
 830
 831 =over 4
 832
 833 =item SYNOPSIS
 834
 835 =item DESCRIPTION
 836
 837 =over 4
 838
 839 =item #! and quoting on non-Unix systems
 840
 841 OS/2, MS-DOS, Win95/NT, Macintosh, VMS
 842
 843 =item Location of Perl
 844
 845 =item Command Switches
 846
 847 B<-0>[I<digits>], B<-a>, B<-C>, B<-c>, B<-d>, B<-d:>I<foo[=bar,baz]>,
 848 B<-D>I<letters>, B<-D>I<number>, B<-e> I<commandline>, B<-F>I<pattern>,
 849 B<-h>, B<-i>[I<extension>], B<-I>I<directory>, B<-l>[I<octnum>],
 850 B<-m>[B<->]I<module>, B<-M>[B<->]I<module>, B<-M>[B<->]I<'module ...'>,
 851 B<-[mM]>[B<->]I<module=arg[,arg]...>, B<-n>, B<-p>, B<-P>, B<-s>, B<-S>,
 852 B<-t>, B<-T>, B<-u>, B<-U>, B<-v>, B<-V>, B<-V:>I<name>, B<-w>, B<-W>,
 853 B<-X>, B<-x> I<directory>
 854
 855 =back
 856
 857 =item ENVIRONMENT
 858
 859 HOME, LOGDIR, PATH, PERL5LIB, PERL5OPT, PERLIO, :bytes, :crlf, :mmap,
 860 :perlio, :raw, :stdio, :unix, :utf8, :win32, PERLIO_DEBUG, PERLLIB,
 861 PERL5DB, PERL5SHELL (specific to the Win32 port), PERL_DEBUG_MSTATS,
 862 PERL_DESTRUCT_LEVEL, PERL_ENCODING, PERL_ROOT (specific to the VMS port),
 863 SYS$LOGIN (specific to the VMS port)
 864
 865 =back
 866
 867 =head2 perldiag - various Perl diagnostics
 868
 869 =over 4
 870
 871 =item DESCRIPTION
 872
 873 =back
 874
 875 =head2 perllexwarn - Perl Lexical Warnings
 876
 877 =over 4
 878
 879 =item DESCRIPTION
 880
 881 =over 4
 882
 883 =item Default Warnings and Optional Warnings
 884
 885 =item What's wrong with B<-w> and C<$^W>
 886
 887 =item Controlling Warnings from the Command Line
 888
 889 B<-w>, B<-W>, B<-X>
 890
 891 =item Backward Compatibility
 892
 893 =item Category Hierarchy
 894
 895 =item Fatal Warnings
 896
 897 =item Reporting Warnings from a Module
 898
 899 =back
 900
 901 =item TODO
 902
 903 =item SEE ALSO
 904
 905 =item AUTHOR
 906
 907 =back
 908
 909 =head2 perldebtut - Perl debugging tutorial
 910
 911 =over 4
 912
 913 =item DESCRIPTION
 914
 915 =item use strict
 916
 917 =item Looking at data and -w and v
 918
 919 =item help
 920
 921 =item Stepping through code
 922
 923 =item Placeholder for a, w, t, T
 924
 925 =item REGULAR EXPRESSIONS
 926
 927 =item OUTPUT TIPS
 928
 929 =item CGI
 930
 931 =item GUIs
 932
 933 =item SUMMARY
 934
 935 =item SEE ALSO
 936
 937 =item AUTHOR
 938
 939 =item CONTRIBUTORS
 940
 941 =back
 942
 943 =head2 perldebug - Perl debugging
 944
 945 =over 4
 946
 947 =item DESCRIPTION
 948
 949 =item The Perl Debugger
 950
 951 =over 4
 952
 953 =item Debugger Commands
 954
 955 h, h [command], h h, p expr, x [maxdepth] expr, V [pkg [vars]], X [vars], y
 956 [level [vars]], T, s [expr], n [expr], r, <CR>, c [line|sub], l, l
 957 min+incr, l min-max, l line, l subname, -, v [line], f filename, /pattern/,
 958 ?pattern?, L [abw], S [[!]regex], t, t expr, b, b [line] [condition], b
 959 subname [condition], b postpone subname [condition], b load filename, b
 960 compile subname, B line, B *, a [line] command, A line, A *, w expr, W
 961 expr, W *, o, o booloption .., o anyoption? .., o option=value .., < ?, < [
 962 command ], << command, > ?, > command, >> command, { ?, { [ command ], {{
 963 command, ! number, ! -number, ! pattern, !! cmd, source file, H -number, q
 964 or ^D, R, |dbcmd, ||dbcmd, command, m expr, M, man [manpage]
 965
 966 =item Configurable Options
 967
 968 C<recallCommand>, C<ShellBang>, C<pager>, C<tkRunning>, C<signalLevel>,
 969 C<warnLevel>, C<dieLevel>, C<AutoTrace>, C<LineInfo>, C<inhibit_exit>,
 970 C<PrintRet>, C<ornaments>, C<frame>, C<maxTraceLen>, C<windowSize>,
 971 C<arrayDepth>, C<hashDepth>, C<dumpDepth>, C<compactDump>, C<veryCompact>,
 972 C<globPrint>, C<DumpDBFiles>, C<DumpPackages>, C<DumpReused>, C<quote>,
 973 C<HighBit>, C<undefPrint>, C<UsageOnly>, C<TTY>, C<noTTY>, C<ReadLine>,
 974 C<NonStop>
 975
 976 =item Debugger input/output
 977
 978 Prompt, Multiline commands, Stack backtrace, Line Listing Format, Frame
 979 listing
 980
 981 =item Debugging compile-time statements
 982
 983 =item Debugger Customization
 984
 985 =item Readline Support
 986
 987 =item Editor Support for Debugging
 988
 989 =item The Perl Profiler
 990
 991 =back
 992
 993 =item Debugging regular expressions
 994
 995 =item Debugging memory usage
 996
 997 =item SEE ALSO
 998
 999 =item BUGS
1000
1001 =back
1002
1003 =head2 perlvar - Perl predefined variables
1004
1005 =over 4
1006
1007 =item DESCRIPTION
1008
1009 =over 4
1010
1011 =item Predefined Names
1012
1013 $ARG, $_, $a, $b, $<I<digits>>, $MATCH, $&, $PREMATCH, $`, $POSTMATCH, $',
1014 $LAST_PAREN_MATCH, $+, $^N, @LAST_MATCH_END, @+, $MULTILINE_MATCHING, $*,
1015 HANDLE->input_line_number(EXPR), $INPUT_LINE_NUMBER, $NR, $,
1016 IO::Handle->input_record_separator(EXPR), $INPUT_RECORD_SEPARATOR, $RS, $/,
1017 HANDLE->autoflush(EXPR), $OUTPUT_AUTOFLUSH, $|,
1018 IO::Handle->output_field_separator EXPR, $OUTPUT_FIELD_SEPARATOR, $OFS, $,,
1019 IO::Handle->output_record_separator EXPR, $OUTPUT_RECORD_SEPARATOR, $ORS,
1020 $\, $LIST_SEPARATOR, $", $SUBSCRIPT_SEPARATOR, $SUBSEP, $;, $OFMT, $#,
1021 HANDLE->format_page_number(EXPR), $FORMAT_PAGE_NUMBER, $%,
1022 HANDLE->format_lines_per_page(EXPR), $FORMAT_LINES_PER_PAGE, $=,
1023 HANDLE->format_lines_left(EXPR), $FORMAT_LINES_LEFT, $-, @LAST_MATCH_START,
1024 @-, C<$`> is the same as C<substr($var, 0, $-[0])>, C<$&> is the same as
1025 C<substr($var, $-[0], $+[0] - $-[0])>, C<$'> is the same as C<substr($var,
1026 $+[0])>, C<$1> is the same as C<substr($var, $-[1], $+[1] - $-[1])>, C<$2>
1027 is the same as C<substr($var, $-[2], $+[2] - $-[2])>, C<$3> is the same as
1028 C<substr $var, $-[3], $+[3] - $-[3])>, HANDLE->format_name(EXPR),
1029 $FORMAT_NAME, $~, HANDLE->format_top_name(EXPR), $FORMAT_TOP_NAME, $^,
1030 IO::Handle->format_line_break_characters EXPR,
1031 $FORMAT_LINE_BREAK_CHARACTERS, $:, IO::Handle->format_formfeed EXPR,
1032 $FORMAT_FORMFEED, $^L, $ACCUMULATOR, $^A, $CHILD_ERROR, $?, ${^ENCODING},
1033 $OS_ERROR, $ERRNO, $!, %!, $EXTENDED_OS_ERROR, $^E, $EVAL_ERROR, $@,
1034 $PROCESS_ID, $PID, $$, $REAL_USER_ID, $UID, $<, $EFFECTIVE_USER_ID, $EUID,
1035 $>, $REAL_GROUP_ID, $GID, $(, $EFFECTIVE_GROUP_ID, $EGID, $),
1036 $PROGRAM_NAME, $0, $[, $], $COMPILING, $^C, $DEBUGGING, $^D,
1037 $SYSTEM_FD_MAX, $^F, $^H, %^H, $INPLACE_EDIT, $^I, $^M, $OSNAME, $^O,
1038 ${^OPEN}, $PERLDB, $^P, 0x01, 0x02, 0x04, 0x08, 0x10, 0x20, 0x40, 0x80,
1039 0x100, 0x200, $LAST_REGEXP_CODE_RESULT, $^R, $EXCEPTIONS_BEING_CAUGHT, $^S,
1040 $BASETIME, $^T, ${^TAINT}, $PERL_VERSION, $^V, $WARNING, $^W,
1041 ${^WARNING_BITS}, ${^WIDE_SYSTEM_CALLS}, $EXECUTABLE_NAME, $^X, ARGV,
1042 $ARGV, @ARGV, @F, @INC, @_, %INC, %ENV, $ENV{expr}, %SIG, $SIG{expr}
1043
1044 =item Error Indicators
1045
1046 =item Technical Note on the Syntax of Variable Names
1047
1048 =back
1049
1050 =item BUGS
1051
1052 =back
1053
1054 =head2 perllol - Manipulating Arrays of Arrays in Perl
1055
1056 =over 4
1057
1058 =item DESCRIPTION
1059
1060 =over 4
1061
1062 =item Declaration and Access of Arrays of Arrays
1063
1064 =item Growing Your Own
1065
1066 =item Access and Printing
1067
1068 =item Slices
1069
1070 =back
1071
1072 =item SEE ALSO
1073
1074 =item AUTHOR
1075
1076 =back
1077
1078 =head2 perlopentut - tutorial on opening things in Perl
1079
1080 =over 4
1081
1082 =item DESCRIPTION
1083
1084 =item Open E<agrave> la shell
1085
1086 =over 4
1087
1088 =item Simple Opens
1089
1090 =item Pipe Opens
1091
1092 =item The Minus File
1093
1094 =item Mixing Reads and Writes
1095
1096 =item Filters
1097
1098 =back
1099
1100 =item Open E<agrave> la C
1101
1102 =over 4
1103
1104 =item Permissions E<agrave> la mode
1105
1106 =back
1107
1108 =item Obscure Open Tricks
1109
1110 =over 4
1111
1112 =item Re-Opening Files (dups)
1113
1114 =item Dispelling the Dweomer
1115
1116 =item Paths as Opens
1117
1118 =item Single Argument Open
1119
1120 =item Playing with STDIN and STDOUT
1121
1122 =back
1123
1124 =item Other I/O Issues
1125
1126 =over 4
1127
1128 =item Opening Non-File Files
1129
1130 =item Binary Files
1131
1132 =item File Locking
1133
1134 =item IO Layers
1135
1136 =back
1137
1138 =item SEE ALSO
1139
1140 =item AUTHOR and COPYRIGHT
1141
1142 =item HISTORY
1143
1144 =back
1145
1146 =head2 perlpacktut - tutorial on C<pack> and C<unpack>
1147
1148 =over 4
1149
1150 =item DESCRIPTION
1151
1152 =item The Basic Principle
1153
1154 =item Packing Text
1155
1156 =item Packing Numbers
1157
1158 =over 4
1159
1160 =item Integers
1161
1162 =item Unpacking a Stack Frame
1163
1164 =item How to Eat an Egg on a Net
1165
1166 =item Floating point Numbers
1167
1168 =back
1169
1170 =item Exotic Templates
1171
1172 =over 4
1173
1174 =item Bit Strings
1175
1176 =item Uuencoding
1177
1178 =item Doing Sums
1179
1180 =item  Unicode
1181
1182 =item Another Portable Binary Encoding
1183
1184 =back
1185
1186 =item Lengths and Widths
1187
1188 =over 4
1189
1190 =item String Lengths
1191
1192 =item Dynamic Templates
1193
1194 =back
1195
1196 =item Packing and Unpacking C Structures
1197
1198 =over 4
1199
1200 =item The Alignment Pit
1201
1202 =item Alignment, Take 2
1203
1204 =item Alignment, Take 3
1205
1206 =item Pointers for How to Use Them
1207
1208 =back
1209
1210 =item Pack Recipes
1211
1212 =item Funnies Section
1213
1214 =item Authors
1215
1216 =back
1217
1218 =head2 perlretut - Perl regular expressions tutorial
1219
1220 =over 4
1221
1222 =item DESCRIPTION
1223
1224 =item Part 1: The basics
1225
1226 =over 4
1227
1228 =item Simple word matching
1229
1230 =item Using character classes
1231
1232 =item Matching this or that
1233
1234 =item Grouping things and hierarchical matching
1235
1236 =item Extracting matches
1237
1238 =item Matching repetitions
1239
1240 =item Building a regexp
1241
1242 =item Using regular expressions in Perl
1243
1244 =back
1245
1246 =item Part 2: Power tools
1247
1248 =over 4
1249
1250 =item More on characters, strings, and character classes
1251
1252 =item Compiling and saving regular expressions
1253
1254 =item Embedding comments and modifiers in a regular expression
1255
1256 =item Non-capturing groupings
1257
1258 =item Looking ahead and looking behind
1259
1260 =item Using independent subexpressions to prevent backtracking
1261
1262 =item Conditional expressions
1263
1264 =item A bit of magic: executing Perl code in a regular expression
1265
1266 =item Pragmas and debugging
1267
1268 =back
1269
1270 =item BUGS
1271
1272 =item SEE ALSO
1273
1274 =item AUTHOR AND COPYRIGHT
1275
1276 =over 4
1277
1278 =item Acknowledgments
1279
1280 =back
1281
1282 =back
1283
1284 =head2 perlre - Perl regular expressions
1285
1286 =over 4
1287
1288 =item DESCRIPTION
1289
1290 i, m, s, x
1291
1292 =over 4
1293
1294 =item Regular Expressions
1295
1296 [1], [2], [3], cntrl, graph, print, punct, xdigit
1297
1298 =item Extended Patterns
1299
1300 C<(?#text)>, C<(?imsx-imsx)>, C<(?:pattern)>, C<(?imsx-imsx:pattern)>,
1301 C<(?=pattern)>, C<(?!pattern)>, C<(?<=pattern)>, C<(?<!pattern)>, C<(?{
1302 code })>, C<(??{ code })>, C<< (?>pattern) >>,
1303 C<(?(condition)yes-pattern|no-pattern)>, C<(?(condition)yes-pattern)>
1304
1305 =item Backtracking
1306
1307 =item Version 8 Regular Expressions
1308
1309 =item Warning on \1 vs $1
1310
1311 =item Repeated patterns matching zero-length substring
1312
1313 =item Combining pieces together
1314
1315 C<ST>, C<S|T>, C<S{REPEAT_COUNT}>, C<S{min,max}>, C<S{min,max}?>, C<S?>,
1316 C<S*>, C<S+>, C<S??>, C<S*?>, C<S+?>, C<< (?>S) >>, C<(?=S)>, C<(?<=S)>,
1317 C<(?!S)>, C<(?<!S)>, C<(??{ EXPR })>,
1318 C<(?(condition)yes-pattern|no-pattern)>
1319
1320 =item Creating custom RE engines
1321
1322 =back
1323
1324 =item BUGS
1325
1326 =item SEE ALSO
1327
1328 =back
1329
1330 =head2 perlref - Perl references and nested data structures
1331
1332 =over 4
1333
1334 =item NOTE
1335
1336 =item DESCRIPTION
1337
1338 =over 4
1339
1340 =item Making References
1341
1342 =item Using References
1343
1344 =item Symbolic references
1345
1346 =item Not-so-symbolic references
1347
1348 =item Pseudo-hashes: Using an array as a hash
1349
1350 =item Function Templates
1351
1352 =back
1353
1354 =item WARNING
1355
1356 =item SEE ALSO
1357
1358 =back
1359
1360 =head2 perlform - Perl formats
1361
1362 =over 4
1363
1364 =item DESCRIPTION
1365
1366 =over 4
1367
1368 =item Format Variables
1369
1370 =back
1371
1372 =item NOTES
1373
1374 =over 4
1375
1376 =item Footers
1377
1378 =item Accessing Formatting Internals
1379
1380 =back
1381
1382 =item WARNINGS
1383
1384 =back
1385
1386 =head2 perlboot - Beginner's Object-Oriented Tutorial
1387
1388 =over 4
1389
1390 =item DESCRIPTION
1391
1392 =over 4
1393
1394 =item If we could talk to the animals...
1395
1396 =item Introducing the method invocation arrow
1397
1398 =item Invoking a barnyard
1399
1400 =item The extra parameter of method invocation
1401
1402 =item Calling a second method to simplify things
1403
1404 =item Inheriting the windpipes
1405
1406 =item A few notes about @ISA
1407
1408 =item Overriding the methods
1409
1410 =item Starting the search from a different place
1411
1412 =item The SUPER way of doing things
1413
1414 =item Where we're at so far...
1415
1416 =item A horse is a horse, of course of course -- or is it?
1417
1418 =item Invoking an instance method
1419
1420 =item Accessing the instance data
1421
1422 =item How to build a horse
1423
1424 =item Inheriting the constructor
1425
1426 =item Making a method work with either classes or instances
1427
1428 =item Adding parameters to a method
1429
1430 =item More interesting instances
1431
1432 =item A horse of a different color
1433
1434 =item Summary
1435
1436 =back
1437
1438 =item SEE ALSO
1439
1440 =item COPYRIGHT
1441
1442 =back
1443
1444 =head2 perltoot - Tom's object-oriented tutorial for perl
1445
1446 =over 4
1447
1448 =item DESCRIPTION
1449
1450 =item Creating a Class
1451
1452 =over 4
1453
1454 =item Object Representation
1455
1456 =item Class Interface
1457
1458 =item Constructors and Instance Methods
1459
1460 =item Planning for the Future: Better Constructors
1461
1462 =item Destructors
1463
1464 =item Other Object Methods
1465
1466 =back
1467
1468 =item Class Data
1469
1470 =over 4
1471
1472 =item Accessing Class Data
1473
1474 =item Debugging Methods
1475
1476 =item Class Destructors
1477
1478 =item Documenting the Interface
1479
1480 =back
1481
1482 =item Aggregation
1483
1484 =item Inheritance
1485
1486 =over 4
1487
1488 =item Overridden Methods
1489
1490 =item Multiple Inheritance
1491
1492 =item UNIVERSAL: The Root of All Objects
1493
1494 =back
1495
1496 =item Alternate Object Representations
1497
1498 =over 4
1499
1500 =item Arrays as Objects
1501
1502 =item Closures as Objects
1503
1504 =back
1505
1506 =item AUTOLOAD: Proxy Methods
1507
1508 =over 4
1509
1510 =item Autoloaded Data Methods
1511
1512 =item Inherited Autoloaded Data Methods
1513
1514 =back
1515
1516 =item Metaclassical Tools
1517
1518 =over 4
1519
1520 =item Class::Struct
1521
1522 =item Data Members as Variables
1523
1524 =back
1525
1526 =item NOTES
1527
1528 =over 4
1529
1530 =item Object Terminology
1531
1532 =back
1533
1534 =item SEE ALSO
1535
1536 =item AUTHOR AND COPYRIGHT
1537
1538 =item COPYRIGHT
1539
1540 =over 4
1541
1542 =item Acknowledgments
1543
1544 =back
1545
1546 =back
1547
1548 =head2 perltooc - Tom's OO Tutorial for Class Data in Perl
1549
1550 =over 4
1551
1552 =item DESCRIPTION
1553
1554 =item Class Data in a Can
1555
1556 =item Class Data as Package Variables
1557
1558 =over 4
1559
1560 =item Putting All Your Eggs in One Basket
1561
1562 =item Inheritance Concerns
1563
1564 =item The Eponymous Meta-Object
1565
1566 =item Indirect References to Class Data
1567
1568 =item Monadic Classes
1569
1570 =item Translucent Attributes
1571
1572 =back
1573
1574 =item Class Data as Lexical Variables
1575
1576 =over 4
1577
1578 =item Privacy and Responsibility
1579
1580 =item File-Scoped Lexicals
1581
1582 =item More Inheritance Concerns
1583
1584 =item Locking the Door and Throwing Away the Key
1585
1586 =item Translucency Revisited
1587
1588 =back
1589
1590 =item NOTES
1591
1592 =item SEE ALSO
1593
1594 =item AUTHOR AND COPYRIGHT
1595
1596 =item ACKNOWLEDGEMENTS
1597
1598 =item HISTORY
1599
1600 =back
1601
1602 =head2 perlobj - Perl objects
1603
1604 =over 4
1605
1606 =item DESCRIPTION
1607
1608 =over 4
1609
1610 =item An Object is Simply a Reference
1611
1612 =item A Class is Simply a Package
1613
1614 =item A Method is Simply a Subroutine
1615
1616 =item Method Invocation
1617
1618 =item Indirect Object Syntax
1619
1620 =item Default UNIVERSAL methods
1621
1622 isa(CLASS), can(METHOD), VERSION( [NEED] )
1623
1624 =item Destructors
1625
1626 =item Summary
1627
1628 =item Two-Phased Garbage Collection
1629
1630 =back
1631
1632 =item SEE ALSO
1633
1634 =back
1635
1636 =head2 perlbot - Bag'o Object Tricks (the BOT)
1637
1638 =over 4
1639
1640 =item DESCRIPTION
1641
1642 =item OO SCALING TIPS
1643
1644 =item INSTANCE VARIABLES
1645
1646 =item SCALAR INSTANCE VARIABLES
1647
1648 =item INSTANCE VARIABLE INHERITANCE
1649
1650 =item OBJECT RELATIONSHIPS
1651
1652 =item OVERRIDING SUPERCLASS METHODS
1653
1654 =item USING RELATIONSHIP WITH SDBM
1655
1656 =item THINKING OF CODE REUSE
1657
1658 =item CLASS CONTEXT AND THE OBJECT
1659
1660 =item INHERITING A CONSTRUCTOR
1661
1662 =item DELEGATION
1663
1664 =back
1665
1666 =head2 perltie - how to hide an object class in a simple variable
1667
1668 =over 4
1669
1670 =item SYNOPSIS
1671
1672 =item DESCRIPTION
1673
1674 =over 4
1675
1676 =item Tying Scalars
1677
1678 TIESCALAR classname, LIST, FETCH this, STORE this, value, UNTIE this,
1679 DESTROY this
1680
1681 =item Tying Arrays
1682
1683 TIEARRAY classname, LIST, FETCH this, index, STORE this, index, value,
1684 FETCHSIZE this, STORESIZE this, count, EXTEND this, count, EXISTS this,
1685 key, DELETE this, key, CLEAR this, PUSH this, LIST, POP this, SHIFT this,
1686 UNSHIFT this, LIST, SPLICE this, offset, length, LIST, UNTIE this, DESTROY
1687 this
1688
1689 =item Tying Hashes
1690
1691 USER, HOME, CLOBBER, LIST, TIEHASH classname, LIST, FETCH this, key, STORE
1692 this, key, value, DELETE this, key, CLEAR this, EXISTS this, key, FIRSTKEY
1693 this, NEXTKEY this, lastkey, UNTIE this, DESTROY this
1694
1695 =item Tying FileHandles
1696
1697 TIEHANDLE classname, LIST, WRITE this, LIST, PRINT this, LIST, PRINTF this,
1698 LIST, READ this, LIST, READLINE this, GETC this, CLOSE this, UNTIE this,
1699 DESTROY this
1700
1701 =item UNTIE this
1702
1703 =item The C<untie> Gotcha
1704
1705 =back
1706
1707 =item SEE ALSO
1708
1709 =item BUGS
1710
1711 =item AUTHOR
1712
1713 =back
1714
1715 =head2 perlipc - Perl interprocess communication (signals, fifos, pipes,
1716 safe subprocesses, sockets, and semaphores)
1717
1718 =over 4
1719
1720 =item DESCRIPTION
1721
1722 =item Signals
1723
1724 =over 4
1725
1726 =item Handling the SIGHUP Signal in Daemons
1727
1728 =back
1729
1730 =item Named Pipes
1731
1732 =over 4
1733
1734 =item Deferred Signals
1735
1736 Long running opcodes, Interrupting IO, Signals as "faults", Signals
1737 triggered by operating system state
1738
1739 =back
1740
1741 =item Using open() for IPC
1742
1743 =over 4
1744
1745 =item Filehandles
1746
1747 =item Background Processes
1748
1749 =item Complete Dissociation of Child from Parent
1750
1751 =item Safe Pipe Opens
1752
1753 =item Bidirectional Communication with Another Process
1754
1755 =item Bidirectional Communication with Yourself
1756
1757 =back
1758
1759 =item Sockets: Client/Server Communication
1760
1761 =over 4
1762
1763 =item Internet Line Terminators
1764
1765 =item Internet TCP Clients and Servers
1766
1767 =item Unix-Domain TCP Clients and Servers
1768
1769 =back
1770
1771 =item TCP Clients with IO::Socket
1772
1773 =over 4
1774
1775 =item A Simple Client
1776
1777 C<Proto>, C<PeerAddr>, C<PeerPort>
1778
1779 =item A Webget Client
1780
1781 =item Interactive Client with IO::Socket
1782
1783 =back
1784
1785 =item TCP Servers with IO::Socket
1786
1787 Proto, LocalPort, Listen, Reuse
1788
1789 =item UDP: Message Passing
1790
1791 =item SysV IPC
1792
1793 =item NOTES
1794
1795 =item BUGS
1796
1797 =item AUTHOR
1798
1799 =item SEE ALSO
1800
1801 =back
1802
1803 =head2 perlfork - Perl's fork() emulation
1804
1805 =over 4
1806
1807 =item SYNOPSIS
1808
1809 =item DESCRIPTION
1810
1811 =over 4
1812
1813 =item Behavior of other Perl features in forked pseudo-processes
1814
1815 $$ or $PROCESS_ID, %ENV, chdir() and all other builtins that accept
1816 filenames, wait() and waitpid(), kill(), exec(), exit(), Open handles to
1817 files, directories and network sockets
1818
1819 =item Resource limits
1820
1821 =item Killing the parent process
1822
1823 =item Lifetime of the parent process and pseudo-processes
1824
1825 =item CAVEATS AND LIMITATIONS
1826
1827 BEGIN blocks, Open filehandles, Forking pipe open() not yet implemented,
1828 Global state maintained by XSUBs, Interpreter embedded in larger
1829 application, Thread-safety of extensions
1830
1831 =back
1832
1833 =item BUGS
1834
1835 =item AUTHOR
1836
1837 =item SEE ALSO
1838
1839 =back
1840
1841 =head2 perlnumber - semantics of numbers and numeric operations in Perl
1842
1843 =over 4
1844
1845 =item SYNOPSIS
1846
1847 =item DESCRIPTION
1848
1849 =item Storing numbers
1850
1851 =item Numeric operators and numeric conversions
1852
1853 =item Flavors of Perl numeric operations
1854
1855 Arithmetic operators except, C<no integer>, Arithmetic operators except,
1856 C<use integer>, Bitwise operators, C<no integer>, Bitwise operators, C<use
1857 integer>, Operators which expect an integer, Operators which expect a
1858 string
1859
1860 =item AUTHOR
1861
1862 =item SEE ALSO
1863
1864 =back
1865
1866 =head2 perlthrtut - tutorial on threads in Perl
1867
1868 =over 4
1869
1870 =item DESCRIPTION
1871
1872 =item Status
1873
1874 =item What Is A Thread Anyway?
1875
1876 =item Threaded Program Models
1877
1878 =over 4
1879
1880 =item Boss/Worker
1881
1882 =item Work Crew
1883
1884 =item Pipeline
1885
1886 =back
1887
1888 =item Native threads
1889
1890 =item What kind of threads are Perl threads?
1891
1892 =item Threadsafe Modules
1893
1894 =item Thread Basics
1895
1896 =over 4
1897
1898 =item Basic Thread Support
1899
1900 =item A Note about the Examples
1901
1902 =item Creating Threads
1903
1904 =item Giving up control
1905
1906 =item Waiting For A Thread To Exit
1907
1908 =item Ignoring A Thread
1909
1910 =back
1911
1912 =item Threads And Data
1913
1914 =over 4
1915
1916 =item Shared And Unshared Data
1917
1918 =item Thread Pitfalls: Races
1919
1920 =back
1921
1922 =item Synchronization and control
1923
1924 =over 4
1925
1926 =item Controlling access: lock()
1927
1928 =item A Thread Pitfall: Deadlocks
1929
1930 =item Queues: Passing Data Around
1931
1932 =item Semaphores: Synchronizing Data Access
1933
1934 =item Basic semaphores
1935
1936 =item Advanced Semaphores
1937
1938 =item cond_wait() and cond_signal()
1939
1940 =back
1941
1942 =item General Thread Utility Routines
1943
1944 =over 4
1945
1946 =item What Thread Am I In?
1947
1948 =item Thread IDs
1949
1950 =item Are These Threads The Same?
1951
1952 =item What Threads Are Running?
1953
1954 =back
1955
1956 =item A Complete Example
1957
1958 =item Performance considerations
1959
1960 =item Threadsafety of System Libraries
1961
1962 =item Conclusion
1963
1964 =item Bibliography
1965
1966 =over 4
1967
1968 =item Introductory Texts
1969
1970 =item OS-Related References
1971
1972 =item Other References
1973
1974 =back
1975
1976 =item Acknowledgements
1977
1978 =item AUTHOR
1979
1980 =item Copyrights
1981
1982 =back
1983
1984 =head2 perlothrtut - old tutorial on threads in Perl
1985
1986 =over 4
1987
1988 =item DESCRIPTION
1989
1990 =item What Is A Thread Anyway?
1991
1992 =item Threaded Program Models
1993
1994 =over 4
1995
1996 =item Boss/Worker
1997
1998 =item Work Crew
1999
2000 =item Pipeline
2001
2002 =back
2003
2004 =item Native threads
2005
2006 =item What kind of threads are perl threads?
2007
2008 =item Threadsafe Modules
2009
2010 =item Thread Basics
2011
2012 =over 4
2013
2014 =item Basic Thread Support
2015
2016 =item Creating Threads
2017
2018 =item Giving up control
2019
2020 =item Waiting For A Thread To Exit
2021
2022 =item Errors In Threads
2023
2024 =item Ignoring A Thread
2025
2026 =back
2027
2028 =item Threads And Data
2029
2030 =over 4
2031
2032 =item Shared And Unshared Data
2033
2034 =item Thread Pitfall: Races
2035
2036 =item Controlling access: lock()
2037
2038 =item Thread Pitfall: Deadlocks
2039
2040 =item Queues: Passing Data Around
2041
2042 =back
2043
2044 =item Threads And Code
2045
2046 =over 4
2047
2048 =item Semaphores: Synchronizing Data Access
2049
2050 Basic semaphores, Advanced Semaphores
2051
2052 =item Attributes: Restricting Access To Subroutines
2053
2054 =item Subroutine Locks
2055
2056 =item Methods
2057
2058 =item Locking A Subroutine
2059
2060 =back
2061
2062 =item General Thread Utility Routines
2063
2064 =over 4
2065
2066 =item What Thread Am I In?
2067
2068 =item Thread IDs
2069
2070 =item Are These Threads The Same?
2071
2072 =item What Threads Are Running?
2073
2074 =back
2075
2076 =item A Complete Example
2077
2078 =item Conclusion
2079
2080 =item Bibliography
2081
2082 =over 4
2083
2084 =item Introductory Texts
2085
2086 =item OS-Related References
2087
2088 =item Other References
2089
2090 =back
2091
2092 =item Acknowledgements
2093
2094 =item AUTHOR
2095
2096 =item Copyrights
2097
2098 =back
2099
2100 =head2 perlport - Writing portable Perl
2101
2102 =over 4
2103
2104 =item DESCRIPTION
2105
2106 Not all Perl programs have to be portable, Nearly all of Perl already I<is>
2107 portable
2108
2109 =item ISSUES
2110
2111 =over 4
2112
2113 =item Newlines
2114
2115 =item Numbers endianness and Width
2116
2117 =item Files and Filesystems
2118
2119 =item System Interaction
2120
2121 =item Command names versus file pathnames
2122
2123 =item Interprocess Communication (IPC)
2124
2125 =item External Subroutines (XS)
2126
2127 =item Standard Modules
2128
2129 =item Time and Date
2130
2131 =item Character sets and character encoding
2132
2133 =item Internationalisation
2134
2135 =item System Resources
2136
2137 =item Security
2138
2139 =item Style
2140
2141 =back
2142
2143 =item CPAN Testers
2144
2145 Mailing list: cpan-testers@perl.org, Testing results:
2146 http://testers.cpan.org/
2147
2148 =item PLATFORMS
2149
2150 =over 4
2151
2152 =item Unix
2153
2154 =item DOS and Derivatives
2155
2156 =item S<Mac OS>
2157
2158 =item VMS
2159
2160 =item VOS
2161
2162 =item EBCDIC Platforms
2163
2164 =item Acorn RISC OS
2165
2166 =item Other perls
2167
2168 =back
2169
2170 =item FUNCTION IMPLEMENTATIONS
2171
2172 =over 4
2173
2174 =item Alphabetical Listing of Perl Functions
2175
2176 -I<X> FILEHANDLE, -I<X> EXPR, -I<X>, alarm SECONDS, alarm, binmode
2177 FILEHANDLE, chmod LIST, chown LIST, chroot FILENAME, chroot, crypt
2178 PLAINTEXT,SALT, dbmclose HASH, dbmopen HASH,DBNAME,MODE, dump LABEL, exec
2179 LIST, exit EXPR, exit, fcntl FILEHANDLE,FUNCTION,SCALAR, flock
2180 FILEHANDLE,OPERATION, fork, getlogin, getpgrp PID, getppid, getpriority
2181 WHICH,WHO, getpwnam NAME, getgrnam NAME, getnetbyname NAME, getpwuid UID,
2182 getgrgid GID, getnetbyaddr ADDR,ADDRTYPE, getprotobynumber NUMBER,
2183 getservbyport PORT,PROTO, getpwent, getgrent, gethostent, getnetent,
2184 getprotoent, getservent, sethostent STAYOPEN, setnetent STAYOPEN,
2185 setprotoent STAYOPEN, setservent STAYOPEN, endpwent, endgrent, endhostent,
2186 endnetent, endprotoent, endservent, getsockopt SOCKET,LEVEL,OPTNAME, glob
2187 EXPR, glob, ioctl FILEHANDLE,FUNCTION,SCALAR, kill SIGNAL, LIST, link
2188 OLDFILE,NEWFILE, lstat FILEHANDLE, lstat EXPR, lstat, msgctl ID,CMD,ARG,
2189 msgget KEY,FLAGS, msgsnd ID,MSG,FLAGS, msgrcv ID,VAR,SIZE,TYPE,FLAGS, open
2190 FILEHANDLE,EXPR, open FILEHANDLE, pipe READHANDLE,WRITEHANDLE, readlink
2191 EXPR, readlink, select RBITS,WBITS,EBITS,TIMEOUT, semctl ID,SEMNUM,CMD,ARG,
2192 semget KEY,NSEMS,FLAGS, semop KEY,OPSTRING, setgrent, setpgrp PID,PGRP,
2193 setpriority WHICH,WHO,PRIORITY, setpwent, setsockopt
2194 SOCKET,LEVEL,OPTNAME,OPTVAL, shmctl ID,CMD,ARG, shmget KEY,SIZE,FLAGS,
2195 shmread ID,VAR,POS,SIZE, shmwrite ID,STRING,POS,SIZE, sockatmark SOCKET,
2196 socketpair SOCKET1,SOCKET2,DOMAIN,TYPE,PROTOCOL, stat FILEHANDLE, stat
2197 EXPR, stat, symlink OLDFILE,NEWFILE, syscall LIST, sysopen
2198 FILEHANDLE,FILENAME,MODE,PERMS, system LIST, times, truncate
2199 FILEHANDLE,LENGTH, truncate EXPR,LENGTH, umask EXPR, umask, utime LIST,
2200 wait, waitpid PID,FLAGS
2201
2202 =back
2203
2204 =item CHANGES
2205
2206 v1.48, 02 February 2001, v1.47, 22 March 2000, v1.46, 12 February 2000,
2207 v1.45, 20 December 1999, v1.44, 19 July 1999, v1.43, 24 May 1999, v1.42, 22
2208 May 1999, v1.41, 19 May 1999, v1.40, 11 April 1999, v1.39, 11 February
2209 1999, v1.38, 31 December 1998, v1.37, 19 December 1998, v1.36, 9 September
2210 1998, v1.35, 13 August 1998, v1.33, 06 August 1998, v1.32, 05 August 1998,
2211 v1.30, 03 August 1998, v1.23, 10 July 1998
2212
2213 =item Supported Platforms
2214
2215 =item SEE ALSO
2216
2217 =item AUTHORS / CONTRIBUTORS
2218
2219 =back
2220
2221 =head2 perllocale - Perl locale handling (internationalization and
2222 localization)
2223
2224 =over 4
2225
2226 =item DESCRIPTION
2227
2228 =item PREPARING TO USE LOCALES
2229
2230 =item USING LOCALES
2231
2232 =over 4
2233
2234 =item The use locale pragma
2235
2236 =item The setlocale function
2237
2238 =item Finding locales
2239
2240 =item LOCALE PROBLEMS
2241
2242 =item Temporarily fixing locale problems
2243
2244 =item Permanently fixing locale problems
2245
2246 =item Permanently fixing your system's locale configuration
2247
2248 =item Fixing system locale configuration
2249
2250 =item The localeconv function
2251
2252 =item I18N::Langinfo
2253
2254 =back
2255
2256 =item LOCALE CATEGORIES
2257
2258 =over 4
2259
2260 =item Category LC_COLLATE: Collation
2261
2262 =item Category LC_CTYPE: Character Types
2263
2264 =item Category LC_NUMERIC: Numeric Formatting
2265
2266 =item Category LC_MONETARY: Formatting of monetary amounts
2267
2268 =item LC_TIME
2269
2270 =item Other categories
2271
2272 =back
2273
2274 =item SECURITY
2275
2276 =item ENVIRONMENT
2277
2278 PERL_BADLANG, LC_ALL, LANGUAGE, LC_CTYPE, LC_COLLATE, LC_MONETARY,
2279 LC_NUMERIC, LC_TIME, LANG
2280
2281 =item NOTES
2282
2283 =over 4
2284
2285 =item Backward compatibility
2286
2287 =item I18N:Collate obsolete
2288
2289 =item Sort speed and memory use impacts
2290
2291 =item write() and LC_NUMERIC
2292
2293 =item Freely available locale definitions
2294
2295 =item I18n and l10n
2296
2297 =item An imperfect standard
2298
2299 =back
2300
2301 =item Unicode and UTF-8
2302
2303 =item BUGS
2304
2305 =over 4
2306
2307 =item Broken systems
2308
2309 =back
2310
2311 =item SEE ALSO
2312
2313 =item HISTORY
2314
2315 =back
2316
2317 =head2 perluniintro - Perl Unicode introduction
2318
2319 =over 4
2320
2321 =item DESCRIPTION
2322
2323 =over 4
2324
2325 =item Unicode
2326
2327 =item Perl's Unicode Support
2328
2329 =item Perl's Unicode Model
2330
2331 =item Unicode and EBCDIC
2332
2333 =item Creating Unicode
2334
2335 =item Handling Unicode
2336
2337 =item Legacy Encodings
2338
2339 =item Unicode I/O
2340
2341 =item Displaying Unicode As Text
2342
2343 =item Special Cases
2344
2345 =item Advanced Topics
2346
2347 =item Miscellaneous
2348
2349 =item Questions With Answers
2350
2351 =item Hexadecimal Notation
2352
2353 =item Further Resources
2354
2355 =back
2356
2357 =item UNICODE IN OLDER PERLS
2358
2359 =item SEE ALSO
2360
2361 =item ACKNOWLEDGMENTS
2362
2363 =item AUTHOR, COPYRIGHT, AND LICENSE
2364
2365 =back
2366
2367 =head2 perlunicode - Unicode support in Perl
2368
2369 =over 4
2370
2371 =item DESCRIPTION
2372
2373 =over 4
2374
2375 =item Important Caveats
2376
2377 Input and Output Layers, Regular Expressions, C<use utf8> still needed to
2378 enable UTF-8/UTF-EBCDIC in scripts
2379
2380 =item Byte and Character Semantics
2381
2382 =item Effects of Character Semantics
2383
2384 =item Scripts
2385
2386 =item Blocks
2387
2388 =item User-Defined Character Properties
2389
2390 =item Character Encodings for Input and Output
2391
2392 =item Unicode Regular Expression Support Level
2393
2394 =item Unicode Encodings
2395
2396 =item Security Implications of Unicode
2397
2398 =item Unicode in Perl on EBCDIC
2399
2400 =item Locales
2401
2402 =item Using Unicode in XS
2403
2404 =back
2405
2406 =item BUGS
2407
2408 =over 4
2409
2410 =item Interaction with Locales
2411
2412 =item Interaction with Extensions
2413
2414 =item Speed
2415
2416 =back
2417
2418 =item SEE ALSO
2419
2420 =back
2421
2422 =head2 perlebcdic - Considerations for running Perl on EBCDIC platforms
2423
2424 =over 4
2425
2426 =item DESCRIPTION
2427
2428 =item COMMON CHARACTER CODE SETS
2429
2430 =over 4
2431
2432 =item ASCII
2433
2434 =item ISO 8859
2435
2436 =item Latin 1 (ISO 8859-1)
2437
2438 =item EBCDIC
2439
2440 =item 13 variant characters
2441
2442 =item 0037
2443
2444 =item 1047
2445
2446 =item POSIX-BC
2447
2448 =item Unicode code points versus EBCDIC code points
2449
2450 =item Remaining Perl Unicode problems in EBCDIC
2451
2452 =item Unicode and UTF
2453
2454 =item Using Encode
2455
2456 =back
2457
2458 =item SINGLE OCTET TABLES
2459
2460 recipe 0, recipe 1, recipe 2, recipe 3, recipe 4, recipe 5, recipe 6
2461
2462 =item IDENTIFYING CHARACTER CODE SETS
2463
2464 =item CONVERSIONS
2465
2466 =over 4
2467
2468 =item tr///
2469
2470 =item iconv
2471
2472 =item C RTL
2473
2474 =back
2475
2476 =item OPERATOR DIFFERENCES
2477
2478 =item FUNCTION DIFFERENCES
2479
2480 chr(), ord(), pack(), print(), printf(), sort(), sprintf(), unpack()
2481
2482 =item REGULAR EXPRESSION DIFFERENCES
2483
2484 =item SOCKETS
2485
2486 =item SORTING
2487
2488 =over 4
2489
2490 =item Ignore ASCII vs. EBCDIC sort differences.
2491
2492 =item MONO CASE then sort data.
2493
2494 =item Convert, sort data, then re convert.
2495
2496 =item Perform sorting on one type of machine only.
2497
2498 =back
2499
2500 =item TRANSFORMATION FORMATS
2501
2502 =over 4
2503
2504 =item URL decoding and encoding
2505
2506 =item uu encoding and decoding
2507
2508 =item Quoted-Printable encoding and decoding
2509
2510 =item Caesarian ciphers
2511
2512 =back
2513
2514 =item Hashing order and checksums
2515
2516 =item I18N AND L10N
2517
2518 =item MULTI OCTET CHARACTER SETS
2519
2520 =item OS ISSUES
2521
2522 =over 4
2523
2524 =item OS/400
2525
2526 IFS access
2527
2528 =item OS/390, z/OS
2529
2530 chcp, dataset access, OS/390, z/OS iconv, locales
2531
2532 =item VM/ESA?
2533
2534 =item POSIX-BC?
2535
2536 =back
2537
2538 =item BUGS
2539
2540 =item SEE ALSO
2541
2542 =item REFERENCES
2543
2544 =item HISTORY
2545
2546 =item AUTHOR
2547
2548 =back
2549
2550 =head2 perlsec - Perl security
2551
2552 =over 4
2553
2554 =item DESCRIPTION
2555
2556 =over 4
2557
2558 =item Laundering and Detecting Tainted Data
2559
2560 =item Switches On the "#!" Line
2561
2562 =item Cleaning Up Your Path
2563
2564 =item Security Bugs
2565
2566 =item Protecting Your Programs
2567
2568 =item Unicode
2569
2570 =back
2571
2572 =item SEE ALSO
2573
2574 =back
2575
2576 =head2 perlmod - Perl modules (packages and symbol tables)
2577
2578 =over 4
2579
2580 =item DESCRIPTION
2581
2582 =over 4
2583
2584 =item Packages
2585
2586 =item Symbol Tables
2587
2588 =item Package Constructors and Destructors
2589
2590 =item Perl Classes
2591
2592 =item Perl Modules
2593
2594 =item Making your module threadsafe
2595
2596 =back
2597
2598 =item SEE ALSO
2599
2600 =back
2601
2602 =head2 perlmodinstall - Installing CPAN Modules
2603
2604 =over 4
2605
2606 =item DESCRIPTION
2607
2608 =over 4
2609
2610 =item PREAMBLE
2611
2612 B<DECOMPRESS> the file, B<UNPACK> the file into a directory, B<BUILD> the
2613 module (sometimes unnecessary), B<INSTALL> the module
2614
2615 =back
2616
2617 =item PORTABILITY
2618
2619 =item HEY
2620
2621 =item AUTHOR
2622
2623 =item COPYRIGHT
2624
2625 =back
2626
2627 =head2 perlmodlib - constructing new Perl modules and finding existing ones
2628
2629 =over 4
2630
2631 =item DESCRIPTION
2632
2633 =item THE PERL MODULE LIBRARY
2634
2635 =over 4
2636
2637 =item Pragmatic Modules
2638
2639 attributes, attrs, autouse, base, bigint, bignum, bigrat, blib, bytes,
2640 charnames, constant, diagnostics, encoding, fields, filetest, if, integer,
2641 less, locale, open, ops, overload, re, sigtrap, sort, strict, subs,
2642 threads, utf8, vars, vmsish, warnings, warnings::register
2643
2644 =item Standard Modules
2645
2646 AnyDBM_File, Attribute::Handlers, AutoLoader, AutoSplit, B, B::Asmdata,
2647 B::Assembler, B::Bblock, B::Bytecode, B::C, B::CC, B::Concise, B::Debug,
2648 B::Deparse, B::Disassembler, B::Lint, B::Showlex, B::Stackobj, B::Stash,
2649 B::Terse, B::Xref, Benchmark, ByteLoader, CGI, CGI::Apache, CGI::Carp,
2650 CGI::Cookie, CGI::Fast, CGI::Pretty, CGI::Push, CGI::Switch, CGI::Util,
2651 CPAN, CPAN::FirstTime, CPAN::Nox, Carp, Carp::Heavy, Class::ISA,
2652 Class::Struct, Config, Cwd, DB, DB_File, Devel::SelfStubber, Digest,
2653 DirHandle, Dumpvalue, Encode, English, Env, Errno, Exporter,
2654 Exporter::Heavy, ExtUtils::Command, ExtUtils::Command::MM,
2655 ExtUtils::Constant, ExtUtils::Embed, ExtUtils::Install,
2656 ExtUtils::Installed, ExtUtils::Liblist, ExtUtils::MM, ExtUtils::MM_Any,
2657 ExtUtils::MM_BeOS, ExtUtils::MM_Cygwin, ExtUtils::MM_DOS,
2658 ExtUtils::MM_MacOS, ExtUtils::MM_NW5, ExtUtils::MM_OS2, ExtUtils::MM_UWIN,
2659 ExtUtils::MM_Unix, ExtUtils::MM_VMS, ExtUtils::MM_Win32,
2660 ExtUtils::MM_Win95, ExtUtils::MY, ExtUtils::MakeMaker, ExtUtils::Manifest,
2661 ExtUtils::Mkbootstrap, ExtUtils::Mksymlists, ExtUtils::Packlist,
2662 ExtUtils::testlib, Fatal, Fcntl, File::Basename, File::CheckTree,
2663 File::Compare, File::Copy, File::DosGlob, File::Find, File::Path,
2664 File::Spec, File::Spec::Cygwin, File::Spec::Epoc, File::Spec::Functions,
2665 File::Spec::Mac, File::Spec::OS2, File::Spec::Unix, File::Spec::VMS,
2666 File::Spec::Win32, File::Temp, File::stat, FileCache, FileHandle,
2667 Filter::Simple, FindBin, Getopt::Long, Getopt::Std, Hash::Util,
2668 I18N::Collate, I18N::LangTags, I18N::LangTags::List, IO, IPC::Open2,
2669 IPC::Open3, Locale::Constants, Locale::Country, Locale::Currency,
2670 Locale::Language, Locale::Maketext, Locale::Maketext::TPJ13,
2671 Locale::Script, Math::BigFloat, Math::BigInt, Math::BigInt::Calc,
2672 Math::BigRat, Math::Complex, Math::Trig, Memoize, Memoize::AnyDBM_File,
2673 Memoize::Expire, Memoize::ExpireFile, Memoize::ExpireTest,
2674 Memoize::NDBM_File, Memoize::SDBM_File, Memoize::Storable, NDBM_File, NEXT,
2675 Net::Cmd, Net::Config, Net::Domain, Net::FTP, Net::NNTP, Net::Netrc,
2676 Net::POP3, Net::Ping, Net::SMTP, Net::Time, Net::hostent, Net::libnetFAQ,
2677 Net::netent, Net::protoent, Net::servent, O, ODBM_File, Opcode, POSIX,
2678 PerlIO, PerlIO::via::QuotedPrint, Pod::Checker, Pod::Find, Pod::Functions,
2679 Pod::Html, Pod::InputObjects, Pod::LaTeX, Pod::Man, Pod::ParseLink,
2680 Pod::ParseUtils, Pod::Parser, Pod::Plainer, Pod::Select, Pod::Text,
2681 Pod::Text::Color, Pod::Text::Overstrike, Pod::Text::Termcap, Pod::Usage,
2682 SDBM_File, Safe, Search::Dict, SelectSaver, SelfLoader, Shell, Socket,
2683 Storable, Switch, Symbol, Term::ANSIColor, Term::Cap, Term::Complete,
2684 Term::ReadLine, Test, Test::Builder, Test::Harness, Test::Harness::Assert,
2685 Test::Harness::Iterator, Test::Harness::Straps, Test::More, Test::Simple,
2686 Test::Tutorial, Text::Abbrev, Text::Balanced, Text::ParseWords,
2687 Text::Soundex, Text::Tabs, Text::Wrap, Thread, Thread::Queue,
2688 Thread::Semaphore, Tie::Array, Tie::File, Tie::Handle, Tie::Hash,
2689 Tie::Memoize, Tie::RefHash, Tie::Scalar, Tie::SubstrHash, Time::Local,
2690 Time::gmtime, Time::localtime, Time::tm, UNIVERSAL, Unicode::Collate,
2691 Unicode::UCD, User::grent, User::pwent, Win32
2692
2693 =item Extension Modules
2694
2695 =back
2696
2697 =item CPAN
2698
2699 =over 4
2700
2701 =item Africa
2702
2703 South Africa
2704
2705 =item Asia
2706
2707 China, India, Indonesia, Israel, Japan, Korea, Philippines, Russian
2708 Federation, Saudi Arabia, Singapore, South Korea, Taiwan, Thailand
2709
2710 =item Central America
2711
2712 Costa Rica
2713
2714 =item Europe
2715
2716 Austria, Belgium, Bulgaria, Croatia, Czech Republic, Denmark, Estonia,
2717 Finland, France, Germany, Greece, Hungary, Iceland, Ireland, Italy, Latvia,
2718 Lithuania, Netherlands, Norway, Poland, Portugal, Romania, Russia,
2719 Slovakia, Slovenia, Spain, Sweden, Switzerland, Turkey, Ukraine, United
2720 Kingdom
2721
2722 =item North America
2723
2724 Alberta, Manitoba, Nova Scotia, Ontario, Quebec, Mexico
2725
2726 =item United States
2727
2728 Alabama, California, Colorado, Delaware, District of Columbia, Florida,
2729 Illinois, Indiana, Kentucky, Massachusetts, Michigan, New Jersey, New York,
2730 North Carolina, Ohio, Oklahoma, Oregon, Pennsylvania, Tennessee, Texas,
2731 Utah, Virginia, ashington, Wisconsin
2732
2733 =item Oceania
2734
2735 Australia, New Zealand
2736
2737 =item South America
2738
2739 Argentina, Brazil, Chile
2740
2741 =item RSYNC Mirrors
2742
2743 =back
2744
2745 =item Modules: Creation, Use, and Abuse
2746
2747 =over 4
2748
2749 =item Guidelines for Module Creation
2750
2751 =item Guidelines for Converting Perl 4 Library Scripts into Modules
2752
2753 =item Guidelines for Reusing Application Code
2754
2755 =back
2756
2757 =item NOTE
2758
2759 =back
2760
2761 =head2 perlmodstyle - Perl module style guide
2762
2763 =over 4
2764
2765 =item INTRODUCTION
2766
2767 =item QUICK CHECKLIST
2768
2769 =over 4
2770
2771 =item Before you start
2772
2773 =item The API
2774
2775 =item Stability
2776
2777 =item Documentation
2778
2779 =item Release considerations
2780
2781 =back
2782
2783 =item BEFORE YOU START WRITING A MODULE
2784
2785 =over 4
2786
2787 =item Has it been done before?
2788
2789 =item Do one thing and do it well
2790
2791 =item What's in a name?
2792
2793 =back
2794
2795 =item DESIGNING AND WRITING YOUR MODULE
2796
2797 =over 4
2798
2799 =item To OO or not to OO?
2800
2801 =item Designing your API
2802
2803 Write simple routines to do simple things, Separate functionality from
2804 output, Provide sensible shortcuts and defaults, Naming conventions,
2805 Parameter passing
2806
2807 =item Strictness and warnings
2808
2809 =item Backwards compatibility
2810
2811 =item Error handling and messages
2812
2813 =back
2814
2815 =item DOCUMENTING YOUR MODULE
2816
2817 =over 4
2818
2819 =item POD
2820
2821 =item README, INSTALL, release notes, changelogs
2822
2823 =back
2824
2825 =item RELEASE CONSIDERATIONS
2826
2827 =over 4
2828
2829 =item Version numbering
2830
2831 =item Pre-requisites
2832
2833 =item Testing
2834
2835 =item Packaging
2836
2837 =item Licensing
2838
2839 =back
2840
2841 =item COMMON PITFALLS
2842
2843 =over 4
2844
2845 =item Reinventing the wheel
2846
2847 =item Trying to do too much
2848
2849 =item Inappropriate documentation
2850
2851 =back
2852
2853 =item SEE ALSO
2854
2855 L<perlstyle>, L<perlnewmod>, L<perlpod>, L<podchecker>, Testing tools,
2856 http://pause.perl.org/, Any good book on software engineering
2857
2858 =item AUTHOR
2859
2860 =back
2861
2862 =head2 perlnewmod - preparing a new module for distribution
2863
2864 =over 4
2865
2866 =item DESCRIPTION
2867
2868 =over 4
2869
2870 =item Warning
2871
2872 =item What should I make into a module?
2873
2874 =item Step-by-step: Preparing the ground
2875
2876 Look around, Check it's new, Discuss the need, Choose a name, Check again
2877
2878 =item Step-by-step: Making the module
2879
2880 Start with F<h2xs>, Use L<strict|strict> and L<warnings|warnings>, Use
2881 L<Carp|Carp>, Use L<Exporter|Exporter> - wisely!, Use L<plain old
2882 documentation|perlpod>, Write tests, Write the README
2883
2884 =item Step-by-step: Distributing your module
2885
2886 Get a CPAN user ID, C<perl Makefile.PL; make test; make dist>, Upload the
2887 tarball, Announce to the modules list, Announce to clpa, Fix bugs!
2888
2889 =back
2890
2891 =item AUTHOR
2892
2893 =item SEE ALSO
2894
2895 =back
2896
2897 =head2 perlfaq1 - General Questions About Perl ($Revision: 1.8 $, $Date:
2898 2002/04/07 18:46:13 $)
2899
2900 =over 4
2901
2902 =item DESCRIPTION
2903
2904 =over 4
2905
2906 =item What is Perl?
2907
2908 =item Who supports Perl?  Who develops it?  Why is it free?
2909
2910 =item Which version of Perl should I use?
2911
2912 =item What are perl4 and perl5?
2913
2914 =item What is perl6?
2915
2916 =item How stable is Perl?
2917
2918 =item Is Perl difficult to learn?
2919
2920 =item How does Perl compare with other languages like Java, Python, REXX,
2921 Scheme, or Tcl?
2922
2923 =item Can I do [task] in Perl?
2924
2925 =item When shouldn't I program in Perl?
2926
2927 =item What's the difference between "perl" and "Perl"?
2928
2929 =item Is it a Perl program or a Perl script?
2930
2931 =item What is a JAPH?
2932
2933 =item Where can I get a list of Larry Wall witticisms?
2934
2935 =item How can I convince my sysadmin/supervisor/employees to use version
2936 5/5.6.1/Perl instead of some other language?
2937
2938 =back
2939
2940 =item AUTHOR AND COPYRIGHT
2941
2942 =back
2943
2944 =head2 perlfaq2 - Obtaining and Learning about Perl ($Revision: 1.13 $,
2945 $Date: 2002/04/26 16:56:35 $)
2946
2947 =over 4
2948
2949 =item DESCRIPTION
2950
2951 =over 4
2952
2953 =item What machines support Perl?  Where do I get it?
2954
2955 =item How can I get a binary version of Perl?
2956
2957 =item I don't have a C compiler on my system.  How can I compile perl?
2958
2959 =item I copied the Perl binary from one machine to another, but scripts
2960 don't work.
2961
2962 =item I grabbed the sources and tried to compile but gdbm/dynamic
2963 loading/malloc/linking/... failed.  How do I make it work?
2964
2965 =item What modules and extensions are available for Perl?  What is CPAN?
2966 What does CPAN/src/... mean?
2967
2968 =item Is there an ISO or ANSI certified version of Perl?
2969
2970 =item Where can I get information on Perl?
2971
2972 =item What are the Perl newsgroups on Usenet?  Where do I post questions?
2973
2974 =item Where should I post source code?
2975
2976 =item Perl Books
2977
2978 References, Tutorials, Task-Oriented, Special Topics
2979
2980 =item Perl in Magazines
2981
2982 =item Perl on the Net: FTP and WWW Access
2983
2984 =item What mailing lists are there for Perl?
2985
2986 =item Archives of comp.lang.perl.misc
2987
2988 =item Where can I buy a commercial version of Perl?
2989
2990 =item Where do I send bug reports?
2991
2992 =item What is perl.com? Perl Mongers? pm.org? perl.org? cpan.org?
2993
2994 =back
2995
2996 =item AUTHOR AND COPYRIGHT
2997
2998 =back
2999
3000 =head2 perlfaq3 - Programming Tools ($Revision: 1.22 $, $Date: 2002/05/06
3001 13:11:13 $)
3002
3003 =over 4
3004
3005 =item DESCRIPTION
3006
3007 =over 4
3008
3009 =item How do I do (anything)?
3010
3011 =item How can I use Perl interactively?
3012
3013 =item Is there a Perl shell?
3014
3015 =item How do I debug my Perl programs?
3016
3017 =item How do I profile my Perl programs?
3018
3019 =item How do I cross-reference my Perl programs?
3020
3021 =item Is there a pretty-printer (formatter) for Perl?
3022
3023 =item Is there a ctags for Perl?
3024
3025 =item Is there an IDE or Windows Perl Editor?
3026
3027 Komodo, The Object System, Open Perl IDE, PerlBuilder, visiPerl+, OptiPerl,
3028 CodeMagicCD, GNU Emacs, MicroEMACS, XEmacs, Elvis, Vile, Vim, Codewright,
3029 MultiEdit, SlickEdit, Bash, Ksh, Tcsh, Zsh, BBEdit and BBEdit Lite, Alpha
3030
3031 =item Where can I get Perl macros for vi?
3032
3033 =item Where can I get perl-mode for emacs?
3034
3035 =item How can I use curses with Perl?
3036
3037 =item How can I use X or Tk with Perl?
3038
3039 =item How can I generate simple menus without using CGI or Tk?
3040
3041 =item How can I make my Perl program run faster?
3042
3043 =item How can I make my Perl program take less memory?
3044
3045 Don't slurp!, Use map and grep selectively, Avoid unnecessary quotes and
3046 stringification, Pass by reference, Tie large variables to disk
3047
3048 =item Is it unsafe to return a pointer to local data?
3049
3050 =item How can I free an array or hash so my program shrinks?
3051
3052 =item How can I make my CGI script more efficient?
3053
3054 =item How can I hide the source for my Perl program?
3055
3056 =item How can I compile my Perl program into byte code or C?
3057
3058 =item How can I compile Perl into Java?
3059
3060 =item How can I get C<#!perl> to work on [MS-DOS,NT,...]?
3061
3062 =item Can I write useful Perl programs on the command line?
3063
3064 =item Why don't Perl one-liners work on my DOS/Mac/VMS system?
3065
3066 =item Where can I learn about CGI or Web programming in Perl?
3067
3068 =item Where can I learn about object-oriented Perl programming?
3069
3070 =item Where can I learn about linking C with Perl? [h2xs, xsubpp]
3071
3072 =item I've read perlembed, perlguts, etc., but I can't embed perl in
3073 my C program; what am I doing wrong?
3074
3075 =item When I tried to run my script, I got this message. What does it mean?
3076
3077 =item What's MakeMaker?
3078
3079 =back
3080
3081 =item AUTHOR AND COPYRIGHT
3082
3083 =back
3084
3085 =head2 perlfaq4 - Data Manipulation ($Revision: 1.25 $, $Date: 2002/05/30
3086 07:04:25 $)
3087
3088 =over 4
3089
3090 =item DESCRIPTION
3091
3092 =item Data: Numbers
3093
3094 =over 4
3095
3096 =item Why am I getting long decimals (eg, 19.9499999999999) instead of the
3097 numbers I should be getting (eg, 19.95)?
3098
3099 =item Why isn't my octal data interpreted correctly?
3100
3101 =item Does Perl have a round() function?  What about ceil() and floor()?
3102 Trig functions?
3103
3104 =item How do I convert between numeric representations?
3105
3106 How do I convert hexadecimal into decimal, How do I convert from decimal to
3107 hexadecimal, How do I convert from octal to decimal, How do I convert from
3108 decimal to octal, How do I convert from binary to decimal, How do I convert
3109 from decimal to binary
3110
3111 =item Why doesn't & work the way I want it to?
3112
3113 =item How do I multiply matrices?
3114
3115 =item How do I perform an operation on a series of integers?
3116
3117 =item How can I output Roman numerals?
3118
3119 =item Why aren't my random numbers random?
3120
3121 =item How do I get a random number between X and Y?
3122
3123 =back
3124
3125 =item Data: Dates
3126
3127 =over 4
3128
3129 =item How do I find the week-of-the-year/day-of-the-year?
3130
3131 =item How do I find the current century or millennium?
3132
3133 =item How can I compare two dates and find the difference?
3134
3135 =item How can I take a string and turn it into epoch seconds?
3136
3137 =item How can I find the Julian Day?
3138
3139 =item How do I find yesterday's date?
3140
3141 =item Does Perl have a Year 2000 problem?  Is Perl Y2K compliant?
3142
3143 =back
3144
3145 =item Data: Strings
3146
3147 =over 4
3148
3149 =item How do I validate input?
3150
3151 =item How do I unescape a string?
3152
3153 =item How do I remove consecutive pairs of characters?
3154
3155 =item How do I expand function calls in a string?
3156
3157 =item How do I find matching/nesting anything?
3158
3159 =item How do I reverse a string?
3160
3161 =item How do I expand tabs in a string?
3162
3163 =item How do I reformat a paragraph?
3164
3165 =item How can I access/change the first N letters of a string?
3166
3167 =item How do I change the Nth occurrence of something?
3168
3169 =item How can I count the number of occurrences of a substring within a
3170 string?
3171
3172 =item How do I capitalize all the words on one line?
3173
3174 =item How can I split a [character] delimited string except when inside
3175 [character]? (Comma-separated files)
3176
3177 =item How do I strip blank space from the beginning/end of a string?
3178
3179 =item How do I pad a string with blanks or pad a number with zeroes?
3180
3181 =item How do I extract selected columns from a string?
3182
3183 =item How do I find the soundex value of a string?
3184
3185 =item How can I expand variables in text strings?
3186
3187 =item What's wrong with always quoting "$vars"?
3188
3189 =item Why don't my <<HERE documents work?
3190
3191 1. There must be no space after the << part, 2. There (probably) should be
3192 a semicolon at the end, 3. You can't (easily) have any space in front of
3193 the tag
3194
3195 =back
3196
3197 =item Data: Arrays
3198
3199 =over 4
3200
3201 =item What is the difference between a list and an array?
3202
3203 =item What is the difference between $array[1] and @array[1]?
3204
3205 =item How can I remove duplicate elements from a list or array?
3206
3207 a), b), c), d), e)
3208
3209 =item How can I tell whether a certain element is contained in a list or
3210 array?
3211
3212 =item How do I compute the difference of two arrays?  How do I compute the
3213 intersection of two arrays?
3214
3215 =item How do I test whether two arrays or hashes are equal?
3216
3217 =item How do I find the first array element for which a condition is true?
3218
3219 =item How do I handle linked lists?
3220
3221 =item How do I handle circular lists?
3222
3223 =item How do I shuffle an array randomly?
3224
3225 =item How do I process/modify each element of an array?
3226
3227 =item How do I select a random element from an array?
3228
3229 =item How do I permute N elements of a list?
3230
3231 =item How do I sort an array by (anything)?
3232
3233 =item How do I manipulate arrays of bits?
3234
3235 =item Why does defined() return true on empty arrays and hashes?
3236
3237 =back
3238
3239 =item Data: Hashes (Associative Arrays)
3240
3241 =over 4
3242
3243 =item How do I process an entire hash?
3244
3245 =item What happens if I add or remove keys from a hash while iterating over
3246 it?
3247
3248 =item How do I look up a hash element by value?
3249
3250 =item How can I know how many entries are in a hash?
3251
3252 =item How do I sort a hash (optionally by value instead of key)?
3253
3254 =item How can I always keep my hash sorted?
3255
3256 =item What's the difference between "delete" and "undef" with hashes?
3257
3258 =item Why don't my tied hashes make the defined/exists distinction?
3259
3260 =item How do I reset an each() operation part-way through?
3261
3262 =item How can I get the unique keys from two hashes?
3263
3264 =item How can I store a multidimensional array in a DBM file?
3265
3266 =item How can I make my hash remember the order I put elements into it?
3267
3268 =item Why does passing a subroutine an undefined element in a hash create
3269 it?
3270
3271 =item How can I make the Perl equivalent of a C structure/C++ class/hash or
3272 array of hashes or arrays?
3273
3274 =item How can I use a reference as a hash key?
3275
3276 =back
3277
3278 =item Data: Misc
3279
3280 =over 4
3281
3282 =item How do I handle binary data correctly?
3283
3284 =item How do I determine whether a scalar is a number/whole/integer/float?
3285
3286 =item How do I keep persistent data across program calls?
3287
3288 =item How do I print out or copy a recursive data structure?
3289
3290 =item How do I define methods for every class/object?
3291
3292 =item How do I verify a credit card checksum?
3293
3294 =item How do I pack arrays of doubles or floats for XS code?
3295
3296 =back
3297
3298 =item AUTHOR AND COPYRIGHT
3299
3300 =back
3301
3302 =head2 perlfaq5 - Files and Formats ($Revision: 1.18 $, $Date: 2002/05/30
3303 07:04:25 $)
3304
3305 =over 4
3306
3307 =item DESCRIPTION
3308
3309 =over 4
3310
3311 =item How do I flush/unbuffer an output filehandle?  Why must I do this?
3312
3313 =item How do I change one line in a file/delete a line in a file/insert a
3314 line in the middle of a file/append to the beginning of a file?
3315
3316 =item How do I count the number of lines in a file?
3317
3318 =item How do I make a temporary file name?
3319
3320 =item How can I manipulate fixed-record-length files?
3321
3322 =item How can I make a filehandle local to a subroutine?  How do I pass
3323 filehandles between subroutines?  How do I make an array of filehandles?
3324
3325 =item How can I use a filehandle indirectly?
3326
3327 =item How can I set up a footer format to be used with write()?
3328
3329 =item How can I write() into a string?
3330
3331 =item How can I output my numbers with commas added?
3332
3333 =item How can I translate tildes (~) in a filename?
3334
3335 =item How come when I open a file read-write it wipes it out?
3336
3337 =item Why do I sometimes get an "Argument list too long" when I use <*>?
3338
3339 =item Is there a leak/bug in glob()?
3340
3341 =item How can I open a file with a leading ">" or trailing blanks?
3342
3343 =item How can I reliably rename a file?
3344
3345 =item How can I lock a file?
3346
3347 =item Why can't I just open(FH, ">file.lock")?
3348
3349 =item I still don't get locking.  I just want to increment the number in
3350 the file.  How can I do this?
3351
3352 =item All I want to do is append a small amount of text to the end of a
3353 file.  Do I still have to use locking?
3354
3355 =item How do I randomly update a binary file?
3356
3357 =item How do I get a file's timestamp in perl?
3358
3359 =item How do I set a file's timestamp in perl?
3360
3361 =item How do I print to more than one file at once?
3362
3363 =item How can I read in an entire file all at once?
3364
3365 =item How can I read in a file by paragraphs?
3366
3367 =item How can I read a single character from a file?  From the keyboard?
3368
3369 =item How can I tell whether there's a character waiting on a filehandle?
3370
3371 =item How do I do a C<tail -f> in perl?
3372
3373 =item How do I dup() a filehandle in Perl?
3374
3375 =item How do I close a file descriptor by number?
3376
3377 =item Why can't I use "C:\temp\foo" in DOS paths?  Why doesn't
3378 `C:\temp\foo.exe` work?
3379
3380 =item Why doesn't glob("*.*") get all the files?
3381
3382 =item Why does Perl let me delete read-only files?  Why does C<-i> clobber
3383 protected files?  Isn't this a bug in Perl?
3384
3385 =item How do I select a random line from a file?
3386
3387 =item Why do I get weird spaces when I print an array of lines?
3388
3389 =back
3390
3391 =item AUTHOR AND COPYRIGHT
3392
3393 =back
3394
3395 =head2 perlfaq6 - Regular Expressions ($Revision: 1.12 $, $Date: 2002/06/01
3396 22:31:09 $)
3397
3398 =over 4
3399
3400 =item DESCRIPTION
3401
3402 =over 4
3403
3404 =item How can I hope to use regular expressions without creating illegible
3405 and unmaintainable code?
3406
3407 Comments Outside the Regex, Comments Inside the Regex, Different Delimiters
3408
3409 =item I'm having trouble matching over more than one line.  What's wrong?
3410
3411 =item How can I pull out lines between two patterns that are themselves on
3412 different lines?
3413
3414 =item I put a regular expression into $/ but it didn't work. What's wrong?
3415
3416 =item How do I substitute case insensitively on the LHS while preserving
3417 case on the RHS?
3418
3419 =item How can I make C<\w> match national character sets?
3420
3421 =item How can I match a locale-smart version of C</[a-zA-Z]/>?
3422
3423 =item How can I quote a variable to use in a regex?
3424
3425 =item What is C</o> really for?
3426
3427 =item How do I use a regular expression to strip C style comments from a
3428 file?
3429
3430 =item Can I use Perl regular expressions to match balanced text?
3431
3432 =item What does it mean that regexes are greedy?  How can I get around it?
3433
3434 =item How do I process each word on each line?
3435
3436 =item How can I print out a word-frequency or line-frequency summary?
3437
3438 =item How can I do approximate matching?
3439
3440 =item How do I efficiently match many regular expressions at once?
3441
3442 =item Why don't word-boundary searches with C<\b> work for me?
3443
3444 =item Why does using $&, $`, or $' slow my program down?
3445
3446 =item What good is C<\G> in a regular expression?
3447
3448 =item Are Perl regexes DFAs or NFAs?  Are they POSIX compliant?
3449
3450 =item What's wrong with using grep or map in a void context?
3451
3452 =item How can I match strings with multibyte characters?
3453
3454 =item How do I match a pattern that is supplied by the user?
3455
3456 =back
3457
3458 =item AUTHOR AND COPYRIGHT
3459
3460 =back
3461
3462 =head2 perlfaq7 - General Perl Language Issues ($Revision: 1.8 $, $Date:
3463 2002/03/26 15:48:32 $)
3464
3465 =over 4
3466
3467 =item DESCRIPTION
3468
3469 =over 4
3470
3471 =item Can I get a BNF/yacc/RE for the Perl language?
3472
3473 =item What are all these $@%&* punctuation signs, and how do I know when to
3474 use them?
3475
3476 =item Do I always/never have to quote my strings or use semicolons and
3477 commas?
3478
3479 =item How do I skip some return values?
3480
3481 =item How do I temporarily block warnings?
3482
3483 =item What's an extension?
3484
3485 =item Why do Perl operators have different precedence than C operators?
3486
3487 =item How do I declare/create a structure?
3488
3489 =item How do I create a module?
3490
3491 =item How do I create a class?
3492
3493 =item How can I tell if a variable is tainted?
3494
3495 =item What's a closure?
3496
3497 =item What is variable suicide and how can I prevent it?
3498
3499 =item How can I pass/return a {Function, FileHandle, Array, Hash, Method,
3500 Regex}?
3501
3502 Passing Variables and Functions, Passing Filehandles, Passing Regexes,
3503 Passing Methods
3504
3505 =item How do I create a static variable?
3506
3507 =item What's the difference between dynamic and lexical (static) scoping?
3508 Between local() and my()?
3509
3510 =item How can I access a dynamic variable while a similarly named lexical
3511 is in scope?
3512
3513 =item What's the difference between deep and shallow binding?
3514
3515 =item Why doesn't "my($foo) = <FILE>;" work right?
3516
3517 =item How do I redefine a builtin function, operator, or method?
3518
3519 =item What's the difference between calling a function as &foo and foo()?
3520
3521 =item How do I create a switch or case statement?
3522
3523 =item How can I catch accesses to undefined variables/functions/methods?
3524
3525 =item Why can't a method included in this same file be found?
3526
3527 =item How can I find out my current package?
3528
3529 =item How can I comment out a large block of perl code?
3530
3531 =item How do I clear a package?
3532
3533 =item How can I use a variable as a variable name?
3534
3535 =back
3536
3537 =item AUTHOR AND COPYRIGHT
3538
3539 =back
3540
3541 =head2 perlfaq8 - System Interaction ($Revision: 1.8 $, $Date: 2002/05/16
3542 12:41:42 $)
3543
3544 =over 4
3545
3546 =item DESCRIPTION
3547
3548 =over 4
3549
3550 =item How do I find out which operating system I'm running under?
3551
3552 =item How come exec() doesn't return?
3553
3554 =item How do I do fancy stuff with the keyboard/screen/mouse?
3555
3556 Keyboard, Screen, Mouse
3557
3558 =item How do I print something out in color?
3559
3560 =item How do I read just one key without waiting for a return key?
3561
3562 =item How do I check whether input is ready on the keyboard?
3563
3564 =item How do I clear the screen?
3565
3566 =item How do I get the screen size?
3567
3568 =item How do I ask the user for a password?
3569
3570 =item How do I read and write the serial port?
3571
3572 lockfiles, open mode, end of line, flushing output, non-blocking input
3573
3574 =item How do I decode encrypted password files?
3575
3576 =item How do I start a process in the background?
3577
3578 STDIN, STDOUT, and STDERR are shared, Signals, Zombies
3579
3580 =item How do I trap control characters/signals?
3581
3582 =item How do I modify the shadow password file on a Unix system?
3583
3584 =item How do I set the time and date?
3585
3586 =item How can I sleep() or alarm() for under a second?
3587
3588 =item How can I measure time under a second?
3589
3590 =item How can I do an atexit() or setjmp()/longjmp()? (Exception handling)
3591
3592 =item Why doesn't my sockets program work under System V (Solaris)?  What
3593 does the error message "Protocol not supported" mean?
3594
3595 =item How can I call my system's unique C functions from Perl?
3596
3597 =item Where do I get the include files to do ioctl() or syscall()?
3598
3599 =item Why do setuid perl scripts complain about kernel problems?
3600
3601 =item How can I open a pipe both to and from a command?
3602
3603 =item Why can't I get the output of a command with system()?
3604
3605 =item How can I capture STDERR from an external command?
3606
3607 =item Why doesn't open() return an error when a pipe open fails?
3608
3609 =item What's wrong with using backticks in a void context?
3610
3611 =item How can I call backticks without shell processing?
3612
3613 =item Why can't my script read from STDIN after I gave it EOF (^D on Unix,
3614 ^Z on MS-DOS)?
3615
3616 =item How can I convert my shell script to perl?
3617
3618 =item Can I use perl to run a telnet or ftp session?
3619
3620 =item How can I write expect in Perl?
3621
3622 =item Is there a way to hide perl's command line from programs such as
3623 "ps"?
3624
3625 =item I {changed directory, modified my environment} in a perl script.  How
3626 come the change disappeared when I exited the script?  How do I get my
3627 changes to be visible?
3628
3629 Unix
3630
3631 =item How do I close a process's filehandle without waiting for it to
3632 complete?
3633
3634 =item How do I fork a daemon process?
3635
3636 =item How do I find out if I'm running interactively or not?
3637
3638 =item How do I timeout a slow event?
3639
3640 =item How do I set CPU limits?
3641
3642 =item How do I avoid zombies on a Unix system?
3643
3644 =item How do I use an SQL database?
3645
3646 =item How do I make a system() exit on control-C?
3647
3648 =item How do I open a file without blocking?
3649
3650 =item How do I install a module from CPAN?
3651
3652 =item What's the difference between require and use?
3653
3654 =item How do I keep my own module/library directory?
3655
3656 =item How do I add the directory my program lives in to the module/library
3657 search path?
3658
3659 =item How do I add a directory to my include path at runtime?
3660
3661 =item What is socket.ph and where do I get it?
3662
3663 =back
3664
3665 =item AUTHOR AND COPYRIGHT
3666
3667 =back
3668
3669 =head2 perlfaq9 - Networking ($Revision: 1.9 $, $Date: 2002/04/07 18:46:13
3670 $)
3671
3672 =over 4
3673
3674 =item DESCRIPTION
3675
3676 =over 4
3677
3678 =item What is the correct form of response from a CGI script?
3679
3680 =item My CGI script runs from the command line but not the browser.  (500
3681 Server Error)
3682
3683 =item How can I get better error messages from a CGI program?
3684
3685 =item How do I remove HTML from a string?
3686
3687 =item How do I extract URLs?
3688
3689 =item How do I download a file from the user's machine?  How do I open a
3690 file on another machine?
3691
3692 =item How do I make a pop-up menu in HTML?
3693
3694 =item How do I fetch an HTML file?
3695
3696 =item How do I automate an HTML form submission?
3697
3698 =item How do I decode or create those %-encodings on the web?
3699
3700 =item How do I redirect to another page?
3701
3702 =item How do I put a password on my web pages?
3703
3704 =item How do I edit my .htpasswd and .htgroup files with Perl?
3705
3706 =item How do I make sure users can't enter values into a form that cause my
3707 CGI script to do bad things?
3708
3709 =item How do I parse a mail header?
3710
3711 =item How do I decode a CGI form?
3712
3713 =item How do I check a valid mail address?
3714
3715 =item How do I decode a MIME/BASE64 string?
3716
3717 =item How do I return the user's mail address?
3718
3719 =item How do I send mail?
3720
3721 =item How do I use MIME to make an attachment to a mail message?
3722
3723 =item How do I read mail?
3724
3725 =item How do I find out my hostname/domainname/IP address?
3726
3727 =item How do I fetch a news article or the active newsgroups?
3728
3729 =item How do I fetch/put an FTP file?
3730
3731 =item How can I do RPC in Perl?
3732
3733 =back
3734
3735 =item AUTHOR AND COPYRIGHT
3736
3737 =back
3738
3739 =head2 perlcompile - Introduction to the Perl Compiler-Translator
3740
3741 =over 4
3742
3743 =item DESCRIPTION
3744
3745 =over 4
3746
3747 =item Layout
3748
3749 B::Bytecode, B::C, B::CC, B::Lint, B::Deparse, B::Xref
3750
3751 =back
3752
3753 =item Using The Back Ends
3754
3755 =over 4
3756
3757 =item The Cross Referencing Back End
3758
3759 i, &, s, r
3760
3761 =item The Decompiling Back End
3762
3763 =item The Lint Back End
3764
3765 =item The Simple C Back End
3766
3767 =item The Bytecode Back End
3768
3769 =item The Optimized C Back End
3770
3771 =back
3772
3773 =item Module List for the Compiler Suite
3774
3775 B, O, B::Asmdata, B::Assembler, B::Bblock, B::Bytecode, B::C, B::CC,
3776 B::Concise, B::Debug, B::Deparse, B::Disassembler, B::Lint, B::Showlex,
3777 B::Stackobj, B::Stash, B::Terse, B::Xref
3778
3779 =item KNOWN PROBLEMS
3780
3781 =item AUTHOR
3782
3783 =back
3784
3785 =head2 perlembed - how to embed perl in your C program
3786
3787 =over 4
3788
3789 =item DESCRIPTION
3790
3791 =over 4
3792
3793 =item PREAMBLE
3794
3795 B<Use C from Perl?>, B<Use a Unix program from Perl?>, B<Use Perl from
3796 Perl?>, B<Use C from C?>, B<Use Perl from C?>
3797
3798 =item ROADMAP
3799
3800 =item Compiling your C program
3801
3802 =item Adding a Perl interpreter to your C program
3803
3804 =item Calling a Perl subroutine from your C program
3805
3806 =item Evaluating a Perl statement from your C program
3807
3808 =item Performing Perl pattern matches and substitutions from your C program
3809
3810 =item Fiddling with the Perl stack from your C program
3811
3812 =item Maintaining a persistent interpreter
3813
3814 =item Execution of END blocks
3815
3816 =item Maintaining multiple interpreter instances
3817
3818 =item Using Perl modules, which themselves use C libraries, from your C
3819 program
3820
3821 =back
3822
3823 =item Embedding Perl under Win32
3824
3825 =item MORAL
3826
3827 =item AUTHOR
3828
3829 =item COPYRIGHT
3830
3831 =back
3832
3833 =head2 perldebguts - Guts of Perl debugging
3834
3835 =over 4
3836
3837 =item DESCRIPTION
3838
3839 =item Debugger Internals
3840
3841 =over 4
3842
3843 =item Writing Your Own Debugger
3844
3845 =back
3846
3847 =item Frame Listing Output Examples
3848
3849 =item Debugging regular expressions
3850
3851 =over 4
3852
3853 =item Compile-time output
3854
3855 C<anchored> I<STRING> C<at> I<POS>, C<floating> I<STRING> C<at>
3856 I<POS1..POS2>, C<matching floating/anchored>, C<minlen>, C<stclass>
3857 I<TYPE>, C<noscan>, C<isall>, C<GPOS>, C<plus>, C<implicit>, C<with eval>,
3858 C<anchored(TYPE)>
3859
3860 =item Types of nodes
3861
3862 =item Run-time output
3863
3864 =back
3865
3866 =item Debugging Perl memory usage
3867
3868 =over 4
3869
3870 =item Using C<$ENV{PERL_DEBUG_MSTATS}>
3871
3872 C<buckets SMALLEST(APPROX)..GREATEST(APPROX)>, Free/Used, C<Total sbrk():
3873 SBRKed/SBRKs:CONTINUOUS>, C<pad: 0>, C<heads: 2192>, C<chain: 0>, C<tail:
3874 6144>
3875
3876 =item Example of using B<-DL> switch
3877
3878 C<717>, C<002>, C<054>, C<602>, C<702>, C<704>
3879
3880 =item B<-DL> details
3881
3882 C<!!!>, C<!!>, C<!>
3883
3884 =item Limitations of B<-DL> statistics
3885
3886 =back
3887
3888 =item SEE ALSO
3889
3890 =back
3891
3892 =head2 perlxstut, perlXStut - Tutorial for writing XSUBs
3893
3894 =over 4
3895
3896 =item DESCRIPTION
3897
3898 =item SPECIAL NOTES
3899
3900 =over 4
3901
3902 =item make
3903
3904 =item Version caveat
3905
3906 =item Dynamic Loading versus Static Loading
3907
3908 =back
3909
3910 =item TUTORIAL
3911
3912 =over 4
3913
3914 =item EXAMPLE 1
3915
3916 =item EXAMPLE 2
3917
3918 =item What has gone on?
3919
3920 =item Writing good test scripts
3921
3922 =item EXAMPLE 3
3923
3924 =item What's new here?
3925
3926 =item Input and Output Parameters
3927
3928 =item The XSUBPP Program
3929
3930 =item The TYPEMAP file
3931
3932 =item Warning about Output Arguments
3933
3934 =item EXAMPLE 4
3935
3936 =item What has happened here?
3937
3938 =item Anatomy of .xs file
3939
3940 =item Getting the fat out of XSUBs
3941
3942 =item More about XSUB arguments
3943
3944 =item The Argument Stack
3945
3946 =item Extending your Extension
3947
3948 =item Documenting your Extension
3949
3950 =item Installing your Extension
3951
3952 =item EXAMPLE 5
3953
3954 =item New Things in this Example
3955
3956 =item EXAMPLE 6
3957
3958 =item New Things in this Example
3959
3960 =item EXAMPLE 7 (Coming Soon)
3961
3962 =item EXAMPLE 8 (Coming Soon)
3963
3964 =item EXAMPLE 9 Passing open files to XSes
3965
3966 =item Troubleshooting these Examples
3967
3968 =back
3969
3970 =item See also
3971
3972 =item Author
3973
3974 =over 4
3975
3976 =item Last Changed
3977
3978 =back
3979
3980 =back
3981
3982 =head2 perlxs - XS language reference manual
3983
3984 =over 4
3985
3986 =item DESCRIPTION
3987
3988 =over 4
3989
3990 =item Introduction
3991
3992 =item On The Road
3993
3994 =item The Anatomy of an XSUB
3995
3996 =item The Argument Stack
3997
3998 =item The RETVAL Variable
3999
4000 =item The MODULE Keyword
4001
4002 =item The PACKAGE Keyword
4003
4004 =item The PREFIX Keyword
4005
4006 =item The OUTPUT: Keyword
4007
4008 =item The NO_OUTPUT Keyword
4009
4010 =item The CODE: Keyword
4011
4012 =item The INIT: Keyword
4013
4014 =item The NO_INIT Keyword
4015
4016 =item Initializing Function Parameters
4017
4018 =item Default Parameter Values
4019
4020 =item The PREINIT: Keyword
4021
4022 =item The SCOPE: Keyword
4023
4024 =item The INPUT: Keyword
4025
4026 =item The IN/OUTLIST/IN_OUTLIST/OUT/IN_OUT Keywords
4027
4028 =item The C<length(NAME)> Keyword
4029
4030 =item Variable-length Parameter Lists
4031
4032 =item The C_ARGS: Keyword
4033
4034 =item The PPCODE: Keyword
4035
4036 =item Returning Undef And Empty Lists
4037
4038 =item The REQUIRE: Keyword
4039
4040 =item The CLEANUP: Keyword
4041
4042 =item The POSTCALL: Keyword
4043
4044 =item The BOOT: Keyword
4045
4046 =item The VERSIONCHECK: Keyword
4047
4048 =item The PROTOTYPES: Keyword
4049
4050 =item The PROTOTYPE: Keyword
4051
4052 =item The ALIAS: Keyword
4053
4054 =item The OVERLOAD: Keyword
4055
4056 =item The INTERFACE: Keyword
4057
4058 =item The INTERFACE_MACRO: Keyword
4059
4060 =item The INCLUDE: Keyword
4061
4062 =item The CASE: Keyword
4063
4064 =item The & Unary Operator
4065
4066 =item Inserting POD, Comments and C Preprocessor Directives
4067
4068 =item Using XS With C++
4069
4070 =item Interface Strategy
4071
4072 =item Perl Objects And C Structures
4073
4074 =item The Typemap
4075
4076 =item Safely Storing Static Data in XS
4077
4078 MY_CXT_KEY, typedef my_cxt_t, START_MY_CXT, MY_CXT_INIT, dMY_CXT, MY_CXT
4079
4080 =back
4081
4082 =item EXAMPLES
4083
4084 =item XS VERSION
4085
4086 =item AUTHOR
4087
4088 =back
4089
4090 =head2 perlclib - Internal replacements for standard C library functions
4091
4092 =over 4
4093
4094 =item DESCRIPTION
4095
4096 =over 4
4097
4098 =item Conventions
4099
4100 C<t>, C<p>, C<n>, C<s>
4101
4102 =item File Operations
4103
4104 =item File Input and Output
4105
4106 =item File Positioning
4107
4108 =item Memory Management and String Handling
4109
4110 =item Character Class Tests
4111
4112 =item F<stdlib.h> functions
4113
4114 =item Miscellaneous functions
4115
4116 =back
4117
4118 =item SEE ALSO
4119
4120 =back
4121
4122 =head2 perlguts - Introduction to the Perl API
4123
4124 =over 4
4125
4126 =item DESCRIPTION
4127
4128 =item Variables
4129
4130 =over 4
4131
4132 =item Datatypes
4133
4134 =item What is an "IV"?
4135
4136 =item Working with SVs
4137
4138 =item Offsets
4139
4140 =item What's Really Stored in an SV?
4141
4142 =item Working with AVs
4143
4144 =item Working with HVs
4145
4146 =item Hash API Extensions
4147
4148 =item References
4149
4150 =item Blessed References and Class Objects
4151
4152 =item Creating New Variables
4153
4154 GV_ADDMULTI, GV_ADDWARN
4155
4156 =item Reference Counts and Mortality
4157
4158 =item Stashes and Globs
4159
4160 =item Double-Typed SVs
4161
4162 =item Magic Variables
4163
4164 =item Assigning Magic
4165
4166 =item Magic Virtual Tables
4167
4168 =item Finding Magic
4169
4170 =item Understanding the Magic of Tied Hashes and Arrays
4171
4172 =item Localizing changes
4173
4174 C<SAVEINT(int i)>, C<SAVEIV(IV i)>, C<SAVEI32(I32 i)>, C<SAVELONG(long i)>,
4175 C<SAVESPTR(s)>, C<SAVEPPTR(p)>, C<SAVEFREESV(SV *sv)>, C<SAVEMORTALIZESV(SV
4176 *sv)>, C<SAVEFREEOP(OP *op)>, C<SAVEFREEPV(p)>, C<SAVECLEARSV(SV *sv)>,
4177 C<SAVEDELETE(HV *hv, char *key, I32 length)>,
4178 C<SAVEDESTRUCTOR(DESTRUCTORFUNC_NOCONTEXT_t f, void *p)>,
4179 C<SAVEDESTRUCTOR_X(DESTRUCTORFUNC_t f, void *p)>, C<SAVESTACK_POS()>, C<SV*
4180 save_scalar(GV *gv)>, C<AV* save_ary(GV *gv)>, C<HV* save_hash(GV *gv)>,
4181 C<void save_item(SV *item)>, C<void save_list(SV **sarg, I32 maxsarg)>,
4182 C<SV* save_svref(SV **sptr)>, C<void save_aptr(AV **aptr)>, C<void
4183 save_hptr(HV **hptr)>
4184
4185 =back
4186
4187 =item Subroutines
4188
4189 =over 4
4190
4191 =item XSUBs and the Argument Stack
4192
4193 =item Calling Perl Routines from within C Programs
4194
4195 =item Memory Allocation
4196
4197 =item PerlIO
4198
4199 =item Putting a C value on Perl stack
4200
4201 =item Scratchpads
4202
4203 =item Scratchpads and recursion
4204
4205 =back
4206
4207 =item Compiled code
4208
4209 =over 4
4210
4211 =item Code tree
4212
4213 =item Examining the tree
4214
4215 =item Compile pass 1: check routines
4216
4217 =item Compile pass 1a: constant folding
4218
4219 =item Compile pass 2: context propagation
4220
4221 =item Compile pass 3: peephole optimization
4222
4223 =item Pluggable runops
4224
4225 =back
4226
4227 =item Examining internal data structures with the C<dump> functions
4228
4229 =item How multiple interpreters and concurrency are supported
4230
4231 =over 4
4232
4233 =item Background and PERL_IMPLICIT_CONTEXT
4234
4235 =item So what happened to dTHR?
4236
4237 =item How do I use all this in extensions?
4238
4239 =item Should I do anything special if I call perl from multiple threads?
4240
4241 =item Future Plans and PERL_IMPLICIT_SYS
4242
4243 =back
4244
4245 =item Internal Functions
4246
4247 A, p, d, s, n, r, f, M, o, j, x
4248
4249 =over 4
4250
4251 =item Formatted Printing of IVs, UVs, and NVs
4252
4253 =item Pointer-To-Integer and Integer-To-Pointer
4254
4255 =item Source Documentation
4256
4257 =back
4258
4259 =item Unicode Support
4260
4261 =over 4
4262
4263 =item What B<is> Unicode, anyway?
4264
4265 =item How can I recognise a UTF8 string?
4266
4267 =item How does UTF8 represent Unicode characters?
4268
4269 =item How does Perl store UTF8 strings?
4270
4271 =item How do I convert a string to UTF8?
4272
4273 =item Is there anything else I need to know?
4274
4275 =back
4276
4277 =item Custom Operators
4278
4279 =item AUTHORS
4280
4281 =item SEE ALSO
4282
4283 =back
4284
4285 =head2 perlcall - Perl calling conventions from C
4286
4287 =over 4
4288
4289 =item DESCRIPTION
4290
4291 An Error Handler, An Event Driven Program
4292
4293 =item THE CALL_ FUNCTIONS
4294
4295 call_sv, call_pv, call_method, call_argv
4296
4297 =item FLAG VALUES
4298
4299 =over 4
4300
4301 =item  G_VOID
4302
4303 =item  G_SCALAR
4304
4305 =item G_ARRAY
4306
4307 =item G_DISCARD
4308
4309 =item G_NOARGS
4310
4311 =item G_EVAL
4312
4313 =item G_KEEPERR
4314
4315 =item Determining the Context
4316
4317 =back
4318
4319 =item KNOWN PROBLEMS
4320
4321 =item EXAMPLES
4322
4323 =over 4
4324
4325 =item No Parameters, Nothing returned
4326
4327 =item Passing Parameters
4328
4329 =item Returning a Scalar
4330
4331 =item Returning a list of values
4332
4333 =item Returning a list in a scalar context
4334
4335 =item Returning Data from Perl via the parameter list
4336
4337 =item Using G_EVAL
4338
4339 =item Using G_KEEPERR
4340
4341 =item Using call_sv
4342
4343 =item Using call_argv
4344
4345 =item Using call_method
4346
4347 =item Using GIMME_V
4348
4349 =item Using Perl to dispose of temporaries
4350
4351 =item Strategies for storing Callback Context Information
4352
4353 1. Ignore the problem - Allow only 1 callback, 2. Create a sequence of
4354 callbacks - hard wired limit, 3. Use a parameter to map to the Perl
4355 callback
4356
4357 =item Alternate Stack Manipulation
4358
4359 =item Creating and calling an anonymous subroutine in C
4360
4361 =back
4362
4363 =item SEE ALSO
4364
4365 =item AUTHOR
4366
4367 =item DATE
4368
4369 =back
4370
4371 =head2 perlutil - utilities packaged with the Perl distribution
4372
4373 =over 4
4374
4375 =item DESCRIPTION
4376
4377 =over 4
4378
4379 =item DOCUMENTATION
4380
4381 L<perldoc|perldoc>, L<pod2man|pod2man> and L<pod2text|pod2text>,
4382 L<pod2html|pod2html> and L<pod2latex|pod2latex>, L<pod2usage|pod2usage>,
4383 L<podselect|podselect>, L<podchecker|podchecker>, L<splain|splain>,
4384 L<roffitall|roffitall>
4385
4386 =item CONVERTORS
4387
4388 L<a2p|a2p>, L<s2p|s2p>, L<find2perl|find2perl>
4389
4390 =item Administration
4391
4392 L<libnetcfg|libnetcfg>
4393
4394 =item Development
4395
4396 L<perlbug|perlbug>, L<h2ph|h2ph>, L<c2ph|c2ph> and L<pstruct|pstruct>,
4397 L<h2xs|h2xs>, L<dprofpp|dprofpp>, L<perlcc|perlcc>
4398
4399 =item SEE ALSO
4400
4401 =back
4402
4403 =back
4404
4405 =head2 perlfilter - Source Filters
4406
4407 =over 4
4408
4409 =item DESCRIPTION
4410
4411 =item CONCEPTS
4412
4413 =item USING FILTERS
4414
4415 =item WRITING A SOURCE FILTER
4416
4417 =item WRITING A SOURCE FILTER IN C
4418
4419 B<Decryption Filters>
4420
4421 =item CREATING A SOURCE FILTER AS A SEPARATE EXECUTABLE
4422
4423 =item WRITING A SOURCE FILTER IN PERL
4424
4425 =item USING CONTEXT: THE DEBUG FILTER
4426
4427 =item CONCLUSION
4428
4429 =item REQUIREMENTS
4430
4431 =item AUTHOR
4432
4433 =item Copyrights
4434
4435 =back
4436
4437 =head2 perldbmfilter - Perl DBM Filters
4438
4439 =over 4
4440
4441 =item SYNOPSIS
4442
4443 =item DESCRIPTION
4444
4445 B<filter_store_key>, B<filter_store_value>, B<filter_fetch_key>,
4446 B<filter_fetch_value>
4447
4448 =over 4
4449
4450 =item The Filter
4451
4452 =item An Example -- the NULL termination problem.
4453
4454 =item Another Example -- Key is a C int.
4455
4456 =back
4457
4458 =item SEE ALSO
4459
4460 =item AUTHOR
4461
4462 =back
4463
4464 =head2 perlapi - autogenerated documentation for the perl public API
4465
4466 =over 4
4467
4468 =item DESCRIPTION
4469
4470 =item "Gimme" Values
4471
4472 GIMME, GIMME_V, G_ARRAY, G_DISCARD, G_EVAL, G_NOARGS, G_SCALAR, G_VOID
4473
4474 =item Array Manipulation Functions
4475
4476 AvFILL, av_clear, av_delete, av_exists, av_extend, av_fetch, av_fill,
4477 av_len, av_make, av_pop, av_push, av_shift, av_store, av_undef, av_unshift,
4478 get_av, newAV, Nullav, sortsv
4479
4480 =item Callback Functions
4481
4482 call_argv, call_method, call_pv, call_sv, ENTER, eval_pv, eval_sv,
4483 FREETMPS, LEAVE, SAVETMPS
4484
4485 =item Character classes
4486
4487 isALNUM, isALPHA, isDIGIT, isLOWER, isSPACE, isUPPER, toLOWER, toUPPER
4488
4489 =item Cloning an interpreter
4490
4491 perl_clone
4492
4493 =item CV Manipulation Functions
4494
4495 CvSTASH, get_cv, Nullcv
4496
4497 =item Embedding Functions
4498
4499 load_module, nothreadhook, perl_alloc, perl_construct, perl_destruct,
4500 perl_free, perl_parse, perl_run, require_pv
4501
4502 =item Functions in file pp_pack.c
4503
4504 pack_cat, unpack_str
4505
4506 =item Global Variables
4507
4508 PL_modglobal, PL_na, PL_sv_no, PL_sv_undef, PL_sv_yes
4509
4510 =item GV Functions
4511
4512 GvSV, gv_fetchmeth, gv_fetchmethod, gv_fetchmethod_autoload,
4513 gv_fetchmeth_autoload, gv_stashpv, gv_stashsv
4514
4515 =item Handy Values
4516
4517 HEf_SVKEY, Nullch, Nullsv
4518
4519 =item Hash Manipulation Functions
4520
4521 get_hv, HeHASH, HeKEY, HeKLEN, HePV, HeSVKEY, HeSVKEY_force, HeSVKEY_set,
4522 HeVAL, HvNAME, hv_clear, hv_delete, hv_delete_ent, hv_exists,
4523 hv_exists_ent, hv_fetch, hv_fetch_ent, hv_iterinit, hv_iterkey,
4524 hv_iterkeysv, hv_iternext, hv_iternextsv, hv_iternext_flags, hv_iterval,
4525 hv_magic, hv_store, hv_store_ent, hv_undef, newHV, Nullhv
4526
4527 =item Magical Functions
4528
4529 mg_clear, mg_copy, mg_find, mg_free, mg_get, mg_length, mg_magical, mg_set,
4530 SvGETMAGIC, SvLOCK, SvSETMAGIC, SvSetMagicSV, SvSetMagicSV_nosteal,
4531 SvSetSV, SvSetSV_nosteal, SvSHARE
4532
4533 =item Memory Management
4534
4535 Copy, Move, New, Newc, NEWSV, Newz, Poison, Renew, Renewc, Safefree,
4536 savepv, savepvn, savesharedpv, StructCopy, Zero
4537
4538 =item Miscellaneous Functions
4539
4540 fbm_compile, fbm_instr, form, getcwd_sv, strEQ, strGE, strGT, strLE, strLT,
4541 strNE, strnEQ, strnNE
4542
4543 =item Numeric functions
4544
4545 grok_bin, grok_hex, grok_number, grok_numeric_radix, grok_oct, scan_bin,
4546 scan_hex, scan_oct
4547
4548 =item Optree Manipulation Functions
4549
4550 cv_const_sv, newCONSTSUB, newXS
4551
4552 =item Stack Manipulation Macros
4553
4554 dMARK, dORIGMARK, dSP, EXTEND, MARK, ORIGMARK, POPi, POPl, POPn, POPp,
4555 POPpbytex, POPpx, POPs, PUSHi, PUSHMARK, PUSHn, PUSHp, PUSHs, PUSHu,
4556 PUTBACK, SP, SPAGAIN, XPUSHi, XPUSHn, XPUSHp, XPUSHs, XPUSHu, XSRETURN,
4557 XSRETURN_IV, XSRETURN_NO, XSRETURN_NV, XSRETURN_PV, XSRETURN_UNDEF,
4558 XSRETURN_YES, XST_mIV, XST_mNO, XST_mNV, XST_mPV, XST_mUNDEF, XST_mYES
4559
4560 =item SV Flags
4561
4562 svtype, SVt_IV, SVt_NV, SVt_PV, SVt_PVAV, SVt_PVCV, SVt_PVHV, SVt_PVMG
4563
4564 =item SV Manipulation Functions
4565
4566 get_sv, looks_like_number, newRV_inc, newRV_noinc, newSV, newSViv, newSVnv,
4567 newSVpv, newSVpvf, newSVpvn, newSVpvn_share, newSVrv, newSVsv, newSVuv,
4568 new_vstring, SvCUR, SvCUR_set, SvEND, SvGROW, SvIOK, SvIOKp, SvIOK_notUV,
4569 SvIOK_off, SvIOK_on, SvIOK_only, SvIOK_only_UV, SvIOK_UV, SvIV, SvIVx,
4570 SvIVX, SvLEN, SvNIOK, SvNIOKp, SvNIOK_off, SvNOK, SvNOKp, SvNOK_off,
4571 SvNOK_on, SvNOK_only, SvNV, SvNVX, SvNVx, SvOK, SvOOK, SvPOK, SvPOKp,
4572 SvPOK_off, SvPOK_on, SvPOK_only, SvPOK_only_UTF8, SvPV, SvPVbyte,
4573 SvPVbytex, SvPVbytex_force, SvPVbyte_force, SvPVbyte_nolen, SvPVutf8,
4574 SvPVutf8x, SvPVutf8x_force, SvPVutf8_force, SvPVutf8_nolen, SvPVx, SvPVX,
4575 SvPV_force, SvPV_force_nomg, SvPV_nolen, SvREFCNT, SvREFCNT_dec,
4576 SvREFCNT_inc, SvROK, SvROK_off, SvROK_on, SvRV, SvSTASH, SvTAINT,
4577 SvTAINTED, SvTAINTED_off, SvTAINTED_on, SvTRUE, SvTYPE, SvUNLOCK, SvUOK,
4578 SvUPGRADE, SvUTF8, SvUTF8_off, SvUTF8_on, SvUV, SvUVX, SvUVx, sv_2bool,
4579 sv_2cv, sv_2io, sv_2iv, sv_2mortal, sv_2nv, sv_2pvbyte, sv_2pvbyte_nolen,
4580 sv_2pvutf8, sv_2pvutf8_nolen, sv_2pv_flags, sv_2pv_nolen, sv_2uv,
4581 sv_backoff, sv_bless, sv_catpv, sv_catpvf, sv_catpvf_mg, sv_catpvn,
4582 sv_catpvn_flags, sv_catpvn_mg, sv_catpv_mg, sv_catsv, sv_catsv_flags,
4583 sv_catsv_mg, sv_chop, sv_clear, sv_cmp, sv_cmp_locale, sv_collxfrm,
4584 sv_copypv, sv_dec, sv_derived_from, sv_eq, sv_force_normal,
4585 sv_force_normal_flags, sv_free, sv_gets, sv_grow, sv_inc, sv_insert,
4586 sv_isa, sv_isobject, sv_iv, sv_len, sv_len_utf8, sv_magic, sv_magicext,
4587 sv_mortalcopy, sv_newmortal, sv_newref, sv_nolocking, sv_nosharing,
4588 sv_nounlocking, sv_nv, sv_pos_b2u, sv_pos_u2b, sv_pv, sv_pvbyte,
4589 sv_pvbyten, sv_pvbyten_force, sv_pvn, sv_pvn_force, sv_pvn_force_flags,
4590 sv_pvutf8, sv_pvutf8n, sv_pvutf8n_force, sv_reftype, sv_replace,
4591 sv_report_used, sv_reset, sv_rvweaken, sv_setiv, sv_setiv_mg, sv_setnv,
4592 sv_setnv_mg, sv_setpv, sv_setpvf, sv_setpvf_mg, sv_setpvn, sv_setpvn_mg,
4593 sv_setpv_mg, sv_setref_iv, sv_setref_nv, sv_setref_pv, sv_setref_pvn,
4594 sv_setref_uv, sv_setsv, sv_setsv_flags, sv_setsv_mg, sv_setuv, sv_setuv_mg,
4595 sv_taint, sv_tainted, sv_true, sv_unmagic, sv_unref, sv_unref_flags,
4596 sv_untaint, sv_upgrade, sv_usepvn, sv_usepvn_mg, sv_utf8_decode,
4597 sv_utf8_downgrade, sv_utf8_encode, sv_utf8_upgrade, sv_utf8_upgrade_flags,
4598 sv_uv, sv_vcatpvfn, sv_vsetpvfn
4599
4600 =item Unicode Support
4601
4602 bytes_from_utf8, bytes_to_utf8, ibcmp_utf8, is_utf8_char, is_utf8_string,
4603 pv_uni_display, sv_recode_to_utf8, sv_uni_display, to_utf8_case,
4604 to_utf8_fold, to_utf8_lower, to_utf8_title, to_utf8_upper, utf8n_to_uvchr,
4605 utf8n_to_uvuni, utf8_distance, utf8_hop, utf8_length, utf8_to_bytes,
4606 utf8_to_uvchr, utf8_to_uvuni, uvchr_to_utf8, uvuni_to_utf8_flags
4607
4608 =item Variables created by C<xsubpp> and C<xsubpp> internal functions
4609
4610 ax, CLASS, dAX, dITEMS, dXSARGS, dXSI32, items, ix, newXSproto, RETVAL, ST,
4611 THIS, XS, XSRETURN_EMPTY, XS_VERSION, XS_VERSION_BOOTCHECK
4612
4613 =item Warning and Dieing
4614
4615 croak, warn
4616
4617 =item AUTHORS
4618
4619 =item SEE ALSO
4620
4621 =back
4622
4623 =head2 perlintern - autogenerated documentation of purely B<internal>
4624                  Perl functions
4625
4626 =over 4
4627
4628 =item DESCRIPTION
4629
4630 =item Global Variables
4631
4632 PL_DBsingle, PL_DBsub, PL_DBtrace, PL_dowarn, PL_last_in_gv, PL_ofs_sv,
4633 PL_rs
4634
4635 =item GV Functions
4636
4637 is_gv_magical
4638
4639 =item IO Functions
4640
4641 start_glob
4642
4643 =item Pad Data Structures
4644
4645 CvPADLIST
4646
4647 =item Stack Manipulation Macros
4648
4649 djSP, LVRET
4650
4651 =item SV Manipulation Functions
4652
4653 report_uninit, sv_add_arena, sv_clean_all, sv_clean_objs, sv_free_arenas
4654
4655 =item AUTHORS
4656
4657 =item SEE ALSO
4658
4659 =back
4660
4661 =head2 perliol - C API for Perl's implementation of IO in Layers.
4662
4663 =over 4
4664
4665 =item SYNOPSIS
4666
4667 =item DESCRIPTION
4668
4669 =over 4
4670
4671 =item History and Background
4672
4673 =item Layers vs Disciplines
4674
4675 =item Data Structures
4676
4677 =item Functions and Attributes
4678
4679 =item Per-instance Data
4680
4681 =item Layers in action.
4682
4683 =item Per-instance flag bits
4684
4685 PERLIO_F_EOF, PERLIO_F_CANWRITE,  PERLIO_F_CANREAD, PERLIO_F_ERROR,
4686 PERLIO_F_TRUNCATE, PERLIO_F_APPEND, PERLIO_F_CRLF, PERLIO_F_UTF8,
4687 PERLIO_F_UNBUF, PERLIO_F_WRBUF, PERLIO_F_RDBUF, PERLIO_F_LINEBUF,
4688 PERLIO_F_TEMP, PERLIO_F_OPEN, PERLIO_F_FASTGETS
4689
4690 =item Methods in Detail
4691
4692 fsize, name, size, kind, PERLIO_K_BUFFERED, PERLIO_K_RAW, PERLIO_K_CANCRLF,
4693 PERLIO_K_FASTGETS, PERLIO_K_MULTIARG, Pushed, Popped, Open, Binmode,
4694 Getarg, Fileno, Dup, Read, Write, Seek, Tell, Close, Flush, Fill, Eof,
4695 Error,  Clearerr, Setlinebuf, Get_base, Get_bufsiz, Get_ptr, Get_cnt,
4696 Set_ptrcnt
4697
4698 =item Core Layers
4699
4700 "unix", "perlio", "stdio", "crlf", "mmap", "pending", "raw", "utf8"
4701
4702 =item Extension Layers
4703
4704 ":encoding", ":scalar", ":via"
4705
4706 =back
4707
4708 =item TODO
4709
4710 =back
4711
4712 =head2 perlapio - perl's IO abstraction interface.
4713
4714 =over 4
4715
4716 =item SYNOPSIS
4717
4718 =item DESCRIPTION
4719
4720 1. USE_STDIO, 2. USE_SFIO, 3. USE_PERLIO, B<PerlIO_stdin()>,
4721 B<PerlIO_stdout()>, B<PerlIO_stderr()>, B<PerlIO_open(path, mode)>,
4722 B<PerlIO_fdopen(fd,mode)>, B<PerlIO_reopen(path,mode,f)>,
4723 B<PerlIO_printf(f,fmt,...)>, B<PerlIO_vprintf(f,fmt,a)>,
4724 B<PerlIO_stdoutf(fmt,...)>, B<PerlIO_read(f,buf,count)>,
4725 B<PerlIO_write(f,buf,count)>, B<PerlIO_close(f)>, B<PerlIO_puts(f,s)>,
4726 B<PerlIO_putc(f,c)>, B<PerlIO_ungetc(f,c)>, B<PerlIO_getc(f)>,
4727 B<PerlIO_eof(f)>, B<PerlIO_error(f)>, B<PerlIO_fileno(f)>,
4728 B<PerlIO_clearerr(f)>, B<PerlIO_flush(f)>, B<PerlIO_seek(f,offset,whence)>,
4729 B<PerlIO_tell(f)>, B<PerlIO_getpos(f,p)>, B<PerlIO_setpos(f,p)>,
4730 B<PerlIO_rewind(f)>, B<PerlIO_tmpfile()>, B<PerlIO_setlinebuf(f)>
4731
4732 =over 4
4733
4734 =item Co-existence with stdio
4735
4736 B<PerlIO_importFILE(f,mode)>, B<PerlIO_exportFILE(f,mode)>,
4737 B<PerlIO_releaseFILE(p,f)>, B<PerlIO_findFILE(f)>
4738
4739 =item "Fast gets" Functions
4740
4741 B<PerlIO_fast_gets(f)>, B<PerlIO_has_cntptr(f)>, B<PerlIO_get_cnt(f)>,
4742 B<PerlIO_get_ptr(f)>, B<PerlIO_set_ptrcnt(f,p,c)>, B<PerlIO_canset_cnt(f)>,
4743 B<PerlIO_set_cnt(f,c)>, B<PerlIO_has_base(f)>, B<PerlIO_get_base(f)>,
4744 B<PerlIO_get_bufsiz(f)>
4745
4746 =item Other Functions
4747
4748 PerlIO_apply_layers(f,mode,layers), PerlIO_binmode(f,ptype,imode,layers),
4749 'E<lt>' read, 'E<gt>' write, '+' read/write, PerlIO_debug(fmt,...)
4750
4751 =back
4752
4753 =back
4754
4755 =head2 perltodo - Perl TO-DO List
4756
4757 =over 4
4758
4759 =item DESCRIPTION
4760
4761 =item To do during 5.6.x
4762
4763 =over 4
4764
4765 =item Support for I/O disciplines
4766
4767 =item Autoload bytes.pm
4768
4769 =item Make "\u{XXXX}" et al work
4770
4771 =item Create a char *sv_pvprintify(sv, STRLEN *lenp, UV flags)
4772
4773 =item Overloadable regex assertions
4774
4775 =item Unicode
4776
4777 =item Work out exit/die semantics for threads
4778
4779 =item Better support for nonpreemptive threading systems like GNU pth
4780
4781 =item Typed lexicals for compiler
4782
4783 =item Compiler workarounds for Win32
4784
4785 =item AUTOLOADing in the compiler
4786
4787 =item Fixing comppadlist when compiling
4788
4789 =item Cleaning up exported namespace
4790
4791 =item Complete signal handling
4792
4793 =item Out-of-source builds
4794
4795 =item POSIX realtime support
4796
4797 =item UNIX98 support
4798
4799 =item IPv6 Support
4800
4801 =item Long double conversion
4802
4803 =item Locales
4804
4805 =item Arithmetic on non-Arabic numerals
4806
4807 =item POSIX Unicode character classes
4808
4809 =item Factoring out common suffices/prefices in regexps (trie optimization)
4810
4811 =item Security audit shipped utilities
4812
4813 =item Sort out the uid-setting mess
4814
4815 =item Custom opcodes
4816
4817 =item DLL Versioning
4818
4819 =item Introduce @( and @)
4820
4821 =item Floating point handling
4822
4823 =item IV/UV preservation
4824
4825 =item Replace pod2html with something using Pod::Parser
4826
4827 =item Automate module testing on CPAN
4828
4829 =item sendmsg and recvmsg
4830
4831 =item Rewrite perlre documentation
4832
4833 =item Convert example code to IO::Handle filehandles
4834
4835 =item Document Win32 choices
4836
4837 =item Check new modules
4838
4839 =item Make roffitall find pods and libs itself
4840
4841 =back
4842
4843 =item To do at some point
4844
4845 =over 4
4846
4847 =item Remove regular expression recursion
4848
4849 =item Memory leaks after failed eval
4850
4851 =item bitfields in pack
4852
4853 =item Cross compilation
4854
4855 =item Perl preprocessor / macros
4856
4857 =item Perl lexer in Perl
4858
4859 =item Using POSIX calls internally
4860
4861 =item -i rename file when changed
4862
4863 =item All ARGV input should act like E<lt>E<gt>
4864
4865 =item Support for rerunning debugger
4866
4867 =item Test Suite for the Debugger
4868
4869 =item my sub foo { }
4870
4871 =item One-pass global destruction
4872
4873 =item Rewrite regexp parser
4874
4875 =item Cache recently used regexps
4876
4877 =item Cross-compilation support
4878
4879 =item Bit-shifting bitvectors
4880
4881 =item debugger pragma
4882
4883 =item use less pragma
4884
4885 =item switch structures
4886
4887 =item Cache eval tree
4888
4889 =item rcatmaybe
4890
4891 =item Shrink opcode tables
4892
4893 =item Optimize away @_
4894
4895 =item Prototypes versus indirect objects
4896
4897 =item Install HTML
4898
4899 =item Prototype method calls
4900
4901 =item Return context prototype declarations
4902
4903 =item magic_setisa
4904
4905 =item Garbage collection
4906
4907 =item IO tutorial
4908
4909 =item Rewrite perldoc
4910
4911 =item Install .3p manpages
4912
4913 =item Unicode tutorial
4914
4915 =item Update POSIX.pm for 1003.1-2
4916
4917 =item Retargetable installation
4918
4919 =item POSIX emulation on non-POSIX systems
4920
4921 =item Rename Win32 headers
4922
4923 =item Finish off lvalue functions
4924
4925 =item Update sprintf documentation
4926
4927 =item Use fchown/fchmod internally
4928
4929 =item Make v-strings overloaded objects
4930
4931 =item Allow restricted hash assignment
4932
4933 =item Should overload be inheritable?
4934
4935 =item Taint rethink
4936
4937 =back
4938
4939 =item Vague ideas
4940
4941 =over 4
4942
4943 =item ref() in list context
4944
4945 =item Make tr/// return histogram of characters in list context
4946
4947 =item Compile to real threaded code
4948
4949 =item Structured types
4950
4951 =item Modifiable $1 et al.
4952
4953 =item Procedural interfaces for IO::*, etc.
4954
4955 =item RPC modules
4956
4957 =item Attach/detach debugger from running program
4958
4959 =item GUI::Native
4960
4961 =item foreach(reverse ...)
4962
4963 =item Constant function cache
4964
4965 =item Approximate regular expression matching
4966
4967 =back
4968
4969 =item Ongoing
4970
4971 =over 4
4972
4973 =item Update guts documentation
4974
4975 =item Add more tests
4976
4977 =item Update auxiliary tools
4978
4979 =item Create debugging macros
4980
4981 =item truncate to the people
4982
4983 =item Unicode in Filenames
4984
4985 =back
4986
4987 =item Recently done things
4988
4989 =over 4
4990
4991 =item Alternative RE syntax module
4992
4993 =item Safe signal handling
4994
4995 =item Tie Modules
4996
4997 =item gettimeofday
4998
4999 =item setitimer and getimiter
5000
5001 =item Testing __DIE__ hook
5002
5003 =item CPP equivalent in Perl
5004
5005 =item Explicit switch statements
5006
5007 =item autocroak
5008
5009 =item UTF/EBCDIC
5010
5011 =item UTF Regexes
5012
5013 =item perlcc to produce executable
5014
5015 =item END blocks saved in compiled output
5016
5017 =item Secure temporary file module
5018
5019 =item Integrate Time::HiRes
5020
5021 =item Turn Cwd into XS
5022
5023 =item Mmap for input
5024
5025 =item Byte to/from UTF8 and UTF8 to/from local conversion
5026
5027 =item Add sockatmark support
5028
5029 =item Mailing list archives
5030
5031 =item Bug tracking
5032
5033 =item Integrate MacPerl
5034
5035 =item Web "nerve center" for Perl
5036
5037 =item Regular expression tutorial
5038
5039 =item Debugging Tutorial
5040
5041 =item Integrate new modules
5042
5043 =item Integrate profiler
5044
5045 =item Y2K error detection
5046
5047 =item Regular expression debugger
5048
5049 =item POD checker
5050
5051 =item "Dynamic" lexicals
5052
5053 =item Cache precompiled modules
5054
5055 =back
5056
5057 =item Deprecated Wishes
5058
5059 =over 4
5060
5061 =item Loop control on do{}
5062
5063 =item Lexically scoped typeglobs
5064
5065 =item format BOTTOM
5066
5067 =item report HANDLE
5068
5069 =item Generalised want()/caller())
5070
5071 =item Named prototypes
5072
5073 =item Built-in globbing
5074
5075 =item Regression tests for suidperl
5076
5077 =item Cached hash values
5078
5079 =item Add compression modules
5080
5081 =item Reorganise documentation into tutorials/references
5082
5083 =item Remove distinction between functions and operators
5084
5085 =item Make XS easier to use
5086
5087 =item Make embedding easier to use
5088
5089 =item man for perl
5090
5091 =item my $Package::variable
5092
5093 =item "or" tests defined, not truth
5094
5095 =item "class"-based lexicals
5096
5097 =item byteperl
5098
5099 =item Lazy evaluation / tail recursion removal
5100
5101 =item Make "use utf8" the default
5102
5103 =item Unicode collation and normalization
5104
5105 =item pack/unpack tutorial
5106
5107 =back
5108
5109 =back
5110
5111 =head2 perlhack - How to hack at the Perl internals
5112
5113 =over 4
5114
5115 =item DESCRIPTION
5116
5117 Does concept match the general goals of Perl?, Where is the
5118 implementation?, Backwards compatibility, Could it be a module instead?, Is
5119 the feature generic enough?, Does it potentially introduce new bugs?, Does
5120 it preclude other desirable features?, Is the implementation robust?, Is
5121 the implementation generic enough to be portable?, Is the implementation
5122 tested?, Is there enough documentation?, Is there another way to do it?,
5123 Does it create too much work?, Patches speak louder than words
5124
5125 =over 4
5126
5127 =item Keeping in sync
5128
5129 rsync'ing the source tree, Using rsync over the LAN, Using pushing over the
5130 NFS, rsync'ing the patches
5131
5132 =item Why rsync the source tree
5133
5134 It's easier to rsync the source tree, It's more reliable
5135
5136 =item Why rsync the patches
5137
5138 It's easier to rsync the patches, It's a good reference, Finding a start
5139 point, Finding how to fix a bug, Finding the source of misbehaviour
5140
5141 =item Perlbug remote interface
5142
5143 1 http://bugs.perl.org, 2 bugdb@perl.org, 3
5144 commands_and_bugdids@bugs.perl.org, notes, patches, tests
5145
5146 =item Submitting patches
5147
5148 L<perlguts>, L<perlxstut> and L<perlxs>, L<perlapi>,
5149 F<Porting/pumpkin.pod>, The perl5-porters FAQ
5150
5151 =item Finding Your Way Around
5152
5153 Core modules, Tests, Documentation, Configure, Interpreter
5154
5155 =item Elements of the interpreter
5156
5157 Startup, Parsing, Optimization, Running
5158
5159 =item Internal Variable Types
5160
5161 =item Op Trees
5162
5163 =item Stacks
5164
5165 Argument stack, Mark stack, Save stack
5166
5167 =item Millions of Macros
5168
5169 =item Poking at Perl
5170
5171 =item Using a source-level debugger
5172
5173 run [args], break function_name, break source.c:xxx, step, next, continue,
5174 finish, 'enter', print
5175
5176 =item Dumping Perl Data Structures
5177
5178 =item Patching
5179
5180 =item Patching a core module
5181
5182 =item Adding a new function to the core
5183
5184 =item Writing a test
5185
5186 F<t/base/>, F<t/cmd/>, F<t/comp/>, F<t/io/>, F<t/lib/>, F<t/op/>,
5187 F<t/pod/>, F<t/run/>, t/base t/comp, t/cmd t/run t/io t/op, t/lib ext lib
5188
5189 =item Special Make Test Targets
5190
5191 coretest, test.deparse, minitest, test.third check.third utest.third
5192 ucheck.third, test.torture torturetest, utest ucheck test.utf8 check.utf8
5193
5194 =back
5195
5196 =item EXTERNAL TOOLS FOR DEBUGGING PERL
5197
5198 =over 4
5199
5200 =item Rational Software's Purify
5201
5202 =item Purify on Unix
5203
5204 -Accflags=-DPURIFY, -Doptimize='-g', -Uusemymalloc, -Dusemultiplicity
5205
5206 =item Purify on NT
5207
5208 DEFINES, USE_MULTI = define, #PERL_MALLOC = define, CFG = Debug
5209
5210 =item Compaq's/Digital's/HP's Third Degree
5211
5212 =item PERL_DESTRUCT_LEVEL
5213
5214 =item Profiling
5215
5216 =item Gprof Profiling
5217
5218 -a, -b, -e routine, -f routine, -s, -z
5219
5220 =item GCC gcov Profiling
5221
5222 =item Pixie Profiling
5223
5224 -h, -l, -p[rocedures], -h[eavy], -i[nvocations], -l[ines], -testcoverage,
5225 -z[ero]
5226
5227 =item Miscellaneous tricks
5228
5229 =item CONCLUSION
5230
5231 I<The Road goes ever on and on, down from the door where it began.>
5232
5233 =back
5234
5235 =item AUTHOR
5236
5237 =back
5238
5239 =head2 perlhist - the Perl history records
5240
5241 =over 4
5242
5243 =item DESCRIPTION
5244
5245 =item INTRODUCTION
5246
5247 =item THE KEEPERS OF THE PUMPKIN
5248
5249 =over 4
5250
5251 =item PUMPKIN?
5252
5253 =back
5254
5255 =item THE RECORDS
5256
5257 =over 4
5258
5259 =item SELECTED RELEASE SIZES
5260
5261 =item SELECTED PATCH SIZES
5262
5263 =back
5264
5265 =item THE KEEPERS OF THE RECORDS
5266
5267 =back
5268
5269 =head2 perldelta - what is new for perl v5.8.0
5270
5271 =over 4
5272
5273 =item DESCRIPTION
5274
5275 =item Highlights In 5.8.0
5276
5277 =item Incompatible Changes
5278
5279 =over 4
5280
5281 =item Binary Incompatibility
5282
5283 =item 64-bit platforms and malloc
5284
5285 =item AIX Dynaloading
5286
5287 =item Attributes for C<my> variables now handled at run-time
5288
5289 =item Socket Extension Dynamic in VMS
5290
5291 =item IEEE-format Floating Point Default on OpenVMS Alpha
5292
5293 =item New Unicode Semantics (no more C<use utf8>)
5294
5295 =item New Unicode Properties
5296
5297 =item REF(...) Instead Of SCALAR(...)
5298
5299 =item pack/unpack D/F recycled
5300
5301 =item glob() now returns filenames in alphabetical order
5302
5303 =item Deprecations
5304
5305 =back
5306
5307 =item Core Enhancements
5308
5309 =over 4
5310
5311 =item Unicode Overhaul
5312
5313 =item PerlIO is Now The Default
5314
5315 =item ithreads
5316
5317 =item Restricted Hashes
5318
5319 =item Safe Signals
5320
5321 =item Understanding of Numbers
5322
5323 =item Arrays now always interpolate into double-quoted strings [561]
5324
5325 =item Miscellaneous Changes
5326
5327 =back
5328
5329 =item Modules and Pragmata
5330
5331 =over 4
5332
5333 =item New Modules and Pragmata
5334
5335 =item Updated And Improved Modules and Pragmata
5336
5337 =back
5338
5339 =item Utility Changes
5340
5341 =item New Documentation
5342
5343 =item Performance Enhancements
5344
5345 =item Installation and Configuration Improvements
5346
5347 =over 4
5348
5349 =item Generic Improvements
5350
5351 =item New Or Improved Platforms
5352
5353 =back
5354
5355 =item Selected Bug Fixes
5356
5357 =over 4
5358
5359 =item Platform Specific Changes and Fixes
5360
5361 =back
5362
5363 =item New or Changed Diagnostics
5364
5365 =item Changed Internals
5366
5367 =item Security Vulnerability Closed [561]
5368
5369 =item New Tests
5370
5371 =item Known Problems
5372
5373 =over 4
5374
5375 =item The Compiler Suite Is Still Very Experimental
5376
5377 =item Localising Tied Arrays and Hashes Is Broken
5378
5379 =item Building Extensions Can Fail Because Of Largefiles
5380
5381 =item Modifying $_ Inside for(..)
5382
5383 =item mod_perl 1.26 Doesn't Build With Threaded Perl
5384
5385 =item lib/ftmp-security tests warn 'system possibly insecure'
5386
5387 =item libwww-perl (LWP) fails base/date #51
5388
5389 =item PDL failing some tests
5390
5391 =item Perl_get_sv
5392
5393 =item Self-tying Problems
5394
5395 =item ext/threads/t/libc
5396
5397 =item Failure of Thread (5.005-style) tests
5398
5399 =item Timing problems
5400
5401 =item Tied/Magical Array/Hash Elements Do Not Autovivify
5402
5403 =item Unicode in package/class and subroutine names does not work
5404
5405 =back
5406
5407 =item Platform Specific Problems
5408
5409 =over 4
5410
5411 =item AIX
5412
5413 =item Alpha systems with old gccs fail several tests
5414
5415 =item AmigaOS
5416
5417 =item BeOS
5418
5419 =item Cygwin "unable to remap"
5420
5421 =item Cygwin ndbm tests fail on FAT
5422
5423 =item DJGPP does not build
5424
5425 =item FreeBSD built with ithreads coredumps reading large directories
5426
5427 =item FreeBSD Failing locale Test 117 For ISO 8859-15 Locales
5428
5429 =item IRIX fails ext/List/Util/t/shuffle.t or Digest::MD5
5430
5431 =item HP-UX lib/posix Subtest 9 Fails When LP64-Configured
5432
5433 =item Linux with glibc 2.2.5 fails t/op/int subtest #6 with -Duse64bitint
5434
5435 =item Linux With Sfio Fails op/misc Test 48
5436
5437 =item Mac OS X
5438
5439 =item Mac OS X dyld undefined symbols
5440
5441 =item OS/2 Test Failures
5442
5443 =item op/sprintf tests 91, 129, and 130
5444
5445 =item Solaris 2.5
5446
5447 =item Solaris x86 Fails Tests With -Duse64bitint
5448
5449 =item SUPER-UX (NEC SX)
5450
5451 =item Term::ReadKey not working on Win32
5452
5453 =item UNICOS/mk
5454
5455 =item UTS
5456
5457 =item VOS (Stratus)
5458
5459 =item VMS
5460
5461 =item Win32
5462
5463 =item XML::Parser not working
5464
5465 =item z/OS (OS/390)
5466
5467 =item Unicode Support on EBCDIC Still Spotty
5468
5469 =item Seen In Perl 5.7 But Gone Now
5470
5471 =back
5472
5473 =item Reporting Bugs
5474
5475 =item SEE ALSO
5476
5477 =item HISTORY
5478
5479 =back
5480
5481 =head2 perl572delta - what's new for perl v5.7.2
5482
5483 =over 4
5484
5485 =item DESCRIPTION
5486
5487 =item Security Vulnerability Closed
5488
5489 =item Incompatible Changes
5490
5491 =over 4
5492
5493 =item 64-bit platforms and malloc
5494
5495 =item AIX Dynaloading
5496
5497 =item Socket Extension Dynamic in VMS
5498
5499 =item Different Definition of the Unicode Character Classes \p{In...}
5500
5501 =item Deprecations
5502
5503 =back
5504
5505 =item Core Enhancements
5506
5507 =item Modules and Pragmata
5508
5509 =over 4
5510
5511 =item New Modules and Distributions
5512
5513 =item Updated And Improved Modules and Pragmata
5514
5515 =back
5516
5517 =item Utility Changes
5518
5519 =item New Documentation
5520
5521 =item Installation and Configuration Improvements
5522
5523 =over 4
5524
5525 =item New Or Improved Platforms
5526
5527 =item Generic Improvements
5528
5529 =back
5530
5531 =item Selected Bug Fixes
5532
5533 =over 4
5534
5535 =item Platform Specific Changes and Fixes
5536
5537 =back
5538
5539 =item New or Changed Diagnostics
5540
5541 =item Source Code Enhancements
5542
5543 =over 4
5544
5545 =item MAGIC constants
5546
5547 =item Better commented code
5548
5549 =item Regex pre-/post-compilation items matched up
5550
5551 =item gcc -Wall
5552
5553 =back
5554
5555 =item New Tests
5556
5557 =item Known Problems
5558
5559 =over 4
5560
5561 =item AIX
5562
5563 =item Amiga Perl Invoking Mystery
5564
5565 =item lib/ftmp-security tests warn 'system possibly insecure'
5566
5567 =item Cygwin intermittent failures of lib/Memoize/t/expire_file 11 and 12
5568
5569 =item HP-UX lib/io_multihomed Fails When LP64-Configured
5570
5571 =item  HP-UX lib/posix Subtest 9 Fails When LP64-Configured
5572
5573 =item Linux With Sfio Fails op/misc Test 48
5574
5575 =item OS/390
5576
5577 =item op/sprintf tests 129 and 130
5578
5579 =item  Failure of Thread tests
5580
5581 =item UNICOS
5582
5583 =item UTS
5584
5585 =item VMS
5586
5587 =item Win32
5588
5589 =item Localising a Tied Variable Leaks Memory
5590
5591 =item Self-tying of Arrays and Hashes Is Forbidden
5592
5593 =item Variable Attributes are not Currently Usable for Tieing
5594
5595 =item Building Extensions Can Fail Because Of Largefiles
5596
5597 =item The Compiler Suite Is Still Experimental
5598
5599 =item The Long Double Support is Still Experimental
5600
5601 =back
5602
5603 =item Reporting Bugs
5604
5605 =item SEE ALSO
5606
5607 =item HISTORY
5608
5609 =back
5610
5611 =head2 perl571delta - what's new for perl v5.7.1
5612
5613 =over 4
5614
5615 =item DESCRIPTION
5616
5617 =item Security Vulnerability Closed
5618
5619 =item Incompatible Changes
5620
5621 =item Core Enhancements
5622
5623 =over 4
5624
5625 =item AUTOLOAD Is Now Lvaluable
5626
5627 =item PerlIO is Now The Default
5628
5629 =item Signals Are Now Safe
5630
5631 =back
5632
5633 =item Modules and Pragmata
5634
5635 =over 4
5636
5637 =item New Modules
5638
5639 =item Updated And Improved Modules and Pragmata
5640
5641 =back
5642
5643 =item Performance Enhancements
5644
5645 =item Utility Changes
5646
5647 =item New Documentation
5648
5649 =over 4
5650
5651 =item perlclib
5652
5653 =item perliol
5654
5655 =item README.aix
5656
5657 =item README.bs2000
5658
5659 =item README.macos
5660
5661 =item README.mpeix
5662
5663 =item README.solaris
5664
5665 =item README.vos
5666
5667 =item Porting/repository.pod
5668
5669 =back
5670
5671 =item Installation and Configuration Improvements
5672
5673 =over 4
5674
5675 =item New Or Improved Platforms
5676
5677 =item Generic Improvements
5678
5679 d_cmsghdr, d_fcntl_can_lock, d_fsync, d_getitimer, d_getpagsz, d_msghdr_s,
5680 need_va_copy, d_readv, d_recvmsg, d_sendmsg, sig_size, d_sockatmark,
5681 d_strtoq, d_u32align, d_ualarm, d_usleep
5682
5683 =back
5684
5685 =item Selected Bug Fixes
5686
5687 =over 4
5688
5689 =item Platform Specific Changes and Fixes
5690
5691 =back
5692
5693 =item New or Changed Diagnostics
5694
5695 =item Changed Internals
5696
5697 =item New Tests
5698
5699 =item Known Problems
5700
5701 =over 4
5702
5703 =item AIX vac 5.0.0.0 May Produce Buggy Code For Perl
5704
5705 =item lib/ftmp-security tests warn 'system possibly insecure'
5706
5707 =item lib/io_multihomed Fails In LP64-Configured HP-UX
5708
5709 =item Test lib/posix Subtest 9 Fails In LP64-Configured HP-UX
5710
5711 =item lib/b test 19
5712
5713 =item Linux With Sfio Fails op/misc Test 48
5714
5715 =item sigaction test 13 in VMS
5716
5717 =item sprintf tests 129 and 130
5718
5719 =item  Failure of Thread tests
5720
5721 =item Localising a Tied Variable Leaks Memory
5722
5723 =item Self-tying of Arrays and Hashes Is Forbidden
5724
5725 =item Building Extensions Can Fail Because Of Largefiles
5726
5727 =item The Compiler Suite Is Still Experimental
5728
5729 =back
5730
5731 =item Reporting Bugs
5732
5733 =item SEE ALSO
5734
5735 =item HISTORY
5736
5737 =back
5738
5739 =head2 perl570delta - what's new for perl v5.7.0
5740
5741 =over 4
5742
5743 =item DESCRIPTION
5744
5745 =item Security Vulnerability Closed
5746
5747 =item Incompatible Changes
5748
5749 =item Core Enhancements
5750
5751 =item Modules and Pragmata
5752
5753 =over 4
5754
5755 =item New Modules
5756
5757 =item Updated And Improved Modules and Pragmata
5758
5759 =back
5760
5761 =item Utility Changes
5762
5763 =item New Documentation
5764
5765 =item Performance Enhancements
5766
5767 =item Installation and Configuration Improvements
5768
5769 =over 4
5770
5771 =item Generic Improvements
5772
5773 =back
5774
5775 =item Selected Bug Fixes
5776
5777 =over 4
5778
5779 =item Platform Specific Changes and Fixes
5780
5781 =back
5782
5783 =item New or Changed Diagnostics
5784
5785 =item Changed Internals
5786
5787 =item Known Problems
5788
5789 =over 4
5790
5791 =item Unicode Support Still Far From Perfect
5792
5793 =item EBCDIC Still A Lost Platform
5794
5795 =item Building Extensions Can Fail Because Of Largefiles
5796
5797 =item ftmp-security tests warn 'system possibly insecure'
5798
5799 =item Test lib/posix Subtest 9 Fails In LP64-Configured HP-UX
5800
5801 =item Long Doubles Still Don't Work In Solaris
5802
5803 =item Linux With Sfio Fails op/misc Test 48
5804
5805 =item Storable tests fail in some platforms
5806
5807 =item Threads Are Still Experimental
5808
5809 =item The Compiler Suite Is Still Experimental
5810
5811 =back
5812
5813 =item Reporting Bugs
5814
5815 =item SEE ALSO
5816
5817 =item HISTORY
5818
5819 =back
5820
5821 =head2 perl561delta - what's new for perl v5.6.x
5822
5823 =over 4
5824
5825 =item DESCRIPTION
5826
5827 =item Summary of changes between 5.6.0 and 5.6.1
5828
5829 =over 4
5830
5831 =item Security Issues
5832
5833 =item Core bug fixes
5834
5835 C<UNIVERSAL::isa()>, Memory leaks, Numeric conversions, qw(a\\b), caller(),
5836 Bugs in regular expressions, "slurp" mode, Autovivification of symbolic
5837 references to special variables, Lexical warnings, Spurious warnings and
5838 errors, glob(), Tainting, sort(), #line directives, Subroutine prototypes,
5839 map(), Debugger, PERL5OPT, chop(), Unicode support, 64-bit support,
5840 Compiler, Lvalue subroutines, IO::Socket, File::Find, xsubpp, C<no
5841 Module;>, Tests
5842
5843 =item Core features
5844
5845 =item Configuration issues
5846
5847 =item Documentation
5848
5849 =item Bundled modules
5850
5851 B::Concise, File::Temp, Pod::LaTeX, Pod::Text::Overstrike, CGI, CPAN,
5852 Class::Struct, DB_File, Devel::Peek, File::Find, Getopt::Long, IO::Poll,
5853 IPC::Open3, Math::BigFloat, Math::Complex, Net::Ping, Opcode, Pod::Parser,
5854 Pod::Text, SDBM_File, Sys::Syslog, Tie::RefHash, Tie::SubstrHash
5855
5856 =item Platform-specific improvements
5857
5858 NCR MP-RAS, NonStop-UX
5859
5860 =back
5861
5862 =item Core Enhancements
5863
5864 =over 4
5865
5866 =item Interpreter cloning, threads, and concurrency
5867
5868 =item Lexically scoped warning categories
5869
5870 =item Unicode and UTF-8 support
5871
5872 =item Support for interpolating named characters
5873
5874 =item "our" declarations
5875
5876 =item Support for strings represented as a vector of ordinals
5877
5878 =item Improved Perl version numbering system
5879
5880 =item New syntax for declaring subroutine attributes
5881
5882 =item File and directory handles can be autovivified
5883
5884 =item open() with more than two arguments
5885
5886 =item 64-bit support
5887
5888 =item Large file support
5889
5890 =item Long doubles
5891
5892 =item "more bits"
5893
5894 =item Enhanced support for sort() subroutines
5895
5896 =item C<sort $coderef @foo> allowed
5897
5898 =item File globbing implemented internally
5899
5900 =item Support for CHECK blocks
5901
5902 =item POSIX character class syntax [: :] supported
5903
5904 =item Better pseudo-random number generator
5905
5906 =item Improved C<qw//> operator
5907
5908 =item Better worst-case behavior of hashes
5909
5910 =item pack() format 'Z' supported
5911
5912 =item pack() format modifier '!' supported
5913
5914 =item pack() and unpack() support counted strings
5915
5916 =item Comments in pack() templates
5917
5918 =item Weak references
5919
5920 =item Binary numbers supported
5921
5922 =item Lvalue subroutines
5923
5924 =item Some arrows may be omitted in calls through references
5925
5926 =item Boolean assignment operators are legal lvalues
5927
5928 =item exists() is supported on subroutine names
5929
5930 =item exists() and delete() are supported on array elements
5931
5932 =item Pseudo-hashes work better
5933
5934 =item Automatic flushing of output buffers
5935
5936 =item Better diagnostics on meaningless filehandle operations
5937
5938 =item Where possible, buffered data discarded from duped input filehandle
5939
5940 =item eof() has the same old magic as <>
5941
5942 =item binmode() can be used to set :crlf and :raw modes
5943
5944 =item C<-T> filetest recognizes UTF-8 encoded files as "text"
5945
5946 =item system(), backticks and pipe open now reflect exec() failure
5947
5948 =item Improved diagnostics
5949
5950 =item Diagnostics follow STDERR
5951
5952 =item More consistent close-on-exec behavior
5953
5954 =item syswrite() ease-of-use
5955
5956 =item Better syntax checks on parenthesized unary operators
5957
5958 =item Bit operators support full native integer width
5959
5960 =item Improved security features
5961
5962 =item More functional bareword prototype (*)
5963
5964 =item C<require> and C<do> may be overridden
5965
5966 =item $^X variables may now have names longer than one character
5967
5968 =item New variable $^C reflects C<-c> switch
5969
5970 =item New variable $^V contains Perl version as a string
5971
5972 =item Optional Y2K warnings
5973
5974 =item Arrays now always interpolate into double-quoted strings
5975
5976 =back
5977
5978 =item Modules and Pragmata
5979
5980 =over 4
5981
5982 =item Modules
5983
5984 attributes, B, Benchmark, ByteLoader, constant, charnames, Data::Dumper,
5985 DB, DB_File, Devel::DProf, Devel::Peek, Dumpvalue, DynaLoader, English,
5986 Env, Fcntl, File::Compare, File::Find, File::Glob, File::Spec,
5987 File::Spec::Functions, Getopt::Long, IO, JPL, lib, Math::BigInt,
5988 Math::Complex, Math::Trig, Pod::Parser, Pod::InputObjects, Pod::Checker,
5989 podchecker, Pod::ParseUtils, Pod::Find, Pod::Select, podselect, Pod::Usage,
5990 pod2usage, Pod::Text and Pod::Man, SDBM_File, Sys::Syslog, Sys::Hostname,
5991 Term::ANSIColor, Time::Local, Win32, XSLoader, DBM Filters
5992
5993 =item Pragmata
5994
5995 =back
5996
5997 =item Utility Changes
5998
5999 =over 4
6000
6001 =item dprofpp
6002
6003 =item find2perl
6004
6005 =item h2xs
6006
6007 =item perlcc
6008
6009 =item perldoc
6010
6011 =item The Perl Debugger
6012
6013 =back
6014
6015 =item Improved Documentation
6016
6017 perlapi.pod, perlboot.pod, perlcompile.pod, perldbmfilter.pod,
6018 perldebug.pod, perldebguts.pod, perlfork.pod, perlfilter.pod, perlhack.pod,
6019 perlintern.pod, perllexwarn.pod, perlnumber.pod, perlopentut.pod,
6020 perlreftut.pod, perltootc.pod, perltodo.pod, perlunicode.pod
6021
6022 =item Performance enhancements
6023
6024 =over 4
6025
6026 =item Simple sort() using { $a <=> $b } and the like are optimized
6027
6028 =item Optimized assignments to lexical variables
6029
6030 =item Faster subroutine calls
6031
6032 =item delete(), each(), values() and hash iteration are faster
6033
6034 =back
6035
6036 =item Installation and Configuration Improvements
6037
6038 =over 4
6039
6040 =item -Dusethreads means something different
6041
6042 =item New Configure flags
6043
6044 =item Threadedness and 64-bitness now more daring
6045
6046 =item Long Doubles
6047
6048 =item -Dusemorebits
6049
6050 =item -Duselargefiles
6051
6052 =item installusrbinperl
6053
6054 =item SOCKS support
6055
6056 =item C<-A> flag
6057
6058 =item Enhanced Installation Directories
6059
6060 =item gcc automatically tried if 'cc' does not seem to be working
6061
6062 =back
6063
6064 =item Platform specific changes
6065
6066 =over 4
6067
6068 =item Supported platforms
6069
6070 =item DOS
6071
6072 =item OS390 (OpenEdition MVS)
6073
6074 =item VMS
6075
6076 =item Win32
6077
6078 =back
6079
6080 =item Significant bug fixes
6081
6082 =over 4
6083
6084 =item <HANDLE> on empty files
6085
6086 =item C<eval '...'> improvements
6087
6088 =item All compilation errors are true errors
6089
6090 =item Implicitly closed filehandles are safer
6091
6092 =item Behavior of list slices is more consistent
6093
6094 =item C<(\$)> prototype and C<$foo{a}>
6095
6096 =item C<goto &sub> and AUTOLOAD
6097
6098 =item C<-bareword> allowed under C<use integer>
6099
6100 =item Failures in DESTROY()
6101
6102 =item Locale bugs fixed
6103
6104 =item Memory leaks
6105
6106 =item Spurious subroutine stubs after failed subroutine calls
6107
6108 =item Taint failures under C<-U>
6109
6110 =item END blocks and the C<-c> switch
6111
6112 =item Potential to leak DATA filehandles
6113
6114 =back
6115
6116 =item New or Changed Diagnostics
6117
6118 "%s" variable %s masks earlier declaration in same %s, "my sub" not yet
6119 implemented, "our" variable %s redeclared, '!' allowed only after types %s,
6120 / cannot take a count, / must be followed by a, A or Z, / must be followed
6121 by a*, A* or Z*, / must follow a numeric type, /%s/: Unrecognized escape
6122 \\%c passed through, /%s/: Unrecognized escape \\%c in character class
6123 passed through, /%s/ should probably be written as "%s", %s() called too
6124 early to check prototype, %s argument is not a HASH or ARRAY element, %s
6125 argument is not a HASH or ARRAY element or slice, %s argument is not a
6126 subroutine name, %s package attribute may clash with future reserved word:
6127 %s, (in cleanup) %s, <> should be quotes, Attempt to join self, Bad evalled
6128 substitution pattern, Bad realloc() ignored, Bareword found in conditional,
6129 Binary number > 0b11111111111111111111111111111111 non-portable, Bit vector
6130 size > 32 non-portable, Buffer overflow in prime_env_iter: %s, Can't check
6131 filesystem of script "%s", Can't declare class for non-scalar %s in "%s",
6132 Can't declare %s in "%s", Can't ignore signal CHLD, forcing to default,
6133 Can't modify non-lvalue subroutine call, Can't read CRTL environ, Can't
6134 remove %s: %s, skipping file, Can't return %s from lvalue subroutine, Can't
6135 weaken a nonreference, Character class [:%s:] unknown, Character class
6136 syntax [%s] belongs inside character classes, Constant is not %s reference,
6137 constant(%s): %s, CORE::%s is not a keyword, defined(@array) is deprecated,
6138 defined(%hash) is deprecated, Did not produce a valid header, (Did you mean
6139 "local" instead of "our"?), Document contains no data, entering effective
6140 %s failed, false [] range "%s" in regexp, Filehandle %s opened only for
6141 output, flock() on closed filehandle %s, Global symbol "%s" requires
6142 explicit package name, Hexadecimal number > 0xffffffff non-portable,
6143 Ill-formed CRTL environ value "%s", Ill-formed message in prime_env_iter:
6144 |%s|, Illegal binary digit %s, Illegal binary digit %s ignored, Illegal
6145 number of bits in vec, Integer overflow in %s number, Invalid %s attribute:
6146 %s, Invalid %s attributes: %s, invalid [] range "%s" in regexp, Invalid
6147 separator character %s in attribute list, Invalid separator character %s in
6148 subroutine attribute list, leaving effective %s failed, Lvalue subs
6149 returning %s not implemented yet, Method %s not permitted, Missing
6150 %sbrace%s on \N{}, Missing command in piped open, Missing name in "my sub",
6151 No %s specified for -%c, No package name allowed for variable %s in "our",
6152 No space allowed after -%c, no UTC offset information; assuming local time
6153 is UTC, Octal number > 037777777777 non-portable, panic: del_backref,
6154 panic: kid popen errno read, panic: magic_killbackrefs, Parentheses missing
6155 around "%s" list, Possible unintended interpolation of %s in string,
6156 Possible Y2K bug: %s, pragma "attrs" is deprecated, use "sub NAME : ATTRS"
6157 instead, Premature end of script headers, Repeat count in pack overflows,
6158 Repeat count in unpack overflows, realloc() of freed memory ignored,
6159 Reference is already weak, setpgrp can't take arguments, Strange *+?{} on
6160 zero-length expression, switching effective %s is not implemented, This
6161 Perl can't reset CRTL environ elements (%s), This Perl can't set CRTL
6162 environ elements (%s=%s), Too late to run %s block, Unknown open() mode
6163 '%s', Unknown process %x sent message to prime_env_iter: %s, Unrecognized
6164 escape \\%c passed through, Unterminated attribute parameter in attribute
6165 list, Unterminated attribute list, Unterminated attribute parameter in
6166 subroutine attribute list, Unterminated subroutine attribute list, Value of
6167 CLI symbol "%s" too long, Version number must be a constant number
6168
6169 =item New tests
6170
6171 =item Incompatible Changes
6172
6173 =over 4
6174
6175 =item Perl Source Incompatibilities
6176
6177 CHECK is a new keyword, Treatment of list slices of undef has changed,
6178 Format of $English::PERL_VERSION is different, Literals of the form
6179 C<1.2.3> parse differently, Possibly changed pseudo-random number
6180 generator, Hashing function for hash keys has changed, C<undef> fails on
6181 read only values, Close-on-exec bit may be set on pipe and socket handles,
6182 Writing C<"$$1"> to mean C<"${$}1"> is unsupported, delete(), each(),
6183 values() and C<\(%h)>, vec(EXPR,OFFSET,BITS) enforces powers-of-two BITS,
6184 Text of some diagnostic output has changed, C<%@> has been removed,
6185 Parenthesized not() behaves like a list operator, Semantics of bareword
6186 prototype C<(*)> have changed, Semantics of bit operators may have changed
6187 on 64-bit platforms, More builtins taint their results
6188
6189 =item C Source Incompatibilities
6190
6191 C<PERL_POLLUTE>, C<PERL_IMPLICIT_CONTEXT>, C<PERL_POLLUTE_MALLOC>
6192
6193 =item Compatible C Source API Changes
6194
6195 C<PATCHLEVEL> is now C<PERL_VERSION>
6196
6197 =item Binary Incompatibilities
6198
6199 =back
6200
6201 =item Known Problems
6202
6203 =over 4
6204
6205 =item Localizing a tied hash element may leak memory
6206
6207 =item Known test failures
6208
6209 =item EBCDIC platforms not fully supported
6210
6211 =item UNICOS/mk CC failures during Configure run
6212
6213 =item Arrow operator and arrays
6214
6215 =item Experimental features
6216
6217 Threads, Unicode, 64-bit support, Lvalue subroutines, Weak references, The
6218 pseudo-hash data type, The Compiler suite, Internal implementation of file
6219 globbing, The DB module, The regular expression code constructs:
6220
6221 =back
6222
6223 =item Obsolete Diagnostics
6224
6225 Character class syntax [: :] is reserved for future extensions, Ill-formed
6226 logical name |%s| in prime_env_iter, In string, @%s now must be written as
6227 \@%s, Probable precedence problem on %s, regexp too big, Use of "$$<digit>"
6228 to mean "${$}<digit>" is deprecated
6229
6230 =item Reporting Bugs
6231
6232 =item SEE ALSO
6233
6234 =item HISTORY
6235
6236 =back
6237
6238 =head2 perl56delta - what's new for perl v5.6.0
6239
6240 =over 4
6241
6242 =item DESCRIPTION
6243
6244 =item Core Enhancements
6245
6246 =over 4
6247
6248 =item Interpreter cloning, threads, and concurrency
6249
6250 =item Lexically scoped warning categories
6251
6252 =item Unicode and UTF-8 support
6253
6254 =item Support for interpolating named characters
6255
6256 =item "our" declarations
6257
6258 =item Support for strings represented as a vector of ordinals
6259
6260 =item Improved Perl version numbering system
6261
6262 =item New syntax for declaring subroutine attributes
6263
6264 =item File and directory handles can be autovivified
6265
6266 =item open() with more than two arguments
6267
6268 =item 64-bit support
6269
6270 =item Large file support
6271
6272 =item Long doubles
6273
6274 =item "more bits"
6275
6276 =item Enhanced support for sort() subroutines
6277
6278 =item C<sort $coderef @foo> allowed
6279
6280 =item File globbing implemented internally
6281
6282 =item Support for CHECK blocks
6283
6284 =item POSIX character class syntax [: :] supported
6285
6286 =item Better pseudo-random number generator
6287
6288 =item Improved C<qw//> operator
6289
6290 =item Better worst-case behavior of hashes
6291
6292 =item pack() format 'Z' supported
6293
6294 =item pack() format modifier '!' supported
6295
6296 =item pack() and unpack() support counted strings
6297
6298 =item Comments in pack() templates
6299
6300 =item Weak references
6301
6302 =item Binary numbers supported
6303
6304 =item Lvalue subroutines
6305
6306 =item Some arrows may be omitted in calls through references
6307
6308 =item Boolean assignment operators are legal lvalues
6309
6310 =item exists() is supported on subroutine names
6311
6312 =item exists() and delete() are supported on array elements
6313
6314 =item Pseudo-hashes work better
6315
6316 =item Automatic flushing of output buffers
6317
6318 =item Better diagnostics on meaningless filehandle operations
6319
6320 =item Where possible, buffered data discarded from duped input filehandle
6321
6322 =item eof() has the same old magic as <>
6323
6324 =item binmode() can be used to set :crlf and :raw modes
6325
6326 =item C<-T> filetest recognizes UTF-8 encoded files as "text"
6327
6328 =item system(), backticks and pipe open now reflect exec() failure
6329
6330 =item Improved diagnostics
6331
6332 =item Diagnostics follow STDERR
6333
6334 =item More consistent close-on-exec behavior
6335
6336 =item syswrite() ease-of-use
6337
6338 =item Better syntax checks on parenthesized unary operators
6339
6340 =item Bit operators support full native integer width
6341
6342 =item Improved security features
6343
6344 =item More functional bareword prototype (*)
6345
6346 =item C<require> and C<do> may be overridden
6347
6348 =item $^X variables may now have names longer than one character
6349
6350 =item New variable $^C reflects C<-c> switch
6351
6352 =item New variable $^V contains Perl version as a string
6353
6354 =item Optional Y2K warnings
6355
6356 =item Arrays now always interpolate into double-quoted strings
6357
6358 =back
6359
6360 =item Modules and Pragmata
6361
6362 =over 4
6363
6364 =item Modules
6365
6366 attributes, B, Benchmark, ByteLoader, constant, charnames, Data::Dumper,
6367 DB, DB_File, Devel::DProf, Devel::Peek, Dumpvalue, DynaLoader, English,
6368 Env, Fcntl, File::Compare, File::Find, File::Glob, File::Spec,
6369 File::Spec::Functions, Getopt::Long, IO, JPL, lib, Math::BigInt,
6370 Math::Complex, Math::Trig, Pod::Parser, Pod::InputObjects, Pod::Checker,
6371 podchecker, Pod::ParseUtils, Pod::Find, Pod::Select, podselect, Pod::Usage,
6372 pod2usage, Pod::Text and Pod::Man, SDBM_File, Sys::Syslog, Sys::Hostname,
6373 Term::ANSIColor, Time::Local, Win32, XSLoader, DBM Filters
6374
6375 =item Pragmata
6376
6377 =back
6378
6379 =item Utility Changes
6380
6381 =over 4
6382
6383 =item dprofpp
6384
6385 =item find2perl
6386
6387 =item h2xs
6388
6389 =item perlcc
6390
6391 =item perldoc
6392
6393 =item The Perl Debugger
6394
6395 =back
6396
6397 =item Improved Documentation
6398
6399 perlapi.pod, perlboot.pod, perlcompile.pod, perldbmfilter.pod,
6400 perldebug.pod, perldebguts.pod, perlfork.pod, perlfilter.pod, perlhack.pod,
6401 perlintern.pod, perllexwarn.pod, perlnumber.pod, perlopentut.pod,
6402 perlreftut.pod, perltootc.pod, perltodo.pod, perlunicode.pod
6403
6404 =item Performance enhancements
6405
6406 =over 4
6407
6408 =item Simple sort() using { $a <=> $b } and the like are optimized
6409
6410 =item Optimized assignments to lexical variables
6411
6412 =item Faster subroutine calls
6413
6414 =item delete(), each(), values() and hash iteration are faster
6415
6416 =back
6417
6418 =item Installation and Configuration Improvements
6419
6420 =over 4
6421
6422 =item -Dusethreads means something different
6423
6424 =item New Configure flags
6425
6426 =item Threadedness and 64-bitness now more daring
6427
6428 =item Long Doubles
6429
6430 =item -Dusemorebits
6431
6432 =item -Duselargefiles
6433
6434 =item installusrbinperl
6435
6436 =item SOCKS support
6437
6438 =item C<-A> flag
6439
6440 =item Enhanced Installation Directories
6441
6442 =back
6443
6444 =item Platform specific changes
6445
6446 =over 4
6447
6448 =item Supported platforms
6449
6450 =item DOS
6451
6452 =item OS390 (OpenEdition MVS)
6453
6454 =item VMS
6455
6456 =item Win32
6457
6458 =back
6459
6460 =item Significant bug fixes
6461
6462 =over 4
6463
6464 =item <HANDLE> on empty files
6465
6466 =item C<eval '...'> improvements
6467
6468 =item All compilation errors are true errors
6469
6470 =item Implicitly closed filehandles are safer
6471
6472 =item Behavior of list slices is more consistent
6473
6474 =item C<(\$)> prototype and C<$foo{a}>
6475
6476 =item C<goto &sub> and AUTOLOAD
6477
6478 =item C<-bareword> allowed under C<use integer>
6479
6480 =item Failures in DESTROY()
6481
6482 =item Locale bugs fixed
6483
6484 =item Memory leaks
6485
6486 =item Spurious subroutine stubs after failed subroutine calls
6487
6488 =item Taint failures under C<-U>
6489
6490 =item END blocks and the C<-c> switch
6491
6492 =item Potential to leak DATA filehandles
6493
6494 =back
6495
6496 =item New or Changed Diagnostics
6497
6498 "%s" variable %s masks earlier declaration in same %s, "my sub" not yet
6499 implemented, "our" variable %s redeclared, '!' allowed only after types %s,
6500 / cannot take a count, / must be followed by a, A or Z, / must be followed
6501 by a*, A* or Z*, / must follow a numeric type, /%s/: Unrecognized escape
6502 \\%c passed through, /%s/: Unrecognized escape \\%c in character class
6503 passed through, /%s/ should probably be written as "%s", %s() called too
6504 early to check prototype, %s argument is not a HASH or ARRAY element, %s
6505 argument is not a HASH or ARRAY element or slice, %s argument is not a
6506 subroutine name, %s package attribute may clash with future reserved word:
6507 %s, (in cleanup) %s, <> should be quotes, Attempt to join self, Bad evalled
6508 substitution pattern, Bad realloc() ignored, Bareword found in conditional,
6509 Binary number > 0b11111111111111111111111111111111 non-portable, Bit vector
6510 size > 32 non-portable, Buffer overflow in prime_env_iter: %s, Can't check
6511 filesystem of script "%s", Can't declare class for non-scalar %s in "%s",
6512 Can't declare %s in "%s", Can't ignore signal CHLD, forcing to default,
6513 Can't modify non-lvalue subroutine call, Can't read CRTL environ, Can't
6514 remove %s: %s, skipping file, Can't return %s from lvalue subroutine, Can't
6515 weaken a nonreference, Character class [:%s:] unknown, Character class
6516 syntax [%s] belongs inside character classes, Constant is not %s reference,
6517 constant(%s): %s, CORE::%s is not a keyword, defined(@array) is deprecated,
6518 defined(%hash) is deprecated, Did not produce a valid header, (Did you mean
6519 "local" instead of "our"?), Document contains no data, entering effective
6520 %s failed, false [] range "%s" in regexp, Filehandle %s opened only for
6521 output, flock() on closed filehandle %s, Global symbol "%s" requires
6522 explicit package name, Hexadecimal number > 0xffffffff non-portable,
6523 Ill-formed CRTL environ value "%s", Ill-formed message in prime_env_iter:
6524 |%s|, Illegal binary digit %s, Illegal binary digit %s ignored, Illegal
6525 number of bits in vec, Integer overflow in %s number, Invalid %s attribute:
6526 %s, Invalid %s attributes: %s, invalid [] range "%s" in regexp, Invalid
6527 separator character %s in attribute list, Invalid separator character %s in
6528 subroutine attribute list, leaving effective %s failed, Lvalue subs
6529 returning %s not implemented yet, Method %s not permitted, Missing
6530 %sbrace%s on \N{}, Missing command in piped open, Missing name in "my sub",
6531 No %s specified for -%c, No package name allowed for variable %s in "our",
6532 No space allowed after -%c, no UTC offset information; assuming local time
6533 is UTC, Octal number > 037777777777 non-portable, panic: del_backref,
6534 panic: kid popen errno read, panic: magic_killbackrefs, Parentheses missing
6535 around "%s" list, Possible unintended interpolation of %s in string,
6536 Possible Y2K bug: %s, pragma "attrs" is deprecated, use "sub NAME : ATTRS"
6537 instead, Premature end of script headers, Repeat count in pack overflows,
6538 Repeat count in unpack overflows, realloc() of freed memory ignored,
6539 Reference is already weak, setpgrp can't take arguments, Strange *+?{} on
6540 zero-length expression, switching effective %s is not implemented, This
6541 Perl can't reset CRTL environ elements (%s), This Perl can't set CRTL
6542 environ elements (%s=%s), Too late to run %s block, Unknown open() mode
6543 '%s', Unknown process %x sent message to prime_env_iter: %s, Unrecognized
6544 escape \\%c passed through, Unterminated attribute parameter in attribute
6545 list, Unterminated attribute list, Unterminated attribute parameter in
6546 subroutine attribute list, Unterminated subroutine attribute list, Value of
6547 CLI symbol "%s" too long, Version number must be a constant number
6548
6549 =item New tests
6550
6551 =item Incompatible Changes
6552
6553 =over 4
6554
6555 =item Perl Source Incompatibilities
6556
6557 CHECK is a new keyword, Treatment of list slices of undef has changed,
6558 Format of $English::PERL_VERSION is different, Literals of the form
6559 C<1.2.3> parse differently, Possibly changed pseudo-random number
6560 generator, Hashing function for hash keys has changed, C<undef> fails on
6561 read only values, Close-on-exec bit may be set on pipe and socket handles,
6562 Writing C<"$$1"> to mean C<"${$}1"> is unsupported, delete(), each(),
6563 values() and C<\(%h)>, vec(EXPR,OFFSET,BITS) enforces powers-of-two BITS,
6564 Text of some diagnostic output has changed, C<%@> has been removed,
6565 Parenthesized not() behaves like a list operator, Semantics of bareword
6566 prototype C<(*)> have changed, Semantics of bit operators may have changed
6567 on 64-bit platforms, More builtins taint their results
6568
6569 =item C Source Incompatibilities
6570
6571 C<PERL_POLLUTE>, C<PERL_IMPLICIT_CONTEXT>, C<PERL_POLLUTE_MALLOC>
6572
6573 =item Compatible C Source API Changes
6574
6575 C<PATCHLEVEL> is now C<PERL_VERSION>
6576
6577 =item Binary Incompatibilities
6578
6579 =back
6580
6581 =item Known Problems
6582
6583 =over 4
6584
6585 =item Thread test failures
6586
6587 =item EBCDIC platforms not supported
6588
6589 =item In 64-bit HP-UX the lib/io_multihomed test may hang
6590
6591 =item NEXTSTEP 3.3 POSIX test failure
6592
6593 =item Tru64 (aka Digital UNIX, aka DEC OSF/1) lib/sdbm test failure with
6594 gcc
6595
6596 =item UNICOS/mk CC failures during Configure run
6597
6598 =item Arrow operator and arrays
6599
6600 =item Experimental features
6601
6602 Threads, Unicode, 64-bit support, Lvalue subroutines, Weak references, The
6603 pseudo-hash data type, The Compiler suite, Internal implementation of file
6604 globbing, The DB module, The regular expression code constructs:
6605
6606 =back
6607
6608 =item Obsolete Diagnostics
6609
6610 Character class syntax [: :] is reserved for future extensions, Ill-formed
6611 logical name |%s| in prime_env_iter, In string, @%s now must be written as
6612 \@%s, Probable precedence problem on %s, regexp too big, Use of "$$<digit>"
6613 to mean "${$}<digit>" is deprecated
6614
6615 =item Reporting Bugs
6616
6617 =item SEE ALSO
6618
6619 =item HISTORY
6620
6621 =back
6622
6623 =head2 perl5005delta - what's new for perl5.005
6624
6625 =over 4
6626
6627 =item DESCRIPTION
6628
6629 =item About the new versioning system
6630
6631 =item Incompatible Changes
6632
6633 =over 4
6634
6635 =item WARNING:  This version is not binary compatible with Perl 5.004.
6636
6637 =item Default installation structure has changed
6638
6639 =item Perl Source Compatibility
6640
6641 =item C Source Compatibility
6642
6643 =item Binary Compatibility
6644
6645 =item Security fixes may affect compatibility
6646
6647 =item Relaxed new mandatory warnings introduced in 5.004
6648
6649 =item Licensing
6650
6651 =back
6652
6653 =item Core Changes
6654
6655 =over 4
6656
6657 =item Threads
6658
6659 =item Compiler
6660
6661 =item Regular Expressions
6662
6663 Many new and improved optimizations, Many bug fixes, New regular expression
6664 constructs, New operator for precompiled regular expressions, Other
6665 improvements, Incompatible changes
6666
6667 =item   Improved malloc()
6668
6669 =item Quicksort is internally implemented
6670
6671 =item Reliable signals
6672
6673 =item Reliable stack pointers
6674
6675 =item More generous treatment of carriage returns
6676
6677 =item Memory leaks
6678
6679 =item Better support for multiple interpreters
6680
6681 =item Behavior of local() on array and hash elements is now well-defined
6682
6683 =item C<%!> is transparently tied to the L<Errno> module
6684
6685 =item Pseudo-hashes are supported
6686
6687 =item C<EXPR foreach EXPR> is supported
6688
6689 =item Keywords can be globally overridden
6690
6691 =item C<$^E> is meaningful on Win32
6692
6693 =item C<foreach (1..1000000)> optimized
6694
6695 =item C<Foo::> can be used as implicitly quoted package name
6696
6697 =item C<exists $Foo::{Bar::}> tests existence of a package
6698
6699 =item Better locale support
6700
6701 =item Experimental support for 64-bit platforms
6702
6703 =item prototype() returns useful results on builtins
6704
6705 =item Extended support for exception handling
6706
6707 =item Re-blessing in DESTROY() supported for chaining DESTROY() methods
6708
6709 =item All C<printf> format conversions are handled internally
6710
6711 =item New C<INIT> keyword
6712
6713 =item New C<lock> keyword
6714
6715 =item New C<qr//> operator
6716
6717 =item C<our> is now a reserved word
6718
6719 =item Tied arrays are now fully supported
6720
6721 =item Tied handles support is better
6722
6723 =item 4th argument to substr
6724
6725 =item Negative LENGTH argument to splice
6726
6727 =item Magic lvalues are now more magical
6728
6729 =item <> now reads in records
6730
6731 =back
6732
6733 =item Supported Platforms
6734
6735 =over 4
6736
6737 =item New Platforms
6738
6739 =item Changes in existing support
6740
6741 =back
6742
6743 =item Modules and Pragmata
6744
6745 =over 4
6746
6747 =item New Modules
6748
6749 B, Data::Dumper, Dumpvalue, Errno, File::Spec, ExtUtils::Installed,
6750 ExtUtils::Packlist, Fatal, IPC::SysV, Test, Tie::Array, Tie::Handle,
6751 Thread, attrs, fields, re
6752
6753 =item Changes in existing modules
6754
6755 Benchmark, Carp, CGI, Fcntl, Math::Complex, Math::Trig, POSIX, DB_File,
6756 MakeMaker, CPAN, Cwd
6757
6758 =back
6759
6760 =item Utility Changes
6761
6762 =item Documentation Changes
6763
6764 =item New Diagnostics
6765
6766 Ambiguous call resolved as CORE::%s(), qualify as such or use &, Bad index
6767 while coercing array into hash, Bareword "%s" refers to nonexistent
6768 package, Can't call method "%s" on an undefined value, Can't check
6769 filesystem of script "%s" for nosuid, Can't coerce array into hash, Can't
6770 goto subroutine from an eval-string, Can't localize pseudo-hash element,
6771 Can't use %%! because Errno.pm is not available, Cannot find an opnumber
6772 for "%s", Character class syntax [. .] is reserved for future extensions,
6773 Character class syntax [: :] is reserved for future extensions, Character
6774 class syntax [= =] is reserved for future extensions, %s: Eval-group in
6775 insecure regular expression, %s: Eval-group not allowed, use re 'eval', %s:
6776 Eval-group not allowed at run time, Explicit blessing to '' (assuming
6777 package main), Illegal hex digit ignored, No such array field, No such
6778 field "%s" in variable %s of type %s, Out of memory during ridiculously
6779 large request, Range iterator outside integer range, Recursive inheritance
6780 detected while looking for method '%s' %s, Reference found where even-sized
6781 list expected, Undefined value assigned to typeglob, Use of reserved word
6782 "%s" is deprecated, perl: warning: Setting locale failed
6783
6784 =item Obsolete Diagnostics
6785
6786 Can't mktemp(), Can't write to temp file for B<-e>: %s, Cannot open
6787 temporary file, regexp too big
6788
6789 =item Configuration Changes
6790
6791 =item BUGS
6792
6793 =item SEE ALSO
6794
6795 =item HISTORY
6796
6797 =back
6798
6799 =head2 perl5004delta - what's new for perl5.004
6800
6801 =over 4
6802
6803 =item DESCRIPTION
6804
6805 =item Supported Environments
6806
6807 =item Core Changes
6808
6809 =over 4
6810
6811 =item List assignment to %ENV works
6812
6813 =item Change to "Can't locate Foo.pm in @INC" error
6814
6815 =item Compilation option: Binary compatibility with 5.003
6816
6817 =item $PERL5OPT environment variable
6818
6819 =item Limitations on B<-M>, B<-m>, and B<-T> options
6820
6821 =item More precise warnings
6822
6823 =item Deprecated: Inherited C<AUTOLOAD> for non-methods
6824
6825 =item Previously deprecated %OVERLOAD is no longer usable
6826
6827 =item Subroutine arguments created only when they're modified
6828
6829 =item Group vector changeable with C<$)>
6830
6831 =item Fixed parsing of $$<digit>, &$<digit>, etc.
6832
6833 =item Fixed localization of $<digit>, $&, etc.
6834
6835 =item No resetting of $. on implicit close
6836
6837 =item C<wantarray> may return undef
6838
6839 =item C<eval EXPR> determines value of EXPR in scalar context
6840
6841 =item Changes to tainting checks
6842
6843 No glob() or <*>, No spawning if tainted $CDPATH, $ENV, $BASH_ENV, No
6844 spawning if tainted $TERM doesn't look like a terminal name
6845
6846 =item New Opcode module and revised Safe module
6847
6848 =item Embedding improvements
6849
6850 =item Internal change: FileHandle class based on IO::* classes
6851
6852 =item Internal change: PerlIO abstraction interface
6853
6854 =item New and changed syntax
6855
6856 $coderef->(PARAMS)
6857
6858 =item New and changed builtin constants
6859
6860 __PACKAGE__
6861
6862 =item New and changed builtin variables
6863
6864 $^E, $^H, $^M
6865
6866 =item New and changed builtin functions
6867
6868 delete on slices, flock, printf and sprintf, keys as an lvalue, my() in
6869 Control Structures, pack() and unpack(), sysseek(), use VERSION, use Module
6870 VERSION LIST, prototype(FUNCTION), srand, $_ as Default, C<m//gc> does not
6871 reset search position on failure, C<m//x> ignores whitespace before ?*+{},
6872 nested C<sub{}> closures work now, formats work right on changing lexicals
6873
6874 =item New builtin methods
6875
6876 isa(CLASS), can(METHOD), VERSION( [NEED] )
6877
6878 =item TIEHANDLE now supported
6879
6880 TIEHANDLE classname, LIST, PRINT this, LIST, PRINTF this, LIST, READ this
6881 LIST, READLINE this, GETC this, DESTROY this
6882
6883 =item Malloc enhancements
6884
6885 -DPERL_EMERGENCY_SBRK, -DPACK_MALLOC, -DTWO_POT_OPTIMIZE
6886
6887 =item Miscellaneous efficiency enhancements
6888
6889 =back
6890
6891 =item Support for More Operating Systems
6892
6893 =over 4
6894
6895 =item Win32
6896
6897 =item Plan 9
6898
6899 =item QNX
6900
6901 =item AmigaOS
6902
6903 =back
6904
6905 =item Pragmata
6906
6907 use autouse MODULE => qw(sub1 sub2 sub3), use blib, use blib 'dir', use
6908 constant NAME => VALUE, use locale, use ops, use vmsish
6909
6910 =item Modules
6911
6912 =over 4
6913
6914 =item Required Updates
6915
6916 =item Installation directories
6917
6918 =item Module information summary
6919
6920 =item Fcntl
6921
6922 =item IO
6923
6924 =item Math::Complex
6925
6926 =item Math::Trig
6927
6928 =item DB_File
6929
6930 =item Net::Ping
6931
6932 =item Object-oriented overrides for builtin operators
6933
6934 =back
6935
6936 =item Utility Changes
6937
6938 =over 4
6939
6940 =item pod2html
6941
6942 Sends converted HTML to standard output
6943
6944 =item xsubpp
6945
6946 C<void> XSUBs now default to returning nothing
6947
6948 =back
6949
6950 =item C Language API Changes
6951
6952 C<gv_fetchmethod> and C<perl_call_sv>, C<perl_eval_pv>, Extended API for
6953 manipulating hashes
6954
6955 =item Documentation Changes
6956
6957 L<perldelta>, L<perlfaq>, L<perllocale>, L<perltoot>, L<perlapio>,
6958 L<perlmodlib>, L<perldebug>, L<perlsec>
6959
6960 =item New Diagnostics
6961
6962 "my" variable %s masks earlier declaration in same scope, %s argument is
6963 not a HASH element or slice, Allocation too large: %lx, Allocation too
6964 large, Applying %s to %s will act on scalar(%s), Attempt to free
6965 nonexistent shared string, Attempt to use reference as lvalue in substr,
6966 Bareword "%s" refers to nonexistent package, Can't redefine active sort
6967 subroutine %s, Can't use bareword ("%s") as %s ref while "strict refs" in
6968 use, Cannot resolve method `%s' overloading `%s' in package `%s', Constant
6969 subroutine %s redefined, Constant subroutine %s undefined, Copy method did
6970 not return a reference, Died, Exiting pseudo-block via %s, Identifier too
6971 long, Illegal character %s (carriage return), Illegal switch in PERL5OPT:
6972 %s, Integer overflow in hex number, Integer overflow in octal number,
6973 internal error: glob failed, Invalid conversion in %s: "%s", Invalid type
6974 in pack: '%s', Invalid type in unpack: '%s', Name "%s::%s" used only once:
6975 possible typo, Null picture in formline, Offset outside string, Out of
6976 memory!, Out of memory during request for %s, panic: frexp, Possible
6977 attempt to put comments in qw() list, Possible attempt to separate words
6978 with commas, Scalar value @%s{%s} better written as $%s{%s}, Stub found
6979 while resolving method `%s' overloading `%s' in %s, Too late for "B<-T>"
6980 option, untie attempted while %d inner references still exist, Unrecognized
6981 character %s, Unsupported function fork, Use of "$$<digit>" to mean
6982 "${$}<digit>" is deprecated, Value of %s can be "0"; test with defined(),
6983 Variable "%s" may be unavailable, Variable "%s" will not stay shared,
6984 Warning: something's wrong, Ill-formed logical name |%s| in prime_env_iter,
6985 Got an error from DosAllocMem, Malformed PERLLIB_PREFIX, PERL_SH_DIR too
6986 long, Process terminated by SIG%s
6987
6988 =item BUGS
6989
6990 =item SEE ALSO
6991
6992 =item HISTORY
6993
6994 =back
6995
6996 =head2 perlaix, README.aix - Perl version 5 on IBM Unix (AIX) systems
6997
6998 =over 4
6999
7000 =item DESCRIPTION
7001
7002 =over 4
7003
7004 =item Compiling Perl 5 on AIX
7005
7006 =item OS level
7007
7008 =item Building Dynamic Extensions on AIX
7009
7010 =item The IBM ANSI C Compiler
7011
7012 =item Using GNU's gcc for building perl
7013
7014 =item Using Large Files with Perl
7015
7016 =item Threaded Perl
7017
7018 =item 64-bit Perl
7019
7020 =item AIX 4.2 and extensions using C++ with statics
7021
7022 =back
7023
7024 =item AUTHOR
7025
7026 =item DATE
7027
7028 =back
7029
7030 =head2 perlapollo, README.apollo - Perl version 5 on Apollo DomainOS
7031
7032 =over 4
7033
7034 =item DESCRIPTION
7035
7036 =item AUTHOR
7037
7038 =back
7039
7040 =head2 perlamiga - Perl under Amiga OS
7041
7042 =over 4
7043
7044 =item NOTE
7045
7046 =item SYNOPSIS
7047
7048 =back
7049
7050 =over 4
7051
7052 =item DESCRIPTION
7053
7054 =over 4
7055
7056 =item Prerequisites for Compiling Perl on AmigaOS
7057
7058 B<Unix emulation for AmigaOS: ixemul.library>, B<Version of Amiga OS>
7059
7060 =item Starting Perl programs under AmigaOS
7061
7062 =item Shortcomings of Perl under AmigaOS
7063
7064 =back
7065
7066 =item INSTALLATION
7067
7068 =item Accessing documentation
7069
7070 =over 4
7071
7072 =item Manpages for Perl on AmigaOS
7073
7074 =item Perl HTML Documentation on AmigaOS
7075
7076 =item Perl GNU Info Files on AmigaOS
7077
7078 =item Perl LaTeX Documentation on AmigaOS
7079
7080 =back
7081
7082 =item BUILDING PERL ON AMIGAOS
7083
7084 =over 4
7085
7086 =item Build Prerequisites for Perl on AmigaOS
7087
7088 =item Getting the Perl Source for AmigaOS
7089
7090 =item Making Perl on AmigaOS
7091
7092 =item Testing Perl on AmigaOS
7093
7094 =item Installing the built Perl on AmigaOS
7095
7096 =back
7097
7098 =item PERL 5.8.0 BROKEN IN AMIGAOS
7099
7100 =item AUTHORS
7101
7102 =item SEE ALSO
7103
7104 =back
7105
7106 =head2 perlbeos, README.beos - Perl version 5 on BeOS
7107
7108 =over 4
7109
7110 =item DESCRIPTION
7111
7112 =over 4
7113
7114 =item General Issues with Perl on BeOS
7115
7116 =item BeOS Release-specific Notes
7117
7118 R4 x86, R4 PPC
7119
7120 =item Contact Information
7121
7122 =item Update 2002-05-30
7123
7124 =back
7125
7126 =back
7127
7128 =head2 perlbs2000, README.BS2000 - building and installing Perl for BS2000.
7129
7130 =over 4
7131
7132 =item SYNOPSIS
7133
7134 =item DESCRIPTION
7135
7136 =over 4
7137
7138 =item gzip on BS2000
7139
7140 =item bison on BS2000
7141
7142 =item Unpacking Perl Distribution on BS2000
7143
7144 =item Compiling Perl on BS2000
7145
7146 =item Testing Perl on BS2000
7147
7148 =item Installing Perl on BS2000
7149
7150 =item Using Perl in the Posix-Shell of BS2000
7151
7152 =item Using Perl in "native" BS2000
7153
7154 =item Floating point anomalies on BS2000
7155
7156 =back
7157
7158 =item AUTHORS
7159
7160 =item SEE ALSO
7161
7162 =over 4
7163
7164 =item Mailing list
7165
7166 =back
7167
7168 =item HISTORY
7169
7170 =back
7171
7172 =over 4
7173
7174 =item Name
7175
7176 =item Description
7177
7178 =item Build
7179
7180 =over 4
7181
7182 =item Tools & SDK
7183
7184 =item Make
7185
7186 =back
7187
7188 =item Acknowledgements
7189
7190 =item Author
7191
7192 =back
7193
7194 =head2 perlcygwin, README.cygwin - Perl for Cygwin
7195
7196 =over 4
7197
7198 =item SYNOPSIS
7199
7200 =item PREREQUISITES FOR COMPILING PERL ON CYGWIN
7201
7202 =over 4
7203
7204 =item Cygwin = GNU+Cygnus+Windows (Don't leave UNIX without it)
7205
7206 =item Cygwin Configuration
7207
7208 C<PATH>, I<nroff>, Permissions
7209
7210 =back
7211
7212 =item CONFIGURE PERL ON CYGWIN
7213
7214 =over 4
7215
7216 =item Stripping Perl Binaries on Cygwin
7217
7218 =item Optional Libraries for Perl on Cygwin
7219
7220 C<-lcrypt>, C<-lgdbm> (C<use GDBM_File>), C<-ldb> (C<use DB_File>),
7221 C<-lcygipc> (C<use IPC::SysV>), C<-lutil>
7222
7223 =item Configure-time Options for Perl on Cygwin
7224
7225 C<-Uusedl>, C<-Uusemymalloc>, C<-Uuseperlio>, C<-Dusemultiplicity>,
7226 C<-Duse64bitint>, C<-Duselongdouble>, C<-Dusethreads>, C<-Duselargefiles>,
7227 C<-Dmksymlinks>
7228
7229 =item Suspicious Warnings on Cygwin
7230
7231 I<dlsym()>, Win9x and C<d_eofnblk>, Compiler/Preprocessor defines
7232
7233 =back
7234
7235 =item MAKE ON CYGWIN
7236
7237 =over 4
7238
7239 =item Warnings on Cygwin
7240
7241 =item ld2 on Cygwin
7242
7243 =back
7244
7245 =item TEST ON CYGWIN
7246
7247 =over 4
7248
7249 =item File Permissions on Cygwin
7250
7251 =item NDBM_File does not work on FAT filesystems
7252
7253 =item Script Portability on Cygwin
7254
7255 Pathnames, Text/Binary, F<.exe>, chown(), Miscellaneous
7256
7257 =back
7258
7259 =item INSTALL PERL ON CYGWIN
7260
7261 =item MANIFEST ON CYGWIN
7262
7263 Documentation, Build, Configure, Make, Install, Tests, Compiled Perl
7264 Source, Compiled Module Source, Perl Modules/Scripts
7265
7266 =item BUGS ON CYGWIN
7267
7268 =item AUTHORS
7269
7270 =item HISTORY
7271
7272 =back
7273
7274 =head2 perldgux - Perl under DG/UX.
7275
7276 =over 4
7277
7278 =item SYNOPSIS
7279
7280 =back
7281
7282 =over 4
7283
7284 =item DESCRIPTION
7285
7286 =item BUILDING PERL ON DG/UX
7287
7288 =over 4
7289
7290 =item Non-threaded Perl on DG/UX
7291
7292 =item Threaded Perl on DG/UX
7293
7294 =item Testing Perl on DG/UX
7295
7296 =item Installing the built perl on DG/UX
7297
7298 =back
7299
7300 =item AUTHOR
7301
7302 =item SEE ALSO
7303
7304 =back
7305
7306 =head2 perldos - Perl under DOS, W31, W95.
7307
7308 =over 4
7309
7310 =item SYNOPSIS
7311
7312 =item DESCRIPTION
7313
7314 =over 4
7315
7316 =item Prerequisites for Compiling Perl on DOS
7317
7318 DJGPP, Pthreads
7319
7320 =item Shortcomings of Perl under DOS
7321
7322 =item Building Perl on DOS
7323
7324 =item Testing Perl on DOS
7325
7326 =item Installation of Perl on DOS
7327
7328 =back
7329
7330 =item BUILDING AND INSTALLING MODULES ON DOS
7331
7332 =over 4
7333
7334 =item Building Prerequisites for Perl on DOS
7335
7336 =item Unpacking CPAN Modules on DOS
7337
7338 =item Building Non-XS Modules on DOS
7339
7340 =item Building XS Modules on DOS
7341
7342 =back
7343
7344 =item AUTHOR
7345
7346 =item SEE ALSO
7347
7348 =back
7349
7350 =head2 perlepoc, README.epoc - Perl for EPOC
7351
7352 =over 4
7353
7354 =item SYNOPSIS
7355
7356 =item INTRODUCTION
7357
7358 =item INSTALLING PERL ON EPOC
7359
7360 =item STARTING PERL ON EPOC
7361
7362 =over 4
7363
7364 =item Editors on Epoc
7365
7366 =item Features of Perl on Epoc
7367
7368 =item Restrictions of Perl on Epoc
7369
7370 =item Compiling Perl 5 on the EPOC cross compiling environment
7371
7372 =back
7373
7374 =item SUPPORT STATUS OF PERL ON EPOC
7375
7376 =item AUTHOR
7377
7378 =item LAST UPDATE
7379
7380 =back
7381
7382 =head2 perlfreebsd, README.freebsd - Perl version 5 on FreeBSD systems
7383
7384 =over 4
7385
7386 =item DESCRIPTION
7387
7388 =over 4
7389
7390 =item FreeBSD core dumps from readdir_r with ithreads
7391
7392 =item $^X doesn't always contain a full path in FreeBSD
7393
7394 =item Perl will no longer be part of "base FreeBSD"
7395
7396 =back
7397
7398 =item AUTHOR
7399
7400 =back
7401
7402 =head2 perlhpux, README.hpux - Perl version 5 on Hewlett-Packard Unix
7403 (HP-UX) systems
7404
7405 =over 4
7406
7407 =item DESCRIPTION
7408
7409 =over 4
7410
7411 =item Using perl as shipped with HP-UX
7412
7413 =item Compiling Perl 5 on HP-UX
7414
7415 =item PA-RISC
7416
7417 =item PA-RISC 1.0
7418
7419 =item PA-RISC 1.1
7420
7421 =item PA-RISC 2.0
7422
7423 =item Itanium
7424
7425 =item Portability Between PA-RISC Versions
7426
7427 =item Itanium Processor Family and HP-UX
7428
7429 =item Building Dynamic Extensions on HP-UX
7430
7431 =item The HP ANSI C Compiler
7432
7433 =item The GNU C Compiler
7434
7435 =item Using Large Files with Perl on HP-UX
7436
7437 =item Threaded Perl on HP-UX
7438
7439 =item 64-bit Perl on HP-UX
7440
7441 =item Oracle on HP-UX
7442
7443 =item GDBM and Threads on HP-UX
7444
7445 =item NFS filesystems and utime(2) on HP-UX
7446
7447 =item perl -P and // and HP-UX
7448
7449 =item HP-UX Kernel Parameters (maxdsiz) for Compiling Perl
7450
7451 =back
7452
7453 =item nss_delete core dump from op/pwent or op/grent
7454
7455 =item AUTHOR
7456
7457 =item DATE
7458
7459 =back
7460
7461 =head2 perlhurd, README.hurd - Perl version 5 on Hurd
7462
7463 =over 4
7464
7465 =item DESCRIPTION
7466
7467 =over 4
7468
7469 =item Known Problems with Perl on Hurd
7470
7471 =back
7472
7473 =item AUTHOR
7474
7475 =back
7476
7477 =head2 perlirix, README.irix - Perl version 5 on Irix systems
7478
7479 =over 4
7480
7481 =item DESCRIPTION
7482
7483 =over 4
7484
7485 =item Building 32-bit Perl in Irix
7486
7487 =item Building 64-bit Perl in Irix
7488
7489 =item About Compiler Versions of Irix
7490
7491 =item Linker Problems in Irix
7492
7493 =item Malloc in Irix
7494
7495 =item Building with threads in Irix
7496
7497 =back
7498
7499 =item AUTHOR
7500
7501 =back
7502
7503 =head2 perlmachten, README.machten - Perl version 5 on Power MachTen
7504 systems
7505
7506 =over 4
7507
7508 =item DESCRIPTION
7509
7510 =over 4
7511
7512 =item Compiling Perl 5 on MachTen
7513
7514 =item Failures during C<make test> on MachTen
7515
7516 op/lexassign.t, pragma/warnings.t
7517
7518 =item Building external modules on MachTen
7519
7520 =back
7521
7522 =item AUTHOR
7523
7524 =item DATE
7525
7526 =back
7527
7528 =head2 perlmacos, README.macos - Perl under Mac OS (Classic)
7529
7530 =over 4
7531
7532 =item SYNOPSIS
7533
7534 =item DESCRIPTION
7535
7536 =item AUTHOR
7537
7538 =item DATE
7539
7540 =back
7541
7542 =head2 perlmint, README.mint - Perl version 5 on Atari MiNT
7543
7544 =over 4
7545
7546 =item DESCRIPTION
7547
7548 =item Known problems with Perl on MiNT
7549
7550 =item AUTHOR
7551
7552 =back
7553
7554 =head2 perlmpeix, README.mpeix - Perl/iX for HP e3000 MPE
7555
7556 =over 4
7557
7558 =item SYNOPSIS
7559
7560 =item NOTE
7561
7562 =item Binary distribution from HP
7563
7564 =item What's New in Perl for MPE/iX
7565
7566 =item Welcome to Perl/iX
7567
7568 =item System Requirements for Perl/iX
7569
7570 =item How to Obtain Perl/iX
7571
7572 =item Perl/iX Distribution Contents Highlights
7573
7574 README, INSTALL, LIBSHP3K, PERL, .cpan/, lib/, man/,
7575 public_html/feedback.cgi, src/perl-5.6.0-mpe
7576
7577 =item How to Compile Perl/iX
7578
7579  4,  6
7580
7581 =item Getting Started with Perl/iX
7582
7583 =item MPE/iX Implementation Considerations
7584
7585 =item Known Perl/iX Bugs Under Investigation
7586
7587 =item Perl/iX To-Do List
7588
7589 =item Perl/iX Change History
7590
7591 =item AUTHOR
7592
7593 =item Name
7594
7595 =item Description
7596
7597 =item Build
7598
7599 =over 4
7600
7601 =item Tools & SDK
7602
7603 =item Setup
7604
7605 SetNWBld.bat, Buildtype.bat
7606
7607 =item Make
7608
7609 =item Interpreter
7610
7611 =item Extensions
7612
7613 =back
7614
7615 =item Install
7616
7617 =item Build new extensions
7618
7619 =item Acknowledgements
7620
7621 =item Authors
7622
7623 =item Date
7624
7625 =back
7626
7627 =head2 perlos2 - Perl under OS/2, DOS, Win0.3*, Win0.95 and WinNT.
7628
7629 =over 4
7630
7631 =item SYNOPSIS
7632
7633 =back
7634
7635 =over 4
7636
7637 =item DESCRIPTION
7638
7639 =over 4
7640
7641 =item Target
7642
7643 =item Other OSes
7644
7645 =item Prerequisites
7646
7647 EMX, RSX, HPFS, pdksh
7648
7649 =item Starting Perl programs under OS/2 (and DOS and...)
7650
7651 =item Starting OS/2 (and DOS) programs under Perl
7652
7653 =back
7654
7655 =item Frequently asked questions
7656
7657 =over 4
7658
7659 =item "It does not work"
7660
7661 =item I cannot run external programs
7662
7663 =item I cannot embed perl into my program, or use F<perl.dll> from my
7664 program.
7665
7666 Is your program EMX-compiled with C<-Zmt -Zcrtdll>?, Did you use
7667 L<ExtUtils::Embed>?
7668
7669 =item C<``> and pipe-C<open> do not work under DOS.
7670
7671 =item Cannot start C<find.exe "pattern" file>
7672
7673 =back
7674
7675 =item INSTALLATION
7676
7677 =over 4
7678
7679 =item Automatic binary installation
7680
7681 C<PERL_BADLANG>, C<PERL_BADFREE>, F<Config.pm>
7682
7683 =item Manual binary installation
7684
7685 Perl VIO and PM executables (dynamically linked), Perl_ VIO executable
7686 (statically linked), Executables for Perl utilities, Main Perl library,
7687 Additional Perl modules, Tools to compile Perl modules, Manpages for Perl
7688 and utilities, Manpages for Perl modules, Source for Perl documentation,
7689 Perl manual in F<.INF> format, Pdksh
7690
7691 =item B<Warning>
7692
7693 =back
7694
7695 =item Accessing documentation
7696
7697 =over 4
7698
7699 =item OS/2 F<.INF> file
7700
7701 =item Plain text
7702
7703 =item Manpages
7704
7705 =item HTML
7706
7707 =item GNU C<info> files
7708
7709 =item F<PDF> files
7710
7711 =item C<LaTeX> docs
7712
7713 =back
7714
7715 =item BUILD
7716
7717 =over 4
7718
7719 =item The short story
7720
7721 =item Prerequisites
7722
7723 =item Getting perl source
7724
7725 =item Application of the patches
7726
7727 =item Hand-editing
7728
7729 =item Making
7730
7731 =item Testing
7732
7733 A lot of C<bad free>, Process terminated by SIGTERM/SIGINT, F<op/fs.t>,
7734 F<op/stat.t>
7735
7736 =item Installing the built perl
7737
7738 =item C<a.out>-style build
7739
7740 =back
7741
7742 =item Build FAQ
7743
7744 =over 4
7745
7746 =item Some C</> became C<\> in pdksh.
7747
7748 =item C<'errno'> - unresolved external
7749
7750 =item Problems with tr or sed
7751
7752 =item Some problem (forget which ;-)
7753
7754 =item Library ... not found
7755
7756 =item Segfault in make
7757
7758 =item op/sprintf test failure
7759
7760 =back
7761
7762 =item Specific (mis)features of OS/2 port
7763
7764 =over 4
7765
7766 =item C<setpriority>, C<getpriority>
7767
7768 =item C<system()>
7769
7770 =item C<extproc> on the first line
7771
7772 =item Additional modules:
7773
7774 =item Prebuilt methods:
7775
7776 C<File::Copy::syscopy>, C<DynaLoader::mod2fname>,  C<Cwd::current_drive()>,
7777  C<Cwd::sys_chdir(name)>,  C<Cwd::change_drive(name)>,
7778 C<Cwd::sys_is_absolute(name)>,  C<Cwd::sys_is_rooted(name)>,
7779 C<Cwd::sys_is_relative(name)>,  C<Cwd::sys_cwd(name)>,
7780 C<Cwd::sys_abspath(name, dir)>,  C<Cwd::extLibpath([type])>,
7781 C<Cwd::extLibpath_set( path [, type ] )>,
7782 C<OS2::Error(do_harderror,do_exception)>, C<OS2::Errors2Drive(drive)>,
7783 OS2::SysInfo(), OS2::BootDrive(), C<OS2::MorphPM(serve)>,
7784 C<OS2::UnMorphPM(serve)>, C<OS2::Serve_Messages(force)>,
7785 C<OS2::Process_Messages(force [, cnt])>, C<OS2::_control87(new,mask)>,
7786 OS2::get_control87(), C<OS2::set_control87_em(new=MCW_EM,mask=MCW_EM)>,
7787 C<OS2::DLLname([how [, \&xsub]])>
7788
7789 =item Prebuilt variables:
7790
7791 $OS2::emx_rev, $OS2::emx_env, $OS2::os_ver, $OS2::is_aout, $OS2::can_fork,
7792 $OS2::nsyserror
7793
7794 =item Misfeatures
7795
7796 =item Modifications
7797
7798 C<popen>, C<tmpnam>, C<tmpfile>, C<ctermid>, C<stat>, C<mkdir>, C<rmdir>,
7799 C<flock>
7800
7801 =item Identifying DLLs
7802
7803 =item Centralized management of resources
7804
7805 C<HAB>, C<HMQ>, Treating errors reported by OS/2 API,
7806 C<CheckOSError(expr)>, C<CheckWinError(expr)>, C<SaveWinError(expr)>,
7807 C<SaveCroakWinError(expr,die,name1,name2)>, C<WinError_2_Perl_rc>,
7808 C<FillWinError>, C<FillOSError(rc)>, Loading DLLs and ordinals in DLLs
7809
7810 =back
7811
7812 =item Perl flavors
7813
7814 =over 4
7815
7816 =item F<perl.exe>
7817
7818 =item F<perl_.exe>
7819
7820 =item F<perl__.exe>
7821
7822 =item F<perl___.exe>
7823
7824 =item Why strange names?
7825
7826 =item Why dynamic linking?
7827
7828 =item Why chimera build?
7829
7830 =back
7831
7832 =item ENVIRONMENT
7833
7834 =over 4
7835
7836 =item C<PERLLIB_PREFIX>
7837
7838 =item C<PERL_BADLANG>
7839
7840 =item C<PERL_BADFREE>
7841
7842 =item C<PERL_SH_DIR>
7843
7844 =item C<USE_PERL_FLOCK>
7845
7846 =item C<TMP> or C<TEMP>
7847
7848 =back
7849
7850 =item Evolution
7851
7852 =over 4
7853
7854 =item Text-mode filehandles
7855
7856 =item Priorities
7857
7858 =item DLL name mangling: pre 5.6.2
7859
7860 =item DLL name mangling: 5.6.2 and beyond
7861
7862 Global DLLs, specific DLLs, C<BEGINLIBPATH> and C<ENDLIBPATH>, F<.> from
7863 C<LIBPATH>
7864
7865 =item DLL forwarder generation
7866
7867 =item Threading
7868
7869 =item Calls to external programs
7870
7871 =item Memory allocation
7872
7873 =item Threads
7874
7875 C<COND_WAIT>, F<os2.c>
7876
7877 =back
7878
7879 =item BUGS
7880
7881 =back
7882
7883 =over 4
7884
7885 =item AUTHOR
7886
7887 =item SEE ALSO
7888
7889 =back
7890
7891 =head2 perlos390, README.os390 - building and installing Perl for OS/390
7892 and z/OS
7893
7894 =over 4
7895
7896 =item SYNOPSIS
7897
7898 =item DESCRIPTION
7899
7900 =over 4
7901
7902 =item Tools
7903
7904 =item Unpacking Perl distribution on OS/390
7905
7906 =item Setup and utilities for Perl on OS/390
7907
7908 =item Configure Perl on OS/390
7909
7910 =item Build, Test, Install Perl on OS/390
7911
7912 =item Build Anomalies with Perl on OS/390
7913
7914 =item Testing Anomalies with Perl on OS/390
7915
7916 =item Installation Anomalies with Perl on OS/390
7917
7918 =item Usage Hints for Perl on OS/390
7919
7920 =item Floating Point Anomalies with Perl on OS/390
7921
7922 =item Modules and Extensions for Perl on OS/390
7923
7924 =back
7925
7926 =item AUTHORS
7927
7928 =item SEE ALSO
7929
7930 =over 4
7931
7932 =item Mailing list for Perl on OS/390
7933
7934 =back
7935
7936 =item HISTORY
7937
7938 =back
7939
7940 =head2 perlqnx, README.qnx - Perl version 5 on QNX
7941
7942 =over 4
7943
7944 =item DESCRIPTION
7945
7946 =over 4
7947
7948 =item Required Software for Compiling Perl on QNX4
7949
7950 /bin/sh, ar, nm, cpp, make
7951
7952 =item Outstanding Issues with Perl on QNX4
7953
7954 =item QNX auxiliary files
7955
7956 qnx/ar, qnx/cpp
7957
7958 =item Outstanding issues with perl under QNX6
7959
7960 =back
7961
7962 =item AUTHOR
7963
7964 =back
7965
7966 =head2 perlplan9 - Plan 9-specific documentation for Perl
7967
7968 =over 4
7969
7970 =item DESCRIPTION
7971
7972 =over 4
7973
7974 =item Invoking Perl
7975
7976 =item What's in Plan 9 Perl
7977
7978 =item What's not in Plan 9 Perl
7979
7980 =item Perl5 Functions not currently supported in Plan 9 Perl
7981
7982 =item Signals in Plan 9 Perl
7983
7984 =back
7985
7986 =item COMPILING AND INSTALLING PERL ON PLAN 9
7987
7988 =over 4
7989
7990 =item Installing Perl Documentation on Plan 9
7991
7992 =back
7993
7994 =item BUGS
7995
7996 =item Revision date
7997
7998 =item AUTHOR
7999
8000 =back
8001
8002 =head2 perlsolaris, README.solaris - Perl version 5 on Solaris systems
8003
8004 =over 4
8005
8006 =item DESCRIPTION
8007
8008 =over 4
8009
8010 =item Solaris Version Numbers.
8011
8012 =back
8013
8014 =item RESOURCES
8015
8016 Solaris FAQ, Precompiled Binaries, Solaris Documentation
8017
8018 =item SETTING UP
8019
8020 =over 4
8021
8022 =item File Extraction Problems on Solaris.
8023
8024 =item Compiler and Related Tools on Solaris.
8025
8026 =item Environment for Compiling Perl on Solaris
8027
8028 =back
8029
8030 =item RUN CONFIGURE.
8031
8032 =over 4
8033
8034 =item 64-bit Issues with Perl on Solaris.
8035
8036 =item Threads in Perl on Solaris.
8037
8038 =item Malloc Issues with Perl on Solaris.
8039
8040 =back
8041
8042 =item MAKE PROBLEMS.
8043
8044 Dynamic Loading Problems With GNU as and GNU ld, ld.so.1: ./perl: fatal:
8045 relocation error:, dlopen: stub interception failed, #error "No
8046 DATAMODEL_NATIVE specified", sh: ar: not found
8047
8048 =item MAKE TEST
8049
8050 =over 4
8051
8052 =item op/stat.t test 4 in Solaris
8053
8054 =item nss_delete core dump from op/pwent or op/grent
8055
8056 =back
8057
8058 =item PREBUILT BINARIES OF PERL FOR SOLARIS.
8059
8060 =item RUNTIME ISSUES FOR PERL ON SOLARIS.
8061
8062 =over 4
8063
8064 =item Limits on Numbers of Open Files on Solaris.
8065
8066 =back
8067
8068 =item SOLARIS-SPECIFIC MODULES.
8069
8070 =item SOLARIS-SPECIFIC PROBLEMS WITH MODULES.
8071
8072 =over 4
8073
8074 =item Proc::ProcessTable on Solaris
8075
8076 =item BSD::Resource on Solaris
8077
8078 =item Net::SSLeay on Solaris
8079
8080 =back
8081
8082 =item AUTHOR
8083
8084 =item LAST MODIFIED
8085
8086 =back
8087
8088 =head2 perltru64, README.tru64 - Perl version 5 on Tru64 (formerly known as
8089 Digital UNIX formerly known as DEC OSF/1) systems
8090
8091 =over 4
8092
8093 =item DESCRIPTION
8094
8095 =over 4
8096
8097 =item Compiling Perl 5 on Tru64
8098
8099 =item Using Large Files with Perl on Tru64
8100
8101 =item Threaded Perl on Tru64
8102
8103 =item Long Doubles on Tru64
8104
8105 =item 64-bit Perl on Tru64
8106
8107 =item Warnings about floating-point overflow when compiling Perl on Tru64
8108
8109 =back
8110
8111 =item Testing Perl on Tru64
8112
8113 =item ext/ODBM_File/odbm Test Failing With Static Builds
8114
8115 =item Perl Fails Because Of Unresolved Symbol sockatmark
8116
8117 =item AUTHOR
8118
8119 =back
8120
8121 =head2 perluts - Perl under UTS
8122
8123 =over 4
8124
8125 =item SYNOPSIS
8126
8127 =item DESCRIPTION
8128
8129 =item BUILDING PERL ON UTS
8130
8131 =item Installing the built perl on UTS
8132
8133 =item AUTHOR
8134
8135 =back
8136
8137 =head2 perlvmesa, README.vmesa - building and installing Perl for VM/ESA.
8138
8139 =over 4
8140
8141 =item SYNOPSIS
8142
8143 =item DESCRIPTION
8144
8145 =over 4
8146
8147 =item Unpacking Perl Distribution on VM/ESA
8148
8149 =item Setup Perl and utilities on VM/ESA
8150
8151 =item Configure Perl on VM/ESA
8152
8153 =item Testing Anomalies of Perl on VM/ESA
8154
8155 =item Usage Hints for Perl on VM/ESA
8156
8157 =back
8158
8159 =item AUTHORS
8160
8161 =item SEE ALSO
8162
8163 =over 4
8164
8165 =item Mailing list for Perl on VM/ESA
8166
8167 =back
8168
8169 =back
8170
8171 =head2 perlvms - VMS-specific documentation for Perl
8172
8173 =over 4
8174
8175 =item DESCRIPTION
8176
8177 =item Installation
8178
8179 =item Organization of Perl Images
8180
8181 =over 4
8182
8183 =item Core Images
8184
8185 =item Perl Extensions
8186
8187 =item Installing static extensions
8188
8189 =item Installing dynamic extensions
8190
8191 =back
8192
8193 =item File specifications
8194
8195 =over 4
8196
8197 =item Syntax
8198
8199 =item Wildcard expansion
8200
8201 =item Pipes
8202
8203 =back
8204
8205 =item PERL5LIB and PERLLIB
8206
8207 =item Command line
8208
8209 =over 4
8210
8211 =item I/O redirection and backgrounding
8212
8213 =item Command line switches
8214
8215 -i, -S, -u
8216
8217 =back
8218
8219 =item Perl functions
8220
8221 File tests, backticks, binmode FILEHANDLE, crypt PLAINTEXT, USER, dump,
8222 exec LIST, fork, getpwent, getpwnam, getpwuid, gmtime, kill, qx//, select
8223 (system call), stat EXPR, system LIST, time, times, unlink LIST, utime
8224 LIST, waitpid PID,FLAGS
8225
8226 =item Perl variables
8227
8228 %ENV, CRTL_ENV, CLISYM_[LOCAL], Any other string, $!, $^E, $?, $|
8229
8230 =item Standard modules with VMS-specific differences
8231
8232 =over 4
8233
8234 =item SDBM_File
8235
8236 =back
8237
8238 =item Revision date
8239
8240 =item AUTHOR
8241
8242 =back
8243
8244 =head2 perlvos, README.vos - Perl for Stratus VOS
8245
8246 =over 4
8247
8248 =item SYNOPSIS
8249
8250 =over 4
8251
8252 =item Multiple methods to build perl for VOS
8253
8254 =item Stratus POSIX Support
8255
8256 =back
8257
8258 =item INSTALLING PERL IN VOS
8259
8260 =over 4
8261
8262 =item Compiling Perl 5 on VOS
8263
8264 =item Installing Perl 5 on VOS
8265
8266 =back
8267
8268 =item USING PERL IN VOS
8269
8270 =over 4
8271
8272 =item Unimplemented Features of Perl on VOS
8273
8274 =item Restrictions of Perl on VOS
8275
8276 =item Handling of underflow and overflow
8277
8278 =back
8279
8280 =item TEST STATUS
8281
8282 =item SUPPORT STATUS
8283
8284 =item AUTHOR
8285
8286 =item LAST UPDATE
8287
8288 =back
8289
8290 =head2 perlwin32 - Perl under Windows
8291
8292 =over 4
8293
8294 =item SYNOPSIS
8295
8296 =item DESCRIPTION
8297
8298 =over 4
8299
8300 =item Setting Up Perl on Win32
8301
8302 Make, Command Shell, Borland C++, Microsoft Visual C++, Microsoft Platform
8303 SDK 64-bit Compiler, Mingw32 with GCC
8304
8305 =item Building
8306
8307 =item Testing Perl on Win32
8308
8309 =item Installation of Perl on Win32
8310
8311 =item Usage Hints for Perl on Win32
8312
8313 Environment Variables, File Globbing, Using perl from the command line,
8314 Building Extensions, Command-line Wildcard Expansion, Win32 Specific
8315 Extensions, Notes on 64-bit Windows
8316
8317 =item Running Perl Scripts
8318
8319 Miscellaneous Things
8320
8321 =back
8322
8323 =item BUGS AND CAVEATS
8324
8325 =item AUTHORS
8326
8327 Gary Ng E<lt>71564.1743@CompuServe.COME<gt>, Gurusamy Sarathy
8328 E<lt>gsar@activestate.comE<gt>, Nick Ing-Simmons
8329 E<lt>nick@ing-simmons.netE<gt>
8330
8331 =item SEE ALSO
8332
8333 =item HISTORY
8334
8335 =back
8336
8337 =head1 PRAGMA DOCUMENTATION
8338
8339 =head2 attrs - set/get attributes of a subroutine (deprecated)
8340
8341 =over 4
8342
8343 =item SYNOPSIS
8344
8345 =item DESCRIPTION
8346
8347 method, locked
8348
8349 =back
8350
8351 =head2 re - Perl pragma to alter regular expression behaviour
8352
8353 =over 4
8354
8355 =item SYNOPSIS
8356
8357 =item DESCRIPTION
8358
8359 =back
8360
8361 =head2 threadshared::shared, threads::shared - Perl extension for sharing
8362 data structures between threads
8363
8364 =over 4
8365
8366 =item SYNOPSIS
8367
8368 =item DESCRIPTION
8369
8370 =item EXPORT
8371
8372 =item FUNCTIONS
8373
8374 share VARIABLE, lock VARIABLE, cond_wait VARIABLE, cond_signal VARIABLE,
8375 cond_broadcast VARIABLE
8376
8377 =item NOTES
8378
8379 =item BUGS
8380
8381 =item AUTHOR
8382
8383 =item SEE ALSO
8384
8385 =back
8386
8387 =head2 threads - Perl extension allowing use of interpreter based threads
8388 from perl
8389
8390 =over 4
8391
8392 =item SYNOPSIS
8393
8394 =item DESCRIPTION
8395
8396 $thread = threads->create(function, LIST), $thread->join, $thread->detach,
8397 threads->self, $thread->tid, threads->object( tid ), threads->yield();,
8398 threads->list();, async BLOCK;
8399
8400 =item WARNINGS
8401
8402 A thread exited while %d other threads were still running
8403
8404 =item TODO
8405
8406 =item BUGS
8407
8408 Parent-Child threads, Returning objects, Creating threads inside BEGIN
8409 blocks, PERL_OLD_SIGNALS are not threadsafe, will not be
8410
8411 =item AUTHOR and COPYRIGHT
8412
8413 =item SEE ALSO
8414
8415 =back
8416
8417 =head2 attributes - get/set subroutine or variable attributes
8418
8419 =over 4
8420
8421 =item SYNOPSIS
8422
8423 =item DESCRIPTION
8424
8425 =over 4
8426
8427 =item Built-in Attributes
8428
8429 locked, method, lvalue
8430
8431 =item Available Subroutines
8432
8433 get, reftype
8434
8435 =item Package-specific Attribute Handling
8436
8437 FETCH_I<type>_ATTRIBUTES, MODIFY_I<type>_ATTRIBUTES
8438
8439 =item Syntax of Attribute Lists
8440
8441 =back
8442
8443 =item EXPORTS
8444
8445 =over 4
8446
8447 =item Default exports
8448
8449 =item Available exports
8450
8451 =item Export tags defined
8452
8453 =back
8454
8455 =item EXAMPLES
8456
8457 =item SEE ALSO
8458
8459 =back
8460
8461 =head2 attrs - set/get attributes of a subroutine (deprecated)
8462
8463 =over 4
8464
8465 =item SYNOPSIS
8466
8467 =item DESCRIPTION
8468
8469 method, locked
8470
8471 =back
8472
8473 =head2 autouse - postpone load of modules until a function is used
8474
8475 =over 4
8476
8477 =item SYNOPSIS
8478
8479 =item DESCRIPTION
8480
8481 =item WARNING
8482
8483 =item AUTHOR
8484
8485 =item SEE ALSO
8486
8487 =back
8488
8489 =head2 base - Establish IS-A relationship with base class at compile time
8490
8491 =over 4
8492
8493 =item SYNOPSIS
8494
8495 =item DESCRIPTION
8496
8497 =item HISTORY
8498
8499 =item SEE ALSO
8500
8501 =back
8502
8503 =head2 bigint - Transparent big integer support for Perl
8504
8505 =over 4
8506
8507 =item SYNOPSIS
8508
8509 =item DESCRIPTION
8510
8511 =over 4
8512
8513 =item OPTIONS
8514
8515 a or accuracy, p or precision, t or trace, l or lib, v or version
8516
8517 =item MATH LIBRARY
8518
8519 =item INTERNAL FORMAT
8520
8521 =item SIGN
8522
8523 =item METHODS
8524
8525 =back
8526
8527 =item MODULES USED
8528
8529 =item EXAMPLES
8530
8531 =item LICENSE
8532
8533 =item SEE ALSO
8534
8535 =item AUTHORS
8536
8537 =back
8538
8539 =head2 bignum - Transparent BigNumber support for Perl
8540
8541 =over 4
8542
8543 =item SYNOPSIS
8544
8545 =item DESCRIPTION
8546
8547 =over 4
8548
8549 =item OPTIONS
8550
8551 a or accuracy, p or precision, t or trace, l or lib, v or version
8552
8553 =item MATH LIBRARY
8554
8555 =item INTERNAL FORMAT
8556
8557 =item SIGN
8558
8559 =item METHODS
8560
8561 =back
8562
8563 =item MODULES USED
8564
8565 =item EXAMPLES
8566
8567 =item LICENSE
8568
8569 =item SEE ALSO
8570
8571 =item AUTHORS
8572
8573 =back
8574
8575 =head2 bigrat - Transparent BigNumber/BigRational support for Perl
8576
8577 =over 4
8578
8579 =item SYNOPSIS
8580
8581 =item DESCRIPTION
8582
8583 =over 4
8584
8585 =item MODULES USED
8586
8587 =item MATH LIBRARY
8588
8589 =item SIGN
8590
8591 =item METHODS
8592
8593 =back
8594
8595 =item EXAMPLES
8596
8597         perl -Mbigrat -le 'print sqrt(33)'
8598         perl -Mbigrat -le 'print 2*255'
8599         perl -Mbigrat -le 'print 4.5+2*255'
8600         perl -Mbigrat -le 'print 3/7 + 5/7 + 8/3'
8601         perl -Mbigrat -le 'print 12->is_odd()';
8602
8603 =item LICENSE
8604
8605 =item SEE ALSO
8606
8607 =item AUTHORS
8608
8609 =back
8610
8611 =head2 blib - Use MakeMaker's uninstalled version of a package
8612
8613 =over 4
8614
8615 =item SYNOPSIS
8616
8617 =item DESCRIPTION
8618
8619 =item BUGS
8620
8621 =item AUTHOR
8622
8623 =back
8624
8625 =head2 bytes - Perl pragma to force byte semantics rather than character
8626 semantics
8627
8628 =over 4
8629
8630 =item SYNOPSIS
8631
8632 =item DESCRIPTION
8633
8634 =item SEE ALSO
8635
8636 =back
8637
8638 =head2 charnames - define character names for C<\N{named}> string literal
8639 escapes
8640
8641 =over 4
8642
8643 =item SYNOPSIS
8644
8645 =item DESCRIPTION
8646
8647 =item CUSTOM TRANSLATORS
8648
8649 =item charnames::viacode(code)
8650
8651 =item charnames::vianame(name)
8652
8653 =item ALIASES
8654
8655 =item ILLEGAL CHARACTERS
8656
8657 =item BUGS
8658
8659 =back
8660
8661 =head2 constant - Perl pragma to declare constants
8662
8663 =over 4
8664
8665 =item SYNOPSIS
8666
8667 =item DESCRIPTION
8668
8669 =item NOTES
8670
8671 =over 4
8672
8673 =item List constants
8674
8675 =item Defining multiple constants at once
8676
8677 =item Magic constants
8678
8679 =back
8680
8681 =item TECHNICAL NOTES
8682
8683 =item BUGS
8684
8685 =item AUTHOR
8686
8687 =item COPYRIGHT
8688
8689 =back
8690
8691 =head2 diagnostics - Perl compiler pragma to force verbose warning
8692 diagnostics
8693
8694 =over 4
8695
8696 =item SYNOPSIS
8697
8698 =item DESCRIPTION
8699
8700 =over 4
8701
8702 =item The C<diagnostics> Pragma
8703
8704 =item The I<splain> Program
8705
8706 =back
8707
8708 =item EXAMPLES
8709
8710 =item INTERNALS
8711
8712 =item BUGS
8713
8714 =item AUTHOR
8715
8716 =back
8717
8718 =head2 encoding - allows you to write your script in non-ascii or non-utf8
8719
8720 =over 4
8721
8722 =item SYNOPSIS
8723
8724 =item ABSTRACT
8725
8726 =item USAGE
8727
8728 use encoding [I<ENCNAME>] ;, use encoding I<ENCNAME> [ STDIN =E<gt>
8729 I<ENCNAME_IN> ...] ;, no encoding;
8730
8731 =item CAVEATS
8732
8733 =over 4
8734
8735 =item NOT SCOPED
8736
8737 =item DO NOT MIX MULTIPLE ENCODINGS
8738
8739 =back
8740
8741 =item Non-ASCII Identifiers and Filter option
8742
8743 use encoding I<ENCNAME> Filter=E<gt>1;
8744
8745 =item EXAMPLE - Greekperl
8746
8747 =item KNOWN PROBLEMS
8748
8749 =item SEE ALSO
8750
8751 =back
8752
8753 =head2 fields - compile-time class fields
8754
8755 =over 4
8756
8757 =item SYNOPSIS
8758
8759 =item DESCRIPTION
8760
8761 new, phash
8762
8763 =item SEE ALSO
8764
8765 =back
8766
8767 =head2 filetest - Perl pragma to control the filetest permission operators
8768
8769 =over 4
8770
8771 =item SYNOPSIS
8772
8773 =item DESCRIPTION
8774
8775 =over 4
8776
8777 =item subpragma access
8778
8779 =back
8780
8781 =back
8782
8783 =head2 if - C<use> a Perl module if a condition holds
8784
8785 =over 4
8786
8787 =item SYNOPSIS
8788
8789 =item DESCRIPTION
8790
8791 =item BUGS
8792
8793 =item AUTHOR
8794
8795 =back
8796
8797 =head2 integer - Perl pragma to use integer arithmetic instead of floating
8798 point
8799
8800 =over 4
8801
8802 =item SYNOPSIS
8803
8804 =item DESCRIPTION
8805
8806 =back
8807
8808 =head2 less - perl pragma to request less of something from the compiler
8809
8810 =over 4
8811
8812 =item SYNOPSIS
8813
8814 =item DESCRIPTION
8815
8816 =back
8817
8818 =head2 lib - manipulate @INC at compile time
8819
8820 =over 4
8821
8822 =item SYNOPSIS
8823
8824 =item DESCRIPTION
8825
8826 =over 4
8827
8828 =item Adding directories to @INC
8829
8830 =item Deleting directories from @INC
8831
8832 =item Restoring original @INC
8833
8834 =back
8835
8836 =item CAVEATS
8837
8838 =item NOTES
8839
8840 =item SEE ALSO
8841
8842 =item AUTHOR
8843
8844 =back
8845
8846 =head2 locale - Perl pragma to use and avoid POSIX locales for built-in
8847 operations
8848
8849 =over 4
8850
8851 =item SYNOPSIS
8852
8853 =item DESCRIPTION
8854
8855 =back
8856
8857 =head2 open - perl pragma to set default PerlIO layers for input and output
8858
8859 =over 4
8860
8861 =item SYNOPSIS
8862
8863 =item DESCRIPTION
8864
8865 =item NONPERLIO FUNCTIONALITY
8866
8867 =item IMPLEMENTATION DETAILS
8868
8869 =item SEE ALSO
8870
8871 =back
8872
8873 =head2 ops - Perl pragma to restrict unsafe operations when compiling
8874
8875 =over 4
8876
8877 =item SYNOPSIS
8878
8879 =item DESCRIPTION
8880
8881 =item SEE ALSO
8882
8883 =back
8884
8885 =head2 overload - Package for overloading perl operations
8886
8887 =over 4
8888
8889 =item SYNOPSIS
8890
8891 =item DESCRIPTION
8892
8893 =over 4
8894
8895 =item Declaration of overloaded functions
8896
8897 =item Calling Conventions for Binary Operations
8898
8899 FALSE, TRUE, C<undef>
8900
8901 =item Calling Conventions for Unary Operations
8902
8903 =item Calling Conventions for Mutators
8904
8905 C<++> and C<-->, C<x=> and other assignment versions
8906
8907 =item Overloadable Operations
8908
8909 I<Arithmetic operations>, I<Comparison operations>, I<Bit operations>,
8910 I<Increment and decrement>, I<Transcendental functions>, I<Boolean, string
8911 and numeric conversion>, I<Iteration>, I<Dereferencing>, I<Special>
8912
8913 =item Inheritance and overloading
8914
8915 Strings as values of C<use overload> directive, Overloading of an operation
8916 is inherited by derived classes
8917
8918 =back
8919
8920 =item SPECIAL SYMBOLS FOR C<use overload>
8921
8922 =over 4
8923
8924 =item Last Resort
8925
8926 =item Fallback
8927
8928 C<undef>, TRUE, defined, but FALSE
8929
8930 =item Copy Constructor
8931
8932 B<Example>
8933
8934 =back
8935
8936 =item MAGIC AUTOGENERATION
8937
8938 I<Assignment forms of arithmetic operations>, I<Conversion operations>,
8939 I<Increment and decrement>, C<abs($a)>, I<Unary minus>, I<Negation>,
8940 I<Concatenation>, I<Comparison operations>, I<Iterator>, I<Dereferencing>,
8941 I<Copy operator>
8942
8943 =item Losing overloading
8944
8945 =item Run-time Overloading
8946
8947 =item Public functions
8948
8949 overload::StrVal(arg), overload::Overloaded(arg), overload::Method(obj,op)
8950
8951 =item Overloading constants
8952
8953 integer, float, binary, q, qr
8954
8955 =item IMPLEMENTATION
8956
8957 =item Metaphor clash
8958
8959 =item Cookbook
8960
8961 =over 4
8962
8963 =item Two-face scalars
8964
8965 =item Two-face references
8966
8967 =item Symbolic calculator
8968
8969 =item I<Really> symbolic calculator
8970
8971 =back
8972
8973 =item AUTHOR
8974
8975 =item DIAGNOSTICS
8976
8977 Odd number of arguments for overload::constant, `%s' is not an overloadable
8978 type, `%s' is not a code reference
8979
8980 =item BUGS
8981
8982 =back
8983
8984 =head2 re - Perl pragma to alter regular expression behaviour
8985
8986 =over 4
8987
8988 =item SYNOPSIS
8989
8990 =item DESCRIPTION
8991
8992 =back
8993
8994 =head2 sigtrap - Perl pragma to enable simple signal handling
8995
8996 =over 4
8997
8998 =item SYNOPSIS
8999
9000 =item DESCRIPTION
9001
9002 =item OPTIONS
9003
9004 =over 4
9005
9006 =item SIGNAL HANDLERS
9007
9008 B<stack-trace>, B<die>, B<handler> I<your-handler>
9009
9010 =item SIGNAL LISTS
9011
9012 B<normal-signals>, B<error-signals>, B<old-interface-signals>
9013
9014 =item OTHER
9015
9016 B<untrapped>, B<any>, I<signal>, I<number>
9017
9018 =back
9019
9020 =item EXAMPLES
9021
9022 =back
9023
9024 =head2 sort - perl pragma to control sort() behaviour
9025
9026 =over 4
9027
9028 =item SYNOPSIS
9029
9030 =item DESCRIPTION
9031
9032 =item CAVEATS
9033
9034 =back
9035
9036 =head2 strict - Perl pragma to restrict unsafe constructs
9037
9038 =over 4
9039
9040 =item SYNOPSIS
9041
9042 =item DESCRIPTION
9043
9044 C<strict refs>, C<strict vars>, C<strict subs>
9045
9046 =back
9047
9048 =head2 subs - Perl pragma to predeclare sub names
9049
9050 =over 4
9051
9052 =item SYNOPSIS
9053
9054 =item DESCRIPTION
9055
9056 =back
9057
9058 =head2 threads - Perl extension allowing use of interpreter based threads
9059 from perl
9060
9061 =over 4
9062
9063 =item SYNOPSIS
9064
9065 =item DESCRIPTION
9066
9067 $thread = threads->create(function, LIST), $thread->join, $thread->detach,
9068 threads->self, $thread->tid, threads->object( tid ), threads->yield();,
9069 threads->list();, async BLOCK;
9070
9071 =item WARNINGS
9072
9073 A thread exited while %d other threads were still running
9074
9075 =item TODO
9076
9077 =item BUGS
9078
9079 Parent-Child threads, Returning objects, Creating threads inside BEGIN
9080 blocks, PERL_OLD_SIGNALS are not threadsafe, will not be
9081
9082 =item AUTHOR and COPYRIGHT
9083
9084 =item SEE ALSO
9085
9086 =back
9087
9088 =head2 threadshared, threads::shared - Perl extension for sharing data
9089 structures between threads
9090
9091 =over 4
9092
9093 =item SYNOPSIS
9094
9095 =item DESCRIPTION
9096
9097 =item EXPORT
9098
9099 =item FUNCTIONS
9100
9101 share VARIABLE, lock VARIABLE, cond_wait VARIABLE, cond_signal VARIABLE,
9102 cond_broadcast VARIABLE
9103
9104 =item NOTES
9105
9106 =item BUGS
9107
9108 =item AUTHOR
9109
9110 =item SEE ALSO
9111
9112 =back
9113
9114 =head2 utf8 - Perl pragma to enable/disable UTF-8 (or UTF-EBCDIC) in source
9115 code
9116
9117 =over 4
9118
9119 =item SYNOPSIS
9120
9121 =item DESCRIPTION
9122
9123 =over 4
9124
9125 =item Utility functions
9126
9127 $num_octets = utf8::upgrade($string);, utf8::downgrade($string[, FAIL_OK]),
9128 utf8::encode($string), $flag = utf8::decode($string), $flag =
9129 utf8::valid(STRING)
9130
9131 =back
9132
9133 =item BUGS
9134
9135 =item SEE ALSO
9136
9137 =back
9138
9139 =head2 vars - Perl pragma to predeclare global variable names (obsolete)
9140
9141 =over 4
9142
9143 =item SYNOPSIS
9144
9145 =item DESCRIPTION
9146
9147 =back
9148
9149 =head2 vmsish - Perl pragma to control VMS-specific language features
9150
9151 =over 4
9152
9153 =item SYNOPSIS
9154
9155 =item DESCRIPTION
9156
9157 C<vmsish status>, C<vmsish exit>, C<vmsish time>, C<vmsish hushed>
9158
9159 =back
9160
9161 =head2 warnings - Perl pragma to control optional warnings
9162
9163 =over 4
9164
9165 =item SYNOPSIS
9166
9167 =item DESCRIPTION
9168
9169 use warnings::register, warnings::enabled(), warnings::enabled($category),
9170 warnings::enabled($object), warnings::warn($message),
9171 warnings::warn($category, $message), warnings::warn($object, $message),
9172 warnings::warnif($message), warnings::warnif($category, $message),
9173 warnings::warnif($object, $message)
9174
9175 =back
9176
9177 =head2 warnings::register - warnings import function
9178
9179 =over 4
9180
9181 =item SYNOPSIS
9182
9183 =item DESCRIPTION
9184
9185 =back
9186
9187 =head1 MODULE DOCUMENTATION
9188
9189 =head2 AnyDBM_File - provide framework for multiple DBMs
9190
9191 =over 4
9192
9193 =item SYNOPSIS
9194
9195 =item DESCRIPTION
9196
9197 =over 4
9198
9199 =item DBM Comparisons
9200
9201 [0], [1], [2], [3]
9202
9203 =back
9204
9205 =item SEE ALSO
9206
9207 =back
9208
9209 =head2 Attribute::Handlers - Simpler definition of attribute handlers
9210
9211 =over 4
9212
9213 =item VERSION
9214
9215 =item SYNOPSIS
9216
9217 =item DESCRIPTION
9218
9219 [0], [1], [2], [3], [4], [5]
9220
9221 =over 4
9222
9223 =item Typed lexicals
9224
9225 =item Type-specific attribute handlers
9226
9227 =item Non-interpretive attribute handlers
9228
9229 =item Phase-specific attribute handlers
9230
9231 =item Attributes as C<tie> interfaces
9232
9233 =back
9234
9235 =item EXAMPLES
9236
9237 =item DIAGNOSTICS
9238
9239 C<Bad attribute type: ATTR(%s)>, C<Attribute handler %s doesn't handle %s
9240 attributes>, C<Declaration of %s attribute in package %s may clash with
9241 future reserved word>, C<Can't have two ATTR specifiers on one subroutine>,
9242 C<Can't autotie a %s>, C<Internal error: %s symbol went missing>, C<Won't
9243 be able to apply END handler>
9244
9245 =item AUTHOR
9246
9247 =item BUGS
9248
9249 =item COPYRIGHT
9250
9251 =back
9252
9253 =head2 AutoLoader - load subroutines only on demand
9254
9255 =over 4
9256
9257 =item SYNOPSIS
9258
9259 =item DESCRIPTION
9260
9261 =over 4
9262
9263 =item Subroutine Stubs
9264
9265 =item Using B<AutoLoader>'s AUTOLOAD Subroutine
9266
9267 =item Overriding B<AutoLoader>'s AUTOLOAD Subroutine
9268
9269 =item Package Lexicals
9270
9271 =item Not Using AutoLoader
9272
9273 =item B<AutoLoader> vs. B<SelfLoader>
9274
9275 =back
9276
9277 =item CAVEATS
9278
9279 =item SEE ALSO
9280
9281 =back
9282
9283 =head2 AutoSplit - split a package for autoloading
9284
9285 =over 4
9286
9287 =item SYNOPSIS
9288
9289 =item DESCRIPTION
9290
9291 $keep, $check, $modtime
9292
9293 =over 4
9294
9295 =item Multiple packages
9296
9297 =back
9298
9299 =item DIAGNOSTICS
9300
9301 =back
9302
9303 =head2 B - The Perl Compiler
9304
9305 =over 4
9306
9307 =item SYNOPSIS
9308
9309 =item DESCRIPTION
9310
9311 =item OVERVIEW OF CLASSES
9312
9313 =over 4
9314
9315 =item SV-RELATED CLASSES
9316
9317 =item B::SV METHODS
9318
9319 REFCNT, FLAGS
9320
9321 =item B::IV METHODS
9322
9323 IV, IVX, UVX, int_value, needs64bits, packiv
9324
9325 =item B::NV METHODS
9326
9327 NV, NVX
9328
9329 =item B::RV METHODS
9330
9331 RV
9332
9333 =item B::PV METHODS
9334
9335 PV, RV, PVX
9336
9337 =item B::PVMG METHODS
9338
9339 MAGIC, SvSTASH
9340
9341 =item B::MAGIC METHODS
9342
9343 MOREMAGIC, precomp, PRIVATE, TYPE, FLAGS, OBJ, PTR, REGEX
9344
9345 =item B::PVLV METHODS
9346
9347 TARGOFF, TARGLEN, TYPE, TARG
9348
9349 =item B::BM METHODS
9350
9351 USEFUL, PREVIOUS, RARE, TABLE
9352
9353 =item B::GV METHODS
9354
9355 is_empty, NAME, SAFENAME, STASH, SV, IO, FORM, AV, HV, EGV, CV, CVGEN,
9356 LINE, FILE, FILEGV, GvREFCNT, FLAGS
9357
9358 =item B::IO METHODS
9359
9360 LINES, PAGE, PAGE_LEN, LINES_LEFT, TOP_NAME, TOP_GV, FMT_NAME, FMT_GV,
9361 BOTTOM_NAME, BOTTOM_GV, SUBPROCESS, IoTYPE, IoFLAGS, IsSTD
9362
9363 =item B::AV METHODS
9364
9365 FILL, MAX, OFF, ARRAY, AvFLAGS
9366
9367 =item B::CV METHODS
9368
9369 STASH, START, ROOT, GV, FILE, DEPTH, PADLIST, OUTSIDE, XSUB, XSUBANY,
9370 CvFLAGS, const_sv
9371
9372 =item B::HV METHODS
9373
9374 FILL, MAX, KEYS, RITER, NAME, PMROOT, ARRAY
9375
9376 =item OP-RELATED CLASSES
9377
9378 =item B::OP METHODS
9379
9380 next, sibling, name, ppaddr, desc, targ, type, seq, flags, private
9381
9382 =item B::UNOP METHOD
9383
9384 first
9385
9386 =item B::BINOP METHOD
9387
9388 last
9389
9390 =item B::LOGOP METHOD
9391
9392 other
9393
9394 =item B::LISTOP METHOD
9395
9396 children
9397
9398 =item B::PMOP METHODS
9399
9400 pmreplroot, pmreplstart, pmnext, pmregexp, pmflags, pmdynflags,
9401 pmpermflags, precomp, pmoffet
9402
9403 =item B::SVOP METHOD
9404
9405 sv, gv
9406
9407 =item B::PADOP METHOD
9408
9409 padix
9410
9411 =item B::PVOP METHOD
9412
9413 pv
9414
9415 =item B::LOOP METHODS
9416
9417 redoop, nextop, lastop
9418
9419 =item B::COP METHODS
9420
9421 label, stash, file, cop_seq, arybase, line
9422
9423 =back
9424
9425 =item FUNCTIONS EXPORTED BY C<B>
9426
9427 main_cv, init_av, begin_av, end_av, main_root, main_start, comppadlist,
9428 regex_padav, sv_undef, sv_yes, sv_no, amagic_generation, walkoptree(OP,
9429 METHOD), walkoptree_debug(DEBUG), walksymtable(SYMREF, METHOD, RECURSE,
9430 PREFIX), svref_2object(SV), ppname(OPNUM), hash(STR), cast_I32(I), minus_c,
9431 cstring(STR), perlstring(STR), class(OBJ), threadsv_names
9432
9433 =item AUTHOR
9434
9435 =back
9436
9437 =head2 B::Asmdata - Autogenerated data about Perl ops, used to generate
9438 bytecode
9439
9440 =over 4
9441
9442 =item SYNOPSIS
9443
9444 =item DESCRIPTION
9445
9446 %insn_data, @insn_name, @optype, @specialsv_name
9447
9448 =item AUTHOR
9449
9450 =back
9451
9452 =head2 B::Assembler - Assemble Perl bytecode
9453
9454 =over 4
9455
9456 =item SYNOPSIS
9457
9458 =item DESCRIPTION
9459
9460 =item AUTHORS
9461
9462 =back
9463
9464 =head2 B::Bblock - Walk basic blocks
9465
9466 =over 4
9467
9468 =item SYNOPSIS
9469
9470 =item DESCRIPTION
9471
9472 =over 4
9473
9474 =item Functions
9475
9476 B<find_leaders>
9477
9478 =back
9479
9480 =item AUTHOR
9481
9482 =back
9483
9484 =head2 B::Bytecode - Perl compiler's bytecode backend
9485
9486 =over 4
9487
9488 =item SYNOPSIS
9489
9490 =item DESCRIPTION
9491
9492 =item OPTIONS
9493
9494 B<-ofilename>, B<-afilename>, B<-->, B<-f>, B<-fcompress-nullops>,
9495 B<-fomit-sequence-numbers>, B<-fbypass-nullops>, B<-On>, B<-D>, B<-Do>,
9496 B<-Db>, B<-Da>, B<-DC>, B<-S>, B<-upackage>
9497
9498 =item EXAMPLES
9499
9500 =item BUGS
9501
9502 =item AUTHORS
9503
9504 =back
9505
9506 =head2 B::C - Perl compiler's C backend
9507
9508 =over 4
9509
9510 =item SYNOPSIS
9511
9512 =item DESCRIPTION
9513
9514 =item OPTIONS
9515
9516 B<-ofilename>, B<-v>, B<-->, B<-uPackname>, B<-D>, B<-Do>, B<-Dc>, B<-DA>,
9517 B<-DC>, B<-DM>, B<-f>, B<-fcog>, B<-fsave-data>, B<-fppaddr>, B<-fwarn-sv>,
9518 B<-fuse-script-name>, B<-fsave-sig-hash>, B<-On>, B<-O0>, B<-O1>, B<-O2>,
9519 B<-llimit>
9520
9521 =item EXAMPLES
9522
9523 =item BUGS
9524
9525 =item AUTHOR
9526
9527 =back
9528
9529 =head2 B::CC - Perl compiler's optimized C translation backend
9530
9531 =over 4
9532
9533 =item SYNOPSIS
9534
9535 =item DESCRIPTION
9536
9537 =item OPTIONS
9538
9539 B<-ofilename>, B<-v>, B<-->, B<-uPackname>, B<-mModulename>, B<-D>, B<-Dr>,
9540 B<-DO>, B<-Ds>, B<-Dp>, B<-Dq>, B<-Dl>, B<-Dt>, B<-f>,
9541 B<-ffreetmps-each-bblock>, B<-ffreetmps-each-loop>, B<-fomit-taint>, B<-On>
9542
9543 =item EXAMPLES
9544
9545 =item BUGS
9546
9547 =item DIFFERENCES
9548
9549 =over 4
9550
9551 =item Loops
9552
9553 =item Context of ".."
9554
9555 =item Arithmetic
9556
9557 =item Deprecated features
9558
9559 =back
9560
9561 =item AUTHOR
9562
9563 =back
9564
9565 =head2 B::Concise - Walk Perl syntax tree, printing concise info about ops
9566
9567 =over 4
9568
9569 =item SYNOPSIS
9570
9571 =item DESCRIPTION
9572
9573 =item EXAMPLE
9574
9575 =item OPTIONS
9576
9577 B<-basic>, B<-exec>, B<-tree>, B<-compact>, B<-loose>, B<-vt>, B<-ascii>,
9578 B<-main>, B<-base>I<n>, B<-bigendian>, B<-littleendian>, B<-concise>,
9579 B<-terse>, B<-linenoise>, B<-debug>, B<-env>
9580
9581 =item FORMATTING SPECIFICATIONS
9582
9583 B<(x(>I<exec_text>B<;>I<basic_text>B<)x)>, B<(*(>I<text>B<)*)>,
9584 B<(*(>I<text1>B<;>I<text2>B<)*)>, B<(?(>I<text1>B<#>I<var>I<Text2>B<)?)>,
9585 B<#>I<var>, B<#>I<var>I<N>, B<~>, B<#addr>, B<#arg>, B<#class>,
9586 B<#classsym>, B<#coplabel>, B<#exname>, B<#extarg>, B<#firstaddr>,
9587 B<#flags>, B<#flagval>, B<#hyphseq>, B<#label>, B<#lastaddr>, B<#name>,
9588 B<#NAME>, B<#next>, B<#nextaddr>, B<#noise>, B<#private>, B<#privval>,
9589 B<#seq>, B<#seqnum>, B<#sibaddr>, B<#svaddr>, B<#svclass>, B<#svval>,
9590 B<#targ>, B<#targarg>, B<#targarglife>, B<#typenum>
9591
9592 =item ABBREVIATIONS
9593
9594 =over 4
9595
9596 =item OP flags abbreviations
9597
9598 =item OP class abbreviations
9599
9600 =back
9601
9602 =item Using B::Concise outside of the O framework
9603
9604 =item AUTHOR
9605
9606 =back
9607
9608 =head2 B::Debug - Walk Perl syntax tree, printing debug info about ops
9609
9610 =over 4
9611
9612 =item SYNOPSIS
9613
9614 =item DESCRIPTION
9615
9616 =item AUTHOR
9617
9618 =back
9619
9620 =head2 B::Deparse - Perl compiler backend to produce perl code
9621
9622 =over 4
9623
9624 =item SYNOPSIS
9625
9626 =item DESCRIPTION
9627
9628 =item OPTIONS
9629
9630 B<-l>, B<-p>, B<-P>, B<-q>, B<-f>I<FILE>, B<-s>I<LETTERS>, B<C>,
9631 B<i>I<NUMBER>, B<T>, B<v>I<STRING>B<.>, B<-x>I<LEVEL>
9632
9633 =item USING B::Deparse AS A MODULE
9634
9635 =over 4
9636
9637 =item Synopsis
9638
9639 =item Description
9640
9641 =item new
9642
9643 =item ambient_pragmas
9644
9645 strict, $[, bytes, utf8, integer, re, warnings, hint_bits, warning_bits
9646
9647 =item coderef2text
9648
9649 =back
9650
9651 =item BUGS
9652
9653 =item AUTHOR
9654
9655 =back
9656
9657 =head2 B::Disassembler - Disassemble Perl bytecode
9658
9659 =over 4
9660
9661 =item SYNOPSIS
9662
9663 =item DESCRIPTION
9664
9665 =item AUTHOR
9666
9667 =back
9668
9669 =head2 B::Lint - Perl lint
9670
9671 =over 4
9672
9673 =item SYNOPSIS
9674
9675 =item DESCRIPTION
9676
9677 =item OPTIONS AND LINT CHECKS
9678
9679 B<context>, B<implicit-read> and B<implicit-write>, B<dollar-underscore>,
9680 B<private-names>, B<undefined-subs>, B<regexp-variables>, B<all>, B<none>
9681
9682 =item NON LINT-CHECK OPTIONS
9683
9684 B<-u Package>
9685
9686 =item BUGS
9687
9688 =item AUTHOR
9689
9690 =back
9691
9692 =head2 B::O, O - Generic interface to Perl Compiler backends
9693
9694 =over 4
9695
9696 =item SYNOPSIS
9697
9698 =item DESCRIPTION
9699
9700 =item CONVENTIONS
9701
9702 =item IMPLEMENTATION
9703
9704 =item BUGS
9705
9706 =item AUTHOR
9707
9708 =back
9709
9710 =head2 B::Showlex - Show lexical variables used in functions or files
9711
9712 =over 4
9713
9714 =item SYNOPSIS
9715
9716 =item DESCRIPTION
9717
9718 =item AUTHOR
9719
9720 =back
9721
9722 =head2 B::Stackobj - Helper module for CC backend
9723
9724 =over 4
9725
9726 =item SYNOPSIS
9727
9728 =item DESCRIPTION
9729
9730 =item AUTHOR
9731
9732 =back
9733
9734 =head2 B::Stash - show what stashes are loaded
9735
9736 =head2 B::Terse - Walk Perl syntax tree, printing terse info about ops
9737
9738 =over 4
9739
9740 =item SYNOPSIS
9741
9742 =item DESCRIPTION
9743
9744 =item AUTHOR
9745
9746 =back
9747
9748 =head2 B::Xref - Generates cross reference reports for Perl programs
9749
9750 =over 4
9751
9752 =item SYNOPSIS
9753
9754 =item DESCRIPTION
9755
9756 =item OPTIONS
9757
9758 C<-oFILENAME>, C<-r>, C<-d>, C<-D[tO]>
9759
9760 =item BUGS
9761
9762 =item AUTHOR
9763
9764 =back
9765
9766 =head2 Bblock, B::Bblock - Walk basic blocks
9767
9768 =over 4
9769
9770 =item SYNOPSIS
9771
9772 =item DESCRIPTION
9773
9774 =over 4
9775
9776 =item Functions
9777
9778 B<find_leaders>
9779
9780 =back
9781
9782 =item AUTHOR
9783
9784 =back
9785
9786 =head2 Benchmark - benchmark running times of Perl code
9787
9788 =over 4
9789
9790 =item SYNOPSIS
9791
9792 =item DESCRIPTION
9793
9794 =over 4
9795
9796 =item Methods
9797
9798 new, debug, iters
9799
9800 =item Standard Exports
9801
9802 timeit(COUNT, CODE), timethis ( COUNT, CODE, [ TITLE, [ STYLE ]] ),
9803 timethese ( COUNT, CODEHASHREF, [ STYLE ] ), timediff ( T1, T2 ), timestr (
9804 TIMEDIFF, [ STYLE, [ FORMAT ] ] )
9805
9806 =item Optional Exports
9807
9808 clearcache ( COUNT ), clearallcache ( ), cmpthese ( COUT, CODEHASHREF, [
9809 STYLE ] ), cmpthese ( RESULTSHASHREF, [ STYLE ] ), countit(TIME, CODE),
9810 disablecache ( ), enablecache ( ), timesum ( T1, T2 )
9811
9812 =back
9813
9814 =item NOTES
9815
9816 =item EXAMPLES
9817
9818 =item INHERITANCE
9819
9820 =item CAVEATS
9821
9822 =item SEE ALSO
9823
9824 =item AUTHORS
9825
9826 =item MODIFICATION HISTORY
9827
9828 =back
9829
9830 =head2 ByteLoader - load byte compiled perl code
9831
9832 =over 4
9833
9834 =item SYNOPSIS
9835
9836 =item DESCRIPTION
9837
9838 =item AUTHOR
9839
9840 =item SEE ALSO
9841
9842 =back
9843
9844 =head2 Bytecode, B::Bytecode - Perl compiler's bytecode backend
9845
9846 =over 4
9847
9848 =item SYNOPSIS
9849
9850 =item DESCRIPTION
9851
9852 =item OPTIONS
9853
9854 B<-ofilename>, B<-afilename>, B<-->, B<-f>, B<-fcompress-nullops>,
9855 B<-fomit-sequence-numbers>, B<-fbypass-nullops>, B<-On>, B<-D>, B<-Do>,
9856 B<-Db>, B<-Da>, B<-DC>, B<-S>, B<-upackage>
9857
9858 =item EXAMPLES
9859
9860 =item BUGS
9861
9862 =item AUTHORS
9863
9864 =back
9865
9866 =head2 CGI - Simple Common Gateway Interface Class
9867
9868 =over 4
9869
9870 =item SYNOPSIS
9871
9872 =item ABSTRACT
9873
9874 =item DESCRIPTION
9875
9876 =over 4
9877
9878 =item PROGRAMMING STYLE
9879
9880 =item CALLING CGI.PM ROUTINES
9881
9882 =item CREATING A NEW QUERY OBJECT (OBJECT-ORIENTED STYLE):
9883
9884 =item CREATING A NEW QUERY OBJECT FROM AN INPUT FILE
9885
9886 =item FETCHING A LIST OF KEYWORDS FROM THE QUERY:
9887
9888 =item FETCHING THE NAMES OF ALL THE PARAMETERS PASSED TO YOUR SCRIPT:
9889
9890 =item FETCHING THE VALUE OR VALUES OF A SINGLE NAMED PARAMETER:
9891
9892 =item SETTING THE VALUE(S) OF A NAMED PARAMETER:
9893
9894 =item APPENDING ADDITIONAL VALUES TO A NAMED PARAMETER:
9895
9896 =item IMPORTING ALL PARAMETERS INTO A NAMESPACE:
9897
9898 =item DELETING A PARAMETER COMPLETELY:
9899
9900 =item DELETING ALL PARAMETERS:
9901
9902 =item DIRECT ACCESS TO THE PARAMETER LIST:
9903
9904 =item FETCHING THE PARAMETER LIST AS A HASH:
9905
9906 =item SAVING THE STATE OF THE SCRIPT TO A FILE:
9907
9908 =item RETRIEVING CGI ERRORS
9909
9910 =item USING THE FUNCTION-ORIENTED INTERFACE
9911
9912 B<:cgi>, B<:form>, B<:html2>, B<:html3>, B<:html4>, B<:netscape>, B<:html>,
9913 B<:standard>, B<:all>
9914
9915 =item PRAGMAS
9916
9917 -any, -compile, -nosticky, -no_undef_params, -no_xhtml, -nph,
9918 -newstyle_urls, -oldstyle_urls, -autoload, -no_debug, -debug,
9919 -private_tempfiles
9920
9921 =item SPECIAL FORMS FOR IMPORTING HTML-TAG FUNCTIONS
9922
9923 1. start_table() (generates a <table> tag), 2. end_table() (generates a
9924 </table> tag), 3. start_ul() (generates a <ul> tag), 4. end_ul() (generates
9925 a </ul> tag)
9926
9927 =back
9928
9929 =item GENERATING DYNAMIC DOCUMENTS
9930
9931 =over 4
9932
9933 =item CREATING A STANDARD HTTP HEADER:
9934
9935 =item GENERATING A REDIRECTION HEADER
9936
9937 =item CREATING THE HTML DOCUMENT HEADER
9938
9939 B<Parameters:>, 4, 5, 6..
9940
9941 =item ENDING THE HTML DOCUMENT:
9942
9943 =item CREATING A SELF-REFERENCING URL THAT PRESERVES STATE INFORMATION:
9944
9945 =item OBTAINING THE SCRIPT'S URL
9946
9947 B<-absolute>, B<-relative>, B<-full>, B<-path> (B<-path_info>), B<-query>
9948 (B<-query_string>), B<-base>
9949
9950 =item MIXING POST AND URL PARAMETERS
9951
9952 =back
9953
9954 =item CREATING STANDARD HTML ELEMENTS:
9955
9956 =over 4
9957
9958 =item PROVIDING ARGUMENTS TO HTML SHORTCUTS
9959
9960 =item THE DISTRIBUTIVE PROPERTY OF HTML SHORTCUTS
9961
9962 =item HTML SHORTCUTS AND LIST INTERPOLATION
9963
9964 =item NON-STANDARD HTML SHORTCUTS
9965
9966 =item AUTOESCAPING HTML
9967
9968 $escaped_string = escapeHTML("unescaped string");, $charset =
9969 charset([$charset]);, $flag = autoEscape([$flag]);
9970
9971 =item PRETTY-PRINTING HTML
9972
9973 =back
9974
9975 =item CREATING FILL-OUT FORMS:
9976
9977 =over 4
9978
9979 =item CREATING AN ISINDEX TAG
9980
9981 =item STARTING AND ENDING A FORM
9982
9983 B<application/x-www-form-urlencoded>, B<multipart/form-data>
9984
9985 =item CREATING A TEXT FIELD
9986
9987 B<Parameters>
9988
9989 =item CREATING A BIG TEXT FIELD
9990
9991 =item CREATING A PASSWORD FIELD
9992
9993 =item CREATING A FILE UPLOAD FIELD
9994
9995 B<Parameters>
9996
9997 =item CREATING A POPUP MENU
9998
9999 =item CREATING A SCROLLING LIST
10000
10001 B<Parameters:>
10002
10003 =item CREATING A GROUP OF RELATED CHECKBOXES
10004
10005 B<Parameters:>
10006
10007 =item CREATING A STANDALONE CHECKBOX
10008
10009 B<Parameters:>
10010
10011 =item CREATING A RADIO BUTTON GROUP
10012
10013 B<Parameters:>
10014
10015 =item CREATING A SUBMIT BUTTON
10016
10017 B<Parameters:>
10018
10019 =item CREATING A RESET BUTTON
10020
10021 =item CREATING A DEFAULT BUTTON
10022
10023 =item CREATING A HIDDEN FIELD
10024
10025 B<Parameters:>
10026
10027 =item CREATING A CLICKABLE IMAGE BUTTON
10028
10029 B<Parameters:>
10030
10031 =item CREATING A JAVASCRIPT ACTION BUTTON
10032
10033 =back
10034
10035 =item HTTP COOKIES
10036
10037 1. an expiration time, 2. a domain, 3. a path, 4. a "secure" flag,
10038 B<-name>, B<-value>, B<-path>, B<-domain>, B<-expires>, B<-secure>
10039
10040 =item WORKING WITH FRAMES
10041
10042 1. Create a <Frameset> document, 2. Specify the destination for the
10043 document in the HTTP header, 3. Specify the destination for the document in
10044 the <form> tag
10045
10046 =item LIMITED SUPPORT FOR CASCADING STYLE SHEETS
10047
10048 =item DEBUGGING
10049
10050 =over 4
10051
10052 =item DUMPING OUT ALL THE NAME/VALUE PAIRS
10053
10054 =back
10055
10056 =item FETCHING ENVIRONMENT VARIABLES
10057
10058 B<Accept()>, B<raw_cookie()>, B<user_agent()>, B<path_info()>,
10059 B<path_translated()>, B<remote_host()>, B<script_name()>, B<referer()>,
10060 B<auth_type ()>, B<server_name ()>, B<virtual_host ()>, B<server_port ()>,
10061 B<server_software ()>, B<remote_user ()>, B<user_name ()>,
10062 B<request_method()>, B<content_type()>, B<http()>, B<https()>
10063
10064 =item USING NPH SCRIPTS
10065
10066 In the B<use> statement, By calling the B<nph()> method:, By using B<-nph>
10067 parameters
10068
10069 =item Server Push
10070
10071 multipart_init(), multipart_start(), multipart_end(), multipart_final()
10072
10073 =item Avoiding Denial of Service Attacks
10074
10075 B<$CGI::POST_MAX>, B<$CGI::DISABLE_UPLOADS>, B<1. On a script-by-script
10076 basis>, B<2. Globally for all scripts>
10077
10078 =item COMPATIBILITY WITH CGI-LIB.PL
10079
10080 =item AUTHOR INFORMATION
10081
10082 =item CREDITS
10083
10084 Matt Heffron (heffron@falstaff.css.beckman.com), James Taylor
10085 (james.taylor@srs.gov), Scott Anguish <sanguish@digifix.com>, Mike Jewell
10086 (mlj3u@virginia.edu), Timothy Shimmin (tes@kbs.citri.edu.au), Joergen Haegg
10087 (jh@axis.se), Laurent Delfosse (delfosse@delfosse.com), Richard Resnick
10088 (applepi1@aol.com), Craig Bishop (csb@barwonwater.vic.gov.au), Tony Curtis
10089 (tc@vcpc.univie.ac.at), Tim Bunce (Tim.Bunce@ig.co.uk), Tom Christiansen
10090 (tchrist@convex.com), Andreas Koenig (k@franz.ww.TU-Berlin.DE), Tim
10091 MacKenzie (Tim.MacKenzie@fulcrum.com.au), Kevin B. Hendricks
10092 (kbhend@dogwood.tyler.wm.edu), Stephen Dahmen (joyfire@inxpress.net), Ed
10093 Jordan (ed@fidalgo.net), David Alan Pisoni (david@cnation.com), Doug
10094 MacEachern (dougm@opengroup.org), Robin Houston (robin@oneworld.org),
10095 ...and many many more..
10096
10097 =item A COMPLETE EXAMPLE OF A SIMPLE FORM-BASED SCRIPT
10098
10099 =item BUGS
10100
10101 =item SEE ALSO
10102
10103 =back
10104
10105 =head2 CGI::Apache - Backward compatibility module for CGI.pm
10106
10107 =over 4
10108
10109 =item SYNOPSIS
10110
10111 =item ABSTRACT
10112
10113 =item DESCRIPTION
10114
10115 =item AUTHOR INFORMATION
10116
10117 =item BUGS
10118
10119 =item SEE ALSO
10120
10121 =back
10122
10123 =head2 CGI::Carp, B<CGI::Carp> - CGI routines for writing to the HTTPD (or
10124 other) error log
10125
10126 =over 4
10127
10128 =item SYNOPSIS
10129
10130 =item DESCRIPTION
10131
10132 =item REDIRECTING ERROR MESSAGES
10133
10134 =item MAKING PERL ERRORS APPEAR IN THE BROWSER WINDOW
10135
10136 =over 4
10137
10138 =item Changing the default message
10139
10140 =back
10141
10142 =item MAKING WARNINGS APPEAR AS HTML COMMENTS
10143
10144 =item CHANGE LOG
10145
10146 =item AUTHORS
10147
10148 =item SEE ALSO
10149
10150 =back
10151
10152 =head2 CGI::Cookie - Interface to Netscape Cookies
10153
10154 =over 4
10155
10156 =item SYNOPSIS
10157
10158 =item DESCRIPTION
10159
10160 =item USING CGI::Cookie
10161
10162 B<1. expiration date>, B<2. domain>, B<3. path>, B<4. secure flag>
10163
10164 =over 4
10165
10166 =item Creating New Cookies
10167
10168 =item Sending the Cookie to the Browser
10169
10170 =item Recovering Previous Cookies
10171
10172 =item Manipulating Cookies
10173
10174 B<name()>, B<value()>, B<domain()>, B<path()>, B<expires()>
10175
10176 =back
10177
10178 =item AUTHOR INFORMATION
10179
10180 =item BUGS
10181
10182 =item SEE ALSO
10183
10184 =back
10185
10186 =head2 CGI::Fast - CGI Interface for Fast CGI
10187
10188 =over 4
10189
10190 =item SYNOPSIS
10191
10192 =item DESCRIPTION
10193
10194 =item OTHER PIECES OF THE PUZZLE
10195
10196 =item WRITING FASTCGI PERL SCRIPTS
10197
10198 =item INSTALLING FASTCGI SCRIPTS
10199
10200 =item USING FASTCGI SCRIPTS AS CGI SCRIPTS
10201
10202 =item EXTERNAL FASTCGI SERVER INVOCATION
10203
10204 FCGI_SOCKET_PATH, FCGI_LISTEN_QUEUE
10205
10206 =item CAVEATS
10207
10208 =item AUTHOR INFORMATION
10209
10210 =item BUGS
10211
10212 =item SEE ALSO
10213
10214 =back
10215
10216 =head2 CGI::Pretty - module to produce nicely formatted HTML code
10217
10218 =over 4
10219
10220 =item SYNOPSIS
10221
10222 =item DESCRIPTION
10223
10224 =over 4
10225
10226 =item Tags that won't be formatted
10227
10228 =item Customizing the Indenting
10229
10230 =back
10231
10232 =item BUGS
10233
10234 =item AUTHOR
10235
10236 =item SEE ALSO
10237
10238 =back
10239
10240 =head2 CGI::Push - Simple Interface to Server Push
10241
10242 =over 4
10243
10244 =item SYNOPSIS
10245
10246 =item DESCRIPTION
10247
10248 =item USING CGI::Push
10249
10250 -next_page, -last_page, -type, -delay, -cookie, -target, -expires, -nph
10251
10252 =over 4
10253
10254 =item Heterogeneous Pages
10255
10256 =item Changing the Page Delay on the Fly
10257
10258 =back
10259
10260 =item INSTALLING CGI::Push SCRIPTS
10261
10262 =item AUTHOR INFORMATION
10263
10264 =item BUGS
10265
10266 =item SEE ALSO
10267
10268 =back
10269
10270 =head2 CGI::Switch - Backward compatibility module for defunct CGI::Switch
10271
10272 =over 4
10273
10274 =item SYNOPSIS
10275
10276 =item ABSTRACT
10277
10278 =item DESCRIPTION
10279
10280 =item AUTHOR INFORMATION
10281
10282 =item BUGS
10283
10284 =item SEE ALSO
10285
10286 =back
10287
10288 =head2 CGI::Util - Internal utilities used by CGI module
10289
10290 =over 4
10291
10292 =item SYNOPSIS
10293
10294 =item DESCRIPTION
10295
10296 =item AUTHOR INFORMATION
10297
10298 =item SEE ALSO
10299
10300 =back
10301
10302 =head2 CPAN - query, download and build perl modules from CPAN sites
10303
10304 =over 4
10305
10306 =item SYNOPSIS
10307
10308 =item DESCRIPTION
10309
10310 =over 4
10311
10312 =item Interactive Mode
10313
10314 Searching for authors, bundles, distribution files and modules, make, test,
10315 install, clean  modules or distributions, get, readme, look module or
10316 distribution, ls author, Signals
10317
10318 =item CPAN::Shell
10319
10320 =item autobundle
10321
10322 =item recompile
10323
10324 =item The four C<CPAN::*> Classes: Author, Bundle, Module, Distribution
10325
10326 =item Programmer's interface
10327
10328 expand($type,@things), expandany(@things), Programming Examples
10329
10330 =item Methods in the other Classes
10331
10332 CPAN::Author::as_glimpse(), CPAN::Author::as_string(),
10333 CPAN::Author::email(), CPAN::Author::fullname(), CPAN::Author::name(),
10334 CPAN::Bundle::as_glimpse(), CPAN::Bundle::as_string(),
10335 CPAN::Bundle::clean(), CPAN::Bundle::contains(),
10336 CPAN::Bundle::force($method,@args), CPAN::Bundle::get(),
10337 CPAN::Bundle::inst_file(), CPAN::Bundle::inst_version(),
10338 CPAN::Bundle::uptodate(), CPAN::Bundle::install(), CPAN::Bundle::make(),
10339 CPAN::Bundle::readme(), CPAN::Bundle::test(),
10340 CPAN::Distribution::as_glimpse(), CPAN::Distribution::as_string(),
10341 CPAN::Distribution::clean(), CPAN::Distribution::containsmods(),
10342 CPAN::Distribution::cvs_import(), CPAN::Distribution::dir(),
10343 CPAN::Distribution::force($method,@args), CPAN::Distribution::get(),
10344 CPAN::Distribution::install(), CPAN::Distribution::isa_perl(),
10345 CPAN::Distribution::look(), CPAN::Distribution::make(),
10346 CPAN::Distribution::prereq_pm(), CPAN::Distribution::readme(),
10347 CPAN::Distribution::test(), CPAN::Distribution::uptodate(),
10348 CPAN::Index::force_reload(), CPAN::Index::reload(), CPAN::InfoObj::dump(),
10349 CPAN::Module::as_glimpse(), CPAN::Module::as_string(),
10350 CPAN::Module::clean(), CPAN::Module::cpan_file(),
10351 CPAN::Module::cpan_version(), CPAN::Module::cvs_import(),
10352 CPAN::Module::description(), CPAN::Module::force($method,@args),
10353 CPAN::Module::get(), CPAN::Module::inst_file(),
10354 CPAN::Module::inst_version(), CPAN::Module::install(),
10355 CPAN::Module::look(), CPAN::Module::make(),
10356 CPAN::Module::manpage_headline(), CPAN::Module::readme(),
10357 CPAN::Module::test(), CPAN::Module::uptodate(), CPAN::Module::userid()
10358
10359 =item Cache Manager
10360
10361 =item Bundles
10362
10363 =item Prerequisites
10364
10365 =item Finding packages and VERSION
10366
10367 =item Debugging
10368
10369 =item Floppy, Zip, Offline Mode
10370
10371 =back
10372
10373 =item CONFIGURATION
10374
10375 C<o conf E<lt>scalar optionE<gt>>, C<o conf E<lt>scalar optionE<gt>
10376 E<lt>valueE<gt>>, C<o conf E<lt>list optionE<gt>>, C<o conf E<lt>list
10377 optionE<gt> [shift|pop]>, C<o conf E<lt>list optionE<gt>
10378 [unshift|push|splice] E<lt>listE<gt>>
10379
10380 =over 4
10381
10382 =item Note on urllist parameter's format
10383
10384 =item urllist parameter has CD-ROM support
10385
10386 =back
10387
10388 =item SECURITY
10389
10390 =item EXPORT
10391
10392 =item POPULATE AN INSTALLATION WITH LOTS OF MODULES
10393
10394 =item WORKING WITH CPAN.pm BEHIND FIREWALLS
10395
10396 =over 4
10397
10398 =item Three basic types of firewalls
10399
10400 http firewall, ftp firewall, One way visibility, SOCKS, IP Masquerade
10401
10402 =item Configuring lynx or ncftp for going through a firewall
10403
10404 =back
10405
10406 =item FAQ
10407
10408 1), 2), 3), 4), 5), 6), 7), 8), 9), 10)
10409
10410 =item BUGS
10411
10412 =item AUTHOR
10413
10414 =item TRANSLATIONS
10415
10416 =item SEE ALSO
10417
10418 =back
10419
10420 =head2 CPAN::FirstTime - Utility for CPAN::Config file Initialization
10421
10422 =over 4
10423
10424 =item SYNOPSIS
10425
10426 =item DESCRIPTION
10427
10428 =back
10429
10430 =head2 CPANox, CPAN::Nox - Wrapper around CPAN.pm without using any XS
10431 module
10432
10433 =over 4
10434
10435 =item SYNOPSIS
10436
10437 =item DESCRIPTION
10438
10439 =item  SEE ALSO
10440
10441 =back
10442
10443 =head2 Carp, carp    - warn of errors (from perspective of caller)
10444
10445 =over 4
10446
10447 =item SYNOPSIS
10448
10449 =item DESCRIPTION
10450
10451 =over 4
10452
10453 =item Forcing a Stack Trace
10454
10455 =back
10456
10457 =item BUGS
10458
10459 =back
10460
10461 =head2 Carp::Heavy, Carp heavy machinery - no user serviceable parts inside
10462
10463 =head2 Class::ISA -- report the search path for a class's ISA tree
10464
10465 =over 4
10466
10467 =item SYNOPSIS
10468
10469 =item DESCRIPTION
10470
10471 =item FUNCTIONS
10472
10473 the function Class::ISA::super_path($CLASS), the function
10474 Class::ISA::self_and_super_path($CLASS), the function
10475 Class::ISA::self_and_super_versions($CLASS)
10476
10477 =item CAUTIONARY NOTES
10478
10479 =item COPYRIGHT
10480
10481 =item AUTHOR
10482
10483 =back
10484
10485 =head2 Class::Struct - declare struct-like datatypes as Perl classes
10486
10487 =over 4
10488
10489 =item SYNOPSIS
10490
10491 =item DESCRIPTION
10492
10493 =over 4
10494
10495 =item The C<struct()> function
10496
10497 =item Class Creation at Compile Time
10498
10499 =item Element Types and Accessor Methods
10500
10501 Scalar (C<'$'> or C<'*$'>), Array (C<'@'> or C<'*@'>), Hash (C<'%'> or
10502 C<'*%'>), Class (C<'Class_Name'> or C<'*Class_Name'>)
10503
10504 =item Initializing with C<new>
10505
10506 =back
10507
10508 =item EXAMPLES
10509
10510 Example 1, Example 2, Example 3
10511
10512 =item Author and Modification History
10513
10514 =back
10515
10516 =head2 Config - access Perl configuration information
10517
10518 =over 4
10519
10520 =item SYNOPSIS
10521
10522 =item DESCRIPTION
10523
10524 myconfig(), config_sh(), config_vars(@names)
10525
10526 =item EXAMPLE
10527
10528 =item WARNING
10529
10530 =item GLOSSARY
10531
10532 =over 4
10533
10534 =item _
10535
10536 C<_a>, C<_exe>, C<_o>
10537
10538 =item a
10539
10540 C<afs>, C<afsroot>, C<alignbytes>, C<ansi2knr>, C<aphostname>,
10541 C<api_revision>, C<api_subversion>, C<api_version>, C<api_versionstring>,
10542 C<ar>, C<archlib>, C<archlibexp>, C<archname64>, C<archname>, C<archobjs>,
10543 C<asctime_r_proto>, C<awk>
10544
10545 =item b
10546
10547 C<baserev>, C<bash>, C<bin>, C<binexp>, C<bison>, C<byacc>, C<byteorder>
10548
10549 =item c
10550
10551 C<c>, C<castflags>, C<cat>, C<cc>, C<cccdlflags>, C<ccdlflags>, C<ccflags>,
10552 C<ccflags_uselargefiles>, C<ccname>, C<ccsymbols>, C<ccversion>, C<cf_by>,
10553 C<cf_email>, C<cf_time>, C<charsize>, C<chgrp>, C<chmod>, C<chown>,
10554 C<clocktype>, C<comm>, C<compress>, C<contains>, C<cp>, C<cpio>, C<cpp>,
10555 C<cpp_stuff>, C<cppccsymbols>, C<cppflags>, C<cpplast>, C<cppminus>,
10556 C<cpprun>, C<cppstdin>, C<cppsymbols>, C<crypt_r_proto>, C<cryptlib>,
10557 C<csh>, C<ctermid_r_proto>, C<ctime_r_proto>
10558
10559 =item d
10560
10561 C<d__fwalk>, C<d_access>, C<d_accessx>, C<d_alarm>, C<d_archlib>,
10562 C<d_asctime_r>, C<d_atolf>, C<d_atoll>, C<d_attribut>, C<d_bcmp>,
10563 C<d_bcopy>, C<d_bsd>, C<d_bsdgetpgrp>, C<d_bsdsetpgrp>, C<d_bzero>,
10564 C<d_casti32>, C<d_castneg>, C<d_charvspr>, C<d_chown>, C<d_chroot>,
10565 C<d_chsize>, C<d_class>, C<d_closedir>, C<d_cmsghdr_s>, C<d_const>,
10566 C<d_crypt>, C<d_crypt_r>, C<d_csh>, C<d_ctermid_r>, C<d_ctime_r>,
10567 C<d_cuserid>, C<d_dbl_dig>, C<d_dbminitproto>, C<d_difftime>, C<d_dirfd>,
10568 C<d_dirnamlen>, C<d_dlerror>, C<d_dlopen>, C<d_dlsymun>, C<d_dosuid>,
10569 C<d_drand48_r>, C<d_drand48proto>, C<d_dup2>, C<d_eaccess>, C<d_endgrent>,
10570 C<d_endgrent_r>, C<d_endhent>, C<d_endhostent_r>, C<d_endnent>,
10571 C<d_endnetent_r>, C<d_endpent>, C<d_endprotoent_r>, C<d_endpwent>,
10572 C<d_endpwent_r>, C<d_endsent>, C<d_endservent_r>, C<d_eofnblk>,
10573 C<d_eunice>, C<d_fchdir>, C<d_fchmod>, C<d_fchown>, C<d_fcntl>,
10574 C<d_fcntl_can_lock>, C<d_fd_macros>, C<d_fd_set>, C<d_fds_bits>,
10575 C<d_fgetpos>, C<d_finite>, C<d_finitel>, C<d_flexfnam>, C<d_flock>,
10576 C<d_flockproto>, C<d_fork>, C<d_fp_class>, C<d_fpathconf>, C<d_fpclass>,
10577 C<d_fpclassify>, C<d_fpclassl>, C<d_fpos64_t>, C<d_frexpl>, C<d_fs_data_s>,
10578 C<d_fseeko>, C<d_fsetpos>, C<d_fstatfs>, C<d_fstatvfs>, C<d_fsync>,
10579 C<d_ftello>, C<d_ftime>, C<d_Gconvert>, C<d_getcwd>, C<d_getespwnam>,
10580 C<d_getfsstat>, C<d_getgrent>, C<d_getgrent_r>, C<d_getgrgid_r>,
10581 C<d_getgrnam_r>, C<d_getgrps>, C<d_gethbyaddr>, C<d_gethbyname>,
10582 C<d_gethent>, C<d_gethname>, C<d_gethostbyaddr_r>, C<d_gethostbyname_r>,
10583 C<d_gethostent_r>, C<d_gethostprotos>, C<d_getitimer>, C<d_getlogin>,
10584 C<d_getlogin_r>, C<d_getmnt>, C<d_getmntent>, C<d_getnbyaddr>,
10585 C<d_getnbyname>, C<d_getnent>, C<d_getnetbyaddr_r>, C<d_getnetbyname_r>,
10586 C<d_getnetent_r>, C<d_getnetprotos>, C<d_getpagsz>, C<d_getpbyname>,
10587 C<d_getpbynumber>, C<d_getpent>, C<d_getpgid>, C<d_getpgrp2>, C<d_getpgrp>,
10588 C<d_getppid>, C<d_getprior>, C<d_getprotobyname_r>,
10589 C<d_getprotobynumber_r>, C<d_getprotoent_r>, C<d_getprotoprotos>,
10590 C<d_getprpwnam>, C<d_getpwent>, C<d_getpwent_r>, C<d_getpwnam_r>,
10591 C<d_getpwuid_r>, C<d_getsbyname>, C<d_getsbyport>, C<d_getsent>,
10592 C<d_getservbyname_r>, C<d_getservbyport_r>, C<d_getservent_r>,
10593 C<d_getservprotos>, C<d_getspnam>, C<d_getspnam_r>, C<d_gettimeod>,
10594 C<d_gmtime_r>, C<d_gnulibc>, C<d_grpasswd>, C<d_hasmntopt>, C<d_htonl>,
10595 C<d_index>, C<d_inetaton>, C<d_int64_t>, C<d_isascii>, C<d_isfinite>,
10596 C<d_isinf>, C<d_isnan>, C<d_isnanl>, C<d_killpg>, C<d_lchown>,
10597 C<d_ldbl_dig>, C<d_link>, C<d_localtime_r>, C<d_locconv>, C<d_lockf>,
10598 C<d_longdbl>, C<d_longlong>, C<d_lseekproto>, C<d_lstat>, C<d_madvise>,
10599 C<d_mblen>, C<d_mbstowcs>, C<d_mbtowc>, C<d_memchr>, C<d_memcmp>,
10600 C<d_memcpy>, C<d_memmove>, C<d_memset>, C<d_mkdir>, C<d_mkdtemp>,
10601 C<d_mkfifo>, C<d_mkstemp>, C<d_mkstemps>, C<d_mktime>, C<d_mmap>,
10602 C<d_modfl>, C<d_modfl_pow32_bug>, C<d_mprotect>, C<d_msg>, C<d_msg_ctrunc>,
10603 C<d_msg_dontroute>, C<d_msg_oob>, C<d_msg_peek>, C<d_msg_proxy>,
10604 C<d_msgctl>, C<d_msgget>, C<d_msghdr_s>, C<d_msgrcv>, C<d_msgsnd>,
10605 C<d_msync>, C<d_munmap>, C<d_mymalloc>, C<d_nice>, C<d_nl_langinfo>,
10606 C<d_nv_preserves_uv>, C<d_off64_t>, C<d_old_pthread_create_joinable>,
10607 C<d_oldpthreads>, C<d_oldsock>, C<d_open3>, C<d_pathconf>, C<d_pause>,
10608 C<d_perl_otherlibdirs>, C<d_phostname>, C<d_pipe>, C<d_poll>,
10609 C<d_portable>, C<d_PRId64>, C<d_PRIeldbl>, C<d_PRIEUldbl>, C<d_PRIfldbl>,
10610 C<d_PRIFUldbl>, C<d_PRIgldbl>, C<d_PRIGUldbl>, C<d_PRIi64>, C<d_PRIo64>,
10611 C<d_PRIu64>, C<d_PRIx64>, C<d_PRIXU64>, C<d_procselfexe>,
10612 C<d_pthread_atfork>, C<d_pthread_yield>, C<d_pwage>, C<d_pwchange>,
10613 C<d_pwclass>, C<d_pwcomment>, C<d_pwexpire>, C<d_pwgecos>, C<d_pwpasswd>,
10614 C<d_pwquota>, C<d_qgcvt>, C<d_quad>, C<d_random_r>, C<d_readdir64_r>,
10615 C<d_readdir>, C<d_readdir_r>, C<d_readlink>, C<d_readv>, C<d_recvmsg>,
10616 C<d_rename>, C<d_rewinddir>, C<d_rmdir>, C<d_safebcpy>, C<d_safemcpy>,
10617 C<d_sanemcmp>, C<d_sbrkproto>, C<d_sched_yield>, C<d_scm_rights>,
10618 C<d_SCNfldbl>, C<d_seekdir>, C<d_select>, C<d_sem>, C<d_semctl>,
10619 C<d_semctl_semid_ds>, C<d_semctl_semun>, C<d_semget>, C<d_semop>,
10620 C<d_sendmsg>, C<d_setegid>, C<d_seteuid>, C<d_setgrent>, C<d_setgrent_r>,
10621 C<d_setgrps>, C<d_sethent>, C<d_sethostent_r>, C<d_setitimer>,
10622 C<d_setlinebuf>, C<d_setlocale>, C<d_setlocale_r>, C<d_setnent>,
10623 C<d_setnetent_r>, C<d_setpent>, C<d_setpgid>, C<d_setpgrp2>, C<d_setpgrp>,
10624 C<d_setprior>, C<d_setproctitle>, C<d_setprotoent_r>, C<d_setpwent>,
10625 C<d_setpwent_r>, C<d_setregid>, C<d_setresgid>, C<d_setresuid>,
10626 C<d_setreuid>, C<d_setrgid>, C<d_setruid>, C<d_setsent>, C<d_setservent_r>,
10627 C<d_setsid>, C<d_setvbuf>, C<d_sfio>, C<d_shm>, C<d_shmat>,
10628 C<d_shmatprototype>, C<d_shmctl>, C<d_shmdt>, C<d_shmget>, C<d_sigaction>,
10629 C<d_sigprocmask>, C<d_sigsetjmp>, C<d_sockatmark>, C<d_sockatmarkproto>,
10630 C<d_socket>, C<d_socklen_t>, C<d_sockpair>, C<d_socks5_init>, C<d_sqrtl>,
10631 C<d_srand48_r>, C<d_srandom_r>, C<d_sresgproto>, C<d_sresuproto>,
10632 C<d_statblks>, C<d_statfs_f_flags>, C<d_statfs_s>, C<d_statvfs>,
10633 C<d_stdio_cnt_lval>, C<d_stdio_ptr_lval>, C<d_stdio_ptr_lval_nochange_cnt>,
10634 C<d_stdio_ptr_lval_sets_cnt>, C<d_stdio_stream_array>, C<d_stdiobase>,
10635 C<d_stdstdio>, C<d_strchr>, C<d_strcoll>, C<d_strctcpy>, C<d_strerrm>,
10636 C<d_strerror>, C<d_strerror_r>, C<d_strftime>, C<d_strtod>, C<d_strtol>,
10637 C<d_strtold>, C<d_strtoll>, C<d_strtoq>, C<d_strtoul>, C<d_strtoull>,
10638 C<d_strtouq>, C<d_strxfrm>, C<d_suidsafe>, C<d_symlink>, C<d_syscall>,
10639 C<d_syscallproto>, C<d_sysconf>, C<d_sysernlst>, C<d_syserrlst>,
10640 C<d_system>, C<d_tcgetpgrp>, C<d_tcsetpgrp>, C<d_telldir>,
10641 C<d_telldirproto>, C<d_time>, C<d_times>, C<d_tm_tm_gmtoff>,
10642 C<d_tm_tm_zone>, C<d_tmpnam_r>, C<d_truncate>, C<d_ttyname_r>, C<d_tzname>,
10643 C<d_u32align>, C<d_ualarm>, C<d_umask>, C<d_uname>, C<d_union_semun>,
10644 C<d_unordered>, C<d_usleep>, C<d_usleepproto>, C<d_ustat>, C<d_vendorarch>,
10645 C<d_vendorbin>, C<d_vendorlib>, C<d_vfork>, C<d_void_closedir>,
10646 C<d_voidsig>, C<d_voidtty>, C<d_volatile>, C<d_vprintf>, C<d_wait4>,
10647 C<d_waitpid>, C<d_wcstombs>, C<d_wctomb>, C<d_writev>, C<d_xenix>, C<date>,
10648 C<db_hashtype>, C<db_prefixtype>, C<db_version_major>, C<db_version_minor>,
10649 C<db_version_patch>, C<defvoidused>, C<direntrytype>, C<dlext>, C<dlsrc>,
10650 C<doublesize>, C<drand01>, C<drand48_r_proto>, C<dynamic_ext>
10651
10652 =item e
10653
10654 C<eagain>, C<ebcdic>, C<echo>, C<egrep>, C<emacs>, C<endgrent_r_proto>,
10655 C<endhostent_r_proto>, C<endnetent_r_proto>, C<endprotoent_r_proto>,
10656 C<endpwent_r_proto>, C<endservent_r_proto>, C<eunicefix>, C<exe_ext>,
10657 C<expr>, C<extensions>, C<extras>
10658
10659 =item f
10660
10661 C<fflushall>, C<fflushNULL>, C<find>, C<firstmakefile>, C<flex>,
10662 C<fpossize>, C<fpostype>, C<freetype>, C<from>, C<full_ar>, C<full_csh>,
10663 C<full_sed>
10664
10665 =item g
10666
10667 C<gccosandvers>, C<gccversion>, C<getgrent_r_proto>, C<getgrgid_r_proto>,
10668 C<getgrnam_r_proto>, C<gethostbyaddr_r_proto>, C<gethostbyname_r_proto>,
10669 C<gethostent_r_proto>, C<getlogin_r_proto>, C<getnetbyaddr_r_proto>,
10670 C<getnetbyname_r_proto>, C<getnetent_r_proto>, C<getprotobyname_r_proto>,
10671 C<getprotobynumber_r_proto>, C<getprotoent_r_proto>, C<getpwent_r_proto>,
10672 C<getpwnam_r_proto>, C<getpwuid_r_proto>, C<getservbyname_r_proto>,
10673 C<getservbyport_r_proto>, C<getservent_r_proto>, C<getspnam_r_proto>,
10674 C<gidformat>, C<gidsign>, C<gidsize>, C<gidtype>, C<glibpth>, C<gmake>,
10675 C<gmtime_r_proto>, C<gnulibc_version>, C<grep>, C<groupcat>, C<groupstype>,
10676 C<gzip>
10677
10678 =item h
10679
10680 C<h_fcntl>, C<h_sysfile>, C<hint>, C<hostcat>
10681
10682 =item i
10683
10684 C<i16size>, C<i16type>, C<i32size>, C<i32type>, C<i64size>, C<i64type>,
10685 C<i8size>, C<i8type>, C<i_arpainet>, C<i_bsdioctl>, C<i_crypt>, C<i_db>,
10686 C<i_dbm>, C<i_dirent>, C<i_dld>, C<i_dlfcn>, C<i_fcntl>, C<i_float>,
10687 C<i_fp>, C<i_fp_class>, C<i_gdbm>, C<i_grp>, C<i_ieeefp>, C<i_inttypes>,
10688 C<i_langinfo>, C<i_libutil>, C<i_limits>, C<i_locale>, C<i_machcthr>,
10689 C<i_malloc>, C<i_math>, C<i_memory>, C<i_mntent>, C<i_ndbm>, C<i_netdb>,
10690 C<i_neterrno>, C<i_netinettcp>, C<i_niin>, C<i_poll>, C<i_prot>,
10691 C<i_pthread>, C<i_pwd>, C<i_rpcsvcdbm>, C<i_sfio>, C<i_sgtty>, C<i_shadow>,
10692 C<i_socks>, C<i_stdarg>, C<i_stddef>, C<i_stdlib>, C<i_string>,
10693 C<i_sunmath>, C<i_sysaccess>, C<i_sysdir>, C<i_sysfile>, C<i_sysfilio>,
10694 C<i_sysin>, C<i_sysioctl>, C<i_syslog>, C<i_sysmman>, C<i_sysmode>,
10695 C<i_sysmount>, C<i_sysndir>, C<i_sysparam>, C<i_sysresrc>, C<i_syssecrt>,
10696 C<i_sysselct>, C<i_syssockio>, C<i_sysstat>, C<i_sysstatfs>,
10697 C<i_sysstatvfs>, C<i_systime>, C<i_systimek>, C<i_systimes>, C<i_systypes>,
10698 C<i_sysuio>, C<i_sysun>, C<i_sysutsname>, C<i_sysvfs>, C<i_syswait>,
10699 C<i_termio>, C<i_termios>, C<i_time>, C<i_unistd>, C<i_ustat>, C<i_utime>,
10700 C<i_values>, C<i_varargs>, C<i_varhdr>, C<i_vfork>,
10701 C<ignore_versioned_solibs>, C<inc_version_list>, C<inc_version_list_init>,
10702 C<incpath>, C<inews>, C<installarchlib>, C<installbin>, C<installman1dir>,
10703 C<installman3dir>, C<installprefix>, C<installprefixexp>,
10704 C<installprivlib>, C<installscript>, C<installsitearch>, C<installsitebin>,
10705 C<installsitelib>, C<installstyle>, C<installusrbinperl>,
10706 C<installvendorarch>, C<installvendorbin>, C<installvendorlib>, C<intsize>,
10707 C<issymlink>, C<ivdformat>, C<ivsize>, C<ivtype>
10708
10709 =item k
10710
10711 C<known_extensions>, C<ksh>
10712
10713 =item l
10714
10715 C<ld>, C<lddlflags>, C<ldflags>, C<ldflags_uselargefiles>, C<ldlibpthname>,
10716 C<less>, C<lib_ext>, C<libc>, C<libperl>, C<libpth>, C<libs>, C<libsdirs>,
10717 C<libsfiles>, C<libsfound>, C<libspath>, C<libswanted>,
10718 C<libswanted_uselargefiles>, C<line>, C<lint>, C<lkflags>, C<ln>, C<lns>,
10719 C<localtime_r_proto>, C<locincpth>, C<loclibpth>, C<longdblsize>,
10720 C<longlongsize>, C<longsize>, C<lp>, C<lpr>, C<ls>, C<lseeksize>,
10721 C<lseektype>
10722
10723 =item m
10724
10725 C<mail>, C<mailx>, C<make>, C<make_set_make>, C<mallocobj>, C<mallocsrc>,
10726 C<malloctype>, C<man1dir>, C<man1direxp>, C<man1ext>, C<man3dir>,
10727 C<man3direxp>, C<man3ext>
10728
10729 =item M
10730
10731 C<Mcc>, C<mips_type>, C<mkdir>, C<mmaptype>, C<modetype>, C<more>,
10732 C<multiarch>, C<mv>, C<myarchname>, C<mydomain>, C<myhostname>, C<myuname>
10733
10734 =item n
10735
10736 C<n>, C<need_va_copy>, C<netdb_hlen_type>, C<netdb_host_type>,
10737 C<netdb_name_type>, C<netdb_net_type>, C<nm>, C<nm_opt>, C<nm_so_opt>,
10738 C<nonxs_ext>, C<nroff>, C<nv_preserves_uv_bits>, C<nveformat>,
10739 C<nvEUformat>, C<nvfformat>, C<nvFUformat>, C<nvgformat>, C<nvGUformat>,
10740 C<nvsize>, C<nvtype>
10741
10742 =item o
10743
10744 C<o_nonblock>, C<obj_ext>, C<old_pthread_create_joinable>, C<optimize>,
10745 C<orderlib>, C<osname>, C<osvers>, C<otherlibdirs>
10746
10747 =item p
10748
10749 C<package>, C<pager>, C<passcat>, C<patchlevel>, C<path_sep>, C<perl5>,
10750 C<perl>, C<perl_patchlevel>
10751
10752 =item P
10753
10754 C<PERL_REVISION>, C<PERL_SUBVERSION>, C<PERL_VERSION>, C<perladmin>,
10755 C<perllibs>, C<perlpath>, C<pg>, C<phostname>, C<pidtype>, C<plibpth>,
10756 C<pm_apiversion>, C<pmake>, C<pr>, C<prefix>, C<prefixexp>, C<privlib>,
10757 C<privlibexp>, C<procselfexe>, C<prototype>, C<ptrsize>
10758
10759 =item q
10760
10761 C<quadkind>, C<quadtype>
10762
10763 =item r
10764
10765 C<randbits>, C<randfunc>, C<random_r_proto>, C<randseedtype>, C<ranlib>,
10766 C<rd_nodata>, C<readdir64_r_proto>, C<readdir_r_proto>, C<revision>, C<rm>,
10767 C<rmail>, C<run>, C<runnm>
10768
10769 =item s
10770
10771 C<sched_yield>, C<scriptdir>, C<scriptdirexp>, C<sed>, C<seedfunc>,
10772 C<selectminbits>, C<selecttype>, C<sendmail>, C<setgrent_r_proto>,
10773 C<sethostent_r_proto>, C<setlocale_r_proto>, C<setnetent_r_proto>,
10774 C<setprotoent_r_proto>, C<setpwent_r_proto>, C<setservent_r_proto>, C<sh>,
10775 C<shar>, C<sharpbang>, C<shmattype>, C<shortsize>, C<shrpenv>, C<shsharp>,
10776 C<sig_count>, C<sig_name>, C<sig_name_init>, C<sig_num>, C<sig_num_init>,
10777 C<sig_size>, C<signal_t>, C<sitearch>, C<sitearchexp>, C<sitebin>,
10778 C<sitebinexp>, C<sitelib>, C<sitelib_stem>, C<sitelibexp>, C<siteprefix>,
10779 C<siteprefixexp>, C<sizesize>, C<sizetype>, C<sleep>, C<smail>, C<so>,
10780 C<sockethdr>, C<socketlib>, C<socksizetype>, C<sort>, C<spackage>,
10781 C<spitshell>, C<sPRId64>, C<sPRIeldbl>, C<sPRIEUldbl>, C<sPRIfldbl>,
10782 C<sPRIFUldbl>, C<sPRIgldbl>, C<sPRIGUldbl>, C<sPRIi64>, C<sPRIo64>,
10783 C<sPRIu64>, C<sPRIx64>, C<sPRIXU64>, C<srand48_r_proto>,
10784 C<srandom_r_proto>, C<src>, C<sSCNfldbl>, C<ssizetype>, C<startperl>,
10785 C<startsh>, C<static_ext>, C<stdchar>, C<stdio_base>, C<stdio_bufsiz>,
10786 C<stdio_cnt>, C<stdio_filbuf>, C<stdio_ptr>, C<stdio_stream_array>,
10787 C<strerror_r_proto>, C<strings>, C<submit>, C<subversion>, C<sysman>
10788
10789 =item t
10790
10791 C<tail>, C<tar>, C<targetarch>, C<tbl>, C<tee>, C<test>, C<timeincl>,
10792 C<timetype>, C<tmpnam_r_proto>, C<to>, C<touch>, C<tr>, C<trnl>, C<troff>,
10793 C<ttyname_r_proto>
10794
10795 =item u
10796
10797 C<u16size>, C<u16type>, C<u32size>, C<u32type>, C<u64size>, C<u64type>,
10798 C<u8size>, C<u8type>, C<uidformat>, C<uidsign>, C<uidsize>, C<uidtype>,
10799 C<uname>, C<uniq>, C<uquadtype>, C<use5005threads>, C<use64bitall>,
10800 C<use64bitint>, C<usecrosscompile>, C<usedl>, C<useithreads>,
10801 C<uselargefiles>, C<uselongdouble>, C<usemorebits>, C<usemultiplicity>,
10802 C<usemymalloc>, C<usenm>, C<useopcode>, C<useperlio>, C<useposix>,
10803 C<usereentrant>, C<usesfio>, C<useshrplib>, C<usesocks>, C<usethreads>,
10804 C<usevendorprefix>, C<usevfork>, C<usrinc>, C<uuname>, C<uvoformat>,
10805 C<uvsize>, C<uvtype>, C<uvuformat>, C<uvxformat>, C<uvXUformat>
10806
10807 =item v
10808
10809 C<vendorarch>, C<vendorarchexp>, C<vendorbin>, C<vendorbinexp>,
10810 C<vendorlib>, C<vendorlib_stem>, C<vendorlibexp>, C<vendorprefix>,
10811 C<vendorprefixexp>, C<version>, C<version_patchlevel_string>,
10812 C<versiononly>, C<vi>, C<voidflags>
10813
10814 =item x
10815
10816 C<xlibpth>, C<xs_apiversion>
10817
10818 =item y
10819
10820 C<yacc>, C<yaccflags>
10821
10822 =item z
10823
10824 C<zcat>, C<zip>
10825
10826 =back
10827
10828 =item NOTE
10829
10830 =back
10831
10832 =head2 Cwd - get pathname of current working directory
10833
10834 =over 4
10835
10836 =item SYNOPSIS
10837
10838 =item DESCRIPTION
10839
10840 =over 4
10841
10842 =item getcwd and friends
10843
10844 getcwd, cwd, fastcwd, fastgetcwd
10845
10846 =item abs_path and friends
10847
10848 abs_path, realpath, fast_abs_path
10849
10850 =item $ENV{PWD}
10851
10852 =back
10853
10854 =item NOTES
10855
10856 =item SEE ALSO
10857
10858 =back
10859
10860 =head2 DB - programmatic interface to the Perl debugging API (draft,
10861 subject to
10862 change)
10863
10864 =over 4
10865
10866 =item SYNOPSIS
10867
10868 =item DESCRIPTION
10869
10870 =over 4
10871
10872 =item Global Variables
10873
10874  $DB::sub,  %DB::sub,  $DB::single,  $DB::signal,  $DB::trace,  @DB::args,
10875 @DB::dbline,  %DB::dbline,  $DB::package,  $DB::filename,  $DB::subname,
10876 $DB::lineno
10877
10878 =item API Methods
10879
10880 CLIENT->register(), CLIENT->evalcode(STRING), CLIENT->skippkg('D::hide'),
10881 CLIENT->run(), CLIENT->step(), CLIENT->next(), CLIENT->done()
10882
10883 =item Client Callback Methods
10884
10885 CLIENT->init(), CLIENT->prestop([STRING]), CLIENT->stop(), CLIENT->idle(),
10886 CLIENT->poststop([STRING]), CLIENT->evalcode(STRING), CLIENT->cleanup(),
10887 CLIENT->output(LIST)
10888
10889 =back
10890
10891 =item BUGS
10892
10893 =item AUTHOR
10894
10895 =back
10896
10897 =head2 DB_File - Perl5 access to Berkeley DB version 1.x
10898
10899 =over 4
10900
10901 =item SYNOPSIS
10902
10903 =item DESCRIPTION
10904
10905 B<DB_HASH>, B<DB_BTREE>, B<DB_RECNO>
10906
10907 =over 4
10908
10909 =item Using DB_File with Berkeley DB version 2 or greater
10910
10911 =item Interface to Berkeley DB
10912
10913 =item Opening a Berkeley DB Database File
10914
10915 =item Default Parameters
10916
10917 =item In Memory Databases
10918
10919 =back
10920
10921 =item DB_HASH
10922
10923 =over 4
10924
10925 =item A Simple Example
10926
10927 =back
10928
10929 =item DB_BTREE
10930
10931 =over 4
10932
10933 =item Changing the BTREE sort order
10934
10935 =item Handling Duplicate Keys
10936
10937 =item The get_dup() Method
10938
10939 =item The find_dup() Method
10940
10941 =item The del_dup() Method
10942
10943 =item Matching Partial Keys
10944
10945 =back
10946
10947 =item DB_RECNO
10948
10949 =over 4
10950
10951 =item The 'bval' Option
10952
10953 =item A Simple Example
10954
10955 =item Extra RECNO Methods
10956
10957 B<$X-E<gt>push(list) ;>, B<$value = $X-E<gt>pop ;>, B<$X-E<gt>shift>,
10958 B<$X-E<gt>unshift(list) ;>, B<$X-E<gt>length>, B<$X-E<gt>splice(offset,
10959 length, elements);>
10960
10961 =item Another Example
10962
10963 =back
10964
10965 =item THE API INTERFACE
10966
10967 B<$status = $X-E<gt>get($key, $value [, $flags]) ;>, B<$status =
10968 $X-E<gt>put($key, $value [, $flags]) ;>, B<$status = $X-E<gt>del($key [,
10969 $flags]) ;>, B<$status = $X-E<gt>fd ;>, B<$status = $X-E<gt>seq($key,
10970 $value, $flags) ;>, B<$status = $X-E<gt>sync([$flags]) ;>
10971
10972 =item DBM FILTERS
10973
10974 B<filter_store_key>, B<filter_store_value>, B<filter_fetch_key>,
10975 B<filter_fetch_value>
10976
10977 =over 4
10978
10979 =item The Filter
10980
10981 =item An Example -- the NULL termination problem.
10982
10983 =item Another Example -- Key is a C int.
10984
10985 =back
10986
10987 =item HINTS AND TIPS
10988
10989 =over 4
10990
10991 =item Locking: The Trouble with fd
10992
10993 =item Safe ways to lock a database
10994
10995 B<Tie::DB_Lock>, B<Tie::DB_LockFile>, B<DB_File::Lock>
10996
10997 =item Sharing Databases With C Applications
10998
10999 =item The untie() Gotcha
11000
11001 =back
11002
11003 =item COMMON QUESTIONS
11004
11005 =over 4
11006
11007 =item Why is there Perl source in my database?
11008
11009 =item How do I store complex data structures with DB_File?
11010
11011 =item What does "Invalid Argument" mean?
11012
11013 =item What does "Bareword 'DB_File' not allowed" mean?
11014
11015 =back
11016
11017 =item REFERENCES
11018
11019 =item HISTORY
11020
11021 =item BUGS
11022
11023 =item AVAILABILITY
11024
11025 =item COPYRIGHT
11026
11027 =item SEE ALSO
11028
11029 =item AUTHOR
11030
11031 =back
11032
11033 =head2 Data::Dumper - stringified perl data structures, suitable for both
11034 printing and C<eval>
11035
11036 =over 4
11037
11038 =item SYNOPSIS
11039
11040 =item DESCRIPTION
11041
11042 =over 4
11043
11044 =item Methods
11045
11046 I<PACKAGE>->new(I<ARRAYREF [>, I<ARRAYREF]>), I<$OBJ>->Dump  I<or>
11047 I<PACKAGE>->Dump(I<ARRAYREF [>, I<ARRAYREF]>), I<$OBJ>->Seen(I<[HASHREF]>),
11048 I<$OBJ>->Values(I<[ARRAYREF]>), I<$OBJ>->Names(I<[ARRAYREF]>),
11049 I<$OBJ>->Reset
11050
11051 =item Functions
11052
11053 Dumper(I<LIST>)
11054
11055 =item Configuration Variables or Methods
11056
11057 $Data::Dumper::Indent  I<or>  I<$OBJ>->Indent(I<[NEWVAL]>),
11058 $Data::Dumper::Purity  I<or>  I<$OBJ>->Purity(I<[NEWVAL]>),
11059 $Data::Dumper::Pad  I<or>  I<$OBJ>->Pad(I<[NEWVAL]>),
11060 $Data::Dumper::Varname  I<or>  I<$OBJ>->Varname(I<[NEWVAL]>),
11061 $Data::Dumper::Useqq  I<or>  I<$OBJ>->Useqq(I<[NEWVAL]>),
11062 $Data::Dumper::Terse  I<or>  I<$OBJ>->Terse(I<[NEWVAL]>),
11063 $Data::Dumper::Freezer  I<or>  $I<OBJ>->Freezer(I<[NEWVAL]>),
11064 $Data::Dumper::Toaster  I<or>  $I<OBJ>->Toaster(I<[NEWVAL]>),
11065 $Data::Dumper::Deepcopy  I<or>  $I<OBJ>->Deepcopy(I<[NEWVAL]>),
11066 $Data::Dumper::Quotekeys  I<or>  $I<OBJ>->Quotekeys(I<[NEWVAL]>),
11067 $Data::Dumper::Bless  I<or>  $I<OBJ>->Bless(I<[NEWVAL]>),
11068 $Data::Dumper::Maxdepth  I<or>  $I<OBJ>->Maxdepth(I<[NEWVAL]>),
11069 $Data::Dumper::Useperl  I<or>  $I<OBJ>->Useperl(I<[NEWVAL]>),
11070 $Data::Dumper::Sortkeys  I<or>  $I<OBJ>->Sortkeys(I<[NEWVAL]>),
11071 $Data::Dumper::Deparse  I<or>  $I<OBJ>->Deparse(I<[NEWVAL]>)
11072
11073 =item Exports
11074
11075 Dumper
11076
11077 =back
11078
11079 =item EXAMPLES
11080
11081 =item BUGS
11082
11083 =item AUTHOR
11084
11085 =item VERSION
11086
11087 =item SEE ALSO
11088
11089 =back
11090
11091 =head2 Devel::DProf - a Perl code profiler
11092
11093 =over 4
11094
11095 =item SYNOPSIS
11096
11097 =item DESCRIPTION
11098
11099 =item PROFILE FORMAT
11100
11101 =item AUTOLOAD
11102
11103 =item ENVIRONMENT
11104
11105 =item BUGS
11106
11107 =item SEE ALSO
11108
11109 =back
11110
11111 =head2 Devel::PPPort, Perl/Pollution/Portability
11112
11113 =over 4
11114
11115 =item SYNOPSIS
11116
11117 =item DESCRIPTION
11118
11119 =over 4
11120
11121 =item WriteFile
11122
11123 =back
11124
11125 =item ppport.h
11126
11127 =item AUTHOR
11128
11129 =item SEE ALSO
11130
11131 =back
11132
11133 =head2 Devel::Peek - A data debugging tool for the XS programmer
11134
11135 =over 4
11136
11137 =item SYNOPSIS
11138
11139 =item DESCRIPTION
11140
11141 =over 4
11142
11143 =item Runtime debugging
11144
11145 =item Memory footprint debugging
11146
11147 =back
11148
11149 =item EXAMPLES
11150
11151 =over 4
11152
11153 =item A simple scalar string
11154
11155 =item A simple scalar number
11156
11157 =item A simple scalar with an extra reference
11158
11159 =item A reference to a simple scalar
11160
11161 =item A reference to an array
11162
11163 =item A reference to a hash
11164
11165 =item Dumping a large array or hash
11166
11167 =item A reference to an SV which holds a C pointer
11168
11169 =item A reference to a subroutine
11170
11171 =back
11172
11173 =item EXPORTS
11174
11175 =item BUGS
11176
11177 =item AUTHOR
11178
11179 =item SEE ALSO
11180
11181 =back
11182
11183 =head2 Devel::SelfStubber - generate stubs for a SelfLoading module
11184
11185 =over 4
11186
11187 =item SYNOPSIS
11188
11189 =item DESCRIPTION
11190
11191 =back
11192
11193 =head2 Digest:: - Modules that calculate message digests
11194
11195 =over 4
11196
11197 =item SYNOPSIS
11198
11199 =item DESCRIPTION
11200
11201 I<binary>, I<hex>, I<base64>
11202
11203 =item OO INTERFACE
11204
11205 $ctx = Digest->XXX($arg,...), $ctx = Digest->new(XXX => $arg,...), $ctx =
11206 Digest::XXX->new($arg,...), $ctx->reset, $ctx->add($data,...),
11207 $ctx->addfile($io_handle), $ctx->digest, $ctx->hexdigest, $ctx->b64digest
11208
11209 =item SEE ALSO
11210
11211 =item AUTHOR
11212
11213 =back
11214
11215 =head2 Digest::MD5 - Perl interface to the MD5 Algorithm
11216
11217 =over 4
11218
11219 =item SYNOPSIS
11220
11221 =item DESCRIPTION
11222
11223 =item FUNCTIONS
11224
11225 md5($data,...), md5_hex($data,...), md5_base64($data,...)
11226
11227 =item METHODS
11228
11229 $md5 = Digest::MD5->new, $md5->reset, $md5->add($data,...),
11230 $md5->addfile($io_handle), $md5->digest, $md5->hexdigest, $md5->b64digest
11231
11232 =item EXAMPLES
11233
11234 =item SEE ALSO
11235
11236 =item COPYRIGHT
11237
11238 =item AUTHORS
11239
11240 =back
11241
11242 =head2 DirHandle - supply object methods for directory handles
11243
11244 =over 4
11245
11246 =item SYNOPSIS
11247
11248 =item DESCRIPTION
11249
11250 =item NOTES
11251
11252 =back
11253
11254 =head2 Dumpvalue - provides screen dump of Perl data.
11255
11256 =over 4
11257
11258 =item SYNOPSIS
11259
11260 =item DESCRIPTION
11261
11262 =over 4
11263
11264 =item Creation
11265
11266 C<arrayDepth>, C<hashDepth>, C<compactDump>, C<veryCompact>, C<globPrint>,
11267 C<dumpDBFiles>, C<dumpPackages>, C<dumpReused>, C<tick>, C<quoteHighBit>,
11268 C<printUndef>, C<usageOnly>, unctrl, subdump, bareStringify, quoteHighBit,
11269 stopDbSignal
11270
11271 =item Methods
11272
11273 dumpValue, dumpValues, stringify, dumpvars, set_quote, set_unctrl,
11274 compactDump, veryCompact, set, get
11275
11276 =back
11277
11278 =back
11279
11280 =head2 DynaLoader - Dynamically load C libraries into Perl code
11281
11282 =over 4
11283
11284 =item SYNOPSIS
11285
11286 =item DESCRIPTION
11287
11288 @dl_library_path, @dl_resolve_using, @dl_require_symbols, @dl_librefs,
11289 @dl_modules, dl_error(), $dl_debug, dl_findfile(), dl_expandspec(),
11290 dl_load_file(), dl_unload_file(), dl_loadflags(), dl_find_symbol(),
11291 dl_find_symbol_anywhere(), dl_undef_symbols(), dl_install_xsub(),
11292 bootstrap()
11293
11294 =item AUTHOR
11295
11296 =back
11297
11298 =head2 DynaLoader::XSLoader, XSLoader - Dynamically load C libraries into
11299 Perl code
11300
11301 =over 4
11302
11303 =item SYNOPSIS
11304
11305 =item DESCRIPTION
11306
11307 =item AUTHOR
11308
11309 =back
11310
11311 =head2 Encode - character encodings
11312
11313 =over 4
11314
11315 =item SYNOPSIS
11316
11317 =over 4
11318
11319 =item Table of Contents
11320
11321 =back
11322
11323 =item DESCRIPTION
11324
11325 =over 4
11326
11327 =item TERMINOLOGY
11328
11329 =back
11330
11331 =item PERL ENCODING API
11332
11333 $octets  = encode(ENCODING, $string [, CHECK]), $string = decode(ENCODING,
11334 $octets [, CHECK]), [$length =] from_to($octets, FROM_ENC, TO_ENC [,
11335 CHECK]), $octets = encode_utf8($string);, $string = decode_utf8($octets [,
11336 CHECK]);
11337
11338 =over 4
11339
11340 =item Listing available encodings
11341
11342 =item Defining Aliases
11343
11344 =back
11345
11346 =item Encoding via PerlIO
11347
11348 =item Handling Malformed Data
11349
11350 I<CHECK> = Encode::FB_DEFAULT ( == 0), I<CHECK> = Encode::FB_CROAK ( == 1),
11351 I<CHECK> = Encode::FB_QUIET, I<CHECK> = Encode::FB_WARN, perlqq mode
11352 (I<CHECK> = Encode::FB_PERLQQ), HTML charref mode (I<CHECK> =
11353 Encode::FB_HTMLCREF), XML charref mode (I<CHECK> = Encode::FB_XMLCREF), The
11354 bitmask
11355
11356 =over 4
11357
11358 =item Unimplemented fallback schemes
11359
11360 =back
11361
11362 =item Defining Encodings
11363
11364 =item The UTF-8 flag
11365
11366 Goal #1:, Goal #2:, Goal #3:, Goal #4:
11367
11368 =over 4
11369
11370 =item Messing with Perl's Internals
11371
11372 is_utf8(STRING [, CHECK]), _utf8_on(STRING), _utf8_off(STRING)
11373
11374 =back
11375
11376 =item SEE ALSO
11377
11378 =item MAINTAINER
11379
11380 =back
11381
11382 =head2 Encode::Alias - alias definitions to encodings
11383
11384 =over 4
11385
11386 =item SYNOPSIS
11387
11388 =item DESCRIPTION
11389
11390 As a simple string, As a qr// compiled regular expression, e.g.:, As a code
11391 reference, e.g.:
11392
11393 =over 4
11394
11395 =item Alias overloading
11396
11397 =back
11398
11399 =item SEE ALSO
11400
11401 =back
11402
11403 =head2 Encode::Byte - Single Byte Encodings
11404
11405 =over 4
11406
11407 =item SYNOPSIS
11408
11409 =item ABSTRACT
11410
11411 =item DESCRIPTION
11412
11413 =item SEE ALSO
11414
11415 =back
11416
11417 =head2   Encode::CJKConstants -- Internally used by Encode::??::ISO_2022_*
11418
11419 =head2 Encode::CN - China-based Chinese Encodings
11420
11421 =over 4
11422
11423 =item SYNOPSIS
11424
11425 =item DESCRIPTION
11426
11427 =item NOTES
11428
11429 =item BUGS
11430
11431 =item SEE ALSO
11432
11433 =back
11434
11435 =head2 Encode::CN::HZ -- internally used by Encode::CN
11436
11437 =head2 Encode::Config -- internally used by Encode
11438
11439 =head2 Encode::EBCDIC - EBCDIC Encodings
11440
11441 =over 4
11442
11443 =item SYNOPSIS
11444
11445 =item ABSTRACT
11446
11447 =item DESCRIPTION
11448
11449 =item SEE ALSO
11450
11451 =back
11452
11453 =head2 Encode::Encoding - Encode Implementation Base Class
11454
11455 =over 4
11456
11457 =item SYNOPSIS
11458
11459 =item DESCRIPTION
11460
11461 =over 4
11462
11463 =item Methods you should implement
11464
11465 -E<gt>encode($string [,$check]), -E<gt>decode($octets [,$check])
11466
11467 =item Other methods defined in Encode::Encodings
11468
11469 -E<gt>name, -E<gt>new_sequence, -E<gt>perlio_ok(), -E<gt>needs_lines()
11470
11471 =item Example: Encode::ROT13
11472
11473 =back
11474
11475 =item Why the heck Encode API is different?
11476
11477 =over 4
11478
11479 =item Compiled Encodings
11480
11481 =back
11482
11483 =item SEE ALSO
11484
11485 Scheme 1, Scheme 2, Other Schemes
11486
11487 =back
11488
11489 =head2 Encode::Guess -- Guesses encoding from data
11490
11491 =over 4
11492
11493 =item SYNOPSIS
11494
11495 =item ABSTRACT
11496
11497 =item DESCRIPTION
11498
11499 Encode::Guess->set_suspects, Encode::Guess->add_suspects,
11500 Encode::decode("Guess" ...), Encode::Guess->guess($data),
11501 guess_encoding($data, [, I<list of suspects>])
11502
11503 =item CAVEATS
11504
11505 =item TO DO
11506
11507 =item SEE ALSO
11508
11509 =back
11510
11511 =head2 Encode::JP - Japanese Encodings
11512
11513 =over 4
11514
11515 =item SYNOPSIS
11516
11517 =item ABSTRACT
11518
11519 =item DESCRIPTION
11520
11521 =item Note on ISO-2022-JP(-1)?
11522
11523 =item BUGS
11524
11525 =item SEE ALSO
11526
11527 =back
11528
11529 =head2 Encode::JP::H2Z -- internally used by Encode::JP::2022_JP*
11530
11531 =head2 Encode::JP::JIS7 -- internally used by Encode::JP
11532
11533 =head2 Encode::KR - Korean Encodings
11534
11535 =over 4
11536
11537 =item SYNOPSIS
11538
11539 =item DESCRIPTION
11540
11541 =item BUGS
11542
11543 =item SEE ALSO
11544
11545 =back
11546
11547 =head2 Encode::KR::2022_KR -- internally used by Encode::KR
11548
11549 =head2 Encode::MIME::Header -- MIME 'B' and 'Q' header encoding
11550
11551 =over 4
11552
11553 =item SYNOPSIS
11554
11555 =item ABSTRACT
11556
11557 =item DESCRIPTION
11558
11559 =item BUGS
11560
11561 =item SEE ALSO
11562
11563 =back
11564
11565 =head2 Encode::PerlIO -- a detailed document on Encode and PerlIO
11566
11567 =over 4
11568
11569 =item Overview
11570
11571 =item How does it work?
11572
11573 =item BUGS
11574
11575 =over 4
11576
11577 =item Workaround
11578
11579 =item How can I tell whether my encoding fully supports PerlIO ?
11580
11581 =back
11582
11583 =item SEE ALSO
11584
11585 =back
11586
11587 =head2 Encode::Supported -- Encodings supported by Encode
11588
11589 =over 4
11590
11591 =item DESCRIPTION
11592
11593 =over 4
11594
11595 =item Encoding Names
11596
11597 =back
11598
11599 =item Supported Encodings
11600
11601 =over 4
11602
11603 =item Built-in Encodings
11604
11605 =item Encode::Unicode -- other Unicode encodings
11606
11607 =item Encode::Byte -- Extended ASCII
11608
11609 ISO-8859 and corresponding vendor mappings, KOI8 - De Facto Standard for
11610 the Cyrillic world, gsm0338 - Hentai Latin 1
11611
11612 =item CJK: Chinese, Japanese, Korean (Multibyte)
11613
11614 Encode::CN -- Continental China, Encode::JP -- Japan, Encode::KR -- Korea,
11615 Encode::TW -- Taiwan, Encode::HanExtra -- More Chinese via CPAN,
11616 Encode::JIS2K -- JIS X 0213 encodings via CPAN
11617
11618 =item Miscellaneous encodings
11619
11620 Encode::EBCDIC, Encode::Symbols, Encode::MIME::Header, Encode::Guess
11621
11622 =back
11623
11624 =item Unsupported encodings
11625
11626   ISO-2022-JP-2 [RFC1554], ISO-2022-CN [RFC1922], Various HP-UX encodings,
11627 Cyrillic encoding ISO-IR-111, ISO-8859-8-1 [Hebrew], ISIRI 3342, Iran
11628 System, ISIRI 2900 [Farsi], Thai encoding TCVN, Vietnamese encodings VPS,
11629 Various Mac encodings, (Mac) Indic encodings
11630
11631 =item Encoding vs. Charset -- terminology
11632
11633 =item Encoding Classification (by Anton Tagunov and Dan Kogai)
11634
11635 =over 4
11636
11637 =item Microsoft-related naming mess
11638
11639 KS_C_5601-1987, GB2312, Big5, Shift_JIS
11640
11641 =back
11642
11643 =item Glossary
11644
11645 character repertoire, coded character set (CCS), character encoding scheme
11646 (CES), charset (in MIME context), EUC, ISO-2022, UCS, UCS-2, Unicode, UTF,
11647 UTF-16
11648
11649 =item See Also
11650
11651 =item References
11652
11653 ECMA, ECMA-035 (eq C<ISO-2022>), IANA, Assigned Charset Names by IANA, ISO,
11654 RFC, UC, Unicode Glossary
11655
11656 =over 4
11657
11658 =item Other Notable Sites
11659
11660 czyborra.com, CJK.inf, Jungshik Shin's Hangul FAQ, debian.org:
11661 "Introduction to i18n"
11662
11663 =item Offline sources
11664
11665 C<CJKV Information Processing> by Ken Lunde
11666
11667 =back
11668
11669 =back
11670
11671 =head2 Encode::Symbol - Symbol Encodings
11672
11673 =over 4
11674
11675 =item SYNOPSIS
11676
11677 =item ABSTRACT
11678
11679 =item DESCRIPTION
11680
11681 =item SEE ALSO
11682
11683 =back
11684
11685 =head2 Encode::TW - Taiwan-based Chinese Encodings
11686
11687 =over 4
11688
11689 =item SYNOPSIS
11690
11691 =item DESCRIPTION
11692
11693 =item NOTES
11694
11695 =item BUGS
11696
11697 =item SEE ALSO
11698
11699 =back
11700
11701 =head2 Encode::Unicode -- Various Unicode Transformation Formats
11702
11703 =over 4
11704
11705 =item SYNOPSIS
11706
11707 =item ABSTRACT
11708
11709 L<http://www.unicode.org/glossary/> says:, Quick Reference
11710
11711 =item Size, Endianness, and BOM
11712
11713 =over 4
11714
11715 =item by size
11716
11717 =item by endianness
11718
11719 BOM as integer when fetched in network byte order
11720
11721 =back
11722
11723 =item Surrogate Pairs
11724
11725 =item SEE ALSO
11726
11727 =back
11728
11729 =head2 Encode::lib::Encode::Alias, Encode::Alias - alias definitions to
11730 encodings
11731
11732 =over 4
11733
11734 =item SYNOPSIS
11735
11736 =item DESCRIPTION
11737
11738 As a simple string, As a qr// compiled regular expression, e.g.:, As a code
11739 reference, e.g.:
11740
11741 =over 4
11742
11743 =item Alias overloading
11744
11745 =back
11746
11747 =item SEE ALSO
11748
11749 =back
11750
11751 =head2 Encode::lib::Encode::CJKConstants,   Encode::CJKConstants.pm --
11752 Internally used by Encode::??::ISO_2022_*
11753
11754 =head2 Encode::lib::Encode::CN::HZ, Encode::CN::HZ -- internally used by
11755 Encode::CN
11756
11757 =head2 Encode::lib::Encode::Config, Encode::Config -- internally used by
11758 Encode
11759
11760 =head2 Encode::lib::Encode::Encoding, Encode::Encoding - Encode
11761 Implementation Base Class
11762
11763 =over 4
11764
11765 =item SYNOPSIS
11766
11767 =item DESCRIPTION
11768
11769 =over 4
11770
11771 =item Methods you should implement
11772
11773 -E<gt>encode($string [,$check]), -E<gt>decode($octets [,$check])
11774
11775 =item Other methods defined in Encode::Encodings
11776
11777 -E<gt>name, -E<gt>new_sequence, -E<gt>perlio_ok(), -E<gt>needs_lines()
11778
11779 =item Example: Encode::ROT13
11780
11781 =back
11782
11783 =item Why the heck Encode API is different?
11784
11785 =over 4
11786
11787 =item Compiled Encodings
11788
11789 =back
11790
11791 =item SEE ALSO
11792
11793 Scheme 1, Scheme 2, Other Schemes
11794
11795 =back
11796
11797 =head2 Encode::lib::Encode::Guess, Encode::Guess -- Guesses encoding from
11798 data
11799
11800 =over 4
11801
11802 =item SYNOPSIS
11803
11804 =item ABSTRACT
11805
11806 =item DESCRIPTION
11807
11808 Encode::Guess->set_suspects, Encode::Guess->add_suspects,
11809 Encode::decode("Guess" ...), Encode::Guess->guess($data),
11810 guess_encoding($data, [, I<list of suspects>])
11811
11812 =item CAVEATS
11813
11814 =item TO DO
11815
11816 =item SEE ALSO
11817
11818 =back
11819
11820 =head2 Encode::lib::Encode::JP::H2Z, Encode::JP::H2Z -- internally used by
11821 Encode::JP::2022_JP*
11822
11823 =head2 Encode::lib::Encode::JP::JIS7, Encode::JP::JIS7 -- internally used
11824 by Encode::JP
11825
11826 =head2 Encode::lib::Encode::KR::2022_KR, Encode::KR::2022_KR -- internally
11827 used by Encode::KR
11828
11829 =head2 Encode::lib::Encode::MIME::Header, Encode::MIME::Header -- MIME 'B'
11830 and 'Q' header encoding
11831
11832 =over 4
11833
11834 =item SYNOPSIS
11835
11836 =item ABSTRACT
11837
11838 =item DESCRIPTION
11839
11840 =item BUGS
11841
11842 =item SEE ALSO
11843
11844 =back
11845
11846 =head2 Encode::lib::Encode::PerlIO, Encode::PerlIO -- a detailed document
11847 on Encode and PerlIO
11848
11849 =over 4
11850
11851 =item Overview
11852
11853 =item How does it work?
11854
11855 =item BUGS
11856
11857 =over 4
11858
11859 =item Workaround
11860
11861 =item How can I tell whether my encoding fully supports PerlIO ?
11862
11863 =back
11864
11865 =item SEE ALSO
11866
11867 =back
11868
11869 =head2 Encode::lib::Encode::Supported, Encode::Supported -- Encodings
11870 supported by Encode
11871
11872 =over 4
11873
11874 =item DESCRIPTION
11875
11876 =over 4
11877
11878 =item Encoding Names
11879
11880 =back
11881
11882 =item Supported Encodings
11883
11884 =over 4
11885
11886 =item Built-in Encodings
11887
11888 =item Encode::Unicode -- other Unicode encodings
11889
11890 =item Encode::Byte -- Extended ASCII
11891
11892 ISO-8859 and corresponding vendor mappings, KOI8 - De Facto Standard for
11893 the Cyrillic world, gsm0338 - Hentai Latin 1
11894
11895 =item CJK: Chinese, Japanese, Korean (Multibyte)
11896
11897 Encode::CN -- Continental China, Encode::JP -- Japan, Encode::KR -- Korea,
11898 Encode::TW -- Taiwan, Encode::HanExtra -- More Chinese via CPAN,
11899 Encode::JIS2K -- JIS X 0213 encodings via CPAN
11900
11901 =item Miscellaneous encodings
11902
11903 Encode::EBCDIC, Encode::Symbols, Encode::MIME::Header, Encode::Guess
11904
11905 =back
11906
11907 =item Unsupported encodings
11908
11909   ISO-2022-JP-2 [RFC1554], ISO-2022-CN [RFC1922], Various HP-UX encodings,
11910 Cyrillic encoding ISO-IR-111, ISO-8859-8-1 [Hebrew], ISIRI 3342, Iran
11911 System, ISIRI 2900 [Farsi], Thai encoding TCVN, Vietnamese encodings VPS,
11912 Various Mac encodings, (Mac) Indic encodings
11913
11914 =item Encoding vs. Charset -- terminology
11915
11916 =item Encoding Classification (by Anton Tagunov and Dan Kogai)
11917
11918 =over 4
11919
11920 =item Microsoft-related naming mess
11921
11922 KS_C_5601-1987, GB2312, Big5, Shift_JIS
11923
11924 =back
11925
11926 =item Glossary
11927
11928 character repertoire, coded character set (CCS), character encoding scheme
11929 (CES), charset (in MIME context), EUC, ISO-2022, UCS, UCS-2, Unicode, UTF,
11930 UTF-16
11931
11932 =item See Also
11933
11934 =item References
11935
11936 ECMA, ECMA-035 (eq C<ISO-2022>), IANA, Assigned Charset Names by IANA, ISO,
11937 RFC, UC, Unicode Glossary
11938
11939 =over 4
11940
11941 =item Other Notable Sites
11942
11943 czyborra.com, CJK.inf, Jungshik Shin's Hangul FAQ, debian.org:
11944 "Introduction to i18n"
11945
11946 =item Offline sources
11947
11948 C<CJKV Information Processing> by Ken Lunde
11949
11950 =back
11951
11952 =back
11953
11954 =head2 Encode::lib::Encoder, Encode::Encoder -- Object Oriented Encoder
11955
11956 =over 4
11957
11958 =item SYNOPSIS
11959
11960   use Encode::Encoder;
11961   # Encode::encode("ISO-8859-1", $data);
11962   Encode::Encoder->new($data)->iso_8859_1; # OOP way
11963   # shortcut
11964   use Encode::Encoder qw(encoder);
11965   encoder($data)->iso_8859_1;
11966   # you can stack them!
11967   encoder($data)->iso_8859_1->base64;  # provided base64() is defined
11968   # you can use it as a decoder as well
11969   encoder($base64)->bytes('base64')->latin1;
11970   # stringified
11971   print encoder($data)->utf8->latin1;  # prints the string in latin1
11972   # numified
11973   encoder("\x{abcd}\x{ef}g")->utf8 == 6; # true. bytes::length($data)
11974
11975 =item ABSTRACT
11976
11977 =item Description
11978
11979 =over 4
11980
11981 =item Predefined Methods
11982
11983 $e = Encode::Encoder-E<gt>new([$data, $encoding]);, encoder(),
11984 $e-E<gt>data([$data]), $e-E<gt>encoding([$encoding]),
11985 $e-E<gt>bytes([$encoding])
11986
11987 =item Example: base64 transcoder
11988
11989 =item Operator Overloading
11990
11991 =back
11992
11993 =item SEE ALSO
11994
11995 =back
11996
11997 =head2 Encodencoding, encoding - allows you to write your script in
11998 non-ascii or non-utf8
11999
12000 =over 4
12001
12002 =item SYNOPSIS
12003
12004 =item ABSTRACT
12005
12006 =item USAGE
12007
12008 use encoding [I<ENCNAME>] ;, use encoding I<ENCNAME> [ STDIN =E<gt>
12009 I<ENCNAME_IN> ...] ;, no encoding;
12010
12011 =item CAVEATS
12012
12013 =over 4
12014
12015 =item NOT SCOPED
12016
12017 =item DO NOT MIX MULTIPLE ENCODINGS
12018
12019 =back
12020
12021 =item Non-ASCII Identifiers and Filter option
12022
12023 use encoding I<ENCNAME> Filter=E<gt>1;
12024
12025 =item EXAMPLE - Greekperl
12026
12027 =item KNOWN PROBLEMS
12028
12029 =item SEE ALSO
12030
12031 =back
12032
12033 =head2 Encoder, Encode::Encoder -- Object Oriented Encoder
12034
12035 =over 4
12036
12037 =item SYNOPSIS
12038
12039   use Encode::Encoder;
12040   # Encode::encode("ISO-8859-1", $data);
12041   Encode::Encoder->new($data)->iso_8859_1; # OOP way
12042   # shortcut
12043   use Encode::Encoder qw(encoder);
12044   encoder($data)->iso_8859_1;
12045   # you can stack them!
12046   encoder($data)->iso_8859_1->base64;  # provided base64() is defined
12047   # you can use it as a decoder as well
12048   encoder($base64)->bytes('base64')->latin1;
12049   # stringified
12050   print encoder($data)->utf8->latin1;  # prints the string in latin1
12051   # numified
12052   encoder("\x{abcd}\x{ef}g")->utf8 == 6; # true. bytes::length($data)
12053
12054 =item ABSTRACT
12055
12056 =item Description
12057
12058 =over 4
12059
12060 =item Predefined Methods
12061
12062 $e = Encode::Encoder-E<gt>new([$data, $encoding]);, encoder(),
12063 $e-E<gt>data([$data]), $e-E<gt>encoding([$encoding]),
12064 $e-E<gt>bytes([$encoding])
12065
12066 =item Example: base64 transcoder
12067
12068 =item Operator Overloading
12069
12070 =back
12071
12072 =item SEE ALSO
12073
12074 =back
12075
12076 =head2 English - use nice English (or awk) names for ugly punctuation
12077 variables
12078
12079 =over 4
12080
12081 =item SYNOPSIS
12082
12083 =item DESCRIPTION
12084
12085 =item PERFORMANCE
12086
12087 =back
12088
12089 =head2 Env - perl module that imports environment variables as scalars or
12090 arrays
12091
12092 =over 4
12093
12094 =item SYNOPSIS
12095
12096 =item DESCRIPTION
12097
12098 =item LIMITATIONS
12099
12100 =item AUTHOR
12101
12102 =back
12103
12104 =head2 Errno - System errno constants
12105
12106 =over 4
12107
12108 =item SYNOPSIS
12109
12110 =item DESCRIPTION
12111
12112 =item CAVEATS
12113
12114 =item AUTHOR
12115
12116 =item COPYRIGHT
12117
12118 =back
12119
12120 =head2 Exporter - Implements default import method for modules
12121
12122 =over 4
12123
12124 =item SYNOPSIS
12125
12126 =item DESCRIPTION
12127
12128 =over 4
12129
12130 =item How to Export
12131
12132 =item Selecting What To Export
12133
12134 =item How to Import
12135
12136 C<use ModuleName;>, C<use ModuleName ();>, C<use ModuleName qw(...);>
12137
12138 =back
12139
12140 =item Advanced features
12141
12142 =over 4
12143
12144 =item Specialised Import Lists
12145
12146 =item Exporting without using Exporter's import method
12147
12148 =item Module Version Checking
12149
12150 =item Managing Unknown Symbols
12151
12152 =item Tag Handling Utility Functions
12153
12154 =item Generating combined tags
12155
12156 =item C<AUTOLOAD>ed Constants
12157
12158 =back
12159
12160 =back
12161
12162 =head2 Exporter::Heavy - Exporter guts
12163
12164 =over 4
12165
12166 =item SYNOPSIS
12167
12168 =item DESCRIPTION
12169
12170 =back
12171
12172 =head2 ExtUtils::Command - utilities to replace common UNIX commands in
12173 Makefiles etc.
12174
12175 =over 4
12176
12177 =item SYNOPSIS
12178
12179 =item DESCRIPTION
12180
12181 =back
12182
12183 cat
12184
12185 eqtime src dst
12186
12187 rm_rf files...
12188
12189 rm_f files...
12190
12191 touch files ..
12192
12193 mv source... destination
12194
12195 cp source... destination
12196
12197 chmod mode files..
12198
12199 mkpath directory..
12200
12201 test_f file
12202
12203 =over 4
12204
12205 =item BUGS
12206
12207 =item SEE ALSO
12208
12209 =item AUTHOR
12210
12211 =back
12212
12213 =head2 ExtUtils::Command::MM - Commands for the MM's to use in Makefiles
12214
12215 =over 4
12216
12217 =item SYNOPSIS
12218
12219 =item DESCRIPTION
12220
12221 B<test_harness>
12222
12223 =back
12224
12225 =head2 ExtUtils::Constant - generate XS code to import C header constants
12226
12227 =over 4
12228
12229 =item SYNOPSIS
12230
12231 =item DESCRIPTION
12232
12233 =item USAGE
12234
12235 IV, UV, NV, PV, PVN, SV, YES, NO, UNDEF
12236
12237 =item FUNCTIONS
12238
12239 =back
12240
12241 C_stringify NAME
12242
12243 perl_stringify NAME
12244
12245 constant_types
12246
12247 memEQ_clause NAME, CHECKED_AT, INDENT
12248
12249 assign INDENT, TYPE, PRE, POST, VALUE..
12250
12251 return_clause
12252
12253 switch_clause INDENT, NAMELEN, ITEMHASH, ITEM..
12254
12255 params WHAT
12256
12257 dump_names
12258
12259 dogfood
12260
12261 C_constant, name, type, value, macro, default, pre, post, def_pre =item
12262 def_post, utf8
12263
12264 XS_constant PACKAGE, TYPES, SUBNAME, C_SUBNAME
12265
12266 autoload PACKAGE, VERSION, AUTOLOADER
12267
12268 WriteMakefileSnippet
12269
12270 WriteConstants ATTRIBUTE =E<gt> VALUE [, ...], NAME, DEFAULT_TYPE,
12271 BREAKOUT_AT, NAMES, C_FILE, XS_FILE, SUBNAME, C_SUBNAME
12272
12273 =over 4
12274
12275 =item AUTHOR
12276
12277 =back
12278
12279 =head2 ExtUtils::Embed - Utilities for embedding Perl in C/C++ applications
12280
12281 =over 4
12282
12283 =item SYNOPSIS
12284
12285 =item DESCRIPTION
12286
12287 =item @EXPORT
12288
12289 =item FUNCTIONS
12290
12291 xsinit(), Examples, ldopts(), Examples, perl_inc(), ccflags(), ccdlflags(),
12292 ccopts(), xsi_header(), xsi_protos(@modules), xsi_body(@modules)
12293
12294 =item EXAMPLES
12295
12296 =item SEE ALSO
12297
12298 =item AUTHOR
12299
12300 =back
12301
12302 =head2 ExtUtils::Install - install files from here to there
12303
12304 =over 4
12305
12306 =item SYNOPSIS
12307
12308 =item DESCRIPTION
12309
12310 =back
12311
12312 =head2 ExtUtils::Installed - Inventory management of installed modules
12313
12314 =over 4
12315
12316 =item SYNOPSIS
12317
12318 =item DESCRIPTION
12319
12320 =item USAGE
12321
12322 =item FUNCTIONS
12323
12324 new(), modules(), files(), directories(), directory_tree(), validate(),
12325 packlist(), version()
12326
12327 =item EXAMPLE
12328
12329 =item AUTHOR
12330
12331 =back
12332
12333 =head2 ExtUtils::Liblist - determine libraries to use and how to use them
12334
12335 =over 4
12336
12337 =item SYNOPSIS
12338
12339 =item DESCRIPTION
12340
12341 For static extensions, For dynamic extensions at build/link time, For
12342 dynamic extensions at load time
12343
12344 =over 4
12345
12346 =item EXTRALIBS
12347
12348 =item LDLOADLIBS and LD_RUN_PATH
12349
12350 =item BSLOADLIBS
12351
12352 =back
12353
12354 =item PORTABILITY
12355
12356 =over 4
12357
12358 =item VMS implementation
12359
12360 =item Win32 implementation
12361
12362 =back
12363
12364 =item SEE ALSO
12365
12366 =back
12367
12368 =head2 ExtUtils::MM - OS adjusted ExtUtils::MakeMaker subclass
12369
12370 =over 4
12371
12372 =item SYNOPSIS
12373
12374 =item DESCRIPTION
12375
12376 =back
12377
12378 =head2 ExtUtils::MM_Any - Platform agnostic MM methods
12379
12380 =over 4
12381
12382 =item SYNOPSIS
12383
12384 =item DESCRIPTION
12385
12386 =item Inherently Cross-Platform Methods
12387
12388 =over 4
12389
12390 =item File::Spec wrappers  B<DEPRECATED>
12391
12392 canonpath
12393
12394 =back
12395
12396 =back
12397
12398 catdir
12399
12400 catfile
12401
12402 curdir
12403
12404 file_name_is_absolute
12405
12406 path
12407
12408 rootdir
12409
12410 updir
12411
12412 =over 4
12413
12414 =item Thought To Be Cross-Platform Methods
12415
12416 test_via_harness
12417
12418 =back
12419
12420 test_via_script
12421
12422 =over 4
12423
12424 =item AUTHOR
12425
12426 =back
12427
12428 =head2 ExtUtils::MM_BeOS - methods to override UN*X behaviour in
12429 ExtUtils::MakeMaker
12430
12431 =over 4
12432
12433 =item SYNOPSIS
12434
12435 =item DESCRIPTION
12436
12437 =back
12438
12439 perl_archive
12440
12441 =head2 ExtUtils::MM_Cygwin - methods to override UN*X behaviour in
12442 ExtUtils::MakeMaker
12443
12444 =over 4
12445
12446 =item SYNOPSIS
12447
12448 =item DESCRIPTION
12449
12450 canonpath, cflags, manifypods, perl_archive
12451
12452 =back
12453
12454 =head2 ExtUtils::MM_DOS - DOS specific subclass of ExtUtils::MM_Unix
12455
12456 =over 4
12457
12458 =item SYNOPSIS
12459
12460 =item DESCRIPTION
12461
12462 =over 4
12463
12464 =item Overridden methods
12465
12466 B<replace_manpage_separator>
12467
12468 =back
12469
12470 =back
12471
12472 =over 4
12473
12474 =item AUTHOR
12475
12476 =item SEE ALSO
12477
12478 =back
12479
12480 =head2 ExtUtils::MM_MacOS - methods to override UN*X behaviour in
12481 ExtUtils::MakeMaker
12482
12483 =over 4
12484
12485 =item SYNOPSIS
12486
12487 =item DESCRIPTION
12488
12489 =back
12490
12491 maybe_command
12492
12493 guess_name
12494
12495 macify
12496
12497 patternify
12498
12499 init_main
12500
12501 init_others
12502
12503 init_dirscan
12504
12505 libscan (o)
12506
12507 constants (o)
12508
12509 static (o)
12510
12511 dlsyms (o)
12512
12513 dynamic (o)
12514
12515 clean (o)
12516
12517 realclean (o)
12518
12519 rulez (o)
12520
12521 processPL (o)
12522
12523 =head2 ExtUtils::MM_NW5 - methods to override UN*X behaviour in
12524 ExtUtils::MakeMaker
12525
12526 =over 4
12527
12528 =item SYNOPSIS
12529
12530 =item DESCRIPTION
12531
12532 =back
12533
12534 constants (o)
12535
12536 static_lib (o)
12537
12538 dynamic_lib (o)
12539
12540 =head2 ExtUtils::MM_OS2 - methods to override UN*X behaviour in
12541 ExtUtils::MakeMaker
12542
12543 =over 4
12544
12545 =item SYNOPSIS
12546
12547 =item DESCRIPTION
12548
12549 =item METHODS
12550
12551 =back
12552
12553 perl_archive_after
12554
12555 =head2 ExtUtils::MM_UWIN - U/WIN specific subclass of ExtUtils::MM_Unix
12556
12557 =over 4
12558
12559 =item SYNOPSIS
12560
12561 =item DESCRIPTION
12562
12563 =over 4
12564
12565 =item Overridden methods
12566
12567 B<replace_manpage_separator>
12568
12569 =back
12570
12571 =back
12572
12573 =over 4
12574
12575 =item AUTHOR
12576
12577 =item SEE ALSO
12578
12579 =back
12580
12581 =head2 ExtUtils::MM_Unix - methods used by ExtUtils::MakeMaker
12582
12583 =over 4
12584
12585 =item SYNOPSIS
12586
12587 =item DESCRIPTION
12588
12589 =item METHODS
12590
12591 =back
12592
12593 =over 4
12594
12595 =item SelfLoaded methods
12596
12597 c_o (o)
12598
12599 =back
12600
12601 cflags (o)
12602
12603 clean (o)
12604
12605 const_cccmd (o)
12606
12607 const_config (o)
12608
12609 const_loadlibs (o)
12610
12611 constants (o)
12612
12613 depend (o)
12614
12615 dir_target (o)
12616
12617 dist (o)
12618
12619 dist_basics (o)
12620
12621 dist_ci (o)
12622
12623 dist_core (o)
12624
12625 dist_dir
12626
12627 dist_test
12628
12629 dlsyms (o)
12630
12631 dynamic (o)
12632
12633 dynamic_bs (o)
12634
12635 dynamic_lib (o)
12636
12637 exescan
12638
12639 extliblist
12640
12641 find_perl
12642
12643 find_tests
12644
12645 =over 4
12646
12647 =item Methods to actually produce chunks of text for the Makefile
12648
12649 fixin
12650
12651 =back
12652
12653 force (o)
12654
12655 guess_name
12656
12657 has_link_code
12658
12659 init_dirscan
12660
12661 init_main
12662
12663 init_others
12664
12665 init_INST
12666
12667 init_INSTALL
12668
12669 init_lib2arch
12670
12671 init_PERL
12672
12673 init_PERM
12674
12675 install (o)
12676
12677 installbin (o)
12678
12679 libscan (o)
12680
12681 linkext (o)
12682
12683 lsdir
12684
12685 macro (o)
12686
12687 makeaperl (o)
12688
12689 makefile (o)
12690
12691 manifypods (o)
12692
12693 maybe_command
12694
12695 maybe_command_in_dirs
12696
12697 needs_linking (o)
12698
12699 nicetext
12700
12701 parse_abstract
12702
12703 parse_version
12704
12705 pasthru (o)
12706
12707 perl_script
12708
12709 perldepend (o)
12710
12711 perm_rw (o)
12712
12713 perm_rwx (o)
12714
12715 pm_to_blib
12716
12717 post_constants (o)
12718
12719 post_initialize (o)
12720
12721 postamble (o)
12722
12723 ppd
12724
12725 prefixify
12726
12727 processPL (o)
12728
12729 quote_paren
12730
12731 realclean (o)
12732
12733 replace_manpage_separator
12734
12735 static (o)
12736
12737 static_lib (o)
12738
12739 staticmake (o)
12740
12741 subdir_x (o)
12742
12743 subdirs (o)
12744
12745 test (o)
12746
12747 test_via_harness (override)
12748
12749 test_via_script (override)
12750
12751 tool_autosplit (o)
12752
12753 tools_other (o)
12754
12755 tool_xsubpp (o)
12756
12757 top_targets (o)
12758
12759 writedoc
12760
12761 xs_c (o)
12762
12763 xs_cpp (o)
12764
12765 xs_o (o)
12766
12767 perl_archive
12768
12769 perl_archive_after
12770
12771 export_list
12772
12773 =over 4
12774
12775 =item SEE ALSO
12776
12777 =back
12778
12779 =head2 ExtUtils::MM_VMS - methods to override UN*X behaviour in
12780 ExtUtils::MakeMaker
12781
12782 =over 4
12783
12784 =item SYNOPSIS
12785
12786 =item DESCRIPTION
12787
12788 =over 4
12789
12790 =item Methods always loaded
12791
12792 wraplist
12793
12794 =back
12795
12796 =back
12797
12798 =over 4
12799
12800 =item Methods
12801
12802 guess_name (override)
12803
12804 =back
12805
12806 find_perl (override)
12807
12808 maybe_command (override)
12809
12810 maybe_command_in_dirs (override)
12811
12812 perl_script (override)
12813
12814 replace_manpage_separator
12815
12816 init_main (override)
12817
12818 init_others (override)
12819
12820 constants (override)
12821
12822 cflags (override)
12823
12824 const_cccmd (override)
12825
12826 pm_to_blib (override)
12827
12828 tool_autosplit (override)
12829
12830 tool_sxubpp (override)
12831
12832 xsubpp_version (override)
12833
12834 tools_other (override)
12835
12836 dist (override)
12837
12838 c_o (override)
12839
12840 xs_c (override)
12841
12842 xs_o (override)
12843
12844 top_targets (override)
12845
12846 dlsyms (override)
12847
12848 dynamic_lib (override)
12849
12850 dynamic_bs (override)
12851
12852 static_lib (override)
12853
12854 manifypods (override)
12855
12856 processPL (override)
12857
12858 installbin (override)
12859
12860 subdir_x (override)
12861
12862 clean (override)
12863
12864 realclean (override)
12865
12866 dist_core (override)
12867
12868 dist_test (override)
12869
12870 install (override)
12871
12872 perldepend (override)
12873
12874 makefile (override)
12875
12876 find_tests (override)
12877
12878 test (override)
12879
12880 makeaperl (override)
12881
12882 nicetext (override)
12883
12884 prefixify (override)
12885
12886 =head2 ExtUtils::MM_Win32 - methods to override UN*X behaviour in
12887 ExtUtils::MakeMaker
12888
12889 =over 4
12890
12891 =item SYNOPSIS
12892
12893 =item DESCRIPTION
12894
12895 =back
12896
12897 constants (o)
12898
12899 static_lib (o)
12900
12901 dynamic_bs (o)
12902
12903 dynamic_lib (o)
12904
12905 perl_script
12906
12907 pm_to_blib
12908
12909 tool_autosplit (override)
12910
12911 tools_other (o)
12912
12913 xs_o (o)
12914
12915 top_targets (o)
12916
12917 manifypods (o)
12918
12919 dist_ci (o)
12920
12921 dist_core (o)
12922
12923 pasthru (o)
12924
12925 =head2 ExtUtils::MM_Win95 - method to customize MakeMaker for Win9X
12926
12927 =over 4
12928
12929 =item SYNOPSIS
12930
12931 =item DESCRIPTION
12932
12933 =back
12934
12935 =head2 ExtUtils::MY - ExtUtils::MakeMaker subclass for customization
12936
12937 =over 4
12938
12939 =item SYNOPSIS
12940
12941 =item DESCRIPTION
12942
12943 =back
12944
12945 =head2 ExtUtils::MakeMaker - create an extension Makefile
12946
12947 =over 4
12948
12949 =item SYNOPSIS
12950
12951 =item DESCRIPTION
12952
12953 =over 4
12954
12955 =item How To Write A Makefile.PL
12956
12957 =item Default Makefile Behaviour
12958
12959 =item make test
12960
12961 =item make testdb
12962
12963 =item make install
12964
12965 =item PREFIX and LIB attribute
12966
12967 =item AFS users
12968
12969 =item Static Linking of a new Perl Binary
12970
12971 =item Determination of Perl Library and Installation Locations
12972
12973 =item Which architecture dependent directory?
12974
12975 =item Using Attributes and Parameters
12976
12977 ABSTRACT, ABSTRACT_FROM, AUTHOR, BINARY_LOCATION, C, CCFLAGS, CONFIG,
12978 CONFIGURE, DEFINE, DIR, DISTNAME, DL_FUNCS, DL_VARS, EXCLUDE_EXT,
12979 EXE_FILES, FIRST_MAKEFILE, FULLPERL, FULLPERLRUN, FULLPERLRUNINST,
12980 FUNCLIST, H, IMPORTS, INC, INCLUDE_EXT, INSTALLARCHLIB, INSTALLBIN,
12981 INSTALLDIRS, INSTALLMAN1DIR, INSTALLMAN3DIR, INSTALLPRIVLIB, INSTALLSCRIPT,
12982 INSTALLSITEARCH, INSTALLSITEBIN, INSTALLSITELIB, INSTALLSITEMAN1DIR,
12983 INSTALLSITEMAN3DIR, INSTALLVENDORARCH, INSTALLVENDORBIN, INSTALLVENDORLIB,
12984 INSTALLVENDORMAN1DIR, INSTALLVENDORMAN3DIR, INST_ARCHLIB, INST_BIN,
12985 INST_LIB, INST_MAN1DIR, INST_MAN3DIR, INST_SCRIPT, LDDLFLAGS, LDFROM, LIB,
12986 LIBPERL_A, LIBS, LINKTYPE, MAKEAPERL, MAKEFILE, MAN1PODS, MAN3PODS,
12987 MAP_TARGET, MYEXTLIB, NAME, NEEDS_LINKING, NOECHO, NORECURS, NO_VC, OBJECT,
12988 OPTIMIZE, PERL, PERL_CORE, PERLMAINCC, PERL_ARCHLIB, PERL_LIB,
12989 PERL_MALLOC_OK, PERLRUN, PERLRUNINST, PERL_SRC, PERM_RW, PERM_RWX,
12990 PL_FILES, PM, PMLIBDIRS, PM_FILTER, POLLUTE, PPM_INSTALL_EXEC,
12991 PPM_INSTALL_SCRIPT, PREFIX, PREREQ_FATAL, PREREQ_PM, PREREQ_PRINT,
12992 PRINT_PREREQ, SITEPREFIX, SKIP, TYPEMAPS, VENDORPREFIX, VERBINST, VERSION,
12993 VERSION_FROM, XS, XSOPT, XSPROTOARG, XS_VERSION
12994
12995 =item Additional lowercase attributes
12996
12997 clean, depend, dist, dynamic_lib, linkext, macro, realclean, test,
12998 tool_autosplit
12999
13000 =item Overriding MakeMaker Methods
13001
13002 =item The End Of Cargo Cult Programming
13003
13004 C<<MAN3PODS => ' '>>
13005
13006 =item Hintsfile support
13007
13008 =item Distribution Support
13009
13010    make distcheck,    make skipcheck,    make distclean,    make manifest,
13011   make distdir,   make disttest,    make tardist,    make dist,    make
13012 uutardist,    make shdist,    make zipdist,    make ci
13013
13014 =item Disabling an extension
13015
13016 =back
13017
13018 =item ENVIRONMENT
13019
13020 PERL_MM_OPT, PERL_MM_USE_DEFAULT
13021
13022 =item SEE ALSO
13023
13024 =item AUTHORS
13025
13026 =back
13027
13028 =head2 ExtUtils::Manifest - utilities to write and check a MANIFEST file
13029
13030 =over 4
13031
13032 =item SYNOPSIS
13033
13034 =item DESCRIPTION
13035
13036 =item MANIFEST.SKIP
13037
13038 =item EXPORT_OK
13039
13040 =item GLOBAL VARIABLES
13041
13042 =item DIAGNOSTICS
13043
13044 C<Not in MANIFEST:> I<file>, C<Skipping> I<file>, C<No such file:> I<file>,
13045 C<MANIFEST:> I<$!>, C<Added to MANIFEST:> I<file>
13046
13047 =item ENVIRONMENT
13048
13049 B<PERL_MM_MANIFEST_DEBUG>
13050
13051 =item SEE ALSO
13052
13053 =item AUTHOR
13054
13055 =back
13056
13057 =head2 ExtUtils::Miniperl, writemain - write the C code for perlmain.c
13058
13059 =over 4
13060
13061 =item SYNOPSIS
13062
13063 =item DESCRIPTION
13064
13065 =item SEE ALSO
13066
13067 =back
13068
13069 =head2 ExtUtils::Mkbootstrap - make a bootstrap file for use by DynaLoader
13070
13071 =over 4
13072
13073 =item SYNOPSIS
13074
13075 =item DESCRIPTION
13076
13077 =back
13078
13079 =head2 ExtUtils::Mksymlists - write linker options files for dynamic
13080 extension
13081
13082 =over 4
13083
13084 =item SYNOPSIS
13085
13086 =item DESCRIPTION
13087
13088 DLBASE, DL_FUNCS, DL_VARS, FILE, FUNCLIST, IMPORTS, NAME
13089
13090 =item AUTHOR
13091
13092 =item REVISION
13093
13094 =back
13095
13096 =head2 ExtUtils::Packlist - manage .packlist files
13097
13098 =over 4
13099
13100 =item SYNOPSIS
13101
13102 =item DESCRIPTION
13103
13104 =item USAGE
13105
13106 =item FUNCTIONS
13107
13108 new(), read(), write(), validate(), packlist_file()
13109
13110 =item EXAMPLE
13111
13112 =item AUTHOR
13113
13114 =back
13115
13116 =head2 ExtUtils::testlib - add blib/* directories to @INC
13117
13118 =over 4
13119
13120 =item SYNOPSIS
13121
13122 =item DESCRIPTION
13123
13124 =back
13125
13126 =head2 Fatal - replace functions with equivalents which succeed or die
13127
13128 =over 4
13129
13130 =item SYNOPSIS
13131
13132 =item DESCRIPTION
13133
13134 =item AUTHOR
13135
13136 =back
13137
13138 =head2 Fcntl - load the C Fcntl.h defines
13139
13140 =over 4
13141
13142 =item SYNOPSIS
13143
13144 =item DESCRIPTION
13145
13146 =item NOTE
13147
13148 =item EXPORTED SYMBOLS
13149
13150 =back
13151
13152 =head2 File::Basename, fileparse - split a pathname into pieces
13153
13154 =over 4
13155
13156 =item SYNOPSIS
13157
13158 =item DESCRIPTION
13159
13160 fileparse_set_fstype, fileparse
13161
13162 =item EXAMPLES
13163
13164 C<basename>, C<dirname>
13165
13166 =back
13167
13168 =head2 File::CheckTree, validate - run many filetest checks on a tree
13169
13170 =over 4
13171
13172 =item SYNOPSIS
13173
13174 =item DESCRIPTION
13175
13176 =item AUTHOR
13177
13178 =item HISTORY
13179
13180 =back
13181
13182 =head2 File::Compare - Compare files or filehandles
13183
13184 =over 4
13185
13186 =item SYNOPSIS
13187
13188 =item DESCRIPTION
13189
13190 =item RETURN
13191
13192 =item AUTHOR
13193
13194 =back
13195
13196 =head2 File::Copy - Copy files or filehandles
13197
13198 =over 4
13199
13200 =item SYNOPSIS
13201
13202 =item DESCRIPTION
13203
13204 =over 4
13205
13206 =item Special behaviour if C<syscopy> is defined (OS/2, VMS and Win32)
13207
13208 rmscopy($from,$to[,$date_flag])
13209
13210 =back
13211
13212 =item RETURN
13213
13214 =item NOTES
13215
13216 =item AUTHOR
13217
13218 =back
13219
13220 =head2 File::DosGlob - DOS like globbing and then some
13221
13222 =over 4
13223
13224 =item SYNOPSIS
13225
13226 =item DESCRIPTION
13227
13228 =item NOTES
13229
13230 =item EXPORTS (by request only)
13231
13232 =item BUGS
13233
13234 =item AUTHOR
13235
13236 =item HISTORY
13237
13238 =item SEE ALSO
13239
13240 =back
13241
13242 =head2 File::Find - Traverse a directory tree.
13243
13244 =over 4
13245
13246 =item SYNOPSIS
13247
13248 =item DESCRIPTION
13249
13250 B<find>, B<finddepth>
13251
13252 =over 4
13253
13254 =item %options
13255
13256 C<wanted>, C<bydepth>, C<preprocess>, C<postprocess>, C<follow>,
13257 C<follow_fast>, C<follow_skip>, C<dangling_symlinks>, C<no_chdir>,
13258 C<untaint>, C<untaint_pattern>, C<untaint_skip>
13259
13260 =item The wanted function
13261
13262 C<$File::Find::dir> is the current directory name,, C<$_> is the current
13263 filename within that directory, C<$File::Find::name> is the complete
13264 pathname to the file
13265
13266 =back
13267
13268 =item WARNINGS
13269
13270 =item CAVEAT
13271
13272 $dont_use_nlink, symlinks
13273
13274 =item NOTES
13275
13276 =item HISTORY
13277
13278 =back
13279
13280 =head2 File::Glob - Perl extension for BSD glob routine
13281
13282 =over 4
13283
13284 =item SYNOPSIS
13285
13286 =item DESCRIPTION
13287
13288 C<GLOB_ERR>, C<GLOB_LIMIT>, C<GLOB_MARK>, C<GLOB_NOCASE>, C<GLOB_NOCHECK>,
13289 C<GLOB_NOSORT>, C<GLOB_BRACE>, C<GLOB_NOMAGIC>, C<GLOB_QUOTE>,
13290 C<GLOB_TILDE>, C<GLOB_CSH>, C<GLOB_ALPHASORT>
13291
13292 =item DIAGNOSTICS
13293
13294 C<GLOB_NOSPACE>, C<GLOB_ABEND>
13295
13296 =item NOTES
13297
13298 =item AUTHOR
13299
13300 =back
13301
13302 =head2 File::Path - create or remove directory trees
13303
13304 =over 4
13305
13306 =item SYNOPSIS
13307
13308 =item DESCRIPTION
13309
13310 =item AUTHORS
13311
13312 =back
13313
13314 =head2 File::Spec - portably perform operations on file names
13315
13316 =over 4
13317
13318 =item SYNOPSIS
13319
13320 =item DESCRIPTION
13321
13322 =item METHODS
13323
13324 canonpath, catdir, catfile, curdir, devnull, rootdir, tmpdir, updir,
13325 no_upwards, case_tolerant, file_name_is_absolute, path, join, splitpath,
13326 splitdir, catpath(), abs2rel, rel2abs()
13327
13328 =item SEE ALSO
13329
13330 =item AUTHORS
13331
13332 =back
13333
13334 =head2 File::Spec::Cygwin - methods for Cygwin file specs
13335
13336 =over 4
13337
13338 =item SYNOPSIS
13339
13340 =item DESCRIPTION
13341
13342 =back
13343
13344 =head2 File::Spec::Epoc - methods for Epoc file specs
13345
13346 =over 4
13347
13348 =item SYNOPSIS
13349
13350 =item DESCRIPTION
13351
13352 canonpath()
13353
13354 =back
13355
13356 =over 4
13357
13358 =item SEE ALSO
13359
13360 =back
13361
13362 =head2 File::Spec::Functions - portably perform operations on file names
13363
13364 =over 4
13365
13366 =item SYNOPSIS
13367
13368 =item DESCRIPTION
13369
13370 =over 4
13371
13372 =item Exports
13373
13374 =back
13375
13376 =item SEE ALSO
13377
13378 =back
13379
13380 =head2 File::Spec::Mac - File::Spec for Mac OS (Classic)
13381
13382 =over 4
13383
13384 =item SYNOPSIS
13385
13386 =item DESCRIPTION
13387
13388 =item METHODS
13389
13390 canonpath
13391
13392 =back
13393
13394 catdir()
13395
13396 catfile
13397
13398 curdir
13399
13400 devnull
13401
13402 rootdir
13403
13404 tmpdir
13405
13406 updir
13407
13408 file_name_is_absolute
13409
13410 path
13411
13412 splitpath
13413
13414 splitdir
13415
13416 catpath
13417
13418 abs2rel
13419
13420 rel2abs
13421
13422 =over 4
13423
13424 =item AUTHORS
13425
13426 =item SEE ALSO
13427
13428 =back
13429
13430 canonpath
13431
13432 splitpath
13433
13434 splitdir
13435
13436 catpath
13437
13438 =head2 File::Spec::OS2 - methods for OS/2 file specs
13439
13440 =over 4
13441
13442 =item SYNOPSIS
13443
13444 =item DESCRIPTION
13445
13446 =back
13447
13448 =head2 File::Spec::Unix - File::Spec for Unix, base for other File::Spec
13449 modules
13450
13451 =over 4
13452
13453 =item SYNOPSIS
13454
13455 =item DESCRIPTION
13456
13457 =item METHODS
13458
13459 canonpath()
13460
13461 =back
13462
13463 catdir()
13464
13465 catfile
13466
13467 curdir
13468
13469 devnull
13470
13471 rootdir
13472
13473 tmpdir
13474
13475 updir
13476
13477 no_upwards
13478
13479 case_tolerant
13480
13481 file_name_is_absolute
13482
13483 path
13484
13485 join
13486
13487 splitpath
13488
13489 splitdir
13490
13491 catpath()
13492
13493 abs2rel
13494
13495 rel2abs()
13496
13497 =over 4
13498
13499 =item SEE ALSO
13500
13501 =back
13502
13503 =head2 File::Spec::VMS - methods for VMS file specs
13504
13505 =over 4
13506
13507 =item SYNOPSIS
13508
13509 =item DESCRIPTION
13510
13511 eliminate_macros
13512
13513 =back
13514
13515 fixpath
13516
13517 =over 4
13518
13519 =item Methods always loaded
13520
13521 canonpath (override)
13522
13523 =back
13524
13525 catdir
13526
13527 catfile
13528
13529 curdir (override)
13530
13531 devnull (override)
13532
13533 rootdir (override)
13534
13535 tmpdir (override)
13536
13537 updir (override)
13538
13539 case_tolerant (override)
13540
13541 path (override)
13542
13543 file_name_is_absolute (override)
13544
13545 splitpath (override)
13546
13547 splitdir (override)
13548
13549 catpath (override)
13550
13551 abs2rel (override)
13552
13553 rel2abs (override)
13554
13555 =over 4
13556
13557 =item SEE ALSO
13558
13559 =back
13560
13561 =head2 File::Spec::Win32 - methods for Win32 file specs
13562
13563 =over 4
13564
13565 =item SYNOPSIS
13566
13567 =item DESCRIPTION
13568
13569 devnull
13570
13571 =back
13572
13573 tmpdir
13574
13575 catfile
13576
13577 canonpath
13578
13579 splitpath
13580
13581 splitdir
13582
13583 catpath
13584
13585 =over 4
13586
13587 =item Note For File::Spec::Win32 Maintainers
13588
13589 =back
13590
13591 =over 4
13592
13593 =item SEE ALSO
13594
13595 =back
13596
13597 =head2 File::Temp - return name and handle of a temporary file safely
13598
13599 =over 4
13600
13601 =item PORTABILITY
13602
13603 =item SYNOPSIS
13604
13605 =item DESCRIPTION
13606
13607 =back
13608
13609 =over 4
13610
13611 =item FUNCTIONS
13612
13613 B<tempfile>
13614
13615 =back
13616
13617 B<tempdir>
13618
13619 =over 4
13620
13621 =item MKTEMP FUNCTIONS
13622
13623 B<mkstemp>
13624
13625 =back
13626
13627 B<mkstemps>
13628
13629 B<mkdtemp>
13630
13631 B<mktemp>
13632
13633 =over 4
13634
13635 =item POSIX FUNCTIONS
13636
13637 B<tmpnam>
13638
13639 =back
13640
13641 B<tmpfile>
13642
13643 =over 4
13644
13645 =item ADDITIONAL FUNCTIONS
13646
13647 B<tempnam>
13648
13649 =back
13650
13651 =over 4
13652
13653 =item UTILITY FUNCTIONS
13654
13655 B<unlink0>
13656
13657 =back
13658
13659 =over 4
13660
13661 =item PACKAGE VARIABLES
13662
13663 B<safe_level>, STANDARD, MEDIUM, HIGH
13664
13665 =back
13666
13667 TopSystemUID
13668
13669 =over 4
13670
13671 =item WARNING
13672
13673 =over 4
13674
13675 =item Temporary files and NFS
13676
13677 =back
13678
13679 =item HISTORY
13680
13681 =item SEE ALSO
13682
13683 =item AUTHOR
13684
13685 =back
13686
13687 =head2 File::stat - by-name interface to Perl's built-in stat() functions
13688
13689 =over 4
13690
13691 =item SYNOPSIS
13692
13693 =item DESCRIPTION
13694
13695 =item NOTE
13696
13697 =item AUTHOR
13698
13699 =back
13700
13701 =head2 FileCache - keep more files open than the system permits
13702
13703 =over 4
13704
13705 =item SYNOPSIS
13706
13707 =item DESCRIPTION
13708
13709 cacheout EXPR, cacheout MODE, EXPR
13710
13711 =item CAVEATS
13712
13713 =item BUGS
13714
13715 =back
13716
13717 =head2 FileHandle - supply object methods for filehandles
13718
13719 =over 4
13720
13721 =item SYNOPSIS
13722
13723 =item DESCRIPTION
13724
13725 $fh->print, $fh->printf, $fh->getline, $fh->getlines
13726
13727 =item SEE ALSO
13728
13729 =back
13730
13731 =head2 Filter::Simple - Simplified source filtering
13732
13733 =over 4
13734
13735 =item SYNOPSIS
13736
13737 =item DESCRIPTION
13738
13739 =over 4
13740
13741 =item The Problem
13742
13743 =item A Solution
13744
13745 =item Disabling or changing <no> behaviour
13746
13747 =item All-in-one interface
13748
13749 =item Filtering only specific components of source code
13750
13751 C<"code">, C<"executable">, C<"quotelike">, C<"string">, C<"regex">,
13752 C<"all">
13753
13754 =item Filtering only the code parts of source code
13755
13756 Most source code ceases to be grammatically correct when it is broken up
13757 into the pieces between string literals and regexes. So the C<'code'>
13758 component filter behaves slightly differently from the other partial
13759 filters
13760 described in the previous section.
13761
13762 =item Using Filter::Simple with an explicit C<import> subroutine
13763
13764 =item Using Filter::Simple and Exporter together
13765
13766 =item How it works
13767
13768 =back
13769
13770 =item AUTHOR
13771
13772 =item COPYRIGHT
13773
13774 =back
13775
13776 =head2 Filter::Util::Call - Perl Source Filter Utility Module
13777
13778 =over 4
13779
13780 =item SYNOPSIS
13781
13782 =item DESCRIPTION
13783
13784 =over 4
13785
13786 =item B<use Filter::Util::Call>
13787
13788 =item B<import()>
13789
13790 =item B<filter() and anonymous sub>
13791
13792 B<$_>, B<$status>, B<filter_read> and B<filter_read_exact>, B<filter_del>
13793
13794 =back
13795
13796 =item EXAMPLES
13797
13798 =over 4
13799
13800 =item Example 1: A simple filter.
13801
13802 =item Example 2: Using the context
13803
13804 =item Example 3: Using the context within the filter
13805
13806 =item Example 4: Using filter_del
13807
13808 =back
13809
13810 =item Filter::Simple
13811
13812 =item AUTHOR
13813
13814 =item DATE
13815
13816 =back
13817
13818 =head2 FindBin - Locate directory of original perl script
13819
13820 =over 4
13821
13822 =item SYNOPSIS
13823
13824 =item DESCRIPTION
13825
13826 =item EXPORTABLE VARIABLES
13827
13828 =item KNOWN ISSUES
13829
13830 =item KNOWN BUGS
13831
13832 =item AUTHORS
13833
13834 =item COPYRIGHT
13835
13836 =back
13837
13838 =head2 GDBM_File - Perl5 access to the gdbm library.
13839
13840 =over 4
13841
13842 =item SYNOPSIS
13843
13844 =item DESCRIPTION
13845
13846 =item AVAILABILITY
13847
13848 =item BUGS
13849
13850 =item SEE ALSO
13851
13852 =back
13853
13854 =head2 Getopt::Long - Extended processing of command line options
13855
13856 =over 4
13857
13858 =item SYNOPSIS
13859
13860 =item DESCRIPTION
13861
13862 =item Command Line Options, an Introduction
13863
13864 =item Getting Started with Getopt::Long
13865
13866 =over 4
13867
13868 =item Simple options
13869
13870 =item A little bit less simple options
13871
13872 =item Mixing command line option with other arguments
13873
13874 =item Options with values
13875
13876 =item Options with multiple values
13877
13878 =item Options with hash values
13879
13880 =item User-defined subroutines to handle options
13881
13882 =item Options with multiple names
13883
13884 =item Case and abbreviations
13885
13886 =item Summary of Option Specifications
13887
13888 !, +, s, i, o, f, : I<type> [ I<desttype> ], : I<number> [ I<desttype> ], :
13889 + [ I<desttype> ]
13890
13891 =back
13892
13893 =item Advanced Possibilities
13894
13895 =over 4
13896
13897 =item Object oriented interface
13898
13899 =item Thread Safety
13900
13901 =item Documentation and help texts
13902
13903 =item Storing options in a hash
13904
13905 =item Bundling
13906
13907 =item The lonesome dash
13908
13909 =item Argument callback
13910
13911 =back
13912
13913 =item Configuring Getopt::Long
13914
13915 default, posix_default, auto_abbrev, getopt_compat, gnu_compat, gnu_getopt,
13916 require_order, permute, bundling (default: disabled), bundling_override
13917 (default: disabled), ignore_case  (default: enabled), ignore_case_always
13918 (default: disabled), pass_through (default: disabled), prefix,
13919 prefix_pattern, debug (default: disabled)
13920
13921 =item Return values and Errors
13922
13923 =item Legacy
13924
13925 =over 4
13926
13927 =item Default destinations
13928
13929 =item Alternative option starters
13930
13931 =item Configuration variables
13932
13933 =back
13934
13935 =item Trouble Shooting
13936
13937 =over 4
13938
13939 =item Warning: Ignoring '!' modifier for short option
13940
13941 =item GetOptions does not return a false result when an option is not
13942 supplied
13943
13944 =item GetOptions does not split the command line correctly
13945
13946 =item How do I put a "-?" option into a Getopt::Long?
13947
13948 =back
13949
13950 =item AUTHOR
13951
13952 =item COPYRIGHT AND DISCLAIMER
13953
13954 =back
13955
13956 =head2 Getopt::Std, getopt - Process single-character switches with switch
13957 clustering
13958
13959 =over 4
13960
13961 =item SYNOPSIS
13962
13963 =item DESCRIPTION
13964
13965 =back
13966
13967 =head2 Hash::Util - A selection of general-utility hash subroutines
13968
13969 =over 4
13970
13971 =item SYNOPSIS
13972
13973 =item DESCRIPTION
13974
13975 =over 4
13976
13977 =item Restricted hashes
13978
13979 lock_keys, unlock_keys
13980
13981 =back
13982
13983 =back
13984
13985 lock_value, unlock_value
13986
13987 B<lock_hash>, B<unlock_hash>
13988
13989 =over 4
13990
13991 =item AUTHOR
13992
13993 =item SEE ALSO
13994
13995 =back
13996
13997 =head2 I18N::Collate - compare 8-bit scalar data according to the current
13998 locale
13999
14000 =over 4
14001
14002 =item SYNOPSIS
14003
14004 =item DESCRIPTION
14005
14006 =back
14007
14008 =head2 I18N::LangTags - functions for dealing with RFC3066-style language
14009 tags
14010
14011 =over 4
14012
14013 =item SYNOPSIS
14014
14015 =item DESCRIPTION
14016
14017 =back
14018
14019 the function is_language_tag($lang1)
14020
14021 the function extract_language_tags($whatever)
14022
14023 the function same_language_tag($lang1, $lang2)
14024
14025 the function similarity_language_tag($lang1, $lang2)
14026
14027 the function is_dialect_of($lang1, $lang2)
14028
14029 the function super_languages($lang1)
14030
14031 the function locale2language_tag($locale_identifier)
14032
14033 the function encode_language_tag($lang1)
14034
14035 the function alternate_language_tags($lang1)
14036
14037 the function @langs = panic_languages(@accept_languages)
14038
14039 =over 4
14040
14041 =item ABOUT LOWERCASING
14042
14043 =item ABOUT UNICODE PLAINTEXT LANGUAGE TAGS
14044
14045 =item SEE ALSO
14046
14047 =item COPYRIGHT
14048
14049 =item AUTHOR
14050
14051 =back
14052
14053 =head2 I18N::LangTags::List -- tags and names for human languages
14054
14055 =over 4
14056
14057 =item SYNOPSIS
14058
14059 =item DESCRIPTION
14060
14061 =item ABOUT LANGUAGE TAGS
14062
14063 =item LIST OF LANGUAGES
14064
14065 {ab} : Abkhazian, {ace} : Achinese, {ach} : Acoli, {ada} : Adangme, {aa} :
14066 Afar, {afh} : Afrihili, {af} : Afrikaans, [{afa} : Afro-Asiatic (Other)],
14067 {aka} : Akan, {akk} : Akkadian, {sq} : Albanian, {ale} : Aleut, [{alg} :
14068 Algonquian languages], [{tut} : Altaic (Other)], {am} : Amharic, {i-ami} :
14069 Ami, [{apa} : Apache languages], {ar} : Arabic, {arc} : Aramaic, {arp} :
14070 Arapaho, {arn} : Araucanian, {arw} : Arawak, {hy} : Armenian, [{art} :
14071 Artificial (Other)], {as} : Assamese, [{ath} : Athapascan languages],
14072 [{aus} : Australian languages], [{map} : Austronesian (Other)], {ava} :
14073 Avaric, {ae} : Avestan, {awa} : Awadhi, {ay} : Aymara, {az} : Azerbaijani,
14074 {ban} : Balinese, [{bat} : Baltic (Other)], {bal} : Baluchi, {bam} :
14075 Bambara, [{bai} : Bamileke languages], {bad} : Banda, [{bnt} : Bantu
14076 (Other)], {bas} : Basa, {ba} : Bashkir, {eu} : Basque, {btk} : Batak
14077 (Indonesia), {bej} : Beja, {be} : Belarusian, {bem} : Bemba, {bn} :
14078 Bengali, [{ber} : Berber (Other)], {bho} : Bhojpuri, {bh} : Bihari, {bik} :
14079 Bikol, {bin} : Bini, {bi} : Bislama, {bs} : Bosnian, {bra} : Braj, {br} :
14080 Breton, {bug} : Buginese, {bg} : Bulgarian, {i-bnn} : Bunun, {bua} :
14081 Buriat, {my} : Burmese, {cad} : Caddo, {car} : Carib, {ca} : Catalan,
14082 [{cau} : Caucasian (Other)], {ceb} : Cebuano, [{cel} : Celtic (Other)],
14083 [{cai} : Central American Indian (Other)], {chg} : Chagatai, [{cmc} :
14084 Chamic languages], {ch} : Chamorro, {ce} : Chechen, {chr} : Cherokee, {chy}
14085 : Cheyenne, {chb} : Chibcha, {ny} : Chichewa, {zh} : Chinese, {chn} :
14086 Chinook Jargon, {chp} : Chipewyan, {cho} : Choctaw, {cu} : Church Slavic,
14087 {chk} : Chuukese, {cv} : Chuvash, {cop} : Coptic, {kw} : Cornish, {co} :
14088 Corsican, {cre} : Cree, {mus} : Creek, [{cpe} : English-based Creoles and
14089 pidgins (Other)], [{cpf} : French-based Creoles and pidgins (Other)],
14090 [{cpp} : Portuguese-based Creoles and pidgins (Other)], [{crp} : Creoles
14091 and pidgins (Other)], {hr} : Croatian, [{cus} : Cushitic (Other)], {cs} :
14092 Czech, {dak} : Dakota, {da} : Danish, {day} : Dayak, {i-default} : Default
14093 (Fallthru) Language, {del} : Delaware, {din} : Dinka, {div} : Divehi, {doi}
14094 : Dogri, {dgr} : Dogrib, [{dra} : Dravidian (Other)], {dua} : Duala, {nl} :
14095 Dutch, {dum} : Middle Dutch (ca.1050-1350), {dyu} : Dyula, {dz} : Dzongkha,
14096 {efi} : Efik, {egy} : Ancient Egyptian, {eka} : Ekajuk, {elx} : Elamite,
14097 {en} : English, {enm} : Old English (1100-1500), {ang} : Old English
14098 (ca.450-1100), {eo} : Esperanto, {et} : Estonian, {ewe} : Ewe, {ewo} :
14099 Ewondo, {fan} : Fang, {fat} : Fanti, {fo} : Faroese, {fj} : Fijian, {fi} :
14100 Finnish, [{fiu} : Finno-Ugrian (Other)], {fon} : Fon, {fr} : French, {frm}
14101 : Middle French (ca.1400-1600), {fro} : Old French (842-ca.1400), {fy} :
14102 Frisian, {fur} : Friulian, {ful} : Fulah, {gaa} : Ga, {gd} : Scots Gaelic,
14103 {gl} : Gallegan, {lug} : Ganda, {gay} : Gayo, {gba} : Gbaya, {gez} : Geez,
14104 {ka} : Georgian, {de} : German, {gmh} : Middle High German (ca.1050-1500),
14105 {goh} : Old High German (ca.750-1050), [{gem} : Germanic (Other)], {gil} :
14106 Gilbertese, {gon} : Gondi, {gor} : Gorontalo, {got} : Gothic, {grb} :
14107 Grebo, {grc} : Ancient Greek, {el} : Modern Greek, {gn} : Guarani, {gu} :
14108 Gujarati, {gwi} : Gwich'in, {hai} : Haida, {ha} : Hausa, {haw} : Hawaiian,
14109 {he} : Hebrew, {hz} : Herero, {hil} : Hiligaynon, {him} : Himachali, {hi} :
14110 Hindi, {ho} : Hiri Motu, {hit} : Hittite, {hmn} : Hmong, {hu} : Hungarian,
14111 {hup} : Hupa, {iba} : Iban, {is} : Icelandic, {ibo} : Igbo, {ijo} : Ijo,
14112 {ilo} : Iloko, [{inc} : Indic (Other)], [{ine} : Indo-European (Other)],
14113 {id} : Indonesian, {ia} : Interlingua (International Auxiliary Language
14114 Association), {ie} : Interlingue, {iu} : Inuktitut, {ik} : Inupiaq, [{ira}
14115 : Iranian (Other)], {ga} : Irish, {mga} : Middle Irish (900-1200), {sga} :
14116 Old Irish (to 900), [{iro} : Iroquoian languages], {it} : Italian, {ja} :
14117 Japanese, {jw} : Javanese, {jrb} : Judeo-Arabic, {jpr} : Judeo-Persian,
14118 {kab} : Kabyle, {kac} : Kachin, {kl} : Kalaallisut, {kam} : Kamba, {kn} :
14119 Kannada, {kau} : Kanuri, {kaa} : Kara-Kalpak, {kar} : Karen, {ks} :
14120 Kashmiri, {kaw} : Kawi, {kk} : Kazakh, {kha} : Khasi, {km} : Khmer, [{khi}
14121 : Khoisan (Other)], {kho} : Khotanese, {ki} : Kikuyu, {kmb} : Kimbundu,
14122 {rw} : Kinyarwanda, {ky} : Kirghiz, {i-klingon} : Klingon, {kv} : Komi,
14123 {kon} : Kongo, {kok} : Konkani, {ko} : Korean, {kos} : Kosraean, {kpe} :
14124 Kpelle, {kro} : Kru, {kj} : Kuanyama, {kum} : Kumyk, {ku} : Kurdish, {kru}
14125 : Kurukh, {kut} : Kutenai, {lad} : Ladino, {lah} : Lahnda, {lam} : Lamba,
14126 {lo} : Lao, {la} : Latin, {lv} : Latvian, {lb} : Letzeburgesch, {lez} :
14127 Lezghian, {ln} : Lingala, {lt} : Lithuanian, {nds} : Low German, {loz} :
14128 Lozi, {lub} : Luba-Katanga, {lua} : Luba-Lulua, {lui} : Luiseno, {lun} :
14129 Lunda, {luo} : Luo (Kenya and Tanzania), {lus} : Lushai, {mk} : Macedonian,
14130 {mad} : Madurese, {mag} : Magahi, {mai} : Maithili, {mak} : Makasar, {mg} :
14131 Malagasy, {ms} : Malay, {ml} : Malayalam, {mt} : Maltese, {mnc} : Manchu,
14132 {mdr} : Mandar, {man} : Mandingo, {mni} : Manipuri, [{mno} : Manobo
14133 languages], {gv} : Manx, {mi} : Maori, {mr} : Marathi, {chm} : Mari, {mh} :
14134 Marshall, {mwr} : Marwari, {mas} : Masai, [{myn} : Mayan languages], {men}
14135 : Mende, {mic} : Micmac, {min} : Minangkabau, {i-mingo} : Mingo, [{mis} :
14136 Miscellaneous languages], {moh} : Mohawk, {mo} : Moldavian, [{mkh} :
14137 Mon-Khmer (Other)], {lol} : Mongo, {mn} : Mongolian, {mos} : Mossi, [{mul}
14138 : Multiple languages], [{mun} : Munda languages], {nah} : Nahuatl, {na} :
14139 Nauru, {nv} : Navajo, {nd} : North Ndebele, {nr} : South Ndebele, {ng} :
14140 Ndonga, {ne} : Nepali, {new} : Newari, {nia} : Nias, [{nic} :
14141 Niger-Kordofanian (Other)], [{ssa} : Nilo-Saharan (Other)], {niu} : Niuean,
14142 {non} : Old Norse, [{nai} : North American Indian], {se} : Northern Sami,
14143 {no} : Norwegian, {nb} : Norwegian Bokmal, {nn} : Norwegian Nynorsk, [{nub}
14144 : Nubian languages], {nym} : Nyamwezi, {nyn} : Nyankole, {nyo} : Nyoro,
14145 {nzi} : Nzima, {oc} : Occitan (post 1500), {oji} : Ojibwa, {or} : Oriya,
14146 {om} : Oromo, {osa} : Osage, {os} : Ossetian; Ossetic, [{oto} : Otomian
14147 languages], {pal} : Pahlavi, {i-pwn} : Paiwan, {pau} : Palauan, {pi} :
14148 Pali, {pam} : Pampanga, {pag} : Pangasinan, {pa} : Panjabi, {pap} :
14149 Papiamento, [{paa} : Papuan (Other)], {fa} : Persian, {peo} : Old Persian
14150 (ca.600-400 B.C.), [{phi} : Philippine (Other)], {phn} : Phoenician, {pon}
14151 : Pohnpeian, {pl} : Polish, {pt} : Portuguese, [{pra} : Prakrit languages],
14152 {pro} : Old Provencal (to 1500), {ps} : Pushto, {qu} : Quechua, {rm} :
14153 Raeto-Romance, {raj} : Rajasthani, {rap} : Rapanui, {rar} : Rarotongan,
14154 [{qaa - qtz} : Reserved for local use.], [{roa} : Romance (Other)], {ro} :
14155 Romanian, {rom} : Romany, {rn} : Rundi, {ru} : Russian, [{sal} : Salishan
14156 languages], {sam} : Samaritan Aramaic, [{smi} : Sami languages (Other)],
14157 {sm} : Samoan, {sad} : Sandawe, {sg} : Sango, {sa} : Sanskrit, {sat} :
14158 Santali, {sc} : Sardinian, {sas} : Sasak, {sco} : Scots, {sel} : Selkup,
14159 [{sem} : Semitic (Other)], {sr} : Serbian, {srr} : Serer, {shn} : Shan,
14160 {sn} : Shona, {sid} : Sidamo, {sgn-...} : Sign Languages, {bla} : Siksika,
14161 {sd} : Sindhi, {si} : Sinhalese, [{sit} : Sino-Tibetan (Other)], [{sio} :
14162 Siouan languages], {den} : Slave (Athapascan), [{sla} : Slavic (Other)],
14163 {sk} : Slovak, {sl} : Slovenian, {sog} : Sogdian, {so} : Somali, {son} :
14164 Songhai, {snk} : Soninke, {wen} : Sorbian languages, {nso} : Northern
14165 Sotho, {st} : Southern Sotho, [{sai} : South American Indian (Other)], {es}
14166 : Spanish, {suk} : Sukuma, {sux} : Sumerian, {su} : Sundanese, {sus} :
14167 Susu, {sw} : Swahili, {ss} : Swati, {sv} : Swedish, {syr} : Syriac, {tl} :
14168 Tagalog, {ty} : Tahitian, [{tai} : Tai (Other)], {tg} : Tajik, {tmh} :
14169 Tamashek, {ta} : Tamil, {i-tao} : Tao, {tt} : Tatar, {i-tay} : Tayal, {te}
14170 : Telugu, {ter} : Tereno, {tet} : Tetum, {th} : Thai, {bo} : Tibetan, {tig}
14171 : Tigre, {ti} : Tigrinya, {tem} : Timne, {tiv} : Tiv, {tli} : Tlingit,
14172 {tpi} : Tok Pisin, {tkl} : Tokelau, {tog} : Tonga (Nyasa), {to} : Tonga
14173 (Tonga Islands), {tsi} : Tsimshian, {ts} : Tsonga, {i-tsu} : Tsou, {tn} :
14174 Tswana, {tum} : Tumbuka, {tr} : Turkish, {ota} : Ottoman Turkish
14175 (1500-1928), {tk} : Turkmen, {tvl} : Tuvalu, {tyv} : Tuvinian, {tw} : Twi,
14176 {uga} : Ugaritic, {ug} : Uighur, {uk} : Ukrainian, {umb} : Umbundu, {und} :
14177 Undetermined, {ur} : Urdu, {uz} : Uzbek, {vai} : Vai, {ven} : Venda, {vi} :
14178 Vietnamese, {vo} : Volapuk, {vot} : Votic, [{wak} : Wakashan languages],
14179 {wal} : Walamo, {war} : Waray, {was} : Washo, {cy} : Welsh, {wo} : Wolof,
14180 {x-...} : Unregistered (Semi-Private Use), {xh} : Xhosa, {sah} : Yakut,
14181 {yao} : Yao, {yap} : Yapese, {yi} : Yiddish, {yo} : Yoruba, [{ypk} : Yupik
14182 languages], {znd} : Zande, [{zap} : Zapotec], {zen} : Zenaga, {za} :
14183 Zhuang, {zu} : Zulu, {zun} : Zuni
14184
14185 =item SEE ALSO
14186
14187 =item COPYRIGHT AND DISCLAIMER
14188
14189 =item AUTHOR
14190
14191 =back
14192
14193 =head2 I18N::Langinfo - query locale information
14194
14195 =over 4
14196
14197 =item SYNOPSIS
14198
14199 =item DESCRIPTION
14200
14201 =over 4
14202
14203 =item EXPORT
14204
14205 =back
14206
14207 =item SEE ALSO
14208
14209 =item AUTHOR
14210
14211 =item COPYRIGHT AND LICENSE
14212
14213 =back
14214
14215 =head2 IO - load various IO modules
14216
14217 =over 4
14218
14219 =item SYNOPSIS
14220
14221 =item DESCRIPTION
14222
14223 =back
14224
14225 =head2 IO::Dir - supply object methods for directory handles
14226
14227 =over 4
14228
14229 =item SYNOPSIS
14230
14231 =item DESCRIPTION
14232
14233 new ( [ DIRNAME ] ), open ( DIRNAME ), read (), seek ( POS ), tell (),
14234 rewind (), close (), tie %hash, IO::Dir, DIRNAME [, OPTIONS ]
14235
14236 =item SEE ALSO
14237
14238 =item AUTHOR
14239
14240 =item COPYRIGHT
14241
14242 =back
14243
14244 =head2 IO::File - supply object methods for filehandles
14245
14246 =over 4
14247
14248 =item SYNOPSIS
14249
14250 =item DESCRIPTION
14251
14252 =item CONSTRUCTOR
14253
14254 new ( FILENAME [,MODE [,PERMS]] ), new_tmpfile
14255
14256 =item METHODS
14257
14258 open( FILENAME [,MODE [,PERMS]] )
14259
14260 =item SEE ALSO
14261
14262 =item HISTORY
14263
14264 =back
14265
14266 =head2 IO::Handle - supply object methods for I/O handles
14267
14268 =over 4
14269
14270 =item SYNOPSIS
14271
14272 =item DESCRIPTION
14273
14274 =item CONSTRUCTOR
14275
14276 new (), new_from_fd ( FD, MODE )
14277
14278 =item METHODS
14279
14280 $io->fdopen ( FD, MODE ), $io->opened, $io->getline, $io->getlines,
14281 $io->ungetc ( ORD ), $io->write ( BUF, LEN [, OFFSET ] ), $io->error,
14282 $io->clearerr, $io->sync, $io->flush, $io->printflush ( ARGS ),
14283 $io->blocking ( [ BOOL ] ), $io->untaint
14284
14285 =item NOTE
14286
14287 =item SEE ALSO
14288
14289 =item BUGS
14290
14291 =item HISTORY
14292
14293 =back
14294
14295 =head2 IO::Pipe - supply object methods for pipes
14296
14297 =over 4
14298
14299 =item SYNOPSIS
14300
14301 =item DESCRIPTION
14302
14303 =item CONSTRUCTOR
14304
14305 new ( [READER, WRITER] )
14306
14307 =item METHODS
14308
14309 reader ([ARGS]), writer ([ARGS]), handles ()
14310
14311 =item SEE ALSO
14312
14313 =item AUTHOR
14314
14315 =item COPYRIGHT
14316
14317 =back
14318
14319 =head2 IO::Poll - Object interface to system poll call
14320
14321 =over 4
14322
14323 =item SYNOPSIS
14324
14325 =item DESCRIPTION
14326
14327 =item METHODS
14328
14329 mask ( IO [, EVENT_MASK ] ), poll ( [ TIMEOUT ] ), events ( IO ), remove (
14330 IO ), handles( [ EVENT_MASK ] )
14331
14332 =item SEE ALSO
14333
14334 =item AUTHOR
14335
14336 =item COPYRIGHT
14337
14338 =back
14339
14340 =head2 IO::Seekable - supply seek based methods for I/O objects
14341
14342 =over 4
14343
14344 =item SYNOPSIS
14345
14346 =item DESCRIPTION
14347
14348 $io->getpos, $io->setpos, $io->seek ( POS, WHENCE ), WHENCE=0 (SEEK_SET),
14349 WHENCE=1 (SEEK_CUR), WHENCE=2 (SEEK_END), $io->sysseek( POS, WHENCE ),
14350 $io->tell
14351
14352 =item SEE ALSO
14353
14354 =item HISTORY
14355
14356 =back
14357
14358 =head2 IO::Select - OO interface to the select system call
14359
14360 =over 4
14361
14362 =item SYNOPSIS
14363
14364 =item DESCRIPTION
14365
14366 =item CONSTRUCTOR
14367
14368 new ( [ HANDLES ] )
14369
14370 =item METHODS
14371
14372 add ( HANDLES ), remove ( HANDLES ), exists ( HANDLE ), handles, can_read (
14373 [ TIMEOUT ] ), can_write ( [ TIMEOUT ] ), has_exception ( [ TIMEOUT ] ),
14374 count (), bits(), select ( READ, WRITE, ERROR [, TIMEOUT ] )
14375
14376 =item EXAMPLE
14377
14378 =item AUTHOR
14379
14380 =item COPYRIGHT
14381
14382 =back
14383
14384 =head2 IO::Socket - Object interface to socket communications
14385
14386 =over 4
14387
14388 =item SYNOPSIS
14389
14390 =item DESCRIPTION
14391
14392 =item CONSTRUCTOR
14393
14394 new ( [ARGS] )
14395
14396 =item METHODS
14397
14398 accept([PKG]), socketpair(DOMAIN, TYPE, PROTOCOL), atmark, connected,
14399 protocol, sockdomain, sockopt(OPT [, VAL]), socktype, timeout([VAL])
14400
14401 =item SEE ALSO
14402
14403 =item AUTHOR
14404
14405 =item COPYRIGHT
14406
14407 =back
14408
14409 =head2 IO::Socket::INET - Object interface for AF_INET domain sockets
14410
14411 =over 4
14412
14413 =item SYNOPSIS
14414
14415 =item DESCRIPTION
14416
14417 =item CONSTRUCTOR
14418
14419 new ( [ARGS] )
14420
14421 =over 4
14422
14423 =item METHODS
14424
14425 sockaddr (), sockport (), sockhost (), peeraddr (), peerport (), peerhost
14426 ()
14427
14428 =back
14429
14430 =item SEE ALSO
14431
14432 =item AUTHOR
14433
14434 =item COPYRIGHT
14435
14436 =back
14437
14438 =head2 IO::Socket::UNIX - Object interface for AF_UNIX domain sockets
14439
14440 =over 4
14441
14442 =item SYNOPSIS
14443
14444 =item DESCRIPTION
14445
14446 =item CONSTRUCTOR
14447
14448 new ( [ARGS] )
14449
14450 =item METHODS
14451
14452 hostpath(), peerpath()
14453
14454 =item SEE ALSO
14455
14456 =item AUTHOR
14457
14458 =item COPYRIGHT
14459
14460 =back
14461
14462 =head2 IO::lib::IO::Dir, IO::Dir - supply object methods for directory
14463 handles
14464
14465 =over 4
14466
14467 =item SYNOPSIS
14468
14469 =item DESCRIPTION
14470
14471 new ( [ DIRNAME ] ), open ( DIRNAME ), read (), seek ( POS ), tell (),
14472 rewind (), close (), tie %hash, IO::Dir, DIRNAME [, OPTIONS ]
14473
14474 =item SEE ALSO
14475
14476 =item AUTHOR
14477
14478 =item COPYRIGHT
14479
14480 =back
14481
14482 =head2 IO::lib::IO::File, IO::File - supply object methods for filehandles
14483
14484 =over 4
14485
14486 =item SYNOPSIS
14487
14488 =item DESCRIPTION
14489
14490 =item CONSTRUCTOR
14491
14492 new ( FILENAME [,MODE [,PERMS]] ), new_tmpfile
14493
14494 =item METHODS
14495
14496 open( FILENAME [,MODE [,PERMS]] )
14497
14498 =item SEE ALSO
14499
14500 =item HISTORY
14501
14502 =back
14503
14504 =head2 IO::lib::IO::Handle, IO::Handle - supply object methods for I/O
14505 handles
14506
14507 =over 4
14508
14509 =item SYNOPSIS
14510
14511 =item DESCRIPTION
14512
14513 =item CONSTRUCTOR
14514
14515 new (), new_from_fd ( FD, MODE )
14516
14517 =item METHODS
14518
14519 $io->fdopen ( FD, MODE ), $io->opened, $io->getline, $io->getlines,
14520 $io->ungetc ( ORD ), $io->write ( BUF, LEN [, OFFSET ] ), $io->error,
14521 $io->clearerr, $io->sync, $io->flush, $io->printflush ( ARGS ),
14522 $io->blocking ( [ BOOL ] ), $io->untaint
14523
14524 =item NOTE
14525
14526 =item SEE ALSO
14527
14528 =item BUGS
14529
14530 =item HISTORY
14531
14532 =back
14533
14534 =head2 IO::lib::IO::Pipe, IO::Pipe - supply object methods for pipes
14535
14536 =over 4
14537
14538 =item SYNOPSIS
14539
14540 =item DESCRIPTION
14541
14542 =item CONSTRUCTOR
14543
14544 new ( [READER, WRITER] )
14545
14546 =item METHODS
14547
14548 reader ([ARGS]), writer ([ARGS]), handles ()
14549
14550 =item SEE ALSO
14551
14552 =item AUTHOR
14553
14554 =item COPYRIGHT
14555
14556 =back
14557
14558 =head2 IO::lib::IO::Poll, IO::Poll - Object interface to system poll call
14559
14560 =over 4
14561
14562 =item SYNOPSIS
14563
14564 =item DESCRIPTION
14565
14566 =item METHODS
14567
14568 mask ( IO [, EVENT_MASK ] ), poll ( [ TIMEOUT ] ), events ( IO ), remove (
14569 IO ), handles( [ EVENT_MASK ] )
14570
14571 =item SEE ALSO
14572
14573 =item AUTHOR
14574
14575 =item COPYRIGHT
14576
14577 =back
14578
14579 =head2 IO::lib::IO::Seekable, IO::Seekable - supply seek based methods for
14580 I/O objects
14581
14582 =over 4
14583
14584 =item SYNOPSIS
14585
14586 =item DESCRIPTION
14587
14588 $io->getpos, $io->setpos, $io->seek ( POS, WHENCE ), WHENCE=0 (SEEK_SET),
14589 WHENCE=1 (SEEK_CUR), WHENCE=2 (SEEK_END), $io->sysseek( POS, WHENCE ),
14590 $io->tell
14591
14592 =item SEE ALSO
14593
14594 =item HISTORY
14595
14596 =back
14597
14598 =head2 IO::lib::IO::Select, IO::Select - OO interface to the select system
14599 call
14600
14601 =over 4
14602
14603 =item SYNOPSIS
14604
14605 =item DESCRIPTION
14606
14607 =item CONSTRUCTOR
14608
14609 new ( [ HANDLES ] )
14610
14611 =item METHODS
14612
14613 add ( HANDLES ), remove ( HANDLES ), exists ( HANDLE ), handles, can_read (
14614 [ TIMEOUT ] ), can_write ( [ TIMEOUT ] ), has_exception ( [ TIMEOUT ] ),
14615 count (), bits(), select ( READ, WRITE, ERROR [, TIMEOUT ] )
14616
14617 =item EXAMPLE
14618
14619 =item AUTHOR
14620
14621 =item COPYRIGHT
14622
14623 =back
14624
14625 =head2 IO::lib::IO::Socket, IO::Socket - Object interface to socket
14626 communications
14627
14628 =over 4
14629
14630 =item SYNOPSIS
14631
14632 =item DESCRIPTION
14633
14634 =item CONSTRUCTOR
14635
14636 new ( [ARGS] )
14637
14638 =item METHODS
14639
14640 accept([PKG]), socketpair(DOMAIN, TYPE, PROTOCOL), atmark, connected,
14641 protocol, sockdomain, sockopt(OPT [, VAL]), socktype, timeout([VAL])
14642
14643 =item SEE ALSO
14644
14645 =item AUTHOR
14646
14647 =item COPYRIGHT
14648
14649 =back
14650
14651 =head2 IO::lib::IO::Socket::INET, IO::Socket::INET - Object interface for
14652 AF_INET domain sockets
14653
14654 =over 4
14655
14656 =item SYNOPSIS
14657
14658 =item DESCRIPTION
14659
14660 =item CONSTRUCTOR
14661
14662 new ( [ARGS] )
14663
14664 =over 4
14665
14666 =item METHODS
14667
14668 sockaddr (), sockport (), sockhost (), peeraddr (), peerport (), peerhost
14669 ()
14670
14671 =back
14672
14673 =item SEE ALSO
14674
14675 =item AUTHOR
14676
14677 =item COPYRIGHT
14678
14679 =back
14680
14681 =head2 IO::lib::IO::Socket::UNIX, IO::Socket::UNIX - Object interface for
14682 AF_UNIX domain sockets
14683
14684 =over 4
14685
14686 =item SYNOPSIS
14687
14688 =item DESCRIPTION
14689
14690 =item CONSTRUCTOR
14691
14692 new ( [ARGS] )
14693
14694 =item METHODS
14695
14696 hostpath(), peerpath()
14697
14698 =item SEE ALSO
14699
14700 =item AUTHOR
14701
14702 =item COPYRIGHT
14703
14704 =back
14705
14706 =head2 IPC::Msg - SysV Msg IPC object class
14707
14708 =over 4
14709
14710 =item SYNOPSIS
14711
14712 =item DESCRIPTION
14713
14714 =item METHODS
14715
14716 new ( KEY , FLAGS ), id, rcv ( BUF, LEN [, TYPE [, FLAGS ]] ), remove, set
14717 ( STAT ), set ( NAME => VALUE [, NAME => VALUE ...] ), snd ( TYPE, MSG [,
14718 FLAGS ] ), stat
14719
14720 =item SEE ALSO
14721
14722 =item AUTHOR
14723
14724 =item COPYRIGHT
14725
14726 =back
14727
14728 =head2 IPC::Open2, open2 - open a process for both reading and writing
14729
14730 =over 4
14731
14732 =item SYNOPSIS
14733
14734 =item DESCRIPTION
14735
14736 =item WARNING
14737
14738 =item SEE ALSO
14739
14740 =back
14741
14742 =head2 IPC::Open3, open3 - open a process for reading, writing, and error
14743 handling
14744
14745 =over 4
14746
14747 =item SYNOPSIS
14748
14749 =item DESCRIPTION
14750
14751 =item WARNING
14752
14753 =back
14754
14755 =head2 IPC::Semaphore - SysV Semaphore IPC object class
14756
14757 =over 4
14758
14759 =item SYNOPSIS
14760
14761 =item DESCRIPTION
14762
14763 =item METHODS
14764
14765 new ( KEY , NSEMS , FLAGS ), getall, getncnt ( SEM ), getpid ( SEM ),
14766 getval ( SEM ), getzcnt ( SEM ), id, op ( OPLIST ), remove, set ( STAT ),
14767 set ( NAME => VALUE [, NAME => VALUE ...] ), setall ( VALUES ), setval ( N
14768 , VALUE ), stat
14769
14770 =item SEE ALSO
14771
14772 =item AUTHOR
14773
14774 =item COPYRIGHT
14775
14776 =back
14777
14778 =head2 IPC::SysV - SysV IPC constants
14779
14780 =over 4
14781
14782 =item SYNOPSIS
14783
14784 =item DESCRIPTION
14785
14786 ftok( PATH, ID )
14787
14788 =item SEE ALSO
14789
14790 =item AUTHORS
14791
14792 =item COPYRIGHT
14793
14794 =back
14795
14796 =head2 IPC::SysV::Msg, IPC::Msg - SysV Msg IPC object class
14797
14798 =over 4
14799
14800 =item SYNOPSIS
14801
14802 =item DESCRIPTION
14803
14804 =item METHODS
14805
14806 new ( KEY , FLAGS ), id, rcv ( BUF, LEN [, TYPE [, FLAGS ]] ), remove, set
14807 ( STAT ), set ( NAME => VALUE [, NAME => VALUE ...] ), snd ( TYPE, MSG [,
14808 FLAGS ] ), stat
14809
14810 =item SEE ALSO
14811
14812 =item AUTHOR
14813
14814 =item COPYRIGHT
14815
14816 =back
14817
14818 =head2 IPC::SysV::Semaphore, IPC::Semaphore - SysV Semaphore IPC object
14819 class
14820
14821 =over 4
14822
14823 =item SYNOPSIS
14824
14825 =item DESCRIPTION
14826
14827 =item METHODS
14828
14829 new ( KEY , NSEMS , FLAGS ), getall, getncnt ( SEM ), getpid ( SEM ),
14830 getval ( SEM ), getzcnt ( SEM ), id, op ( OPLIST ), remove, set ( STAT ),
14831 set ( NAME => VALUE [, NAME => VALUE ...] ), setall ( VALUES ), setval ( N
14832 , VALUE ), stat
14833
14834 =item SEE ALSO
14835
14836 =item AUTHOR
14837
14838 =item COPYRIGHT
14839
14840 =back
14841
14842 =head2 List::Util - A selection of general-utility list subroutines
14843
14844 =over 4
14845
14846 =item SYNOPSIS
14847
14848 =item DESCRIPTION
14849
14850 first BLOCK LIST, max LIST, maxstr LIST, min LIST, minstr LIST, reduce
14851 BLOCK LIST, shuffle LIST, sum LIST
14852
14853 =item KNOWN BUGS
14854
14855 =item SUGGESTED ADDITIONS
14856
14857 =item COPYRIGHT
14858
14859 =back
14860
14861 =head2 List::Utilib::List::Util, List::Util - A selection of
14862 general-utility list subroutines
14863
14864 =over 4
14865
14866 =item SYNOPSIS
14867
14868 =item DESCRIPTION
14869
14870 first BLOCK LIST, max LIST, maxstr LIST, min LIST, minstr LIST, reduce
14871 BLOCK LIST, shuffle LIST, sum LIST
14872
14873 =item KNOWN BUGS
14874
14875 =item SUGGESTED ADDITIONS
14876
14877 =item COPYRIGHT
14878
14879 =back
14880
14881 =head2 List::Utilib::Scalar::Util, Scalar::Util - A selection of
14882 general-utility scalar subroutines
14883
14884 =over 4
14885
14886 =item SYNOPSIS
14887
14888 =item DESCRIPTION
14889
14890 blessed EXPR, dualvar NUM, STRING, isweak EXPR, openhandle FH, reftype
14891 EXPR, tainted EXPR, weaken REF
14892
14893 =item KNOWN BUGS
14894
14895 =item COPYRIGHT
14896
14897 =item BLATANT PLUG
14898
14899 =back
14900
14901 =head2 Locale::Constants - constants for Locale codes
14902
14903 =over 4
14904
14905 =item SYNOPSIS
14906
14907 =item DESCRIPTION
14908
14909 =item KNOWN BUGS AND LIMITATIONS
14910
14911 =item SEE ALSO
14912
14913 Locale::Language, Locale::Country, Locale::Script, Locale::Currency
14914
14915 =item AUTHOR
14916
14917 =item COPYRIGHT
14918
14919 =back
14920
14921 =head2 Locale::Country - ISO codes for country identification (ISO 3166)
14922
14923 =over 4
14924
14925 =item SYNOPSIS
14926
14927 =item DESCRIPTION
14928
14929 B<alpha-2>, B<alpha-3>, B<numeric>
14930
14931 =item CONVERSION ROUTINES
14932
14933 code2country( CODE, [ CODESET ] ), country2code( STRING, [ CODESET ] ),
14934 country_code2code( CODE, CODESET, CODESET )
14935
14936 =item QUERY ROUTINES
14937
14938 C<all_country_codes( [ CODESET ] )>, C<all_country_names( [ CODESET ] )>
14939
14940 =item SEMI-PRIVATE ROUTINES
14941
14942 =over 4
14943
14944 =item alias_code
14945
14946 =item rename_country
14947
14948 =back
14949
14950 =item EXAMPLES
14951
14952 =item DOMAIN NAMES
14953
14954 =item KNOWN BUGS AND LIMITATIONS
14955
14956 =item SEE ALSO
14957
14958 Locale::Language, Locale::Script, Locale::Currency, Locale::SubCountry, ISO
14959 3166-1, http://www.iso.org/iso/en/prods-services/iso3166ma/index.html,
14960 http://www.egt.ie/standards/iso3166/iso3166-1-en.html,
14961 http://www.cia.gov/cia/publications/factbook/docs/app-d-1.html
14962
14963 =item AUTHOR
14964
14965 =item COPYRIGHT
14966
14967 =back
14968
14969 =head2 Locale::Currency - ISO three letter codes for currency
14970 identification (ISO 4217)
14971
14972 =over 4
14973
14974 =item SYNOPSIS
14975
14976 =item DESCRIPTION
14977
14978 XTS, XXX
14979
14980 =item CONVERSION ROUTINES
14981
14982 code2currency(), currency2code()
14983
14984 =item QUERY ROUTINES
14985
14986 C<all_currency_codes()>, C<all_currency_names()>
14987
14988 =item EXAMPLES
14989
14990 =item KNOWN BUGS AND LIMITATIONS
14991
14992 =item SEE ALSO
14993
14994 Locale::Country, Locale::Script, ISO 4217:1995,
14995 http://www.bsi-global.com/iso4217currency
14996
14997 =item AUTHOR
14998
14999 =item COPYRIGHT
15000
15001 =back
15002
15003 =head2 Locale::Language - ISO two letter codes for language identification
15004 (ISO 639)
15005
15006 =over 4
15007
15008 =item SYNOPSIS
15009
15010 =item DESCRIPTION
15011
15012 =item CONVERSION ROUTINES
15013
15014 code2language(), language2code()
15015
15016 =item QUERY ROUTINES
15017
15018 C<all_language_codes()>, C<all_language_names()>
15019
15020 =item EXAMPLES
15021
15022 =item KNOWN BUGS AND LIMITATIONS
15023
15024 =item SEE ALSO
15025
15026 Locale::Country, Locale::Script, Locale::Currency, ISO 639:1988 (E/F),
15027 http://lcweb.loc.gov/standards/iso639-2/langhome.html
15028
15029 =item AUTHOR
15030
15031 =item COPYRIGHT
15032
15033 =back
15034
15035 =head2 Locale::Maketext -- framework for localization
15036
15037 =over 4
15038
15039 =item SYNOPSIS
15040
15041 =item DESCRIPTION
15042
15043 =item QUICK OVERVIEW
15044
15045 =item METHODS
15046
15047 =over 4
15048
15049 =item Construction Methods
15050
15051 =item The "maketext" Method
15052
15053 $lh->fail_with I<or> $lh->fail_with(I<PARAM>), $lh->failure_handler_auto
15054
15055 =item Utility Methods
15056
15057 $language->quant($number, $singular), $language->quant($number, $singular,
15058 $plural), $language->quant($number, $singular, $plural, $negative),
15059 $language->numf($number), $language->sprintf($format, @items),
15060 $language->language_tag(), $language->encoding()
15061
15062 =item Language Handle Attributes and Internals
15063
15064 =back
15065
15066 =item LANGUAGE CLASS HIERARCHIES
15067
15068 =item ENTRIES IN EACH LEXICON
15069
15070 =item BRACKET NOTATION
15071
15072 =item AUTO LEXICONS
15073
15074 =item CONTROLLING LOOKUP FAILURE
15075
15076 =item HOW TO USE MAKETEXT
15077
15078 =item SEE ALSO
15079
15080 =item COPYRIGHT AND DISCLAIMER
15081
15082 =item AUTHOR
15083
15084 =back
15085
15086 =head2 Locale::Maketext::TPJ13 -- article about software localization
15087
15088 =over 4
15089
15090 =item SYNOPSIS
15091
15092 =item DESCRIPTION
15093
15094 =item Localization and Perl: gettext breaks, Maketext fixes
15095
15096 =over 4
15097
15098 =item A Localization Horror Story: It Could Happen To You
15099
15100 =item The Linguistic View
15101
15102 =item Breaking gettext
15103
15104 =item Replacing gettext
15105
15106 =item Buzzwords: Abstraction and Encapsulation
15107
15108 =item Buzzword: Isomorphism
15109
15110 =item Buzzword: Inheritance
15111
15112 =item Buzzword: Concision
15113
15114 =item The Devil in the Details
15115
15116 =item The Proof in the Pudding: Localizing Web Sites
15117
15118 =item References
15119
15120 =back
15121
15122 =back
15123
15124 =head2 Locale::Script - ISO codes for script identification (ISO 15924)
15125
15126 =over 4
15127
15128 =item SYNOPSIS
15129
15130 =item DESCRIPTION
15131
15132 B<alpha-2>, B<alpha-3>, B<numeric>
15133
15134 =over 4
15135
15136 =item SPECIAL CODES
15137
15138 =back
15139
15140 =item CONVERSION ROUTINES
15141
15142 code2script( CODE, [ CODESET ] ), script2code( STRING, [ CODESET ] ),
15143 script_code2code( CODE, CODESET, CODESET )
15144
15145 =item QUERY ROUTINES
15146
15147 C<all_script_codes ( [ CODESET ] )>, C<all_script_names ( [ CODESET ] )>
15148
15149 =item EXAMPLES
15150
15151 =item KNOWN BUGS AND LIMITATIONS
15152
15153 =item SEE ALSO
15154
15155 Locale::Language, Locale::Currency, Locale::Country, ISO 15924,
15156 http://www.evertype.com/standards/iso15924/
15157
15158 =item AUTHOR
15159
15160 =item COPYRIGHT
15161
15162 =back
15163
15164 =head2 MIME::Base64 - Encoding and decoding of base64 strings
15165
15166 =over 4
15167
15168 =item SYNOPSIS
15169
15170 =item DESCRIPTION
15171
15172 encode_base64($str, [$eol]), decode_base64($str)
15173
15174 =item DIAGNOSTICS
15175
15176 Premature end of base64 data, Premature padding of base64 data
15177
15178 =item EXAMPLES
15179
15180 =item COPYRIGHT
15181
15182 =back
15183
15184 =head2 MIME::Base64::QuotedPrint, MIME::QuotedPrint - Encoding and decoding
15185 of quoted-printable strings
15186
15187 =over 4
15188
15189 =item SYNOPSIS
15190
15191 =item DESCRIPTION
15192
15193 encode_qp($str), decode_qp($str);
15194
15195 =item COPYRIGHT
15196
15197 =back
15198
15199 =head2 MIME::QuotedPrint - Encoding and decoding of quoted-printable
15200 strings
15201
15202 =over 4
15203
15204 =item SYNOPSIS
15205
15206 =item DESCRIPTION
15207
15208 encode_qp($str), decode_qp($str);
15209
15210 =item COPYRIGHT
15211
15212 =back
15213
15214 =head2 Math::BigFloat - Arbitrary size floating point math package
15215
15216 =over 4
15217
15218 =item SYNOPSIS
15219
15220 =item DESCRIPTION
15221
15222 =over 4
15223
15224 =item Canonical notation
15225
15226 =item Output
15227
15228 =item C<mantissa()>, C<exponent()> and C<parts()>
15229
15230 =item Accuracy vs. Precision
15231
15232 =item Rounding
15233
15234 ffround ( +$scale ), ffround ( -$scale ), ffround ( 0 ), fround  ( +$scale
15235 ), fround  ( -$scale ) and fround ( 0 )
15236
15237 =back
15238
15239 =item EXAMPLES
15240
15241   # not ready yet
15242
15243 =item Autocreating constants
15244
15245 =over 4
15246
15247 =item Math library
15248
15249 =item Using Math::BigInt::Lite
15250
15251 =back
15252
15253 =item BUGS
15254
15255 =item CAVEAT
15256
15257 stringify, bstr(), bdiv, Modifying and =, bpow
15258
15259 =item LICENSE
15260
15261 =item AUTHORS
15262
15263 =back
15264
15265 =head2 Math::BigInt - Arbitrary size integer math package
15266
15267 =over 4
15268
15269 =item SYNOPSIS
15270
15271 =item DESCRIPTION
15272
15273 Canonical notation, Input, Output
15274
15275 =item METHODS
15276
15277 =over 4
15278
15279 =item config
15280
15281 =item accuracy
15282
15283 =item brsft
15284
15285 =item new
15286
15287 =item bnan
15288
15289 =item bzero
15290
15291 =item binf
15292
15293 =item bone
15294
15295 =item is_one()/is_zero()/is_nan()/is_inf()
15296
15297 =item is_positive()/is_negative()
15298
15299         $x->is_positive();              # true if >= 0
15300         $x->is_negative();              # true if <  0
15301
15302 =item is_odd()/is_even()/is_int()
15303
15304 =item bcmp
15305
15306 =item bacmp
15307
15308 =item sign
15309
15310 =item bcmp
15311
15312 =item bneg
15313
15314 =item babs
15315
15316 =item bnorm
15317
15318 =item bnot
15319
15320 =item binc
15321
15322 =item bdec
15323
15324 =item badd
15325
15326 =item bsub
15327
15328 =item bmul
15329
15330 =item bdiv
15331
15332 =item bmod
15333
15334 =item bmodinv
15335
15336 =item bmodpow
15337
15338 =item bpow
15339
15340 =item blsft
15341
15342 =item brsft
15343
15344 =item band
15345
15346 =item bior
15347
15348 =item bxor
15349
15350 =item bnot
15351
15352 =item bsqrt
15353
15354 =item bfac
15355
15356 =item round
15357
15358 =item bround
15359
15360 =item bfround
15361
15362 =item bfloor
15363
15364 =item bceil
15365
15366 =item bgcd
15367
15368 =item blcm
15369
15370 =item exponent
15371
15372 =item mantissa
15373
15374 =item parts
15375
15376 =item copy
15377
15378 =item as_number
15379
15380 =item bsstr
15381
15382 =item as_hex
15383
15384 =item as_bin
15385
15386 =back
15387
15388 =item ACCURACY and PRECISION
15389
15390 =over 4
15391
15392 =item Precision P
15393
15394 =item Accuracy A
15395
15396 =item Fallback F
15397
15398 =item Rounding mode R
15399
15400 'trunc', 'even', 'odd', '+inf', '-inf', 'zero', Precision, Accuracy
15401 (significant digits), Setting/Accessing, Creating numbers, Usage,
15402 Precedence, Overriding globals, Local settings, Rounding, Default values,
15403 Remarks
15404
15405 =back
15406
15407 =item INTERNALS
15408
15409 =over 4
15410
15411 =item MATH LIBRARY
15412
15413 =item SIGN
15414
15415 =item mantissa(), exponent() and parts()
15416
15417 =back
15418
15419 =item EXAMPLES
15420
15421   use Math::BigInt;
15422
15423 =item Autocreating constants
15424
15425 =item PERFORMANCE
15426
15427 =over 4
15428
15429 =item Alternative math libraries
15430
15431 =item SUBCLASSING
15432
15433 =back
15434
15435 =item Subclassing Math::BigInt
15436
15437 =item UPGRADING
15438
15439 =over 4
15440
15441 =item Auto-upgrade
15442
15443 bsqrt(), div(), blog()
15444
15445 =back
15446
15447 =item BUGS
15448
15449 Out of Memory!, Fails to load Calc on Perl prior 5.6.0
15450
15451 =item CAVEATS
15452
15453 stringify, bstr(), bsstr() and 'cmp', int(), length, bdiv, infinity
15454 handling, Modifying and =, bpow, Overloading -$x, Mixing different object
15455 types, bsqrt(), brsft()
15456
15457 =item LICENSE
15458
15459 =item SEE ALSO
15460
15461 =item AUTHORS
15462
15463 =back
15464
15465 =head2 Math::BigInt::Calc - Pure Perl module to support Math::BigInt
15466
15467 =over 4
15468
15469 =item SYNOPSIS
15470
15471 =item DESCRIPTION
15472
15473 =item EXPORT
15474
15475 =item WRAP YOUR OWN
15476
15477 =item LICENSE
15478
15479 This program is free software; you may redistribute it and/or modify it
15480 under
15481 the same terms as Perl itself.
15482
15483 =item AUTHORS
15484
15485 =item SEE ALSO
15486
15487 =back
15488
15489 =head2 Math::BigRat - arbitrarily big rationals
15490
15491 =over 4
15492
15493 =item SYNOPSIS
15494
15495 =item DESCRIPTION
15496
15497 =over 4
15498
15499 =item MATH LIBRARY
15500
15501 =back
15502
15503 =item METHODS
15504
15505 =over 4
15506
15507 =item new()
15508
15509 =item numerator()
15510
15511 =item denominator()
15512
15513         $d = $x->denominator();
15514
15515 =item parts()
15516
15517 =item as_number()
15518
15519 =item bfac()
15520
15521 =item blog()
15522
15523 =item bround()/round()/bfround()
15524
15525 =back
15526
15527 =item BUGS
15528
15529 =item LICENSE
15530
15531 =item SEE ALSO
15532
15533 =item AUTHORS
15534
15535 =back
15536
15537 =head2 Math::Complex - complex numbers and associated mathematical
15538 functions
15539
15540 =over 4
15541
15542 =item SYNOPSIS
15543
15544 =item DESCRIPTION
15545
15546 =item OPERATIONS
15547
15548 =item CREATION
15549
15550 =item STRINGIFICATION
15551
15552 =over 4
15553
15554 =item CHANGED IN PERL 5.6
15555
15556 =back
15557
15558 =item USAGE
15559
15560 =item ERRORS DUE TO DIVISION BY ZERO OR LOGARITHM OF ZERO
15561
15562 =item ERRORS DUE TO INDIGESTIBLE ARGUMENTS
15563
15564 =item BUGS
15565
15566 =item AUTHORS
15567
15568 =back
15569
15570 =head2 Math::Trig - trigonometric functions
15571
15572 =over 4
15573
15574 =item SYNOPSIS
15575
15576 =item DESCRIPTION
15577
15578 =item TRIGONOMETRIC FUNCTIONS
15579
15580 B<tan>
15581
15582 =over 4
15583
15584 =item ERRORS DUE TO DIVISION BY ZERO
15585
15586 =item SIMPLE (REAL) ARGUMENTS, COMPLEX RESULTS
15587
15588 =back
15589
15590 =item PLANE ANGLE CONVERSIONS
15591
15592 =item RADIAL COORDINATE CONVERSIONS
15593
15594 =over 4
15595
15596 =item COORDINATE SYSTEMS
15597
15598 =item 3-D ANGLE CONVERSIONS
15599
15600 cartesian_to_cylindrical, cartesian_to_spherical, cylindrical_to_cartesian,
15601 cylindrical_to_spherical, spherical_to_cartesian, spherical_to_cylindrical
15602
15603 =back
15604
15605 =item GREAT CIRCLE DISTANCES AND DIRECTIONS
15606
15607 =item EXAMPLES
15608
15609 =over 4
15610
15611 =item CAVEAT FOR GREAT CIRCLE FORMULAS
15612
15613 =back
15614
15615 =item BUGS
15616
15617 =item AUTHORS
15618
15619 =back
15620
15621 =head2 Memoize - Make functions faster by trading space for time
15622
15623 =over 4
15624
15625 =item SYNOPSIS
15626
15627 =item DESCRIPTION
15628
15629 =item DETAILS
15630
15631 =item OPTIONS
15632
15633 =over 4
15634
15635 =item INSTALL
15636
15637 =item NORMALIZER
15638
15639 =item C<SCALAR_CACHE>, C<LIST_CACHE>
15640
15641 C<MEMORY>, C<HASH>, C<TIE>, C<FAULT>, C<MERGE>
15642
15643 =back
15644
15645 =item OTHER FACILITIES
15646
15647 =over 4
15648
15649 =item C<unmemoize>
15650
15651 =item C<flush_cache>
15652
15653 =back
15654
15655 =item CAVEATS
15656
15657 =item PERSISTENT CACHE SUPPORT
15658
15659 =item EXPIRATION SUPPORT
15660
15661 =item BUGS
15662
15663 =item MAILING LIST
15664
15665 =item AUTHOR
15666
15667 =item COPYRIGHT AND LICENSE
15668
15669 =item THANK YOU
15670
15671 =back
15672
15673 =head2 Memoize::AnyDBM_File - glue to provide EXISTS for AnyDBM_File for
15674 Storable use
15675
15676 =over 4
15677
15678 =item DESCRIPTION
15679
15680 =back
15681
15682 =head2 Memoize::Expire - Plug-in module for automatic expiration of
15683 memoized values
15684
15685 =over 4
15686
15687 =item SYNOPSIS
15688
15689 =item DESCRIPTION
15690
15691 =item INTERFACE
15692
15693  TIEHASH,  EXISTS,  STORE
15694
15695 =item ALTERNATIVES
15696
15697 =item CAVEATS
15698
15699 =item AUTHOR
15700
15701 =item SEE ALSO
15702
15703 =back
15704
15705 =head2 Memoize::ExpireFile - test for Memoize expiration semantics
15706
15707 =over 4
15708
15709 =item DESCRIPTION
15710
15711 =back
15712
15713 =head2 Memoize::ExpireTest - test for Memoize expiration semantics
15714
15715 =over 4
15716
15717 =item DESCRIPTION
15718
15719 =back
15720
15721 =head2 Memoize::NDBM_File - glue to provide EXISTS for NDBM_File for
15722 Storable use
15723
15724 =over 4
15725
15726 =item DESCRIPTION
15727
15728 =back
15729
15730 =head2 Memoize::SDBM_File - glue to provide EXISTS for SDBM_File for
15731 Storable use
15732
15733 =over 4
15734
15735 =item DESCRIPTION
15736
15737 =back
15738
15739 =head2 Memoize::Storable - store Memoized data in Storable database
15740
15741 =over 4
15742
15743 =item DESCRIPTION
15744
15745 =back
15746
15747 =head2 NDBM_File - Tied access to ndbm files
15748
15749 =over 4
15750
15751 =item SYNOPSIS
15752
15753 =item DESCRIPTION
15754
15755 C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR>
15756
15757 =item DIAGNOSTICS
15758
15759 =over 4
15760
15761 =item C<ndbm store returned -1, errno 22, key "..." at ...>
15762
15763 =back
15764
15765 =item BUGS AND WARNINGS
15766
15767 =back
15768
15769 =head2 NEXT - Provide a pseudo-class NEXT that allows method redispatch
15770
15771 =over 4
15772
15773 =item SYNOPSIS
15774
15775 =item DESCRIPTION
15776
15777 =over 4
15778
15779 =item Enforcing redispatch
15780
15781 =item Avoiding repetitions
15782
15783 =back
15784
15785 =item AUTHOR
15786
15787 =item BUGS AND IRRITATIONS
15788
15789 =item COPYRIGHT
15790
15791 =back
15792
15793 =head2 Net::Cmd - Network Command class (as used by FTP, SMTP etc)
15794
15795 =over 4
15796
15797 =item SYNOPSIS
15798
15799 =item DESCRIPTION
15800
15801 =item USER METHODS
15802
15803 debug ( VALUE ), message (), code (), ok (), status (), datasend ( DATA ),
15804 dataend ()
15805
15806 =item CLASS METHODS
15807
15808 debug_print ( DIR, TEXT ), debug_text ( TEXT ), command ( CMD [, ARGS, ...
15809 ]), unsupported (), response (), parse_response ( TEXT ), getline (),
15810 ungetline ( TEXT ), read_until_dot (), tied_fh ()
15811
15812 =item EXPORTS
15813
15814 =item AUTHOR
15815
15816 =item COPYRIGHT
15817
15818 =back
15819
15820 =head2 Net::Config - Local configuration data for libnet
15821
15822 =over 4
15823
15824 =item SYNOPSYS
15825
15826 =item DESCRIPTION
15827
15828 =item METHODS
15829
15830 requires_firewall HOST
15831
15832 =item NetConfig VALUES
15833
15834 nntp_hosts, snpp_hosts, pop3_hosts, smtp_hosts, ph_hosts, daytime_hosts,
15835 time_hosts, inet_domain, ftp_firewall, ftp_firewall_type, ftp_ext_passive,
15836 ftp_int_pasive, local_netmask, test_hosts, test_exists
15837
15838 =back
15839
15840 =head2 Net::Domain - Attempt to evaluate the current host's internet name
15841 and domain
15842
15843 =over 4
15844
15845 =item SYNOPSIS
15846
15847 =item DESCRIPTION
15848
15849 hostfqdn (), hostname (), hostdomain ()
15850
15851 =item AUTHOR
15852
15853 =item COPYRIGHT
15854
15855 =back
15856
15857 =head2 Net::FTP - FTP Client class
15858
15859 =over 4
15860
15861 =item SYNOPSIS
15862
15863 =item DESCRIPTION
15864
15865 =item OVERVIEW
15866
15867 =item CONSTRUCTOR
15868
15869 new (HOST [,OPTIONS])
15870
15871 =item METHODS
15872
15873 login ([LOGIN [,PASSWORD [, ACCOUNT] ] ]), authorize ( [AUTH [, RESP]]),
15874 site (ARGS), type (TYPE [, ARGS]), ascii ([ARGS]) binary([ARGS])
15875 ebcdic([ARGS]) byte([ARGS]), rename ( OLDNAME, NEWNAME ), delete ( FILENAME
15876 ), cwd ( [ DIR ] ), cdup (), pwd (), restart ( WHERE ), rmdir ( DIR ),
15877 mkdir ( DIR [, RECURSE ]), ls ( [ DIR ] ), dir ( [ DIR ] ), get (
15878 REMOTE_FILE [, LOCAL_FILE [, WHERE]] ), put ( LOCAL_FILE [, REMOTE_FILE ]
15879 ), put_unique ( LOCAL_FILE [, REMOTE_FILE ] ), append ( LOCAL_FILE [,
15880 REMOTE_FILE ] ), unique_name (), mdtm ( FILE ), size ( FILE ), supported (
15881 CMD ), hash ( [FILEHANDLE_GLOB_REF],[ BYTES_PER_HASH_MARK] ), nlst ( [ DIR
15882 ] ), list ( [ DIR ] ), retr ( FILE ), stor ( FILE ), stou ( FILE ), appe (
15883 FILE ), port ( [ PORT ] ), pasv (), pasv_xfer ( SRC_FILE, DEST_SERVER [,
15884 DEST_FILE ] ), pasv_xfer_unique ( SRC_FILE, DEST_SERVER [, DEST_FILE ] ),
15885 pasv_wait ( NON_PASV_SERVER ), abort (), quit ()
15886
15887 =over 4
15888
15889 =item Methods for the adventurous
15890
15891 quot (CMD [,ARGS])
15892
15893 =back
15894
15895 =item THE dataconn CLASS
15896
15897 read ( BUFFER, SIZE [, TIMEOUT ] ), write ( BUFFER, SIZE [, TIMEOUT ] ),
15898 bytes_read (), abort (), close ()
15899
15900 =item UNIMPLEMENTED
15901
15902 B<ALLO>, B<SMNT>, B<HELP>, B<MODE>, B<SYST>, B<STAT>, B<STRU>, B<REIN>
15903
15904 =item REPORTING BUGS
15905
15906 =item AUTHOR
15907
15908 =item SEE ALSO
15909
15910 =item USE EXAMPLES
15911
15912 http://www.csh.rit.edu/~adam/Progs/autoftp-2.0.tar.gz
15913
15914 =item CREDITS
15915
15916 =item COPYRIGHT
15917
15918 =back
15919
15920 =head2 Net::NNTP - NNTP Client class
15921
15922 =over 4
15923
15924 =item SYNOPSIS
15925
15926 =item DESCRIPTION
15927
15928 =item CONSTRUCTOR
15929
15930 new ( [ HOST ] [, OPTIONS ])
15931
15932 =item METHODS
15933
15934 article ( [ MSGID|MSGNUM ], [FH] ), body ( [ MSGID|MSGNUM ], [FH] ), head (
15935 [ MSGID|MSGNUM ], [FH] ), articlefh ( [ MSGID|MSGNUM ] ), bodyfh ( [
15936 MSGID|MSGNUM ] ), headfh ( [ MSGID|MSGNUM ] ), nntpstat ( [ MSGID|MSGNUM ]
15937 ), group ( [ GROUP ] ), ihave ( MSGID [, MESSAGE ]), last (), date (),
15938 postok (), authinfo ( USER, PASS ), list (), newgroups ( SINCE [,
15939 DISTRIBUTIONS ]), newnews ( SINCE [, GROUPS [, DISTRIBUTIONS ]]), next (),
15940 post ( [ MESSAGE ] ), postfh (), slave (), quit ()
15941
15942 =over 4
15943
15944 =item Extension methods
15945
15946 newsgroups ( [ PATTERN ] ), distributions (), subscriptions (),
15947 overview_fmt (), active_times (), active ( [ PATTERN ] ), xgtitle ( PATTERN
15948 ), xhdr ( HEADER, MESSAGE-SPEC ), xover ( MESSAGE-SPEC ), xpath (
15949 MESSAGE-ID ), xpat ( HEADER, PATTERN, MESSAGE-SPEC), xrover, listgroup ( [
15950 GROUP ] ), reader
15951
15952 =back
15953
15954 =item UNSUPPORTED
15955
15956 =item DEFINITIONS
15957
15958 MESSAGE-SPEC, PATTERN, Examples, C<[^]-]>, C<*bdc>, C<[0-9a-zA-Z]>, C<a??d>
15959
15960 =item SEE ALSO
15961
15962 =item AUTHOR
15963
15964 =item COPYRIGHT
15965
15966 =back
15967
15968 =head2 Net::POP3 - Post Office Protocol 3 Client class (RFC1939)
15969
15970 =over 4
15971
15972 =item SYNOPSIS
15973
15974 =item DESCRIPTION
15975
15976 =item EXAMPLES
15977
15978 =item CONSTRUCTOR
15979
15980 new ( [ HOST, ] [ OPTIONS ] )
15981
15982 =item METHODS
15983
15984 user ( USER ), pass ( PASS ), login ( [ USER [, PASS ]] ), apop ( [ USER [,
15985 PASS ]] ), top ( MSGNUM [, NUMLINES ] ), list ( [ MSGNUM ] ), get ( MSGNUM
15986 [, FH ] ), getfh ( MSGNUM ), last (), popstat (), ping ( USER ), uidl ( [
15987 MSGNUM ] ), delete ( MSGNUM ), reset (), quit ()
15988
15989 =item NOTES
15990
15991 =item SEE ALSO
15992
15993 =item AUTHOR
15994
15995 =item COPYRIGHT
15996
15997 =back
15998
15999 =head2 Net::Ping - check a remote host for reachability
16000
16001 =over 4
16002
16003 =item SYNOPSIS
16004
16005 =item DESCRIPTION
16006
16007 =over 4
16008
16009 =item Functions
16010
16011 Net::Ping->new([$proto [, $def_timeout [, $bytes]]]);, $p->ping($host [,
16012 $timeout]);, $p->source_verify( { 0 | 1 } );, $p->hires( { 0 | 1 } );,
16013 $p->bind($local_addr);, $p->open($host);, $p->close();, pingecho($host [,
16014 $timeout]);
16015
16016 =back
16017
16018 =item WARNING
16019
16020 =item NOTES
16021
16022 =item INSTALL
16023
16024 =item AUTHORS
16025
16026 =item COPYRIGHT
16027
16028 =back
16029
16030 =head2 Net::SMTP - Simple Mail Transfer Protocol Client
16031
16032 =over 4
16033
16034 =item SYNOPSIS
16035
16036 =item DESCRIPTION
16037
16038 =item EXAMPLES
16039
16040 =item CONSTRUCTOR
16041
16042 new Net::SMTP [ HOST, ] [ OPTIONS ]
16043
16044 =item METHODS
16045
16046 banner (), domain (), hello ( DOMAIN ), etrn ( DOMAIN ), auth ( USERNAME,
16047 PASSWORD ), mail ( ADDRESS [, OPTIONS] ), send ( ADDRESS ), send_or_mail (
16048 ADDRESS ), send_and_mail ( ADDRESS ), reset (), recipient ( ADDRESS [,
16049 ADDRESS [ ...]] [, OPTIONS ] ), to ( ADDRESS [, ADDRESS [...]] ), cc (
16050 ADDRESS [, ADDRESS [...]] ), bcc ( ADDRESS [, ADDRESS [...]] ), data ( [
16051 DATA ] ), expand ( ADDRESS ), verify ( ADDRESS ), help ( [ $subject ] ),
16052 quit ()
16053
16054 =item ADDRESSES
16055
16056 =item SEE ALSO
16057
16058 =item AUTHOR
16059
16060 =item COPYRIGHT
16061
16062 =back
16063
16064 =head2 Net::Time - time and daytime network client interface
16065
16066 =over 4
16067
16068 =item SYNOPSIS
16069
16070 =item DESCRIPTION
16071
16072 inet_time ( [HOST [, PROTOCOL [, TIMEOUT]]]), inet_daytime ( [HOST [,
16073 PROTOCOL [, TIMEOUT]]])
16074
16075 =item AUTHOR
16076
16077 =item COPYRIGHT
16078
16079 =back
16080
16081 =head2 Net::hostent - by-name interface to Perl's built-in gethost*()
16082 functions
16083
16084 =over 4
16085
16086 =item SYNOPSIS
16087
16088 =item DESCRIPTION
16089
16090 =item EXAMPLES
16091
16092 =item NOTE
16093
16094 =item AUTHOR
16095
16096 =back
16097
16098 =head2 Net::libnetFAQ, libnetFAQ - libnet Frequently Asked Questions
16099
16100 =over 4
16101
16102 =item DESCRIPTION
16103
16104 =over 4
16105
16106 =item Where to get this document
16107
16108 =item How to contribute to this document
16109
16110 =back
16111
16112 =item Author and Copyright Information
16113
16114 =over 4
16115
16116 =item Disclaimer
16117
16118 =back
16119
16120 =item Obtaining and installing libnet
16121
16122 =over 4
16123
16124 =item What is libnet ?
16125
16126 =item Which version of perl do I need ?
16127
16128 =item What other modules do I need ?
16129
16130 =item What machines support libnet ?
16131
16132 =item Where can I get the latest libnet release
16133
16134 =back
16135
16136 =item Using Net::FTP
16137
16138 =over 4
16139
16140 =item How do I download files from an FTP server ?
16141
16142 =item How do I transfer files in binary mode ?
16143
16144 =item How can I get the size of a file on a remote FTP server ?
16145
16146 =item How can I get the modification time of a file on a remote FTP server
16147 ?
16148
16149 =item How can I change the permissions of a file on a remote server ?
16150
16151 =item Can I do a reget operation like the ftp command ?
16152
16153 =item How do I get a directory listing from an FTP server ?
16154
16155 =item Changing directory to "" does not fail ?
16156
16157 =item I am behind a SOCKS firewall, but the Firewall option does not work ?
16158
16159 =item I am behind an FTP proxy firewall, but cannot access machines outside
16160 ?
16161
16162 =item My ftp proxy firewall does not listen on port 21
16163
16164 =item Is it possible to change the file permissions of a file on an FTP
16165 server ?
16166
16167 =item I have seen scripts call a method message, but cannot find it
16168 documented ?
16169
16170 =item Why does Net::FTP not implement mput and mget methods
16171
16172 =back
16173
16174 =item Using Net::SMTP
16175
16176 =over 4
16177
16178 =item Why can't the part of an Email address after the @ be used as the
16179 hostname ?
16180
16181 =item Why does Net::SMTP not do DNS MX lookups ?
16182
16183 =item The verify method always returns true ?
16184
16185 =back
16186
16187 =item Debugging scripts
16188
16189 =over 4
16190
16191 =item How can I debug my scripts that use Net::* modules ?
16192
16193 =back
16194
16195 =item AUTHOR AND COPYRIGHT
16196
16197 =back
16198
16199 =head2 Net::netent - by-name interface to Perl's built-in getnet*()
16200 functions
16201
16202 =over 4
16203
16204 =item SYNOPSIS
16205
16206 =item DESCRIPTION
16207
16208 =item EXAMPLES
16209
16210 =item NOTE
16211
16212 =item AUTHOR
16213
16214 =back
16215
16216 =head2 Net::protoent - by-name interface to Perl's built-in getproto*()
16217 functions
16218
16219 =over 4
16220
16221 =item SYNOPSIS
16222
16223 =item DESCRIPTION
16224
16225 =item NOTE
16226
16227 =item AUTHOR
16228
16229 =back
16230
16231 =head2 Net::servent - by-name interface to Perl's built-in getserv*()
16232 functions
16233
16234 =over 4
16235
16236 =item SYNOPSIS
16237
16238 =item DESCRIPTION
16239
16240 =item EXAMPLES
16241
16242 =item NOTE
16243
16244 =item AUTHOR
16245
16246 =back
16247
16248 =head2 Netrc, Net::Netrc - OO interface to users netrc file
16249
16250 =over 4
16251
16252 =item SYNOPSIS
16253
16254 =item DESCRIPTION
16255
16256 =item THE .netrc FILE
16257
16258 machine name, default, login name, password string, account string, macdef
16259 name
16260
16261 =item CONSTRUCTOR
16262
16263 lookup ( MACHINE [, LOGIN ])
16264
16265 =item METHODS
16266
16267 login (), password (), account (), lpa ()
16268
16269 =item AUTHOR
16270
16271 =item SEE ALSO
16272
16273 =item COPYRIGHT
16274
16275 =back
16276
16277 =head2 O - Generic interface to Perl Compiler backends
16278
16279 =over 4
16280
16281 =item SYNOPSIS
16282
16283 =item DESCRIPTION
16284
16285 =item CONVENTIONS
16286
16287 =item IMPLEMENTATION
16288
16289 =item BUGS
16290
16291 =item AUTHOR
16292
16293 =back
16294
16295 =head2 ODBM_File - Tied access to odbm files
16296
16297 =over 4
16298
16299 =item SYNOPSIS
16300
16301 =item DESCRIPTION
16302
16303 C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR>
16304
16305 =item DIAGNOSTICS
16306
16307 =over 4
16308
16309 =item C<odbm store returned -1, errno 22, key "..." at ...>
16310
16311 =back
16312
16313 =item BUGS AND WARNINGS
16314
16315 =back
16316
16317 =head2 Opcode - Disable named opcodes when compiling perl code
16318
16319 =over 4
16320
16321 =item SYNOPSIS
16322
16323 =item DESCRIPTION
16324
16325 =item NOTE
16326
16327 =item WARNING
16328
16329 =item Operator Names and Operator Lists
16330
16331 an operator name (opname), an operator tag name (optag), a negated opname
16332 or optag, an operator set (opset)
16333
16334 =item Opcode Functions
16335
16336 opcodes, opset (OP, ...), opset_to_ops (OPSET), opset_to_hex (OPSET),
16337 full_opset, empty_opset, invert_opset (OPSET), verify_opset (OPSET, ...),
16338 define_optag (OPTAG, OPSET), opmask_add (OPSET), opmask, opdesc (OP, ...),
16339 opdump (PAT)
16340
16341 =item Manipulating Opsets
16342
16343 =item TO DO (maybe)
16344
16345 =back
16346
16347 =over 4
16348
16349 =item Predefined Opcode Tags
16350
16351 :base_core, :base_mem, :base_loop, :base_io, :base_orig, :base_math,
16352 :base_thread, :default, :filesys_read, :sys_db, :browse, :filesys_open,
16353 :filesys_write, :subprocess, :ownprocess, :others, :still_to_be_decided,
16354 :dangerous
16355
16356 =item SEE ALSO
16357
16358 =item AUTHORS
16359
16360 =back
16361
16362 =head2 Opcode::Safe, Safe - Compile and execute code in restricted
16363 compartments
16364
16365 =over 4
16366
16367 =item SYNOPSIS
16368
16369 =item DESCRIPTION
16370
16371 a new namespace, an operator mask
16372
16373 =item WARNING
16374
16375 =over 4
16376
16377 =item RECENT CHANGES
16378
16379 =item Methods in class Safe
16380
16381 permit (OP, ...), permit_only (OP, ...), deny (OP, ...), deny_only (OP,
16382 ...), trap (OP, ...), untrap (OP, ...), share (NAME, ...), share_from
16383 (PACKAGE, ARRAYREF), varglob (VARNAME), reval (STRING), rdo (FILENAME),
16384 root (NAMESPACE), mask (MASK)
16385
16386 =item Some Safety Issues
16387
16388 Memory, CPU, Snooping, Signals, State Changes
16389
16390 =item AUTHOR
16391
16392 =back
16393
16394 =back
16395
16396 =head2 Opcode::ops, ops - Perl pragma to restrict unsafe operations when
16397 compiling
16398
16399 =over 4
16400
16401 =item SYNOPSIS
16402
16403 =item DESCRIPTION
16404
16405 =item SEE ALSO
16406
16407 =back
16408
16409 =head2 POSIX - Perl interface to IEEE Std 1003.1
16410
16411 =over 4
16412
16413 =item SYNOPSIS
16414
16415 =item DESCRIPTION
16416
16417 =item NOTE
16418
16419 =item CAVEATS
16420
16421 =item FUNCTIONS
16422
16423 _exit, abort, abs, access, acos, alarm, asctime, asin, assert, atan, atan2,
16424 atexit, atof, atoi, atol, bsearch, calloc, ceil, chdir, chmod, chown,
16425 clearerr, clock, close, closedir, cos, cosh, creat, ctermid, ctime,
16426 cuserid, difftime, div, dup, dup2, errno, execl, execle, execlp, execv,
16427 execve, execvp, exit, exp, fabs, fclose, fcntl, fdopen, feof, ferror,
16428 fflush, fgetc, fgetpos, fgets, fileno, floor, fmod, fopen, fork, fpathconf,
16429 fprintf, fputc, fputs, fread, free, freopen, frexp, fscanf, fseek, fsetpos,
16430 fstat, ftell, fwrite, getc, getchar, getcwd, getegid, getenv, geteuid,
16431 getgid, getgrgid, getgrnam, getgroups, getlogin, getpgrp, getpid, getppid,
16432 getpwnam, getpwuid, gets, getuid, gmtime, isalnum, isalpha, isatty,
16433 iscntrl, isdigit, isgraph, islower, isprint, ispunct, isspace, isupper,
16434 isxdigit, kill, labs, ldexp, ldiv, link, localeconv, localtime, log, log10,
16435 longjmp, lseek, malloc, mblen, mbstowcs, mbtowc, memchr, memcmp, memcpy,
16436 memmove, memset, mkdir, mkfifo, mktime, modf, nice, offsetof, open,
16437 opendir, pathconf, pause, perror, pipe, pow, printf, putc, putchar, puts,
16438 qsort, raise, rand, read, readdir, realloc, remove, rename, rewind,
16439 rewinddir, rmdir, scanf, setgid, setjmp, setlocale, setpgid, setsid,
16440 setuid, sigaction, siglongjmp, sigpending, sigprocmask, sigsetjmp,
16441 sigsuspend, sin, sinh, sleep, sprintf, sqrt, srand, sscanf, stat, strcat,
16442 strchr, strcmp, strcoll, strcpy, strcspn, strerror, strftime, strlen,
16443 strncat, strncmp, strncpy, strpbrk, strrchr, strspn, strstr, strtod,
16444 strtok, strtol, strtoul, strxfrm, sysconf, system, tan, tanh, tcdrain,
16445 tcflow, tcflush, tcgetpgrp, tcsendbreak, tcsetpgrp, time, times, tmpfile,
16446 tmpnam, tolower, toupper, ttyname, tzname, tzset, umask, uname, ungetc,
16447 unlink, utime, vfprintf, vprintf, vsprintf, wait, waitpid, wcstombs,
16448 wctomb, write
16449
16450 =item CLASSES
16451
16452 =over 4
16453
16454 =item POSIX::SigAction
16455
16456 new
16457
16458 =item POSIX::SigSet
16459
16460 new, addset, delset, emptyset, fillset, ismember
16461
16462 =item POSIX::Termios
16463
16464 new, getattr, getcc, getcflag, getiflag, getispeed, getlflag, getoflag,
16465 getospeed, setattr, setcc, setcflag, setiflag, setispeed, setlflag,
16466 setoflag, setospeed, Baud rate values, Terminal interface values, c_cc
16467 field values, c_cflag field values, c_iflag field values, c_lflag field
16468 values, c_oflag field values
16469
16470 =back
16471
16472 =item PATHNAME CONSTANTS
16473
16474 Constants
16475
16476 =item POSIX CONSTANTS
16477
16478 Constants
16479
16480 =item SYSTEM CONFIGURATION
16481
16482 Constants
16483
16484 =item ERRNO
16485
16486 Constants
16487
16488 =item FCNTL
16489
16490 Constants
16491
16492 =item FLOAT
16493
16494 Constants
16495
16496 =item LIMITS
16497
16498 Constants
16499
16500 =item LOCALE
16501
16502 Constants
16503
16504 =item MATH
16505
16506 Constants
16507
16508 =item SIGNAL
16509
16510 Constants
16511
16512 =item STAT
16513
16514 Constants, Macros
16515
16516 =item STDLIB
16517
16518 Constants
16519
16520 =item STDIO
16521
16522 Constants
16523
16524 =item TIME
16525
16526 Constants
16527
16528 =item UNISTD
16529
16530 Constants
16531
16532 =item WAIT
16533
16534 Constants, WNOHANG, WUNTRACED, Macros, WIFEXITED, WEXITSTATUS, WIFSIGNALED,
16535 WTERMSIG, WIFSTOPPED, WSTOPSIG
16536
16537 =back
16538
16539 =head2 PerlIO - On demand loader for PerlIO layers and root of PerlIO::*
16540 name space
16541
16542 =over 4
16543
16544 =item SYNOPSIS
16545
16546 =item DESCRIPTION
16547
16548 unix, stdio, perlio, crlf, utf8, bytes, raw, pop
16549
16550 =over 4
16551
16552 =item Alternatives to raw
16553
16554 =item Defaults and how to override them
16555
16556 =back
16557
16558 =item AUTHOR
16559
16560 =item SEE ALSO
16561
16562 =back
16563
16564 =head2 PerlIO::encoding - encoding layer
16565
16566 =over 4
16567
16568 =item SYNOPSIS
16569
16570 =item DESCRIPTION
16571
16572 =item SEE ALSO
16573
16574 =back
16575
16576 =head2 PerlIO::scalar - support module for in-memory IO.
16577
16578 =over 4
16579
16580 =item SYNOPSIS
16581
16582 =item DESCRIPTION
16583
16584 =back
16585
16586 =head2 PerlIO::via - Helper class for PerlIO layers implemented in perl
16587
16588 =over 4
16589
16590 =item SYNOPSIS
16591
16592 =item DESCRIPTION
16593
16594 =item EXPECTED METHODS
16595
16596 $class->PUSHED([$mode[,$fh]]), $obj->POPPED([$fh]),
16597 $obj->OPEN($path,$mode[,$fh]), $obj->BINMODE([,$fh]),
16598 $obj->FDOPEN($fd[,$fh]), $obj->SYSOPEN($path,$imode,$perm,[,$fh]),
16599 $obj->FILENO($fh), $obj->READ($buffer,$len,$fh), $obj->WRITE($buffer,$fh),
16600 $obj->FILL($fh), $obj->CLOSE($fh), $obj->SEEK($posn,$whence,$fh),
16601 $obj->TELL($fh), $obj->UNREAD($buffer,$fh), $obj->FLUSH($fh),
16602 $obj->SETLINEBUF($fh), $obj->CLEARERR($fh), $obj->ERROR($fh),
16603 $obj->EOF($fh)
16604
16605 =item EXAMPLES
16606
16607 =over 4
16608
16609 =item Example - a Hexadecimal Handle
16610
16611 =back
16612
16613 =back
16614
16615 =head2 PerlIO::via::QuotedPrint - PerlIO layer for quoted-printable strings
16616
16617 =over 4
16618
16619 =item SYNOPSIS
16620
16621 =item DESCRIPTION
16622
16623 =item SEE ALSO
16624
16625 =item COPYRIGHT
16626
16627 =back
16628
16629 =head2 Pod::Checker, podchecker() - check pod documents for syntax errors
16630
16631 =over 4
16632
16633 =item SYNOPSIS
16634
16635 =item OPTIONS/ARGUMENTS
16636
16637 =over 4
16638
16639 =item podchecker()
16640
16641 B<-warnings> =E<gt> I<val>
16642
16643 =back
16644
16645 =item DESCRIPTION
16646
16647 =item DIAGNOSTICS
16648
16649 =over 4
16650
16651 =item Errors
16652
16653 empty =headn, =over on line I<N> without closing =back, =item without
16654 previous =over, =back without previous =over, No argument for =begin, =end
16655 without =begin, Nested =begin's, =for without formatter specification,
16656 unresolved internal link I<NAME>, Unknown command "I<CMD>", Unknown
16657 interior-sequence "I<SEQ>", nested commands
16658 I<CMD>E<lt>...I<CMD>E<lt>...E<gt>...E<gt>, garbled entity I<STRING>, Entity
16659 number out of range, malformed link LE<lt>E<gt>, nonempty ZE<lt>E<gt>,
16660 empty XE<lt>E<gt>, Spurious text after =pod / =cut, Spurious character(s)
16661 after =back
16662
16663 =item Warnings
16664
16665 multiple occurrence of link target I<name>, line containing nothing but
16666 whitespace in paragraph, file does not start with =head, previous =item has
16667 no contents, preceding non-item paragraph(s), =item type mismatch (I<one>
16668 vs. I<two>), I<N> unescaped C<E<lt>E<gt>> in paragraph, Unknown entity, No
16669 items in =over, No argument for =item, empty section in previous paragraph,
16670 Verbatim paragraph in NAME section
16671
16672 =item Hyperlinks
16673
16674 ignoring leading/trailing whitespace in link, (section) in '$page'
16675 deprecated, alternative text/node '%s' contains non-escaped | or /
16676
16677 =back
16678
16679 =item RETURN VALUE
16680
16681 =item EXAMPLES
16682
16683 =item INTERFACE
16684
16685 =back
16686
16687 C<Pod::Checker-E<gt>new( %options )>
16688
16689 C<$checker-E<gt>poderror( @args )>, C<$checker-E<gt>poderror( {%opts},
16690 @args )>
16691
16692 C<$checker-E<gt>num_errors()>
16693
16694 C<$checker-E<gt>name()>
16695
16696 C<$checker-E<gt>node()>
16697
16698 C<$checker-E<gt>idx()>
16699
16700 C<$checker-E<gt>hyperlink()>
16701
16702 =over 4
16703
16704 =item AUTHOR
16705
16706 =back
16707
16708 =head2 Pod::Find - find POD documents in directory trees
16709
16710 =over 4
16711
16712 =item SYNOPSIS
16713
16714 =item DESCRIPTION
16715
16716 =back
16717
16718 =over 4
16719
16720 =item C<pod_find( { %opts } , @directories )>
16721
16722 C<-verbose =E<gt> 1>, C<-perl =E<gt> 1>, C<-script =E<gt> 1>, C<-inc =E<gt>
16723 1>
16724
16725 =back
16726
16727 =over 4
16728
16729 =item C<simplify_name( $str )>
16730
16731 =back
16732
16733 =over 4
16734
16735 =item C<pod_where( { %opts }, $pod )>
16736
16737 C<-inc =E<gt> 1>, C<-dirs =E<gt> [ $dir1, $dir2, ... ]>, C<-verbose =E<gt>
16738 1>
16739
16740 =back
16741
16742 =over 4
16743
16744 =item C<contains_pod( $file , $verbose )>
16745
16746 =back
16747
16748 =over 4
16749
16750 =item AUTHOR
16751
16752 =item SEE ALSO
16753
16754 =back
16755
16756 =head2 Pod::Html - module to convert pod files to HTML
16757
16758 =over 4
16759
16760 =item SYNOPSIS
16761
16762 =item DESCRIPTION
16763
16764 =item ARGUMENTS
16765
16766 backlink, cachedir, css, flush, header, help, htmldir, htmlroot, index,
16767 infile, libpods, netscape, outfile, podpath, podroot, quiet, recurse,
16768 title, verbose
16769
16770 =item EXAMPLE
16771
16772 =item ENVIRONMENT
16773
16774 =item AUTHOR
16775
16776 =item SEE ALSO
16777
16778 =item COPYRIGHT
16779
16780 =back
16781
16782 =head2 Pod::InputObjects - objects representing POD input paragraphs,
16783 commands, etc.
16784
16785 =over 4
16786
16787 =item SYNOPSIS
16788
16789 =item REQUIRES
16790
16791 =item EXPORTS
16792
16793 =item DESCRIPTION
16794
16795 package B<Pod::InputSource>, package B<Pod::Paragraph>, package
16796 B<Pod::InteriorSequence>, package B<Pod::ParseTree>
16797
16798 =back
16799
16800 =over 4
16801
16802 =item B<Pod::InputSource>
16803
16804 =back
16805
16806 =over 4
16807
16808 =item B<new()>
16809
16810 =back
16811
16812 =over 4
16813
16814 =item B<name()>
16815
16816 =back
16817
16818 =over 4
16819
16820 =item B<handle()>
16821
16822 =back
16823
16824 =over 4
16825
16826 =item B<was_cutting()>
16827
16828 =back
16829
16830 =over 4
16831
16832 =item B<Pod::Paragraph>
16833
16834 =back
16835
16836 =over 4
16837
16838 =item Pod::Paragraph-E<gt>B<new()>
16839
16840 =back
16841
16842 =over 4
16843
16844 =item $pod_para-E<gt>B<cmd_name()>
16845
16846 =back
16847
16848 =over 4
16849
16850 =item $pod_para-E<gt>B<text()>
16851
16852 =back
16853
16854 =over 4
16855
16856 =item $pod_para-E<gt>B<raw_text()>
16857
16858 =back
16859
16860 =over 4
16861
16862 =item $pod_para-E<gt>B<cmd_prefix()>
16863
16864 =back
16865
16866 =over 4
16867
16868 =item $pod_para-E<gt>B<cmd_separator()>
16869
16870 =back
16871
16872 =over 4
16873
16874 =item $pod_para-E<gt>B<parse_tree()>
16875
16876 =back
16877
16878 =over 4
16879
16880 =item $pod_para-E<gt>B<file_line()>
16881
16882 =back
16883
16884 =over 4
16885
16886 =item B<Pod::InteriorSequence>
16887
16888 =back
16889
16890 =over 4
16891
16892 =item Pod::InteriorSequence-E<gt>B<new()>
16893
16894 =back
16895
16896 =over 4
16897
16898 =item $pod_seq-E<gt>B<cmd_name()>
16899
16900 =back
16901
16902 =over 4
16903
16904 =item $pod_seq-E<gt>B<prepend()>
16905
16906 =back
16907
16908 =over 4
16909
16910 =item $pod_seq-E<gt>B<append()>
16911
16912 =back
16913
16914 =over 4
16915
16916 =item $pod_seq-E<gt>B<nested()>
16917
16918 =back
16919
16920 =over 4
16921
16922 =item $pod_seq-E<gt>B<raw_text()>
16923
16924 =back
16925
16926 =over 4
16927
16928 =item $pod_seq-E<gt>B<left_delimiter()>
16929
16930 =back
16931
16932 =over 4
16933
16934 =item $pod_seq-E<gt>B<right_delimiter()>
16935
16936 =back
16937
16938 =over 4
16939
16940 =item $pod_seq-E<gt>B<parse_tree()>
16941
16942 =back
16943
16944 =over 4
16945
16946 =item $pod_seq-E<gt>B<file_line()>
16947
16948 =back
16949
16950 =over 4
16951
16952 =item Pod::InteriorSequence::B<DESTROY()>
16953
16954 =back
16955
16956 =over 4
16957
16958 =item B<Pod::ParseTree>
16959
16960 =back
16961
16962 =over 4
16963
16964 =item Pod::ParseTree-E<gt>B<new()>
16965
16966 =back
16967
16968 =over 4
16969
16970 =item $ptree-E<gt>B<top()>
16971
16972 =back
16973
16974 =over 4
16975
16976 =item $ptree-E<gt>B<children()>
16977
16978 =back
16979
16980 =over 4
16981
16982 =item $ptree-E<gt>B<prepend()>
16983
16984 =back
16985
16986 =over 4
16987
16988 =item $ptree-E<gt>B<append()>
16989
16990 =back
16991
16992 =over 4
16993
16994 =item $ptree-E<gt>B<raw_text()>
16995
16996 =back
16997
16998 =over 4
16999
17000 =item Pod::ParseTree::B<DESTROY()>
17001
17002 =back
17003
17004 =over 4
17005
17006 =item SEE ALSO
17007
17008 =item AUTHOR
17009
17010 =back
17011
17012 =head2 Pod::LaTeX - Convert Pod data to formatted Latex
17013
17014 =over 4
17015
17016 =item SYNOPSIS
17017
17018 =item DESCRIPTION
17019
17020 =back
17021
17022 =over 4
17023
17024 =item OBJECT METHODS
17025
17026 C<initialize>
17027
17028 =back
17029
17030 =over 4
17031
17032 =item Data Accessors
17033
17034 B<AddPreamble>
17035
17036 =back
17037
17038 B<AddPostamble>
17039
17040 B<Head1Level>
17041
17042 B<Label>
17043
17044 B<LevelNoNum>
17045
17046 B<MakeIndex>
17047
17048 B<ReplaceNAMEwithSection>
17049
17050 B<StartWithNewPage>
17051
17052 B<TableOfContents>
17053
17054 B<UniqueLabels>
17055
17056 B<UserPreamble>
17057
17058 B<UserPostamble>
17059
17060 B<Lists>
17061
17062 =over 4
17063
17064 =item Subclassed methods
17065
17066 =back
17067
17068 B<begin_pod>
17069
17070 B<end_pod>
17071
17072 B<command>
17073
17074 B<verbatim>
17075
17076 B<textblock>
17077
17078 B<interior_sequence>
17079
17080 =over 4
17081
17082 =item List Methods
17083
17084 B<begin_list>
17085
17086 =back
17087
17088 B<end_list>
17089
17090 B<add_item>
17091
17092 =over 4
17093
17094 =item Methods for headings
17095
17096 B<head>
17097
17098 =back
17099
17100 =over 4
17101
17102 =item Internal methods
17103
17104 B<_output>
17105
17106 =back
17107
17108 B<_replace_special_chars>
17109
17110 B<_replace_special_chars_late>
17111
17112 B<_create_label>
17113
17114 B<_create_index>
17115
17116 B<_clean_latex_commands>
17117
17118 B<_split_delimited>
17119
17120 =over 4
17121
17122 =item NOTES
17123
17124 =item SEE ALSO
17125
17126 =item AUTHORS
17127
17128 =item COPYRIGHT
17129
17130 =item REVISION
17131
17132 =back
17133
17134 =head2 Pod::Man - Convert POD data to formatted *roff input
17135
17136 =over 4
17137
17138 =item SYNOPSIS
17139
17140 =item DESCRIPTION
17141
17142 center, date, fixed, fixedbold, fixeditalic, fixedbolditalic, name, quotes,
17143 release, section
17144
17145 =item DIAGNOSTICS
17146
17147 roff font should be 1 or 2 chars, not "%s", Invalid link %s, Invalid quote
17148 specification "%s", %s:%d: Unknown command paragraph "%s", %s:%d: Unknown
17149 escape EE<lt>%sE<gt>, %s:%d: Unknown formatting code %s, %s:%d: Unmatched
17150 =back
17151
17152 =item BUGS
17153
17154 =item CAVEATS
17155
17156 =item SEE ALSO
17157
17158 =item AUTHOR
17159
17160 =item COPYRIGHT AND LICENSE
17161
17162 =back
17163
17164 =head2 Pod::ParseLink - Parse an LE<lt>E<gt> formatting code in POD text
17165
17166 =over 4
17167
17168 =item SYNOPSIS
17169
17170 =item DESCRIPTION
17171
17172 =item SEE ALSO
17173
17174 =item AUTHOR
17175
17176 =item COPYRIGHT AND LICENSE
17177
17178 =back
17179
17180 =head2 Pod::ParseUtils - helpers for POD parsing and conversion
17181
17182 =over 4
17183
17184 =item SYNOPSIS
17185
17186 =item DESCRIPTION
17187
17188 =back
17189
17190 =over 4
17191
17192 =item Pod::List
17193
17194 Pod::List-E<gt>new()
17195
17196 =back
17197
17198 $list-E<gt>file()
17199
17200 $list-E<gt>start()
17201
17202 $list-E<gt>indent()
17203
17204 $list-E<gt>type()
17205
17206 $list-E<gt>rx()
17207
17208 $list-E<gt>item()
17209
17210 $list-E<gt>parent()
17211
17212 $list-E<gt>tag()
17213
17214 =over 4
17215
17216 =item Pod::Hyperlink
17217
17218 Pod::Hyperlink-E<gt>new()
17219
17220 =back
17221
17222 $link-E<gt>parse($string)
17223
17224 $link-E<gt>markup($string)
17225
17226 $link-E<gt>text()
17227
17228 $link-E<gt>warning()
17229
17230 $link-E<gt>file(), $link-E<gt>line()
17231
17232 $link-E<gt>page()
17233
17234 $link-E<gt>node()
17235
17236 $link-E<gt>alttext()
17237
17238 $link-E<gt>type()
17239
17240 $link-E<gt>link()
17241
17242 =over 4
17243
17244 =item Pod::Cache
17245
17246 Pod::Cache-E<gt>new()
17247
17248 =back
17249
17250 $cache-E<gt>item()
17251
17252 $cache-E<gt>find_page($name)
17253
17254 =over 4
17255
17256 =item Pod::Cache::Item
17257
17258 Pod::Cache::Item-E<gt>new()
17259
17260 =back
17261
17262 $cacheitem-E<gt>page()
17263
17264 $cacheitem-E<gt>description()
17265
17266 $cacheitem-E<gt>path()
17267
17268 $cacheitem-E<gt>file()
17269
17270 $cacheitem-E<gt>nodes()
17271
17272 $cacheitem-E<gt>find_node($name)
17273
17274 $cacheitem-E<gt>idx()
17275
17276 =over 4
17277
17278 =item AUTHOR
17279
17280 =item SEE ALSO
17281
17282 =back
17283
17284 =head2 Pod::Parser - base class for creating POD filters and translators
17285
17286 =over 4
17287
17288 =item SYNOPSIS
17289
17290 =item REQUIRES
17291
17292 =item EXPORTS
17293
17294 =item DESCRIPTION
17295
17296 =item QUICK OVERVIEW
17297
17298 =item PARSING OPTIONS
17299
17300 B<-want_nonPODs> (default: unset), B<-process_cut_cmd> (default: unset),
17301 B<-warnings> (default: unset)
17302
17303 =back
17304
17305 =over 4
17306
17307 =item RECOMMENDED SUBROUTINE/METHOD OVERRIDES
17308
17309 =back
17310
17311 =over 4
17312
17313 =item B<command()>
17314
17315 C<$cmd>, C<$text>, C<$line_num>, C<$pod_para>
17316
17317 =back
17318
17319 =over 4
17320
17321 =item B<verbatim()>
17322
17323 C<$text>, C<$line_num>, C<$pod_para>
17324
17325 =back
17326
17327 =over 4
17328
17329 =item B<textblock()>
17330
17331 C<$text>, C<$line_num>, C<$pod_para>
17332
17333 =back
17334
17335 =over 4
17336
17337 =item B<interior_sequence()>
17338
17339 =back
17340
17341 =over 4
17342
17343 =item OPTIONAL SUBROUTINE/METHOD OVERRIDES
17344
17345 =back
17346
17347 =over 4
17348
17349 =item B<new()>
17350
17351 =back
17352
17353 =over 4
17354
17355 =item B<initialize()>
17356
17357 =back
17358
17359 =over 4
17360
17361 =item B<begin_pod()>
17362
17363 =back
17364
17365 =over 4
17366
17367 =item B<begin_input()>
17368
17369 =back
17370
17371 =over 4
17372
17373 =item B<end_input()>
17374
17375 =back
17376
17377 =over 4
17378
17379 =item B<end_pod()>
17380
17381 =back
17382
17383 =over 4
17384
17385 =item B<preprocess_line()>
17386
17387 =back
17388
17389 =over 4
17390
17391 =item B<preprocess_paragraph()>
17392
17393 =back
17394
17395 =over 4
17396
17397 =item METHODS FOR PARSING AND PROCESSING
17398
17399 =back
17400
17401 =over 4
17402
17403 =item B<parse_text()>
17404
17405 B<-expand_seq> =E<gt> I<code-ref>|I<method-name>, B<-expand_text> =E<gt>
17406 I<code-ref>|I<method-name>, B<-expand_ptree> =E<gt>
17407 I<code-ref>|I<method-name>
17408
17409 =back
17410
17411 =over 4
17412
17413 =item B<interpolate()>
17414
17415 =back
17416
17417 =over 4
17418
17419 =item B<parse_paragraph()>
17420
17421 =back
17422
17423 =over 4
17424
17425 =item B<parse_from_filehandle()>
17426
17427 =back
17428
17429 =over 4
17430
17431 =item B<parse_from_file()>
17432
17433 =back
17434
17435 =over 4
17436
17437 =item ACCESSOR METHODS
17438
17439 =back
17440
17441 =over 4
17442
17443 =item B<errorsub()>
17444
17445 =back
17446
17447 =over 4
17448
17449 =item B<cutting()>
17450
17451 =back
17452
17453 =over 4
17454
17455 =item B<parseopts()>
17456
17457 =back
17458
17459 =over 4
17460
17461 =item B<output_file()>
17462
17463 =back
17464
17465 =over 4
17466
17467 =item B<output_handle()>
17468
17469 =back
17470
17471 =over 4
17472
17473 =item B<input_file()>
17474
17475 =back
17476
17477 =over 4
17478
17479 =item B<input_handle()>
17480
17481 =back
17482
17483 =over 4
17484
17485 =item B<input_streams()>
17486
17487 =back
17488
17489 =over 4
17490
17491 =item B<top_stream()>
17492
17493 =back
17494
17495 =over 4
17496
17497 =item PRIVATE METHODS AND DATA
17498
17499 =back
17500
17501 =over 4
17502
17503 =item B<_push_input_stream()>
17504
17505 =back
17506
17507 =over 4
17508
17509 =item B<_pop_input_stream()>
17510
17511 =back
17512
17513 =over 4
17514
17515 =item TREE-BASED PARSING
17516
17517 =item SEE ALSO
17518
17519 =item AUTHOR
17520
17521 =back
17522
17523 =head2 Pod::Plainer - Perl extension for converting Pod to old style Pod.
17524
17525 =over 4
17526
17527 =item SYNOPSIS
17528
17529 =item DESCRIPTION
17530
17531 =over 4
17532
17533 =item EXPORT
17534
17535 =back
17536
17537 =item AUTHOR
17538
17539 =item SEE ALSO
17540
17541 =back
17542
17543 =head2 Pod::Select, podselect() - extract selected sections of POD from
17544 input
17545
17546 =over 4
17547
17548 =item SYNOPSIS
17549
17550 =item REQUIRES
17551
17552 =item EXPORTS
17553
17554 =item DESCRIPTION
17555
17556 =item SECTION SPECIFICATIONS
17557
17558 =item RANGE SPECIFICATIONS
17559
17560 =back
17561
17562 =over 4
17563
17564 =item OBJECT METHODS
17565
17566 =back
17567
17568 =over 4
17569
17570 =item B<curr_headings()>
17571
17572 =back
17573
17574 =over 4
17575
17576 =item B<select()>
17577
17578 =back
17579
17580 =over 4
17581
17582 =item B<add_selection()>
17583
17584 =back
17585
17586 =over 4
17587
17588 =item B<clear_selections()>
17589
17590 =back
17591
17592 =over 4
17593
17594 =item B<match_section()>
17595
17596 =back
17597
17598 =over 4
17599
17600 =item B<is_selected()>
17601
17602 =back
17603
17604 =over 4
17605
17606 =item EXPORTED FUNCTIONS
17607
17608 =back
17609
17610 =over 4
17611
17612 =item B<podselect()>
17613
17614 B<-output>, B<-sections>, B<-ranges>
17615
17616 =back
17617
17618 =over 4
17619
17620 =item PRIVATE METHODS AND DATA
17621
17622 =back
17623
17624 =over 4
17625
17626 =item B<_compile_section_spec()>
17627
17628 =back
17629
17630 =over 4
17631
17632 =item $self->{_SECTION_HEADINGS}
17633
17634 =back
17635
17636 =over 4
17637
17638 =item $self->{_SELECTED_SECTIONS}
17639
17640 =back
17641
17642 =over 4
17643
17644 =item SEE ALSO
17645
17646 =item AUTHOR
17647
17648 =back
17649
17650 =head2 Pod::Text - Convert POD data to formatted ASCII text
17651
17652 =over 4
17653
17654 =item SYNOPSIS
17655
17656 =item DESCRIPTION
17657
17658 alt, code, indent, loose, quotes, sentence, width
17659
17660 =item DIAGNOSTICS
17661
17662 Bizarre space in item, Item called without tag, Can't open %s for reading:
17663 %s, Invalid quote specification "%s", %s:%d: Unknown command paragraph: %s,
17664 %s:%d: Unknown escape: %s, %s:%d: Unknown formatting code: %s, %s:%d:
17665 Unmatched =back
17666
17667 =item RESTRICTIONS
17668
17669 =item NOTES
17670
17671 =item SEE ALSO
17672
17673 =item AUTHOR
17674
17675 =item COPYRIGHT AND LICENSE
17676
17677 =back
17678
17679 =head2 Pod::Text::Color - Convert POD data to formatted color ASCII text
17680
17681 =over 4
17682
17683 =item SYNOPSIS
17684
17685 =item DESCRIPTION
17686
17687 =item BUGS
17688
17689 =item SEE ALSO
17690
17691 =item AUTHOR
17692
17693 =item COPYRIGHT AND LICENSE
17694
17695 =back
17696
17697 =head2 Pod::Text::Overstrike - Convert POD data to formatted overstrike
17698 text
17699
17700 =over 4
17701
17702 =item SYNOPSIS
17703
17704 =item DESCRIPTION
17705
17706 =item BUGS
17707
17708 =item SEE ALSO
17709
17710 =item AUTHOR
17711
17712 =item COPYRIGHT AND LICENSE
17713
17714 =back
17715
17716 =head2 Pod::Text::Termcap - Convert POD data to ASCII text with format
17717 escapes
17718
17719 =over 4
17720
17721 =item SYNOPSIS
17722
17723 =item DESCRIPTION
17724
17725 =item NOTES
17726
17727 =item SEE ALSO
17728
17729 =item AUTHOR
17730
17731 =item COPYRIGHT AND LICENSE
17732
17733 =back
17734
17735 =head2 Pod::Usage, pod2usage() - print a usage message from embedded pod
17736 documentation
17737
17738 =over 4
17739
17740 =item SYNOPSIS
17741
17742 =item ARGUMENTS
17743
17744 C<-message>, C<-msg>, C<-exitval>, C<-verbose>, C<-output>, C<-input>,
17745 C<-pathlist>
17746
17747 =item DESCRIPTION
17748
17749 =item EXAMPLES
17750
17751 =over 4
17752
17753 =item Recommended Use
17754
17755 =back
17756
17757 =item CAVEATS
17758
17759 =item AUTHOR
17760
17761 =item ACKNOWLEDGEMENTS
17762
17763 =back
17764
17765 =head2 Pod::t::basic, basic.pod - Test of various basic POD features in
17766 translators.
17767
17768 =over 4
17769
17770 =item HEADINGS
17771
17772 =item This C<is> a "level 1" heading
17773
17774 =over 4
17775
17776 =item ``Level'' "2 I<heading>
17777
17778 =back
17779
17780 =item This C<is> a "level 1" heading
17781
17782 =over 4
17783
17784 =item ``Level'' 2 I<heading>
17785
17786 =back
17787
17788 =item LINKS
17789
17790 =item OVER AND ITEMS
17791
17792 This  is a test, a, b, a, b, c, d, "foo", B<bar>, C<baz>, Some longer item
17793 text
17794
17795 =item FORMATTING CODES
17796
17797 E<amp>, E<apos>, E<lt>, E<gt>, E<quot>, E<sol>
17798
17799 =item VERBATIM
17800
17801 =item CONCLUSION
17802
17803 =back
17804
17805 =head2 Pod::t::htmlescp, Escape Sequences Test
17806
17807 =over 4
17808
17809 =item DESCRIPTION
17810
17811 =back
17812
17813 =head2 Pod::t::htmlview, Test HTML Rendering
17814
17815 =over 4
17816
17817 =item SYNOPSIS
17818
17819 =item DESCRIPTION
17820
17821 =item METHODS =E<gt> OTHER STUFF
17822
17823 =over 4
17824
17825 =item new()
17826
17827 foo, bar, baz, C<Black> Cat, Sat S<I<on> the>, MatE<lt>!E<gt>, 1 Cat, 2
17828 Sat, 3 Mat
17829
17830 =item old()
17831
17832 =back
17833
17834 =item TESTING FOR AND BEGIN
17835
17836 =item TESTING URLs hyperlinking
17837
17838 =item SEE ALSO
17839
17840 =back
17841
17842 =head2 SDBM_File - Tied access to sdbm files
17843
17844 =over 4
17845
17846 =item SYNOPSIS
17847
17848 =item DESCRIPTION
17849
17850 C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR>
17851
17852 =item DIAGNOSTICS
17853
17854 =over 4
17855
17856 =item C<sdbm store returned -1, errno 22, key "..." at ...>
17857
17858 =back
17859
17860 =item BUGS AND WARNINGS
17861
17862 =back
17863
17864 =head2 Safe - Compile and execute code in restricted compartments
17865
17866 =over 4
17867
17868 =item SYNOPSIS
17869
17870 =item DESCRIPTION
17871
17872 a new namespace, an operator mask
17873
17874 =item WARNING
17875
17876 =over 4
17877
17878 =item RECENT CHANGES
17879
17880 =item Methods in class Safe
17881
17882 permit (OP, ...), permit_only (OP, ...), deny (OP, ...), deny_only (OP,
17883 ...), trap (OP, ...), untrap (OP, ...), share (NAME, ...), share_from
17884 (PACKAGE, ARRAYREF), varglob (VARNAME), reval (STRING), rdo (FILENAME),
17885 root (NAMESPACE), mask (MASK)
17886
17887 =item Some Safety Issues
17888
17889 Memory, CPU, Snooping, Signals, State Changes
17890
17891 =item AUTHOR
17892
17893 =back
17894
17895 =back
17896
17897 =head2 Scalar::Util - A selection of general-utility scalar subroutines
17898
17899 =over 4
17900
17901 =item SYNOPSIS
17902
17903 =item DESCRIPTION
17904
17905 blessed EXPR, dualvar NUM, STRING, isweak EXPR, openhandle FH, reftype
17906 EXPR, tainted EXPR, weaken REF
17907
17908 =item KNOWN BUGS
17909
17910 =item COPYRIGHT
17911
17912 =item BLATANT PLUG
17913
17914 =back
17915
17916 =head2 Search::Dict, look - search for key in dictionary file
17917
17918 =over 4
17919
17920 =item SYNOPSIS
17921
17922 =item DESCRIPTION
17923
17924 =back
17925
17926 =head2 SelectSaver - save and restore selected file handle
17927
17928 =over 4
17929
17930 =item SYNOPSIS
17931
17932 =item DESCRIPTION
17933
17934 =back
17935
17936 =head2 SelfLoader - load functions only on demand
17937
17938 =over 4
17939
17940 =item SYNOPSIS
17941
17942 =item DESCRIPTION
17943
17944 =over 4
17945
17946 =item The __DATA__ token
17947
17948 =item SelfLoader autoloading
17949
17950 =item Autoloading and package lexicals
17951
17952 =item SelfLoader and AutoLoader
17953
17954 =item __DATA__, __END__, and the FOOBAR::DATA filehandle.
17955
17956 =item Classes and inherited methods.
17957
17958 =back
17959
17960 =item Multiple packages and fully qualified subroutine names
17961
17962 =back
17963
17964 =head2 Shell - run shell commands transparently within perl
17965
17966 =over 4
17967
17968 =item SYNOPSIS
17969
17970 =item DESCRIPTION
17971
17972 =over 4
17973
17974 =item OBJECT ORIENTED SYNTAX
17975
17976 =back
17977
17978 =item AUTHOR
17979
17980 =back
17981
17982 =head2 Socket, sockaddr_in, sockaddr_un, inet_aton, inet_ntoa - load the C
17983 socket.h defines and structure manipulators
17984
17985 =over 4
17986
17987 =item SYNOPSIS
17988
17989 =item DESCRIPTION
17990
17991 inet_aton HOSTNAME, inet_ntoa IP_ADDRESS, INADDR_ANY, INADDR_BROADCAST,
17992 INADDR_LOOPBACK, INADDR_NONE, sockaddr_family SOCKADDR, sockaddr_in PORT,
17993 ADDRESS, sockaddr_in SOCKADDR_IN, pack_sockaddr_in PORT, IP_ADDRESS,
17994 unpack_sockaddr_in SOCKADDR_IN, sockaddr_un PATHNAME, sockaddr_un
17995 SOCKADDR_UN, pack_sockaddr_un PATH, unpack_sockaddr_un SOCKADDR_UN
17996
17997 =back
17998
17999 =head2 Storable - persistence for Perl data structures
18000
18001 =over 4
18002
18003 =item SYNOPSIS
18004
18005 =item DESCRIPTION
18006
18007 =item MEMORY STORE
18008
18009 =item ADVISORY LOCKING
18010
18011 =item SPEED
18012
18013 =item CANONICAL REPRESENTATION
18014
18015 =item FORWARD COMPATIBILITY
18016
18017 utf8 data, restricted hashes, files from future versions of Storable
18018
18019 =item ERROR REPORTING
18020
18021 =item WIZARDS ONLY
18022
18023 =over 4
18024
18025 =item Hooks
18026
18027 C<STORABLE_freeze> I<obj>, I<cloning>, C<STORABLE_thaw> I<obj>, I<cloning>,
18028 I<serialized>, ..
18029
18030 =item Predicates
18031
18032 C<Storable::last_op_in_netorder>, C<Storable::is_storing>,
18033 C<Storable::is_retrieving>
18034
18035 =item Recursion
18036
18037 =item Deep Cloning
18038
18039 =back
18040
18041 =item Storable magic
18042
18043 =item EXAMPLES
18044
18045 =item WARNING
18046
18047 =item BUGS
18048
18049 =over 4
18050
18051 =item 64 bit data in perl 5.6.0 and 5.6.1
18052
18053 =back
18054
18055 =item CREDITS
18056
18057 =item AUTHOR
18058
18059 =item SEE ALSO
18060
18061 =back
18062
18063 =head2 Switch - A switch statement for Perl
18064
18065 =over 4
18066
18067 =item VERSION
18068
18069 =item SYNOPSIS
18070
18071 =item BACKGROUND
18072
18073 =item DESCRIPTION
18074
18075 =over 4
18076
18077 =item Allowing fall-through
18078
18079 =item Automating fall-through
18080
18081 =item Alternative syntax
18082
18083 =item Higher-order Operations
18084
18085 =back
18086
18087 =item DEPENDENCIES
18088
18089 =item AUTHOR
18090
18091 =item BUGS
18092
18093 =item LIMITATION
18094
18095 =item COPYRIGHT
18096
18097 =back
18098
18099 =head2 Symbol - manipulate Perl symbols and their names
18100
18101 =over 4
18102
18103 =item SYNOPSIS
18104
18105 =item DESCRIPTION
18106
18107 =back
18108
18109 =head2 Sys::Hostname - Try every conceivable way to get hostname
18110
18111 =over 4
18112
18113 =item SYNOPSIS
18114
18115 =item DESCRIPTION
18116
18117 =item AUTHOR
18118
18119 =back
18120
18121 =head2 Syslog, Sys::Syslog, openlog, closelog, setlogmask, syslog - Perl
18122 interface to the UNIX syslog(3) calls
18123
18124 =over 4
18125
18126 =item SYNOPSIS
18127
18128 =item DESCRIPTION
18129
18130 openlog $ident, $logopt, $facility, syslog $priority, $format, @args,
18131 setlogmask $mask_priority, setlogsock $sock_type [$stream_location] (added
18132 in 5.004_02), closelog
18133
18134 =item EXAMPLES
18135
18136 =item SEE ALSO
18137
18138 =item AUTHOR
18139
18140 =back
18141
18142 =head2 Syslog::Syslog, Sys::Syslog, openlog, closelog, setlogmask, syslog -
18143 Perl interface to the UNIX syslog(3) calls
18144
18145 =over 4
18146
18147 =item SYNOPSIS
18148
18149 =item DESCRIPTION
18150
18151 openlog $ident, $logopt, $facility, syslog $priority, $format, @args,
18152 setlogmask $mask_priority, setlogsock $sock_type [$stream_location] (added
18153 in 5.004_02), closelog
18154
18155 =item EXAMPLES
18156
18157 =item SEE ALSO
18158
18159 =item AUTHOR
18160
18161 =back
18162
18163 =head2 Term::ANSIColor - Color screen output using ANSI escape sequences
18164
18165 =over 4
18166
18167 =item SYNOPSIS
18168
18169 =item DESCRIPTION
18170
18171 =item DIAGNOSTICS
18172
18173 Bad escape sequence %s, Bareword "%s" not allowed while "strict subs" in
18174 use, Invalid attribute name %s, Name "%s" used only once: possible typo, No
18175 comma allowed after filehandle, No name for escape sequence %s
18176
18177 =item ENVIRONMENT
18178
18179 ANSI_COLORS_DISABLED
18180
18181 =item RESTRICTIONS
18182
18183 =item NOTES
18184
18185 =item SEE ALSO
18186
18187 =item AUTHORS
18188
18189 =item COPYRIGHT AND LICENSE
18190
18191 =back
18192
18193 =head2 Term::Cap - Perl termcap interface
18194
18195 =over 4
18196
18197 =item SYNOPSIS
18198
18199 =item DESCRIPTION
18200
18201 =over 4
18202
18203 =item METHODS
18204
18205 =back
18206
18207 =back
18208
18209 B<Tgetent>, OSPEED, TERM
18210
18211 B<Tpad>, B<$string>, B<$cnt>, B<$FH>
18212
18213 B<Tputs>, B<$cap>, B<$cnt>, B<$FH>
18214
18215 B<Tgoto>, B<$cap>, B<$col>, B<$row>, B<$FH>
18216
18217 B<Trequire>
18218
18219 =over 4
18220
18221 =item EXAMPLES
18222
18223 =item COPYRIGHT AND LICENSE
18224
18225 =item AUTHOR
18226
18227 =item SEE ALSO
18228
18229 =back
18230
18231 =head2 Term::Complete - Perl word completion module
18232
18233 =over 4
18234
18235 =item SYNOPSIS
18236
18237 =item DESCRIPTION
18238
18239 E<lt>tabE<gt>, ^D, ^U, E<lt>delE<gt>, E<lt>bsE<gt>
18240
18241 =item DIAGNOSTICS
18242
18243 =item BUGS
18244
18245 =item AUTHOR
18246
18247 =back
18248
18249 =head2 Term::ReadLine - Perl interface to various C<readline> packages. If
18250 no real package is found, substitutes stubs instead of basic functions.
18251
18252 =over 4
18253
18254 =item SYNOPSIS
18255
18256 =item DESCRIPTION
18257
18258 =item Minimal set of supported functions
18259
18260 C<ReadLine>, C<new>, C<readline>, C<addhistory>, C<IN>, $C<OUT>,
18261 C<MinLine>, C<findConsole>, Attribs, C<Features>
18262
18263 =item Additional supported functions
18264
18265 C<tkRunning>, C<ornaments>, C<newTTY>
18266
18267 =item EXPORTS
18268
18269 =item ENVIRONMENT
18270
18271 =item CAVEATS
18272
18273 =back
18274
18275 =head2 Test - provides a simple framework for writing test scripts
18276
18277 =over 4
18278
18279 =item SYNOPSIS
18280
18281 =item DESCRIPTION
18282
18283 =over 4
18284
18285 =item Functions
18286
18287 B<plan>
18288
18289 =back
18290
18291 =back
18292
18293 B<_to_value>
18294
18295 B<ok>
18296
18297 =over 4
18298
18299 =item TEST TYPES
18300
18301 NORMAL TESTS, SKIPPED TESTS, TODO TESTS
18302
18303 =item ONFAIL
18304
18305 =item BUGS and CAVEATS
18306
18307 =item NOTE
18308
18309 =item SEE ALSO
18310
18311 =item AUTHOR
18312
18313 =back
18314
18315 =head2 Test::Builder - Backend for building test libraries
18316
18317 =over 4
18318
18319 =item SYNOPSIS
18320
18321 =item DESCRIPTION
18322
18323 =over 4
18324
18325 =item Construction
18326
18327 B<new>
18328
18329 =back
18330
18331 =back
18332
18333 =over 4
18334
18335 =item Setting up tests
18336
18337 B<exported_to>
18338
18339 =back
18340
18341 B<plan>
18342
18343 B<expected_tests>
18344
18345 B<no_plan>
18346
18347 B<skip_all>
18348
18349 =over 4
18350
18351 =item Running tests
18352
18353 B<ok>
18354
18355 =back
18356
18357 B<is_eq>, B<is_num>
18358
18359 B<isnt_eq>, B<isnt_num>
18360
18361 B<like>, B<unlike>
18362
18363 B<maybe_regex>
18364
18365 B<cmp_ok>
18366
18367 B<BAILOUT>
18368
18369 B<skip>
18370
18371 B<todo_skip>
18372
18373 B<skip_rest>
18374
18375 =over 4
18376
18377 =item Test style
18378
18379 B<level>
18380
18381 =back
18382
18383 B<use_numbers>
18384
18385 B<no_header>, B<no_ending>
18386
18387 =over 4
18388
18389 =item Output
18390
18391 B<diag>
18392
18393 =back
18394
18395 B<_print>
18396
18397 B<output>, B<failure_output>, B<todo_output>
18398
18399 =over 4
18400
18401 =item Test Status and Info
18402
18403 B<current_test>
18404
18405 =back
18406
18407 B<summary>
18408
18409 B<details>  I<UNIMPLEMENTED>, B<todo>
18410
18411 B<caller>
18412
18413 B<_sanity_check>
18414
18415 B<_whoa>
18416
18417 B<_my_exit>
18418
18419 =over 4
18420
18421 =item THREADS
18422
18423 =item EXAMPLES
18424
18425 =item SEE ALSO
18426
18427 =item AUTHORS
18428
18429 =item COPYRIGHT
18430
18431 =back
18432
18433 =head2 Test::Harness - run perl standard test scripts with statistics
18434
18435 =over 4
18436
18437 =item SYNOPSIS
18438
18439 =item DESCRIPTION
18440
18441 =over 4
18442
18443 =item The test script output
18444
18445 B<'1..M'>, B<'ok', 'not ok'.  Ok?>, B<test numbers>, B<test names>,
18446 B<Skipping tests>, B<Todo tests>, B<Bail out!>, B<Comments>, B<Anything
18447 else>
18448
18449 =item Taint mode
18450
18451 =item Configuration variables.
18452
18453 B<$Test::Harness::verbose>, B<$Test::Harness::switches>
18454
18455 =item Failure
18456
18457 B<Failed Test>, B<Stat>, B<Wstat>, B<Total>, B<Fail>, B<Failed>, B<List of
18458 Failed>
18459
18460 =item Functions
18461
18462 B<runtests>
18463
18464 =back
18465
18466 =back
18467
18468 B<_all_ok>
18469
18470 B<_globdir>
18471
18472 B<_run_all_tests>
18473
18474 B<_mk_leader>
18475
18476 B<_leader_width>
18477
18478 =over 4
18479
18480 =item EXPORT
18481
18482 =item DIAGNOSTICS
18483
18484 C<All tests successful.\nFiles=%d,  Tests=%d, %s>, C<FAILED tests
18485 %s\n\tFailed %d/%d tests, %.2f%% okay.>, C<Test returned status %d (wstat
18486 %d)>, C<Failed 1 test, %.2f%% okay. %s>, C<Failed %d/%d tests, %.2f%% okay.
18487 %s>, C<FAILED--Further testing stopped: %s>
18488
18489 =item ENVIRONMENT
18490
18491 C<HARNESS_ACTIVE>, C<HARNESS_COLUMNS>, C<HARNESS_COMPILE_TEST>,
18492 C<HARNESS_FILELEAK_IN_DIR>, C<HARNESS_IGNORE_EXITCODE>, C<HARNESS_NOTTY>,
18493 C<HARNESS_PERL_SWITCHES>, C<HARNESS_VERBOSE>
18494
18495 =item EXAMPLE
18496
18497 =item SEE ALSO
18498
18499 =item AUTHORS
18500
18501 =item TODO
18502
18503 =item BUGS
18504
18505 =back
18506
18507 =head2 Test::Harness::Assert - simple assert
18508
18509 =over 4
18510
18511 =item SYNOPSIS
18512
18513 =item DESCRIPTION
18514
18515 =over 4
18516
18517 =item Functions
18518
18519 B<assert>
18520
18521 =back
18522
18523 =back
18524
18525 =over 4
18526
18527 =item AUTHOR
18528
18529 =item SEE ALSO
18530
18531 =back
18532
18533 =head2 Test::Harness::Iterator - Internal Test::Harness Iterator
18534
18535 =over 4
18536
18537 =item SYNOPSIS
18538
18539 =item DESCRIPTION
18540
18541 =back
18542
18543 =head2 Test::Harness::Straps - detailed analysis of test results
18544
18545 =over 4
18546
18547 =item SYNOPSIS
18548
18549 =item DESCRIPTION
18550
18551 =over 4
18552
18553 =item Construction
18554
18555 B<new>
18556
18557 =back
18558
18559 =back
18560
18561 B<_init>
18562
18563 =over 4
18564
18565 =item Analysis
18566
18567 B<analyze>
18568
18569 =back
18570
18571 B<analyze_fh>
18572
18573 B<analyze_file>
18574
18575 B<_switches>
18576
18577 B<_INC2PERL5LIB>
18578
18579 B<_filtered_INC>
18580
18581 B<_restore_PERL5LIB>
18582
18583 =over 4
18584
18585 =item Parsing
18586
18587 B<_is_comment>
18588
18589 =back
18590
18591 B<_is_header>
18592
18593 B<_is_test>
18594
18595 B<_is_bail_out>
18596
18597 B<_reset_file_state>
18598
18599 =over 4
18600
18601 =item Results
18602
18603 B<_detailize>
18604
18605 =back
18606
18607 =over 4
18608
18609 =item EXAMPLES
18610
18611 =item AUTHOR
18612
18613 =item SEE ALSO
18614
18615 =back
18616
18617 =head2 Test::More - yet another framework for writing test scripts
18618
18619 =over 4
18620
18621 =item SYNOPSIS
18622
18623 =item DESCRIPTION
18624
18625 =over 4
18626
18627 =item I love it when a plan comes together
18628
18629 =back
18630
18631 =back
18632
18633 =over 4
18634
18635 =item Test names
18636
18637 =item I'm ok, you're not ok.
18638
18639 B<ok>
18640
18641 =back
18642
18643 B<is>, B<isnt>
18644
18645 B<like>
18646
18647 B<unlike>
18648
18649 B<cmp_ok>
18650
18651 B<can_ok>
18652
18653 B<isa_ok>
18654
18655 B<pass>, B<fail>
18656
18657 =over 4
18658
18659 =item Diagnostics
18660
18661 B<diag>
18662
18663 =back
18664
18665 =over 4
18666
18667 =item Module tests
18668
18669 B<use_ok>
18670
18671 =back
18672
18673 B<require_ok>
18674
18675 =over 4
18676
18677 =item Conditional tests
18678
18679 B<SKIP: BLOCK>
18680
18681 =back
18682
18683 B<TODO: BLOCK>, B<todo_skip>
18684
18685 When do I use SKIP vs. TODO?
18686
18687 =over 4
18688
18689 =item Comparison functions
18690
18691 B<is_deeply>
18692
18693 =back
18694
18695 B<eq_array>
18696
18697 B<eq_hash>
18698
18699 B<eq_set>
18700
18701 =over 4
18702
18703 =item Extending and Embedding Test::More
18704
18705 B<builder>
18706
18707 =back
18708
18709 =over 4
18710
18711 =item NOTES
18712
18713 =item BUGS and CAVEATS
18714
18715 Making your own ok(), The eq_* family has some caveats, Test::Harness
18716 upgrades
18717
18718 =item HISTORY
18719
18720 =item SEE ALSO
18721
18722 =item AUTHORS
18723
18724 =item COPYRIGHT
18725
18726 =back
18727
18728 =head2 Test::Simple - Basic utilities for writing tests.
18729
18730 =over 4
18731
18732 =item SYNOPSIS
18733
18734 =item DESCRIPTION
18735
18736 B<ok>
18737
18738 =back
18739
18740 =over 4
18741
18742 =item EXAMPLE
18743
18744 =item CAVEATS
18745
18746 =item NOTES
18747
18748 =item HISTORY
18749
18750 =item SEE ALSO
18751
18752 L<Test::More>, L<Test>, L<Test::Unit>, L<Test::Inline>, L<SelfTest>,
18753 L<Test::Harness>
18754
18755 =item AUTHORS
18756
18757 =item COPYRIGHT
18758
18759 =back
18760
18761 =head2 Test::Tutorial - A tutorial about writing really basic tests
18762
18763 =over 4
18764
18765 =item DESCRIPTION
18766
18767 =over 4
18768
18769 =item Nuts and bolts of testing.
18770
18771 =item Where to start?
18772
18773 =item Names
18774
18775 =item Test the manual
18776
18777 =item Sometimes the tests are wrong
18778
18779 =item Testing lots of values
18780
18781 =item Informative names
18782
18783 =item Skipping tests
18784
18785 =item Todo tests
18786
18787 =item Testing with taint mode.
18788
18789 =back
18790
18791 =item FOOTNOTES
18792
18793 =item AUTHORS
18794
18795 =item COPYRIGHT
18796
18797 =back
18798
18799 =head2 Text::Abbrev, abbrev - create an abbreviation table from a list
18800
18801 =over 4
18802
18803 =item SYNOPSIS
18804
18805 =item DESCRIPTION
18806
18807 =item EXAMPLE
18808
18809 =back
18810
18811 =head2 Text::Balanced - Extract delimited text sequences from strings.
18812
18813 =over 4
18814
18815 =item SYNOPSIS
18816
18817 =item DESCRIPTION
18818
18819 =over 4
18820
18821 =item General behaviour in list contexts
18822
18823 [0], [1], [2]
18824
18825 =item General behaviour in scalar and void contexts
18826
18827 =item A note about prefixes
18828
18829 =item C<extract_delimited>
18830
18831 =item C<extract_bracketed>
18832
18833 =item C<extract_tagged>
18834
18835 C<reject =E<gt> $listref>, C<ignore =E<gt> $listref>, C<fail =E<gt> $str>,
18836 [0], [1], [2], [3], [4], [5]
18837
18838 =item C<gen_extract_tagged>
18839
18840 =item C<extract_quotelike>
18841
18842 [0], [1], [2], [3], [4], [5], [6], [7], [8], [9], [10]
18843
18844 =item C<extract_quotelike> and "here documents"
18845
18846 [0], [1], [2], [3], [4], [5], [6], [7..10]
18847
18848 =item C<extract_codeblock>
18849
18850 =item C<extract_multiple>
18851
18852 =item C<gen_delimited_pat>
18853
18854 =back
18855
18856 =item DIAGNOSTICS
18857
18858  C<Did not find a suitable bracket: "%s">,  C<Did not find prefix: /%s/>,
18859 C<Did not find opening bracket after prefix: "%s">,  C<No quotelike
18860 operator found after prefix: "%s">,  C<Unmatched closing bracket: "%c">,
18861 C<Unmatched opening bracket(s): "%s">, C<Unmatched embedded quote (%s)>,
18862 C<Did not find closing delimiter to match '%s'>,  C<Mismatched closing
18863 bracket: expected "%c" but found "%s">,  C<No block delimiter found after
18864 quotelike "%s">, C<Did not find leading dereferencer>, C<Bad identifier
18865 after dereferencer>, C<Did not find expected opening bracket at %s>,
18866 C<Improperly nested codeblock at %s>,  C<Missing second block for quotelike
18867 "%s">, C<No match found for opening bracket>, C<Did not find opening tag:
18868 /%s/>, C<Unable to construct closing tag to match: /%s/>, C<Found invalid
18869 nested tag: %s>, C<Found unbalanced nested tag: %s>, C<Did not find closing
18870 tag>
18871
18872 =item AUTHOR
18873
18874 =item BUGS AND IRRITATIONS
18875
18876 =item COPYRIGHT
18877
18878 =back
18879
18880 =head2 Text::ParseWords - parse text into an array of tokens or array of
18881 arrays
18882
18883 =over 4
18884
18885 =item SYNOPSIS
18886
18887 =item DESCRIPTION
18888
18889 =item EXAMPLES
18890
18891 =item AUTHORS
18892
18893 =back
18894
18895 =head2 Text::Soundex - Implementation of the Soundex Algorithm as Described
18896 by Knuth
18897
18898 =over 4
18899
18900 =item SYNOPSIS
18901
18902 =item DESCRIPTION
18903
18904 =item EXAMPLES
18905
18906 =item LIMITATIONS
18907
18908 =item AUTHOR
18909
18910 =back
18911
18912 =head2 Text::Tabs -- expand and unexpand tabs per the unix expand(1) and
18913 unexpand(1)
18914
18915 =over 4
18916
18917 =item SYNOPSIS
18918
18919 =item DESCRIPTION
18920
18921 =item BUGS
18922
18923 =item AUTHOR
18924
18925 =back
18926
18927 =head2 Text::Wrap - line wrapping to form simple paragraphs
18928
18929 =over 4
18930
18931 =item SYNOPSIS
18932
18933 =item DESCRIPTION
18934
18935 =item OVERRIDES
18936
18937 =item EXAMPLE
18938
18939 =item AUTHOR
18940
18941 =back
18942
18943 =head2 Thread - manipulate threads in Perl (for old code only)
18944
18945 =over 4
18946
18947 =item CAVEAT
18948
18949 =item SYNOPSIS
18950
18951 =item DESCRIPTION
18952
18953 =item FUNCTIONS
18954
18955 $thread = Thread->new(\&start_sub), $thread = Thread->new(\&start_sub,
18956 LIST), lock VARIABLE, async BLOCK;, Thread->self, cond_wait VARIABLE,
18957 cond_signal VARIABLE, cond_broadcast VARIABLE, yield
18958
18959 =item METHODS
18960
18961 join, eval, detach, equal, tid, flags, done
18962
18963 =item LIMITATIONS
18964
18965 =item SEE ALSO
18966
18967 =back
18968
18969 =head2 Thread::Queue - thread-safe queues
18970
18971 =over 4
18972
18973 =item SYNOPSIS
18974
18975 =item DESCRIPTION
18976
18977 =item FUNCTIONS AND METHODS
18978
18979 new, enqueue LIST, dequeue, dequeue_nb, pending
18980
18981 =item SEE ALSO
18982
18983 =back
18984
18985 =head2 Thread::Semaphore - thread-safe semaphores
18986
18987 =over 4
18988
18989 =item SYNOPSIS
18990
18991 =item DESCRIPTION
18992
18993 =item FUNCTIONS AND METHODS
18994
18995 new, new NUMBER, down, down NUMBER, up, up NUMBER
18996
18997 =back
18998
18999 =head2 Thread::Signal - Start a thread which runs signal handlers reliably
19000 (for old code)
19001
19002 =over 4
19003
19004 =item CAVEAT
19005
19006 =item SYNOPSIS
19007
19008 =item DESCRIPTION
19009
19010 =item BUGS
19011
19012 =back
19013
19014 =head2 Thread::Specific - thread-specific keys
19015
19016 =over 4
19017
19018 =item SYNOPSIS
19019
19020 =item DESCRIPTION
19021
19022 =back
19023
19024 =head2 Tie::Array - base class for tied arrays
19025
19026 =over 4
19027
19028 =item SYNOPSIS
19029
19030 =item DESCRIPTION
19031
19032 TIEARRAY classname, LIST, STORE this, index, value, FETCH this, index,
19033 FETCHSIZE this, STORESIZE this, count, EXTEND this, count, EXISTS this,
19034 key, DELETE this, key, CLEAR this, DESTROY this, PUSH this, LIST, POP this,
19035 SHIFT this, UNSHIFT this, LIST, SPLICE this, offset, length, LIST
19036
19037 =item CAVEATS
19038
19039 =item AUTHOR
19040
19041 =back
19042
19043 =head2 Tie::File - Access the lines of a disk file via a Perl array
19044
19045 =over 4
19046
19047 =item SYNOPSIS
19048
19049 =item DESCRIPTION
19050
19051 =over 4
19052
19053 =item C<recsep>
19054
19055 =item C<autochomp>
19056
19057 =item C<mode>
19058
19059 =item C<memory>
19060
19061 =item C<dw_size>
19062
19063 =item Option Format
19064
19065 =back
19066
19067 =item Public Methods
19068
19069 =over 4
19070
19071 =item C<flock>
19072
19073 =item C<autochomp>
19074
19075 =item C<defer>, C<flush>, C<discard>, and C<autodefer>
19076
19077 =back
19078
19079 =item Tying to an already-opened filehandle
19080
19081 =item Deferred Writing
19082
19083 =over 4
19084
19085 =item Autodeferring
19086
19087 =back
19088
19089 =item CAVEATS
19090
19091 =item SUBCLASSING
19092
19093 =item WHAT ABOUT C<DB_File>?
19094
19095 =item AUTHOR
19096
19097 =item LICENSE
19098
19099 =item WARRANTY
19100
19101 =item THANKS
19102
19103 =item TODO
19104
19105 =back
19106
19107 =head2 Tie::Handle, Tie::StdHandle  - base class definitions for tied
19108 handles
19109
19110 =over 4
19111
19112 =item SYNOPSIS
19113
19114 =item DESCRIPTION
19115
19116 TIEHANDLE classname, LIST, WRITE this, scalar, length, offset, PRINT this,
19117 LIST, PRINTF this, format, LIST, READ this, scalar, length, offset,
19118 READLINE this, GETC this, CLOSE this, OPEN this, filename, BINMODE this,
19119 EOF this, TELL this, SEEK this, offset, whence, DESTROY this
19120
19121 =item MORE INFORMATION
19122
19123 =item COMPATIBILITY
19124
19125 =back
19126
19127 =head2 Tie::Hash, Tie::StdHash, Tie::ExtraHash - base class definitions for
19128 tied hashes
19129
19130 =over 4
19131
19132 =item SYNOPSIS
19133
19134 =item DESCRIPTION
19135
19136 TIEHASH classname, LIST, STORE this, key, value, FETCH this, key, FIRSTKEY
19137 this, NEXTKEY this, lastkey, EXISTS this, key, DELETE this, key, CLEAR this
19138
19139 =item Inheriting from B<Tie::StdHash>
19140
19141 =item Inheriting from B<Tie::ExtraHash>
19142
19143 =item C<UNTIE> and C<DESTROY>
19144
19145 =item MORE INFORMATION
19146
19147 =back
19148
19149 =head2 Tie::Memoize - add data to hash when needed
19150
19151 =over 4
19152
19153 =item SYNOPSIS
19154
19155 =item DESCRIPTION
19156
19157 =item Inheriting from B<Tie::Memoize>
19158
19159 =item EXAMPLE
19160
19161 =item BUGS
19162
19163 =item AUTHOR
19164
19165 =back
19166
19167 =head2 Tie::RefHash - use references as hash keys
19168
19169 =over 4
19170
19171 =item SYNOPSIS
19172
19173 =item DESCRIPTION
19174
19175 =item EXAMPLE
19176
19177 =item AUTHOR
19178
19179 =item VERSION
19180
19181 =item SEE ALSO
19182
19183 =back
19184
19185 =head2 Tie::Scalar, Tie::StdScalar - base class definitions for tied
19186 scalars
19187
19188 =over 4
19189
19190 =item SYNOPSIS
19191
19192 =item DESCRIPTION
19193
19194 TIESCALAR classname, LIST, FETCH this, STORE this, value, DESTROY this
19195
19196 =item MORE INFORMATION
19197
19198 =back
19199
19200 =head2 Tie::SubstrHash - Fixed-table-size, fixed-key-length hashing
19201
19202 =over 4
19203
19204 =item SYNOPSIS
19205
19206 =item DESCRIPTION
19207
19208 =item CAVEATS
19209
19210 =back
19211
19212 =head2 Time::HiRes - High resolution alarm, sleep, gettimeofday, interval
19213 timers
19214
19215 =over 4
19216
19217 =item SYNOPSIS
19218
19219 =item DESCRIPTION
19220
19221 gettimeofday (), usleep ( $useconds ), ualarm ( $useconds [,
19222 $interval_useconds ] ), tv_interval, time (), sleep ( $floating_seconds ),
19223 alarm ( $floating_seconds [, $interval_floating_seconds ] ), setitimer,
19224 getitimer ( $which )
19225
19226 =item EXAMPLES
19227
19228 =item C API
19229
19230 =item CAVEATS
19231
19232 =item AUTHORS
19233
19234 =item REVISION
19235
19236 =item COPYRIGHT
19237
19238 =back
19239
19240 =head2 Time::Local - efficiently compute time from local and GMT time
19241
19242 =over 4
19243
19244 =item SYNOPSIS
19245
19246 =item DESCRIPTION
19247
19248 =item IMPLEMENTATION
19249
19250 =item BUGS
19251
19252 =back
19253
19254 =head2 Time::gmtime - by-name interface to Perl's built-in gmtime()
19255 function
19256
19257 =over 4
19258
19259 =item SYNOPSIS
19260
19261 =item DESCRIPTION
19262
19263 =item NOTE
19264
19265 =item AUTHOR
19266
19267 =back
19268
19269 =head2 Time::localtime - by-name interface to Perl's built-in localtime()
19270 function
19271
19272 =over 4
19273
19274 =item SYNOPSIS
19275
19276 =item DESCRIPTION
19277
19278 =item NOTE
19279
19280 =item AUTHOR
19281
19282 =back
19283
19284 =head2 Time::tm - internal object used by Time::gmtime and Time::localtime
19285
19286 =over 4
19287
19288 =item SYNOPSIS
19289
19290 =item DESCRIPTION
19291
19292 =item AUTHOR
19293
19294 =back
19295
19296 =head2 UNIVERSAL - base class for ALL classes (blessed references)
19297
19298 =over 4
19299
19300 =item SYNOPSIS
19301
19302 =item DESCRIPTION
19303
19304 $obj->isa( TYPE ), CLASS->isa( TYPE ), isa( VAL, TYPE ), $obj->can( METHOD
19305 ), CLASS->can( METHOD ), can( VAL, METHOD ), VERSION ( [ REQUIRE ] )
19306
19307 =back
19308
19309 =head2 Unicode::Collate - Unicode Collation Algorithm
19310
19311 =over 4
19312
19313 =item SYNOPSIS
19314
19315 =item DESCRIPTION
19316
19317 =over 4
19318
19319 =item Constructor and Tailoring
19320
19321 alternate, backwards, entry, ignoreName, ignoreChar, level, normalization,
19322 overrideCJK, overrideHangul, preprocess, rearrange, table, undefName,
19323 undefChar, katakana_before_hiragana, upper_before_lower
19324
19325 =item Methods for Collation
19326
19327 C<@sorted = $Collator-E<gt>sort(@not_sorted)>, C<$result =
19328 $Collator-E<gt>cmp($a, $b)>, C<$result = $Collator-E<gt>eq($a, $b)>,
19329 C<$result = $Collator-E<gt>ne($a, $b)>, C<$result = $Collator-E<gt>lt($a,
19330 $b)>, C<$result = $Collator-E<gt>le($a, $b)>, C<$result =
19331 $Collator-E<gt>gt($a, $b)>, C<$result = $Collator-E<gt>ge($a, $b)>,
19332 C<$sortKey = $Collator-E<gt>getSortKey($string)>, C<$sortKeyForm =
19333 $Collator-E<gt>viewSortKey($string)>, C<$position =
19334 $Collator-E<gt>index($string, $substring)>, C<($position, $length) =
19335 $Collator-E<gt>index($string, $substring)>
19336
19337 =item Other Methods
19338
19339 UCA_Version, Base_Unicode_Version
19340
19341 =item EXPORT
19342
19343 =item TODO
19344
19345 =item CAVEAT
19346
19347 =item BUGS
19348
19349 =back
19350
19351 =item AUTHOR
19352
19353 =item SEE ALSO
19354
19355 http://www.unicode.org/unicode/reports/tr10/,
19356 http://www.unicode.org/unicode/reports/tr10/allkeys.txt,
19357 http://www.unicode.org/unicode/reports/tr15/,
19358 http://www.unicode.org/unicode/reports/tr18, L<Unicode::Normalize>
19359
19360 =back
19361
19362 =head2 Unicode::Normalize - Unicode Normalization Forms
19363
19364 =over 4
19365
19366 =item SYNOPSIS
19367
19368 =item DESCRIPTION
19369
19370 =over 4
19371
19372 =item Normalization Forms
19373
19374 C<$NFD_string = NFD($string)>, C<$NFC_string = NFC($string)>,
19375 C<$NFKD_string = NFKD($string)>, C<$NFKC_string = NFKC($string)>,
19376 C<$normalized_string = normalize($form_name, $string)>
19377
19378 =item Decomposition and Composition
19379
19380 C<$decomposed_string = decompose($string)>, C<$decomposed_string =
19381 decompose($string, $useCompatMapping)>, C<$reordered_string  =
19382 reorder($string)>, C<$composed_string   = compose($string)>
19383
19384 =item Quick Check
19385
19386 C<$result = checkNFD($string)>, C<$result = checkNFC($string)>, C<$result =
19387 checkNFKD($string)>, C<$result = checkNFKC($string)>, C<$result =
19388 check($form_name, $string)>
19389
19390 =item Character Data
19391
19392 C<$canonical_decomposed = getCanon($codepoint)>,
19393 C<$compatibility_decomposed = getCompat($codepoint)>,
19394 C<$codepoint_composite = getComposite($codepoint_here, $codepoint_next)>,
19395 C<$combining_class = getCombinClass($codepoint)>, C<$is_exclusion =
19396 isExclusion($codepoint)>, C<$is_singleton = isSingleton($codepoint)>,
19397 C<$is_non_startar_decomposition = isNonStDecomp($codepoint)>,
19398 C<$may_be_composed_with_prev_char = isComp2nd($codepoint)>
19399
19400 =item EXPORT
19401
19402 =back
19403
19404 =item AUTHOR
19405
19406 =item SEE ALSO
19407
19408 http://www.unicode.org/unicode/reports/tr15/,
19409 http://www.unicode.org/Public/UNIDATA/DerivedNormalizationProps.txt
19410
19411 =back
19412
19413 =head2 Unicode::UCD - Unicode character database
19414
19415 =over 4
19416
19417 =item SYNOPSIS
19418
19419 =item DESCRIPTION
19420
19421 =back
19422
19423 =over 4
19424
19425 =item charinfo
19426
19427 =back
19428
19429 =over 4
19430
19431 =item charblock
19432
19433 =back
19434
19435 =over 4
19436
19437 =item charscript
19438
19439 =back
19440
19441 =over 4
19442
19443 =item charblocks
19444
19445 =back
19446
19447 =over 4
19448
19449 =item charscripts
19450
19451 =back
19452
19453 =over 4
19454
19455 =item Blocks versus Scripts
19456
19457 =item Matching Scripts and Blocks
19458
19459 =item Code Point Arguments
19460
19461 =item charinrange
19462
19463 =back
19464
19465 =over 4
19466
19467 =item compexcl
19468
19469 =back
19470
19471 =over 4
19472
19473 =item casefold
19474
19475 =back
19476
19477 =over 4
19478
19479 =item casespec
19480
19481 =back
19482
19483 =over 4
19484
19485 =item Unicode::UCD::UnicodeVersion
19486
19487 =back
19488
19489 =over 4
19490
19491 =item Implementation Note
19492
19493 =back
19494
19495 =over 4
19496
19497 =item BUGS
19498
19499 =item AUTHOR
19500
19501 =back
19502
19503 =head2 User::grent - by-name interface to Perl's built-in getgr*()
19504 functions
19505
19506 =over 4
19507
19508 =item SYNOPSIS
19509
19510 =item DESCRIPTION
19511
19512 =item NOTE
19513
19514 =item AUTHOR
19515
19516 =back
19517
19518 =head2 User::pwent - by-name interface to Perl's built-in getpw*()
19519 functions
19520
19521 =over 4
19522
19523 =item SYNOPSIS
19524
19525 =item DESCRIPTION
19526
19527 =over 4
19528
19529 =item System Specifics
19530
19531 =back
19532
19533 =item NOTE
19534
19535 =item AUTHOR
19536
19537 =item HISTORY
19538
19539 March 18th, 2000
19540
19541 =back
19542
19543 =head2 Win32 - Interfaces to some Win32 API Functions
19544
19545 =over 4
19546
19547 =item DESCRIPTION
19548
19549 =over 4
19550
19551 =item Alphabetical Listing of Win32 Functions
19552
19553 Win32::AbortSystemShutdown(MACHINE), Win32::BuildNumber(),
19554 Win32::CopyFile(FROM, TO, OVERWRITE), Win32::DomainName(),
19555 Win32::ExpandEnvironmentStrings(STRING), Win32::FormatMessage(ERRORCODE),
19556 Win32::FsType(), Win32::FreeLibrary(HANDLE), Win32::GetArchName(),
19557 Win32::GetChipName(), Win32::GetCwd(), Win32::GetFullPathName(FILENAME),
19558 Win32::GetLastError(), Win32::GetLongPathName(PATHNAME),
19559 Win32::GetNextAvailDrive(), Win32::GetOSVersion(), Win32::GetOSName(),
19560 Win32::GetShortPathName(PATHNAME), Win32::GetProcAddress(INSTANCE,
19561 PROCNAME), Win32::GetTickCount(), Win32::InitiateSystemShutdown,
19562 Win32::IsWinNT(), Win32::IsWin95(), Win32::LoadLibrary(LIBNAME),
19563 Win32::LoginName(), Win32::LookupAccountName(SYSTEM, ACCOUNT, DOMAIN, SID,
19564 SIDTYPE), Win32::LookupAccountSID(SYSTEM, SID, ACCOUNT, DOMAIN, SIDTYPE),
19565 Win32::MsgBox(MESSAGE [, FLAGS [, TITLE]]), Win32::NodeName(),
19566 Win32::RegisterServer(LIBRARYNAME), Win32::SetChildShowWindow(SHOWWINDOW),
19567 Win32::SetCwd(NEWDIRECTORY), Win32::SetLastError(ERROR),
19568 Win32::Sleep(TIME), Win32::Spawn(COMMAND, ARGS, PID),
19569 Win32::UnregisterServer(LIBRARYNAME)
19570
19571 =back
19572
19573 =back
19574
19575 =head2 XSLoader - Dynamically load C libraries into Perl code
19576
19577 =over 4
19578
19579 =item SYNOPSIS
19580
19581 =item DESCRIPTION
19582
19583 =item AUTHOR
19584
19585 =back
19586
19587 =head1 AUXILIARY DOCUMENTATION
19588
19589 Here should be listed all the extra programs' documentation, but they
19590 don't all have manual pages yet:
19591
19592 =over 4
19593
19594 =item a2p
19595
19596 =item s2p
19597
19598 =item find2perl
19599
19600 =item h2ph
19601
19602 =item c2ph
19603
19604 =item h2xs
19605
19606 =item xsubpp
19607
19608 =item pod2man
19609
19610 =item wrapsuid
19611
19612 =back
19613
19614 =head1 AUTHOR
19615
19616 Larry Wall <F<larry@wall.org>>, with the help of oodles
19617 of other folks.
19618