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, sqrt EXPR,
 459 sqrt, srand EXPR, srand, stat FILEHANDLE, stat EXPR, stat, study SCALAR,
 460 study, sub NAME BLOCK, sub NAME (PROTO) BLOCK, sub NAME : ATTRS BLOCK, sub
 461 NAME (PROTO) : ATTRS BLOCK, substr EXPR,OFFSET,LENGTH,REPLACEMENT, substr
 462 EXPR,OFFSET,LENGTH, substr EXPR,OFFSET, symlink OLDFILE,NEWFILE, syscall
 463 LIST, sysopen FILEHANDLE,FILENAME,MODE, sysopen
 464 FILEHANDLE,FILENAME,MODE,PERMS, sysread FILEHANDLE,SCALAR,LENGTH,OFFSET,
 465 sysread FILEHANDLE,SCALAR,LENGTH, sysseek FILEHANDLE,POSITION,WHENCE,
 466 system LIST, system PROGRAM LIST, syswrite FILEHANDLE,SCALAR,LENGTH,OFFSET,
 467 syswrite FILEHANDLE,SCALAR,LENGTH, syswrite FILEHANDLE,SCALAR, tell
 468 FILEHANDLE, tell, telldir DIRHANDLE, tie VARIABLE,CLASSNAME,LIST, tied
 469 VARIABLE, time, times, tr///, truncate FILEHANDLE,LENGTH, truncate
 470 EXPR,LENGTH, uc EXPR, uc, ucfirst EXPR, ucfirst, umask EXPR, umask, undef
 471 EXPR, undef, unlink LIST, unlink, unpack TEMPLATE,EXPR, untie VARIABLE,
 472 unshift ARRAY,LIST, use Module VERSION LIST, use Module VERSION, use Module
 473 LIST, use Module, use VERSION, utime LIST, values HASH, vec
 474 EXPR,OFFSET,BITS, wait, waitpid PID,FLAGS, wantarray, warn LIST, write
 475 FILEHANDLE, write EXPR, write, y///
 476
 477 =back
 478
 479 =back
 480
 481 =head2 perlreftut - Mark's very short tutorial about references
 482
 483 =over 4
 484
 485 =item DESCRIPTION
 486
 487 =item Who Needs Complicated Data Structures?
 488
 489 =item The Solution
 490
 491 =item Syntax
 492
 493 =over 4
 494
 495 =item Making References
 496
 497 =item Using References
 498
 499 =back
 500
 501 =item An Example
 502
 503 =item Arrow Rule
 504
 505 =item Solution
 506
 507 =item The Rest
 508
 509 =item Summary
 510
 511 =item Credits
 512
 513 =over 4
 514
 515 =item Distribution Conditions
 516
 517 =back
 518
 519 =back
 520
 521 =head2 perldsc - Perl Data Structures Cookbook
 522
 523 =over 4
 524
 525 =item DESCRIPTION
 526
 527 arrays of arrays, hashes of arrays, arrays of hashes, hashes of hashes,
 528 more elaborate constructs
 529
 530 =item REFERENCES
 531
 532 =item COMMON MISTAKES
 533
 534 =item CAVEAT ON PRECEDENCE
 535
 536 =item WHY YOU SHOULD ALWAYS C<use strict>
 537
 538 =item DEBUGGING
 539
 540 =item CODE EXAMPLES
 541
 542 =item ARRAYS OF ARRAYS
 543
 544 =over 4
 545
 546 =item Declaration of an ARRAY OF ARRAYS
 547
 548 =item Generation of an ARRAY OF ARRAYS
 549
 550 =item Access and Printing of an ARRAY OF ARRAYS
 551
 552 =back
 553
 554 =item HASHES OF ARRAYS
 555
 556 =over 4
 557
 558 =item Declaration of a HASH OF ARRAYS
 559
 560 =item Generation of a HASH OF ARRAYS
 561
 562 =item Access and Printing of a HASH OF ARRAYS
 563
 564 =back
 565
 566 =item ARRAYS OF HASHES
 567
 568 =over 4
 569
 570 =item Declaration of an ARRAY OF HASHES
 571
 572 =item Generation of an ARRAY OF HASHES
 573
 574 =item Access and Printing of an ARRAY OF HASHES
 575
 576 =back
 577
 578 =item HASHES OF HASHES
 579
 580 =over 4
 581
 582 =item Declaration of a HASH OF HASHES
 583
 584 =item Generation of a HASH OF HASHES
 585
 586 =item Access and Printing of a HASH OF HASHES
 587
 588 =back
 589
 590 =item MORE ELABORATE RECORDS
 591
 592 =over 4
 593
 594 =item Declaration of MORE ELABORATE RECORDS
 595
 596 =item Declaration of a HASH OF COMPLEX RECORDS
 597
 598 =item Generation of a HASH OF COMPLEX RECORDS
 599
 600 =back
 601
 602 =item Database Ties
 603
 604 =item SEE ALSO
 605
 606 =item AUTHOR
 607
 608 =back
 609
 610 =head2 perlrequick - Perl regular expressions quick start
 611
 612 =over 4
 613
 614 =item DESCRIPTION
 615
 616 =item The Guide
 617
 618 =over 4
 619
 620 =item Simple word matching
 621
 622 =item Using character classes
 623
 624 =item Matching this or that
 625
 626 =item Grouping things and hierarchical matching
 627
 628 =item Extracting matches
 629
 630 =item Matching repetitions
 631
 632 =item More matching
 633
 634 =item Search and replace
 635
 636 =item The split operator
 637
 638 =back
 639
 640 =item BUGS
 641
 642 =item SEE ALSO
 643
 644 =item AUTHOR AND COPYRIGHT
 645
 646 =over 4
 647
 648 =item Acknowledgments
 649
 650 =back
 651
 652 =back
 653
 654 =head2 perlpod - the Plain Old Documentation format
 655
 656 =over 4
 657
 658 =item DESCRIPTION
 659
 660 =over 4
 661
 662 =item Ordinary Paragraph
 663
 664 =item Verbatim Paragraph
 665
 666 =item Command Paragraph
 667
 668 C<=head1 I<Heading Text>>, C<=head2 I<Heading Text>>, C<=head3 I<Heading
 669 Text>>, C<=head4 I<Heading Text>>, C<=over I<indentlevel>>, C<=item
 670 I<stuff...>>, C<=back>, C<=cut>, C<=pod>, C<=begin I<formatname>>, C<=end
 671 I<formatname>>, C<=for I<formatname> I<text...>>
 672
 673 =item Formatting Codes
 674
 675 C<IE<lt>textE<gt>> -- italic text, C<BE<lt>textE<gt>> -- bold text,
 676 C<CE<lt>codeE<gt>> -- code text, C<LE<lt>nameE<gt>> -- a hyperlink,
 677 C<EE<lt>escapeE<gt>> -- a character escape, C<FE<lt>filenameE<gt>> -- used
 678 for filenames, C<SE<lt>textE<gt>> -- text contains non-breaking spaces,
 679 C<XE<lt>topic nameE<gt>> -- an index entry, C<ZE<lt>E<gt>> -- a null
 680 (zero-effect) formatting code
 681
 682 =item The Intent
 683
 684 =item Embedding Pods in Perl Modules
 685
 686 =item Hints for Writing Pod
 687
 688 =back
 689
 690 =item SEE ALSO
 691
 692 =item AUTHOR
 693
 694 =back
 695
 696 =head2 perlpodspec - Plain Old Documentation: format specification and
 697 notes
 698
 699 =over 4
 700
 701 =item DESCRIPTION
 702
 703 =item Pod Definitions
 704
 705 =item Pod Commands
 706
 707 "=head1", "=head2", "=head3", "=head4", "=pod", "=cut", "=over", "=item",
 708 "=back", "=begin formatname", "=end formatname", "=for formatname text..."
 709
 710 =item Pod Formatting Codes
 711
 712 C<IE<lt>textE<gt>> -- italic text, C<BE<lt>textE<gt>> -- bold text,
 713 C<CE<lt>codeE<gt>> -- code text, C<FE<lt>filenameE<gt>> -- style for
 714 filenames, C<XE<lt>topic nameE<gt>> -- an index entry, C<ZE<lt>E<gt>> -- a
 715 null (zero-effect) formatting code, C<LE<lt>nameE<gt>> -- a hyperlink,
 716 C<EE<lt>escapeE<gt>> -- a character escape, C<SE<lt>textE<gt>> -- text
 717 contains non-breaking spaces
 718
 719 =item Notes on Implementing Pod Processors
 720
 721 =item About LE<lt>...E<gt> Codes
 722
 723 First:, Second:, Third:, Fourth:, Fifth:, Sixth:
 724
 725 =item About =over...=back Regions
 726
 727 =item About Data Paragraphs and "=begin/=end" Regions
 728
 729 =item SEE ALSO
 730
 731 =item AUTHOR
 732
 733 =back
 734
 735 =head2 perlstyle - Perl style guide
 736
 737 =over 4
 738
 739 =item DESCRIPTION
 740
 741 =back
 742
 743 =head2 perltrap - Perl traps for the unwary
 744
 745 =over 4
 746
 747 =item DESCRIPTION
 748
 749 =over 4
 750
 751 =item Awk Traps
 752
 753 =item C Traps
 754
 755 =item Sed Traps
 756
 757 =item Shell Traps
 758
 759 =item Perl Traps
 760
 761 =item Perl4 to Perl5 Traps
 762
 763 Discontinuance, Deprecation, and BugFix traps, Parsing Traps, Numerical
 764 Traps, General data type traps, Context Traps - scalar, list contexts,
 765 Precedence Traps, General Regular Expression Traps using s///, etc,
 766 Subroutine, Signal, Sorting Traps, OS Traps, DBM Traps, Unclassified Traps
 767
 768 =item Discontinuance, Deprecation, and BugFix traps
 769
 770 Discontinuance, Deprecation, BugFix, Discontinuance, Discontinuance,
 771 Discontinuance, BugFix, Discontinuance, Discontinuance, BugFix,
 772 Discontinuance, Deprecation, Discontinuance, Discontinuance
 773
 774 =item Parsing Traps
 775
 776 Parsing, Parsing, Parsing, Parsing, Parsing
 777
 778 =item Numerical Traps
 779
 780 Numerical, Numerical, Numerical, Bitwise string ops
 781
 782 =item General data type traps
 783
 784 (Arrays), (Arrays), (Hashes), (Globs), (Globs), (Scalar String),
 785 (Constants), (Scalars), (Variable Suicide)
 786
 787 =item Context Traps - scalar, list contexts
 788
 789 (list context), (scalar context), (scalar context), (list, builtin)
 790
 791 =item Precedence Traps
 792
 793 Precedence, Precedence, Precedence, Precedence, Precedence, Precedence,
 794 Precedence
 795
 796 =item General Regular Expression Traps using s///, etc.
 797
 798 Regular Expression, Regular Expression, Regular Expression, Regular
 799 Expression, Regular Expression, Regular Expression, Regular Expression,
 800 Regular Expression
 801
 802 =item Subroutine, Signal, Sorting Traps
 803
 804 (Signals), (Sort Subroutine), warn() won't let you specify a filehandle
 805
 806 =item OS Traps
 807
 808 (SysV), (SysV)
 809
 810 =item Interpolation Traps
 811
 812 Interpolation, Interpolation, Interpolation, Interpolation, Interpolation,
 813 Interpolation, Interpolation, Interpolation, Interpolation
 814
 815 =item DBM Traps
 816
 817 DBM, DBM
 818
 819 =item Unclassified Traps
 820
 821 C<require>/C<do> trap using returned value, C<split> on empty string with
 822 LIMIT specified
 823
 824 =back
 825
 826 =back
 827
 828 =head2 perlrun - how to execute the Perl interpreter
 829
 830 =over 4
 831
 832 =item SYNOPSIS
 833
 834 =item DESCRIPTION
 835
 836 =over 4
 837
 838 =item #! and quoting on non-Unix systems
 839
 840 OS/2, MS-DOS, Win95/NT, Macintosh, VMS
 841
 842 =item Location of Perl
 843
 844 =item Command Switches
 845
 846 B<-0>[I<digits>], B<-a>, B<-C>, B<-c>, B<-d>, B<-d:>I<foo[=bar,baz]>,
 847 B<-D>I<letters>, B<-D>I<number>, B<-e> I<commandline>, B<-F>I<pattern>,
 848 B<-h>, B<-i>[I<extension>], B<-I>I<directory>, B<-l>[I<octnum>],
 849 B<-m>[B<->]I<module>, B<-M>[B<->]I<module>, B<-M>[B<->]I<'module ...'>,
 850 B<-[mM]>[B<->]I<module=arg[,arg]...>, B<-n>, B<-p>, B<-P>, B<-s>, B<-S>,
 851 B<-t>, B<-T>, B<-u>, B<-U>, B<-v>, B<-V>, B<-V:>I<name>, B<-w>, B<-W>,
 852 B<-X>, B<-x> I<directory>
 853
 854 =back
 855
 856 =item ENVIRONMENT
 857
 858 HOME, LOGDIR, PATH, PERL5LIB, PERL5OPT, PERLIO, :bytes, :crlf, :mmap,
 859 :perlio, :raw, :stdio, :unix, :utf8, :win32, PERLIO_DEBUG, PERLLIB,
 860 PERL5DB, PERL5SHELL (specific to the Win32 port), PERL_DEBUG_MSTATS,
 861 PERL_DESTRUCT_LEVEL, PERL_ENCODING, PERL_ROOT (specific to the VMS port),
 862 SYS$LOGIN (specific to the VMS port)
 863
 864 =back
 865
 866 =head2 perldiag - various Perl diagnostics
 867
 868 =over 4
 869
 870 =item DESCRIPTION
 871
 872 =back
 873
 874 =head2 perllexwarn - Perl Lexical Warnings
 875
 876 =over 4
 877
 878 =item DESCRIPTION
 879
 880 =over 4
 881
 882 =item Default Warnings and Optional Warnings
 883
 884 =item What's wrong with B<-w> and C<$^W>
 885
 886 =item Controlling Warnings from the Command Line
 887
 888 B<-w>, B<-W>, B<-X>
 889
 890 =item Backward Compatibility
 891
 892 =item Category Hierarchy
 893
 894 =item Fatal Warnings
 895
 896 =item Reporting Warnings from a Module
 897
 898 =back
 899
 900 =item TODO
 901
 902 =item SEE ALSO
 903
 904 =item AUTHOR
 905
 906 =back
 907
 908 =head2 perldebtut - Perl debugging tutorial
 909
 910 =over 4
 911
 912 =item DESCRIPTION
 913
 914 =item use strict
 915
 916 =item Looking at data and -w and v
 917
 918 =item help
 919
 920 =item Stepping through code
 921
 922 =item Placeholder for a, w, t, T
 923
 924 =item REGULAR EXPRESSIONS
 925
 926 =item OUTPUT TIPS
 927
 928 =item CGI
 929
 930 =item GUIs
 931
 932 =item SUMMARY
 933
 934 =item SEE ALSO
 935
 936 =item AUTHOR
 937
 938 =item CONTRIBUTORS
 939
 940 =back
 941
 942 =head2 perldebug - Perl debugging
 943
 944 =over 4
 945
 946 =item DESCRIPTION
 947
 948 =item The Perl Debugger
 949
 950 =over 4
 951
 952 =item Debugger Commands
 953
 954 h, h [command], h h, p expr, x [maxdepth] expr, V [pkg [vars]], X [vars], y
 955 [level [vars]], T, s [expr], n [expr], r, <CR>, c [line|sub], l, l
 956 min+incr, l min-max, l line, l subname, -, v [line], f filename, /pattern/,
 957 ?pattern?, L [abw], S [[!]regex], t, t expr, b, b [line] [condition], b
 958 subname [condition], b postpone subname [condition], b load filename, b
 959 compile subname, B line, B *, a [line] command, A line, A *, w expr, W
 960 expr, W *, o, o booloption .., o anyoption? .., o option=value .., < ?, < [
 961 command ], << command, > ?, > command, >> command, { ?, { [ command ], {{
 962 command, ! number, ! -number, ! pattern, !! cmd, source file, H -number, q
 963 or ^D, R, |dbcmd, ||dbcmd, command, m expr, M, man [manpage]
 964
 965 =item Configurable Options
 966
 967 C<recallCommand>, C<ShellBang>, C<pager>, C<tkRunning>, C<signalLevel>,
 968 C<warnLevel>, C<dieLevel>, C<AutoTrace>, C<LineInfo>, C<inhibit_exit>,
 969 C<PrintRet>, C<ornaments>, C<frame>, C<maxTraceLen>, C<windowSize>,
 970 C<arrayDepth>, C<hashDepth>, C<dumpDepth>, C<compactDump>, C<veryCompact>,
 971 C<globPrint>, C<DumpDBFiles>, C<DumpPackages>, C<DumpReused>, C<quote>,
 972 C<HighBit>, C<undefPrint>, C<UsageOnly>, C<TTY>, C<noTTY>, C<ReadLine>,
 973 C<NonStop>
 974
 975 =item Debugger input/output
 976
 977 Prompt, Multiline commands, Stack backtrace, Line Listing Format, Frame
 978 listing
 979
 980 =item Debugging compile-time statements
 981
 982 =item Debugger Customization
 983
 984 =item Readline Support
 985
 986 =item Editor Support for Debugging
 987
 988 =item The Perl Profiler
 989
 990 =back
 991
 992 =item Debugging regular expressions
 993
 994 =item Debugging memory usage
 995
 996 =item SEE ALSO
 997
 998 =item BUGS
 999
1000 =back
1001
1002 =head2 perlvar - Perl predefined variables
1003
1004 =over 4
1005
1006 =item DESCRIPTION
1007
1008 =over 4
1009
1010 =item Predefined Names
1011
1012 $ARG, $_, $a, $b, $<I<digits>>, $MATCH, $&, $PREMATCH, $`, $POSTMATCH, $',
1013 $LAST_PAREN_MATCH, $+, $^N, @LAST_MATCH_END, @+, $MULTILINE_MATCHING, $*,
1014 HANDLE->input_line_number(EXPR), $INPUT_LINE_NUMBER, $NR, $,
1015 IO::Handle->input_record_separator(EXPR), $INPUT_RECORD_SEPARATOR, $RS, $/,
1016 HANDLE->autoflush(EXPR), $OUTPUT_AUTOFLUSH, $|,
1017 IO::Handle->output_field_separator EXPR, $OUTPUT_FIELD_SEPARATOR, $OFS, $,,
1018 IO::Handle->output_record_separator EXPR, $OUTPUT_RECORD_SEPARATOR, $ORS,
1019 $\, $LIST_SEPARATOR, $", $SUBSCRIPT_SEPARATOR, $SUBSEP, $;, $OFMT, $#,
1020 HANDLE->format_page_number(EXPR), $FORMAT_PAGE_NUMBER, $%,
1021 HANDLE->format_lines_per_page(EXPR), $FORMAT_LINES_PER_PAGE, $=,
1022 HANDLE->format_lines_left(EXPR), $FORMAT_LINES_LEFT, $-, @LAST_MATCH_START,
1023 @-, C<$`> is the same as C<substr($var, 0, $-[0])>, C<$&> is the same as
1024 C<substr($var, $-[0], $+[0] - $-[0])>, C<$'> is the same as C<substr($var,
1025 $+[0])>, C<$1> is the same as C<substr($var, $-[1], $+[1] - $-[1])>, C<$2>
1026 is the same as C<substr($var, $-[2], $+[2] - $-[2])>, C<$3> is the same as
1027 C<substr $var, $-[3], $+[3] - $-[3])>, HANDLE->format_name(EXPR),
1028 $FORMAT_NAME, $~, HANDLE->format_top_name(EXPR), $FORMAT_TOP_NAME, $^,
1029 IO::Handle->format_line_break_characters EXPR,
1030 $FORMAT_LINE_BREAK_CHARACTERS, $:, IO::Handle->format_formfeed EXPR,
1031 $FORMAT_FORMFEED, $^L, $ACCUMULATOR, $^A, $CHILD_ERROR, $?, ${^ENCODING},
1032 $OS_ERROR, $ERRNO, $!, %!, $EXTENDED_OS_ERROR, $^E, $EVAL_ERROR, $@,
1033 $PROCESS_ID, $PID, $$, $REAL_USER_ID, $UID, $<, $EFFECTIVE_USER_ID, $EUID,
1034 $>, $REAL_GROUP_ID, $GID, $(, $EFFECTIVE_GROUP_ID, $EGID, $),
1035 $PROGRAM_NAME, $0, $[, $], $COMPILING, $^C, $DEBUGGING, $^D,
1036 $SYSTEM_FD_MAX, $^F, $^H, %^H, $INPLACE_EDIT, $^I, $^M, $OSNAME, $^O,
1037 ${^OPEN}, $PERLDB, $^P, 0x01, 0x02, 0x04, 0x08, 0x10, 0x20, 0x40, 0x80,
1038 0x100, 0x200, $LAST_REGEXP_CODE_RESULT, $^R, $EXCEPTIONS_BEING_CAUGHT, $^S,
1039 $BASETIME, $^T, ${^TAINT}, $PERL_VERSION, $^V, $WARNING, $^W,
1040 ${^WARNING_BITS}, ${^WIDE_SYSTEM_CALLS}, $EXECUTABLE_NAME, $^X, ARGV,
1041 $ARGV, @ARGV, @F, @INC, @_, %INC, %ENV, $ENV{expr}, %SIG, $SIG{expr}
1042
1043 =item Error Indicators
1044
1045 =item Technical Note on the Syntax of Variable Names
1046
1047 =back
1048
1049 =item BUGS
1050
1051 =back
1052
1053 =head2 perllol - Manipulating Arrays of Arrays in Perl
1054
1055 =over 4
1056
1057 =item DESCRIPTION
1058
1059 =over 4
1060
1061 =item Declaration and Access of Arrays of Arrays
1062
1063 =item Growing Your Own
1064
1065 =item Access and Printing
1066
1067 =item Slices
1068
1069 =back
1070
1071 =item SEE ALSO
1072
1073 =item AUTHOR
1074
1075 =back
1076
1077 =head2 perlopentut - tutorial on opening things in Perl
1078
1079 =over 4
1080
1081 =item DESCRIPTION
1082
1083 =item Open E<agrave> la shell
1084
1085 =over 4
1086
1087 =item Simple Opens
1088
1089 =item Pipe Opens
1090
1091 =item The Minus File
1092
1093 =item Mixing Reads and Writes
1094
1095 =item Filters
1096
1097 =back
1098
1099 =item Open E<agrave> la C
1100
1101 =over 4
1102
1103 =item Permissions E<agrave> la mode
1104
1105 =back
1106
1107 =item Obscure Open Tricks
1108
1109 =over 4
1110
1111 =item Re-Opening Files (dups)
1112
1113 =item Dispelling the Dweomer
1114
1115 =item Paths as Opens
1116
1117 =item Single Argument Open
1118
1119 =item Playing with STDIN and STDOUT
1120
1121 =back
1122
1123 =item Other I/O Issues
1124
1125 =over 4
1126
1127 =item Opening Non-File Files
1128
1129 =item Binary Files
1130
1131 =item File Locking
1132
1133 =item IO Layers
1134
1135 =back
1136
1137 =item SEE ALSO
1138
1139 =item AUTHOR and COPYRIGHT
1140
1141 =item HISTORY
1142
1143 =back
1144
1145 =head2 perlpacktut - tutorial on C<pack> and C<unpack>
1146
1147 =over 4
1148
1149 =item DESCRIPTION
1150
1151 =item The Basic Principle
1152
1153 =item Packing Text
1154
1155 =item Packing Numbers
1156
1157 =over 4
1158
1159 =item Integers
1160
1161 =item Unpacking a Stack Frame
1162
1163 =item How to Eat an Egg on a Net
1164
1165 =item Floating point Numbers
1166
1167 =back
1168
1169 =item Exotic Templates
1170
1171 =over 4
1172
1173 =item Bit Strings
1174
1175 =item Uuencoding
1176
1177 =item Doing Sums
1178
1179 =item  Unicode
1180
1181 =item Another Portable Binary Encoding
1182
1183 =back
1184
1185 =item Lengths and Widths
1186
1187 =over 4
1188
1189 =item String Lengths
1190
1191 =item Dynamic Templates
1192
1193 =back
1194
1195 =item Packing and Unpacking C Structures
1196
1197 =over 4
1198
1199 =item The Alignment Pit
1200
1201 =item Alignment, Take 2
1202
1203 =item Alignment, Take 3
1204
1205 =item Pointers for How to Use Them
1206
1207 =back
1208
1209 =item Pack Recipes
1210
1211 =item Funnies Section
1212
1213 =item Authors
1214
1215 =back
1216
1217 =head2 perlretut - Perl regular expressions tutorial
1218
1219 =over 4
1220
1221 =item DESCRIPTION
1222
1223 =item Part 1: The basics
1224
1225 =over 4
1226
1227 =item Simple word matching
1228
1229 =item Using character classes
1230
1231 =item Matching this or that
1232
1233 =item Grouping things and hierarchical matching
1234
1235 =item Extracting matches
1236
1237 =item Matching repetitions
1238
1239 =item Building a regexp
1240
1241 =item Using regular expressions in Perl
1242
1243 =back
1244
1245 =item Part 2: Power tools
1246
1247 =over 4
1248
1249 =item More on characters, strings, and character classes
1250
1251 =item Compiling and saving regular expressions
1252
1253 =item Embedding comments and modifiers in a regular expression
1254
1255 =item Non-capturing groupings
1256
1257 =item Looking ahead and looking behind
1258
1259 =item Using independent subexpressions to prevent backtracking
1260
1261 =item Conditional expressions
1262
1263 =item A bit of magic: executing Perl code in a regular expression
1264
1265 =item Pragmas and debugging
1266
1267 =back
1268
1269 =item BUGS
1270
1271 =item SEE ALSO
1272
1273 =item AUTHOR AND COPYRIGHT
1274
1275 =over 4
1276
1277 =item Acknowledgments
1278
1279 =back
1280
1281 =back
1282
1283 =head2 perlre - Perl regular expressions
1284
1285 =over 4
1286
1287 =item DESCRIPTION
1288
1289 i, m, s, x
1290
1291 =over 4
1292
1293 =item Regular Expressions
1294
1295 [1], [2], [3], cntrl, graph, print, punct, xdigit
1296
1297 =item Extended Patterns
1298
1299 C<(?#text)>, C<(?imsx-imsx)>, C<(?:pattern)>, C<(?imsx-imsx:pattern)>,
1300 C<(?=pattern)>, C<(?!pattern)>, C<(?<=pattern)>, C<(?<!pattern)>, C<(?{
1301 code })>, C<(??{ code })>, C<< (?>pattern) >>,
1302 C<(?(condition)yes-pattern|no-pattern)>, C<(?(condition)yes-pattern)>
1303
1304 =item Backtracking
1305
1306 =item Version 8 Regular Expressions
1307
1308 =item Warning on \1 vs $1
1309
1310 =item Repeated patterns matching zero-length substring
1311
1312 =item Combining pieces together
1313
1314 C<ST>, C<S|T>, C<S{REPEAT_COUNT}>, C<S{min,max}>, C<S{min,max}?>, C<S?>,
1315 C<S*>, C<S+>, C<S??>, C<S*?>, C<S+?>, C<< (?>S) >>, C<(?=S)>, C<(?<=S)>,
1316 C<(?!S)>, C<(?<!S)>, C<(??{ EXPR })>,
1317 C<(?(condition)yes-pattern|no-pattern)>
1318
1319 =item Creating custom RE engines
1320
1321 =back
1322
1323 =item BUGS
1324
1325 =item SEE ALSO
1326
1327 =back
1328
1329 =head2 perlref - Perl references and nested data structures
1330
1331 =over 4
1332
1333 =item NOTE
1334
1335 =item DESCRIPTION
1336
1337 =over 4
1338
1339 =item Making References
1340
1341 =item Using References
1342
1343 =item Symbolic references
1344
1345 =item Not-so-symbolic references
1346
1347 =item Pseudo-hashes: Using an array as a hash
1348
1349 =item Function Templates
1350
1351 =back
1352
1353 =item WARNING
1354
1355 =item SEE ALSO
1356
1357 =back
1358
1359 =head2 perlform - Perl formats
1360
1361 =over 4
1362
1363 =item DESCRIPTION
1364
1365 =over 4
1366
1367 =item Format Variables
1368
1369 =back
1370
1371 =item NOTES
1372
1373 =over 4
1374
1375 =item Footers
1376
1377 =item Accessing Formatting Internals
1378
1379 =back
1380
1381 =item WARNINGS
1382
1383 =back
1384
1385 =head2 perlboot - Beginner's Object-Oriented Tutorial
1386
1387 =over 4
1388
1389 =item DESCRIPTION
1390
1391 =over 4
1392
1393 =item If we could talk to the animals...
1394
1395 =item Introducing the method invocation arrow
1396
1397 =item Invoking a barnyard
1398
1399 =item The extra parameter of method invocation
1400
1401 =item Calling a second method to simplify things
1402
1403 =item Inheriting the windpipes
1404
1405 =item A few notes about @ISA
1406
1407 =item Overriding the methods
1408
1409 =item Starting the search from a different place
1410
1411 =item The SUPER way of doing things
1412
1413 =item Where we're at so far...
1414
1415 =item A horse is a horse, of course of course -- or is it?
1416
1417 =item Invoking an instance method
1418
1419 =item Accessing the instance data
1420
1421 =item How to build a horse
1422
1423 =item Inheriting the constructor
1424
1425 =item Making a method work with either classes or instances
1426
1427 =item Adding parameters to a method
1428
1429 =item More interesting instances
1430
1431 =item A horse of a different color
1432
1433 =item Summary
1434
1435 =back
1436
1437 =item SEE ALSO
1438
1439 =item COPYRIGHT
1440
1441 =back
1442
1443 =head2 perltoot - Tom's object-oriented tutorial for perl
1444
1445 =over 4
1446
1447 =item DESCRIPTION
1448
1449 =item Creating a Class
1450
1451 =over 4
1452
1453 =item Object Representation
1454
1455 =item Class Interface
1456
1457 =item Constructors and Instance Methods
1458
1459 =item Planning for the Future: Better Constructors
1460
1461 =item Destructors
1462
1463 =item Other Object Methods
1464
1465 =back
1466
1467 =item Class Data
1468
1469 =over 4
1470
1471 =item Accessing Class Data
1472
1473 =item Debugging Methods
1474
1475 =item Class Destructors
1476
1477 =item Documenting the Interface
1478
1479 =back
1480
1481 =item Aggregation
1482
1483 =item Inheritance
1484
1485 =over 4
1486
1487 =item Overridden Methods
1488
1489 =item Multiple Inheritance
1490
1491 =item UNIVERSAL: The Root of All Objects
1492
1493 =back
1494
1495 =item Alternate Object Representations
1496
1497 =over 4
1498
1499 =item Arrays as Objects
1500
1501 =item Closures as Objects
1502
1503 =back
1504
1505 =item AUTOLOAD: Proxy Methods
1506
1507 =over 4
1508
1509 =item Autoloaded Data Methods
1510
1511 =item Inherited Autoloaded Data Methods
1512
1513 =back
1514
1515 =item Metaclassical Tools
1516
1517 =over 4
1518
1519 =item Class::Struct
1520
1521 =item Data Members as Variables
1522
1523 =back
1524
1525 =item NOTES
1526
1527 =over 4
1528
1529 =item Object Terminology
1530
1531 =back
1532
1533 =item SEE ALSO
1534
1535 =item AUTHOR AND COPYRIGHT
1536
1537 =item COPYRIGHT
1538
1539 =over 4
1540
1541 =item Acknowledgments
1542
1543 =back
1544
1545 =back
1546
1547 =head2 perltooc - Tom's OO Tutorial for Class Data in Perl
1548
1549 =over 4
1550
1551 =item DESCRIPTION
1552
1553 =item Class Data in a Can
1554
1555 =item Class Data as Package Variables
1556
1557 =over 4
1558
1559 =item Putting All Your Eggs in One Basket
1560
1561 =item Inheritance Concerns
1562
1563 =item The Eponymous Meta-Object
1564
1565 =item Indirect References to Class Data
1566
1567 =item Monadic Classes
1568
1569 =item Translucent Attributes
1570
1571 =back
1572
1573 =item Class Data as Lexical Variables
1574
1575 =over 4
1576
1577 =item Privacy and Responsibility
1578
1579 =item File-Scoped Lexicals
1580
1581 =item More Inheritance Concerns
1582
1583 =item Locking the Door and Throwing Away the Key
1584
1585 =item Translucency Revisited
1586
1587 =back
1588
1589 =item NOTES
1590
1591 =item SEE ALSO
1592
1593 =item AUTHOR AND COPYRIGHT
1594
1595 =item ACKNOWLEDGEMENTS
1596
1597 =item HISTORY
1598
1599 =back
1600
1601 =head2 perlobj - Perl objects
1602
1603 =over 4
1604
1605 =item DESCRIPTION
1606
1607 =over 4
1608
1609 =item An Object is Simply a Reference
1610
1611 =item A Class is Simply a Package
1612
1613 =item A Method is Simply a Subroutine
1614
1615 =item Method Invocation
1616
1617 =item Indirect Object Syntax
1618
1619 =item Default UNIVERSAL methods
1620
1621 isa(CLASS), can(METHOD), VERSION( [NEED] )
1622
1623 =item Destructors
1624
1625 =item Summary
1626
1627 =item Two-Phased Garbage Collection
1628
1629 =back
1630
1631 =item SEE ALSO
1632
1633 =back
1634
1635 =head2 perlbot - Bag'o Object Tricks (the BOT)
1636
1637 =over 4
1638
1639 =item DESCRIPTION
1640
1641 =item OO SCALING TIPS
1642
1643 =item INSTANCE VARIABLES
1644
1645 =item SCALAR INSTANCE VARIABLES
1646
1647 =item INSTANCE VARIABLE INHERITANCE
1648
1649 =item OBJECT RELATIONSHIPS
1650
1651 =item OVERRIDING SUPERCLASS METHODS
1652
1653 =item USING RELATIONSHIP WITH SDBM
1654
1655 =item THINKING OF CODE REUSE
1656
1657 =item CLASS CONTEXT AND THE OBJECT
1658
1659 =item INHERITING A CONSTRUCTOR
1660
1661 =item DELEGATION
1662
1663 =back
1664
1665 =head2 perltie - how to hide an object class in a simple variable
1666
1667 =over 4
1668
1669 =item SYNOPSIS
1670
1671 =item DESCRIPTION
1672
1673 =over 4
1674
1675 =item Tying Scalars
1676
1677 TIESCALAR classname, LIST, FETCH this, STORE this, value, UNTIE this,
1678 DESTROY this
1679
1680 =item Tying Arrays
1681
1682 TIEARRAY classname, LIST, FETCH this, index, STORE this, index, value,
1683 FETCHSIZE this, STORESIZE this, count, EXTEND this, count, EXISTS this,
1684 key, DELETE this, key, CLEAR this, PUSH this, LIST, POP this, SHIFT this,
1685 UNSHIFT this, LIST, SPLICE this, offset, length, LIST, UNTIE this, DESTROY
1686 this
1687
1688 =item Tying Hashes
1689
1690 USER, HOME, CLOBBER, LIST, TIEHASH classname, LIST, FETCH this, key, STORE
1691 this, key, value, DELETE this, key, CLEAR this, EXISTS this, key, FIRSTKEY
1692 this, NEXTKEY this, lastkey, UNTIE this, DESTROY this
1693
1694 =item Tying FileHandles
1695
1696 TIEHANDLE classname, LIST, WRITE this, LIST, PRINT this, LIST, PRINTF this,
1697 LIST, READ this, LIST, READLINE this, GETC this, CLOSE this, UNTIE this,
1698 DESTROY this
1699
1700 =item UNTIE this
1701
1702 =item The C<untie> Gotcha
1703
1704 =back
1705
1706 =item SEE ALSO
1707
1708 =item BUGS
1709
1710 =item AUTHOR
1711
1712 =back
1713
1714 =head2 perlipc - Perl interprocess communication (signals, fifos, pipes,
1715 safe subprocesses, sockets, and semaphores)
1716
1717 =over 4
1718
1719 =item DESCRIPTION
1720
1721 =item Signals
1722
1723 =over 4
1724
1725 =item Handling the SIGHUP Signal in Daemons
1726
1727 =back
1728
1729 =item Named Pipes
1730
1731 =over 4
1732
1733 =item Deferred Signals
1734
1735 Long running opcodes, Interrupting IO, Signals as "faults", Signals
1736 triggered by operating system state
1737
1738 =back
1739
1740 =item Using open() for IPC
1741
1742 =over 4
1743
1744 =item Filehandles
1745
1746 =item Background Processes
1747
1748 =item Complete Dissociation of Child from Parent
1749
1750 =item Safe Pipe Opens
1751
1752 =item Bidirectional Communication with Another Process
1753
1754 =item Bidirectional Communication with Yourself
1755
1756 =back
1757
1758 =item Sockets: Client/Server Communication
1759
1760 =over 4
1761
1762 =item Internet Line Terminators
1763
1764 =item Internet TCP Clients and Servers
1765
1766 =item Unix-Domain TCP Clients and Servers
1767
1768 =back
1769
1770 =item TCP Clients with IO::Socket
1771
1772 =over 4
1773
1774 =item A Simple Client
1775
1776 C<Proto>, C<PeerAddr>, C<PeerPort>
1777
1778 =item A Webget Client
1779
1780 =item Interactive Client with IO::Socket
1781
1782 =back
1783
1784 =item TCP Servers with IO::Socket
1785
1786 Proto, LocalPort, Listen, Reuse
1787
1788 =item UDP: Message Passing
1789
1790 =item SysV IPC
1791
1792 =item NOTES
1793
1794 =item BUGS
1795
1796 =item AUTHOR
1797
1798 =item SEE ALSO
1799
1800 =back
1801
1802 =head2 perlfork - Perl's fork() emulation
1803
1804 =over 4
1805
1806 =item SYNOPSIS
1807
1808 =item DESCRIPTION
1809
1810 =over 4
1811
1812 =item Behavior of other Perl features in forked pseudo-processes
1813
1814 $$ or $PROCESS_ID, %ENV, chdir() and all other builtins that accept
1815 filenames, wait() and waitpid(), kill(), exec(), exit(), Open handles to
1816 files, directories and network sockets
1817
1818 =item Resource limits
1819
1820 =item Killing the parent process
1821
1822 =item Lifetime of the parent process and pseudo-processes
1823
1824 =item CAVEATS AND LIMITATIONS
1825
1826 BEGIN blocks, Open filehandles, Forking pipe open() not yet implemented,
1827 Global state maintained by XSUBs, Interpreter embedded in larger
1828 application, Thread-safety of extensions
1829
1830 =back
1831
1832 =item BUGS
1833
1834 =item AUTHOR
1835
1836 =item SEE ALSO
1837
1838 =back
1839
1840 =head2 perlnumber - semantics of numbers and numeric operations in Perl
1841
1842 =over 4
1843
1844 =item SYNOPSIS
1845
1846 =item DESCRIPTION
1847
1848 =item Storing numbers
1849
1850 =item Numeric operators and numeric conversions
1851
1852 =item Flavors of Perl numeric operations
1853
1854 Arithmetic operators except, C<no integer>, Arithmetic operators except,
1855 C<use integer>, Bitwise operators, C<no integer>, Bitwise operators, C<use
1856 integer>, Operators which expect an integer, Operators which expect a
1857 string
1858
1859 =item AUTHOR
1860
1861 =item SEE ALSO
1862
1863 =back
1864
1865 =head2 perlthrtut - tutorial on threads in Perl
1866
1867 =over 4
1868
1869 =item DESCRIPTION
1870
1871 =item Status
1872
1873 =item What Is A Thread Anyway?
1874
1875 =item Threaded Program Models
1876
1877 =over 4
1878
1879 =item Boss/Worker
1880
1881 =item Work Crew
1882
1883 =item Pipeline
1884
1885 =back
1886
1887 =item Native threads
1888
1889 =item What kind of threads are Perl threads?
1890
1891 =item Threadsafe Modules
1892
1893 =item Thread Basics
1894
1895 =over 4
1896
1897 =item Basic Thread Support
1898
1899 =item A Note about the Examples
1900
1901 =item Creating Threads
1902
1903 =item Giving up control
1904
1905 =item Waiting For A Thread To Exit
1906
1907 =item Ignoring A Thread
1908
1909 =back
1910
1911 =item Threads And Data
1912
1913 =over 4
1914
1915 =item Shared And Unshared Data
1916
1917 =item Thread Pitfalls: Races
1918
1919 =back
1920
1921 =item Synchronization and control
1922
1923 =over 4
1924
1925 =item Controlling access: lock()
1926
1927 =item A Thread Pitfall: Deadlocks
1928
1929 =item Queues: Passing Data Around
1930
1931 =item Semaphores: Synchronizing Data Access
1932
1933 =item Basic semaphores
1934
1935 =item Advanced Semaphores
1936
1937 =item cond_wait() and cond_signal()
1938
1939 =back
1940
1941 =item General Thread Utility Routines
1942
1943 =over 4
1944
1945 =item What Thread Am I In?
1946
1947 =item Thread IDs
1948
1949 =item Are These Threads The Same?
1950
1951 =item What Threads Are Running?
1952
1953 =back
1954
1955 =item A Complete Example
1956
1957 =item Performance considerations
1958
1959 =item Threadsafety of System Libraries
1960
1961 =item Conclusion
1962
1963 =item Bibliography
1964
1965 =over 4
1966
1967 =item Introductory Texts
1968
1969 =item OS-Related References
1970
1971 =item Other References
1972
1973 =back
1974
1975 =item Acknowledgements
1976
1977 =item AUTHOR
1978
1979 =item Copyrights
1980
1981 =back
1982
1983 =head2 perlothrtut - old tutorial on threads in Perl
1984
1985 =over 4
1986
1987 =item DESCRIPTION
1988
1989 =item What Is A Thread Anyway?
1990
1991 =item Threaded Program Models
1992
1993 =over 4
1994
1995 =item Boss/Worker
1996
1997 =item Work Crew
1998
1999 =item Pipeline
2000
2001 =back
2002
2003 =item Native threads
2004
2005 =item What kind of threads are perl threads?
2006
2007 =item Threadsafe Modules
2008
2009 =item Thread Basics
2010
2011 =over 4
2012
2013 =item Basic Thread Support
2014
2015 =item Creating Threads
2016
2017 =item Giving up control
2018
2019 =item Waiting For A Thread To Exit
2020
2021 =item Errors In Threads
2022
2023 =item Ignoring A Thread
2024
2025 =back
2026
2027 =item Threads And Data
2028
2029 =over 4
2030
2031 =item Shared And Unshared Data
2032
2033 =item Thread Pitfall: Races
2034
2035 =item Controlling access: lock()
2036
2037 =item Thread Pitfall: Deadlocks
2038
2039 =item Queues: Passing Data Around
2040
2041 =back
2042
2043 =item Threads And Code
2044
2045 =over 4
2046
2047 =item Semaphores: Synchronizing Data Access
2048
2049 Basic semaphores, Advanced Semaphores
2050
2051 =item Attributes: Restricting Access To Subroutines
2052
2053 =item Subroutine Locks
2054
2055 =item Methods
2056
2057 =item Locking A Subroutine
2058
2059 =back
2060
2061 =item General Thread Utility Routines
2062
2063 =over 4
2064
2065 =item What Thread Am I In?
2066
2067 =item Thread IDs
2068
2069 =item Are These Threads The Same?
2070
2071 =item What Threads Are Running?
2072
2073 =back
2074
2075 =item A Complete Example
2076
2077 =item Conclusion
2078
2079 =item Bibliography
2080
2081 =over 4
2082
2083 =item Introductory Texts
2084
2085 =item OS-Related References
2086
2087 =item Other References
2088
2089 =back
2090
2091 =item Acknowledgements
2092
2093 =item AUTHOR
2094
2095 =item Copyrights
2096
2097 =back
2098
2099 =head2 perlport - Writing portable Perl
2100
2101 =over 4
2102
2103 =item DESCRIPTION
2104
2105 Not all Perl programs have to be portable, Nearly all of Perl already I<is>
2106 portable
2107
2108 =item ISSUES
2109
2110 =over 4
2111
2112 =item Newlines
2113
2114 =item Numbers endianness and Width
2115
2116 =item Files and Filesystems
2117
2118 =item System Interaction
2119
2120 =item Command names versus file pathnames
2121
2122 =item Interprocess Communication (IPC)
2123
2124 =item External Subroutines (XS)
2125
2126 =item Standard Modules
2127
2128 =item Time and Date
2129
2130 =item Character sets and character encoding
2131
2132 =item Internationalisation
2133
2134 =item System Resources
2135
2136 =item Security
2137
2138 =item Style
2139
2140 =back
2141
2142 =item CPAN Testers
2143
2144 Mailing list: cpan-testers@perl.org, Testing results:
2145 http://testers.cpan.org/
2146
2147 =item PLATFORMS
2148
2149 =over 4
2150
2151 =item Unix
2152
2153 =item DOS and Derivatives
2154
2155 =item S<Mac OS>
2156
2157 =item VMS
2158
2159 =item VOS
2160
2161 =item EBCDIC Platforms
2162
2163 =item Acorn RISC OS
2164
2165 =item Other perls
2166
2167 =back
2168
2169 =item FUNCTION IMPLEMENTATIONS
2170
2171 =over 4
2172
2173 =item Alphabetical Listing of Perl Functions
2174
2175 -I<X> FILEHANDLE, -I<X> EXPR, -I<X>, alarm SECONDS, alarm, binmode
2176 FILEHANDLE, chmod LIST, chown LIST, chroot FILENAME, chroot, crypt
2177 PLAINTEXT,SALT, dbmclose HASH, dbmopen HASH,DBNAME,MODE, dump LABEL, exec
2178 LIST, exit EXPR, exit, fcntl FILEHANDLE,FUNCTION,SCALAR, flock
2179 FILEHANDLE,OPERATION, fork, getlogin, getpgrp PID, getppid, getpriority
2180 WHICH,WHO, getpwnam NAME, getgrnam NAME, getnetbyname NAME, getpwuid UID,
2181 getgrgid GID, getnetbyaddr ADDR,ADDRTYPE, getprotobynumber NUMBER,
2182 getservbyport PORT,PROTO, getpwent, getgrent, gethostent, getnetent,
2183 getprotoent, getservent, sethostent STAYOPEN, setnetent STAYOPEN,
2184 setprotoent STAYOPEN, setservent STAYOPEN, endpwent, endgrent, endhostent,
2185 endnetent, endprotoent, endservent, getsockopt SOCKET,LEVEL,OPTNAME, glob
2186 EXPR, glob, ioctl FILEHANDLE,FUNCTION,SCALAR, kill SIGNAL, LIST, link
2187 OLDFILE,NEWFILE, lstat FILEHANDLE, lstat EXPR, lstat, msgctl ID,CMD,ARG,
2188 msgget KEY,FLAGS, msgsnd ID,MSG,FLAGS, msgrcv ID,VAR,SIZE,TYPE,FLAGS, open
2189 FILEHANDLE,EXPR, open FILEHANDLE, pipe READHANDLE,WRITEHANDLE, readlink
2190 EXPR, readlink, select RBITS,WBITS,EBITS,TIMEOUT, semctl ID,SEMNUM,CMD,ARG,
2191 semget KEY,NSEMS,FLAGS, semop KEY,OPSTRING, setgrent, setpgrp PID,PGRP,
2192 setpriority WHICH,WHO,PRIORITY, setpwent, setsockopt
2193 SOCKET,LEVEL,OPTNAME,OPTVAL, shmctl ID,CMD,ARG, shmget KEY,SIZE,FLAGS,
2194 shmread ID,VAR,POS,SIZE, shmwrite ID,STRING,POS,SIZE, sockatmark SOCKET,
2195 socketpair SOCKET1,SOCKET2,DOMAIN,TYPE,PROTOCOL, stat FILEHANDLE, stat
2196 EXPR, stat, symlink OLDFILE,NEWFILE, syscall LIST, sysopen
2197 FILEHANDLE,FILENAME,MODE,PERMS, system LIST, times, truncate
2198 FILEHANDLE,LENGTH, truncate EXPR,LENGTH, umask EXPR, umask, utime LIST,
2199 wait, waitpid PID,FLAGS
2200
2201 =back
2202
2203 =item CHANGES
2204
2205 v1.48, 02 February 2001, v1.47, 22 March 2000, v1.46, 12 February 2000,
2206 v1.45, 20 December 1999, v1.44, 19 July 1999, v1.43, 24 May 1999, v1.42, 22
2207 May 1999, v1.41, 19 May 1999, v1.40, 11 April 1999, v1.39, 11 February
2208 1999, v1.38, 31 December 1998, v1.37, 19 December 1998, v1.36, 9 September
2209 1998, v1.35, 13 August 1998, v1.33, 06 August 1998, v1.32, 05 August 1998,
2210 v1.30, 03 August 1998, v1.23, 10 July 1998
2211
2212 =item Supported Platforms
2213
2214 =item SEE ALSO
2215
2216 =item AUTHORS / CONTRIBUTORS
2217
2218 =back
2219
2220 =head2 perllocale - Perl locale handling (internationalization and
2221 localization)
2222
2223 =over 4
2224
2225 =item DESCRIPTION
2226
2227 =item PREPARING TO USE LOCALES
2228
2229 =item USING LOCALES
2230
2231 =over 4
2232
2233 =item The use locale pragma
2234
2235 =item The setlocale function
2236
2237 =item Finding locales
2238
2239 =item LOCALE PROBLEMS
2240
2241 =item Temporarily fixing locale problems
2242
2243 =item Permanently fixing locale problems
2244
2245 =item Permanently fixing your system's locale configuration
2246
2247 =item Fixing system locale configuration
2248
2249 =item The localeconv function
2250
2251 =item I18N::Langinfo
2252
2253 =back
2254
2255 =item LOCALE CATEGORIES
2256
2257 =over 4
2258
2259 =item Category LC_COLLATE: Collation
2260
2261 =item Category LC_CTYPE: Character Types
2262
2263 =item Category LC_NUMERIC: Numeric Formatting
2264
2265 =item Category LC_MONETARY: Formatting of monetary amounts
2266
2267 =item LC_TIME
2268
2269 =item Other categories
2270
2271 =back
2272
2273 =item SECURITY
2274
2275 =item ENVIRONMENT
2276
2277 PERL_BADLANG, LC_ALL, LANGUAGE, LC_CTYPE, LC_COLLATE, LC_MONETARY,
2278 LC_NUMERIC, LC_TIME, LANG
2279
2280 =item NOTES
2281
2282 =over 4
2283
2284 =item Backward compatibility
2285
2286 =item I18N:Collate obsolete
2287
2288 =item Sort speed and memory use impacts
2289
2290 =item write() and LC_NUMERIC
2291
2292 =item Freely available locale definitions
2293
2294 =item I18n and l10n
2295
2296 =item An imperfect standard
2297
2298 =back
2299
2300 =item Unicode and UTF-8
2301
2302 =item BUGS
2303
2304 =over 4
2305
2306 =item Broken systems
2307
2308 =back
2309
2310 =item SEE ALSO
2311
2312 =item HISTORY
2313
2314 =back
2315
2316 =head2 perluniintro - Perl Unicode introduction
2317
2318 =over 4
2319
2320 =item DESCRIPTION
2321
2322 =over 4
2323
2324 =item Unicode
2325
2326 =item Perl's Unicode Support
2327
2328 =item Perl's Unicode Model
2329
2330 =item Unicode and EBCDIC
2331
2332 =item Creating Unicode
2333
2334 =item Handling Unicode
2335
2336 =item Legacy Encodings
2337
2338 =item Unicode I/O
2339
2340 =item Displaying Unicode As Text
2341
2342 =item Special Cases
2343
2344 =item Advanced Topics
2345
2346 =item Miscellaneous
2347
2348 =item Questions With Answers
2349
2350 =item Hexadecimal Notation
2351
2352 =item Further Resources
2353
2354 =back
2355
2356 =item UNICODE IN OLDER PERLS
2357
2358 =item SEE ALSO
2359
2360 =item ACKNOWLEDGMENTS
2361
2362 =item AUTHOR, COPYRIGHT, AND LICENSE
2363
2364 =back
2365
2366 =head2 perlunicode - Unicode support in Perl
2367
2368 =over 4
2369
2370 =item DESCRIPTION
2371
2372 =over 4
2373
2374 =item Important Caveats
2375
2376 Input and Output Layers, Regular Expressions, C<use utf8> still needed to
2377 enable UTF-8/UTF-EBCDIC in scripts
2378
2379 =item Byte and Character Semantics
2380
2381 =item Effects of Character Semantics
2382
2383 =item Scripts
2384
2385 =item Blocks
2386
2387 =item User-Defined Character Properties
2388
2389 =item Character Encodings for Input and Output
2390
2391 =item Unicode Regular Expression Support Level
2392
2393 =item Unicode Encodings
2394
2395 =item Security Implications of Unicode
2396
2397 =item Unicode in Perl on EBCDIC
2398
2399 =item Locales
2400
2401 =item Using Unicode in XS
2402
2403 =back
2404
2405 =item BUGS
2406
2407 =over 4
2408
2409 =item Interaction with Locales
2410
2411 =item Interaction with Extensions
2412
2413 =item Speed
2414
2415 =back
2416
2417 =item SEE ALSO
2418
2419 =back
2420
2421 =head2 perlebcdic - Considerations for running Perl on EBCDIC platforms
2422
2423 =over 4
2424
2425 =item DESCRIPTION
2426
2427 =item COMMON CHARACTER CODE SETS
2428
2429 =over 4
2430
2431 =item ASCII
2432
2433 =item ISO 8859
2434
2435 =item Latin 1 (ISO 8859-1)
2436
2437 =item EBCDIC
2438
2439 =item 13 variant characters
2440
2441 =item 0037
2442
2443 =item 1047
2444
2445 =item POSIX-BC
2446
2447 =item Unicode code points versus EBCDIC code points
2448
2449 =item Remaining Perl Unicode problems in EBCDIC
2450
2451 =item Unicode and UTF
2452
2453 =item Using Encode
2454
2455 =back
2456
2457 =item SINGLE OCTET TABLES
2458
2459 recipe 0, recipe 1, recipe 2, recipe 3, recipe 4, recipe 5, recipe 6
2460
2461 =item IDENTIFYING CHARACTER CODE SETS
2462
2463 =item CONVERSIONS
2464
2465 =over 4
2466
2467 =item tr///
2468
2469 =item iconv
2470
2471 =item C RTL
2472
2473 =back
2474
2475 =item OPERATOR DIFFERENCES
2476
2477 =item FUNCTION DIFFERENCES
2478
2479 chr(), ord(), pack(), print(), printf(), sort(), sprintf(), unpack()
2480
2481 =item REGULAR EXPRESSION DIFFERENCES
2482
2483 =item SOCKETS
2484
2485 =item SORTING
2486
2487 =over 4
2488
2489 =item Ignore ASCII vs. EBCDIC sort differences.
2490
2491 =item MONO CASE then sort data.
2492
2493 =item Convert, sort data, then re convert.
2494
2495 =item Perform sorting on one type of machine only.
2496
2497 =back
2498
2499 =item TRANSFORMATION FORMATS
2500
2501 =over 4
2502
2503 =item URL decoding and encoding
2504
2505 =item uu encoding and decoding
2506
2507 =item Quoted-Printable encoding and decoding
2508
2509 =item Caesarian ciphers
2510
2511 =back
2512
2513 =item Hashing order and checksums
2514
2515 =item I18N AND L10N
2516
2517 =item MULTI OCTET CHARACTER SETS
2518
2519 =item OS ISSUES
2520
2521 =over 4
2522
2523 =item OS/400
2524
2525 IFS access
2526
2527 =item OS/390, z/OS
2528
2529 chcp, dataset access, OS/390, z/OS iconv, locales
2530
2531 =item VM/ESA?
2532
2533 =item POSIX-BC?
2534
2535 =back
2536
2537 =item BUGS
2538
2539 =item SEE ALSO
2540
2541 =item REFERENCES
2542
2543 =item HISTORY
2544
2545 =item AUTHOR
2546
2547 =back
2548
2549 =head2 perlsec - Perl security
2550
2551 =over 4
2552
2553 =item DESCRIPTION
2554
2555 =over 4
2556
2557 =item Laundering and Detecting Tainted Data
2558
2559 =item Switches On the "#!" Line
2560
2561 =item Cleaning Up Your Path
2562
2563 =item Security Bugs
2564
2565 =item Protecting Your Programs
2566
2567 =item Unicode
2568
2569 =back
2570
2571 =item SEE ALSO
2572
2573 =back
2574
2575 =head2 perlmod - Perl modules (packages and symbol tables)
2576
2577 =over 4
2578
2579 =item DESCRIPTION
2580
2581 =over 4
2582
2583 =item Packages
2584
2585 =item Symbol Tables
2586
2587 =item Package Constructors and Destructors
2588
2589 =item Perl Classes
2590
2591 =item Perl Modules
2592
2593 =item Making your module threadsafe
2594
2595 =back
2596
2597 =item SEE ALSO
2598
2599 =back
2600
2601 =head2 perlmodinstall - Installing CPAN Modules
2602
2603 =over 4
2604
2605 =item DESCRIPTION
2606
2607 =over 4
2608
2609 =item PREAMBLE
2610
2611 B<DECOMPRESS> the file, B<UNPACK> the file into a directory, B<BUILD> the
2612 module (sometimes unnecessary), B<INSTALL> the module
2613
2614 =back
2615
2616 =item PORTABILITY
2617
2618 =item HEY
2619
2620 =item AUTHOR
2621
2622 =item COPYRIGHT
2623
2624 =back
2625
2626 =head2 perlmodlib - constructing new Perl modules and finding existing ones
2627
2628 =over 4
2629
2630 =item DESCRIPTION
2631
2632 =item THE PERL MODULE LIBRARY
2633
2634 =over 4
2635
2636 =item Pragmatic Modules
2637
2638 attributes, attrs, autouse, base, bigint, bignum, bigrat, blib, bytes,
2639 charnames, constant, diagnostics, encoding, fields, filetest, if, integer,
2640 less, locale, open, ops, overload, re, sigtrap, sort, strict, subs,
2641 threads, utf8, vars, vmsish, warnings, warnings::register
2642
2643 =item Standard Modules
2644
2645 AnyDBM_File, Attribute::Handlers, AutoLoader, AutoSplit, B, B::Asmdata,
2646 B::Assembler, B::Bblock, B::Bytecode, B::C, B::CC, B::Concise, B::Debug,
2647 B::Deparse, B::Disassembler, B::Lint, B::Showlex, B::Stackobj, B::Stash,
2648 B::Terse, B::Xref, Benchmark, ByteLoader, CGI, CGI::Apache, CGI::Carp,
2649 CGI::Cookie, CGI::Fast, CGI::Pretty, CGI::Push, CGI::Switch, CGI::Util,
2650 CPAN, CPAN::FirstTime, CPAN::Nox, Carp, Carp::Heavy, Class::ISA,
2651 Class::Struct, Config, Cwd, DB, DB_File, Devel::SelfStubber, Digest,
2652 DirHandle, Dumpvalue, Encode, English, Env, Errno, Exporter,
2653 Exporter::Heavy, ExtUtils::Command, ExtUtils::Command::MM,
2654 ExtUtils::Constant, ExtUtils::Embed, ExtUtils::Install,
2655 ExtUtils::Installed, ExtUtils::Liblist, ExtUtils::MM, ExtUtils::MM_Any,
2656 ExtUtils::MM_BeOS, ExtUtils::MM_Cygwin, ExtUtils::MM_DOS,
2657 ExtUtils::MM_MacOS, ExtUtils::MM_NW5, ExtUtils::MM_OS2, ExtUtils::MM_UWIN,
2658 ExtUtils::MM_Unix, ExtUtils::MM_VMS, ExtUtils::MM_Win32,
2659 ExtUtils::MM_Win95, ExtUtils::MY, ExtUtils::MakeMaker, ExtUtils::Manifest,
2660 ExtUtils::Mkbootstrap, ExtUtils::Mksymlists, ExtUtils::Packlist,
2661 ExtUtils::testlib, Fatal, Fcntl, File::Basename, File::CheckTree,
2662 File::Compare, File::Copy, File::DosGlob, File::Find, File::Path,
2663 File::Spec, File::Spec::Cygwin, File::Spec::Epoc, File::Spec::Functions,
2664 File::Spec::Mac, File::Spec::OS2, File::Spec::Unix, File::Spec::VMS,
2665 File::Spec::Win32, File::Temp, File::stat, FileCache, FileHandle,
2666 Filter::Simple, FindBin, Getopt::Long, Getopt::Std, Hash::Util,
2667 I18N::Collate, I18N::LangTags, I18N::LangTags::List, IO, IPC::Open2,
2668 IPC::Open3, Locale::Constants, Locale::Country, Locale::Currency,
2669 Locale::Language, Locale::Maketext, Locale::Maketext::TPJ13,
2670 Locale::Script, Math::BigFloat, Math::BigInt, Math::BigInt::Calc,
2671 Math::BigRat, Math::Complex, Math::Trig, Memoize, Memoize::AnyDBM_File,
2672 Memoize::Expire, Memoize::ExpireFile, Memoize::ExpireTest,
2673 Memoize::NDBM_File, Memoize::SDBM_File, Memoize::Storable, NDBM_File, NEXT,
2674 Net::Cmd, Net::Config, Net::Domain, Net::FTP, Net::NNTP, Net::Netrc,
2675 Net::POP3, Net::Ping, Net::SMTP, Net::Time, Net::hostent, Net::libnetFAQ,
2676 Net::netent, Net::protoent, Net::servent, O, ODBM_File, Opcode, POSIX,
2677 PerlIO, PerlIO::via::QuotedPrint, Pod::Checker, Pod::Find, Pod::Functions,
2678 Pod::Html, Pod::InputObjects, Pod::LaTeX, Pod::Man, Pod::ParseLink,
2679 Pod::ParseUtils, Pod::Parser, Pod::Plainer, Pod::Select, Pod::Text,
2680 Pod::Text::Color, Pod::Text::Overstrike, Pod::Text::Termcap, Pod::Usage,
2681 SDBM_File, Safe, Search::Dict, SelectSaver, SelfLoader, Shell, Socket,
2682 Storable, Switch, Symbol, Term::ANSIColor, Term::Cap, Term::Complete,
2683 Term::ReadLine, Test, Test::Builder, Test::Harness, Test::Harness::Assert,
2684 Test::Harness::Iterator, Test::Harness::Straps, Test::More, Test::Simple,
2685 Test::Tutorial, Text::Abbrev, Text::Balanced, Text::ParseWords,
2686 Text::Soundex, Text::Tabs, Text::Wrap, Thread, Thread::Queue,
2687 Thread::Semaphore, Tie::Array, Tie::File, Tie::Handle, Tie::Hash,
2688 Tie::Memoize, Tie::RefHash, Tie::Scalar, Tie::SubstrHash, Time::Local,
2689 Time::gmtime, Time::localtime, Time::tm, UNIVERSAL, Unicode::Collate,
2690 Unicode::UCD, User::grent, User::pwent, Win32
2691
2692 =item Extension Modules
2693
2694 =back
2695
2696 =item CPAN
2697
2698 =over 4
2699
2700 =item Africa
2701
2702 South Africa
2703
2704 =item Asia
2705
2706 China, India, Indonesia, Israel, Japan, Korea, Philippines, Russian
2707 Federation, Saudi Arabia, Singapore, South Korea, Taiwan, Thailand
2708
2709 =item Central America
2710
2711 Costa Rica
2712
2713 =item Europe
2714
2715 Austria, Belgium, Bulgaria, Croatia, Czech Republic, Denmark, Estonia,
2716 Finland, France, Germany, Greece, Hungary, Iceland, Ireland, Italy, Latvia,
2717 Lithuania, Netherlands, Norway, Poland, Portugal, Romania, Russia,
2718 Slovakia, Slovenia, Spain, Sweden, Switzerland, Turkey, Ukraine, United
2719 Kingdom
2720
2721 =item North America
2722
2723 Alberta, Manitoba, Nova Scotia, Ontario, Quebec, Mexico
2724
2725 =item United States
2726
2727 Alabama, California, Colorado, Delaware, District of Columbia, Florida,
2728 Illinois, Indiana, Kentucky, Massachusetts, Michigan, New Jersey, New York,
2729 North Carolina, Ohio, Oklahoma, Oregon, Pennsylvania, Tennessee, Texas,
2730 Utah, Virginia, ashington, Wisconsin
2731
2732 =item Oceania
2733
2734 Australia, New Zealand
2735
2736 =item South America
2737
2738 Argentina, Brazil, Chile
2739
2740 =item RSYNC Mirrors
2741
2742 =back
2743
2744 =item Modules: Creation, Use, and Abuse
2745
2746 =over 4
2747
2748 =item Guidelines for Module Creation
2749
2750 =item Guidelines for Converting Perl 4 Library Scripts into Modules
2751
2752 =item Guidelines for Reusing Application Code
2753
2754 =back
2755
2756 =item NOTE
2757
2758 =back
2759
2760 =head2 perlmodstyle - Perl module style guide
2761
2762 =over 4
2763
2764 =item INTRODUCTION
2765
2766 =item QUICK CHECKLIST
2767
2768 =over 4
2769
2770 =item Before you start
2771
2772 =item The API
2773
2774 =item Stability
2775
2776 =item Documentation
2777
2778 =item Release considerations
2779
2780 =back
2781
2782 =item BEFORE YOU START WRITING A MODULE
2783
2784 =over 4
2785
2786 =item Has it been done before?
2787
2788 =item Do one thing and do it well
2789
2790 =item What's in a name?
2791
2792 =back
2793
2794 =item DESIGNING AND WRITING YOUR MODULE
2795
2796 =over 4
2797
2798 =item To OO or not to OO?
2799
2800 =item Designing your API
2801
2802 Write simple routines to do simple things, Separate functionality from
2803 output, Provide sensible shortcuts and defaults, Naming conventions,
2804 Parameter passing
2805
2806 =item Strictness and warnings
2807
2808 =item Backwards compatibility
2809
2810 =item Error handling and messages
2811
2812 =back
2813
2814 =item DOCUMENTING YOUR MODULE
2815
2816 =over 4
2817
2818 =item POD
2819
2820 =item README, INSTALL, release notes, changelogs
2821
2822 =back
2823
2824 =item RELEASE CONSIDERATIONS
2825
2826 =over 4
2827
2828 =item Version numbering
2829
2830 =item Pre-requisites
2831
2832 =item Testing
2833
2834 =item Packaging
2835
2836 =item Licensing
2837
2838 =back
2839
2840 =item COMMON PITFALLS
2841
2842 =over 4
2843
2844 =item Reinventing the wheel
2845
2846 =item Trying to do too much
2847
2848 =item Inappropriate documentation
2849
2850 =back
2851
2852 =item SEE ALSO
2853
2854 L<perlstyle>, L<perlnewmod>, L<perlpod>, L<podchecker>, Testing tools,
2855 http://pause.perl.org/, Any good book on software engineering
2856
2857 =item AUTHOR
2858
2859 =back
2860
2861 =head2 perlnewmod - preparing a new module for distribution
2862
2863 =over 4
2864
2865 =item DESCRIPTION
2866
2867 =over 4
2868
2869 =item Warning
2870
2871 =item What should I make into a module?
2872
2873 =item Step-by-step: Preparing the ground
2874
2875 Look around, Check it's new, Discuss the need, Choose a name, Check again
2876
2877 =item Step-by-step: Making the module
2878
2879 Start with F<h2xs>, Use L<strict|strict> and L<warnings|warnings>, Use
2880 L<Carp|Carp>, Use L<Exporter|Exporter> - wisely!, Use L<plain old
2881 documentation|perlpod>, Write tests, Write the README
2882
2883 =item Step-by-step: Distributing your module
2884
2885 Get a CPAN user ID, C<perl Makefile.PL; make test; make dist>, Upload the
2886 tarball, Announce to the modules list, Announce to clpa, Fix bugs!
2887
2888 =back
2889
2890 =item AUTHOR
2891
2892 =item SEE ALSO
2893
2894 =back
2895
2896 =head2 perlfaq1 - General Questions About Perl ($Revision: 1.8 $, $Date:
2897 2002/04/07 18:46:13 $)
2898
2899 =over 4
2900
2901 =item DESCRIPTION
2902
2903 =over 4
2904
2905 =item What is Perl?
2906
2907 =item Who supports Perl?  Who develops it?  Why is it free?
2908
2909 =item Which version of Perl should I use?
2910
2911 =item What are perl4 and perl5?
2912
2913 =item What is perl6?
2914
2915 =item How stable is Perl?
2916
2917 =item Is Perl difficult to learn?
2918
2919 =item How does Perl compare with other languages like Java, Python, REXX,
2920 Scheme, or Tcl?
2921
2922 =item Can I do [task] in Perl?
2923
2924 =item When shouldn't I program in Perl?
2925
2926 =item What's the difference between "perl" and "Perl"?
2927
2928 =item Is it a Perl program or a Perl script?
2929
2930 =item What is a JAPH?
2931
2932 =item Where can I get a list of Larry Wall witticisms?
2933
2934 =item How can I convince my sysadmin/supervisor/employees to use version
2935 5/5.6.1/Perl instead of some other language?
2936
2937 =back
2938
2939 =item AUTHOR AND COPYRIGHT
2940
2941 =back
2942
2943 =head2 perlfaq2 - Obtaining and Learning about Perl ($Revision: 1.13 $,
2944 $Date: 2002/04/26 16:56:35 $)
2945
2946 =over 4
2947
2948 =item DESCRIPTION
2949
2950 =over 4
2951
2952 =item What machines support Perl?  Where do I get it?
2953
2954 =item How can I get a binary version of Perl?
2955
2956 =item I don't have a C compiler on my system.  How can I compile perl?
2957
2958 =item I copied the Perl binary from one machine to another, but scripts
2959 don't work.
2960
2961 =item I grabbed the sources and tried to compile but gdbm/dynamic
2962 loading/malloc/linking/... failed.  How do I make it work?
2963
2964 =item What modules and extensions are available for Perl?  What is CPAN?
2965 What does CPAN/src/... mean?
2966
2967 =item Is there an ISO or ANSI certified version of Perl?
2968
2969 =item Where can I get information on Perl?
2970
2971 =item What are the Perl newsgroups on Usenet?  Where do I post questions?
2972
2973 =item Where should I post source code?
2974
2975 =item Perl Books
2976
2977 References, Tutorials, Task-Oriented, Special Topics
2978
2979 =item Perl in Magazines
2980
2981 =item Perl on the Net: FTP and WWW Access
2982
2983 =item What mailing lists are there for Perl?
2984
2985 =item Archives of comp.lang.perl.misc
2986
2987 =item Where can I buy a commercial version of Perl?
2988
2989 =item Where do I send bug reports?
2990
2991 =item What is perl.com? Perl Mongers? pm.org? perl.org? cpan.org?
2992
2993 =back
2994
2995 =item AUTHOR AND COPYRIGHT
2996
2997 =back
2998
2999 =head2 perlfaq3 - Programming Tools ($Revision: 1.22 $, $Date: 2002/05/06
3000 13:11:13 $)
3001
3002 =over 4
3003
3004 =item DESCRIPTION
3005
3006 =over 4
3007
3008 =item How do I do (anything)?
3009
3010 =item How can I use Perl interactively?
3011
3012 =item Is there a Perl shell?
3013
3014 =item How do I debug my Perl programs?
3015
3016 =item How do I profile my Perl programs?
3017
3018 =item How do I cross-reference my Perl programs?
3019
3020 =item Is there a pretty-printer (formatter) for Perl?
3021
3022 =item Is there a ctags for Perl?
3023
3024 =item Is there an IDE or Windows Perl Editor?
3025
3026 Komodo, The Object System, Open Perl IDE, PerlBuilder, visiPerl+, OptiPerl,
3027 CodeMagicCD, GNU Emacs, MicroEMACS, XEmacs, Elvis, Vile, Vim, Codewright,
3028 MultiEdit, SlickEdit, Bash, Ksh, Tcsh, Zsh, BBEdit and BBEdit Lite, Alpha
3029
3030 =item Where can I get Perl macros for vi?
3031
3032 =item Where can I get perl-mode for emacs?
3033
3034 =item How can I use curses with Perl?
3035
3036 =item How can I use X or Tk with Perl?
3037
3038 =item How can I generate simple menus without using CGI or Tk?
3039
3040 =item How can I make my Perl program run faster?
3041
3042 =item How can I make my Perl program take less memory?
3043
3044 Don't slurp!, Use map and grep selectively, Avoid unnecessary quotes and
3045 stringification, Pass by reference, Tie large variables to disk
3046
3047 =item Is it unsafe to return a pointer to local data?
3048
3049 =item How can I free an array or hash so my program shrinks?
3050
3051 =item How can I make my CGI script more efficient?
3052
3053 =item How can I hide the source for my Perl program?
3054
3055 =item How can I compile my Perl program into byte code or C?
3056
3057 =item How can I compile Perl into Java?
3058
3059 =item How can I get C<#!perl> to work on [MS-DOS,NT,...]?
3060
3061 =item Can I write useful Perl programs on the command line?
3062
3063 =item Why don't Perl one-liners work on my DOS/Mac/VMS system?
3064
3065 =item Where can I learn about CGI or Web programming in Perl?
3066
3067 =item Where can I learn about object-oriented Perl programming?
3068
3069 =item Where can I learn about linking C with Perl? [h2xs, xsubpp]
3070
3071 =item I've read perlembed, perlguts, etc., but I can't embed perl in
3072 my C program; what am I doing wrong?
3073
3074 =item When I tried to run my script, I got this message. What does it mean?
3075
3076 =item What's MakeMaker?
3077
3078 =back
3079
3080 =item AUTHOR AND COPYRIGHT
3081
3082 =back
3083
3084 =head2 perlfaq4 - Data Manipulation ($Revision: 1.25 $, $Date: 2002/05/30
3085 07:04:25 $)
3086
3087 =over 4
3088
3089 =item DESCRIPTION
3090
3091 =item Data: Numbers
3092
3093 =over 4
3094
3095 =item Why am I getting long decimals (eg, 19.9499999999999) instead of the
3096 numbers I should be getting (eg, 19.95)?
3097
3098 =item Why isn't my octal data interpreted correctly?
3099
3100 =item Does Perl have a round() function?  What about ceil() and floor()?
3101 Trig functions?
3102
3103 =item How do I convert between numeric representations?
3104
3105 How do I convert hexadecimal into decimal, How do I convert from decimal to
3106 hexadecimal, How do I convert from octal to decimal, How do I convert from
3107 decimal to octal, How do I convert from binary to decimal, How do I convert
3108 from decimal to binary
3109
3110 =item Why doesn't & work the way I want it to?
3111
3112 =item How do I multiply matrices?
3113
3114 =item How do I perform an operation on a series of integers?
3115
3116 =item How can I output Roman numerals?
3117
3118 =item Why aren't my random numbers random?
3119
3120 =item How do I get a random number between X and Y?
3121
3122 =back
3123
3124 =item Data: Dates
3125
3126 =over 4
3127
3128 =item How do I find the week-of-the-year/day-of-the-year?
3129
3130 =item How do I find the current century or millennium?
3131
3132 =item How can I compare two dates and find the difference?
3133
3134 =item How can I take a string and turn it into epoch seconds?
3135
3136 =item How can I find the Julian Day?
3137
3138 =item How do I find yesterday's date?
3139
3140 =item Does Perl have a Year 2000 problem?  Is Perl Y2K compliant?
3141
3142 =back
3143
3144 =item Data: Strings
3145
3146 =over 4
3147
3148 =item How do I validate input?
3149
3150 =item How do I unescape a string?
3151
3152 =item How do I remove consecutive pairs of characters?
3153
3154 =item How do I expand function calls in a string?
3155
3156 =item How do I find matching/nesting anything?
3157
3158 =item How do I reverse a string?
3159
3160 =item How do I expand tabs in a string?
3161
3162 =item How do I reformat a paragraph?
3163
3164 =item How can I access/change the first N letters of a string?
3165
3166 =item How do I change the Nth occurrence of something?
3167
3168 =item How can I count the number of occurrences of a substring within a
3169 string?
3170
3171 =item How do I capitalize all the words on one line?
3172
3173 =item How can I split a [character] delimited string except when inside
3174 [character]? (Comma-separated files)
3175
3176 =item How do I strip blank space from the beginning/end of a string?
3177
3178 =item How do I pad a string with blanks or pad a number with zeroes?
3179
3180 =item How do I extract selected columns from a string?
3181
3182 =item How do I find the soundex value of a string?
3183
3184 =item How can I expand variables in text strings?
3185
3186 =item What's wrong with always quoting "$vars"?
3187
3188 =item Why don't my <<HERE documents work?
3189
3190 1. There must be no space after the << part, 2. There (probably) should be
3191 a semicolon at the end, 3. You can't (easily) have any space in front of
3192 the tag
3193
3194 =back
3195
3196 =item Data: Arrays
3197
3198 =over 4
3199
3200 =item What is the difference between a list and an array?
3201
3202 =item What is the difference between $array[1] and @array[1]?
3203
3204 =item How can I remove duplicate elements from a list or array?
3205
3206 a), b), c), d), e)
3207
3208 =item How can I tell whether a certain element is contained in a list or
3209 array?
3210
3211 =item How do I compute the difference of two arrays?  How do I compute the
3212 intersection of two arrays?
3213
3214 =item How do I test whether two arrays or hashes are equal?
3215
3216 =item How do I find the first array element for which a condition is true?
3217
3218 =item How do I handle linked lists?
3219
3220 =item How do I handle circular lists?
3221
3222 =item How do I shuffle an array randomly?
3223
3224 =item How do I process/modify each element of an array?
3225
3226 =item How do I select a random element from an array?
3227
3228 =item How do I permute N elements of a list?
3229
3230 =item How do I sort an array by (anything)?
3231
3232 =item How do I manipulate arrays of bits?
3233
3234 =item Why does defined() return true on empty arrays and hashes?
3235
3236 =back
3237
3238 =item Data: Hashes (Associative Arrays)
3239
3240 =over 4
3241
3242 =item How do I process an entire hash?
3243
3244 =item What happens if I add or remove keys from a hash while iterating over
3245 it?
3246
3247 =item How do I look up a hash element by value?
3248
3249 =item How can I know how many entries are in a hash?
3250
3251 =item How do I sort a hash (optionally by value instead of key)?
3252
3253 =item How can I always keep my hash sorted?
3254
3255 =item What's the difference between "delete" and "undef" with hashes?
3256
3257 =item Why don't my tied hashes make the defined/exists distinction?
3258
3259 =item How do I reset an each() operation part-way through?
3260
3261 =item How can I get the unique keys from two hashes?
3262
3263 =item How can I store a multidimensional array in a DBM file?
3264
3265 =item How can I make my hash remember the order I put elements into it?
3266
3267 =item Why does passing a subroutine an undefined element in a hash create
3268 it?
3269
3270 =item How can I make the Perl equivalent of a C structure/C++ class/hash or
3271 array of hashes or arrays?
3272
3273 =item How can I use a reference as a hash key?
3274
3275 =back
3276
3277 =item Data: Misc
3278
3279 =over 4
3280
3281 =item How do I handle binary data correctly?
3282
3283 =item How do I determine whether a scalar is a number/whole/integer/float?
3284
3285 =item How do I keep persistent data across program calls?
3286
3287 =item How do I print out or copy a recursive data structure?
3288
3289 =item How do I define methods for every class/object?
3290
3291 =item How do I verify a credit card checksum?
3292
3293 =item How do I pack arrays of doubles or floats for XS code?
3294
3295 =back
3296
3297 =item AUTHOR AND COPYRIGHT
3298
3299 =back
3300
3301 =head2 perlfaq5 - Files and Formats ($Revision: 1.18 $, $Date: 2002/05/30
3302 07:04:25 $)
3303
3304 =over 4
3305
3306 =item DESCRIPTION
3307
3308 =over 4
3309
3310 =item How do I flush/unbuffer an output filehandle?  Why must I do this?
3311
3312 =item How do I change one line in a file/delete a line in a file/insert a
3313 line in the middle of a file/append to the beginning of a file?
3314
3315 =item How do I count the number of lines in a file?
3316
3317 =item How do I make a temporary file name?
3318
3319 =item How can I manipulate fixed-record-length files?
3320
3321 =item How can I make a filehandle local to a subroutine?  How do I pass
3322 filehandles between subroutines?  How do I make an array of filehandles?
3323
3324 =item How can I use a filehandle indirectly?
3325
3326 =item How can I set up a footer format to be used with write()?
3327
3328 =item How can I write() into a string?
3329
3330 =item How can I output my numbers with commas added?
3331
3332 =item How can I translate tildes (~) in a filename?
3333
3334 =item How come when I open a file read-write it wipes it out?
3335
3336 =item Why do I sometimes get an "Argument list too long" when I use <*>?
3337
3338 =item Is there a leak/bug in glob()?
3339
3340 =item How can I open a file with a leading ">" or trailing blanks?
3341
3342 =item How can I reliably rename a file?
3343
3344 =item How can I lock a file?
3345
3346 =item Why can't I just open(FH, ">file.lock")?
3347
3348 =item I still don't get locking.  I just want to increment the number in
3349 the file.  How can I do this?
3350
3351 =item All I want to do is append a small amount of text to the end of a
3352 file.  Do I still have to use locking?
3353
3354 =item How do I randomly update a binary file?
3355
3356 =item How do I get a file's timestamp in perl?
3357
3358 =item How do I set a file's timestamp in perl?
3359
3360 =item How do I print to more than one file at once?
3361
3362 =item How can I read in an entire file all at once?
3363
3364 =item How can I read in a file by paragraphs?
3365
3366 =item How can I read a single character from a file?  From the keyboard?
3367
3368 =item How can I tell whether there's a character waiting on a filehandle?
3369
3370 =item How do I do a C<tail -f> in perl?
3371
3372 =item How do I dup() a filehandle in Perl?
3373
3374 =item How do I close a file descriptor by number?
3375
3376 =item Why can't I use "C:\temp\foo" in DOS paths?  Why doesn't
3377 `C:\temp\foo.exe` work?
3378
3379 =item Why doesn't glob("*.*") get all the files?
3380
3381 =item Why does Perl let me delete read-only files?  Why does C<-i> clobber
3382 protected files?  Isn't this a bug in Perl?
3383
3384 =item How do I select a random line from a file?
3385
3386 =item Why do I get weird spaces when I print an array of lines?
3387
3388 =back
3389
3390 =item AUTHOR AND COPYRIGHT
3391
3392 =back
3393
3394 =head2 perlfaq6 - Regular Expressions ($Revision: 1.12 $, $Date: 2002/06/01
3395 22:31:09 $)
3396
3397 =over 4
3398
3399 =item DESCRIPTION
3400
3401 =over 4
3402
3403 =item How can I hope to use regular expressions without creating illegible
3404 and unmaintainable code?
3405
3406 Comments Outside the Regex, Comments Inside the Regex, Different Delimiters
3407
3408 =item I'm having trouble matching over more than one line.  What's wrong?
3409
3410 =item How can I pull out lines between two patterns that are themselves on
3411 different lines?
3412
3413 =item I put a regular expression into $/ but it didn't work. What's wrong?
3414
3415 =item How do I substitute case insensitively on the LHS while preserving
3416 case on the RHS?
3417
3418 =item How can I make C<\w> match national character sets?
3419
3420 =item How can I match a locale-smart version of C</[a-zA-Z]/>?
3421
3422 =item How can I quote a variable to use in a regex?
3423
3424 =item What is C</o> really for?
3425
3426 =item How do I use a regular expression to strip C style comments from a
3427 file?
3428
3429 =item Can I use Perl regular expressions to match balanced text?
3430
3431 =item What does it mean that regexes are greedy?  How can I get around it?
3432
3433 =item How do I process each word on each line?
3434
3435 =item How can I print out a word-frequency or line-frequency summary?
3436
3437 =item How can I do approximate matching?
3438
3439 =item How do I efficiently match many regular expressions at once?
3440
3441 =item Why don't word-boundary searches with C<\b> work for me?
3442
3443 =item Why does using $&, $`, or $' slow my program down?
3444
3445 =item What good is C<\G> in a regular expression?
3446
3447 =item Are Perl regexes DFAs or NFAs?  Are they POSIX compliant?
3448
3449 =item What's wrong with using grep or map in a void context?
3450
3451 =item How can I match strings with multibyte characters?
3452
3453 =item How do I match a pattern that is supplied by the user?
3454
3455 =back
3456
3457 =item AUTHOR AND COPYRIGHT
3458
3459 =back
3460
3461 =head2 perlfaq7 - General Perl Language Issues ($Revision: 1.8 $, $Date:
3462 2002/03/26 15:48:32 $)
3463
3464 =over 4
3465
3466 =item DESCRIPTION
3467
3468 =over 4
3469
3470 =item Can I get a BNF/yacc/RE for the Perl language?
3471
3472 =item What are all these $@%&* punctuation signs, and how do I know when to
3473 use them?
3474
3475 =item Do I always/never have to quote my strings or use semicolons and
3476 commas?
3477
3478 =item How do I skip some return values?
3479
3480 =item How do I temporarily block warnings?
3481
3482 =item What's an extension?
3483
3484 =item Why do Perl operators have different precedence than C operators?
3485
3486 =item How do I declare/create a structure?
3487
3488 =item How do I create a module?
3489
3490 =item How do I create a class?
3491
3492 =item How can I tell if a variable is tainted?
3493
3494 =item What's a closure?
3495
3496 =item What is variable suicide and how can I prevent it?
3497
3498 =item How can I pass/return a {Function, FileHandle, Array, Hash, Method,
3499 Regex}?
3500
3501 Passing Variables and Functions, Passing Filehandles, Passing Regexes,
3502 Passing Methods
3503
3504 =item How do I create a static variable?
3505
3506 =item What's the difference between dynamic and lexical (static) scoping?
3507 Between local() and my()?
3508
3509 =item How can I access a dynamic variable while a similarly named lexical
3510 is in scope?
3511
3512 =item What's the difference between deep and shallow binding?
3513
3514 =item Why doesn't "my($foo) = <FILE>;" work right?
3515
3516 =item How do I redefine a builtin function, operator, or method?
3517
3518 =item What's the difference between calling a function as &foo and foo()?
3519
3520 =item How do I create a switch or case statement?
3521
3522 =item How can I catch accesses to undefined variables/functions/methods?
3523
3524 =item Why can't a method included in this same file be found?
3525
3526 =item How can I find out my current package?
3527
3528 =item How can I comment out a large block of perl code?
3529
3530 =item How do I clear a package?
3531
3532 =item How can I use a variable as a variable name?
3533
3534 =back
3535
3536 =item AUTHOR AND COPYRIGHT
3537
3538 =back
3539
3540 =head2 perlfaq8 - System Interaction ($Revision: 1.8 $, $Date: 2002/05/16
3541 12:41:42 $)
3542
3543 =over 4
3544
3545 =item DESCRIPTION
3546
3547 =over 4
3548
3549 =item How do I find out which operating system I'm running under?
3550
3551 =item How come exec() doesn't return?
3552
3553 =item How do I do fancy stuff with the keyboard/screen/mouse?
3554
3555 Keyboard, Screen, Mouse
3556
3557 =item How do I print something out in color?
3558
3559 =item How do I read just one key without waiting for a return key?
3560
3561 =item How do I check whether input is ready on the keyboard?
3562
3563 =item How do I clear the screen?
3564
3565 =item How do I get the screen size?
3566
3567 =item How do I ask the user for a password?
3568
3569 =item How do I read and write the serial port?
3570
3571 lockfiles, open mode, end of line, flushing output, non-blocking input
3572
3573 =item How do I decode encrypted password files?
3574
3575 =item How do I start a process in the background?
3576
3577 STDIN, STDOUT, and STDERR are shared, Signals, Zombies
3578
3579 =item How do I trap control characters/signals?
3580
3581 =item How do I modify the shadow password file on a Unix system?
3582
3583 =item How do I set the time and date?
3584
3585 =item How can I sleep() or alarm() for under a second?
3586
3587 =item How can I measure time under a second?
3588
3589 =item How can I do an atexit() or setjmp()/longjmp()? (Exception handling)
3590
3591 =item Why doesn't my sockets program work under System V (Solaris)?  What
3592 does the error message "Protocol not supported" mean?
3593
3594 =item How can I call my system's unique C functions from Perl?
3595
3596 =item Where do I get the include files to do ioctl() or syscall()?
3597
3598 =item Why do setuid perl scripts complain about kernel problems?
3599
3600 =item How can I open a pipe both to and from a command?
3601
3602 =item Why can't I get the output of a command with system()?
3603
3604 =item How can I capture STDERR from an external command?
3605
3606 =item Why doesn't open() return an error when a pipe open fails?
3607
3608 =item What's wrong with using backticks in a void context?
3609
3610 =item How can I call backticks without shell processing?
3611
3612 =item Why can't my script read from STDIN after I gave it EOF (^D on Unix,
3613 ^Z on MS-DOS)?
3614
3615 =item How can I convert my shell script to perl?
3616
3617 =item Can I use perl to run a telnet or ftp session?
3618
3619 =item How can I write expect in Perl?
3620
3621 =item Is there a way to hide perl's command line from programs such as
3622 "ps"?
3623
3624 =item I {changed directory, modified my environment} in a perl script.  How
3625 come the change disappeared when I exited the script?  How do I get my
3626 changes to be visible?
3627
3628 Unix
3629
3630 =item How do I close a process's filehandle without waiting for it to
3631 complete?
3632
3633 =item How do I fork a daemon process?
3634
3635 =item How do I find out if I'm running interactively or not?
3636
3637 =item How do I timeout a slow event?
3638
3639 =item How do I set CPU limits?
3640
3641 =item How do I avoid zombies on a Unix system?
3642
3643 =item How do I use an SQL database?
3644
3645 =item How do I make a system() exit on control-C?
3646
3647 =item How do I open a file without blocking?
3648
3649 =item How do I install a module from CPAN?
3650
3651 =item What's the difference between require and use?
3652
3653 =item How do I keep my own module/library directory?
3654
3655 =item How do I add the directory my program lives in to the module/library
3656 search path?
3657
3658 =item How do I add a directory to my include path at runtime?
3659
3660 =item What is socket.ph and where do I get it?
3661
3662 =back
3663
3664 =item AUTHOR AND COPYRIGHT
3665
3666 =back
3667
3668 =head2 perlfaq9 - Networking ($Revision: 1.9 $, $Date: 2002/04/07 18:46:13
3669 $)
3670
3671 =over 4
3672
3673 =item DESCRIPTION
3674
3675 =over 4
3676
3677 =item What is the correct form of response from a CGI script?
3678
3679 =item My CGI script runs from the command line but not the browser.  (500
3680 Server Error)
3681
3682 =item How can I get better error messages from a CGI program?
3683
3684 =item How do I remove HTML from a string?
3685
3686 =item How do I extract URLs?
3687
3688 =item How do I download a file from the user's machine?  How do I open a
3689 file on another machine?
3690
3691 =item How do I make a pop-up menu in HTML?
3692
3693 =item How do I fetch an HTML file?
3694
3695 =item How do I automate an HTML form submission?
3696
3697 =item How do I decode or create those %-encodings on the web?
3698
3699 =item How do I redirect to another page?
3700
3701 =item How do I put a password on my web pages?
3702
3703 =item How do I edit my .htpasswd and .htgroup files with Perl?
3704
3705 =item How do I make sure users can't enter values into a form that cause my
3706 CGI script to do bad things?
3707
3708 =item How do I parse a mail header?
3709
3710 =item How do I decode a CGI form?
3711
3712 =item How do I check a valid mail address?
3713
3714 =item How do I decode a MIME/BASE64 string?
3715
3716 =item How do I return the user's mail address?
3717
3718 =item How do I send mail?
3719
3720 =item How do I use MIME to make an attachment to a mail message?
3721
3722 =item How do I read mail?
3723
3724 =item How do I find out my hostname/domainname/IP address?
3725
3726 =item How do I fetch a news article or the active newsgroups?
3727
3728 =item How do I fetch/put an FTP file?
3729
3730 =item How can I do RPC in Perl?
3731
3732 =back
3733
3734 =item AUTHOR AND COPYRIGHT
3735
3736 =back
3737
3738 =head2 perlcompile - Introduction to the Perl Compiler-Translator
3739
3740 =over 4
3741
3742 =item DESCRIPTION
3743
3744 =over 4
3745
3746 =item Layout
3747
3748 B::Bytecode, B::C, B::CC, B::Lint, B::Deparse, B::Xref
3749
3750 =back
3751
3752 =item Using The Back Ends
3753
3754 =over 4
3755
3756 =item The Cross Referencing Back End
3757
3758 i, &, s, r
3759
3760 =item The Decompiling Back End
3761
3762 =item The Lint Back End
3763
3764 =item The Simple C Back End
3765
3766 =item The Bytecode Back End
3767
3768 =item The Optimized C Back End
3769
3770 =back
3771
3772 =item Module List for the Compiler Suite
3773
3774 B, O, B::Asmdata, B::Assembler, B::Bblock, B::Bytecode, B::C, B::CC,
3775 B::Concise, B::Debug, B::Deparse, B::Disassembler, B::Lint, B::Showlex,
3776 B::Stackobj, B::Stash, B::Terse, B::Xref
3777
3778 =item KNOWN PROBLEMS
3779
3780 =item AUTHOR
3781
3782 =back
3783
3784 =head2 perlembed - how to embed perl in your C program
3785
3786 =over 4
3787
3788 =item DESCRIPTION
3789
3790 =over 4
3791
3792 =item PREAMBLE
3793
3794 B<Use C from Perl?>, B<Use a Unix program from Perl?>, B<Use Perl from
3795 Perl?>, B<Use C from C?>, B<Use Perl from C?>
3796
3797 =item ROADMAP
3798
3799 =item Compiling your C program
3800
3801 =item Adding a Perl interpreter to your C program
3802
3803 =item Calling a Perl subroutine from your C program
3804
3805 =item Evaluating a Perl statement from your C program
3806
3807 =item Performing Perl pattern matches and substitutions from your C program
3808
3809 =item Fiddling with the Perl stack from your C program
3810
3811 =item Maintaining a persistent interpreter
3812
3813 =item Execution of END blocks
3814
3815 =item Maintaining multiple interpreter instances
3816
3817 =item Using Perl modules, which themselves use C libraries, from your C
3818 program
3819
3820 =back
3821
3822 =item Embedding Perl under Win32
3823
3824 =item MORAL
3825
3826 =item AUTHOR
3827
3828 =item COPYRIGHT
3829
3830 =back
3831
3832 =head2 perldebguts - Guts of Perl debugging
3833
3834 =over 4
3835
3836 =item DESCRIPTION
3837
3838 =item Debugger Internals
3839
3840 =over 4
3841
3842 =item Writing Your Own Debugger
3843
3844 =back
3845
3846 =item Frame Listing Output Examples
3847
3848 =item Debugging regular expressions
3849
3850 =over 4
3851
3852 =item Compile-time output
3853
3854 C<anchored> I<STRING> C<at> I<POS>, C<floating> I<STRING> C<at>
3855 I<POS1..POS2>, C<matching floating/anchored>, C<minlen>, C<stclass>
3856 I<TYPE>, C<noscan>, C<isall>, C<GPOS>, C<plus>, C<implicit>, C<with eval>,
3857 C<anchored(TYPE)>
3858
3859 =item Types of nodes
3860
3861 =item Run-time output
3862
3863 =back
3864
3865 =item Debugging Perl memory usage
3866
3867 =over 4
3868
3869 =item Using C<$ENV{PERL_DEBUG_MSTATS}>
3870
3871 C<buckets SMALLEST(APPROX)..GREATEST(APPROX)>, Free/Used, C<Total sbrk():
3872 SBRKed/SBRKs:CONTINUOUS>, C<pad: 0>, C<heads: 2192>, C<chain: 0>, C<tail:
3873 6144>
3874
3875 =item Example of using B<-DL> switch
3876
3877 C<717>, C<002>, C<054>, C<602>, C<702>, C<704>
3878
3879 =item B<-DL> details
3880
3881 C<!!!>, C<!!>, C<!>
3882
3883 =item Limitations of B<-DL> statistics
3884
3885 =back
3886
3887 =item SEE ALSO
3888
3889 =back
3890
3891 =head2 perlxstut, perlXStut - Tutorial for writing XSUBs
3892
3893 =over 4
3894
3895 =item DESCRIPTION
3896
3897 =item SPECIAL NOTES
3898
3899 =over 4
3900
3901 =item make
3902
3903 =item Version caveat
3904
3905 =item Dynamic Loading versus Static Loading
3906
3907 =back
3908
3909 =item TUTORIAL
3910
3911 =over 4
3912
3913 =item EXAMPLE 1
3914
3915 =item EXAMPLE 2
3916
3917 =item What has gone on?
3918
3919 =item Writing good test scripts
3920
3921 =item EXAMPLE 3
3922
3923 =item What's new here?
3924
3925 =item Input and Output Parameters
3926
3927 =item The XSUBPP Program
3928
3929 =item The TYPEMAP file
3930
3931 =item Warning about Output Arguments
3932
3933 =item EXAMPLE 4
3934
3935 =item What has happened here?
3936
3937 =item Anatomy of .xs file
3938
3939 =item Getting the fat out of XSUBs
3940
3941 =item More about XSUB arguments
3942
3943 =item The Argument Stack
3944
3945 =item Extending your Extension
3946
3947 =item Documenting your Extension
3948
3949 =item Installing your Extension
3950
3951 =item EXAMPLE 5
3952
3953 =item New Things in this Example
3954
3955 =item EXAMPLE 6
3956
3957 =item New Things in this Example
3958
3959 =item EXAMPLE 7 (Coming Soon)
3960
3961 =item EXAMPLE 8 (Coming Soon)
3962
3963 =item EXAMPLE 9 Passing open files to XSes
3964
3965 =item Troubleshooting these Examples
3966
3967 =back
3968
3969 =item See also
3970
3971 =item Author
3972
3973 =over 4
3974
3975 =item Last Changed
3976
3977 =back
3978
3979 =back
3980
3981 =head2 perlxs - XS language reference manual
3982
3983 =over 4
3984
3985 =item DESCRIPTION
3986
3987 =over 4
3988
3989 =item Introduction
3990
3991 =item On The Road
3992
3993 =item The Anatomy of an XSUB
3994
3995 =item The Argument Stack
3996
3997 =item The RETVAL Variable
3998
3999 =item The MODULE Keyword
4000
4001 =item The PACKAGE Keyword
4002
4003 =item The PREFIX Keyword
4004
4005 =item The OUTPUT: Keyword
4006
4007 =item The NO_OUTPUT Keyword
4008
4009 =item The CODE: Keyword
4010
4011 =item The INIT: Keyword
4012
4013 =item The NO_INIT Keyword
4014
4015 =item Initializing Function Parameters
4016
4017 =item Default Parameter Values
4018
4019 =item The PREINIT: Keyword
4020
4021 =item The SCOPE: Keyword
4022
4023 =item The INPUT: Keyword
4024
4025 =item The IN/OUTLIST/IN_OUTLIST/OUT/IN_OUT Keywords
4026
4027 =item The C<length(NAME)> Keyword
4028
4029 =item Variable-length Parameter Lists
4030
4031 =item The C_ARGS: Keyword
4032
4033 =item The PPCODE: Keyword
4034
4035 =item Returning Undef And Empty Lists
4036
4037 =item The REQUIRE: Keyword
4038
4039 =item The CLEANUP: Keyword
4040
4041 =item The POSTCALL: Keyword
4042
4043 =item The BOOT: Keyword
4044
4045 =item The VERSIONCHECK: Keyword
4046
4047 =item The PROTOTYPES: Keyword
4048
4049 =item The PROTOTYPE: Keyword
4050
4051 =item The ALIAS: Keyword
4052
4053 =item The OVERLOAD: Keyword
4054
4055 =item The INTERFACE: Keyword
4056
4057 =item The INTERFACE_MACRO: Keyword
4058
4059 =item The INCLUDE: Keyword
4060
4061 =item The CASE: Keyword
4062
4063 =item The & Unary Operator
4064
4065 =item Inserting POD, Comments and C Preprocessor Directives
4066
4067 =item Using XS With C++
4068
4069 =item Interface Strategy
4070
4071 =item Perl Objects And C Structures
4072
4073 =item The Typemap
4074
4075 =item Safely Storing Static Data in XS
4076
4077 MY_CXT_KEY, typedef my_cxt_t, START_MY_CXT, MY_CXT_INIT, dMY_CXT, MY_CXT
4078
4079 =back
4080
4081 =item EXAMPLES
4082
4083 =item XS VERSION
4084
4085 =item AUTHOR
4086
4087 =back
4088
4089 =head2 perlclib - Internal replacements for standard C library functions
4090
4091 =over 4
4092
4093 =item DESCRIPTION
4094
4095 =over 4
4096
4097 =item Conventions
4098
4099 C<t>, C<p>, C<n>, C<s>
4100
4101 =item File Operations
4102
4103 =item File Input and Output
4104
4105 =item File Positioning
4106
4107 =item Memory Management and String Handling
4108
4109 =item Character Class Tests
4110
4111 =item F<stdlib.h> functions
4112
4113 =item Miscellaneous functions
4114
4115 =back
4116
4117 =item SEE ALSO
4118
4119 =back
4120
4121 =head2 perlguts - Introduction to the Perl API
4122
4123 =over 4
4124
4125 =item DESCRIPTION
4126
4127 =item Variables
4128
4129 =over 4
4130
4131 =item Datatypes
4132
4133 =item What is an "IV"?
4134
4135 =item Working with SVs
4136
4137 =item Offsets
4138
4139 =item What's Really Stored in an SV?
4140
4141 =item Working with AVs
4142
4143 =item Working with HVs
4144
4145 =item Hash API Extensions
4146
4147 =item References
4148
4149 =item Blessed References and Class Objects
4150
4151 =item Creating New Variables
4152
4153 GV_ADDMULTI, GV_ADDWARN
4154
4155 =item Reference Counts and Mortality
4156
4157 =item Stashes and Globs
4158
4159 =item Double-Typed SVs
4160
4161 =item Magic Variables
4162
4163 =item Assigning Magic
4164
4165 =item Magic Virtual Tables
4166
4167 =item Finding Magic
4168
4169 =item Understanding the Magic of Tied Hashes and Arrays
4170
4171 =item Localizing changes
4172
4173 C<SAVEINT(int i)>, C<SAVEIV(IV i)>, C<SAVEI32(I32 i)>, C<SAVELONG(long i)>,
4174 C<SAVESPTR(s)>, C<SAVEPPTR(p)>, C<SAVEFREESV(SV *sv)>, C<SAVEMORTALIZESV(SV
4175 *sv)>, C<SAVEFREEOP(OP *op)>, C<SAVEFREEPV(p)>, C<SAVECLEARSV(SV *sv)>,
4176 C<SAVEDELETE(HV *hv, char *key, I32 length)>,
4177 C<SAVEDESTRUCTOR(DESTRUCTORFUNC_NOCONTEXT_t f, void *p)>,
4178 C<SAVEDESTRUCTOR_X(DESTRUCTORFUNC_t f, void *p)>, C<SAVESTACK_POS()>, C<SV*
4179 save_scalar(GV *gv)>, C<AV* save_ary(GV *gv)>, C<HV* save_hash(GV *gv)>,
4180 C<void save_item(SV *item)>, C<void save_list(SV **sarg, I32 maxsarg)>,
4181 C<SV* save_svref(SV **sptr)>, C<void save_aptr(AV **aptr)>, C<void
4182 save_hptr(HV **hptr)>
4183
4184 =back
4185
4186 =item Subroutines
4187
4188 =over 4
4189
4190 =item XSUBs and the Argument Stack
4191
4192 =item Calling Perl Routines from within C Programs
4193
4194 =item Memory Allocation
4195
4196 =item PerlIO
4197
4198 =item Putting a C value on Perl stack
4199
4200 =item Scratchpads
4201
4202 =item Scratchpads and recursion
4203
4204 =back
4205
4206 =item Compiled code
4207
4208 =over 4
4209
4210 =item Code tree
4211
4212 =item Examining the tree
4213
4214 =item Compile pass 1: check routines
4215
4216 =item Compile pass 1a: constant folding
4217
4218 =item Compile pass 2: context propagation
4219
4220 =item Compile pass 3: peephole optimization
4221
4222 =item Pluggable runops
4223
4224 =back
4225
4226 =item Examining internal data structures with the C<dump> functions
4227
4228 =item How multiple interpreters and concurrency are supported
4229
4230 =over 4
4231
4232 =item Background and PERL_IMPLICIT_CONTEXT
4233
4234 =item So what happened to dTHR?
4235
4236 =item How do I use all this in extensions?
4237
4238 =item Should I do anything special if I call perl from multiple threads?
4239
4240 =item Future Plans and PERL_IMPLICIT_SYS
4241
4242 =back
4243
4244 =item Internal Functions
4245
4246 A, p, d, s, n, r, f, M, o, j, x
4247
4248 =over 4
4249
4250 =item Formatted Printing of IVs, UVs, and NVs
4251
4252 =item Pointer-To-Integer and Integer-To-Pointer
4253
4254 =item Source Documentation
4255
4256 =back
4257
4258 =item Unicode Support
4259
4260 =over 4
4261
4262 =item What B<is> Unicode, anyway?
4263
4264 =item How can I recognise a UTF8 string?
4265
4266 =item How does UTF8 represent Unicode characters?
4267
4268 =item How does Perl store UTF8 strings?
4269
4270 =item How do I convert a string to UTF8?
4271
4272 =item Is there anything else I need to know?
4273
4274 =back
4275
4276 =item Custom Operators
4277
4278 =item AUTHORS
4279
4280 =item SEE ALSO
4281
4282 =back
4283
4284 =head2 perlcall - Perl calling conventions from C
4285
4286 =over 4
4287
4288 =item DESCRIPTION
4289
4290 An Error Handler, An Event Driven Program
4291
4292 =item THE CALL_ FUNCTIONS
4293
4294 call_sv, call_pv, call_method, call_argv
4295
4296 =item FLAG VALUES
4297
4298 =over 4
4299
4300 =item  G_VOID
4301
4302 =item  G_SCALAR
4303
4304 =item G_ARRAY
4305
4306 =item G_DISCARD
4307
4308 =item G_NOARGS
4309
4310 =item G_EVAL
4311
4312 =item G_KEEPERR
4313
4314 =item Determining the Context
4315
4316 =back
4317
4318 =item KNOWN PROBLEMS
4319
4320 =item EXAMPLES
4321
4322 =over 4
4323
4324 =item No Parameters, Nothing returned
4325
4326 =item Passing Parameters
4327
4328 =item Returning a Scalar
4329
4330 =item Returning a list of values
4331
4332 =item Returning a list in a scalar context
4333
4334 =item Returning Data from Perl via the parameter list
4335
4336 =item Using G_EVAL
4337
4338 =item Using G_KEEPERR
4339
4340 =item Using call_sv
4341
4342 =item Using call_argv
4343
4344 =item Using call_method
4345
4346 =item Using GIMME_V
4347
4348 =item Using Perl to dispose of temporaries
4349
4350 =item Strategies for storing Callback Context Information
4351
4352 1. Ignore the problem - Allow only 1 callback, 2. Create a sequence of
4353 callbacks - hard wired limit, 3. Use a parameter to map to the Perl
4354 callback
4355
4356 =item Alternate Stack Manipulation
4357
4358 =item Creating and calling an anonymous subroutine in C
4359
4360 =back
4361
4362 =item SEE ALSO
4363
4364 =item AUTHOR
4365
4366 =item DATE
4367
4368 =back
4369
4370 =head2 perlutil - utilities packaged with the Perl distribution
4371
4372 =over 4
4373
4374 =item DESCRIPTION
4375
4376 =over 4
4377
4378 =item DOCUMENTATION
4379
4380 L<perldoc|perldoc>, L<pod2man|pod2man> and L<pod2text|pod2text>,
4381 L<pod2html|pod2html> and L<pod2latex|pod2latex>, L<pod2usage|pod2usage>,
4382 L<podselect|podselect>, L<podchecker|podchecker>, L<splain|splain>,
4383 L<roffitall|roffitall>
4384
4385 =item CONVERTORS
4386
4387 L<a2p|a2p>, L<s2p|s2p>, L<find2perl|find2perl>
4388
4389 =item Administration
4390
4391 L<libnetcfg|libnetcfg>
4392
4393 =item Development
4394
4395 L<perlbug|perlbug>, L<h2ph|h2ph>, L<c2ph|c2ph> and L<pstruct|pstruct>,
4396 L<h2xs|h2xs>, L<dprofpp|dprofpp>, L<perlcc|perlcc>
4397
4398 =item SEE ALSO
4399
4400 =back
4401
4402 =back
4403
4404 =head2 perlfilter - Source Filters
4405
4406 =over 4
4407
4408 =item DESCRIPTION
4409
4410 =item CONCEPTS
4411
4412 =item USING FILTERS
4413
4414 =item WRITING A SOURCE FILTER
4415
4416 =item WRITING A SOURCE FILTER IN C
4417
4418 B<Decryption Filters>
4419
4420 =item CREATING A SOURCE FILTER AS A SEPARATE EXECUTABLE
4421
4422 =item WRITING A SOURCE FILTER IN PERL
4423
4424 =item USING CONTEXT: THE DEBUG FILTER
4425
4426 =item CONCLUSION
4427
4428 =item REQUIREMENTS
4429
4430 =item AUTHOR
4431
4432 =item Copyrights
4433
4434 =back
4435
4436 =head2 perldbmfilter - Perl DBM Filters
4437
4438 =over 4
4439
4440 =item SYNOPSIS
4441
4442 =item DESCRIPTION
4443
4444 B<filter_store_key>, B<filter_store_value>, B<filter_fetch_key>,
4445 B<filter_fetch_value>
4446
4447 =over 4
4448
4449 =item The Filter
4450
4451 =item An Example -- the NULL termination problem.
4452
4453 =item Another Example -- Key is a C int.
4454
4455 =back
4456
4457 =item SEE ALSO
4458
4459 =item AUTHOR
4460
4461 =back
4462
4463 =head2 perlapi - autogenerated documentation for the perl public API
4464
4465 =over 4
4466
4467 =item DESCRIPTION
4468
4469 =item "Gimme" Values
4470
4471 GIMME, GIMME_V, G_ARRAY, G_DISCARD, G_EVAL, G_NOARGS, G_SCALAR, G_VOID
4472
4473 =item Array Manipulation Functions
4474
4475 AvFILL, av_clear, av_delete, av_exists, av_extend, av_fetch, av_fill,
4476 av_len, av_make, av_pop, av_push, av_shift, av_store, av_undef, av_unshift,
4477 get_av, newAV, Nullav, sortsv
4478
4479 =item Callback Functions
4480
4481 call_argv, call_method, call_pv, call_sv, ENTER, eval_pv, eval_sv,
4482 FREETMPS, LEAVE, SAVETMPS
4483
4484 =item Character classes
4485
4486 isALNUM, isALPHA, isDIGIT, isLOWER, isSPACE, isUPPER, toLOWER, toUPPER
4487
4488 =item Cloning an interpreter
4489
4490 perl_clone
4491
4492 =item CV Manipulation Functions
4493
4494 CvSTASH, get_cv, Nullcv
4495
4496 =item Embedding Functions
4497
4498 load_module, nothreadhook, perl_alloc, perl_construct, perl_destruct,
4499 perl_free, perl_parse, perl_run, require_pv
4500
4501 =item Functions in file pp_pack.c
4502
4503 pack_cat, unpack_str
4504
4505 =item Global Variables
4506
4507 PL_modglobal, PL_na, PL_sv_no, PL_sv_undef, PL_sv_yes
4508
4509 =item GV Functions
4510
4511 GvSV, gv_fetchmeth, gv_fetchmethod, gv_fetchmethod_autoload,
4512 gv_fetchmeth_autoload, gv_stashpv, gv_stashsv
4513
4514 =item Handy Values
4515
4516 HEf_SVKEY, Nullch, Nullsv
4517
4518 =item Hash Manipulation Functions
4519
4520 get_hv, HeHASH, HeKEY, HeKLEN, HePV, HeSVKEY, HeSVKEY_force, HeSVKEY_set,
4521 HeVAL, HvNAME, hv_clear, hv_delete, hv_delete_ent, hv_exists,
4522 hv_exists_ent, hv_fetch, hv_fetch_ent, hv_iterinit, hv_iterkey,
4523 hv_iterkeysv, hv_iternext, hv_iternextsv, hv_iternext_flags, hv_iterval,
4524 hv_magic, hv_store, hv_store_ent, hv_undef, newHV, Nullhv
4525
4526 =item Magical Functions
4527
4528 mg_clear, mg_copy, mg_find, mg_free, mg_get, mg_length, mg_magical, mg_set,
4529 SvGETMAGIC, SvLOCK, SvSETMAGIC, SvSetMagicSV, SvSetMagicSV_nosteal,
4530 SvSetSV, SvSetSV_nosteal, SvSHARE
4531
4532 =item Memory Management
4533
4534 Copy, Move, New, Newc, NEWSV, Newz, Poison, Renew, Renewc, Safefree,
4535 savepv, savepvn, savesharedpv, StructCopy, Zero
4536
4537 =item Miscellaneous Functions
4538
4539 fbm_compile, fbm_instr, form, getcwd_sv, strEQ, strGE, strGT, strLE, strLT,
4540 strNE, strnEQ, strnNE
4541
4542 =item Numeric functions
4543
4544 grok_bin, grok_hex, grok_number, grok_numeric_radix, grok_oct, scan_bin,
4545 scan_hex, scan_oct
4546
4547 =item Optree Manipulation Functions
4548
4549 cv_const_sv, newCONSTSUB, newXS
4550
4551 =item Stack Manipulation Macros
4552
4553 dMARK, dORIGMARK, dSP, EXTEND, MARK, ORIGMARK, POPi, POPl, POPn, POPp,
4554 POPpbytex, POPpx, POPs, PUSHi, PUSHMARK, PUSHn, PUSHp, PUSHs, PUSHu,
4555 PUTBACK, SP, SPAGAIN, XPUSHi, XPUSHn, XPUSHp, XPUSHs, XPUSHu, XSRETURN,
4556 XSRETURN_IV, XSRETURN_NO, XSRETURN_NV, XSRETURN_PV, XSRETURN_UNDEF,
4557 XSRETURN_YES, XST_mIV, XST_mNO, XST_mNV, XST_mPV, XST_mUNDEF, XST_mYES
4558
4559 =item SV Flags
4560
4561 svtype, SVt_IV, SVt_NV, SVt_PV, SVt_PVAV, SVt_PVCV, SVt_PVHV, SVt_PVMG
4562
4563 =item SV Manipulation Functions
4564
4565 get_sv, looks_like_number, newRV_inc, newRV_noinc, newSV, newSViv, newSVnv,
4566 newSVpv, newSVpvf, newSVpvn, newSVpvn_share, newSVrv, newSVsv, newSVuv,
4567 new_vstring, SvCUR, SvCUR_set, SvEND, SvGROW, SvIOK, SvIOKp, SvIOK_notUV,
4568 SvIOK_off, SvIOK_on, SvIOK_only, SvIOK_only_UV, SvIOK_UV, SvIV, SvIVx,
4569 SvIVX, SvLEN, SvNIOK, SvNIOKp, SvNIOK_off, SvNOK, SvNOKp, SvNOK_off,
4570 SvNOK_on, SvNOK_only, SvNV, SvNVX, SvNVx, SvOK, SvOOK, SvPOK, SvPOKp,
4571 SvPOK_off, SvPOK_on, SvPOK_only, SvPOK_only_UTF8, SvPV, SvPVbyte,
4572 SvPVbytex, SvPVbytex_force, SvPVbyte_force, SvPVbyte_nolen, SvPVutf8,
4573 SvPVutf8x, SvPVutf8x_force, SvPVutf8_force, SvPVutf8_nolen, SvPVx, SvPVX,
4574 SvPV_force, SvPV_force_nomg, SvPV_nolen, SvREFCNT, SvREFCNT_dec,
4575 SvREFCNT_inc, SvROK, SvROK_off, SvROK_on, SvRV, SvSTASH, SvTAINT,
4576 SvTAINTED, SvTAINTED_off, SvTAINTED_on, SvTRUE, SvTYPE, SvUNLOCK, SvUOK,
4577 SvUPGRADE, SvUTF8, SvUTF8_off, SvUTF8_on, SvUV, SvUVX, SvUVx, sv_2bool,
4578 sv_2cv, sv_2io, sv_2iv, sv_2mortal, sv_2nv, sv_2pvbyte, sv_2pvbyte_nolen,
4579 sv_2pvutf8, sv_2pvutf8_nolen, sv_2pv_flags, sv_2pv_nolen, sv_2uv,
4580 sv_backoff, sv_bless, sv_catpv, sv_catpvf, sv_catpvf_mg, sv_catpvn,
4581 sv_catpvn_flags, sv_catpvn_mg, sv_catpv_mg, sv_catsv, sv_catsv_flags,
4582 sv_catsv_mg, sv_chop, sv_clear, sv_cmp, sv_cmp_locale, sv_collxfrm,
4583 sv_copypv, sv_dec, sv_derived_from, sv_eq, sv_force_normal,
4584 sv_force_normal_flags, sv_free, sv_gets, sv_grow, sv_inc, sv_insert,
4585 sv_isa, sv_isobject, sv_iv, sv_len, sv_len_utf8, sv_magic, sv_magicext,
4586 sv_mortalcopy, sv_newmortal, sv_newref, sv_nolocking, sv_nosharing,
4587 sv_nounlocking, sv_nv, sv_pos_b2u, sv_pos_u2b, sv_pv, sv_pvbyte,
4588 sv_pvbyten, sv_pvbyten_force, sv_pvn, sv_pvn_force, sv_pvn_force_flags,
4589 sv_pvutf8, sv_pvutf8n, sv_pvutf8n_force, sv_reftype, sv_replace,
4590 sv_report_used, sv_reset, sv_rvweaken, sv_setiv, sv_setiv_mg, sv_setnv,
4591 sv_setnv_mg, sv_setpv, sv_setpvf, sv_setpvf_mg, sv_setpvn, sv_setpvn_mg,
4592 sv_setpv_mg, sv_setref_iv, sv_setref_nv, sv_setref_pv, sv_setref_pvn,
4593 sv_setref_uv, sv_setsv, sv_setsv_flags, sv_setsv_mg, sv_setuv, sv_setuv_mg,
4594 sv_taint, sv_tainted, sv_true, sv_unmagic, sv_unref, sv_unref_flags,
4595 sv_untaint, sv_upgrade, sv_usepvn, sv_usepvn_mg, sv_utf8_decode,
4596 sv_utf8_downgrade, sv_utf8_encode, sv_utf8_upgrade, sv_utf8_upgrade_flags,
4597 sv_uv, sv_vcatpvfn, sv_vsetpvfn
4598
4599 =item Unicode Support
4600
4601 bytes_from_utf8, bytes_to_utf8, ibcmp_utf8, is_utf8_char, is_utf8_string,
4602 pv_uni_display, sv_recode_to_utf8, sv_uni_display, to_utf8_case,
4603 to_utf8_fold, to_utf8_lower, to_utf8_title, to_utf8_upper, utf8n_to_uvchr,
4604 utf8n_to_uvuni, utf8_distance, utf8_hop, utf8_length, utf8_to_bytes,
4605 utf8_to_uvchr, utf8_to_uvuni, uvchr_to_utf8, uvuni_to_utf8_flags
4606
4607 =item Variables created by C<xsubpp> and C<xsubpp> internal functions
4608
4609 ax, CLASS, dAX, dITEMS, dXSARGS, dXSI32, items, ix, newXSproto, RETVAL, ST,
4610 THIS, XS, XSRETURN_EMPTY, XS_VERSION, XS_VERSION_BOOTCHECK
4611
4612 =item Warning and Dieing
4613
4614 croak, warn
4615
4616 =item AUTHORS
4617
4618 =item SEE ALSO
4619
4620 =back
4621
4622 =head2 perlintern - autogenerated documentation of purely B<internal>
4623                  Perl functions
4624
4625 =over 4
4626
4627 =item DESCRIPTION
4628
4629 =item Global Variables
4630
4631 PL_DBsingle, PL_DBsub, PL_DBtrace, PL_dowarn, PL_last_in_gv, PL_ofs_sv,
4632 PL_rs
4633
4634 =item GV Functions
4635
4636 is_gv_magical
4637
4638 =item IO Functions
4639
4640 start_glob
4641
4642 =item Pad Data Structures
4643
4644 CvPADLIST
4645
4646 =item Stack Manipulation Macros
4647
4648 djSP, LVRET
4649
4650 =item SV Manipulation Functions
4651
4652 report_uninit, sv_add_arena, sv_clean_all, sv_clean_objs, sv_free_arenas
4653
4654 =item AUTHORS
4655
4656 =item SEE ALSO
4657
4658 =back
4659
4660 =head2 perliol - C API for Perl's implementation of IO in Layers.
4661
4662 =over 4
4663
4664 =item SYNOPSIS
4665
4666 =item DESCRIPTION
4667
4668 =over 4
4669
4670 =item History and Background
4671
4672 =item Layers vs Disciplines
4673
4674 =item Data Structures
4675
4676 =item Functions and Attributes
4677
4678 =item Per-instance Data
4679
4680 =item Layers in action.
4681
4682 =item Per-instance flag bits
4683
4684 PERLIO_F_EOF, PERLIO_F_CANWRITE,  PERLIO_F_CANREAD, PERLIO_F_ERROR,
4685 PERLIO_F_TRUNCATE, PERLIO_F_APPEND, PERLIO_F_CRLF, PERLIO_F_UTF8,
4686 PERLIO_F_UNBUF, PERLIO_F_WRBUF, PERLIO_F_RDBUF, PERLIO_F_LINEBUF,
4687 PERLIO_F_TEMP, PERLIO_F_OPEN, PERLIO_F_FASTGETS
4688
4689 =item Methods in Detail
4690
4691 fsize, name, size, kind, PERLIO_K_BUFFERED, PERLIO_K_RAW, PERLIO_K_CANCRLF,
4692 PERLIO_K_FASTGETS, PERLIO_K_MULTIARG, Pushed, Popped, Open, Binmode,
4693 Getarg, Fileno, Dup, Read, Write, Seek, Tell, Close, Flush, Fill, Eof,
4694 Error,  Clearerr, Setlinebuf, Get_base, Get_bufsiz, Get_ptr, Get_cnt,
4695 Set_ptrcnt
4696
4697 =item Core Layers
4698
4699 "unix", "perlio", "stdio", "crlf", "mmap", "pending", "raw", "utf8"
4700
4701 =item Extension Layers
4702
4703 ":encoding", ":scalar", ":via"
4704
4705 =back
4706
4707 =item TODO
4708
4709 =back
4710
4711 =head2 perlapio - perl's IO abstraction interface.
4712
4713 =over 4
4714
4715 =item SYNOPSIS
4716
4717 =item DESCRIPTION
4718
4719 1. USE_STDIO, 2. USE_SFIO, 3. USE_PERLIO, B<PerlIO_stdin()>,
4720 B<PerlIO_stdout()>, B<PerlIO_stderr()>, B<PerlIO_open(path, mode)>,
4721 B<PerlIO_fdopen(fd,mode)>, B<PerlIO_reopen(path,mode,f)>,
4722 B<PerlIO_printf(f,fmt,...)>, B<PerlIO_vprintf(f,fmt,a)>,
4723 B<PerlIO_stdoutf(fmt,...)>, B<PerlIO_read(f,buf,count)>,
4724 B<PerlIO_write(f,buf,count)>, B<PerlIO_close(f)>, B<PerlIO_puts(f,s)>,
4725 B<PerlIO_putc(f,c)>, B<PerlIO_ungetc(f,c)>, B<PerlIO_getc(f)>,
4726 B<PerlIO_eof(f)>, B<PerlIO_error(f)>, B<PerlIO_fileno(f)>,
4727 B<PerlIO_clearerr(f)>, B<PerlIO_flush(f)>, B<PerlIO_seek(f,offset,whence)>,
4728 B<PerlIO_tell(f)>, B<PerlIO_getpos(f,p)>, B<PerlIO_setpos(f,p)>,
4729 B<PerlIO_rewind(f)>, B<PerlIO_tmpfile()>, B<PerlIO_setlinebuf(f)>
4730
4731 =over 4
4732
4733 =item Co-existence with stdio
4734
4735 B<PerlIO_importFILE(f,mode)>, B<PerlIO_exportFILE(f,mode)>,
4736 B<PerlIO_releaseFILE(p,f)>, B<PerlIO_findFILE(f)>
4737
4738 =item "Fast gets" Functions
4739
4740 B<PerlIO_fast_gets(f)>, B<PerlIO_has_cntptr(f)>, B<PerlIO_get_cnt(f)>,
4741 B<PerlIO_get_ptr(f)>, B<PerlIO_set_ptrcnt(f,p,c)>, B<PerlIO_canset_cnt(f)>,
4742 B<PerlIO_set_cnt(f,c)>, B<PerlIO_has_base(f)>, B<PerlIO_get_base(f)>,
4743 B<PerlIO_get_bufsiz(f)>
4744
4745 =item Other Functions
4746
4747 PerlIO_apply_layers(f,mode,layers), PerlIO_binmode(f,ptype,imode,layers),
4748 'E<lt>' read, 'E<gt>' write, '+' read/write, PerlIO_debug(fmt,...)
4749
4750 =back
4751
4752 =back
4753
4754 =head2 perltodo - Perl TO-DO List
4755
4756 =over 4
4757
4758 =item DESCRIPTION
4759
4760 =item To do during 5.6.x
4761
4762 =over 4
4763
4764 =item Support for I/O disciplines
4765
4766 =item Autoload bytes.pm
4767
4768 =item Make "\u{XXXX}" et al work
4769
4770 =item Create a char *sv_pvprintify(sv, STRLEN *lenp, UV flags)
4771
4772 =item Overloadable regex assertions
4773
4774 =item Unicode
4775
4776 =item Work out exit/die semantics for threads
4777
4778 =item Better support for nonpreemptive threading systems like GNU pth
4779
4780 =item Typed lexicals for compiler
4781
4782 =item Compiler workarounds for Win32
4783
4784 =item AUTOLOADing in the compiler
4785
4786 =item Fixing comppadlist when compiling
4787
4788 =item Cleaning up exported namespace
4789
4790 =item Complete signal handling
4791
4792 =item Out-of-source builds
4793
4794 =item POSIX realtime support
4795
4796 =item UNIX98 support
4797
4798 =item IPv6 Support
4799
4800 =item Long double conversion
4801
4802 =item Locales
4803
4804 =item Arithmetic on non-Arabic numerals
4805
4806 =item POSIX Unicode character classes
4807
4808 =item Factoring out common suffices/prefices in regexps (trie optimization)
4809
4810 =item Security audit shipped utilities
4811
4812 =item Sort out the uid-setting mess
4813
4814 =item Custom opcodes
4815
4816 =item DLL Versioning
4817
4818 =item Introduce @( and @)
4819
4820 =item Floating point handling
4821
4822 =item IV/UV preservation
4823
4824 =item Replace pod2html with something using Pod::Parser
4825
4826 =item Automate module testing on CPAN
4827
4828 =item sendmsg and recvmsg
4829
4830 =item Rewrite perlre documentation
4831
4832 =item Convert example code to IO::Handle filehandles
4833
4834 =item Document Win32 choices
4835
4836 =item Check new modules
4837
4838 =item Make roffitall find pods and libs itself
4839
4840 =back
4841
4842 =item To do at some point
4843
4844 =over 4
4845
4846 =item Remove regular expression recursion
4847
4848 =item Memory leaks after failed eval
4849
4850 =item bitfields in pack
4851
4852 =item Cross compilation
4853
4854 =item Perl preprocessor / macros
4855
4856 =item Perl lexer in Perl
4857
4858 =item Using POSIX calls internally
4859
4860 =item -i rename file when changed
4861
4862 =item All ARGV input should act like E<lt>E<gt>
4863
4864 =item Support for rerunning debugger
4865
4866 =item Test Suite for the Debugger
4867
4868 =item my sub foo { }
4869
4870 =item One-pass global destruction
4871
4872 =item Rewrite regexp parser
4873
4874 =item Cache recently used regexps
4875
4876 =item Cross-compilation support
4877
4878 =item Bit-shifting bitvectors
4879
4880 =item debugger pragma
4881
4882 =item use less pragma
4883
4884 =item switch structures
4885
4886 =item Cache eval tree
4887
4888 =item rcatmaybe
4889
4890 =item Shrink opcode tables
4891
4892 =item Optimize away @_
4893
4894 =item Prototypes versus indirect objects
4895
4896 =item Install HTML
4897
4898 =item Prototype method calls
4899
4900 =item Return context prototype declarations
4901
4902 =item magic_setisa
4903
4904 =item Garbage collection
4905
4906 =item IO tutorial
4907
4908 =item Rewrite perldoc
4909
4910 =item Install .3p manpages
4911
4912 =item Unicode tutorial
4913
4914 =item Update POSIX.pm for 1003.1-2
4915
4916 =item Retargetable installation
4917
4918 =item POSIX emulation on non-POSIX systems
4919
4920 =item Rename Win32 headers
4921
4922 =item Finish off lvalue functions
4923
4924 =item Update sprintf documentation
4925
4926 =item Use fchown/fchmod internally
4927
4928 =item Make v-strings overloaded objects
4929
4930 =item Allow restricted hash assignment
4931
4932 =item Should overload be inheritable?
4933
4934 =item Taint rethink
4935
4936 =back
4937
4938 =item Vague ideas
4939
4940 =over 4
4941
4942 =item ref() in list context
4943
4944 =item Make tr/// return histogram of characters in list context
4945
4946 =item Compile to real threaded code
4947
4948 =item Structured types
4949
4950 =item Modifiable $1 et al.
4951
4952 =item Procedural interfaces for IO::*, etc.
4953
4954 =item RPC modules
4955
4956 =item Attach/detach debugger from running program
4957
4958 =item GUI::Native
4959
4960 =item foreach(reverse ...)
4961
4962 =item Constant function cache
4963
4964 =item Approximate regular expression matching
4965
4966 =back
4967
4968 =item Ongoing
4969
4970 =over 4
4971
4972 =item Update guts documentation
4973
4974 =item Add more tests
4975
4976 =item Update auxiliary tools
4977
4978 =item Create debugging macros
4979
4980 =item truncate to the people
4981
4982 =item Unicode in Filenames
4983
4984 =back
4985
4986 =item Recently done things
4987
4988 =over 4
4989
4990 =item Alternative RE syntax module
4991
4992 =item Safe signal handling
4993
4994 =item Tie Modules
4995
4996 =item gettimeofday
4997
4998 =item setitimer and getimiter
4999
5000 =item Testing __DIE__ hook
5001
5002 =item CPP equivalent in Perl
5003
5004 =item Explicit switch statements
5005
5006 =item autocroak
5007
5008 =item UTF/EBCDIC
5009
5010 =item UTF Regexes
5011
5012 =item perlcc to produce executable
5013
5014 =item END blocks saved in compiled output
5015
5016 =item Secure temporary file module
5017
5018 =item Integrate Time::HiRes
5019
5020 =item Turn Cwd into XS
5021
5022 =item Mmap for input
5023
5024 =item Byte to/from UTF8 and UTF8 to/from local conversion
5025
5026 =item Add sockatmark support
5027
5028 =item Mailing list archives
5029
5030 =item Bug tracking
5031
5032 =item Integrate MacPerl
5033
5034 =item Web "nerve center" for Perl
5035
5036 =item Regular expression tutorial
5037
5038 =item Debugging Tutorial
5039
5040 =item Integrate new modules
5041
5042 =item Integrate profiler
5043
5044 =item Y2K error detection
5045
5046 =item Regular expression debugger
5047
5048 =item POD checker
5049
5050 =item "Dynamic" lexicals
5051
5052 =item Cache precompiled modules
5053
5054 =back
5055
5056 =item Deprecated Wishes
5057
5058 =over 4
5059
5060 =item Loop control on do{}
5061
5062 =item Lexically scoped typeglobs
5063
5064 =item format BOTTOM
5065
5066 =item report HANDLE
5067
5068 =item Generalised want()/caller())
5069
5070 =item Named prototypes
5071
5072 =item Built-in globbing
5073
5074 =item Regression tests for suidperl
5075
5076 =item Cached hash values
5077
5078 =item Add compression modules
5079
5080 =item Reorganise documentation into tutorials/references
5081
5082 =item Remove distinction between functions and operators
5083
5084 =item Make XS easier to use
5085
5086 =item Make embedding easier to use
5087
5088 =item man for perl
5089
5090 =item my $Package::variable
5091
5092 =item "or" tests defined, not truth
5093
5094 =item "class"-based lexicals
5095
5096 =item byteperl
5097
5098 =item Lazy evaluation / tail recursion removal
5099
5100 =item Make "use utf8" the default
5101
5102 =item Unicode collation and normalization
5103
5104 =item pack/unpack tutorial
5105
5106 =back
5107
5108 =back
5109
5110 =head2 perlhack - How to hack at the Perl internals
5111
5112 =over 4
5113
5114 =item DESCRIPTION
5115
5116 Does concept match the general goals of Perl?, Where is the
5117 implementation?, Backwards compatibility, Could it be a module instead?, Is
5118 the feature generic enough?, Does it potentially introduce new bugs?, Does
5119 it preclude other desirable features?, Is the implementation robust?, Is
5120 the implementation generic enough to be portable?, Is the implementation
5121 tested?, Is there enough documentation?, Is there another way to do it?,
5122 Does it create too much work?, Patches speak louder than words
5123
5124 =over 4
5125
5126 =item Keeping in sync
5127
5128 rsync'ing the source tree, Using rsync over the LAN, Using pushing over the
5129 NFS, rsync'ing the patches
5130
5131 =item Why rsync the source tree
5132
5133 It's easier to rsync the source tree, It's more reliable
5134
5135 =item Why rsync the patches
5136
5137 It's easier to rsync the patches, It's a good reference, Finding a start
5138 point, Finding how to fix a bug, Finding the source of misbehaviour
5139
5140 =item Perlbug remote interface
5141
5142 1 http://bugs.perl.org, 2 bugdb@perl.org, 3
5143 commands_and_bugdids@bugs.perl.org, notes, patches, tests
5144
5145 =item Submitting patches
5146
5147 L<perlguts>, L<perlxstut> and L<perlxs>, L<perlapi>,
5148 F<Porting/pumpkin.pod>, The perl5-porters FAQ
5149
5150 =item Finding Your Way Around
5151
5152 Core modules, Tests, Documentation, Configure, Interpreter
5153
5154 =item Elements of the interpreter
5155
5156 Startup, Parsing, Optimization, Running
5157
5158 =item Internal Variable Types
5159
5160 =item Op Trees
5161
5162 =item Stacks
5163
5164 Argument stack, Mark stack, Save stack
5165
5166 =item Millions of Macros
5167
5168 =item Poking at Perl
5169
5170 =item Using a source-level debugger
5171
5172 run [args], break function_name, break source.c:xxx, step, next, continue,
5173 finish, 'enter', print
5174
5175 =item Dumping Perl Data Structures
5176
5177 =item Patching
5178
5179 =item Patching a core module
5180
5181 =item Adding a new function to the core
5182
5183 =item Writing a test
5184
5185 F<t/base/>, F<t/cmd/>, F<t/comp/>, F<t/io/>, F<t/lib/>, F<t/op/>,
5186 F<t/pod/>, F<t/run/>, t/base t/comp, t/cmd t/run t/io t/op, t/lib ext lib
5187
5188 =item Special Make Test Targets
5189
5190 coretest, test.deparse, minitest, test.third check.third utest.third
5191 ucheck.third, test.torture torturetest, utest ucheck test.utf8 check.utf8
5192
5193 =back
5194
5195 =item EXTERNAL TOOLS FOR DEBUGGING PERL
5196
5197 =over 4
5198
5199 =item Rational Software's Purify
5200
5201 =item Purify on Unix
5202
5203 -Accflags=-DPURIFY, -Doptimize='-g', -Uusemymalloc, -Dusemultiplicity
5204
5205 =item Purify on NT
5206
5207 DEFINES, USE_MULTI = define, #PERL_MALLOC = define, CFG = Debug
5208
5209 =item Compaq's/Digital's/HP's Third Degree
5210
5211 =item PERL_DESTRUCT_LEVEL
5212
5213 =item Profiling
5214
5215 =item Gprof Profiling
5216
5217 -a, -b, -e routine, -f routine, -s, -z
5218
5219 =item GCC gcov Profiling
5220
5221 =item Pixie Profiling
5222
5223 -h, -l, -p[rocedures], -h[eavy], -i[nvocations], -l[ines], -testcoverage,
5224 -z[ero]
5225
5226 =item Miscellaneous tricks
5227
5228 =item CONCLUSION
5229
5230 I<The Road goes ever on and on, down from the door where it began.>
5231
5232 =back
5233
5234 =item AUTHOR
5235
5236 =back
5237
5238 =head2 perlhist - the Perl history records
5239
5240 =over 4
5241
5242 =item DESCRIPTION
5243
5244 =item INTRODUCTION
5245
5246 =item THE KEEPERS OF THE PUMPKIN
5247
5248 =over 4
5249
5250 =item PUMPKIN?
5251
5252 =back
5253
5254 =item THE RECORDS
5255
5256 =over 4
5257
5258 =item SELECTED RELEASE SIZES
5259
5260 =item SELECTED PATCH SIZES
5261
5262 =back
5263
5264 =item THE KEEPERS OF THE RECORDS
5265
5266 =back
5267
5268 =head2 perldelta - what is new for perl v5.8.0
5269
5270 =over 4
5271
5272 =item DESCRIPTION
5273
5274 =item Highlights In 5.8.0
5275
5276 =item Incompatible Changes
5277
5278 =over 4
5279
5280 =item Binary Incompatibility
5281
5282 =item 64-bit platforms and malloc
5283
5284 =item AIX Dynaloading
5285
5286 =item Attributes for C<my> variables now handled at run-time.
5287
5288 =item Socket Extension Dynamic in VMS
5289
5290 =item IEEE-format Floating Point Default on OpenVMS Alpha
5291
5292 =item New Unicode Properties
5293
5294 =item REF(...) Instead Of SCALAR(...)
5295
5296 =item pack/unpack D/F recycled
5297
5298 =item Deprecations
5299
5300 =back
5301
5302 =item Core Enhancements
5303
5304 =over 4
5305
5306 =item PerlIO is Now The Default
5307
5308 =item Restricted Hashes
5309
5310 =item Safe Signals
5311
5312 =item Unicode Overhaul
5313
5314 =item Understanding of Numbers
5315
5316 =item Arrays now always interpolate into double-quoted strings [561]
5317
5318 =item Miscellaneous Changes
5319
5320 =back
5321
5322 =item Modules and Pragmata
5323
5324 =over 4
5325
5326 =item New Modules and Pragmata
5327
5328 =item Updated And Improved Modules and Pragmata
5329
5330 =back
5331
5332 =item Utility Changes
5333
5334 =item New Documentation
5335
5336 =item Performance Enhancements
5337
5338 =item Installation and Configuration Improvements
5339
5340 =over 4
5341
5342 =item Generic Improvements
5343
5344 =item New Or Improved Platforms
5345
5346 =back
5347
5348 =item Selected Bug Fixes
5349
5350 =over 4
5351
5352 =item Platform Specific Changes and Fixes
5353
5354 =back
5355
5356 =item New or Changed Diagnostics
5357
5358 =item Changed Internals
5359
5360 =item Security Vulnerability Closed [561]
5361
5362 =item New Tests
5363
5364 =item Known Problems
5365
5366 =over 4
5367
5368 =item AIX
5369
5370 =item Alpha systems with old gccs fail several tests
5371
5372 =item AmigaOS
5373
5374 =item BeOS
5375
5376 =item Cygwin "unable to remap"
5377
5378 =item Cygwin ndbm tests fail on FAT
5379
5380 =item ext/threads/t/libc
5381
5382 =item FreeBSD built with ithreads coredumps reading large directories
5383
5384 =item FreeBSD Failing locale Test 117 For ISO 8859-15 Locales
5385
5386 =item IRIX fails ext/List/Util/t/shuffle.t
5387
5388 =item Modifying $_ Inside for(..)
5389
5390 =item mod_perl 1.26 Doesn't Build With Threaded Perl
5391
5392 =item lib/ftmp-security tests warn 'system possibly insecure'
5393
5394 =item HP-UX lib/posix Subtest 9 Fails When LP64-Configured
5395
5396 =item Linux with glibc 2.2.5 fails t/op/int subtest #6 with -Duse64bitint
5397
5398 =item Linux With Sfio Fails op/misc Test 48
5399
5400 =item libwww-perl (LWP) fails base/date #51
5401
5402 =item Mac OS X
5403
5404 =item OS/2 Test Failures
5405
5406 =item op/sprintf tests 91, 129, and 130
5407
5408 =item Solaris 2.5
5409
5410 =item Solaris x86 Fails Tests With -Duse64bitint
5411
5412 =item SUPER-UX (NEC SX)
5413
5414 =item PDL failing some tests
5415
5416 =item Term::ReadKey not working on Win32
5417
5418 =item Failure of Thread (5.005-style) tests
5419
5420 =item Timing problems
5421
5422 =item Unicode in package/class and subroutine names does not work
5423
5424 =item UNICOS/mk
5425
5426 =item UTS
5427
5428 =item VOS (Stratus)
5429
5430 =item VMS
5431
5432 =item Win32
5433
5434 =item XML::Parser not working
5435
5436 =item z/OS (OS/390)
5437
5438 =item Localising Tied Arrays and Hashes Is Broken
5439
5440 =item Self-tying Problems
5441
5442 =item Tied/Magical Array/Hash Elements Do Not Autovivify
5443
5444 =item Building Extensions Can Fail Because Of Largefiles
5445
5446 =item Unicode Support on EBCDIC Still Spotty
5447
5448 =item The Compiler Suite Is Still Very Experimental
5449
5450 =item The Long Double Support Is Still Experimental
5451
5452 =item Seen In Perl 5.7 But Gone Now
5453
5454 =back
5455
5456 =item Reporting Bugs
5457
5458 =item SEE ALSO
5459
5460 =item HISTORY
5461
5462 =back
5463
5464 =head2 perl572delta - what's new for perl v5.7.2
5465
5466 =over 4
5467
5468 =item DESCRIPTION
5469
5470 =item Security Vulnerability Closed
5471
5472 =item Incompatible Changes
5473
5474 =over 4
5475
5476 =item 64-bit platforms and malloc
5477
5478 =item AIX Dynaloading
5479
5480 =item Socket Extension Dynamic in VMS
5481
5482 =item Different Definition of the Unicode Character Classes \p{In...}
5483
5484 =item Deprecations
5485
5486 =back
5487
5488 =item Core Enhancements
5489
5490 =item Modules and Pragmata
5491
5492 =over 4
5493
5494 =item New Modules and Distributions
5495
5496 =item Updated And Improved Modules and Pragmata
5497
5498 =back
5499
5500 =item Utility Changes
5501
5502 =item New Documentation
5503
5504 =item Installation and Configuration Improvements
5505
5506 =over 4
5507
5508 =item New Or Improved Platforms
5509
5510 =item Generic Improvements
5511
5512 =back
5513
5514 =item Selected Bug Fixes
5515
5516 =over 4
5517
5518 =item Platform Specific Changes and Fixes
5519
5520 =back
5521
5522 =item New or Changed Diagnostics
5523
5524 =item Source Code Enhancements
5525
5526 =over 4
5527
5528 =item MAGIC constants
5529
5530 =item Better commented code
5531
5532 =item Regex pre-/post-compilation items matched up
5533
5534 =item gcc -Wall
5535
5536 =back
5537
5538 =item New Tests
5539
5540 =item Known Problems
5541
5542 =over 4
5543
5544 =item AIX
5545
5546 =item Amiga Perl Invoking Mystery
5547
5548 =item lib/ftmp-security tests warn 'system possibly insecure'
5549
5550 =item Cygwin intermittent failures of lib/Memoize/t/expire_file 11 and 12
5551
5552 =item HP-UX lib/io_multihomed Fails When LP64-Configured
5553
5554 =item  HP-UX lib/posix Subtest 9 Fails When LP64-Configured
5555
5556 =item Linux With Sfio Fails op/misc Test 48
5557
5558 =item OS/390
5559
5560 =item op/sprintf tests 129 and 130
5561
5562 =item  Failure of Thread tests
5563
5564 =item UNICOS
5565
5566 =item UTS
5567
5568 =item VMS
5569
5570 =item Win32
5571
5572 =item Localising a Tied Variable Leaks Memory
5573
5574 =item Self-tying of Arrays and Hashes Is Forbidden
5575
5576 =item Variable Attributes are not Currently Usable for Tieing
5577
5578 =item Building Extensions Can Fail Because Of Largefiles
5579
5580 =item The Compiler Suite Is Still Experimental
5581
5582 =item The Long Double Support is Still Experimental
5583
5584 =back
5585
5586 =item Reporting Bugs
5587
5588 =item SEE ALSO
5589
5590 =item HISTORY
5591
5592 =back
5593
5594 =head2 perl571delta - what's new for perl v5.7.1
5595
5596 =over 4
5597
5598 =item DESCRIPTION
5599
5600 =item Security Vulnerability Closed
5601
5602 =item Incompatible Changes
5603
5604 =item Core Enhancements
5605
5606 =over 4
5607
5608 =item AUTOLOAD Is Now Lvaluable
5609
5610 =item PerlIO is Now The Default
5611
5612 =item Signals Are Now Safe
5613
5614 =back
5615
5616 =item Modules and Pragmata
5617
5618 =over 4
5619
5620 =item New Modules
5621
5622 =item Updated And Improved Modules and Pragmata
5623
5624 =back
5625
5626 =item Performance Enhancements
5627
5628 =item Utility Changes
5629
5630 =item New Documentation
5631
5632 =over 4
5633
5634 =item perlclib
5635
5636 =item perliol
5637
5638 =item README.aix
5639
5640 =item README.bs2000
5641
5642 =item README.macos
5643
5644 =item README.mpeix
5645
5646 =item README.solaris
5647
5648 =item README.vos
5649
5650 =item Porting/repository.pod
5651
5652 =back
5653
5654 =item Installation and Configuration Improvements
5655
5656 =over 4
5657
5658 =item New Or Improved Platforms
5659
5660 =item Generic Improvements
5661
5662 d_cmsghdr, d_fcntl_can_lock, d_fsync, d_getitimer, d_getpagsz, d_msghdr_s,
5663 need_va_copy, d_readv, d_recvmsg, d_sendmsg, sig_size, d_sockatmark,
5664 d_strtoq, d_u32align, d_ualarm, d_usleep
5665
5666 =back
5667
5668 =item Selected Bug Fixes
5669
5670 =over 4
5671
5672 =item Platform Specific Changes and Fixes
5673
5674 =back
5675
5676 =item New or Changed Diagnostics
5677
5678 =item Changed Internals
5679
5680 =item New Tests
5681
5682 =item Known Problems
5683
5684 =over 4
5685
5686 =item AIX vac 5.0.0.0 May Produce Buggy Code For Perl
5687
5688 =item lib/ftmp-security tests warn 'system possibly insecure'
5689
5690 =item lib/io_multihomed Fails In LP64-Configured HP-UX
5691
5692 =item Test lib/posix Subtest 9 Fails In LP64-Configured HP-UX
5693
5694 =item lib/b test 19
5695
5696 =item Linux With Sfio Fails op/misc Test 48
5697
5698 =item sigaction test 13 in VMS
5699
5700 =item sprintf tests 129 and 130
5701
5702 =item  Failure of Thread tests
5703
5704 =item Localising a Tied Variable Leaks Memory
5705
5706 =item Self-tying of Arrays and Hashes Is Forbidden
5707
5708 =item Building Extensions Can Fail Because Of Largefiles
5709
5710 =item The Compiler Suite Is Still Experimental
5711
5712 =back
5713
5714 =item Reporting Bugs
5715
5716 =item SEE ALSO
5717
5718 =item HISTORY
5719
5720 =back
5721
5722 =head2 perl570delta - what's new for perl v5.7.0
5723
5724 =over 4
5725
5726 =item DESCRIPTION
5727
5728 =item Security Vulnerability Closed
5729
5730 =item Incompatible Changes
5731
5732 =item Core Enhancements
5733
5734 =item Modules and Pragmata
5735
5736 =over 4
5737
5738 =item New Modules
5739
5740 =item Updated And Improved Modules and Pragmata
5741
5742 =back
5743
5744 =item Utility Changes
5745
5746 =item New Documentation
5747
5748 =item Performance Enhancements
5749
5750 =item Installation and Configuration Improvements
5751
5752 =over 4
5753
5754 =item Generic Improvements
5755
5756 =back
5757
5758 =item Selected Bug Fixes
5759
5760 =over 4
5761
5762 =item Platform Specific Changes and Fixes
5763
5764 =back
5765
5766 =item New or Changed Diagnostics
5767
5768 =item Changed Internals
5769
5770 =item Known Problems
5771
5772 =over 4
5773
5774 =item Unicode Support Still Far From Perfect
5775
5776 =item EBCDIC Still A Lost Platform
5777
5778 =item Building Extensions Can Fail Because Of Largefiles
5779
5780 =item ftmp-security tests warn 'system possibly insecure'
5781
5782 =item Test lib/posix Subtest 9 Fails In LP64-Configured HP-UX
5783
5784 =item Long Doubles Still Don't Work In Solaris
5785
5786 =item Linux With Sfio Fails op/misc Test 48
5787
5788 =item Storable tests fail in some platforms
5789
5790 =item Threads Are Still Experimental
5791
5792 =item The Compiler Suite Is Still Experimental
5793
5794 =back
5795
5796 =item Reporting Bugs
5797
5798 =item SEE ALSO
5799
5800 =item HISTORY
5801
5802 =back
5803
5804 =head2 perl561delta - what's new for perl v5.6.x
5805
5806 =over 4
5807
5808 =item DESCRIPTION
5809
5810 =item Summary of changes between 5.6.0 and 5.6.1
5811
5812 =over 4
5813
5814 =item Security Issues
5815
5816 =item Core bug fixes
5817
5818 C<UNIVERSAL::isa()>, Memory leaks, Numeric conversions, qw(a\\b), caller(),
5819 Bugs in regular expressions, "slurp" mode, Autovivification of symbolic
5820 references to special variables, Lexical warnings, Spurious warnings and
5821 errors, glob(), Tainting, sort(), #line directives, Subroutine prototypes,
5822 map(), Debugger, PERL5OPT, chop(), Unicode support, 64-bit support,
5823 Compiler, Lvalue subroutines, IO::Socket, File::Find, xsubpp, C<no
5824 Module;>, Tests
5825
5826 =item Core features
5827
5828 =item Configuration issues
5829
5830 =item Documentation
5831
5832 =item Bundled modules
5833
5834 B::Concise, File::Temp, Pod::LaTeX, Pod::Text::Overstrike, CGI, CPAN,
5835 Class::Struct, DB_File, Devel::Peek, File::Find, Getopt::Long, IO::Poll,
5836 IPC::Open3, Math::BigFloat, Math::Complex, Net::Ping, Opcode, Pod::Parser,
5837 Pod::Text, SDBM_File, Sys::Syslog, Tie::RefHash, Tie::SubstrHash
5838
5839 =item Platform-specific improvements
5840
5841 NCR MP-RAS, NonStop-UX
5842
5843 =back
5844
5845 =item Core Enhancements
5846
5847 =over 4
5848
5849 =item Interpreter cloning, threads, and concurrency
5850
5851 =item Lexically scoped warning categories
5852
5853 =item Unicode and UTF-8 support
5854
5855 =item Support for interpolating named characters
5856
5857 =item "our" declarations
5858
5859 =item Support for strings represented as a vector of ordinals
5860
5861 =item Improved Perl version numbering system
5862
5863 =item New syntax for declaring subroutine attributes
5864
5865 =item File and directory handles can be autovivified
5866
5867 =item open() with more than two arguments
5868
5869 =item 64-bit support
5870
5871 =item Large file support
5872
5873 =item Long doubles
5874
5875 =item "more bits"
5876
5877 =item Enhanced support for sort() subroutines
5878
5879 =item C<sort $coderef @foo> allowed
5880
5881 =item File globbing implemented internally
5882
5883 =item Support for CHECK blocks
5884
5885 =item POSIX character class syntax [: :] supported
5886
5887 =item Better pseudo-random number generator
5888
5889 =item Improved C<qw//> operator
5890
5891 =item Better worst-case behavior of hashes
5892
5893 =item pack() format 'Z' supported
5894
5895 =item pack() format modifier '!' supported
5896
5897 =item pack() and unpack() support counted strings
5898
5899 =item Comments in pack() templates
5900
5901 =item Weak references
5902
5903 =item Binary numbers supported
5904
5905 =item Lvalue subroutines
5906
5907 =item Some arrows may be omitted in calls through references
5908
5909 =item Boolean assignment operators are legal lvalues
5910
5911 =item exists() is supported on subroutine names
5912
5913 =item exists() and delete() are supported on array elements
5914
5915 =item Pseudo-hashes work better
5916
5917 =item Automatic flushing of output buffers
5918
5919 =item Better diagnostics on meaningless filehandle operations
5920
5921 =item Where possible, buffered data discarded from duped input filehandle
5922
5923 =item eof() has the same old magic as <>
5924
5925 =item binmode() can be used to set :crlf and :raw modes
5926
5927 =item C<-T> filetest recognizes UTF-8 encoded files as "text"
5928
5929 =item system(), backticks and pipe open now reflect exec() failure
5930
5931 =item Improved diagnostics
5932
5933 =item Diagnostics follow STDERR
5934
5935 =item More consistent close-on-exec behavior
5936
5937 =item syswrite() ease-of-use
5938
5939 =item Better syntax checks on parenthesized unary operators
5940
5941 =item Bit operators support full native integer width
5942
5943 =item Improved security features
5944
5945 =item More functional bareword prototype (*)
5946
5947 =item C<require> and C<do> may be overridden
5948
5949 =item $^X variables may now have names longer than one character
5950
5951 =item New variable $^C reflects C<-c> switch
5952
5953 =item New variable $^V contains Perl version as a string
5954
5955 =item Optional Y2K warnings
5956
5957 =item Arrays now always interpolate into double-quoted strings
5958
5959 =back
5960
5961 =item Modules and Pragmata
5962
5963 =over 4
5964
5965 =item Modules
5966
5967 attributes, B, Benchmark, ByteLoader, constant, charnames, Data::Dumper,
5968 DB, DB_File, Devel::DProf, Devel::Peek, Dumpvalue, DynaLoader, English,
5969 Env, Fcntl, File::Compare, File::Find, File::Glob, File::Spec,
5970 File::Spec::Functions, Getopt::Long, IO, JPL, lib, Math::BigInt,
5971 Math::Complex, Math::Trig, Pod::Parser, Pod::InputObjects, Pod::Checker,
5972 podchecker, Pod::ParseUtils, Pod::Find, Pod::Select, podselect, Pod::Usage,
5973 pod2usage, Pod::Text and Pod::Man, SDBM_File, Sys::Syslog, Sys::Hostname,
5974 Term::ANSIColor, Time::Local, Win32, XSLoader, DBM Filters
5975
5976 =item Pragmata
5977
5978 =back
5979
5980 =item Utility Changes
5981
5982 =over 4
5983
5984 =item dprofpp
5985
5986 =item find2perl
5987
5988 =item h2xs
5989
5990 =item perlcc
5991
5992 =item perldoc
5993
5994 =item The Perl Debugger
5995
5996 =back
5997
5998 =item Improved Documentation
5999
6000 perlapi.pod, perlboot.pod, perlcompile.pod, perldbmfilter.pod,
6001 perldebug.pod, perldebguts.pod, perlfork.pod, perlfilter.pod, perlhack.pod,
6002 perlintern.pod, perllexwarn.pod, perlnumber.pod, perlopentut.pod,
6003 perlreftut.pod, perltootc.pod, perltodo.pod, perlunicode.pod
6004
6005 =item Performance enhancements
6006
6007 =over 4
6008
6009 =item Simple sort() using { $a <=> $b } and the like are optimized
6010
6011 =item Optimized assignments to lexical variables
6012
6013 =item Faster subroutine calls
6014
6015 =item delete(), each(), values() and hash iteration are faster
6016
6017 =back
6018
6019 =item Installation and Configuration Improvements
6020
6021 =over 4
6022
6023 =item -Dusethreads means something different
6024
6025 =item New Configure flags
6026
6027 =item Threadedness and 64-bitness now more daring
6028
6029 =item Long Doubles
6030
6031 =item -Dusemorebits
6032
6033 =item -Duselargefiles
6034
6035 =item installusrbinperl
6036
6037 =item SOCKS support
6038
6039 =item C<-A> flag
6040
6041 =item Enhanced Installation Directories
6042
6043 =item gcc automatically tried if 'cc' does not seem to be working
6044
6045 =back
6046
6047 =item Platform specific changes
6048
6049 =over 4
6050
6051 =item Supported platforms
6052
6053 =item DOS
6054
6055 =item OS390 (OpenEdition MVS)
6056
6057 =item VMS
6058
6059 =item Win32
6060
6061 =back
6062
6063 =item Significant bug fixes
6064
6065 =over 4
6066
6067 =item <HANDLE> on empty files
6068
6069 =item C<eval '...'> improvements
6070
6071 =item All compilation errors are true errors
6072
6073 =item Implicitly closed filehandles are safer
6074
6075 =item Behavior of list slices is more consistent
6076
6077 =item C<(\$)> prototype and C<$foo{a}>
6078
6079 =item C<goto &sub> and AUTOLOAD
6080
6081 =item C<-bareword> allowed under C<use integer>
6082
6083 =item Failures in DESTROY()
6084
6085 =item Locale bugs fixed
6086
6087 =item Memory leaks
6088
6089 =item Spurious subroutine stubs after failed subroutine calls
6090
6091 =item Taint failures under C<-U>
6092
6093 =item END blocks and the C<-c> switch
6094
6095 =item Potential to leak DATA filehandles
6096
6097 =back
6098
6099 =item New or Changed Diagnostics
6100
6101 "%s" variable %s masks earlier declaration in same %s, "my sub" not yet
6102 implemented, "our" variable %s redeclared, '!' allowed only after types %s,
6103 / cannot take a count, / must be followed by a, A or Z, / must be followed
6104 by a*, A* or Z*, / must follow a numeric type, /%s/: Unrecognized escape
6105 \\%c passed through, /%s/: Unrecognized escape \\%c in character class
6106 passed through, /%s/ should probably be written as "%s", %s() called too
6107 early to check prototype, %s argument is not a HASH or ARRAY element, %s
6108 argument is not a HASH or ARRAY element or slice, %s argument is not a
6109 subroutine name, %s package attribute may clash with future reserved word:
6110 %s, (in cleanup) %s, <> should be quotes, Attempt to join self, Bad evalled
6111 substitution pattern, Bad realloc() ignored, Bareword found in conditional,
6112 Binary number > 0b11111111111111111111111111111111 non-portable, Bit vector
6113 size > 32 non-portable, Buffer overflow in prime_env_iter: %s, Can't check
6114 filesystem of script "%s", Can't declare class for non-scalar %s in "%s",
6115 Can't declare %s in "%s", Can't ignore signal CHLD, forcing to default,
6116 Can't modify non-lvalue subroutine call, Can't read CRTL environ, Can't
6117 remove %s: %s, skipping file, Can't return %s from lvalue subroutine, Can't
6118 weaken a nonreference, Character class [:%s:] unknown, Character class
6119 syntax [%s] belongs inside character classes, Constant is not %s reference,
6120 constant(%s): %s, CORE::%s is not a keyword, defined(@array) is deprecated,
6121 defined(%hash) is deprecated, Did not produce a valid header, (Did you mean
6122 "local" instead of "our"?), Document contains no data, entering effective
6123 %s failed, false [] range "%s" in regexp, Filehandle %s opened only for
6124 output, flock() on closed filehandle %s, Global symbol "%s" requires
6125 explicit package name, Hexadecimal number > 0xffffffff non-portable,
6126 Ill-formed CRTL environ value "%s", Ill-formed message in prime_env_iter:
6127 |%s|, Illegal binary digit %s, Illegal binary digit %s ignored, Illegal
6128 number of bits in vec, Integer overflow in %s number, Invalid %s attribute:
6129 %s, Invalid %s attributes: %s, invalid [] range "%s" in regexp, Invalid
6130 separator character %s in attribute list, Invalid separator character %s in
6131 subroutine attribute list, leaving effective %s failed, Lvalue subs
6132 returning %s not implemented yet, Method %s not permitted, Missing
6133 %sbrace%s on \N{}, Missing command in piped open, Missing name in "my sub",
6134 No %s specified for -%c, No package name allowed for variable %s in "our",
6135 No space allowed after -%c, no UTC offset information; assuming local time
6136 is UTC, Octal number > 037777777777 non-portable, panic: del_backref,
6137 panic: kid popen errno read, panic: magic_killbackrefs, Parentheses missing
6138 around "%s" list, Possible unintended interpolation of %s in string,
6139 Possible Y2K bug: %s, pragma "attrs" is deprecated, use "sub NAME : ATTRS"
6140 instead, Premature end of script headers, Repeat count in pack overflows,
6141 Repeat count in unpack overflows, realloc() of freed memory ignored,
6142 Reference is already weak, setpgrp can't take arguments, Strange *+?{} on
6143 zero-length expression, switching effective %s is not implemented, This
6144 Perl can't reset CRTL environ elements (%s), This Perl can't set CRTL
6145 environ elements (%s=%s), Too late to run %s block, Unknown open() mode
6146 '%s', Unknown process %x sent message to prime_env_iter: %s, Unrecognized
6147 escape \\%c passed through, Unterminated attribute parameter in attribute
6148 list, Unterminated attribute list, Unterminated attribute parameter in
6149 subroutine attribute list, Unterminated subroutine attribute list, Value of
6150 CLI symbol "%s" too long, Version number must be a constant number
6151
6152 =item New tests
6153
6154 =item Incompatible Changes
6155
6156 =over 4
6157
6158 =item Perl Source Incompatibilities
6159
6160 CHECK is a new keyword, Treatment of list slices of undef has changed,
6161 Format of $English::PERL_VERSION is different, Literals of the form
6162 C<1.2.3> parse differently, Possibly changed pseudo-random number
6163 generator, Hashing function for hash keys has changed, C<undef> fails on
6164 read only values, Close-on-exec bit may be set on pipe and socket handles,
6165 Writing C<"$$1"> to mean C<"${$}1"> is unsupported, delete(), each(),
6166 values() and C<\(%h)>, vec(EXPR,OFFSET,BITS) enforces powers-of-two BITS,
6167 Text of some diagnostic output has changed, C<%@> has been removed,
6168 Parenthesized not() behaves like a list operator, Semantics of bareword
6169 prototype C<(*)> have changed, Semantics of bit operators may have changed
6170 on 64-bit platforms, More builtins taint their results
6171
6172 =item C Source Incompatibilities
6173
6174 C<PERL_POLLUTE>, C<PERL_IMPLICIT_CONTEXT>, C<PERL_POLLUTE_MALLOC>
6175
6176 =item Compatible C Source API Changes
6177
6178 C<PATCHLEVEL> is now C<PERL_VERSION>
6179
6180 =item Binary Incompatibilities
6181
6182 =back
6183
6184 =item Known Problems
6185
6186 =over 4
6187
6188 =item Localizing a tied hash element may leak memory
6189
6190 =item Known test failures
6191
6192 =item EBCDIC platforms not fully supported
6193
6194 =item UNICOS/mk CC failures during Configure run
6195
6196 =item Arrow operator and arrays
6197
6198 =item Experimental features
6199
6200 Threads, Unicode, 64-bit support, Lvalue subroutines, Weak references, The
6201 pseudo-hash data type, The Compiler suite, Internal implementation of file
6202 globbing, The DB module, The regular expression code constructs:
6203
6204 =back
6205
6206 =item Obsolete Diagnostics
6207
6208 Character class syntax [: :] is reserved for future extensions, Ill-formed
6209 logical name |%s| in prime_env_iter, In string, @%s now must be written as
6210 \@%s, Probable precedence problem on %s, regexp too big, Use of "$$<digit>"
6211 to mean "${$}<digit>" is deprecated
6212
6213 =item Reporting Bugs
6214
6215 =item SEE ALSO
6216
6217 =item HISTORY
6218
6219 =back
6220
6221 =head2 perl56delta - what's new for perl v5.6.0
6222
6223 =over 4
6224
6225 =item DESCRIPTION
6226
6227 =item Core Enhancements
6228
6229 =over 4
6230
6231 =item Interpreter cloning, threads, and concurrency
6232
6233 =item Lexically scoped warning categories
6234
6235 =item Unicode and UTF-8 support
6236
6237 =item Support for interpolating named characters
6238
6239 =item "our" declarations
6240
6241 =item Support for strings represented as a vector of ordinals
6242
6243 =item Improved Perl version numbering system
6244
6245 =item New syntax for declaring subroutine attributes
6246
6247 =item File and directory handles can be autovivified
6248
6249 =item open() with more than two arguments
6250
6251 =item 64-bit support
6252
6253 =item Large file support
6254
6255 =item Long doubles
6256
6257 =item "more bits"
6258
6259 =item Enhanced support for sort() subroutines
6260
6261 =item C<sort $coderef @foo> allowed
6262
6263 =item File globbing implemented internally
6264
6265 =item Support for CHECK blocks
6266
6267 =item POSIX character class syntax [: :] supported
6268
6269 =item Better pseudo-random number generator
6270
6271 =item Improved C<qw//> operator
6272
6273 =item Better worst-case behavior of hashes
6274
6275 =item pack() format 'Z' supported
6276
6277 =item pack() format modifier '!' supported
6278
6279 =item pack() and unpack() support counted strings
6280
6281 =item Comments in pack() templates
6282
6283 =item Weak references
6284
6285 =item Binary numbers supported
6286
6287 =item Lvalue subroutines
6288
6289 =item Some arrows may be omitted in calls through references
6290
6291 =item Boolean assignment operators are legal lvalues
6292
6293 =item exists() is supported on subroutine names
6294
6295 =item exists() and delete() are supported on array elements
6296
6297 =item Pseudo-hashes work better
6298
6299 =item Automatic flushing of output buffers
6300
6301 =item Better diagnostics on meaningless filehandle operations
6302
6303 =item Where possible, buffered data discarded from duped input filehandle
6304
6305 =item eof() has the same old magic as <>
6306
6307 =item binmode() can be used to set :crlf and :raw modes
6308
6309 =item C<-T> filetest recognizes UTF-8 encoded files as "text"
6310
6311 =item system(), backticks and pipe open now reflect exec() failure
6312
6313 =item Improved diagnostics
6314
6315 =item Diagnostics follow STDERR
6316
6317 =item More consistent close-on-exec behavior
6318
6319 =item syswrite() ease-of-use
6320
6321 =item Better syntax checks on parenthesized unary operators
6322
6323 =item Bit operators support full native integer width
6324
6325 =item Improved security features
6326
6327 =item More functional bareword prototype (*)
6328
6329 =item C<require> and C<do> may be overridden
6330
6331 =item $^X variables may now have names longer than one character
6332
6333 =item New variable $^C reflects C<-c> switch
6334
6335 =item New variable $^V contains Perl version as a string
6336
6337 =item Optional Y2K warnings
6338
6339 =item Arrays now always interpolate into double-quoted strings
6340
6341 =back
6342
6343 =item Modules and Pragmata
6344
6345 =over 4
6346
6347 =item Modules
6348
6349 attributes, B, Benchmark, ByteLoader, constant, charnames, Data::Dumper,
6350 DB, DB_File, Devel::DProf, Devel::Peek, Dumpvalue, DynaLoader, English,
6351 Env, Fcntl, File::Compare, File::Find, File::Glob, File::Spec,
6352 File::Spec::Functions, Getopt::Long, IO, JPL, lib, Math::BigInt,
6353 Math::Complex, Math::Trig, Pod::Parser, Pod::InputObjects, Pod::Checker,
6354 podchecker, Pod::ParseUtils, Pod::Find, Pod::Select, podselect, Pod::Usage,
6355 pod2usage, Pod::Text and Pod::Man, SDBM_File, Sys::Syslog, Sys::Hostname,
6356 Term::ANSIColor, Time::Local, Win32, XSLoader, DBM Filters
6357
6358 =item Pragmata
6359
6360 =back
6361
6362 =item Utility Changes
6363
6364 =over 4
6365
6366 =item dprofpp
6367
6368 =item find2perl
6369
6370 =item h2xs
6371
6372 =item perlcc
6373
6374 =item perldoc
6375
6376 =item The Perl Debugger
6377
6378 =back
6379
6380 =item Improved Documentation
6381
6382 perlapi.pod, perlboot.pod, perlcompile.pod, perldbmfilter.pod,
6383 perldebug.pod, perldebguts.pod, perlfork.pod, perlfilter.pod, perlhack.pod,
6384 perlintern.pod, perllexwarn.pod, perlnumber.pod, perlopentut.pod,
6385 perlreftut.pod, perltootc.pod, perltodo.pod, perlunicode.pod
6386
6387 =item Performance enhancements
6388
6389 =over 4
6390
6391 =item Simple sort() using { $a <=> $b } and the like are optimized
6392
6393 =item Optimized assignments to lexical variables
6394
6395 =item Faster subroutine calls
6396
6397 =item delete(), each(), values() and hash iteration are faster
6398
6399 =back
6400
6401 =item Installation and Configuration Improvements
6402
6403 =over 4
6404
6405 =item -Dusethreads means something different
6406
6407 =item New Configure flags
6408
6409 =item Threadedness and 64-bitness now more daring
6410
6411 =item Long Doubles
6412
6413 =item -Dusemorebits
6414
6415 =item -Duselargefiles
6416
6417 =item installusrbinperl
6418
6419 =item SOCKS support
6420
6421 =item C<-A> flag
6422
6423 =item Enhanced Installation Directories
6424
6425 =back
6426
6427 =item Platform specific changes
6428
6429 =over 4
6430
6431 =item Supported platforms
6432
6433 =item DOS
6434
6435 =item OS390 (OpenEdition MVS)
6436
6437 =item VMS
6438
6439 =item Win32
6440
6441 =back
6442
6443 =item Significant bug fixes
6444
6445 =over 4
6446
6447 =item <HANDLE> on empty files
6448
6449 =item C<eval '...'> improvements
6450
6451 =item All compilation errors are true errors
6452
6453 =item Implicitly closed filehandles are safer
6454
6455 =item Behavior of list slices is more consistent
6456
6457 =item C<(\$)> prototype and C<$foo{a}>
6458
6459 =item C<goto &sub> and AUTOLOAD
6460
6461 =item C<-bareword> allowed under C<use integer>
6462
6463 =item Failures in DESTROY()
6464
6465 =item Locale bugs fixed
6466
6467 =item Memory leaks
6468
6469 =item Spurious subroutine stubs after failed subroutine calls
6470
6471 =item Taint failures under C<-U>
6472
6473 =item END blocks and the C<-c> switch
6474
6475 =item Potential to leak DATA filehandles
6476
6477 =back
6478
6479 =item New or Changed Diagnostics
6480
6481 "%s" variable %s masks earlier declaration in same %s, "my sub" not yet
6482 implemented, "our" variable %s redeclared, '!' allowed only after types %s,
6483 / cannot take a count, / must be followed by a, A or Z, / must be followed
6484 by a*, A* or Z*, / must follow a numeric type, /%s/: Unrecognized escape
6485 \\%c passed through, /%s/: Unrecognized escape \\%c in character class
6486 passed through, /%s/ should probably be written as "%s", %s() called too
6487 early to check prototype, %s argument is not a HASH or ARRAY element, %s
6488 argument is not a HASH or ARRAY element or slice, %s argument is not a
6489 subroutine name, %s package attribute may clash with future reserved word:
6490 %s, (in cleanup) %s, <> should be quotes, Attempt to join self, Bad evalled
6491 substitution pattern, Bad realloc() ignored, Bareword found in conditional,
6492 Binary number > 0b11111111111111111111111111111111 non-portable, Bit vector
6493 size > 32 non-portable, Buffer overflow in prime_env_iter: %s, Can't check
6494 filesystem of script "%s", Can't declare class for non-scalar %s in "%s",
6495 Can't declare %s in "%s", Can't ignore signal CHLD, forcing to default,
6496 Can't modify non-lvalue subroutine call, Can't read CRTL environ, Can't
6497 remove %s: %s, skipping file, Can't return %s from lvalue subroutine, Can't
6498 weaken a nonreference, Character class [:%s:] unknown, Character class
6499 syntax [%s] belongs inside character classes, Constant is not %s reference,
6500 constant(%s): %s, CORE::%s is not a keyword, defined(@array) is deprecated,
6501 defined(%hash) is deprecated, Did not produce a valid header, (Did you mean
6502 "local" instead of "our"?), Document contains no data, entering effective
6503 %s failed, false [] range "%s" in regexp, Filehandle %s opened only for
6504 output, flock() on closed filehandle %s, Global symbol "%s" requires
6505 explicit package name, Hexadecimal number > 0xffffffff non-portable,
6506 Ill-formed CRTL environ value "%s", Ill-formed message in prime_env_iter:
6507 |%s|, Illegal binary digit %s, Illegal binary digit %s ignored, Illegal
6508 number of bits in vec, Integer overflow in %s number, Invalid %s attribute:
6509 %s, Invalid %s attributes: %s, invalid [] range "%s" in regexp, Invalid
6510 separator character %s in attribute list, Invalid separator character %s in
6511 subroutine attribute list, leaving effective %s failed, Lvalue subs
6512 returning %s not implemented yet, Method %s not permitted, Missing
6513 %sbrace%s on \N{}, Missing command in piped open, Missing name in "my sub",
6514 No %s specified for -%c, No package name allowed for variable %s in "our",
6515 No space allowed after -%c, no UTC offset information; assuming local time
6516 is UTC, Octal number > 037777777777 non-portable, panic: del_backref,
6517 panic: kid popen errno read, panic: magic_killbackrefs, Parentheses missing
6518 around "%s" list, Possible unintended interpolation of %s in string,
6519 Possible Y2K bug: %s, pragma "attrs" is deprecated, use "sub NAME : ATTRS"
6520 instead, Premature end of script headers, Repeat count in pack overflows,
6521 Repeat count in unpack overflows, realloc() of freed memory ignored,
6522 Reference is already weak, setpgrp can't take arguments, Strange *+?{} on
6523 zero-length expression, switching effective %s is not implemented, This
6524 Perl can't reset CRTL environ elements (%s), This Perl can't set CRTL
6525 environ elements (%s=%s), Too late to run %s block, Unknown open() mode
6526 '%s', Unknown process %x sent message to prime_env_iter: %s, Unrecognized
6527 escape \\%c passed through, Unterminated attribute parameter in attribute
6528 list, Unterminated attribute list, Unterminated attribute parameter in
6529 subroutine attribute list, Unterminated subroutine attribute list, Value of
6530 CLI symbol "%s" too long, Version number must be a constant number
6531
6532 =item New tests
6533
6534 =item Incompatible Changes
6535
6536 =over 4
6537
6538 =item Perl Source Incompatibilities
6539
6540 CHECK is a new keyword, Treatment of list slices of undef has changed,
6541 Format of $English::PERL_VERSION is different, Literals of the form
6542 C<1.2.3> parse differently, Possibly changed pseudo-random number
6543 generator, Hashing function for hash keys has changed, C<undef> fails on
6544 read only values, Close-on-exec bit may be set on pipe and socket handles,
6545 Writing C<"$$1"> to mean C<"${$}1"> is unsupported, delete(), each(),
6546 values() and C<\(%h)>, vec(EXPR,OFFSET,BITS) enforces powers-of-two BITS,
6547 Text of some diagnostic output has changed, C<%@> has been removed,
6548 Parenthesized not() behaves like a list operator, Semantics of bareword
6549 prototype C<(*)> have changed, Semantics of bit operators may have changed
6550 on 64-bit platforms, More builtins taint their results
6551
6552 =item C Source Incompatibilities
6553
6554 C<PERL_POLLUTE>, C<PERL_IMPLICIT_CONTEXT>, C<PERL_POLLUTE_MALLOC>
6555
6556 =item Compatible C Source API Changes
6557
6558 C<PATCHLEVEL> is now C<PERL_VERSION>
6559
6560 =item Binary Incompatibilities
6561
6562 =back
6563
6564 =item Known Problems
6565
6566 =over 4
6567
6568 =item Thread test failures
6569
6570 =item EBCDIC platforms not supported
6571
6572 =item In 64-bit HP-UX the lib/io_multihomed test may hang
6573
6574 =item NEXTSTEP 3.3 POSIX test failure
6575
6576 =item Tru64 (aka Digital UNIX, aka DEC OSF/1) lib/sdbm test failure with
6577 gcc
6578
6579 =item UNICOS/mk CC failures during Configure run
6580
6581 =item Arrow operator and arrays
6582
6583 =item Experimental features
6584
6585 Threads, Unicode, 64-bit support, Lvalue subroutines, Weak references, The
6586 pseudo-hash data type, The Compiler suite, Internal implementation of file
6587 globbing, The DB module, The regular expression code constructs:
6588
6589 =back
6590
6591 =item Obsolete Diagnostics
6592
6593 Character class syntax [: :] is reserved for future extensions, Ill-formed
6594 logical name |%s| in prime_env_iter, In string, @%s now must be written as
6595 \@%s, Probable precedence problem on %s, regexp too big, Use of "$$<digit>"
6596 to mean "${$}<digit>" is deprecated
6597
6598 =item Reporting Bugs
6599
6600 =item SEE ALSO
6601
6602 =item HISTORY
6603
6604 =back
6605
6606 =head2 perl5005delta - what's new for perl5.005
6607
6608 =over 4
6609
6610 =item DESCRIPTION
6611
6612 =item About the new versioning system
6613
6614 =item Incompatible Changes
6615
6616 =over 4
6617
6618 =item WARNING:  This version is not binary compatible with Perl 5.004.
6619
6620 =item Default installation structure has changed
6621
6622 =item Perl Source Compatibility
6623
6624 =item C Source Compatibility
6625
6626 =item Binary Compatibility
6627
6628 =item Security fixes may affect compatibility
6629
6630 =item Relaxed new mandatory warnings introduced in 5.004
6631
6632 =item Licensing
6633
6634 =back
6635
6636 =item Core Changes
6637
6638 =over 4
6639
6640 =item Threads
6641
6642 =item Compiler
6643
6644 =item Regular Expressions
6645
6646 Many new and improved optimizations, Many bug fixes, New regular expression
6647 constructs, New operator for precompiled regular expressions, Other
6648 improvements, Incompatible changes
6649
6650 =item   Improved malloc()
6651
6652 =item Quicksort is internally implemented
6653
6654 =item Reliable signals
6655
6656 =item Reliable stack pointers
6657
6658 =item More generous treatment of carriage returns
6659
6660 =item Memory leaks
6661
6662 =item Better support for multiple interpreters
6663
6664 =item Behavior of local() on array and hash elements is now well-defined
6665
6666 =item C<%!> is transparently tied to the L<Errno> module
6667
6668 =item Pseudo-hashes are supported
6669
6670 =item C<EXPR foreach EXPR> is supported
6671
6672 =item Keywords can be globally overridden
6673
6674 =item C<$^E> is meaningful on Win32
6675
6676 =item C<foreach (1..1000000)> optimized
6677
6678 =item C<Foo::> can be used as implicitly quoted package name
6679
6680 =item C<exists $Foo::{Bar::}> tests existence of a package
6681
6682 =item Better locale support
6683
6684 =item Experimental support for 64-bit platforms
6685
6686 =item prototype() returns useful results on builtins
6687
6688 =item Extended support for exception handling
6689
6690 =item Re-blessing in DESTROY() supported for chaining DESTROY() methods
6691
6692 =item All C<printf> format conversions are handled internally
6693
6694 =item New C<INIT> keyword
6695
6696 =item New C<lock> keyword
6697
6698 =item New C<qr//> operator
6699
6700 =item C<our> is now a reserved word
6701
6702 =item Tied arrays are now fully supported
6703
6704 =item Tied handles support is better
6705
6706 =item 4th argument to substr
6707
6708 =item Negative LENGTH argument to splice
6709
6710 =item Magic lvalues are now more magical
6711
6712 =item <> now reads in records
6713
6714 =back
6715
6716 =item Supported Platforms
6717
6718 =over 4
6719
6720 =item New Platforms
6721
6722 =item Changes in existing support
6723
6724 =back
6725
6726 =item Modules and Pragmata
6727
6728 =over 4
6729
6730 =item New Modules
6731
6732 B, Data::Dumper, Dumpvalue, Errno, File::Spec, ExtUtils::Installed,
6733 ExtUtils::Packlist, Fatal, IPC::SysV, Test, Tie::Array, Tie::Handle,
6734 Thread, attrs, fields, re
6735
6736 =item Changes in existing modules
6737
6738 Benchmark, Carp, CGI, Fcntl, Math::Complex, Math::Trig, POSIX, DB_File,
6739 MakeMaker, CPAN, Cwd
6740
6741 =back
6742
6743 =item Utility Changes
6744
6745 =item Documentation Changes
6746
6747 =item New Diagnostics
6748
6749 Ambiguous call resolved as CORE::%s(), qualify as such or use &, Bad index
6750 while coercing array into hash, Bareword "%s" refers to nonexistent
6751 package, Can't call method "%s" on an undefined value, Can't check
6752 filesystem of script "%s" for nosuid, Can't coerce array into hash, Can't
6753 goto subroutine from an eval-string, Can't localize pseudo-hash element,
6754 Can't use %%! because Errno.pm is not available, Cannot find an opnumber
6755 for "%s", Character class syntax [. .] is reserved for future extensions,
6756 Character class syntax [: :] is reserved for future extensions, Character
6757 class syntax [= =] is reserved for future extensions, %s: Eval-group in
6758 insecure regular expression, %s: Eval-group not allowed, use re 'eval', %s:
6759 Eval-group not allowed at run time, Explicit blessing to '' (assuming
6760 package main), Illegal hex digit ignored, No such array field, No such
6761 field "%s" in variable %s of type %s, Out of memory during ridiculously
6762 large request, Range iterator outside integer range, Recursive inheritance
6763 detected while looking for method '%s' %s, Reference found where even-sized
6764 list expected, Undefined value assigned to typeglob, Use of reserved word
6765 "%s" is deprecated, perl: warning: Setting locale failed
6766
6767 =item Obsolete Diagnostics
6768
6769 Can't mktemp(), Can't write to temp file for B<-e>: %s, Cannot open
6770 temporary file, regexp too big
6771
6772 =item Configuration Changes
6773
6774 =item BUGS
6775
6776 =item SEE ALSO
6777
6778 =item HISTORY
6779
6780 =back
6781
6782 =head2 perl5004delta - what's new for perl5.004
6783
6784 =over 4
6785
6786 =item DESCRIPTION
6787
6788 =item Supported Environments
6789
6790 =item Core Changes
6791
6792 =over 4
6793
6794 =item List assignment to %ENV works
6795
6796 =item Change to "Can't locate Foo.pm in @INC" error
6797
6798 =item Compilation option: Binary compatibility with 5.003
6799
6800 =item $PERL5OPT environment variable
6801
6802 =item Limitations on B<-M>, B<-m>, and B<-T> options
6803
6804 =item More precise warnings
6805
6806 =item Deprecated: Inherited C<AUTOLOAD> for non-methods
6807
6808 =item Previously deprecated %OVERLOAD is no longer usable
6809
6810 =item Subroutine arguments created only when they're modified
6811
6812 =item Group vector changeable with C<$)>
6813
6814 =item Fixed parsing of $$<digit>, &$<digit>, etc.
6815
6816 =item Fixed localization of $<digit>, $&, etc.
6817
6818 =item No resetting of $. on implicit close
6819
6820 =item C<wantarray> may return undef
6821
6822 =item C<eval EXPR> determines value of EXPR in scalar context
6823
6824 =item Changes to tainting checks
6825
6826 No glob() or <*>, No spawning if tainted $CDPATH, $ENV, $BASH_ENV, No
6827 spawning if tainted $TERM doesn't look like a terminal name
6828
6829 =item New Opcode module and revised Safe module
6830
6831 =item Embedding improvements
6832
6833 =item Internal change: FileHandle class based on IO::* classes
6834
6835 =item Internal change: PerlIO abstraction interface
6836
6837 =item New and changed syntax
6838
6839 $coderef->(PARAMS)
6840
6841 =item New and changed builtin constants
6842
6843 __PACKAGE__
6844
6845 =item New and changed builtin variables
6846
6847 $^E, $^H, $^M
6848
6849 =item New and changed builtin functions
6850
6851 delete on slices, flock, printf and sprintf, keys as an lvalue, my() in
6852 Control Structures, pack() and unpack(), sysseek(), use VERSION, use Module
6853 VERSION LIST, prototype(FUNCTION), srand, $_ as Default, C<m//gc> does not
6854 reset search position on failure, C<m//x> ignores whitespace before ?*+{},
6855 nested C<sub{}> closures work now, formats work right on changing lexicals
6856
6857 =item New builtin methods
6858
6859 isa(CLASS), can(METHOD), VERSION( [NEED] )
6860
6861 =item TIEHANDLE now supported
6862
6863 TIEHANDLE classname, LIST, PRINT this, LIST, PRINTF this, LIST, READ this
6864 LIST, READLINE this, GETC this, DESTROY this
6865
6866 =item Malloc enhancements
6867
6868 -DPERL_EMERGENCY_SBRK, -DPACK_MALLOC, -DTWO_POT_OPTIMIZE
6869
6870 =item Miscellaneous efficiency enhancements
6871
6872 =back
6873
6874 =item Support for More Operating Systems
6875
6876 =over 4
6877
6878 =item Win32
6879
6880 =item Plan 9
6881
6882 =item QNX
6883
6884 =item AmigaOS
6885
6886 =back
6887
6888 =item Pragmata
6889
6890 use autouse MODULE => qw(sub1 sub2 sub3), use blib, use blib 'dir', use
6891 constant NAME => VALUE, use locale, use ops, use vmsish
6892
6893 =item Modules
6894
6895 =over 4
6896
6897 =item Required Updates
6898
6899 =item Installation directories
6900
6901 =item Module information summary
6902
6903 =item Fcntl
6904
6905 =item IO
6906
6907 =item Math::Complex
6908
6909 =item Math::Trig
6910
6911 =item DB_File
6912
6913 =item Net::Ping
6914
6915 =item Object-oriented overrides for builtin operators
6916
6917 =back
6918
6919 =item Utility Changes
6920
6921 =over 4
6922
6923 =item pod2html
6924
6925 Sends converted HTML to standard output
6926
6927 =item xsubpp
6928
6929 C<void> XSUBs now default to returning nothing
6930
6931 =back
6932
6933 =item C Language API Changes
6934
6935 C<gv_fetchmethod> and C<perl_call_sv>, C<perl_eval_pv>, Extended API for
6936 manipulating hashes
6937
6938 =item Documentation Changes
6939
6940 L<perldelta>, L<perlfaq>, L<perllocale>, L<perltoot>, L<perlapio>,
6941 L<perlmodlib>, L<perldebug>, L<perlsec>
6942
6943 =item New Diagnostics
6944
6945 "my" variable %s masks earlier declaration in same scope, %s argument is
6946 not a HASH element or slice, Allocation too large: %lx, Allocation too
6947 large, Applying %s to %s will act on scalar(%s), Attempt to free
6948 nonexistent shared string, Attempt to use reference as lvalue in substr,
6949 Bareword "%s" refers to nonexistent package, Can't redefine active sort
6950 subroutine %s, Can't use bareword ("%s") as %s ref while "strict refs" in
6951 use, Cannot resolve method `%s' overloading `%s' in package `%s', Constant
6952 subroutine %s redefined, Constant subroutine %s undefined, Copy method did
6953 not return a reference, Died, Exiting pseudo-block via %s, Identifier too
6954 long, Illegal character %s (carriage return), Illegal switch in PERL5OPT:
6955 %s, Integer overflow in hex number, Integer overflow in octal number,
6956 internal error: glob failed, Invalid conversion in %s: "%s", Invalid type
6957 in pack: '%s', Invalid type in unpack: '%s', Name "%s::%s" used only once:
6958 possible typo, Null picture in formline, Offset outside string, Out of
6959 memory!, Out of memory during request for %s, panic: frexp, Possible
6960 attempt to put comments in qw() list, Possible attempt to separate words
6961 with commas, Scalar value @%s{%s} better written as $%s{%s}, Stub found
6962 while resolving method `%s' overloading `%s' in %s, Too late for "B<-T>"
6963 option, untie attempted while %d inner references still exist, Unrecognized
6964 character %s, Unsupported function fork, Use of "$$<digit>" to mean
6965 "${$}<digit>" is deprecated, Value of %s can be "0"; test with defined(),
6966 Variable "%s" may be unavailable, Variable "%s" will not stay shared,
6967 Warning: something's wrong, Ill-formed logical name |%s| in prime_env_iter,
6968 Got an error from DosAllocMem, Malformed PERLLIB_PREFIX, PERL_SH_DIR too
6969 long, Process terminated by SIG%s
6970
6971 =item BUGS
6972
6973 =item SEE ALSO
6974
6975 =item HISTORY
6976
6977 =back
6978
6979 =head2 perlaix, README.aix - Perl version 5 on IBM Unix (AIX) systems
6980
6981 =over 4
6982
6983 =item DESCRIPTION
6984
6985 =over 4
6986
6987 =item Compiling Perl 5 on AIX
6988
6989 =item OS level
6990
6991 =item Building Dynamic Extensions on AIX
6992
6993 =item The IBM ANSI C Compiler
6994
6995 =item Using GNU's gcc for building perl
6996
6997 =item Using Large Files with Perl
6998
6999 =item Threaded Perl
7000
7001 =item 64-bit Perl
7002
7003 =item AIX 4.2 and extensions using C++ with statics
7004
7005 =back
7006
7007 =item AUTHOR
7008
7009 =item DATE
7010
7011 =back
7012
7013 =head2 perlapollo, README.apollo - Perl version 5 on Apollo DomainOS
7014
7015 =over 4
7016
7017 =item DESCRIPTION
7018
7019 =item AUTHOR
7020
7021 =back
7022
7023 =head2 perlamiga - Perl under Amiga OS
7024
7025 =over 4
7026
7027 =item NOTE
7028
7029 =item SYNOPSIS
7030
7031 =back
7032
7033 =over 4
7034
7035 =item DESCRIPTION
7036
7037 =over 4
7038
7039 =item Prerequisites for Compiling Perl on AmigaOS
7040
7041 B<Unix emulation for AmigaOS: ixemul.library>, B<Version of Amiga OS>
7042
7043 =item Starting Perl programs under AmigaOS
7044
7045 =item Shortcomings of Perl under AmigaOS
7046
7047 =back
7048
7049 =item INSTALLATION
7050
7051 =item Accessing documentation
7052
7053 =over 4
7054
7055 =item Manpages for Perl on AmigaOS
7056
7057 =item Perl HTML Documentation on AmigaOS
7058
7059 =item Perl GNU Info Files on AmigaOS
7060
7061 =item Perl LaTeX Documentation on AmigaOS
7062
7063 =back
7064
7065 =item BUILDING PERL ON AMIGAOS
7066
7067 =over 4
7068
7069 =item Build Prerequisites for Perl on AmigaOS
7070
7071 =item Getting the Perl Source for AmigaOS
7072
7073 =item Making Perl on AmigaOS
7074
7075 =item Testing Perl on AmigaOS
7076
7077 =item Installing the built Perl on AmigaOS
7078
7079 =back
7080
7081 =item PERL 5.8.0 BROKEN IN AMIGAOS
7082
7083 =item AUTHORS
7084
7085 =item SEE ALSO
7086
7087 =back
7088
7089 =head2 perlbeos, README.beos - Perl version 5 on BeOS
7090
7091 =over 4
7092
7093 =item DESCRIPTION
7094
7095 =over 4
7096
7097 =item General Issues with Perl on BeOS
7098
7099 =item BeOS Release-specific Notes
7100
7101 R4 x86, R4 PPC
7102
7103 =item Contact Information
7104
7105 =item Update 2002-05-30
7106
7107 =back
7108
7109 =back
7110
7111 =head2 perlbs2000, README.BS2000 - building and installing Perl for BS2000.
7112
7113 =over 4
7114
7115 =item SYNOPSIS
7116
7117 =item DESCRIPTION
7118
7119 =over 4
7120
7121 =item gzip on BS2000
7122
7123 =item bison on BS2000
7124
7125 =item Unpacking Perl Distribution on BS2000
7126
7127 =item Compiling Perl on BS2000
7128
7129 =item Testing Perl on BS2000
7130
7131 =item Installing Perl on BS2000
7132
7133 =item Using Perl in the Posix-Shell of BS2000
7134
7135 =item Using Perl in "native" BS2000
7136
7137 =item Floating point anomalies on BS2000
7138
7139 =back
7140
7141 =item AUTHORS
7142
7143 =item SEE ALSO
7144
7145 =over 4
7146
7147 =item Mailing list
7148
7149 =back
7150
7151 =item HISTORY
7152
7153 =back
7154
7155 =over 4
7156
7157 =item Name
7158
7159 =item Description
7160
7161 =item Build
7162
7163 =over 4
7164
7165 =item Tools & SDK
7166
7167 =item Make
7168
7169 =back
7170
7171 =item Acknowledgements
7172
7173 =item Author
7174
7175 =back
7176
7177 =head2 perlcygwin, README.cygwin - Perl for Cygwin
7178
7179 =over 4
7180
7181 =item SYNOPSIS
7182
7183 =item PREREQUISITES FOR COMPILING PERL ON CYGWIN
7184
7185 =over 4
7186
7187 =item Cygwin = GNU+Cygnus+Windows (Don't leave UNIX without it)
7188
7189 =item Cygwin Configuration
7190
7191 C<PATH>, I<nroff>, Permissions
7192
7193 =back
7194
7195 =item CONFIGURE PERL ON CYGWIN
7196
7197 =over 4
7198
7199 =item Stripping Perl Binaries on Cygwin
7200
7201 =item Optional Libraries for Perl on Cygwin
7202
7203 C<-lcrypt>, C<-lgdbm> (C<use GDBM_File>), C<-ldb> (C<use DB_File>),
7204 C<-lcygipc> (C<use IPC::SysV>), C<-lutil>
7205
7206 =item Configure-time Options for Perl on Cygwin
7207
7208 C<-Uusedl>, C<-Uusemymalloc>, C<-Uuseperlio>, C<-Dusemultiplicity>,
7209 C<-Duse64bitint>, C<-Duselongdouble>, C<-Dusethreads>, C<-Duselargefiles>,
7210 C<-Dmksymlinks>
7211
7212 =item Suspicious Warnings on Cygwin
7213
7214 I<dlsym()>, Win9x and C<d_eofnblk>, Compiler/Preprocessor defines
7215
7216 =back
7217
7218 =item MAKE ON CYGWIN
7219
7220 =over 4
7221
7222 =item Warnings on Cygwin
7223
7224 =item ld2 on Cygwin
7225
7226 =back
7227
7228 =item TEST ON CYGWIN
7229
7230 =over 4
7231
7232 =item File Permissions on Cygwin
7233
7234 =item NDBM_File does not work on FAT filesystems
7235
7236 =item Script Portability on Cygwin
7237
7238 Pathnames, Text/Binary, F<.exe>, chown(), Miscellaneous
7239
7240 =back
7241
7242 =item INSTALL PERL ON CYGWIN
7243
7244 =item MANIFEST ON CYGWIN
7245
7246 Documentation, Build, Configure, Make, Install, Tests, Compiled Perl
7247 Source, Compiled Module Source, Perl Modules/Scripts
7248
7249 =item BUGS ON CYGWIN
7250
7251 =item AUTHORS
7252
7253 =item HISTORY
7254
7255 =back
7256
7257 =head2 perldgux - Perl under DG/UX.
7258
7259 =over 4
7260
7261 =item SYNOPSIS
7262
7263 =back
7264
7265 =over 4
7266
7267 =item DESCRIPTION
7268
7269 =item BUILDING PERL ON DG/UX
7270
7271 =over 4
7272
7273 =item Non-threaded Perl on DG/UX
7274
7275 =item Threaded Perl on DG/UX
7276
7277 =item Testing Perl on DG/UX
7278
7279 =item Installing the built perl on DG/UX
7280
7281 =back
7282
7283 =item AUTHOR
7284
7285 =item SEE ALSO
7286
7287 =back
7288
7289 =head2 perldos - Perl under DOS, W31, W95.
7290
7291 =over 4
7292
7293 =item SYNOPSIS
7294
7295 =item DESCRIPTION
7296
7297 =over 4
7298
7299 =item Prerequisites for Compiling Perl on DOS
7300
7301 DJGPP, Pthreads
7302
7303 =item Shortcomings of Perl under DOS
7304
7305 =item Building Perl on DOS
7306
7307 =item Testing Perl on DOS
7308
7309 =item Installation of Perl on DOS
7310
7311 =back
7312
7313 =item BUILDING AND INSTALLING MODULES ON DOS
7314
7315 =over 4
7316
7317 =item Building Prerequisites for Perl on DOS
7318
7319 =item Unpacking CPAN Modules on DOS
7320
7321 =item Building Non-XS Modules on DOS
7322
7323 =item Building XS Modules on DOS
7324
7325 =back
7326
7327 =item AUTHOR
7328
7329 =item SEE ALSO
7330
7331 =back
7332
7333 =head2 perlepoc, README.epoc - Perl for EPOC
7334
7335 =over 4
7336
7337 =item SYNOPSIS
7338
7339 =item INTRODUCTION
7340
7341 =item INSTALLING PERL ON EPOC
7342
7343 =item STARTING PERL ON EPOC
7344
7345 =over 4
7346
7347 =item Editors on Epoc
7348
7349 =item Features of Perl on Epoc
7350
7351 =item Restrictions of Perl on Epoc
7352
7353 =item Compiling Perl 5 on the EPOC cross compiling environment
7354
7355 =back
7356
7357 =item SUPPORT STATUS OF PERL ON EPOC
7358
7359 =item AUTHOR
7360
7361 =item LAST UPDATE
7362
7363 =back
7364
7365 =head2 perlfreebsd, README.freebsd - Perl version 5 on FreeBSD systems
7366
7367 =over 4
7368
7369 =item DESCRIPTION
7370
7371 =over 4
7372
7373 =item FreeBSD core dumps from readdir_r with ithreads
7374
7375 =item $^X doesn't always contain a full path in FreeBSD
7376
7377 =item Perl will no longer be part of "base FreeBSD"
7378
7379 =back
7380
7381 =item AUTHOR
7382
7383 =back
7384
7385 =head2 perlhpux, README.hpux - Perl version 5 on Hewlett-Packard Unix
7386 (HP-UX) systems
7387
7388 =over 4
7389
7390 =item DESCRIPTION
7391
7392 =over 4
7393
7394 =item Using perl as shipped with HP-UX
7395
7396 =item Compiling Perl 5 on HP-UX
7397
7398 =item PA-RISC
7399
7400 =item PA-RISC 1.0
7401
7402 =item PA-RISC 1.1
7403
7404 =item PA-RISC 2.0
7405
7406 =item Itanium
7407
7408 =item Portability Between PA-RISC Versions
7409
7410 =item Itanium Processor Family and HP-UX
7411
7412 =item Building Dynamic Extensions on HP-UX
7413
7414 =item The HP ANSI C Compiler
7415
7416 =item The GNU C Compiler
7417
7418 =item Using Large Files with Perl on HP-UX
7419
7420 =item Threaded Perl on HP-UX
7421
7422 =item 64-bit Perl on HP-UX
7423
7424 =item Oracle on HP-UX
7425
7426 =item GDBM and Threads on HP-UX
7427
7428 =item NFS filesystems and utime(2) on HP-UX
7429
7430 =item perl -P and // and HP-UX
7431
7432 =item HP-UX Kernel Parameters (maxdsiz) for Compiling Perl
7433
7434 =back
7435
7436 =item nss_delete core dump from op/pwent or op/grent
7437
7438 =item AUTHOR
7439
7440 =item DATE
7441
7442 =back
7443
7444 =head2 perlhurd, README.hurd - Perl version 5 on Hurd
7445
7446 =over 4
7447
7448 =item DESCRIPTION
7449
7450 =over 4
7451
7452 =item Known Problems with Perl on Hurd
7453
7454 =back
7455
7456 =item AUTHOR
7457
7458 =back
7459
7460 =head2 perlirix, README.irix - Perl version 5 on Irix systems
7461
7462 =over 4
7463
7464 =item DESCRIPTION
7465
7466 =over 4
7467
7468 =item Building 32-bit Perl in Irix
7469
7470 =item Building 64-bit Perl in Irix
7471
7472 =item About Compiler Versions of Irix
7473
7474 =item Linker Problems in Irix
7475
7476 =item Malloc in Irix
7477
7478 =item Building with threads in Irix
7479
7480 =back
7481
7482 =item AUTHOR
7483
7484 =back
7485
7486 =head2 perlmachten, README.machten - Perl version 5 on Power MachTen
7487 systems
7488
7489 =over 4
7490
7491 =item DESCRIPTION
7492
7493 =over 4
7494
7495 =item Compiling Perl 5 on MachTen
7496
7497 =item Failures during C<make test> on MachTen
7498
7499 op/lexassign.t, pragma/warnings.t
7500
7501 =item Building external modules on MachTen
7502
7503 =back
7504
7505 =item AUTHOR
7506
7507 =item DATE
7508
7509 =back
7510
7511 =head2 perlmacos, README.macos - Perl under Mac OS (Classic)
7512
7513 =over 4
7514
7515 =item SYNOPSIS
7516
7517 =item DESCRIPTION
7518
7519 =item AUTHOR
7520
7521 =item DATE
7522
7523 =back
7524
7525 =head2 perlmint, README.mint - Perl version 5 on Atari MiNT
7526
7527 =over 4
7528
7529 =item DESCRIPTION
7530
7531 =item Known problems with Perl on MiNT
7532
7533 =item AUTHOR
7534
7535 =back
7536
7537 =head2 perlmpeix, README.mpeix - Perl/iX for HP e3000 MPE
7538
7539 =over 4
7540
7541 =item SYNOPSIS
7542
7543 =item NOTE
7544
7545 =item Binary distribution from HP
7546
7547 =item What's New in Perl for MPE/iX
7548
7549 =item Welcome to Perl/iX
7550
7551 =item System Requirements for Perl/iX
7552
7553 =item How to Obtain Perl/iX
7554
7555 =item Perl/iX Distribution Contents Highlights
7556
7557 README, INSTALL, LIBSHP3K, PERL, .cpan/, lib/, man/,
7558 public_html/feedback.cgi, src/perl-5.6.0-mpe
7559
7560 =item How to Compile Perl/iX
7561
7562  4,  6
7563
7564 =item Getting Started with Perl/iX
7565
7566 =item MPE/iX Implementation Considerations
7567
7568 =item Known Perl/iX Bugs Under Investigation
7569
7570 =item Perl/iX To-Do List
7571
7572 =item Perl/iX Change History
7573
7574 =item AUTHOR
7575
7576 =item Name
7577
7578 =item Description
7579
7580 =item Build
7581
7582 =over 4
7583
7584 =item Tools & SDK
7585
7586 =item Setup
7587
7588 SetNWBld.bat, Buildtype.bat
7589
7590 =item Make
7591
7592 =item Interpreter
7593
7594 =item Extensions
7595
7596 =back
7597
7598 =item Install
7599
7600 =item Build new extensions
7601
7602 =item Acknowledgements
7603
7604 =item Authors
7605
7606 =item Date
7607
7608 =back
7609
7610 =head2 perlos2 - Perl under OS/2, DOS, Win0.3*, Win0.95 and WinNT.
7611
7612 =over 4
7613
7614 =item SYNOPSIS
7615
7616 =back
7617
7618 =over 4
7619
7620 =item DESCRIPTION
7621
7622 =over 4
7623
7624 =item Target
7625
7626 =item Other OSes
7627
7628 =item Prerequisites
7629
7630 EMX, RSX, HPFS, pdksh
7631
7632 =item Starting Perl programs under OS/2 (and DOS and...)
7633
7634 =item Starting OS/2 (and DOS) programs under Perl
7635
7636 =back
7637
7638 =item Frequently asked questions
7639
7640 =over 4
7641
7642 =item "It does not work"
7643
7644 =item I cannot run external programs
7645
7646 =item I cannot embed perl into my program, or use F<perl.dll> from my
7647 program.
7648
7649 Is your program EMX-compiled with C<-Zmt -Zcrtdll>?, Did you use
7650 L<ExtUtils::Embed>?
7651
7652 =item C<``> and pipe-C<open> do not work under DOS.
7653
7654 =item Cannot start C<find.exe "pattern" file>
7655
7656 =back
7657
7658 =item INSTALLATION
7659
7660 =over 4
7661
7662 =item Automatic binary installation
7663
7664 C<PERL_BADLANG>, C<PERL_BADFREE>, F<Config.pm>
7665
7666 =item Manual binary installation
7667
7668 Perl VIO and PM executables (dynamically linked), Perl_ VIO executable
7669 (statically linked), Executables for Perl utilities, Main Perl library,
7670 Additional Perl modules, Tools to compile Perl modules, Manpages for Perl
7671 and utilities, Manpages for Perl modules, Source for Perl documentation,
7672 Perl manual in F<.INF> format, Pdksh
7673
7674 =item B<Warning>
7675
7676 =back
7677
7678 =item Accessing documentation
7679
7680 =over 4
7681
7682 =item OS/2 F<.INF> file
7683
7684 =item Plain text
7685
7686 =item Manpages
7687
7688 =item HTML
7689
7690 =item GNU C<info> files
7691
7692 =item F<PDF> files
7693
7694 =item C<LaTeX> docs
7695
7696 =back
7697
7698 =item BUILD
7699
7700 =over 4
7701
7702 =item The short story
7703
7704 =item Prerequisites
7705
7706 =item Getting perl source
7707
7708 =item Application of the patches
7709
7710 =item Hand-editing
7711
7712 =item Making
7713
7714 =item Testing
7715
7716 A lot of C<bad free>, Process terminated by SIGTERM/SIGINT, F<op/fs.t>,
7717 F<op/stat.t>
7718
7719 =item Installing the built perl
7720
7721 =item C<a.out>-style build
7722
7723 =back
7724
7725 =item Build FAQ
7726
7727 =over 4
7728
7729 =item Some C</> became C<\> in pdksh.
7730
7731 =item C<'errno'> - unresolved external
7732
7733 =item Problems with tr or sed
7734
7735 =item Some problem (forget which ;-)
7736
7737 =item Library ... not found
7738
7739 =item Segfault in make
7740
7741 =item op/sprintf test failure
7742
7743 =back
7744
7745 =item Specific (mis)features of OS/2 port
7746
7747 =over 4
7748
7749 =item C<setpriority>, C<getpriority>
7750
7751 =item C<system()>
7752
7753 =item C<extproc> on the first line
7754
7755 =item Additional modules:
7756
7757 =item Prebuilt methods:
7758
7759 C<File::Copy::syscopy>, C<DynaLoader::mod2fname>,  C<Cwd::current_drive()>,
7760  C<Cwd::sys_chdir(name)>,  C<Cwd::change_drive(name)>,
7761 C<Cwd::sys_is_absolute(name)>,  C<Cwd::sys_is_rooted(name)>,
7762 C<Cwd::sys_is_relative(name)>,  C<Cwd::sys_cwd(name)>,
7763 C<Cwd::sys_abspath(name, dir)>,  C<Cwd::extLibpath([type])>,
7764 C<Cwd::extLibpath_set( path [, type ] )>,
7765 C<OS2::Error(do_harderror,do_exception)>, C<OS2::Errors2Drive(drive)>,
7766 OS2::SysInfo(), OS2::BootDrive(), C<OS2::MorphPM(serve)>,
7767 C<OS2::UnMorphPM(serve)>, C<OS2::Serve_Messages(force)>,
7768 C<OS2::Process_Messages(force [, cnt])>, C<OS2::_control87(new,mask)>,
7769 OS2::get_control87(), C<OS2::set_control87_em(new=MCW_EM,mask=MCW_EM)>,
7770 C<OS2::DLLname([how [, \&xsub]])>
7771
7772 =item Prebuilt variables:
7773
7774 $OS2::emx_rev, $OS2::emx_env, $OS2::os_ver, $OS2::is_aout, $OS2::can_fork,
7775 $OS2::nsyserror
7776
7777 =item Misfeatures
7778
7779 =item Modifications
7780
7781 C<popen>, C<tmpnam>, C<tmpfile>, C<ctermid>, C<stat>, C<mkdir>, C<rmdir>,
7782 C<flock>
7783
7784 =item Identifying DLLs
7785
7786 =item Centralized management of resources
7787
7788 C<HAB>, C<HMQ>, Treating errors reported by OS/2 API,
7789 C<CheckOSError(expr)>, C<CheckWinError(expr)>, C<SaveWinError(expr)>,
7790 C<SaveCroakWinError(expr,die,name1,name2)>, C<WinError_2_Perl_rc>,
7791 C<FillWinError>, C<FillOSError(rc)>, Loading DLLs and ordinals in DLLs
7792
7793 =back
7794
7795 =item Perl flavors
7796
7797 =over 4
7798
7799 =item F<perl.exe>
7800
7801 =item F<perl_.exe>
7802
7803 =item F<perl__.exe>
7804
7805 =item F<perl___.exe>
7806
7807 =item Why strange names?
7808
7809 =item Why dynamic linking?
7810
7811 =item Why chimera build?
7812
7813 =back
7814
7815 =item ENVIRONMENT
7816
7817 =over 4
7818
7819 =item C<PERLLIB_PREFIX>
7820
7821 =item C<PERL_BADLANG>
7822
7823 =item C<PERL_BADFREE>
7824
7825 =item C<PERL_SH_DIR>
7826
7827 =item C<USE_PERL_FLOCK>
7828
7829 =item C<TMP> or C<TEMP>
7830
7831 =back
7832
7833 =item Evolution
7834
7835 =over 4
7836
7837 =item Text-mode filehandles
7838
7839 =item Priorities
7840
7841 =item DLL name mangling: pre 5.6.2
7842
7843 =item DLL name mangling: 5.6.2 and beyond
7844
7845 Global DLLs, specific DLLs, C<BEGINLIBPATH> and C<ENDLIBPATH>, F<.> from
7846 C<LIBPATH>
7847
7848 =item DLL forwarder generation
7849
7850 =item Threading
7851
7852 =item Calls to external programs
7853
7854 =item Memory allocation
7855
7856 =item Threads
7857
7858 C<COND_WAIT>, F<os2.c>
7859
7860 =back
7861
7862 =item BUGS
7863
7864 =back
7865
7866 =over 4
7867
7868 =item AUTHOR
7869
7870 =item SEE ALSO
7871
7872 =back
7873
7874 =head2 perlos390, README.os390 - building and installing Perl for OS/390
7875 and z/OS
7876
7877 =over 4
7878
7879 =item SYNOPSIS
7880
7881 =item DESCRIPTION
7882
7883 =over 4
7884
7885 =item Tools
7886
7887 =item Unpacking Perl distribution on OS/390
7888
7889 =item Setup and utilities for Perl on OS/390
7890
7891 =item Configure Perl on OS/390
7892
7893 =item Build, Test, Install Perl on OS/390
7894
7895 =item Build Anomalies with Perl on OS/390
7896
7897 =item Testing Anomalies with Perl on OS/390
7898
7899 =item Installation Anomalies with Perl on OS/390
7900
7901 =item Usage Hints for Perl on OS/390
7902
7903 =item Floating Point Anomalies with Perl on OS/390
7904
7905 =item Modules and Extensions for Perl on OS/390
7906
7907 =back
7908
7909 =item AUTHORS
7910
7911 =item SEE ALSO
7912
7913 =over 4
7914
7915 =item Mailing list for Perl on OS/390
7916
7917 =back
7918
7919 =item HISTORY
7920
7921 =back
7922
7923 =head2 perlqnx, README.qnx - Perl version 5 on QNX
7924
7925 =over 4
7926
7927 =item DESCRIPTION
7928
7929 =over 4
7930
7931 =item Required Software for Compiling Perl on QNX4
7932
7933 /bin/sh, ar, nm, cpp, make
7934
7935 =item Outstanding Issues with Perl on QNX4
7936
7937 =item QNX auxiliary files
7938
7939 qnx/ar, qnx/cpp
7940
7941 =item Outstanding issues with perl under QNX6
7942
7943 =back
7944
7945 =item AUTHOR
7946
7947 =back
7948
7949 =head2 perlplan9 - Plan 9-specific documentation for Perl
7950
7951 =over 4
7952
7953 =item DESCRIPTION
7954
7955 =over 4
7956
7957 =item Invoking Perl
7958
7959 =item What's in Plan 9 Perl
7960
7961 =item What's not in Plan 9 Perl
7962
7963 =item Perl5 Functions not currently supported in Plan 9 Perl
7964
7965 =item Signals in Plan 9 Perl
7966
7967 =back
7968
7969 =item COMPILING AND INSTALLING PERL ON PLAN 9
7970
7971 =over 4
7972
7973 =item Installing Perl Documentation on Plan 9
7974
7975 =back
7976
7977 =item BUGS
7978
7979 =item Revision date
7980
7981 =item AUTHOR
7982
7983 =back
7984
7985 =head2 perlsolaris, README.solaris - Perl version 5 on Solaris systems
7986
7987 =over 4
7988
7989 =item DESCRIPTION
7990
7991 =over 4
7992
7993 =item Solaris Version Numbers.
7994
7995 =back
7996
7997 =item RESOURCES
7998
7999 Solaris FAQ, Precompiled Binaries, Solaris Documentation
8000
8001 =item SETTING UP
8002
8003 =over 4
8004
8005 =item File Extraction Problems on Solaris.
8006
8007 =item Compiler and Related Tools on Solaris.
8008
8009 =item Environment for Compiling Perl on Solaris
8010
8011 =back
8012
8013 =item RUN CONFIGURE.
8014
8015 =over 4
8016
8017 =item 64-bit Issues with Perl on Solaris.
8018
8019 =item Threads in Perl on Solaris.
8020
8021 =item Malloc Issues with Perl on Solaris.
8022
8023 =back
8024
8025 =item MAKE PROBLEMS.
8026
8027 Dynamic Loading Problems With GNU as and GNU ld, ld.so.1: ./perl: fatal:
8028 relocation error:, dlopen: stub interception failed, #error "No
8029 DATAMODEL_NATIVE specified", sh: ar: not found
8030
8031 =item MAKE TEST
8032
8033 =over 4
8034
8035 =item op/stat.t test 4 in Solaris
8036
8037 =item nss_delete core dump from op/pwent or op/grent
8038
8039 =back
8040
8041 =item PREBUILT BINARIES OF PERL FOR SOLARIS.
8042
8043 =item RUNTIME ISSUES FOR PERL ON SOLARIS.
8044
8045 =over 4
8046
8047 =item Limits on Numbers of Open Files on Solaris.
8048
8049 =back
8050
8051 =item SOLARIS-SPECIFIC MODULES.
8052
8053 =item SOLARIS-SPECIFIC PROBLEMS WITH MODULES.
8054
8055 =over 4
8056
8057 =item Proc::ProcessTable on Solaris
8058
8059 =item BSD::Resource on Solaris
8060
8061 =item Net::SSLeay on Solaris
8062
8063 =back
8064
8065 =item AUTHOR
8066
8067 =item LAST MODIFIED
8068
8069 =back
8070
8071 =head2 perltru64, README.tru64 - Perl version 5 on Tru64 (formerly known as
8072 Digital UNIX formerly known as DEC OSF/1) systems
8073
8074 =over 4
8075
8076 =item DESCRIPTION
8077
8078 =over 4
8079
8080 =item Compiling Perl 5 on Tru64
8081
8082 =item Using Large Files with Perl on Tru64
8083
8084 =item Threaded Perl on Tru64
8085
8086 =item Long Doubles on Tru64
8087
8088 =item 64-bit Perl on Tru64
8089
8090 =item Warnings about floating-point overflow when compiling Perl on Tru64
8091
8092 =back
8093
8094 =item Testing Perl on Tru64
8095
8096 =item ext/ODBM_File/odbm Test Failing With Static Builds
8097
8098 =item Perl Fails Because Of Unresolved Symbol sockatmark
8099
8100 =item AUTHOR
8101
8102 =back
8103
8104 =head2 perluts - Perl under UTS
8105
8106 =over 4
8107
8108 =item SYNOPSIS
8109
8110 =item DESCRIPTION
8111
8112 =item BUILDING PERL ON UTS
8113
8114 =item Installing the built perl on UTS
8115
8116 =item AUTHOR
8117
8118 =back
8119
8120 =head2 perlvmesa, README.vmesa - building and installing Perl for VM/ESA.
8121
8122 =over 4
8123
8124 =item SYNOPSIS
8125
8126 =item DESCRIPTION
8127
8128 =over 4
8129
8130 =item Unpacking Perl Distribution on VM/ESA
8131
8132 =item Setup Perl and utilities on VM/ESA
8133
8134 =item Configure Perl on VM/ESA
8135
8136 =item Testing Anomalies of Perl on VM/ESA
8137
8138 =item Usage Hints for Perl on VM/ESA
8139
8140 =back
8141
8142 =item AUTHORS
8143
8144 =item SEE ALSO
8145
8146 =over 4
8147
8148 =item Mailing list for Perl on VM/ESA
8149
8150 =back
8151
8152 =back
8153
8154 =head2 perlvms - VMS-specific documentation for Perl
8155
8156 =over 4
8157
8158 =item DESCRIPTION
8159
8160 =item Installation
8161
8162 =item Organization of Perl Images
8163
8164 =over 4
8165
8166 =item Core Images
8167
8168 =item Perl Extensions
8169
8170 =item Installing static extensions
8171
8172 =item Installing dynamic extensions
8173
8174 =back
8175
8176 =item File specifications
8177
8178 =over 4
8179
8180 =item Syntax
8181
8182 =item Wildcard expansion
8183
8184 =item Pipes
8185
8186 =back
8187
8188 =item PERL5LIB and PERLLIB
8189
8190 =item Command line
8191
8192 =over 4
8193
8194 =item I/O redirection and backgrounding
8195
8196 =item Command line switches
8197
8198 -i, -S, -u
8199
8200 =back
8201
8202 =item Perl functions
8203
8204 File tests, backticks, binmode FILEHANDLE, crypt PLAINTEXT, USER, dump,
8205 exec LIST, fork, getpwent, getpwnam, getpwuid, gmtime, kill, qx//, select
8206 (system call), stat EXPR, system LIST, time, times, unlink LIST, utime
8207 LIST, waitpid PID,FLAGS
8208
8209 =item Perl variables
8210
8211 %ENV, CRTL_ENV, CLISYM_[LOCAL], Any other string, $!, $^E, $?, $|
8212
8213 =item Standard modules with VMS-specific differences
8214
8215 =over 4
8216
8217 =item SDBM_File
8218
8219 =back
8220
8221 =item Revision date
8222
8223 =item AUTHOR
8224
8225 =back
8226
8227 =head2 perlvos, README.vos - Perl for Stratus VOS
8228
8229 =over 4
8230
8231 =item SYNOPSIS
8232
8233 =over 4
8234
8235 =item Multiple methods to build perl for VOS
8236
8237 =item Stratus POSIX Support
8238
8239 =back
8240
8241 =item INSTALLING PERL IN VOS
8242
8243 =over 4
8244
8245 =item Compiling Perl 5 on VOS
8246
8247 =item Installing Perl 5 on VOS
8248
8249 =back
8250
8251 =item USING PERL IN VOS
8252
8253 =over 4
8254
8255 =item Unimplemented Features of Perl on VOS
8256
8257 =item Restrictions of Perl on VOS
8258
8259 =item Handling of underflow and overflow
8260
8261 =back
8262
8263 =item TEST STATUS
8264
8265 =item SUPPORT STATUS
8266
8267 =item AUTHOR
8268
8269 =item LAST UPDATE
8270
8271 =back
8272
8273 =head2 perlwin32 - Perl under Windows
8274
8275 =over 4
8276
8277 =item SYNOPSIS
8278
8279 =item DESCRIPTION
8280
8281 =over 4
8282
8283 =item Setting Up Perl on Win32
8284
8285 Make, Command Shell, Borland C++, Microsoft Visual C++, Microsoft Platform
8286 SDK 64-bit Compiler, Mingw32 with GCC
8287
8288 =item Building
8289
8290 =item Testing Perl on Win32
8291
8292 =item Installation of Perl on Win32
8293
8294 =item Usage Hints for Perl on Win32
8295
8296 Environment Variables, File Globbing, Using perl from the command line,
8297 Building Extensions, Command-line Wildcard Expansion, Win32 Specific
8298 Extensions, Notes on 64-bit Windows
8299
8300 =item Running Perl Scripts
8301
8302 Miscellaneous Things
8303
8304 =back
8305
8306 =item BUGS AND CAVEATS
8307
8308 =item AUTHORS
8309
8310 Gary Ng E<lt>71564.1743@CompuServe.COME<gt>, Gurusamy Sarathy
8311 E<lt>gsar@activestate.comE<gt>, Nick Ing-Simmons
8312 E<lt>nick@ing-simmons.netE<gt>
8313
8314 =item SEE ALSO
8315
8316 =item HISTORY
8317
8318 =back
8319
8320 =head1 PRAGMA DOCUMENTATION
8321
8322 =head2 attrs - set/get attributes of a subroutine (deprecated)
8323
8324 =over 4
8325
8326 =item SYNOPSIS
8327
8328 =item DESCRIPTION
8329
8330 method, locked
8331
8332 =back
8333
8334 =head2 re - Perl pragma to alter regular expression behaviour
8335
8336 =over 4
8337
8338 =item SYNOPSIS
8339
8340 =item DESCRIPTION
8341
8342 =back
8343
8344 =head2 threadshared::shared, threads::shared - Perl extension for sharing
8345 data structures between threads
8346
8347 =over 4
8348
8349 =item SYNOPSIS
8350
8351 =item DESCRIPTION
8352
8353 =item EXPORT
8354
8355 =item FUNCTIONS
8356
8357 share VARIABLE, lock VARIABLE, cond_wait VARIABLE, cond_signal VARIABLE,
8358 cond_broadcast VARIABLE
8359
8360 =item NOTES
8361
8362 =item BUGS
8363
8364 =item AUTHOR
8365
8366 =item SEE ALSO
8367
8368 =back
8369
8370 =head2 threads - Perl extension allowing use of interpreter based threads
8371 from perl
8372
8373 =over 4
8374
8375 =item SYNOPSIS
8376
8377 =item DESCRIPTION
8378
8379 $thread = threads->create(function, LIST), $thread->join, $thread->detach,
8380 threads->self, $thread->tid, threads->object( tid ), threads->yield();,
8381 threads->list();, async BLOCK;
8382
8383 =item WARNINGS
8384
8385 A thread exited while %d other threads were still running
8386
8387 =item TODO
8388
8389 =item BUGS
8390
8391 Parent-Child threads, Returning objects, Creating threads inside BEGIN
8392 blocks, PERL_OLD_SIGNALS are not threadsafe, will not be
8393
8394 =item AUTHOR and COPYRIGHT
8395
8396 =item SEE ALSO
8397
8398 =back
8399
8400 =head2 attributes - get/set subroutine or variable attributes
8401
8402 =over 4
8403
8404 =item SYNOPSIS
8405
8406 =item DESCRIPTION
8407
8408 =over 4
8409
8410 =item Built-in Attributes
8411
8412 locked, method, lvalue
8413
8414 =item Available Subroutines
8415
8416 get, reftype
8417
8418 =item Package-specific Attribute Handling
8419
8420 FETCH_I<type>_ATTRIBUTES, MODIFY_I<type>_ATTRIBUTES
8421
8422 =item Syntax of Attribute Lists
8423
8424 =back
8425
8426 =item EXPORTS
8427
8428 =over 4
8429
8430 =item Default exports
8431
8432 =item Available exports
8433
8434 =item Export tags defined
8435
8436 =back
8437
8438 =item EXAMPLES
8439
8440 =item SEE ALSO
8441
8442 =back
8443
8444 =head2 attrs - set/get attributes of a subroutine (deprecated)
8445
8446 =over 4
8447
8448 =item SYNOPSIS
8449
8450 =item DESCRIPTION
8451
8452 method, locked
8453
8454 =back
8455
8456 =head2 autouse - postpone load of modules until a function is used
8457
8458 =over 4
8459
8460 =item SYNOPSIS
8461
8462 =item DESCRIPTION
8463
8464 =item WARNING
8465
8466 =item AUTHOR
8467
8468 =item SEE ALSO
8469
8470 =back
8471
8472 =head2 base - Establish IS-A relationship with base class at compile time
8473
8474 =over 4
8475
8476 =item SYNOPSIS
8477
8478 =item DESCRIPTION
8479
8480 =item HISTORY
8481
8482 =item SEE ALSO
8483
8484 =back
8485
8486 =head2 bigint - Transparent big integer support for Perl
8487
8488 =over 4
8489
8490 =item SYNOPSIS
8491
8492 =item DESCRIPTION
8493
8494 =over 4
8495
8496 =item OPTIONS
8497
8498 a or accuracy, p or precision, t or trace, l or lib, v or version
8499
8500 =item MATH LIBRARY
8501
8502 =item INTERNAL FORMAT
8503
8504 =item SIGN
8505
8506 =item METHODS
8507
8508 =back
8509
8510 =item MODULES USED
8511
8512 =item EXAMPLES
8513
8514 =item LICENSE
8515
8516 =item SEE ALSO
8517
8518 =item AUTHORS
8519
8520 =back
8521
8522 =head2 bignum - Transparent BigNumber support for Perl
8523
8524 =over 4
8525
8526 =item SYNOPSIS
8527
8528 =item DESCRIPTION
8529
8530 =over 4
8531
8532 =item OPTIONS
8533
8534 a or accuracy, p or precision, t or trace, l or lib, v or version
8535
8536 =item MATH LIBRARY
8537
8538 =item INTERNAL FORMAT
8539
8540 =item SIGN
8541
8542 =item METHODS
8543
8544 =back
8545
8546 =item MODULES USED
8547
8548 =item EXAMPLES
8549
8550 =item LICENSE
8551
8552 =item SEE ALSO
8553
8554 =item AUTHORS
8555
8556 =back
8557
8558 =head2 bigrat - Transparent BigNumber/BigRational support for Perl
8559
8560 =over 4
8561
8562 =item SYNOPSIS
8563
8564 =item DESCRIPTION
8565
8566 =over 4
8567
8568 =item MODULES USED
8569
8570 =item MATH LIBRARY
8571
8572 =item SIGN
8573
8574 =item METHODS
8575
8576 =back
8577
8578 =item EXAMPLES
8579
8580         perl -Mbigrat -le 'print sqrt(33)'
8581         perl -Mbigrat -le 'print 2*255'
8582         perl -Mbigrat -le 'print 4.5+2*255'
8583         perl -Mbigrat -le 'print 3/7 + 5/7 + 8/3'
8584         perl -Mbigrat -le 'print 12->is_odd()';
8585
8586 =item LICENSE
8587
8588 =item SEE ALSO
8589
8590 =item AUTHORS
8591
8592 =back
8593
8594 =head2 blib - Use MakeMaker's uninstalled version of a package
8595
8596 =over 4
8597
8598 =item SYNOPSIS
8599
8600 =item DESCRIPTION
8601
8602 =item BUGS
8603
8604 =item AUTHOR
8605
8606 =back
8607
8608 =head2 bytes - Perl pragma to force byte semantics rather than character
8609 semantics
8610
8611 =over 4
8612
8613 =item SYNOPSIS
8614
8615 =item DESCRIPTION
8616
8617 =item SEE ALSO
8618
8619 =back
8620
8621 =head2 charnames - define character names for C<\N{named}> string literal
8622 escapes
8623
8624 =over 4
8625
8626 =item SYNOPSIS
8627
8628 =item DESCRIPTION
8629
8630 =item CUSTOM TRANSLATORS
8631
8632 =item charnames::viacode(code)
8633
8634 =item charnames::vianame(name)
8635
8636 =item ALIASES
8637
8638 =item ILLEGAL CHARACTERS
8639
8640 =item BUGS
8641
8642 =back
8643
8644 =head2 constant - Perl pragma to declare constants
8645
8646 =over 4
8647
8648 =item SYNOPSIS
8649
8650 =item DESCRIPTION
8651
8652 =item NOTES
8653
8654 =over 4
8655
8656 =item List constants
8657
8658 =item Defining multiple constants at once
8659
8660 =item Magic constants
8661
8662 =back
8663
8664 =item TECHNICAL NOTES
8665
8666 =item BUGS
8667
8668 =item AUTHOR
8669
8670 =item COPYRIGHT
8671
8672 =back
8673
8674 =head2 diagnostics - Perl compiler pragma to force verbose warning
8675 diagnostics
8676
8677 =over 4
8678
8679 =item SYNOPSIS
8680
8681 =item DESCRIPTION
8682
8683 =over 4
8684
8685 =item The C<diagnostics> Pragma
8686
8687 =item The I<splain> Program
8688
8689 =back
8690
8691 =item EXAMPLES
8692
8693 =item INTERNALS
8694
8695 =item BUGS
8696
8697 =item AUTHOR
8698
8699 =back
8700
8701 =head2 encoding - allows you to write your script in non-ascii or non-utf8
8702
8703 =over 4
8704
8705 =item SYNOPSIS
8706
8707 =item ABSTRACT
8708
8709 =item USAGE
8710
8711 use encoding [I<ENCNAME>] ;, use encoding I<ENCNAME> [ STDIN =E<gt>
8712 I<ENCNAME_IN> ...] ;, no encoding;
8713
8714 =item CAVEATS
8715
8716 =over 4
8717
8718 =item NOT SCOPED
8719
8720 =item DO NOT MIX MULTIPLE ENCODINGS
8721
8722 =back
8723
8724 =item Non-ASCII Identifiers and Filter option
8725
8726 use encoding I<ENCNAME> Filter=E<gt>1;
8727
8728 =item EXAMPLE - Greekperl
8729
8730 =item KNOWN PROBLEMS
8731
8732 =item SEE ALSO
8733
8734 =back
8735
8736 =head2 fields - compile-time class fields
8737
8738 =over 4
8739
8740 =item SYNOPSIS
8741
8742 =item DESCRIPTION
8743
8744 new, phash
8745
8746 =item SEE ALSO
8747
8748 =back
8749
8750 =head2 filetest - Perl pragma to control the filetest permission operators
8751
8752 =over 4
8753
8754 =item SYNOPSIS
8755
8756 =item DESCRIPTION
8757
8758 =over 4
8759
8760 =item subpragma access
8761
8762 =back
8763
8764 =back
8765
8766 =head2 if - C<use> a Perl module if a condition holds
8767
8768 =over 4
8769
8770 =item SYNOPSIS
8771
8772 =item DESCRIPTION
8773
8774 =item BUGS
8775
8776 =item AUTHOR
8777
8778 =back
8779
8780 =head2 integer - Perl pragma to use integer arithmetic instead of floating
8781 point
8782
8783 =over 4
8784
8785 =item SYNOPSIS
8786
8787 =item DESCRIPTION
8788
8789 =back
8790
8791 =head2 less - perl pragma to request less of something from the compiler
8792
8793 =over 4
8794
8795 =item SYNOPSIS
8796
8797 =item DESCRIPTION
8798
8799 =back
8800
8801 =head2 lib - manipulate @INC at compile time
8802
8803 =over 4
8804
8805 =item SYNOPSIS
8806
8807 =item DESCRIPTION
8808
8809 =over 4
8810
8811 =item Adding directories to @INC
8812
8813 =item Deleting directories from @INC
8814
8815 =item Restoring original @INC
8816
8817 =back
8818
8819 =item CAVEATS
8820
8821 =item NOTES
8822
8823 =item SEE ALSO
8824
8825 =item AUTHOR
8826
8827 =back
8828
8829 =head2 locale - Perl pragma to use and avoid POSIX locales for built-in
8830 operations
8831
8832 =over 4
8833
8834 =item SYNOPSIS
8835
8836 =item DESCRIPTION
8837
8838 =back
8839
8840 =head2 open - perl pragma to set default PerlIO layers for input and output
8841
8842 =over 4
8843
8844 =item SYNOPSIS
8845
8846 =item DESCRIPTION
8847
8848 =item NONPERLIO FUNCTIONALITY
8849
8850 =item IMPLEMENTATION DETAILS
8851
8852 =item SEE ALSO
8853
8854 =back
8855
8856 =head2 ops - Perl pragma to restrict unsafe operations when compiling
8857
8858 =over 4
8859
8860 =item SYNOPSIS
8861
8862 =item DESCRIPTION
8863
8864 =item SEE ALSO
8865
8866 =back
8867
8868 =head2 overload - Package for overloading perl operations
8869
8870 =over 4
8871
8872 =item SYNOPSIS
8873
8874 =item DESCRIPTION
8875
8876 =over 4
8877
8878 =item Declaration of overloaded functions
8879
8880 =item Calling Conventions for Binary Operations
8881
8882 FALSE, TRUE, C<undef>
8883
8884 =item Calling Conventions for Unary Operations
8885
8886 =item Calling Conventions for Mutators
8887
8888 C<++> and C<-->, C<x=> and other assignment versions
8889
8890 =item Overloadable Operations
8891
8892 I<Arithmetic operations>, I<Comparison operations>, I<Bit operations>,
8893 I<Increment and decrement>, I<Transcendental functions>, I<Boolean, string
8894 and numeric conversion>, I<Iteration>, I<Dereferencing>, I<Special>
8895
8896 =item Inheritance and overloading
8897
8898 Strings as values of C<use overload> directive, Overloading of an operation
8899 is inherited by derived classes
8900
8901 =back
8902
8903 =item SPECIAL SYMBOLS FOR C<use overload>
8904
8905 =over 4
8906
8907 =item Last Resort
8908
8909 =item Fallback
8910
8911 C<undef>, TRUE, defined, but FALSE
8912
8913 =item Copy Constructor
8914
8915 B<Example>
8916
8917 =back
8918
8919 =item MAGIC AUTOGENERATION
8920
8921 I<Assignment forms of arithmetic operations>, I<Conversion operations>,
8922 I<Increment and decrement>, C<abs($a)>, I<Unary minus>, I<Negation>,
8923 I<Concatenation>, I<Comparison operations>, I<Iterator>, I<Dereferencing>,
8924 I<Copy operator>
8925
8926 =item Losing overloading
8927
8928 =item Run-time Overloading
8929
8930 =item Public functions
8931
8932 overload::StrVal(arg), overload::Overloaded(arg), overload::Method(obj,op)
8933
8934 =item Overloading constants
8935
8936 integer, float, binary, q, qr
8937
8938 =item IMPLEMENTATION
8939
8940 =item Metaphor clash
8941
8942 =item Cookbook
8943
8944 =over 4
8945
8946 =item Two-face scalars
8947
8948 =item Two-face references
8949
8950 =item Symbolic calculator
8951
8952 =item I<Really> symbolic calculator
8953
8954 =back
8955
8956 =item AUTHOR
8957
8958 =item DIAGNOSTICS
8959
8960 Odd number of arguments for overload::constant, `%s' is not an overloadable
8961 type, `%s' is not a code reference
8962
8963 =item BUGS
8964
8965 =back
8966
8967 =head2 re - Perl pragma to alter regular expression behaviour
8968
8969 =over 4
8970
8971 =item SYNOPSIS
8972
8973 =item DESCRIPTION
8974
8975 =back
8976
8977 =head2 sigtrap - Perl pragma to enable simple signal handling
8978
8979 =over 4
8980
8981 =item SYNOPSIS
8982
8983 =item DESCRIPTION
8984
8985 =item OPTIONS
8986
8987 =over 4
8988
8989 =item SIGNAL HANDLERS
8990
8991 B<stack-trace>, B<die>, B<handler> I<your-handler>
8992
8993 =item SIGNAL LISTS
8994
8995 B<normal-signals>, B<error-signals>, B<old-interface-signals>
8996
8997 =item OTHER
8998
8999 B<untrapped>, B<any>, I<signal>, I<number>
9000
9001 =back
9002
9003 =item EXAMPLES
9004
9005 =back
9006
9007 =head2 sort - perl pragma to control sort() behaviour
9008
9009 =over 4
9010
9011 =item SYNOPSIS
9012
9013 =item DESCRIPTION
9014
9015 =item CAVEATS
9016
9017 =back
9018
9019 =head2 strict - Perl pragma to restrict unsafe constructs
9020
9021 =over 4
9022
9023 =item SYNOPSIS
9024
9025 =item DESCRIPTION
9026
9027 C<strict refs>, C<strict vars>, C<strict subs>
9028
9029 =back
9030
9031 =head2 subs - Perl pragma to predeclare sub names
9032
9033 =over 4
9034
9035 =item SYNOPSIS
9036
9037 =item DESCRIPTION
9038
9039 =back
9040
9041 =head2 threads - Perl extension allowing use of interpreter based threads
9042 from perl
9043
9044 =over 4
9045
9046 =item SYNOPSIS
9047
9048 =item DESCRIPTION
9049
9050 $thread = threads->create(function, LIST), $thread->join, $thread->detach,
9051 threads->self, $thread->tid, threads->object( tid ), threads->yield();,
9052 threads->list();, async BLOCK;
9053
9054 =item WARNINGS
9055
9056 A thread exited while %d other threads were still running
9057
9058 =item TODO
9059
9060 =item BUGS
9061
9062 Parent-Child threads, Returning objects, Creating threads inside BEGIN
9063 blocks, PERL_OLD_SIGNALS are not threadsafe, will not be
9064
9065 =item AUTHOR and COPYRIGHT
9066
9067 =item SEE ALSO
9068
9069 =back
9070
9071 =head2 threadshared, threads::shared - Perl extension for sharing data
9072 structures between threads
9073
9074 =over 4
9075
9076 =item SYNOPSIS
9077
9078 =item DESCRIPTION
9079
9080 =item EXPORT
9081
9082 =item FUNCTIONS
9083
9084 share VARIABLE, lock VARIABLE, cond_wait VARIABLE, cond_signal VARIABLE,
9085 cond_broadcast VARIABLE
9086
9087 =item NOTES
9088
9089 =item BUGS
9090
9091 =item AUTHOR
9092
9093 =item SEE ALSO
9094
9095 =back
9096
9097 =head2 utf8 - Perl pragma to enable/disable UTF-8 (or UTF-EBCDIC) in source
9098 code
9099
9100 =over 4
9101
9102 =item SYNOPSIS
9103
9104 =item DESCRIPTION
9105
9106 =over 4
9107
9108 =item Utility functions
9109
9110 $num_octets = utf8::upgrade($string);, utf8::downgrade($string[, FAIL_OK]),
9111 utf8::encode($string), $flag = utf8::decode($string), $flag =
9112 utf8::valid(STRING)
9113
9114 =back
9115
9116 =item BUGS
9117
9118 =item SEE ALSO
9119
9120 =back
9121
9122 =head2 vars - Perl pragma to predeclare global variable names (obsolete)
9123
9124 =over 4
9125
9126 =item SYNOPSIS
9127
9128 =item DESCRIPTION
9129
9130 =back
9131
9132 =head2 vmsish - Perl pragma to control VMS-specific language features
9133
9134 =over 4
9135
9136 =item SYNOPSIS
9137
9138 =item DESCRIPTION
9139
9140 C<vmsish status>, C<vmsish exit>, C<vmsish time>, C<vmsish hushed>
9141
9142 =back
9143
9144 =head2 warnings - Perl pragma to control optional warnings
9145
9146 =over 4
9147
9148 =item SYNOPSIS
9149
9150 =item DESCRIPTION
9151
9152 use warnings::register, warnings::enabled(), warnings::enabled($category),
9153 warnings::enabled($object), warnings::warn($message),
9154 warnings::warn($category, $message), warnings::warn($object, $message),
9155 warnings::warnif($message), warnings::warnif($category, $message),
9156 warnings::warnif($object, $message)
9157
9158 =back
9159
9160 =head2 warnings::register - warnings import function
9161
9162 =over 4
9163
9164 =item SYNOPSIS
9165
9166 =item DESCRIPTION
9167
9168 =back
9169
9170 =head1 MODULE DOCUMENTATION
9171
9172 =head2 AnyDBM_File - provide framework for multiple DBMs
9173
9174 =over 4
9175
9176 =item SYNOPSIS
9177
9178 =item DESCRIPTION
9179
9180 =over 4
9181
9182 =item DBM Comparisons
9183
9184 [0], [1], [2], [3]
9185
9186 =back
9187
9188 =item SEE ALSO
9189
9190 =back
9191
9192 =head2 Attribute::Handlers - Simpler definition of attribute handlers
9193
9194 =over 4
9195
9196 =item VERSION
9197
9198 =item SYNOPSIS
9199
9200 =item DESCRIPTION
9201
9202 [0], [1], [2], [3], [4], [5]
9203
9204 =over 4
9205
9206 =item Typed lexicals
9207
9208 =item Type-specific attribute handlers
9209
9210 =item Non-interpretive attribute handlers
9211
9212 =item Phase-specific attribute handlers
9213
9214 =item Attributes as C<tie> interfaces
9215
9216 =back
9217
9218 =item EXAMPLES
9219
9220 =item DIAGNOSTICS
9221
9222 C<Bad attribute type: ATTR(%s)>, C<Attribute handler %s doesn't handle %s
9223 attributes>, C<Declaration of %s attribute in package %s may clash with
9224 future reserved word>, C<Can't have two ATTR specifiers on one subroutine>,
9225 C<Can't autotie a %s>, C<Internal error: %s symbol went missing>, C<Won't
9226 be able to apply END handler>
9227
9228 =item AUTHOR
9229
9230 =item BUGS
9231
9232 =item COPYRIGHT
9233
9234 =back
9235
9236 =head2 AutoLoader - load subroutines only on demand
9237
9238 =over 4
9239
9240 =item SYNOPSIS
9241
9242 =item DESCRIPTION
9243
9244 =over 4
9245
9246 =item Subroutine Stubs
9247
9248 =item Using B<AutoLoader>'s AUTOLOAD Subroutine
9249
9250 =item Overriding B<AutoLoader>'s AUTOLOAD Subroutine
9251
9252 =item Package Lexicals
9253
9254 =item Not Using AutoLoader
9255
9256 =item B<AutoLoader> vs. B<SelfLoader>
9257
9258 =back
9259
9260 =item CAVEATS
9261
9262 =item SEE ALSO
9263
9264 =back
9265
9266 =head2 AutoSplit - split a package for autoloading
9267
9268 =over 4
9269
9270 =item SYNOPSIS
9271
9272 =item DESCRIPTION
9273
9274 $keep, $check, $modtime
9275
9276 =over 4
9277
9278 =item Multiple packages
9279
9280 =back
9281
9282 =item DIAGNOSTICS
9283
9284 =back
9285
9286 =head2 B - The Perl Compiler
9287
9288 =over 4
9289
9290 =item SYNOPSIS
9291
9292 =item DESCRIPTION
9293
9294 =item OVERVIEW OF CLASSES
9295
9296 =over 4
9297
9298 =item SV-RELATED CLASSES
9299
9300 =item B::SV METHODS
9301
9302 REFCNT, FLAGS
9303
9304 =item B::IV METHODS
9305
9306 IV, IVX, UVX, int_value, needs64bits, packiv
9307
9308 =item B::NV METHODS
9309
9310 NV, NVX
9311
9312 =item B::RV METHODS
9313
9314 RV
9315
9316 =item B::PV METHODS
9317
9318 PV, RV, PVX
9319
9320 =item B::PVMG METHODS
9321
9322 MAGIC, SvSTASH
9323
9324 =item B::MAGIC METHODS
9325
9326 MOREMAGIC, precomp, PRIVATE, TYPE, FLAGS, OBJ, PTR, REGEX
9327
9328 =item B::PVLV METHODS
9329
9330 TARGOFF, TARGLEN, TYPE, TARG
9331
9332 =item B::BM METHODS
9333
9334 USEFUL, PREVIOUS, RARE, TABLE
9335
9336 =item B::GV METHODS
9337
9338 is_empty, NAME, SAFENAME, STASH, SV, IO, FORM, AV, HV, EGV, CV, CVGEN,
9339 LINE, FILE, FILEGV, GvREFCNT, FLAGS
9340
9341 =item B::IO METHODS
9342
9343 LINES, PAGE, PAGE_LEN, LINES_LEFT, TOP_NAME, TOP_GV, FMT_NAME, FMT_GV,
9344 BOTTOM_NAME, BOTTOM_GV, SUBPROCESS, IoTYPE, IoFLAGS, IsSTD
9345
9346 =item B::AV METHODS
9347
9348 FILL, MAX, OFF, ARRAY, AvFLAGS
9349
9350 =item B::CV METHODS
9351
9352 STASH, START, ROOT, GV, FILE, DEPTH, PADLIST, OUTSIDE, XSUB, XSUBANY,
9353 CvFLAGS, const_sv
9354
9355 =item B::HV METHODS
9356
9357 FILL, MAX, KEYS, RITER, NAME, PMROOT, ARRAY
9358
9359 =item OP-RELATED CLASSES
9360
9361 =item B::OP METHODS
9362
9363 next, sibling, name, ppaddr, desc, targ, type, seq, flags, private
9364
9365 =item B::UNOP METHOD
9366
9367 first
9368
9369 =item B::BINOP METHOD
9370
9371 last
9372
9373 =item B::LOGOP METHOD
9374
9375 other
9376
9377 =item B::LISTOP METHOD
9378
9379 children
9380
9381 =item B::PMOP METHODS
9382
9383 pmreplroot, pmreplstart, pmnext, pmregexp, pmflags, pmdynflags,
9384 pmpermflags, precomp, pmoffet
9385
9386 =item B::SVOP METHOD
9387
9388 sv, gv
9389
9390 =item B::PADOP METHOD
9391
9392 padix
9393
9394 =item B::PVOP METHOD
9395
9396 pv
9397
9398 =item B::LOOP METHODS
9399
9400 redoop, nextop, lastop
9401
9402 =item B::COP METHODS
9403
9404 label, stash, file, cop_seq, arybase, line
9405
9406 =back
9407
9408 =item FUNCTIONS EXPORTED BY C<B>
9409
9410 main_cv, init_av, begin_av, end_av, main_root, main_start, comppadlist,
9411 regex_padav, sv_undef, sv_yes, sv_no, amagic_generation, walkoptree(OP,
9412 METHOD), walkoptree_debug(DEBUG), walksymtable(SYMREF, METHOD, RECURSE,
9413 PREFIX), svref_2object(SV), ppname(OPNUM), hash(STR), cast_I32(I), minus_c,
9414 cstring(STR), perlstring(STR), class(OBJ), threadsv_names
9415
9416 =item AUTHOR
9417
9418 =back
9419
9420 =head2 B::Asmdata - Autogenerated data about Perl ops, used to generate
9421 bytecode
9422
9423 =over 4
9424
9425 =item SYNOPSIS
9426
9427 =item DESCRIPTION
9428
9429 %insn_data, @insn_name, @optype, @specialsv_name
9430
9431 =item AUTHOR
9432
9433 =back
9434
9435 =head2 B::Assembler - Assemble Perl bytecode
9436
9437 =over 4
9438
9439 =item SYNOPSIS
9440
9441 =item DESCRIPTION
9442
9443 =item AUTHORS
9444
9445 =back
9446
9447 =head2 B::Bblock - Walk basic blocks
9448
9449 =over 4
9450
9451 =item SYNOPSIS
9452
9453 =item DESCRIPTION
9454
9455 =over 4
9456
9457 =item Functions
9458
9459 B<find_leaders>
9460
9461 =back
9462
9463 =item AUTHOR
9464
9465 =back
9466
9467 =head2 B::Bytecode - Perl compiler's bytecode backend
9468
9469 =over 4
9470
9471 =item SYNOPSIS
9472
9473 =item DESCRIPTION
9474
9475 =item OPTIONS
9476
9477 B<-ofilename>, B<-afilename>, B<-->, B<-f>, B<-fcompress-nullops>,
9478 B<-fomit-sequence-numbers>, B<-fbypass-nullops>, B<-On>, B<-D>, B<-Do>,
9479 B<-Db>, B<-Da>, B<-DC>, B<-S>, B<-upackage>
9480
9481 =item EXAMPLES
9482
9483 =item BUGS
9484
9485 =item AUTHORS
9486
9487 =back
9488
9489 =head2 B::C - Perl compiler's C backend
9490
9491 =over 4
9492
9493 =item SYNOPSIS
9494
9495 =item DESCRIPTION
9496
9497 =item OPTIONS
9498
9499 B<-ofilename>, B<-v>, B<-->, B<-uPackname>, B<-D>, B<-Do>, B<-Dc>, B<-DA>,
9500 B<-DC>, B<-DM>, B<-f>, B<-fcog>, B<-fsave-data>, B<-fppaddr>, B<-fwarn-sv>,
9501 B<-fuse-script-name>, B<-fsave-sig-hash>, B<-On>, B<-O0>, B<-O1>, B<-O2>,
9502 B<-llimit>
9503
9504 =item EXAMPLES
9505
9506 =item BUGS
9507
9508 =item AUTHOR
9509
9510 =back
9511
9512 =head2 B::CC - Perl compiler's optimized C translation backend
9513
9514 =over 4
9515
9516 =item SYNOPSIS
9517
9518 =item DESCRIPTION
9519
9520 =item OPTIONS
9521
9522 B<-ofilename>, B<-v>, B<-->, B<-uPackname>, B<-mModulename>, B<-D>, B<-Dr>,
9523 B<-DO>, B<-Ds>, B<-Dp>, B<-Dq>, B<-Dl>, B<-Dt>, B<-f>,
9524 B<-ffreetmps-each-bblock>, B<-ffreetmps-each-loop>, B<-fomit-taint>, B<-On>
9525
9526 =item EXAMPLES
9527
9528 =item BUGS
9529
9530 =item DIFFERENCES
9531
9532 =over 4
9533
9534 =item Loops
9535
9536 =item Context of ".."
9537
9538 =item Arithmetic
9539
9540 =item Deprecated features
9541
9542 =back
9543
9544 =item AUTHOR
9545
9546 =back
9547
9548 =head2 B::Concise - Walk Perl syntax tree, printing concise info about ops
9549
9550 =over 4
9551
9552 =item SYNOPSIS
9553
9554 =item DESCRIPTION
9555
9556 =item EXAMPLE
9557
9558 =item OPTIONS
9559
9560 B<-basic>, B<-exec>, B<-tree>, B<-compact>, B<-loose>, B<-vt>, B<-ascii>,
9561 B<-main>, B<-base>I<n>, B<-bigendian>, B<-littleendian>, B<-concise>,
9562 B<-terse>, B<-linenoise>, B<-debug>, B<-env>
9563
9564 =item FORMATTING SPECIFICATIONS
9565
9566 B<(x(>I<exec_text>B<;>I<basic_text>B<)x)>, B<(*(>I<text>B<)*)>,
9567 B<(*(>I<text1>B<;>I<text2>B<)*)>, B<(?(>I<text1>B<#>I<var>I<Text2>B<)?)>,
9568 B<#>I<var>, B<#>I<var>I<N>, B<~>, B<#addr>, B<#arg>, B<#class>,
9569 B<#classsym>, B<#coplabel>, B<#exname>, B<#extarg>, B<#firstaddr>,
9570 B<#flags>, B<#flagval>, B<#hyphseq>, B<#label>, B<#lastaddr>, B<#name>,
9571 B<#NAME>, B<#next>, B<#nextaddr>, B<#noise>, B<#private>, B<#privval>,
9572 B<#seq>, B<#seqnum>, B<#sibaddr>, B<#svaddr>, B<#svclass>, B<#svval>,
9573 B<#targ>, B<#targarg>, B<#targarglife>, B<#typenum>
9574
9575 =item ABBREVIATIONS
9576
9577 =over 4
9578
9579 =item OP flags abbreviations
9580
9581 =item OP class abbreviations
9582
9583 =back
9584
9585 =item Using B::Concise outside of the O framework
9586
9587 =item AUTHOR
9588
9589 =back
9590
9591 =head2 B::Debug - Walk Perl syntax tree, printing debug info about ops
9592
9593 =over 4
9594
9595 =item SYNOPSIS
9596
9597 =item DESCRIPTION
9598
9599 =item AUTHOR
9600
9601 =back
9602
9603 =head2 B::Deparse - Perl compiler backend to produce perl code
9604
9605 =over 4
9606
9607 =item SYNOPSIS
9608
9609 =item DESCRIPTION
9610
9611 =item OPTIONS
9612
9613 B<-l>, B<-p>, B<-P>, B<-q>, B<-f>I<FILE>, B<-s>I<LETTERS>, B<C>,
9614 B<i>I<NUMBER>, B<T>, B<v>I<STRING>B<.>, B<-x>I<LEVEL>
9615
9616 =item USING B::Deparse AS A MODULE
9617
9618 =over 4
9619
9620 =item Synopsis
9621
9622 =item Description
9623
9624 =item new
9625
9626 =item ambient_pragmas
9627
9628 strict, $[, bytes, utf8, integer, re, warnings, hint_bits, warning_bits
9629
9630 =item coderef2text
9631
9632 =back
9633
9634 =item BUGS
9635
9636 =item AUTHOR
9637
9638 =back
9639
9640 =head2 B::Disassembler - Disassemble Perl bytecode
9641
9642 =over 4
9643
9644 =item SYNOPSIS
9645
9646 =item DESCRIPTION
9647
9648 =item AUTHOR
9649
9650 =back
9651
9652 =head2 B::Lint - Perl lint
9653
9654 =over 4
9655
9656 =item SYNOPSIS
9657
9658 =item DESCRIPTION
9659
9660 =item OPTIONS AND LINT CHECKS
9661
9662 B<context>, B<implicit-read> and B<implicit-write>, B<dollar-underscore>,
9663 B<private-names>, B<undefined-subs>, B<regexp-variables>, B<all>, B<none>
9664
9665 =item NON LINT-CHECK OPTIONS
9666
9667 B<-u Package>
9668
9669 =item BUGS
9670
9671 =item AUTHOR
9672
9673 =back
9674
9675 =head2 B::O, O - Generic interface to Perl Compiler backends
9676
9677 =over 4
9678
9679 =item SYNOPSIS
9680
9681 =item DESCRIPTION
9682
9683 =item CONVENTIONS
9684
9685 =item IMPLEMENTATION
9686
9687 =item BUGS
9688
9689 =item AUTHOR
9690
9691 =back
9692
9693 =head2 B::Showlex - Show lexical variables used in functions or files
9694
9695 =over 4
9696
9697 =item SYNOPSIS
9698
9699 =item DESCRIPTION
9700
9701 =item AUTHOR
9702
9703 =back
9704
9705 =head2 B::Stackobj - Helper module for CC backend
9706
9707 =over 4
9708
9709 =item SYNOPSIS
9710
9711 =item DESCRIPTION
9712
9713 =item AUTHOR
9714
9715 =back
9716
9717 =head2 B::Stash - show what stashes are loaded
9718
9719 =head2 B::Terse - Walk Perl syntax tree, printing terse info about ops
9720
9721 =over 4
9722
9723 =item SYNOPSIS
9724
9725 =item DESCRIPTION
9726
9727 =item AUTHOR
9728
9729 =back
9730
9731 =head2 B::Xref - Generates cross reference reports for Perl programs
9732
9733 =over 4
9734
9735 =item SYNOPSIS
9736
9737 =item DESCRIPTION
9738
9739 =item OPTIONS
9740
9741 C<-oFILENAME>, C<-r>, C<-d>, C<-D[tO]>
9742
9743 =item BUGS
9744
9745 =item AUTHOR
9746
9747 =back
9748
9749 =head2 Bblock, B::Bblock - Walk basic blocks
9750
9751 =over 4
9752
9753 =item SYNOPSIS
9754
9755 =item DESCRIPTION
9756
9757 =over 4
9758
9759 =item Functions
9760
9761 B<find_leaders>
9762
9763 =back
9764
9765 =item AUTHOR
9766
9767 =back
9768
9769 =head2 Benchmark - benchmark running times of Perl code
9770
9771 =over 4
9772
9773 =item SYNOPSIS
9774
9775 =item DESCRIPTION
9776
9777 =over 4
9778
9779 =item Methods
9780
9781 new, debug, iters
9782
9783 =item Standard Exports
9784
9785 timeit(COUNT, CODE), timethis ( COUNT, CODE, [ TITLE, [ STYLE ]] ),
9786 timethese ( COUNT, CODEHASHREF, [ STYLE ] ), timediff ( T1, T2 ), timestr (
9787 TIMEDIFF, [ STYLE, [ FORMAT ] ] )
9788
9789 =item Optional Exports
9790
9791 clearcache ( COUNT ), clearallcache ( ), cmpthese ( COUT, CODEHASHREF, [
9792 STYLE ] ), cmpthese ( RESULTSHASHREF, [ STYLE ] ), countit(TIME, CODE),
9793 disablecache ( ), enablecache ( ), timesum ( T1, T2 )
9794
9795 =back
9796
9797 =item NOTES
9798
9799 =item EXAMPLES
9800
9801 =item INHERITANCE
9802
9803 =item CAVEATS
9804
9805 =item SEE ALSO
9806
9807 =item AUTHORS
9808
9809 =item MODIFICATION HISTORY
9810
9811 =back
9812
9813 =head2 ByteLoader - load byte compiled perl code
9814
9815 =over 4
9816
9817 =item SYNOPSIS
9818
9819 =item DESCRIPTION
9820
9821 =item AUTHOR
9822
9823 =item SEE ALSO
9824
9825 =back
9826
9827 =head2 Bytecode, B::Bytecode - Perl compiler's bytecode backend
9828
9829 =over 4
9830
9831 =item SYNOPSIS
9832
9833 =item DESCRIPTION
9834
9835 =item OPTIONS
9836
9837 B<-ofilename>, B<-afilename>, B<-->, B<-f>, B<-fcompress-nullops>,
9838 B<-fomit-sequence-numbers>, B<-fbypass-nullops>, B<-On>, B<-D>, B<-Do>,
9839 B<-Db>, B<-Da>, B<-DC>, B<-S>, B<-upackage>
9840
9841 =item EXAMPLES
9842
9843 =item BUGS
9844
9845 =item AUTHORS
9846
9847 =back
9848
9849 =head2 CGI - Simple Common Gateway Interface Class
9850
9851 =over 4
9852
9853 =item SYNOPSIS
9854
9855 =item ABSTRACT
9856
9857 =item DESCRIPTION
9858
9859 =over 4
9860
9861 =item PROGRAMMING STYLE
9862
9863 =item CALLING CGI.PM ROUTINES
9864
9865 =item CREATING A NEW QUERY OBJECT (OBJECT-ORIENTED STYLE):
9866
9867 =item CREATING A NEW QUERY OBJECT FROM AN INPUT FILE
9868
9869 =item FETCHING A LIST OF KEYWORDS FROM THE QUERY:
9870
9871 =item FETCHING THE NAMES OF ALL THE PARAMETERS PASSED TO YOUR SCRIPT:
9872
9873 =item FETCHING THE VALUE OR VALUES OF A SINGLE NAMED PARAMETER:
9874
9875 =item SETTING THE VALUE(S) OF A NAMED PARAMETER:
9876
9877 =item APPENDING ADDITIONAL VALUES TO A NAMED PARAMETER:
9878
9879 =item IMPORTING ALL PARAMETERS INTO A NAMESPACE:
9880
9881 =item DELETING A PARAMETER COMPLETELY:
9882
9883 =item DELETING ALL PARAMETERS:
9884
9885 =item DIRECT ACCESS TO THE PARAMETER LIST:
9886
9887 =item FETCHING THE PARAMETER LIST AS A HASH:
9888
9889 =item SAVING THE STATE OF THE SCRIPT TO A FILE:
9890
9891 =item RETRIEVING CGI ERRORS
9892
9893 =item USING THE FUNCTION-ORIENTED INTERFACE
9894
9895 B<:cgi>, B<:form>, B<:html2>, B<:html3>, B<:html4>, B<:netscape>, B<:html>,
9896 B<:standard>, B<:all>
9897
9898 =item PRAGMAS
9899
9900 -any, -compile, -nosticky, -no_undef_params, -no_xhtml, -nph,
9901 -newstyle_urls, -oldstyle_urls, -autoload, -no_debug, -debug,
9902 -private_tempfiles
9903
9904 =item SPECIAL FORMS FOR IMPORTING HTML-TAG FUNCTIONS
9905
9906 1. start_table() (generates a <table> tag), 2. end_table() (generates a
9907 </table> tag), 3. start_ul() (generates a <ul> tag), 4. end_ul() (generates
9908 a </ul> tag)
9909
9910 =back
9911
9912 =item GENERATING DYNAMIC DOCUMENTS
9913
9914 =over 4
9915
9916 =item CREATING A STANDARD HTTP HEADER:
9917
9918 =item GENERATING A REDIRECTION HEADER
9919
9920 =item CREATING THE HTML DOCUMENT HEADER
9921
9922 B<Parameters:>, 4, 5, 6..
9923
9924 =item ENDING THE HTML DOCUMENT:
9925
9926 =item CREATING A SELF-REFERENCING URL THAT PRESERVES STATE INFORMATION:
9927
9928 =item OBTAINING THE SCRIPT'S URL
9929
9930 B<-absolute>, B<-relative>, B<-full>, B<-path> (B<-path_info>), B<-query>
9931 (B<-query_string>), B<-base>
9932
9933 =item MIXING POST AND URL PARAMETERS
9934
9935 =back
9936
9937 =item CREATING STANDARD HTML ELEMENTS:
9938
9939 =over 4
9940
9941 =item PROVIDING ARGUMENTS TO HTML SHORTCUTS
9942
9943 =item THE DISTRIBUTIVE PROPERTY OF HTML SHORTCUTS
9944
9945 =item HTML SHORTCUTS AND LIST INTERPOLATION
9946
9947 =item NON-STANDARD HTML SHORTCUTS
9948
9949 =item AUTOESCAPING HTML
9950
9951 $escaped_string = escapeHTML("unescaped string");, $charset =
9952 charset([$charset]);, $flag = autoEscape([$flag]);
9953
9954 =item PRETTY-PRINTING HTML
9955
9956 =back
9957
9958 =item CREATING FILL-OUT FORMS:
9959
9960 =over 4
9961
9962 =item CREATING AN ISINDEX TAG
9963
9964 =item STARTING AND ENDING A FORM
9965
9966 B<application/x-www-form-urlencoded>, B<multipart/form-data>
9967
9968 =item CREATING A TEXT FIELD
9969
9970 B<Parameters>
9971
9972 =item CREATING A BIG TEXT FIELD
9973
9974 =item CREATING A PASSWORD FIELD
9975
9976 =item CREATING A FILE UPLOAD FIELD
9977
9978 B<Parameters>
9979
9980 =item CREATING A POPUP MENU
9981
9982 =item CREATING A SCROLLING LIST
9983
9984 B<Parameters:>
9985
9986 =item CREATING A GROUP OF RELATED CHECKBOXES
9987
9988 B<Parameters:>
9989
9990 =item CREATING A STANDALONE CHECKBOX
9991
9992 B<Parameters:>
9993
9994 =item CREATING A RADIO BUTTON GROUP
9995
9996 B<Parameters:>
9997
9998 =item CREATING A SUBMIT BUTTON
9999
10000 B<Parameters:>
10001
10002 =item CREATING A RESET BUTTON
10003
10004 =item CREATING A DEFAULT BUTTON
10005
10006 =item CREATING A HIDDEN FIELD
10007
10008 B<Parameters:>
10009
10010 =item CREATING A CLICKABLE IMAGE BUTTON
10011
10012 B<Parameters:>
10013
10014 =item CREATING A JAVASCRIPT ACTION BUTTON
10015
10016 =back
10017
10018 =item HTTP COOKIES
10019
10020 1. an expiration time, 2. a domain, 3. a path, 4. a "secure" flag,
10021 B<-name>, B<-value>, B<-path>, B<-domain>, B<-expires>, B<-secure>
10022
10023 =item WORKING WITH FRAMES
10024
10025 1. Create a <Frameset> document, 2. Specify the destination for the
10026 document in the HTTP header, 3. Specify the destination for the document in
10027 the <form> tag
10028
10029 =item LIMITED SUPPORT FOR CASCADING STYLE SHEETS
10030
10031 =item DEBUGGING
10032
10033 =over 4
10034
10035 =item DUMPING OUT ALL THE NAME/VALUE PAIRS
10036
10037 =back
10038
10039 =item FETCHING ENVIRONMENT VARIABLES
10040
10041 B<Accept()>, B<raw_cookie()>, B<user_agent()>, B<path_info()>,
10042 B<path_translated()>, B<remote_host()>, B<script_name()>, B<referer()>,
10043 B<auth_type ()>, B<server_name ()>, B<virtual_host ()>, B<server_port ()>,
10044 B<server_software ()>, B<remote_user ()>, B<user_name ()>,
10045 B<request_method()>, B<content_type()>, B<http()>, B<https()>
10046
10047 =item USING NPH SCRIPTS
10048
10049 In the B<use> statement, By calling the B<nph()> method:, By using B<-nph>
10050 parameters
10051
10052 =item Server Push
10053
10054 multipart_init(), multipart_start(), multipart_end(), multipart_final()
10055
10056 =item Avoiding Denial of Service Attacks
10057
10058 B<$CGI::POST_MAX>, B<$CGI::DISABLE_UPLOADS>, B<1. On a script-by-script
10059 basis>, B<2. Globally for all scripts>
10060
10061 =item COMPATIBILITY WITH CGI-LIB.PL
10062
10063 =item AUTHOR INFORMATION
10064
10065 =item CREDITS
10066
10067 Matt Heffron (heffron@falstaff.css.beckman.com), James Taylor
10068 (james.taylor@srs.gov), Scott Anguish <sanguish@digifix.com>, Mike Jewell
10069 (mlj3u@virginia.edu), Timothy Shimmin (tes@kbs.citri.edu.au), Joergen Haegg
10070 (jh@axis.se), Laurent Delfosse (delfosse@delfosse.com), Richard Resnick
10071 (applepi1@aol.com), Craig Bishop (csb@barwonwater.vic.gov.au), Tony Curtis
10072 (tc@vcpc.univie.ac.at), Tim Bunce (Tim.Bunce@ig.co.uk), Tom Christiansen
10073 (tchrist@convex.com), Andreas Koenig (k@franz.ww.TU-Berlin.DE), Tim
10074 MacKenzie (Tim.MacKenzie@fulcrum.com.au), Kevin B. Hendricks
10075 (kbhend@dogwood.tyler.wm.edu), Stephen Dahmen (joyfire@inxpress.net), Ed
10076 Jordan (ed@fidalgo.net), David Alan Pisoni (david@cnation.com), Doug
10077 MacEachern (dougm@opengroup.org), Robin Houston (robin@oneworld.org),
10078 ...and many many more..
10079
10080 =item A COMPLETE EXAMPLE OF A SIMPLE FORM-BASED SCRIPT
10081
10082 =item BUGS
10083
10084 =item SEE ALSO
10085
10086 =back
10087
10088 =head2 CGI::Apache - Backward compatibility module for CGI.pm
10089
10090 =over 4
10091
10092 =item SYNOPSIS
10093
10094 =item ABSTRACT
10095
10096 =item DESCRIPTION
10097
10098 =item AUTHOR INFORMATION
10099
10100 =item BUGS
10101
10102 =item SEE ALSO
10103
10104 =back
10105
10106 =head2 CGI::Carp, B<CGI::Carp> - CGI routines for writing to the HTTPD (or
10107 other) error log
10108
10109 =over 4
10110
10111 =item SYNOPSIS
10112
10113 =item DESCRIPTION
10114
10115 =item REDIRECTING ERROR MESSAGES
10116
10117 =item MAKING PERL ERRORS APPEAR IN THE BROWSER WINDOW
10118
10119 =over 4
10120
10121 =item Changing the default message
10122
10123 =back
10124
10125 =item MAKING WARNINGS APPEAR AS HTML COMMENTS
10126
10127 =item CHANGE LOG
10128
10129 =item AUTHORS
10130
10131 =item SEE ALSO
10132
10133 =back
10134
10135 =head2 CGI::Cookie - Interface to Netscape Cookies
10136
10137 =over 4
10138
10139 =item SYNOPSIS
10140
10141 =item DESCRIPTION
10142
10143 =item USING CGI::Cookie
10144
10145 B<1. expiration date>, B<2. domain>, B<3. path>, B<4. secure flag>
10146
10147 =over 4
10148
10149 =item Creating New Cookies
10150
10151 =item Sending the Cookie to the Browser
10152
10153 =item Recovering Previous Cookies
10154
10155 =item Manipulating Cookies
10156
10157 B<name()>, B<value()>, B<domain()>, B<path()>, B<expires()>
10158
10159 =back
10160
10161 =item AUTHOR INFORMATION
10162
10163 =item BUGS
10164
10165 =item SEE ALSO
10166
10167 =back
10168
10169 =head2 CGI::Fast - CGI Interface for Fast CGI
10170
10171 =over 4
10172
10173 =item SYNOPSIS
10174
10175 =item DESCRIPTION
10176
10177 =item OTHER PIECES OF THE PUZZLE
10178
10179 =item WRITING FASTCGI PERL SCRIPTS
10180
10181 =item INSTALLING FASTCGI SCRIPTS
10182
10183 =item USING FASTCGI SCRIPTS AS CGI SCRIPTS
10184
10185 =item EXTERNAL FASTCGI SERVER INVOCATION
10186
10187 FCGI_SOCKET_PATH, FCGI_LISTEN_QUEUE
10188
10189 =item CAVEATS
10190
10191 =item AUTHOR INFORMATION
10192
10193 =item BUGS
10194
10195 =item SEE ALSO
10196
10197 =back
10198
10199 =head2 CGI::Pretty - module to produce nicely formatted HTML code
10200
10201 =over 4
10202
10203 =item SYNOPSIS
10204
10205 =item DESCRIPTION
10206
10207 =over 4
10208
10209 =item Tags that won't be formatted
10210
10211 =item Customizing the Indenting
10212
10213 =back
10214
10215 =item BUGS
10216
10217 =item AUTHOR
10218
10219 =item SEE ALSO
10220
10221 =back
10222
10223 =head2 CGI::Push - Simple Interface to Server Push
10224
10225 =over 4
10226
10227 =item SYNOPSIS
10228
10229 =item DESCRIPTION
10230
10231 =item USING CGI::Push
10232
10233 -next_page, -last_page, -type, -delay, -cookie, -target, -expires, -nph
10234
10235 =over 4
10236
10237 =item Heterogeneous Pages
10238
10239 =item Changing the Page Delay on the Fly
10240
10241 =back
10242
10243 =item INSTALLING CGI::Push SCRIPTS
10244
10245 =item AUTHOR INFORMATION
10246
10247 =item BUGS
10248
10249 =item SEE ALSO
10250
10251 =back
10252
10253 =head2 CGI::Switch - Backward compatibility module for defunct CGI::Switch
10254
10255 =over 4
10256
10257 =item SYNOPSIS
10258
10259 =item ABSTRACT
10260
10261 =item DESCRIPTION
10262
10263 =item AUTHOR INFORMATION
10264
10265 =item BUGS
10266
10267 =item SEE ALSO
10268
10269 =back
10270
10271 =head2 CGI::Util - Internal utilities used by CGI module
10272
10273 =over 4
10274
10275 =item SYNOPSIS
10276
10277 =item DESCRIPTION
10278
10279 =item AUTHOR INFORMATION
10280
10281 =item SEE ALSO
10282
10283 =back
10284
10285 =head2 CPAN - query, download and build perl modules from CPAN sites
10286
10287 =over 4
10288
10289 =item SYNOPSIS
10290
10291 =item DESCRIPTION
10292
10293 =over 4
10294
10295 =item Interactive Mode
10296
10297 Searching for authors, bundles, distribution files and modules, make, test,
10298 install, clean  modules or distributions, get, readme, look module or
10299 distribution, ls author, Signals
10300
10301 =item CPAN::Shell
10302
10303 =item autobundle
10304
10305 =item recompile
10306
10307 =item The four C<CPAN::*> Classes: Author, Bundle, Module, Distribution
10308
10309 =item Programmer's interface
10310
10311 expand($type,@things), expandany(@things), Programming Examples
10312
10313 =item Methods in the other Classes
10314
10315 CPAN::Author::as_glimpse(), CPAN::Author::as_string(),
10316 CPAN::Author::email(), CPAN::Author::fullname(), CPAN::Author::name(),
10317 CPAN::Bundle::as_glimpse(), CPAN::Bundle::as_string(),
10318 CPAN::Bundle::clean(), CPAN::Bundle::contains(),
10319 CPAN::Bundle::force($method,@args), CPAN::Bundle::get(),
10320 CPAN::Bundle::inst_file(), CPAN::Bundle::inst_version(),
10321 CPAN::Bundle::uptodate(), CPAN::Bundle::install(), CPAN::Bundle::make(),
10322 CPAN::Bundle::readme(), CPAN::Bundle::test(),
10323 CPAN::Distribution::as_glimpse(), CPAN::Distribution::as_string(),
10324 CPAN::Distribution::clean(), CPAN::Distribution::containsmods(),
10325 CPAN::Distribution::cvs_import(), CPAN::Distribution::dir(),
10326 CPAN::Distribution::force($method,@args), CPAN::Distribution::get(),
10327 CPAN::Distribution::install(), CPAN::Distribution::isa_perl(),
10328 CPAN::Distribution::look(), CPAN::Distribution::make(),
10329 CPAN::Distribution::prereq_pm(), CPAN::Distribution::readme(),
10330 CPAN::Distribution::test(), CPAN::Distribution::uptodate(),
10331 CPAN::Index::force_reload(), CPAN::Index::reload(), CPAN::InfoObj::dump(),
10332 CPAN::Module::as_glimpse(), CPAN::Module::as_string(),
10333 CPAN::Module::clean(), CPAN::Module::cpan_file(),
10334 CPAN::Module::cpan_version(), CPAN::Module::cvs_import(),
10335 CPAN::Module::description(), CPAN::Module::force($method,@args),
10336 CPAN::Module::get(), CPAN::Module::inst_file(),
10337 CPAN::Module::inst_version(), CPAN::Module::install(),
10338 CPAN::Module::look(), CPAN::Module::make(),
10339 CPAN::Module::manpage_headline(), CPAN::Module::readme(),
10340 CPAN::Module::test(), CPAN::Module::uptodate(), CPAN::Module::userid()
10341
10342 =item Cache Manager
10343
10344 =item Bundles
10345
10346 =item Prerequisites
10347
10348 =item Finding packages and VERSION
10349
10350 =item Debugging
10351
10352 =item Floppy, Zip, Offline Mode
10353
10354 =back
10355
10356 =item CONFIGURATION
10357
10358 C<o conf E<lt>scalar optionE<gt>>, C<o conf E<lt>scalar optionE<gt>
10359 E<lt>valueE<gt>>, C<o conf E<lt>list optionE<gt>>, C<o conf E<lt>list
10360 optionE<gt> [shift|pop]>, C<o conf E<lt>list optionE<gt>
10361 [unshift|push|splice] E<lt>listE<gt>>
10362
10363 =over 4
10364
10365 =item Note on urllist parameter's format
10366
10367 =item urllist parameter has CD-ROM support
10368
10369 =back
10370
10371 =item SECURITY
10372
10373 =item EXPORT
10374
10375 =item POPULATE AN INSTALLATION WITH LOTS OF MODULES
10376
10377 =item WORKING WITH CPAN.pm BEHIND FIREWALLS
10378
10379 =over 4
10380
10381 =item Three basic types of firewalls
10382
10383 http firewall, ftp firewall, One way visibility, SOCKS, IP Masquerade
10384
10385 =item Configuring lynx or ncftp for going through a firewall
10386
10387 =back
10388
10389 =item FAQ
10390
10391 1), 2), 3), 4), 5), 6), 7), 8), 9), 10)
10392
10393 =item BUGS
10394
10395 =item AUTHOR
10396
10397 =item TRANSLATIONS
10398
10399 =item SEE ALSO
10400
10401 =back
10402
10403 =head2 CPAN::FirstTime - Utility for CPAN::Config file Initialization
10404
10405 =over 4
10406
10407 =item SYNOPSIS
10408
10409 =item DESCRIPTION
10410
10411 =back
10412
10413 =head2 CPANox, CPAN::Nox - Wrapper around CPAN.pm without using any XS
10414 module
10415
10416 =over 4
10417
10418 =item SYNOPSIS
10419
10420 =item DESCRIPTION
10421
10422 =item  SEE ALSO
10423
10424 =back
10425
10426 =head2 Carp, carp    - warn of errors (from perspective of caller)
10427
10428 =over 4
10429
10430 =item SYNOPSIS
10431
10432 =item DESCRIPTION
10433
10434 =over 4
10435
10436 =item Forcing a Stack Trace
10437
10438 =back
10439
10440 =item BUGS
10441
10442 =back
10443
10444 =head2 Carp::Heavy, Carp heavy machinery - no user serviceable parts inside
10445
10446 =head2 Class::ISA -- report the search path for a class's ISA tree
10447
10448 =over 4
10449
10450 =item SYNOPSIS
10451
10452 =item DESCRIPTION
10453
10454 =item FUNCTIONS
10455
10456 the function Class::ISA::super_path($CLASS), the function
10457 Class::ISA::self_and_super_path($CLASS), the function
10458 Class::ISA::self_and_super_versions($CLASS)
10459
10460 =item CAUTIONARY NOTES
10461
10462 =item COPYRIGHT
10463
10464 =item AUTHOR
10465
10466 =back
10467
10468 =head2 Class::Struct - declare struct-like datatypes as Perl classes
10469
10470 =over 4
10471
10472 =item SYNOPSIS
10473
10474 =item DESCRIPTION
10475
10476 =over 4
10477
10478 =item The C<struct()> function
10479
10480 =item Class Creation at Compile Time
10481
10482 =item Element Types and Accessor Methods
10483
10484 Scalar (C<'$'> or C<'*$'>), Array (C<'@'> or C<'*@'>), Hash (C<'%'> or
10485 C<'*%'>), Class (C<'Class_Name'> or C<'*Class_Name'>)
10486
10487 =item Initializing with C<new>
10488
10489 =back
10490
10491 =item EXAMPLES
10492
10493 Example 1, Example 2, Example 3
10494
10495 =item Author and Modification History
10496
10497 =back
10498
10499 =head2 Config - access Perl configuration information
10500
10501 =over 4
10502
10503 =item SYNOPSIS
10504
10505 =item DESCRIPTION
10506
10507 myconfig(), config_sh(), config_vars(@names)
10508
10509 =item EXAMPLE
10510
10511 =item WARNING
10512
10513 =item GLOSSARY
10514
10515 =over 4
10516
10517 =item _
10518
10519 C<_a>, C<_exe>, C<_o>
10520
10521 =item a
10522
10523 C<afs>, C<afsroot>, C<alignbytes>, C<ansi2knr>, C<aphostname>,
10524 C<api_revision>, C<api_subversion>, C<api_version>, C<api_versionstring>,
10525 C<ar>, C<archlib>, C<archlibexp>, C<archname64>, C<archname>, C<archobjs>,
10526 C<asctime_r_proto>, C<awk>
10527
10528 =item b
10529
10530 C<baserev>, C<bash>, C<bin>, C<binexp>, C<bison>, C<byacc>, C<byteorder>
10531
10532 =item c
10533
10534 C<c>, C<castflags>, C<cat>, C<cc>, C<cccdlflags>, C<ccdlflags>, C<ccflags>,
10535 C<ccflags_uselargefiles>, C<ccname>, C<ccsymbols>, C<ccversion>, C<cf_by>,
10536 C<cf_email>, C<cf_time>, C<charsize>, C<chgrp>, C<chmod>, C<chown>,
10537 C<clocktype>, C<comm>, C<compress>, C<contains>, C<cp>, C<cpio>, C<cpp>,
10538 C<cpp_stuff>, C<cppccsymbols>, C<cppflags>, C<cpplast>, C<cppminus>,
10539 C<cpprun>, C<cppstdin>, C<cppsymbols>, C<crypt_r_proto>, C<cryptlib>,
10540 C<csh>, C<ctermid_r_proto>, C<ctime_r_proto>
10541
10542 =item d
10543
10544 C<d__fwalk>, C<d_access>, C<d_accessx>, C<d_alarm>, C<d_archlib>,
10545 C<d_asctime_r>, C<d_atolf>, C<d_atoll>, C<d_attribut>, C<d_bcmp>,
10546 C<d_bcopy>, C<d_bsd>, C<d_bsdgetpgrp>, C<d_bsdsetpgrp>, C<d_bzero>,
10547 C<d_casti32>, C<d_castneg>, C<d_charvspr>, C<d_chown>, C<d_chroot>,
10548 C<d_chsize>, C<d_class>, C<d_closedir>, C<d_cmsghdr_s>, C<d_const>,
10549 C<d_crypt>, C<d_crypt_r>, C<d_csh>, C<d_ctermid_r>, C<d_ctime_r>,
10550 C<d_cuserid>, C<d_dbl_dig>, C<d_dbminitproto>, C<d_difftime>, C<d_dirfd>,
10551 C<d_dirnamlen>, C<d_dlerror>, C<d_dlopen>, C<d_dlsymun>, C<d_dosuid>,
10552 C<d_drand48_r>, C<d_drand48proto>, C<d_dup2>, C<d_eaccess>, C<d_endgrent>,
10553 C<d_endgrent_r>, C<d_endhent>, C<d_endhostent_r>, C<d_endnent>,
10554 C<d_endnetent_r>, C<d_endpent>, C<d_endprotoent_r>, C<d_endpwent>,
10555 C<d_endpwent_r>, C<d_endsent>, C<d_endservent_r>, C<d_eofnblk>,
10556 C<d_eunice>, C<d_fchdir>, C<d_fchmod>, C<d_fchown>, C<d_fcntl>,
10557 C<d_fcntl_can_lock>, C<d_fd_macros>, C<d_fd_set>, C<d_fds_bits>,
10558 C<d_fgetpos>, C<d_finite>, C<d_finitel>, C<d_flexfnam>, C<d_flock>,
10559 C<d_flockproto>, C<d_fork>, C<d_fp_class>, C<d_fpathconf>, C<d_fpclass>,
10560 C<d_fpclassify>, C<d_fpclassl>, C<d_fpos64_t>, C<d_frexpl>, C<d_fs_data_s>,
10561 C<d_fseeko>, C<d_fsetpos>, C<d_fstatfs>, C<d_fstatvfs>, C<d_fsync>,
10562 C<d_ftello>, C<d_ftime>, C<d_Gconvert>, C<d_getcwd>, C<d_getespwnam>,
10563 C<d_getfsstat>, C<d_getgrent>, C<d_getgrent_r>, C<d_getgrgid_r>,
10564 C<d_getgrnam_r>, C<d_getgrps>, C<d_gethbyaddr>, C<d_gethbyname>,
10565 C<d_gethent>, C<d_gethname>, C<d_gethostbyaddr_r>, C<d_gethostbyname_r>,
10566 C<d_gethostent_r>, C<d_gethostprotos>, C<d_getitimer>, C<d_getlogin>,
10567 C<d_getlogin_r>, C<d_getmnt>, C<d_getmntent>, C<d_getnbyaddr>,
10568 C<d_getnbyname>, C<d_getnent>, C<d_getnetbyaddr_r>, C<d_getnetbyname_r>,
10569 C<d_getnetent_r>, C<d_getnetprotos>, C<d_getpagsz>, C<d_getpbyname>,
10570 C<d_getpbynumber>, C<d_getpent>, C<d_getpgid>, C<d_getpgrp2>, C<d_getpgrp>,
10571 C<d_getppid>, C<d_getprior>, C<d_getprotobyname_r>,
10572 C<d_getprotobynumber_r>, C<d_getprotoent_r>, C<d_getprotoprotos>,
10573 C<d_getprpwnam>, C<d_getpwent>, C<d_getpwent_r>, C<d_getpwnam_r>,
10574 C<d_getpwuid_r>, C<d_getsbyname>, C<d_getsbyport>, C<d_getsent>,
10575 C<d_getservbyname_r>, C<d_getservbyport_r>, C<d_getservent_r>,
10576 C<d_getservprotos>, C<d_getspnam>, C<d_getspnam_r>, C<d_gettimeod>,
10577 C<d_gmtime_r>, C<d_gnulibc>, C<d_grpasswd>, C<d_hasmntopt>, C<d_htonl>,
10578 C<d_index>, C<d_inetaton>, C<d_int64_t>, C<d_isascii>, C<d_isfinite>,
10579 C<d_isinf>, C<d_isnan>, C<d_isnanl>, C<d_killpg>, C<d_lchown>,
10580 C<d_ldbl_dig>, C<d_link>, C<d_localtime_r>, C<d_locconv>, C<d_lockf>,
10581 C<d_longdbl>, C<d_longlong>, C<d_lseekproto>, C<d_lstat>, C<d_madvise>,
10582 C<d_mblen>, C<d_mbstowcs>, C<d_mbtowc>, C<d_memchr>, C<d_memcmp>,
10583 C<d_memcpy>, C<d_memmove>, C<d_memset>, C<d_mkdir>, C<d_mkdtemp>,
10584 C<d_mkfifo>, C<d_mkstemp>, C<d_mkstemps>, C<d_mktime>, C<d_mmap>,
10585 C<d_modfl>, C<d_modfl_pow32_bug>, C<d_mprotect>, C<d_msg>, C<d_msg_ctrunc>,
10586 C<d_msg_dontroute>, C<d_msg_oob>, C<d_msg_peek>, C<d_msg_proxy>,
10587 C<d_msgctl>, C<d_msgget>, C<d_msghdr_s>, C<d_msgrcv>, C<d_msgsnd>,
10588 C<d_msync>, C<d_munmap>, C<d_mymalloc>, C<d_nice>, C<d_nl_langinfo>,
10589 C<d_nv_preserves_uv>, C<d_off64_t>, C<d_old_pthread_create_joinable>,
10590 C<d_oldpthreads>, C<d_oldsock>, C<d_open3>, C<d_pathconf>, C<d_pause>,
10591 C<d_perl_otherlibdirs>, C<d_phostname>, C<d_pipe>, C<d_poll>,
10592 C<d_portable>, C<d_PRId64>, C<d_PRIeldbl>, C<d_PRIEUldbl>, C<d_PRIfldbl>,
10593 C<d_PRIFUldbl>, C<d_PRIgldbl>, C<d_PRIGUldbl>, C<d_PRIi64>, C<d_PRIo64>,
10594 C<d_PRIu64>, C<d_PRIx64>, C<d_PRIXU64>, C<d_procselfexe>,
10595 C<d_pthread_atfork>, C<d_pthread_yield>, C<d_pwage>, C<d_pwchange>,
10596 C<d_pwclass>, C<d_pwcomment>, C<d_pwexpire>, C<d_pwgecos>, C<d_pwpasswd>,
10597 C<d_pwquota>, C<d_qgcvt>, C<d_quad>, C<d_random_r>, C<d_readdir64_r>,
10598 C<d_readdir>, C<d_readdir_r>, C<d_readlink>, C<d_readv>, C<d_recvmsg>,
10599 C<d_rename>, C<d_rewinddir>, C<d_rmdir>, C<d_safebcpy>, C<d_safemcpy>,
10600 C<d_sanemcmp>, C<d_sbrkproto>, C<d_sched_yield>, C<d_scm_rights>,
10601 C<d_SCNfldbl>, C<d_seekdir>, C<d_select>, C<d_sem>, C<d_semctl>,
10602 C<d_semctl_semid_ds>, C<d_semctl_semun>, C<d_semget>, C<d_semop>,
10603 C<d_sendmsg>, C<d_setegid>, C<d_seteuid>, C<d_setgrent>, C<d_setgrent_r>,
10604 C<d_setgrps>, C<d_sethent>, C<d_sethostent_r>, C<d_setitimer>,
10605 C<d_setlinebuf>, C<d_setlocale>, C<d_setlocale_r>, C<d_setnent>,
10606 C<d_setnetent_r>, C<d_setpent>, C<d_setpgid>, C<d_setpgrp2>, C<d_setpgrp>,
10607 C<d_setprior>, C<d_setproctitle>, C<d_setprotoent_r>, C<d_setpwent>,
10608 C<d_setpwent_r>, C<d_setregid>, C<d_setresgid>, C<d_setresuid>,
10609 C<d_setreuid>, C<d_setrgid>, C<d_setruid>, C<d_setsent>, C<d_setservent_r>,
10610 C<d_setsid>, C<d_setvbuf>, C<d_sfio>, C<d_shm>, C<d_shmat>,
10611 C<d_shmatprototype>, C<d_shmctl>, C<d_shmdt>, C<d_shmget>, C<d_sigaction>,
10612 C<d_sigprocmask>, C<d_sigsetjmp>, C<d_sockatmark>, C<d_sockatmarkproto>,
10613 C<d_socket>, C<d_socklen_t>, C<d_sockpair>, C<d_socks5_init>, C<d_sqrtl>,
10614 C<d_srand48_r>, C<d_srandom_r>, C<d_sresgproto>, C<d_sresuproto>,
10615 C<d_statblks>, C<d_statfs_f_flags>, C<d_statfs_s>, C<d_statvfs>,
10616 C<d_stdio_cnt_lval>, C<d_stdio_ptr_lval>, C<d_stdio_ptr_lval_nochange_cnt>,
10617 C<d_stdio_ptr_lval_sets_cnt>, C<d_stdio_stream_array>, C<d_stdiobase>,
10618 C<d_stdstdio>, C<d_strchr>, C<d_strcoll>, C<d_strctcpy>, C<d_strerrm>,
10619 C<d_strerror>, C<d_strerror_r>, C<d_strftime>, C<d_strtod>, C<d_strtol>,
10620 C<d_strtold>, C<d_strtoll>, C<d_strtoq>, C<d_strtoul>, C<d_strtoull>,
10621 C<d_strtouq>, C<d_strxfrm>, C<d_suidsafe>, C<d_symlink>, C<d_syscall>,
10622 C<d_syscallproto>, C<d_sysconf>, C<d_sysernlst>, C<d_syserrlst>,
10623 C<d_system>, C<d_tcgetpgrp>, C<d_tcsetpgrp>, C<d_telldir>,
10624 C<d_telldirproto>, C<d_time>, C<d_times>, C<d_tm_tm_gmtoff>,
10625 C<d_tm_tm_zone>, C<d_tmpnam_r>, C<d_truncate>, C<d_ttyname_r>, C<d_tzname>,
10626 C<d_u32align>, C<d_ualarm>, C<d_umask>, C<d_uname>, C<d_union_semun>,
10627 C<d_unordered>, C<d_usleep>, C<d_usleepproto>, C<d_ustat>, C<d_vendorarch>,
10628 C<d_vendorbin>, C<d_vendorlib>, C<d_vfork>, C<d_void_closedir>,
10629 C<d_voidsig>, C<d_voidtty>, C<d_volatile>, C<d_vprintf>, C<d_wait4>,
10630 C<d_waitpid>, C<d_wcstombs>, C<d_wctomb>, C<d_writev>, C<d_xenix>, C<date>,
10631 C<db_hashtype>, C<db_prefixtype>, C<db_version_major>, C<db_version_minor>,
10632 C<db_version_patch>, C<defvoidused>, C<direntrytype>, C<dlext>, C<dlsrc>,
10633 C<doublesize>, C<drand01>, C<drand48_r_proto>, C<dynamic_ext>
10634
10635 =item e
10636
10637 C<eagain>, C<ebcdic>, C<echo>, C<egrep>, C<emacs>, C<endgrent_r_proto>,
10638 C<endhostent_r_proto>, C<endnetent_r_proto>, C<endprotoent_r_proto>,
10639 C<endpwent_r_proto>, C<endservent_r_proto>, C<eunicefix>, C<exe_ext>,
10640 C<expr>, C<extensions>, C<extras>
10641
10642 =item f
10643
10644 C<fflushall>, C<fflushNULL>, C<find>, C<firstmakefile>, C<flex>,
10645 C<fpossize>, C<fpostype>, C<freetype>, C<from>, C<full_ar>, C<full_csh>,
10646 C<full_sed>
10647
10648 =item g
10649
10650 C<gccosandvers>, C<gccversion>, C<getgrent_r_proto>, C<getgrgid_r_proto>,
10651 C<getgrnam_r_proto>, C<gethostbyaddr_r_proto>, C<gethostbyname_r_proto>,
10652 C<gethostent_r_proto>, C<getlogin_r_proto>, C<getnetbyaddr_r_proto>,
10653 C<getnetbyname_r_proto>, C<getnetent_r_proto>, C<getprotobyname_r_proto>,
10654 C<getprotobynumber_r_proto>, C<getprotoent_r_proto>, C<getpwent_r_proto>,
10655 C<getpwnam_r_proto>, C<getpwuid_r_proto>, C<getservbyname_r_proto>,
10656 C<getservbyport_r_proto>, C<getservent_r_proto>, C<getspnam_r_proto>,
10657 C<gidformat>, C<gidsign>, C<gidsize>, C<gidtype>, C<glibpth>, C<gmake>,
10658 C<gmtime_r_proto>, C<gnulibc_version>, C<grep>, C<groupcat>, C<groupstype>,
10659 C<gzip>
10660
10661 =item h
10662
10663 C<h_fcntl>, C<h_sysfile>, C<hint>, C<hostcat>
10664
10665 =item i
10666
10667 C<i16size>, C<i16type>, C<i32size>, C<i32type>, C<i64size>, C<i64type>,
10668 C<i8size>, C<i8type>, C<i_arpainet>, C<i_bsdioctl>, C<i_crypt>, C<i_db>,
10669 C<i_dbm>, C<i_dirent>, C<i_dld>, C<i_dlfcn>, C<i_fcntl>, C<i_float>,
10670 C<i_fp>, C<i_fp_class>, C<i_gdbm>, C<i_grp>, C<i_ieeefp>, C<i_inttypes>,
10671 C<i_langinfo>, C<i_libutil>, C<i_limits>, C<i_locale>, C<i_machcthr>,
10672 C<i_malloc>, C<i_math>, C<i_memory>, C<i_mntent>, C<i_ndbm>, C<i_netdb>,
10673 C<i_neterrno>, C<i_netinettcp>, C<i_niin>, C<i_poll>, C<i_prot>,
10674 C<i_pthread>, C<i_pwd>, C<i_rpcsvcdbm>, C<i_sfio>, C<i_sgtty>, C<i_shadow>,
10675 C<i_socks>, C<i_stdarg>, C<i_stddef>, C<i_stdlib>, C<i_string>,
10676 C<i_sunmath>, C<i_sysaccess>, C<i_sysdir>, C<i_sysfile>, C<i_sysfilio>,
10677 C<i_sysin>, C<i_sysioctl>, C<i_syslog>, C<i_sysmman>, C<i_sysmode>,
10678 C<i_sysmount>, C<i_sysndir>, C<i_sysparam>, C<i_sysresrc>, C<i_syssecrt>,
10679 C<i_sysselct>, C<i_syssockio>, C<i_sysstat>, C<i_sysstatfs>,
10680 C<i_sysstatvfs>, C<i_systime>, C<i_systimek>, C<i_systimes>, C<i_systypes>,
10681 C<i_sysuio>, C<i_sysun>, C<i_sysutsname>, C<i_sysvfs>, C<i_syswait>,
10682 C<i_termio>, C<i_termios>, C<i_time>, C<i_unistd>, C<i_ustat>, C<i_utime>,
10683 C<i_values>, C<i_varargs>, C<i_varhdr>, C<i_vfork>,
10684 C<ignore_versioned_solibs>, C<inc_version_list>, C<inc_version_list_init>,
10685 C<incpath>, C<inews>, C<installarchlib>, C<installbin>, C<installman1dir>,
10686 C<installman3dir>, C<installprefix>, C<installprefixexp>,
10687 C<installprivlib>, C<installscript>, C<installsitearch>, C<installsitebin>,
10688 C<installsitelib>, C<installstyle>, C<installusrbinperl>,
10689 C<installvendorarch>, C<installvendorbin>, C<installvendorlib>, C<intsize>,
10690 C<issymlink>, C<ivdformat>, C<ivsize>, C<ivtype>
10691
10692 =item k
10693
10694 C<known_extensions>, C<ksh>
10695
10696 =item l
10697
10698 C<ld>, C<lddlflags>, C<ldflags>, C<ldflags_uselargefiles>, C<ldlibpthname>,
10699 C<less>, C<lib_ext>, C<libc>, C<libperl>, C<libpth>, C<libs>, C<libsdirs>,
10700 C<libsfiles>, C<libsfound>, C<libspath>, C<libswanted>,
10701 C<libswanted_uselargefiles>, C<line>, C<lint>, C<lkflags>, C<ln>, C<lns>,
10702 C<localtime_r_proto>, C<locincpth>, C<loclibpth>, C<longdblsize>,
10703 C<longlongsize>, C<longsize>, C<lp>, C<lpr>, C<ls>, C<lseeksize>,
10704 C<lseektype>
10705
10706 =item m
10707
10708 C<mail>, C<mailx>, C<make>, C<make_set_make>, C<mallocobj>, C<mallocsrc>,
10709 C<malloctype>, C<man1dir>, C<man1direxp>, C<man1ext>, C<man3dir>,
10710 C<man3direxp>, C<man3ext>
10711
10712 =item M
10713
10714 C<Mcc>, C<mips_type>, C<mkdir>, C<mmaptype>, C<modetype>, C<more>,
10715 C<multiarch>, C<mv>, C<myarchname>, C<mydomain>, C<myhostname>, C<myuname>
10716
10717 =item n
10718
10719 C<n>, C<need_va_copy>, C<netdb_hlen_type>, C<netdb_host_type>,
10720 C<netdb_name_type>, C<netdb_net_type>, C<nm>, C<nm_opt>, C<nm_so_opt>,
10721 C<nonxs_ext>, C<nroff>, C<nv_preserves_uv_bits>, C<nveformat>,
10722 C<nvEUformat>, C<nvfformat>, C<nvFUformat>, C<nvgformat>, C<nvGUformat>,
10723 C<nvsize>, C<nvtype>
10724
10725 =item o
10726
10727 C<o_nonblock>, C<obj_ext>, C<old_pthread_create_joinable>, C<optimize>,
10728 C<orderlib>, C<osname>, C<osvers>, C<otherlibdirs>
10729
10730 =item p
10731
10732 C<package>, C<pager>, C<passcat>, C<patchlevel>, C<path_sep>, C<perl5>,
10733 C<perl>, C<perl_patchlevel>
10734
10735 =item P
10736
10737 C<PERL_REVISION>, C<PERL_SUBVERSION>, C<PERL_VERSION>, C<perladmin>,
10738 C<perllibs>, C<perlpath>, C<pg>, C<phostname>, C<pidtype>, C<plibpth>,
10739 C<pm_apiversion>, C<pmake>, C<pr>, C<prefix>, C<prefixexp>, C<privlib>,
10740 C<privlibexp>, C<procselfexe>, C<prototype>, C<ptrsize>
10741
10742 =item q
10743
10744 C<quadkind>, C<quadtype>
10745
10746 =item r
10747
10748 C<randbits>, C<randfunc>, C<random_r_proto>, C<randseedtype>, C<ranlib>,
10749 C<rd_nodata>, C<readdir64_r_proto>, C<readdir_r_proto>, C<revision>, C<rm>,
10750 C<rmail>, C<run>, C<runnm>
10751
10752 =item s
10753
10754 C<sched_yield>, C<scriptdir>, C<scriptdirexp>, C<sed>, C<seedfunc>,
10755 C<selectminbits>, C<selecttype>, C<sendmail>, C<setgrent_r_proto>,
10756 C<sethostent_r_proto>, C<setlocale_r_proto>, C<setnetent_r_proto>,
10757 C<setprotoent_r_proto>, C<setpwent_r_proto>, C<setservent_r_proto>, C<sh>,
10758 C<shar>, C<sharpbang>, C<shmattype>, C<shortsize>, C<shrpenv>, C<shsharp>,
10759 C<sig_count>, C<sig_name>, C<sig_name_init>, C<sig_num>, C<sig_num_init>,
10760 C<sig_size>, C<signal_t>, C<sitearch>, C<sitearchexp>, C<sitebin>,
10761 C<sitebinexp>, C<sitelib>, C<sitelib_stem>, C<sitelibexp>, C<siteprefix>,
10762 C<siteprefixexp>, C<sizesize>, C<sizetype>, C<sleep>, C<smail>, C<so>,
10763 C<sockethdr>, C<socketlib>, C<socksizetype>, C<sort>, C<spackage>,
10764 C<spitshell>, C<sPRId64>, C<sPRIeldbl>, C<sPRIEUldbl>, C<sPRIfldbl>,
10765 C<sPRIFUldbl>, C<sPRIgldbl>, C<sPRIGUldbl>, C<sPRIi64>, C<sPRIo64>,
10766 C<sPRIu64>, C<sPRIx64>, C<sPRIXU64>, C<srand48_r_proto>,
10767 C<srandom_r_proto>, C<src>, C<sSCNfldbl>, C<ssizetype>, C<startperl>,
10768 C<startsh>, C<static_ext>, C<stdchar>, C<stdio_base>, C<stdio_bufsiz>,
10769 C<stdio_cnt>, C<stdio_filbuf>, C<stdio_ptr>, C<stdio_stream_array>,
10770 C<strerror_r_proto>, C<strings>, C<submit>, C<subversion>, C<sysman>
10771
10772 =item t
10773
10774 C<tail>, C<tar>, C<targetarch>, C<tbl>, C<tee>, C<test>, C<timeincl>,
10775 C<timetype>, C<tmpnam_r_proto>, C<to>, C<touch>, C<tr>, C<trnl>, C<troff>,
10776 C<ttyname_r_proto>
10777
10778 =item u
10779
10780 C<u16size>, C<u16type>, C<u32size>, C<u32type>, C<u64size>, C<u64type>,
10781 C<u8size>, C<u8type>, C<uidformat>, C<uidsign>, C<uidsize>, C<uidtype>,
10782 C<uname>, C<uniq>, C<uquadtype>, C<use5005threads>, C<use64bitall>,
10783 C<use64bitint>, C<usecrosscompile>, C<usedl>, C<useithreads>,
10784 C<uselargefiles>, C<uselongdouble>, C<usemorebits>, C<usemultiplicity>,
10785 C<usemymalloc>, C<usenm>, C<useopcode>, C<useperlio>, C<useposix>,
10786 C<usereentrant>, C<usesfio>, C<useshrplib>, C<usesocks>, C<usethreads>,
10787 C<usevendorprefix>, C<usevfork>, C<usrinc>, C<uuname>, C<uvoformat>,
10788 C<uvsize>, C<uvtype>, C<uvuformat>, C<uvxformat>, C<uvXUformat>
10789
10790 =item v
10791
10792 C<vendorarch>, C<vendorarchexp>, C<vendorbin>, C<vendorbinexp>,
10793 C<vendorlib>, C<vendorlib_stem>, C<vendorlibexp>, C<vendorprefix>,
10794 C<vendorprefixexp>, C<version>, C<version_patchlevel_string>,
10795 C<versiononly>, C<vi>, C<voidflags>
10796
10797 =item x
10798
10799 C<xlibpth>, C<xs_apiversion>
10800
10801 =item y
10802
10803 C<yacc>, C<yaccflags>
10804
10805 =item z
10806
10807 C<zcat>, C<zip>
10808
10809 =back
10810
10811 =item NOTE
10812
10813 =back
10814
10815 =head2 Cwd - get pathname of current working directory
10816
10817 =over 4
10818
10819 =item SYNOPSIS
10820
10821 =item DESCRIPTION
10822
10823 =over 4
10824
10825 =item getcwd and friends
10826
10827 getcwd, cwd, fastcwd, fastgetcwd
10828
10829 =item abs_path and friends
10830
10831 abs_path, realpath, fast_abs_path
10832
10833 =item $ENV{PWD}
10834
10835 =back
10836
10837 =item NOTES
10838
10839 =item SEE ALSO
10840
10841 =back
10842
10843 =head2 DB - programmatic interface to the Perl debugging API (draft,
10844 subject to
10845 change)
10846
10847 =over 4
10848
10849 =item SYNOPSIS
10850
10851 =item DESCRIPTION
10852
10853 =over 4
10854
10855 =item Global Variables
10856
10857  $DB::sub,  %DB::sub,  $DB::single,  $DB::signal,  $DB::trace,  @DB::args,
10858 @DB::dbline,  %DB::dbline,  $DB::package,  $DB::filename,  $DB::subname,
10859 $DB::lineno
10860
10861 =item API Methods
10862
10863 CLIENT->register(), CLIENT->evalcode(STRING), CLIENT->skippkg('D::hide'),
10864 CLIENT->run(), CLIENT->step(), CLIENT->next(), CLIENT->done()
10865
10866 =item Client Callback Methods
10867
10868 CLIENT->init(), CLIENT->prestop([STRING]), CLIENT->stop(), CLIENT->idle(),
10869 CLIENT->poststop([STRING]), CLIENT->evalcode(STRING), CLIENT->cleanup(),
10870 CLIENT->output(LIST)
10871
10872 =back
10873
10874 =item BUGS
10875
10876 =item AUTHOR
10877
10878 =back
10879
10880 =head2 DB_File - Perl5 access to Berkeley DB version 1.x
10881
10882 =over 4
10883
10884 =item SYNOPSIS
10885
10886 =item DESCRIPTION
10887
10888 B<DB_HASH>, B<DB_BTREE>, B<DB_RECNO>
10889
10890 =over 4
10891
10892 =item Using DB_File with Berkeley DB version 2 or greater
10893
10894 =item Interface to Berkeley DB
10895
10896 =item Opening a Berkeley DB Database File
10897
10898 =item Default Parameters
10899
10900 =item In Memory Databases
10901
10902 =back
10903
10904 =item DB_HASH
10905
10906 =over 4
10907
10908 =item A Simple Example
10909
10910 =back
10911
10912 =item DB_BTREE
10913
10914 =over 4
10915
10916 =item Changing the BTREE sort order
10917
10918 =item Handling Duplicate Keys
10919
10920 =item The get_dup() Method
10921
10922 =item The find_dup() Method
10923
10924 =item The del_dup() Method
10925
10926 =item Matching Partial Keys
10927
10928 =back
10929
10930 =item DB_RECNO
10931
10932 =over 4
10933
10934 =item The 'bval' Option
10935
10936 =item A Simple Example
10937
10938 =item Extra RECNO Methods
10939
10940 B<$X-E<gt>push(list) ;>, B<$value = $X-E<gt>pop ;>, B<$X-E<gt>shift>,
10941 B<$X-E<gt>unshift(list) ;>, B<$X-E<gt>length>, B<$X-E<gt>splice(offset,
10942 length, elements);>
10943
10944 =item Another Example
10945
10946 =back
10947
10948 =item THE API INTERFACE
10949
10950 B<$status = $X-E<gt>get($key, $value [, $flags]) ;>, B<$status =
10951 $X-E<gt>put($key, $value [, $flags]) ;>, B<$status = $X-E<gt>del($key [,
10952 $flags]) ;>, B<$status = $X-E<gt>fd ;>, B<$status = $X-E<gt>seq($key,
10953 $value, $flags) ;>, B<$status = $X-E<gt>sync([$flags]) ;>
10954
10955 =item DBM FILTERS
10956
10957 B<filter_store_key>, B<filter_store_value>, B<filter_fetch_key>,
10958 B<filter_fetch_value>
10959
10960 =over 4
10961
10962 =item The Filter
10963
10964 =item An Example -- the NULL termination problem.
10965
10966 =item Another Example -- Key is a C int.
10967
10968 =back
10969
10970 =item HINTS AND TIPS
10971
10972 =over 4
10973
10974 =item Locking: The Trouble with fd
10975
10976 =item Safe ways to lock a database
10977
10978 B<Tie::DB_Lock>, B<Tie::DB_LockFile>, B<DB_File::Lock>
10979
10980 =item Sharing Databases With C Applications
10981
10982 =item The untie() Gotcha
10983
10984 =back
10985
10986 =item COMMON QUESTIONS
10987
10988 =over 4
10989
10990 =item Why is there Perl source in my database?
10991
10992 =item How do I store complex data structures with DB_File?
10993
10994 =item What does "Invalid Argument" mean?
10995
10996 =item What does "Bareword 'DB_File' not allowed" mean?
10997
10998 =back
10999
11000 =item REFERENCES
11001
11002 =item HISTORY
11003
11004 =item BUGS
11005
11006 =item AVAILABILITY
11007
11008 =item COPYRIGHT
11009
11010 =item SEE ALSO
11011
11012 =item AUTHOR
11013
11014 =back
11015
11016 =head2 Data::Dumper - stringified perl data structures, suitable for both
11017 printing and C<eval>
11018
11019 =over 4
11020
11021 =item SYNOPSIS
11022
11023 =item DESCRIPTION
11024
11025 =over 4
11026
11027 =item Methods
11028
11029 I<PACKAGE>->new(I<ARRAYREF [>, I<ARRAYREF]>), I<$OBJ>->Dump  I<or>
11030 I<PACKAGE>->Dump(I<ARRAYREF [>, I<ARRAYREF]>), I<$OBJ>->Seen(I<[HASHREF]>),
11031 I<$OBJ>->Values(I<[ARRAYREF]>), I<$OBJ>->Names(I<[ARRAYREF]>),
11032 I<$OBJ>->Reset
11033
11034 =item Functions
11035
11036 Dumper(I<LIST>)
11037
11038 =item Configuration Variables or Methods
11039
11040 $Data::Dumper::Indent  I<or>  I<$OBJ>->Indent(I<[NEWVAL]>),
11041 $Data::Dumper::Purity  I<or>  I<$OBJ>->Purity(I<[NEWVAL]>),
11042 $Data::Dumper::Pad  I<or>  I<$OBJ>->Pad(I<[NEWVAL]>),
11043 $Data::Dumper::Varname  I<or>  I<$OBJ>->Varname(I<[NEWVAL]>),
11044 $Data::Dumper::Useqq  I<or>  I<$OBJ>->Useqq(I<[NEWVAL]>),
11045 $Data::Dumper::Terse  I<or>  I<$OBJ>->Terse(I<[NEWVAL]>),
11046 $Data::Dumper::Freezer  I<or>  $I<OBJ>->Freezer(I<[NEWVAL]>),
11047 $Data::Dumper::Toaster  I<or>  $I<OBJ>->Toaster(I<[NEWVAL]>),
11048 $Data::Dumper::Deepcopy  I<or>  $I<OBJ>->Deepcopy(I<[NEWVAL]>),
11049 $Data::Dumper::Quotekeys  I<or>  $I<OBJ>->Quotekeys(I<[NEWVAL]>),
11050 $Data::Dumper::Bless  I<or>  $I<OBJ>->Bless(I<[NEWVAL]>),
11051 $Data::Dumper::Maxdepth  I<or>  $I<OBJ>->Maxdepth(I<[NEWVAL]>),
11052 $Data::Dumper::Useperl  I<or>  $I<OBJ>->Useperl(I<[NEWVAL]>),
11053 $Data::Dumper::Sortkeys  I<or>  $I<OBJ>->Sortkeys(I<[NEWVAL]>),
11054 $Data::Dumper::Deparse  I<or>  $I<OBJ>->Deparse(I<[NEWVAL]>)
11055
11056 =item Exports
11057
11058 Dumper
11059
11060 =back
11061
11062 =item EXAMPLES
11063
11064 =item BUGS
11065
11066 =item AUTHOR
11067
11068 =item VERSION
11069
11070 =item SEE ALSO
11071
11072 =back
11073
11074 =head2 Devel::DProf - a Perl code profiler
11075
11076 =over 4
11077
11078 =item SYNOPSIS
11079
11080 =item DESCRIPTION
11081
11082 =item PROFILE FORMAT
11083
11084 =item AUTOLOAD
11085
11086 =item ENVIRONMENT
11087
11088 =item BUGS
11089
11090 =item SEE ALSO
11091
11092 =back
11093
11094 =head2 Devel::PPPort, Perl/Pollution/Portability
11095
11096 =over 4
11097
11098 =item SYNOPSIS
11099
11100 =item DESCRIPTION
11101
11102 =over 4
11103
11104 =item WriteFile
11105
11106 =back
11107
11108 =item ppport.h
11109
11110 =item AUTHOR
11111
11112 =item SEE ALSO
11113
11114 =back
11115
11116 =head2 Devel::Peek - A data debugging tool for the XS programmer
11117
11118 =over 4
11119
11120 =item SYNOPSIS
11121
11122 =item DESCRIPTION
11123
11124 =over 4
11125
11126 =item Runtime debugging
11127
11128 =item Memory footprint debugging
11129
11130 =back
11131
11132 =item EXAMPLES
11133
11134 =over 4
11135
11136 =item A simple scalar string
11137
11138 =item A simple scalar number
11139
11140 =item A simple scalar with an extra reference
11141
11142 =item A reference to a simple scalar
11143
11144 =item A reference to an array
11145
11146 =item A reference to a hash
11147
11148 =item Dumping a large array or hash
11149
11150 =item A reference to an SV which holds a C pointer
11151
11152 =item A reference to a subroutine
11153
11154 =back
11155
11156 =item EXPORTS
11157
11158 =item BUGS
11159
11160 =item AUTHOR
11161
11162 =item SEE ALSO
11163
11164 =back
11165
11166 =head2 Devel::SelfStubber - generate stubs for a SelfLoading module
11167
11168 =over 4
11169
11170 =item SYNOPSIS
11171
11172 =item DESCRIPTION
11173
11174 =back
11175
11176 =head2 Digest:: - Modules that calculate message digests
11177
11178 =over 4
11179
11180 =item SYNOPSIS
11181
11182 =item DESCRIPTION
11183
11184 I<binary>, I<hex>, I<base64>
11185
11186 =item OO INTERFACE
11187
11188 $ctx = Digest->XXX($arg,...), $ctx = Digest->new(XXX => $arg,...), $ctx =
11189 Digest::XXX->new($arg,...), $ctx->reset, $ctx->add($data,...),
11190 $ctx->addfile($io_handle), $ctx->digest, $ctx->hexdigest, $ctx->b64digest
11191
11192 =item SEE ALSO
11193
11194 =item AUTHOR
11195
11196 =back
11197
11198 =head2 Digest::MD5 - Perl interface to the MD5 Algorithm
11199
11200 =over 4
11201
11202 =item SYNOPSIS
11203
11204 =item DESCRIPTION
11205
11206 =item FUNCTIONS
11207
11208 md5($data,...), md5_hex($data,...), md5_base64($data,...)
11209
11210 =item METHODS
11211
11212 $md5 = Digest::MD5->new, $md5->reset, $md5->add($data,...),
11213 $md5->addfile($io_handle), $md5->digest, $md5->hexdigest, $md5->b64digest
11214
11215 =item EXAMPLES
11216
11217 =item SEE ALSO
11218
11219 =item COPYRIGHT
11220
11221 =item AUTHORS
11222
11223 =back
11224
11225 =head2 DirHandle - supply object methods for directory handles
11226
11227 =over 4
11228
11229 =item SYNOPSIS
11230
11231 =item DESCRIPTION
11232
11233 =item NOTES
11234
11235 =back
11236
11237 =head2 Dumpvalue - provides screen dump of Perl data.
11238
11239 =over 4
11240
11241 =item SYNOPSIS
11242
11243 =item DESCRIPTION
11244
11245 =over 4
11246
11247 =item Creation
11248
11249 C<arrayDepth>, C<hashDepth>, C<compactDump>, C<veryCompact>, C<globPrint>,
11250 C<dumpDBFiles>, C<dumpPackages>, C<dumpReused>, C<tick>, C<quoteHighBit>,
11251 C<printUndef>, C<usageOnly>, unctrl, subdump, bareStringify, quoteHighBit,
11252 stopDbSignal
11253
11254 =item Methods
11255
11256 dumpValue, dumpValues, stringify, dumpvars, set_quote, set_unctrl,
11257 compactDump, veryCompact, set, get
11258
11259 =back
11260
11261 =back
11262
11263 =head2 DynaLoader - Dynamically load C libraries into Perl code
11264
11265 =over 4
11266
11267 =item SYNOPSIS
11268
11269 =item DESCRIPTION
11270
11271 @dl_library_path, @dl_resolve_using, @dl_require_symbols, @dl_librefs,
11272 @dl_modules, dl_error(), $dl_debug, dl_findfile(), dl_expandspec(),
11273 dl_load_file(), dl_unload_file(), dl_loadflags(), dl_find_symbol(),
11274 dl_find_symbol_anywhere(), dl_undef_symbols(), dl_install_xsub(),
11275 bootstrap()
11276
11277 =item AUTHOR
11278
11279 =back
11280
11281 =head2 DynaLoader::XSLoader, XSLoader - Dynamically load C libraries into
11282 Perl code
11283
11284 =over 4
11285
11286 =item SYNOPSIS
11287
11288 =item DESCRIPTION
11289
11290 =item AUTHOR
11291
11292 =back
11293
11294 =head2 Encode - character encodings
11295
11296 =over 4
11297
11298 =item SYNOPSIS
11299
11300 =over 4
11301
11302 =item Table of Contents
11303
11304 =back
11305
11306 =item DESCRIPTION
11307
11308 =over 4
11309
11310 =item TERMINOLOGY
11311
11312 =back
11313
11314 =item PERL ENCODING API
11315
11316 $octets  = encode(ENCODING, $string [, CHECK]), $string = decode(ENCODING,
11317 $octets [, CHECK]), [$length =] from_to($octets, FROM_ENC, TO_ENC [,
11318 CHECK]), $octets = encode_utf8($string);, $string = decode_utf8($octets [,
11319 CHECK]);
11320
11321 =over 4
11322
11323 =item Listing available encodings
11324
11325 =item Defining Aliases
11326
11327 =back
11328
11329 =item Encoding via PerlIO
11330
11331 =item Handling Malformed Data
11332
11333 I<CHECK> = Encode::FB_DEFAULT ( == 0), I<CHECK> = Encode::FB_CROAK ( == 1),
11334 I<CHECK> = Encode::FB_QUIET, I<CHECK> = Encode::FB_WARN, perlqq mode
11335 (I<CHECK> = Encode::FB_PERLQQ), HTML charref mode (I<CHECK> =
11336 Encode::FB_HTMLCREF), XML charref mode (I<CHECK> = Encode::FB_XMLCREF), The
11337 bitmask
11338
11339 =over 4
11340
11341 =item Unimplemented fallback schemes
11342
11343 =back
11344
11345 =item Defining Encodings
11346
11347 =item The UTF-8 flag
11348
11349 Goal #1:, Goal #2:, Goal #3:, Goal #4:
11350
11351 =over 4
11352
11353 =item Messing with Perl's Internals
11354
11355 is_utf8(STRING [, CHECK]), _utf8_on(STRING), _utf8_off(STRING)
11356
11357 =back
11358
11359 =item SEE ALSO
11360
11361 =item MAINTAINER
11362
11363 =back
11364
11365 =head2 Encode::Alias - alias definitions to encodings
11366
11367 =over 4
11368
11369 =item SYNOPSIS
11370
11371 =item DESCRIPTION
11372
11373 As a simple string, As a qr// compiled regular expression, e.g.:, As a code
11374 reference, e.g.:
11375
11376 =over 4
11377
11378 =item Alias overloading
11379
11380 =back
11381
11382 =item SEE ALSO
11383
11384 =back
11385
11386 =head2 Encode::Byte - Single Byte Encodings
11387
11388 =over 4
11389
11390 =item SYNOPSIS
11391
11392 =item ABSTRACT
11393
11394 =item DESCRIPTION
11395
11396 =item SEE ALSO
11397
11398 =back
11399
11400 =head2   Encode::CJKConstants -- Internally used by Encode::??::ISO_2022_*
11401
11402 =head2 Encode::CN - China-based Chinese Encodings
11403
11404 =over 4
11405
11406 =item SYNOPSIS
11407
11408 =item DESCRIPTION
11409
11410 =item NOTES
11411
11412 =item BUGS
11413
11414 =item SEE ALSO
11415
11416 =back
11417
11418 =head2 Encode::CN::HZ -- internally used by Encode::CN
11419
11420 =head2 Encode::Config -- internally used by Encode
11421
11422 =head2 Encode::EBCDIC - EBCDIC Encodings
11423
11424 =over 4
11425
11426 =item SYNOPSIS
11427
11428 =item ABSTRACT
11429
11430 =item DESCRIPTION
11431
11432 =item SEE ALSO
11433
11434 =back
11435
11436 =head2 Encode::Encoding - Encode Implementation Base Class
11437
11438 =over 4
11439
11440 =item SYNOPSIS
11441
11442 =item DESCRIPTION
11443
11444 =over 4
11445
11446 =item Methods you should implement
11447
11448 -E<gt>encode($string [,$check]), -E<gt>decode($octets [,$check])
11449
11450 =item Other methods defined in Encode::Encodings
11451
11452 -E<gt>name, -E<gt>new_sequence, -E<gt>perlio_ok(), -E<gt>needs_lines()
11453
11454 =item Example: Encode::ROT13
11455
11456 =back
11457
11458 =item Why the heck Encode API is different?
11459
11460 =over 4
11461
11462 =item Compiled Encodings
11463
11464 =back
11465
11466 =item SEE ALSO
11467
11468 Scheme 1, Scheme 2, Other Schemes
11469
11470 =back
11471
11472 =head2 Encode::Guess -- Guesses encoding from data
11473
11474 =over 4
11475
11476 =item SYNOPSIS
11477
11478 =item ABSTRACT
11479
11480 =item DESCRIPTION
11481
11482 Encode::Guess->set_suspects, Encode::Guess->add_suspects,
11483 Encode::decode("Guess" ...), Encode::Guess->guess($data),
11484 guess_encoding($data, [, I<list of suspects>])
11485
11486 =item CAVEATS
11487
11488 =item TO DO
11489
11490 =item SEE ALSO
11491
11492 =back
11493
11494 =head2 Encode::JP - Japanese Encodings
11495
11496 =over 4
11497
11498 =item SYNOPSIS
11499
11500 =item ABSTRACT
11501
11502 =item DESCRIPTION
11503
11504 =item Note on ISO-2022-JP(-1)?
11505
11506 =item BUGS
11507
11508 =item SEE ALSO
11509
11510 =back
11511
11512 =head2 Encode::JP::H2Z -- internally used by Encode::JP::2022_JP*
11513
11514 =head2 Encode::JP::JIS7 -- internally used by Encode::JP
11515
11516 =head2 Encode::KR - Korean Encodings
11517
11518 =over 4
11519
11520 =item SYNOPSIS
11521
11522 =item DESCRIPTION
11523
11524 =item BUGS
11525
11526 =item SEE ALSO
11527
11528 =back
11529
11530 =head2 Encode::KR::2022_KR -- internally used by Encode::KR
11531
11532 =head2 Encode::MIME::Header -- MIME 'B' and 'Q' header encoding
11533
11534 =over 4
11535
11536 =item SYNOPSIS
11537
11538 =item ABSTRACT
11539
11540 =item DESCRIPTION
11541
11542 =item BUGS
11543
11544 =item SEE ALSO
11545
11546 =back
11547
11548 =head2 Encode::PerlIO -- a detailed document on Encode and PerlIO
11549
11550 =over 4
11551
11552 =item Overview
11553
11554 =item How does it work?
11555
11556 =item BUGS
11557
11558 =over 4
11559
11560 =item Workaround
11561
11562 =item How can I tell whether my encoding fully supports PerlIO ?
11563
11564 =back
11565
11566 =item SEE ALSO
11567
11568 =back
11569
11570 =head2 Encode::Supported -- Encodings supported by Encode
11571
11572 =over 4
11573
11574 =item DESCRIPTION
11575
11576 =over 4
11577
11578 =item Encoding Names
11579
11580 =back
11581
11582 =item Supported Encodings
11583
11584 =over 4
11585
11586 =item Built-in Encodings
11587
11588 =item Encode::Unicode -- other Unicode encodings
11589
11590 =item Encode::Byte -- Extended ASCII
11591
11592 ISO-8859 and corresponding vendor mappings, KOI8 - De Facto Standard for
11593 the Cyrillic world, gsm0338 - Hentai Latin 1
11594
11595 =item CJK: Chinese, Japanese, Korean (Multibyte)
11596
11597 Encode::CN -- Continental China, Encode::JP -- Japan, Encode::KR -- Korea,
11598 Encode::TW -- Taiwan, Encode::HanExtra -- More Chinese via CPAN,
11599 Encode::JIS2K -- JIS X 0213 encodings via CPAN
11600
11601 =item Miscellaneous encodings
11602
11603 Encode::EBCDIC, Encode::Symbols, Encode::MIME::Header, Encode::Guess
11604
11605 =back
11606
11607 =item Unsupported encodings
11608
11609   ISO-2022-JP-2 [RFC1554], ISO-2022-CN [RFC1922], Various HP-UX encodings,
11610 Cyrillic encoding ISO-IR-111, ISO-8859-8-1 [Hebrew], ISIRI 3342, Iran
11611 System, ISIRI 2900 [Farsi], Thai encoding TCVN, Vietnamese encodings VPS,
11612 Various Mac encodings, (Mac) Indic encodings
11613
11614 =item Encoding vs. Charset -- terminology
11615
11616 =item Encoding Classification (by Anton Tagunov and Dan Kogai)
11617
11618 =over 4
11619
11620 =item Microsoft-related naming mess
11621
11622 KS_C_5601-1987, GB2312, Big5, Shift_JIS
11623
11624 =back
11625
11626 =item Glossary
11627
11628 character repertoire, coded character set (CCS), character encoding scheme
11629 (CES), charset (in MIME context), EUC, ISO-2022, UCS, UCS-2, Unicode, UTF,
11630 UTF-16
11631
11632 =item See Also
11633
11634 =item References
11635
11636 ECMA, ECMA-035 (eq C<ISO-2022>), IANA, Assigned Charset Names by IANA, ISO,
11637 RFC, UC, Unicode Glossary
11638
11639 =over 4
11640
11641 =item Other Notable Sites
11642
11643 czyborra.com, CJK.inf, Jungshik Shin's Hangul FAQ, debian.org:
11644 "Introduction to i18n"
11645
11646 =item Offline sources
11647
11648 C<CJKV Information Processing> by Ken Lunde
11649
11650 =back
11651
11652 =back
11653
11654 =head2 Encode::Symbol - Symbol Encodings
11655
11656 =over 4
11657
11658 =item SYNOPSIS
11659
11660 =item ABSTRACT
11661
11662 =item DESCRIPTION
11663
11664 =item SEE ALSO
11665
11666 =back
11667
11668 =head2 Encode::TW - Taiwan-based Chinese Encodings
11669
11670 =over 4
11671
11672 =item SYNOPSIS
11673
11674 =item DESCRIPTION
11675
11676 =item NOTES
11677
11678 =item BUGS
11679
11680 =item SEE ALSO
11681
11682 =back
11683
11684 =head2 Encode::Unicode -- Various Unicode Transformation Formats
11685
11686 =over 4
11687
11688 =item SYNOPSIS
11689
11690 =item ABSTRACT
11691
11692 L<http://www.unicode.org/glossary/> says:, Quick Reference
11693
11694 =item Size, Endianness, and BOM
11695
11696 =over 4
11697
11698 =item by size
11699
11700 =item by endianness
11701
11702 BOM as integer when fetched in network byte order
11703
11704 =back
11705
11706 =item Surrogate Pairs
11707
11708 =item SEE ALSO
11709
11710 =back
11711
11712 =head2 Encode::lib::Encode::Alias, Encode::Alias - alias definitions to
11713 encodings
11714
11715 =over 4
11716
11717 =item SYNOPSIS
11718
11719 =item DESCRIPTION
11720
11721 As a simple string, As a qr// compiled regular expression, e.g.:, As a code
11722 reference, e.g.:
11723
11724 =over 4
11725
11726 =item Alias overloading
11727
11728 =back
11729
11730 =item SEE ALSO
11731
11732 =back
11733
11734 =head2 Encode::lib::Encode::CJKConstants,   Encode::CJKConstants.pm --
11735 Internally used by Encode::??::ISO_2022_*
11736
11737 =head2 Encode::lib::Encode::CN::HZ, Encode::CN::HZ -- internally used by
11738 Encode::CN
11739
11740 =head2 Encode::lib::Encode::Config, Encode::Config -- internally used by
11741 Encode
11742
11743 =head2 Encode::lib::Encode::Encoding, Encode::Encoding - Encode
11744 Implementation Base Class
11745
11746 =over 4
11747
11748 =item SYNOPSIS
11749
11750 =item DESCRIPTION
11751
11752 =over 4
11753
11754 =item Methods you should implement
11755
11756 -E<gt>encode($string [,$check]), -E<gt>decode($octets [,$check])
11757
11758 =item Other methods defined in Encode::Encodings
11759
11760 -E<gt>name, -E<gt>new_sequence, -E<gt>perlio_ok(), -E<gt>needs_lines()
11761
11762 =item Example: Encode::ROT13
11763
11764 =back
11765
11766 =item Why the heck Encode API is different?
11767
11768 =over 4
11769
11770 =item Compiled Encodings
11771
11772 =back
11773
11774 =item SEE ALSO
11775
11776 Scheme 1, Scheme 2, Other Schemes
11777
11778 =back
11779
11780 =head2 Encode::lib::Encode::Guess, Encode::Guess -- Guesses encoding from
11781 data
11782
11783 =over 4
11784
11785 =item SYNOPSIS
11786
11787 =item ABSTRACT
11788
11789 =item DESCRIPTION
11790
11791 Encode::Guess->set_suspects, Encode::Guess->add_suspects,
11792 Encode::decode("Guess" ...), Encode::Guess->guess($data),
11793 guess_encoding($data, [, I<list of suspects>])
11794
11795 =item CAVEATS
11796
11797 =item TO DO
11798
11799 =item SEE ALSO
11800
11801 =back
11802
11803 =head2 Encode::lib::Encode::JP::H2Z, Encode::JP::H2Z -- internally used by
11804 Encode::JP::2022_JP*
11805
11806 =head2 Encode::lib::Encode::JP::JIS7, Encode::JP::JIS7 -- internally used
11807 by Encode::JP
11808
11809 =head2 Encode::lib::Encode::KR::2022_KR, Encode::KR::2022_KR -- internally
11810 used by Encode::KR
11811
11812 =head2 Encode::lib::Encode::MIME::Header, Encode::MIME::Header -- MIME 'B'
11813 and 'Q' header encoding
11814
11815 =over 4
11816
11817 =item SYNOPSIS
11818
11819 =item ABSTRACT
11820
11821 =item DESCRIPTION
11822
11823 =item BUGS
11824
11825 =item SEE ALSO
11826
11827 =back
11828
11829 =head2 Encode::lib::Encode::PerlIO, Encode::PerlIO -- a detailed document
11830 on Encode and PerlIO
11831
11832 =over 4
11833
11834 =item Overview
11835
11836 =item How does it work?
11837
11838 =item BUGS
11839
11840 =over 4
11841
11842 =item Workaround
11843
11844 =item How can I tell whether my encoding fully supports PerlIO ?
11845
11846 =back
11847
11848 =item SEE ALSO
11849
11850 =back
11851
11852 =head2 Encode::lib::Encode::Supported, Encode::Supported -- Encodings
11853 supported by Encode
11854
11855 =over 4
11856
11857 =item DESCRIPTION
11858
11859 =over 4
11860
11861 =item Encoding Names
11862
11863 =back
11864
11865 =item Supported Encodings
11866
11867 =over 4
11868
11869 =item Built-in Encodings
11870
11871 =item Encode::Unicode -- other Unicode encodings
11872
11873 =item Encode::Byte -- Extended ASCII
11874
11875 ISO-8859 and corresponding vendor mappings, KOI8 - De Facto Standard for
11876 the Cyrillic world, gsm0338 - Hentai Latin 1
11877
11878 =item CJK: Chinese, Japanese, Korean (Multibyte)
11879
11880 Encode::CN -- Continental China, Encode::JP -- Japan, Encode::KR -- Korea,
11881 Encode::TW -- Taiwan, Encode::HanExtra -- More Chinese via CPAN,
11882 Encode::JIS2K -- JIS X 0213 encodings via CPAN
11883
11884 =item Miscellaneous encodings
11885
11886 Encode::EBCDIC, Encode::Symbols, Encode::MIME::Header, Encode::Guess
11887
11888 =back
11889
11890 =item Unsupported encodings
11891
11892   ISO-2022-JP-2 [RFC1554], ISO-2022-CN [RFC1922], Various HP-UX encodings,
11893 Cyrillic encoding ISO-IR-111, ISO-8859-8-1 [Hebrew], ISIRI 3342, Iran
11894 System, ISIRI 2900 [Farsi], Thai encoding TCVN, Vietnamese encodings VPS,
11895 Various Mac encodings, (Mac) Indic encodings
11896
11897 =item Encoding vs. Charset -- terminology
11898
11899 =item Encoding Classification (by Anton Tagunov and Dan Kogai)
11900
11901 =over 4
11902
11903 =item Microsoft-related naming mess
11904
11905 KS_C_5601-1987, GB2312, Big5, Shift_JIS
11906
11907 =back
11908
11909 =item Glossary
11910
11911 character repertoire, coded character set (CCS), character encoding scheme
11912 (CES), charset (in MIME context), EUC, ISO-2022, UCS, UCS-2, Unicode, UTF,
11913 UTF-16
11914
11915 =item See Also
11916
11917 =item References
11918
11919 ECMA, ECMA-035 (eq C<ISO-2022>), IANA, Assigned Charset Names by IANA, ISO,
11920 RFC, UC, Unicode Glossary
11921
11922 =over 4
11923
11924 =item Other Notable Sites
11925
11926 czyborra.com, CJK.inf, Jungshik Shin's Hangul FAQ, debian.org:
11927 "Introduction to i18n"
11928
11929 =item Offline sources
11930
11931 C<CJKV Information Processing> by Ken Lunde
11932
11933 =back
11934
11935 =back
11936
11937 =head2 Encode::lib::Encoder, Encode::Encoder -- Object Oriented Encoder
11938
11939 =over 4
11940
11941 =item SYNOPSIS
11942
11943   use Encode::Encoder;
11944   # Encode::encode("ISO-8859-1", $data);
11945   Encode::Encoder->new($data)->iso_8859_1; # OOP way
11946   # shortcut
11947   use Encode::Encoder qw(encoder);
11948   encoder($data)->iso_8859_1;
11949   # you can stack them!
11950   encoder($data)->iso_8859_1->base64;  # provided base64() is defined
11951   # you can use it as a decoder as well
11952   encoder($base64)->bytes('base64')->latin1;
11953   # stringified
11954   print encoder($data)->utf8->latin1;  # prints the string in latin1
11955   # numified
11956   encoder("\x{abcd}\x{ef}g")->utf8 == 6; # true. bytes::length($data)
11957
11958 =item ABSTRACT
11959
11960 =item Description
11961
11962 =over 4
11963
11964 =item Predefined Methods
11965
11966 $e = Encode::Encoder-E<gt>new([$data, $encoding]);, encoder(),
11967 $e-E<gt>data([$data]), $e-E<gt>encoding([$encoding]),
11968 $e-E<gt>bytes([$encoding])
11969
11970 =item Example: base64 transcoder
11971
11972 =item Operator Overloading
11973
11974 =back
11975
11976 =item SEE ALSO
11977
11978 =back
11979
11980 =head2 Encodencoding, encoding - allows you to write your script in
11981 non-ascii or non-utf8
11982
11983 =over 4
11984
11985 =item SYNOPSIS
11986
11987 =item ABSTRACT
11988
11989 =item USAGE
11990
11991 use encoding [I<ENCNAME>] ;, use encoding I<ENCNAME> [ STDIN =E<gt>
11992 I<ENCNAME_IN> ...] ;, no encoding;
11993
11994 =item CAVEATS
11995
11996 =over 4
11997
11998 =item NOT SCOPED
11999
12000 =item DO NOT MIX MULTIPLE ENCODINGS
12001
12002 =back
12003
12004 =item Non-ASCII Identifiers and Filter option
12005
12006 use encoding I<ENCNAME> Filter=E<gt>1;
12007
12008 =item EXAMPLE - Greekperl
12009
12010 =item KNOWN PROBLEMS
12011
12012 =item SEE ALSO
12013
12014 =back
12015
12016 =head2 Encoder, Encode::Encoder -- Object Oriented Encoder
12017
12018 =over 4
12019
12020 =item SYNOPSIS
12021
12022   use Encode::Encoder;
12023   # Encode::encode("ISO-8859-1", $data);
12024   Encode::Encoder->new($data)->iso_8859_1; # OOP way
12025   # shortcut
12026   use Encode::Encoder qw(encoder);
12027   encoder($data)->iso_8859_1;
12028   # you can stack them!
12029   encoder($data)->iso_8859_1->base64;  # provided base64() is defined
12030   # you can use it as a decoder as well
12031   encoder($base64)->bytes('base64')->latin1;
12032   # stringified
12033   print encoder($data)->utf8->latin1;  # prints the string in latin1
12034   # numified
12035   encoder("\x{abcd}\x{ef}g")->utf8 == 6; # true. bytes::length($data)
12036
12037 =item ABSTRACT
12038
12039 =item Description
12040
12041 =over 4
12042
12043 =item Predefined Methods
12044
12045 $e = Encode::Encoder-E<gt>new([$data, $encoding]);, encoder(),
12046 $e-E<gt>data([$data]), $e-E<gt>encoding([$encoding]),
12047 $e-E<gt>bytes([$encoding])
12048
12049 =item Example: base64 transcoder
12050
12051 =item Operator Overloading
12052
12053 =back
12054
12055 =item SEE ALSO
12056
12057 =back
12058
12059 =head2 English - use nice English (or awk) names for ugly punctuation
12060 variables
12061
12062 =over 4
12063
12064 =item SYNOPSIS
12065
12066 =item DESCRIPTION
12067
12068 =item PERFORMANCE
12069
12070 =back
12071
12072 =head2 Env - perl module that imports environment variables as scalars or
12073 arrays
12074
12075 =over 4
12076
12077 =item SYNOPSIS
12078
12079 =item DESCRIPTION
12080
12081 =item LIMITATIONS
12082
12083 =item AUTHOR
12084
12085 =back
12086
12087 =head2 Errno - System errno constants
12088
12089 =over 4
12090
12091 =item SYNOPSIS
12092
12093 =item DESCRIPTION
12094
12095 =item CAVEATS
12096
12097 =item AUTHOR
12098
12099 =item COPYRIGHT
12100
12101 =back
12102
12103 =head2 Exporter - Implements default import method for modules
12104
12105 =over 4
12106
12107 =item SYNOPSIS
12108
12109 =item DESCRIPTION
12110
12111 =over 4
12112
12113 =item How to Export
12114
12115 =item Selecting What To Export
12116
12117 =item How to Import
12118
12119 C<use ModuleName;>, C<use ModuleName ();>, C<use ModuleName qw(...);>
12120
12121 =back
12122
12123 =item Advanced features
12124
12125 =over 4
12126
12127 =item Specialised Import Lists
12128
12129 =item Exporting without using Exporter's import method
12130
12131 =item Module Version Checking
12132
12133 =item Managing Unknown Symbols
12134
12135 =item Tag Handling Utility Functions
12136
12137 =item Generating combined tags
12138
12139 =item C<AUTOLOAD>ed Constants
12140
12141 =back
12142
12143 =back
12144
12145 =head2 Exporter::Heavy - Exporter guts
12146
12147 =over 4
12148
12149 =item SYNOPSIS
12150
12151 =item DESCRIPTION
12152
12153 =back
12154
12155 =head2 ExtUtils::Command - utilities to replace common UNIX commands in
12156 Makefiles etc.
12157
12158 =over 4
12159
12160 =item SYNOPSIS
12161
12162 =item DESCRIPTION
12163
12164 =back
12165
12166 cat
12167
12168 eqtime src dst
12169
12170 rm_rf files...
12171
12172 rm_f files...
12173
12174 touch files ..
12175
12176 mv source... destination
12177
12178 cp source... destination
12179
12180 chmod mode files..
12181
12182 mkpath directory..
12183
12184 test_f file
12185
12186 =over 4
12187
12188 =item BUGS
12189
12190 =item SEE ALSO
12191
12192 =item AUTHOR
12193
12194 =back
12195
12196 =head2 ExtUtils::Command::MM - Commands for the MM's to use in Makefiles
12197
12198 =over 4
12199
12200 =item SYNOPSIS
12201
12202 =item DESCRIPTION
12203
12204 B<test_harness>
12205
12206 =back
12207
12208 =head2 ExtUtils::Constant - generate XS code to import C header constants
12209
12210 =over 4
12211
12212 =item SYNOPSIS
12213
12214 =item DESCRIPTION
12215
12216 =item USAGE
12217
12218 IV, UV, NV, PV, PVN, SV, YES, NO, UNDEF
12219
12220 =item FUNCTIONS
12221
12222 =back
12223
12224 C_stringify NAME
12225
12226 perl_stringify NAME
12227
12228 constant_types
12229
12230 memEQ_clause NAME, CHECKED_AT, INDENT
12231
12232 assign INDENT, TYPE, PRE, POST, VALUE..
12233
12234 return_clause
12235
12236 switch_clause INDENT, NAMELEN, ITEMHASH, ITEM..
12237
12238 params WHAT
12239
12240 dump_names
12241
12242 dogfood
12243
12244 C_constant, name, type, value, macro, default, pre, post, def_pre =item
12245 def_post, utf8
12246
12247 XS_constant PACKAGE, TYPES, SUBNAME, C_SUBNAME
12248
12249 autoload PACKAGE, VERSION, AUTOLOADER
12250
12251 WriteMakefileSnippet
12252
12253 WriteConstants ATTRIBUTE =E<gt> VALUE [, ...], NAME, DEFAULT_TYPE,
12254 BREAKOUT_AT, NAMES, C_FILE, XS_FILE, SUBNAME, C_SUBNAME
12255
12256 =over 4
12257
12258 =item AUTHOR
12259
12260 =back
12261
12262 =head2 ExtUtils::Embed - Utilities for embedding Perl in C/C++ applications
12263
12264 =over 4
12265
12266 =item SYNOPSIS
12267
12268 =item DESCRIPTION
12269
12270 =item @EXPORT
12271
12272 =item FUNCTIONS
12273
12274 xsinit(), Examples, ldopts(), Examples, perl_inc(), ccflags(), ccdlflags(),
12275 ccopts(), xsi_header(), xsi_protos(@modules), xsi_body(@modules)
12276
12277 =item EXAMPLES
12278
12279 =item SEE ALSO
12280
12281 =item AUTHOR
12282
12283 =back
12284
12285 =head2 ExtUtils::Install - install files from here to there
12286
12287 =over 4
12288
12289 =item SYNOPSIS
12290
12291 =item DESCRIPTION
12292
12293 =back
12294
12295 =head2 ExtUtils::Installed - Inventory management of installed modules
12296
12297 =over 4
12298
12299 =item SYNOPSIS
12300
12301 =item DESCRIPTION
12302
12303 =item USAGE
12304
12305 =item FUNCTIONS
12306
12307 new(), modules(), files(), directories(), directory_tree(), validate(),
12308 packlist(), version()
12309
12310 =item EXAMPLE
12311
12312 =item AUTHOR
12313
12314 =back
12315
12316 =head2 ExtUtils::Liblist - determine libraries to use and how to use them
12317
12318 =over 4
12319
12320 =item SYNOPSIS
12321
12322 =item DESCRIPTION
12323
12324 For static extensions, For dynamic extensions at build/link time, For
12325 dynamic extensions at load time
12326
12327 =over 4
12328
12329 =item EXTRALIBS
12330
12331 =item LDLOADLIBS and LD_RUN_PATH
12332
12333 =item BSLOADLIBS
12334
12335 =back
12336
12337 =item PORTABILITY
12338
12339 =over 4
12340
12341 =item VMS implementation
12342
12343 =item Win32 implementation
12344
12345 =back
12346
12347 =item SEE ALSO
12348
12349 =back
12350
12351 =head2 ExtUtils::MM - OS adjusted ExtUtils::MakeMaker subclass
12352
12353 =over 4
12354
12355 =item SYNOPSIS
12356
12357 =item DESCRIPTION
12358
12359 =back
12360
12361 =head2 ExtUtils::MM_Any - Platform agnostic MM methods
12362
12363 =over 4
12364
12365 =item SYNOPSIS
12366
12367 =item DESCRIPTION
12368
12369 =item Inherently Cross-Platform Methods
12370
12371 =over 4
12372
12373 =item File::Spec wrappers  B<DEPRECATED>
12374
12375 canonpath
12376
12377 =back
12378
12379 =back
12380
12381 catdir
12382
12383 catfile
12384
12385 curdir
12386
12387 file_name_is_absolute
12388
12389 path
12390
12391 rootdir
12392
12393 updir
12394
12395 =over 4
12396
12397 =item Thought To Be Cross-Platform Methods
12398
12399 test_via_harness
12400
12401 =back
12402
12403 test_via_script
12404
12405 =over 4
12406
12407 =item AUTHOR
12408
12409 =back
12410
12411 =head2 ExtUtils::MM_BeOS - methods to override UN*X behaviour in
12412 ExtUtils::MakeMaker
12413
12414 =over 4
12415
12416 =item SYNOPSIS
12417
12418 =item DESCRIPTION
12419
12420 =back
12421
12422 perl_archive
12423
12424 =head2 ExtUtils::MM_Cygwin - methods to override UN*X behaviour in
12425 ExtUtils::MakeMaker
12426
12427 =over 4
12428
12429 =item SYNOPSIS
12430
12431 =item DESCRIPTION
12432
12433 canonpath, cflags, manifypods, perl_archive
12434
12435 =back
12436
12437 =head2 ExtUtils::MM_DOS - DOS specific subclass of ExtUtils::MM_Unix
12438
12439 =over 4
12440
12441 =item SYNOPSIS
12442
12443 =item DESCRIPTION
12444
12445 =over 4
12446
12447 =item Overridden methods
12448
12449 B<replace_manpage_separator>
12450
12451 =back
12452
12453 =back
12454
12455 =over 4
12456
12457 =item AUTHOR
12458
12459 =item SEE ALSO
12460
12461 =back
12462
12463 =head2 ExtUtils::MM_MacOS - methods to override UN*X behaviour in
12464 ExtUtils::MakeMaker
12465
12466 =over 4
12467
12468 =item SYNOPSIS
12469
12470 =item DESCRIPTION
12471
12472 =back
12473
12474 maybe_command
12475
12476 guess_name
12477
12478 macify
12479
12480 patternify
12481
12482 init_main
12483
12484 init_others
12485
12486 init_dirscan
12487
12488 libscan (o)
12489
12490 constants (o)
12491
12492 static (o)
12493
12494 dlsyms (o)
12495
12496 dynamic (o)
12497
12498 clean (o)
12499
12500 realclean (o)
12501
12502 rulez (o)
12503
12504 processPL (o)
12505
12506 =head2 ExtUtils::MM_NW5 - methods to override UN*X behaviour in
12507 ExtUtils::MakeMaker
12508
12509 =over 4
12510
12511 =item SYNOPSIS
12512
12513 =item DESCRIPTION
12514
12515 =back
12516
12517 constants (o)
12518
12519 static_lib (o)
12520
12521 dynamic_lib (o)
12522
12523 =head2 ExtUtils::MM_OS2 - methods to override UN*X behaviour in
12524 ExtUtils::MakeMaker
12525
12526 =over 4
12527
12528 =item SYNOPSIS
12529
12530 =item DESCRIPTION
12531
12532 =item METHODS
12533
12534 =back
12535
12536 perl_archive_after
12537
12538 =head2 ExtUtils::MM_UWIN - U/WIN specific subclass of ExtUtils::MM_Unix
12539
12540 =over 4
12541
12542 =item SYNOPSIS
12543
12544 =item DESCRIPTION
12545
12546 =over 4
12547
12548 =item Overridden methods
12549
12550 B<replace_manpage_separator>
12551
12552 =back
12553
12554 =back
12555
12556 =over 4
12557
12558 =item AUTHOR
12559
12560 =item SEE ALSO
12561
12562 =back
12563
12564 =head2 ExtUtils::MM_Unix - methods used by ExtUtils::MakeMaker
12565
12566 =over 4
12567
12568 =item SYNOPSIS
12569
12570 =item DESCRIPTION
12571
12572 =item METHODS
12573
12574 =back
12575
12576 =over 4
12577
12578 =item SelfLoaded methods
12579
12580 c_o (o)
12581
12582 =back
12583
12584 cflags (o)
12585
12586 clean (o)
12587
12588 const_cccmd (o)
12589
12590 const_config (o)
12591
12592 const_loadlibs (o)
12593
12594 constants (o)
12595
12596 depend (o)
12597
12598 dir_target (o)
12599
12600 dist (o)
12601
12602 dist_basics (o)
12603
12604 dist_ci (o)
12605
12606 dist_core (o)
12607
12608 dist_dir
12609
12610 dist_test
12611
12612 dlsyms (o)
12613
12614 dynamic (o)
12615
12616 dynamic_bs (o)
12617
12618 dynamic_lib (o)
12619
12620 exescan
12621
12622 extliblist
12623
12624 find_perl
12625
12626 find_tests
12627
12628 =over 4
12629
12630 =item Methods to actually produce chunks of text for the Makefile
12631
12632 fixin
12633
12634 =back
12635
12636 force (o)
12637
12638 guess_name
12639
12640 has_link_code
12641
12642 init_dirscan
12643
12644 init_main
12645
12646 init_others
12647
12648 init_INST
12649
12650 init_INSTALL
12651
12652 init_lib2arch
12653
12654 init_PERL
12655
12656 init_PERM
12657
12658 install (o)
12659
12660 installbin (o)
12661
12662 libscan (o)
12663
12664 linkext (o)
12665
12666 lsdir
12667
12668 macro (o)
12669
12670 makeaperl (o)
12671
12672 makefile (o)
12673
12674 manifypods (o)
12675
12676 maybe_command
12677
12678 maybe_command_in_dirs
12679
12680 needs_linking (o)
12681
12682 nicetext
12683
12684 parse_abstract
12685
12686 parse_version
12687
12688 pasthru (o)
12689
12690 perl_script
12691
12692 perldepend (o)
12693
12694 perm_rw (o)
12695
12696 perm_rwx (o)
12697
12698 pm_to_blib
12699
12700 post_constants (o)
12701
12702 post_initialize (o)
12703
12704 postamble (o)
12705
12706 ppd
12707
12708 prefixify
12709
12710 processPL (o)
12711
12712 quote_paren
12713
12714 realclean (o)
12715
12716 replace_manpage_separator
12717
12718 static (o)
12719
12720 static_lib (o)
12721
12722 staticmake (o)
12723
12724 subdir_x (o)
12725
12726 subdirs (o)
12727
12728 test (o)
12729
12730 test_via_harness (override)
12731
12732 test_via_script (override)
12733
12734 tool_autosplit (o)
12735
12736 tools_other (o)
12737
12738 tool_xsubpp (o)
12739
12740 top_targets (o)
12741
12742 writedoc
12743
12744 xs_c (o)
12745
12746 xs_cpp (o)
12747
12748 xs_o (o)
12749
12750 perl_archive
12751
12752 perl_archive_after
12753
12754 export_list
12755
12756 =over 4
12757
12758 =item SEE ALSO
12759
12760 =back
12761
12762 =head2 ExtUtils::MM_VMS - methods to override UN*X behaviour in
12763 ExtUtils::MakeMaker
12764
12765 =over 4
12766
12767 =item SYNOPSIS
12768
12769 =item DESCRIPTION
12770
12771 =over 4
12772
12773 =item Methods always loaded
12774
12775 wraplist
12776
12777 =back
12778
12779 =back
12780
12781 =over 4
12782
12783 =item Methods
12784
12785 guess_name (override)
12786
12787 =back
12788
12789 find_perl (override)
12790
12791 maybe_command (override)
12792
12793 maybe_command_in_dirs (override)
12794
12795 perl_script (override)
12796
12797 replace_manpage_separator
12798
12799 init_main (override)
12800
12801 init_others (override)
12802
12803 constants (override)
12804
12805 cflags (override)
12806
12807 const_cccmd (override)
12808
12809 pm_to_blib (override)
12810
12811 tool_autosplit (override)
12812
12813 tool_sxubpp (override)
12814
12815 xsubpp_version (override)
12816
12817 tools_other (override)
12818
12819 dist (override)
12820
12821 c_o (override)
12822
12823 xs_c (override)
12824
12825 xs_o (override)
12826
12827 top_targets (override)
12828
12829 dlsyms (override)
12830
12831 dynamic_lib (override)
12832
12833 dynamic_bs (override)
12834
12835 static_lib (override)
12836
12837 manifypods (override)
12838
12839 processPL (override)
12840
12841 installbin (override)
12842
12843 subdir_x (override)
12844
12845 clean (override)
12846
12847 realclean (override)
12848
12849 dist_core (override)
12850
12851 dist_test (override)
12852
12853 install (override)
12854
12855 perldepend (override)
12856
12857 makefile (override)
12858
12859 find_tests (override)
12860
12861 test (override)
12862
12863 makeaperl (override)
12864
12865 nicetext (override)
12866
12867 prefixify (override)
12868
12869 =head2 ExtUtils::MM_Win32 - methods to override UN*X behaviour in
12870 ExtUtils::MakeMaker
12871
12872 =over 4
12873
12874 =item SYNOPSIS
12875
12876 =item DESCRIPTION
12877
12878 =back
12879
12880 constants (o)
12881
12882 static_lib (o)
12883
12884 dynamic_bs (o)
12885
12886 dynamic_lib (o)
12887
12888 perl_script
12889
12890 pm_to_blib
12891
12892 tool_autosplit (override)
12893
12894 tools_other (o)
12895
12896 xs_o (o)
12897
12898 top_targets (o)
12899
12900 manifypods (o)
12901
12902 dist_ci (o)
12903
12904 dist_core (o)
12905
12906 pasthru (o)
12907
12908 =head2 ExtUtils::MM_Win95 - method to customize MakeMaker for Win9X
12909
12910 =over 4
12911
12912 =item SYNOPSIS
12913
12914 =item DESCRIPTION
12915
12916 =back
12917
12918 =head2 ExtUtils::MY - ExtUtils::MakeMaker subclass for customization
12919
12920 =over 4
12921
12922 =item SYNOPSIS
12923
12924 =item DESCRIPTION
12925
12926 =back
12927
12928 =head2 ExtUtils::MakeMaker - create an extension Makefile
12929
12930 =over 4
12931
12932 =item SYNOPSIS
12933
12934 =item DESCRIPTION
12935
12936 =over 4
12937
12938 =item How To Write A Makefile.PL
12939
12940 =item Default Makefile Behaviour
12941
12942 =item make test
12943
12944 =item make testdb
12945
12946 =item make install
12947
12948 =item PREFIX and LIB attribute
12949
12950 =item AFS users
12951
12952 =item Static Linking of a new Perl Binary
12953
12954 =item Determination of Perl Library and Installation Locations
12955
12956 =item Which architecture dependent directory?
12957
12958 =item Using Attributes and Parameters
12959
12960 ABSTRACT, ABSTRACT_FROM, AUTHOR, BINARY_LOCATION, C, CCFLAGS, CONFIG,
12961 CONFIGURE, DEFINE, DIR, DISTNAME, DL_FUNCS, DL_VARS, EXCLUDE_EXT,
12962 EXE_FILES, FIRST_MAKEFILE, FULLPERL, FULLPERLRUN, FULLPERLRUNINST,
12963 FUNCLIST, H, IMPORTS, INC, INCLUDE_EXT, INSTALLARCHLIB, INSTALLBIN,
12964 INSTALLDIRS, INSTALLMAN1DIR, INSTALLMAN3DIR, INSTALLPRIVLIB, INSTALLSCRIPT,
12965 INSTALLSITEARCH, INSTALLSITEBIN, INSTALLSITELIB, INSTALLSITEMAN1DIR,
12966 INSTALLSITEMAN3DIR, INSTALLVENDORARCH, INSTALLVENDORBIN, INSTALLVENDORLIB,
12967 INSTALLVENDORMAN1DIR, INSTALLVENDORMAN3DIR, INST_ARCHLIB, INST_BIN,
12968 INST_LIB, INST_MAN1DIR, INST_MAN3DIR, INST_SCRIPT, LDDLFLAGS, LDFROM, LIB,
12969 LIBPERL_A, LIBS, LINKTYPE, MAKEAPERL, MAKEFILE, MAN1PODS, MAN3PODS,
12970 MAP_TARGET, MYEXTLIB, NAME, NEEDS_LINKING, NOECHO, NORECURS, NO_VC, OBJECT,
12971 OPTIMIZE, PERL, PERL_CORE, PERLMAINCC, PERL_ARCHLIB, PERL_LIB,
12972 PERL_MALLOC_OK, PERLRUN, PERLRUNINST, PERL_SRC, PERM_RW, PERM_RWX,
12973 PL_FILES, PM, PMLIBDIRS, PM_FILTER, POLLUTE, PPM_INSTALL_EXEC,
12974 PPM_INSTALL_SCRIPT, PREFIX, PREREQ_FATAL, PREREQ_PM, PREREQ_PRINT,
12975 PRINT_PREREQ, SITEPREFIX, SKIP, TYPEMAPS, VENDORPREFIX, VERBINST, VERSION,
12976 VERSION_FROM, XS, XSOPT, XSPROTOARG, XS_VERSION
12977
12978 =item Additional lowercase attributes
12979
12980 clean, depend, dist, dynamic_lib, linkext, macro, realclean, test,
12981 tool_autosplit
12982
12983 =item Overriding MakeMaker Methods
12984
12985 =item The End Of Cargo Cult Programming
12986
12987 C<<MAN3PODS => ' '>>
12988
12989 =item Hintsfile support
12990
12991 =item Distribution Support
12992
12993    make distcheck,    make skipcheck,    make distclean,    make manifest,
12994   make distdir,   make disttest,    make tardist,    make dist,    make
12995 uutardist,    make shdist,    make zipdist,    make ci
12996
12997 =item Disabling an extension
12998
12999 =back
13000
13001 =item ENVIRONMENT
13002
13003 PERL_MM_OPT, PERL_MM_USE_DEFAULT
13004
13005 =item SEE ALSO
13006
13007 =item AUTHORS
13008
13009 =back
13010
13011 =head2 ExtUtils::Manifest - utilities to write and check a MANIFEST file
13012
13013 =over 4
13014
13015 =item SYNOPSIS
13016
13017 =item DESCRIPTION
13018
13019 =item MANIFEST.SKIP
13020
13021 =item EXPORT_OK
13022
13023 =item GLOBAL VARIABLES
13024
13025 =item DIAGNOSTICS
13026
13027 C<Not in MANIFEST:> I<file>, C<Skipping> I<file>, C<No such file:> I<file>,
13028 C<MANIFEST:> I<$!>, C<Added to MANIFEST:> I<file>
13029
13030 =item ENVIRONMENT
13031
13032 B<PERL_MM_MANIFEST_DEBUG>
13033
13034 =item SEE ALSO
13035
13036 =item AUTHOR
13037
13038 =back
13039
13040 =head2 ExtUtils::Miniperl, writemain - write the C code for perlmain.c
13041
13042 =over 4
13043
13044 =item SYNOPSIS
13045
13046 =item DESCRIPTION
13047
13048 =item SEE ALSO
13049
13050 =back
13051
13052 =head2 ExtUtils::Mkbootstrap - make a bootstrap file for use by DynaLoader
13053
13054 =over 4
13055
13056 =item SYNOPSIS
13057
13058 =item DESCRIPTION
13059
13060 =back
13061
13062 =head2 ExtUtils::Mksymlists - write linker options files for dynamic
13063 extension
13064
13065 =over 4
13066
13067 =item SYNOPSIS
13068
13069 =item DESCRIPTION
13070
13071 DLBASE, DL_FUNCS, DL_VARS, FILE, FUNCLIST, IMPORTS, NAME
13072
13073 =item AUTHOR
13074
13075 =item REVISION
13076
13077 =back
13078
13079 =head2 ExtUtils::Packlist - manage .packlist files
13080
13081 =over 4
13082
13083 =item SYNOPSIS
13084
13085 =item DESCRIPTION
13086
13087 =item USAGE
13088
13089 =item FUNCTIONS
13090
13091 new(), read(), write(), validate(), packlist_file()
13092
13093 =item EXAMPLE
13094
13095 =item AUTHOR
13096
13097 =back
13098
13099 =head2 ExtUtils::testlib - add blib/* directories to @INC
13100
13101 =over 4
13102
13103 =item SYNOPSIS
13104
13105 =item DESCRIPTION
13106
13107 =back
13108
13109 =head2 Fatal - replace functions with equivalents which succeed or die
13110
13111 =over 4
13112
13113 =item SYNOPSIS
13114
13115 =item DESCRIPTION
13116
13117 =item AUTHOR
13118
13119 =back
13120
13121 =head2 Fcntl - load the C Fcntl.h defines
13122
13123 =over 4
13124
13125 =item SYNOPSIS
13126
13127 =item DESCRIPTION
13128
13129 =item NOTE
13130
13131 =item EXPORTED SYMBOLS
13132
13133 =back
13134
13135 =head2 File::Basename, fileparse - split a pathname into pieces
13136
13137 =over 4
13138
13139 =item SYNOPSIS
13140
13141 =item DESCRIPTION
13142
13143 fileparse_set_fstype, fileparse
13144
13145 =item EXAMPLES
13146
13147 C<basename>, C<dirname>
13148
13149 =back
13150
13151 =head2 File::CheckTree, validate - run many filetest checks on a tree
13152
13153 =over 4
13154
13155 =item SYNOPSIS
13156
13157 =item DESCRIPTION
13158
13159 =item AUTHOR
13160
13161 =item HISTORY
13162
13163 =back
13164
13165 =head2 File::Compare - Compare files or filehandles
13166
13167 =over 4
13168
13169 =item SYNOPSIS
13170
13171 =item DESCRIPTION
13172
13173 =item RETURN
13174
13175 =item AUTHOR
13176
13177 =back
13178
13179 =head2 File::Copy - Copy files or filehandles
13180
13181 =over 4
13182
13183 =item SYNOPSIS
13184
13185 =item DESCRIPTION
13186
13187 =over 4
13188
13189 =item Special behaviour if C<syscopy> is defined (OS/2, VMS and Win32)
13190
13191 rmscopy($from,$to[,$date_flag])
13192
13193 =back
13194
13195 =item RETURN
13196
13197 =item NOTES
13198
13199 =item AUTHOR
13200
13201 =back
13202
13203 =head2 File::DosGlob - DOS like globbing and then some
13204
13205 =over 4
13206
13207 =item SYNOPSIS
13208
13209 =item DESCRIPTION
13210
13211 =item NOTES
13212
13213 =item EXPORTS (by request only)
13214
13215 =item BUGS
13216
13217 =item AUTHOR
13218
13219 =item HISTORY
13220
13221 =item SEE ALSO
13222
13223 =back
13224
13225 =head2 File::Find - Traverse a directory tree.
13226
13227 =over 4
13228
13229 =item SYNOPSIS
13230
13231 =item DESCRIPTION
13232
13233 B<find>, B<finddepth>
13234
13235 =over 4
13236
13237 =item %options
13238
13239 C<wanted>, C<bydepth>, C<preprocess>, C<postprocess>, C<follow>,
13240 C<follow_fast>, C<follow_skip>, C<dangling_symlinks>, C<no_chdir>,
13241 C<untaint>, C<untaint_pattern>, C<untaint_skip>
13242
13243 =item The wanted function
13244
13245 C<$File::Find::dir> is the current directory name,, C<$_> is the current
13246 filename within that directory, C<$File::Find::name> is the complete
13247 pathname to the file
13248
13249 =back
13250
13251 =item WARNINGS
13252
13253 =item CAVEAT
13254
13255 $dont_use_nlink, symlinks
13256
13257 =item NOTES
13258
13259 =item HISTORY
13260
13261 =back
13262
13263 =head2 File::Glob - Perl extension for BSD glob routine
13264
13265 =over 4
13266
13267 =item SYNOPSIS
13268
13269 =item DESCRIPTION
13270
13271 C<GLOB_ERR>, C<GLOB_LIMIT>, C<GLOB_MARK>, C<GLOB_NOCASE>, C<GLOB_NOCHECK>,
13272 C<GLOB_NOSORT>, C<GLOB_BRACE>, C<GLOB_NOMAGIC>, C<GLOB_QUOTE>,
13273 C<GLOB_TILDE>, C<GLOB_CSH>, C<GLOB_ALPHASORT>
13274
13275 =item DIAGNOSTICS
13276
13277 C<GLOB_NOSPACE>, C<GLOB_ABEND>
13278
13279 =item NOTES
13280
13281 =item AUTHOR
13282
13283 =back
13284
13285 =head2 File::Path - create or remove directory trees
13286
13287 =over 4
13288
13289 =item SYNOPSIS
13290
13291 =item DESCRIPTION
13292
13293 =item AUTHORS
13294
13295 =back
13296
13297 =head2 File::Spec - portably perform operations on file names
13298
13299 =over 4
13300
13301 =item SYNOPSIS
13302
13303 =item DESCRIPTION
13304
13305 =item METHODS
13306
13307 canonpath, catdir, catfile, curdir, devnull, rootdir, tmpdir, updir,
13308 no_upwards, case_tolerant, file_name_is_absolute, path, join, splitpath,
13309 splitdir, catpath(), abs2rel, rel2abs()
13310
13311 =item SEE ALSO
13312
13313 =item AUTHORS
13314
13315 =back
13316
13317 =head2 File::Spec::Cygwin - methods for Cygwin file specs
13318
13319 =over 4
13320
13321 =item SYNOPSIS
13322
13323 =item DESCRIPTION
13324
13325 =back
13326
13327 =head2 File::Spec::Epoc - methods for Epoc file specs
13328
13329 =over 4
13330
13331 =item SYNOPSIS
13332
13333 =item DESCRIPTION
13334
13335 canonpath()
13336
13337 =back
13338
13339 =over 4
13340
13341 =item SEE ALSO
13342
13343 =back
13344
13345 =head2 File::Spec::Functions - portably perform operations on file names
13346
13347 =over 4
13348
13349 =item SYNOPSIS
13350
13351 =item DESCRIPTION
13352
13353 =over 4
13354
13355 =item Exports
13356
13357 =back
13358
13359 =item SEE ALSO
13360
13361 =back
13362
13363 =head2 File::Spec::Mac - File::Spec for Mac OS (Classic)
13364
13365 =over 4
13366
13367 =item SYNOPSIS
13368
13369 =item DESCRIPTION
13370
13371 =item METHODS
13372
13373 canonpath
13374
13375 =back
13376
13377 catdir()
13378
13379 catfile
13380
13381 curdir
13382
13383 devnull
13384
13385 rootdir
13386
13387 tmpdir
13388
13389 updir
13390
13391 file_name_is_absolute
13392
13393 path
13394
13395 splitpath
13396
13397 splitdir
13398
13399 catpath
13400
13401 abs2rel
13402
13403 rel2abs
13404
13405 =over 4
13406
13407 =item AUTHORS
13408
13409 =item SEE ALSO
13410
13411 =back
13412
13413 canonpath
13414
13415 splitpath
13416
13417 splitdir
13418
13419 catpath
13420
13421 =head2 File::Spec::OS2 - methods for OS/2 file specs
13422
13423 =over 4
13424
13425 =item SYNOPSIS
13426
13427 =item DESCRIPTION
13428
13429 =back
13430
13431 =head2 File::Spec::Unix - File::Spec for Unix, base for other File::Spec
13432 modules
13433
13434 =over 4
13435
13436 =item SYNOPSIS
13437
13438 =item DESCRIPTION
13439
13440 =item METHODS
13441
13442 canonpath()
13443
13444 =back
13445
13446 catdir()
13447
13448 catfile
13449
13450 curdir
13451
13452 devnull
13453
13454 rootdir
13455
13456 tmpdir
13457
13458 updir
13459
13460 no_upwards
13461
13462 case_tolerant
13463
13464 file_name_is_absolute
13465
13466 path
13467
13468 join
13469
13470 splitpath
13471
13472 splitdir
13473
13474 catpath()
13475
13476 abs2rel
13477
13478 rel2abs()
13479
13480 =over 4
13481
13482 =item SEE ALSO
13483
13484 =back
13485
13486 =head2 File::Spec::VMS - methods for VMS file specs
13487
13488 =over 4
13489
13490 =item SYNOPSIS
13491
13492 =item DESCRIPTION
13493
13494 eliminate_macros
13495
13496 =back
13497
13498 fixpath
13499
13500 =over 4
13501
13502 =item Methods always loaded
13503
13504 canonpath (override)
13505
13506 =back
13507
13508 catdir
13509
13510 catfile
13511
13512 curdir (override)
13513
13514 devnull (override)
13515
13516 rootdir (override)
13517
13518 tmpdir (override)
13519
13520 updir (override)
13521
13522 case_tolerant (override)
13523
13524 path (override)
13525
13526 file_name_is_absolute (override)
13527
13528 splitpath (override)
13529
13530 splitdir (override)
13531
13532 catpath (override)
13533
13534 abs2rel (override)
13535
13536 rel2abs (override)
13537
13538 =over 4
13539
13540 =item SEE ALSO
13541
13542 =back
13543
13544 =head2 File::Spec::Win32 - methods for Win32 file specs
13545
13546 =over 4
13547
13548 =item SYNOPSIS
13549
13550 =item DESCRIPTION
13551
13552 devnull
13553
13554 =back
13555
13556 tmpdir
13557
13558 catfile
13559
13560 canonpath
13561
13562 splitpath
13563
13564 splitdir
13565
13566 catpath
13567
13568 =over 4
13569
13570 =item Note For File::Spec::Win32 Maintainers
13571
13572 =back
13573
13574 =over 4
13575
13576 =item SEE ALSO
13577
13578 =back
13579
13580 =head2 File::Temp - return name and handle of a temporary file safely
13581
13582 =over 4
13583
13584 =item PORTABILITY
13585
13586 =item SYNOPSIS
13587
13588 =item DESCRIPTION
13589
13590 =back
13591
13592 =over 4
13593
13594 =item FUNCTIONS
13595
13596 B<tempfile>
13597
13598 =back
13599
13600 B<tempdir>
13601
13602 =over 4
13603
13604 =item MKTEMP FUNCTIONS
13605
13606 B<mkstemp>
13607
13608 =back
13609
13610 B<mkstemps>
13611
13612 B<mkdtemp>
13613
13614 B<mktemp>
13615
13616 =over 4
13617
13618 =item POSIX FUNCTIONS
13619
13620 B<tmpnam>
13621
13622 =back
13623
13624 B<tmpfile>
13625
13626 =over 4
13627
13628 =item ADDITIONAL FUNCTIONS
13629
13630 B<tempnam>
13631
13632 =back
13633
13634 =over 4
13635
13636 =item UTILITY FUNCTIONS
13637
13638 B<unlink0>
13639
13640 =back
13641
13642 =over 4
13643
13644 =item PACKAGE VARIABLES
13645
13646 B<safe_level>, STANDARD, MEDIUM, HIGH
13647
13648 =back
13649
13650 TopSystemUID
13651
13652 =over 4
13653
13654 =item WARNING
13655
13656 =over 4
13657
13658 =item Temporary files and NFS
13659
13660 =back
13661
13662 =item HISTORY
13663
13664 =item SEE ALSO
13665
13666 =item AUTHOR
13667
13668 =back
13669
13670 =head2 File::stat - by-name interface to Perl's built-in stat() functions
13671
13672 =over 4
13673
13674 =item SYNOPSIS
13675
13676 =item DESCRIPTION
13677
13678 =item NOTE
13679
13680 =item AUTHOR
13681
13682 =back
13683
13684 =head2 FileCache - keep more files open than the system permits
13685
13686 =over 4
13687
13688 =item SYNOPSIS
13689
13690 =item DESCRIPTION
13691
13692 cacheout EXPR, cacheout MODE, EXPR
13693
13694 =item CAVEATS
13695
13696 =item BUGS
13697
13698 =back
13699
13700 =head2 FileHandle - supply object methods for filehandles
13701
13702 =over 4
13703
13704 =item SYNOPSIS
13705
13706 =item DESCRIPTION
13707
13708 $fh->print, $fh->printf, $fh->getline, $fh->getlines
13709
13710 =item SEE ALSO
13711
13712 =back
13713
13714 =head2 Filter::Simple - Simplified source filtering
13715
13716 =over 4
13717
13718 =item SYNOPSIS
13719
13720 =item DESCRIPTION
13721
13722 =over 4
13723
13724 =item The Problem
13725
13726 =item A Solution
13727
13728 =item Disabling or changing <no> behaviour
13729
13730 =item All-in-one interface
13731
13732 =item Filtering only specific components of source code
13733
13734 C<"code">, C<"executable">, C<"quotelike">, C<"string">, C<"regex">,
13735 C<"all">
13736
13737 =item Filtering only the code parts of source code
13738
13739 Most source code ceases to be grammatically correct when it is broken up
13740 into the pieces between string literals and regexes. So the C<'code'>
13741 component filter behaves slightly differently from the other partial
13742 filters
13743 described in the previous section.
13744
13745 =item Using Filter::Simple with an explicit C<import> subroutine
13746
13747 =item Using Filter::Simple and Exporter together
13748
13749 =item How it works
13750
13751 =back
13752
13753 =item AUTHOR
13754
13755 =item COPYRIGHT
13756
13757 =back
13758
13759 =head2 Filter::Util::Call - Perl Source Filter Utility Module
13760
13761 =over 4
13762
13763 =item SYNOPSIS
13764
13765 =item DESCRIPTION
13766
13767 =over 4
13768
13769 =item B<use Filter::Util::Call>
13770
13771 =item B<import()>
13772
13773 =item B<filter() and anonymous sub>
13774
13775 B<$_>, B<$status>, B<filter_read> and B<filter_read_exact>, B<filter_del>
13776
13777 =back
13778
13779 =item EXAMPLES
13780
13781 =over 4
13782
13783 =item Example 1: A simple filter.
13784
13785 =item Example 2: Using the context
13786
13787 =item Example 3: Using the context within the filter
13788
13789 =item Example 4: Using filter_del
13790
13791 =back
13792
13793 =item Filter::Simple
13794
13795 =item AUTHOR
13796
13797 =item DATE
13798
13799 =back
13800
13801 =head2 FindBin - Locate directory of original perl script
13802
13803 =over 4
13804
13805 =item SYNOPSIS
13806
13807 =item DESCRIPTION
13808
13809 =item EXPORTABLE VARIABLES
13810
13811 =item KNOWN ISSUES
13812
13813 =item KNOWN BUGS
13814
13815 =item AUTHORS
13816
13817 =item COPYRIGHT
13818
13819 =back
13820
13821 =head2 GDBM_File - Perl5 access to the gdbm library.
13822
13823 =over 4
13824
13825 =item SYNOPSIS
13826
13827 =item DESCRIPTION
13828
13829 =item AVAILABILITY
13830
13831 =item BUGS
13832
13833 =item SEE ALSO
13834
13835 =back
13836
13837 =head2 Getopt::Long - Extended processing of command line options
13838
13839 =over 4
13840
13841 =item SYNOPSIS
13842
13843 =item DESCRIPTION
13844
13845 =item Command Line Options, an Introduction
13846
13847 =item Getting Started with Getopt::Long
13848
13849 =over 4
13850
13851 =item Simple options
13852
13853 =item A little bit less simple options
13854
13855 =item Mixing command line option with other arguments
13856
13857 =item Options with values
13858
13859 =item Options with multiple values
13860
13861 =item Options with hash values
13862
13863 =item User-defined subroutines to handle options
13864
13865 =item Options with multiple names
13866
13867 =item Case and abbreviations
13868
13869 =item Summary of Option Specifications
13870
13871 !, +, s, i, o, f, : I<type> [ I<desttype> ], : I<number> [ I<desttype> ], :
13872 + [ I<desttype> ]
13873
13874 =back
13875
13876 =item Advanced Possibilities
13877
13878 =over 4
13879
13880 =item Object oriented interface
13881
13882 =item Thread Safety
13883
13884 =item Documentation and help texts
13885
13886 =item Storing options in a hash
13887
13888 =item Bundling
13889
13890 =item The lonesome dash
13891
13892 =item Argument callback
13893
13894 =back
13895
13896 =item Configuring Getopt::Long
13897
13898 default, posix_default, auto_abbrev, getopt_compat, gnu_compat, gnu_getopt,
13899 require_order, permute, bundling (default: disabled), bundling_override
13900 (default: disabled), ignore_case  (default: enabled), ignore_case_always
13901 (default: disabled), pass_through (default: disabled), prefix,
13902 prefix_pattern, debug (default: disabled)
13903
13904 =item Return values and Errors
13905
13906 =item Legacy
13907
13908 =over 4
13909
13910 =item Default destinations
13911
13912 =item Alternative option starters
13913
13914 =item Configuration variables
13915
13916 =back
13917
13918 =item Trouble Shooting
13919
13920 =over 4
13921
13922 =item Warning: Ignoring '!' modifier for short option
13923
13924 =item GetOptions does not return a false result when an option is not
13925 supplied
13926
13927 =item GetOptions does not split the command line correctly
13928
13929 =item How do I put a "-?" option into a Getopt::Long?
13930
13931 =back
13932
13933 =item AUTHOR
13934
13935 =item COPYRIGHT AND DISCLAIMER
13936
13937 =back
13938
13939 =head2 Getopt::Std, getopt - Process single-character switches with switch
13940 clustering
13941
13942 =over 4
13943
13944 =item SYNOPSIS
13945
13946 =item DESCRIPTION
13947
13948 =back
13949
13950 =head2 Hash::Util - A selection of general-utility hash subroutines
13951
13952 =over 4
13953
13954 =item SYNOPSIS
13955
13956 =item DESCRIPTION
13957
13958 =over 4
13959
13960 =item Restricted hashes
13961
13962 lock_keys, unlock_keys
13963
13964 =back
13965
13966 =back
13967
13968 lock_value, unlock_value
13969
13970 B<lock_hash>, B<unlock_hash>
13971
13972 =over 4
13973
13974 =item AUTHOR
13975
13976 =item SEE ALSO
13977
13978 =back
13979
13980 =head2 I18N::Collate - compare 8-bit scalar data according to the current
13981 locale
13982
13983 =over 4
13984
13985 =item SYNOPSIS
13986
13987 =item DESCRIPTION
13988
13989 =back
13990
13991 =head2 I18N::LangTags - functions for dealing with RFC3066-style language
13992 tags
13993
13994 =over 4
13995
13996 =item SYNOPSIS
13997
13998 =item DESCRIPTION
13999
14000 =back
14001
14002 the function is_language_tag($lang1)
14003
14004 the function extract_language_tags($whatever)
14005
14006 the function same_language_tag($lang1, $lang2)
14007
14008 the function similarity_language_tag($lang1, $lang2)
14009
14010 the function is_dialect_of($lang1, $lang2)
14011
14012 the function super_languages($lang1)
14013
14014 the function locale2language_tag($locale_identifier)
14015
14016 the function encode_language_tag($lang1)
14017
14018 the function alternate_language_tags($lang1)
14019
14020 the function @langs = panic_languages(@accept_languages)
14021
14022 =over 4
14023
14024 =item ABOUT LOWERCASING
14025
14026 =item ABOUT UNICODE PLAINTEXT LANGUAGE TAGS
14027
14028 =item SEE ALSO
14029
14030 =item COPYRIGHT
14031
14032 =item AUTHOR
14033
14034 =back
14035
14036 =head2 I18N::LangTags::List -- tags and names for human languages
14037
14038 =over 4
14039
14040 =item SYNOPSIS
14041
14042 =item DESCRIPTION
14043
14044 =item ABOUT LANGUAGE TAGS
14045
14046 =item LIST OF LANGUAGES
14047
14048 {ab} : Abkhazian, {ace} : Achinese, {ach} : Acoli, {ada} : Adangme, {aa} :
14049 Afar, {afh} : Afrihili, {af} : Afrikaans, [{afa} : Afro-Asiatic (Other)],
14050 {aka} : Akan, {akk} : Akkadian, {sq} : Albanian, {ale} : Aleut, [{alg} :
14051 Algonquian languages], [{tut} : Altaic (Other)], {am} : Amharic, {i-ami} :
14052 Ami, [{apa} : Apache languages], {ar} : Arabic, {arc} : Aramaic, {arp} :
14053 Arapaho, {arn} : Araucanian, {arw} : Arawak, {hy} : Armenian, [{art} :
14054 Artificial (Other)], {as} : Assamese, [{ath} : Athapascan languages],
14055 [{aus} : Australian languages], [{map} : Austronesian (Other)], {ava} :
14056 Avaric, {ae} : Avestan, {awa} : Awadhi, {ay} : Aymara, {az} : Azerbaijani,
14057 {ban} : Balinese, [{bat} : Baltic (Other)], {bal} : Baluchi, {bam} :
14058 Bambara, [{bai} : Bamileke languages], {bad} : Banda, [{bnt} : Bantu
14059 (Other)], {bas} : Basa, {ba} : Bashkir, {eu} : Basque, {btk} : Batak
14060 (Indonesia), {bej} : Beja, {be} : Belarusian, {bem} : Bemba, {bn} :
14061 Bengali, [{ber} : Berber (Other)], {bho} : Bhojpuri, {bh} : Bihari, {bik} :
14062 Bikol, {bin} : Bini, {bi} : Bislama, {bs} : Bosnian, {bra} : Braj, {br} :
14063 Breton, {bug} : Buginese, {bg} : Bulgarian, {i-bnn} : Bunun, {bua} :
14064 Buriat, {my} : Burmese, {cad} : Caddo, {car} : Carib, {ca} : Catalan,
14065 [{cau} : Caucasian (Other)], {ceb} : Cebuano, [{cel} : Celtic (Other)],
14066 [{cai} : Central American Indian (Other)], {chg} : Chagatai, [{cmc} :
14067 Chamic languages], {ch} : Chamorro, {ce} : Chechen, {chr} : Cherokee, {chy}
14068 : Cheyenne, {chb} : Chibcha, {ny} : Chichewa, {zh} : Chinese, {chn} :
14069 Chinook Jargon, {chp} : Chipewyan, {cho} : Choctaw, {cu} : Church Slavic,
14070 {chk} : Chuukese, {cv} : Chuvash, {cop} : Coptic, {kw} : Cornish, {co} :
14071 Corsican, {cre} : Cree, {mus} : Creek, [{cpe} : English-based Creoles and
14072 pidgins (Other)], [{cpf} : French-based Creoles and pidgins (Other)],
14073 [{cpp} : Portuguese-based Creoles and pidgins (Other)], [{crp} : Creoles
14074 and pidgins (Other)], {hr} : Croatian, [{cus} : Cushitic (Other)], {cs} :
14075 Czech, {dak} : Dakota, {da} : Danish, {day} : Dayak, {i-default} : Default
14076 (Fallthru) Language, {del} : Delaware, {din} : Dinka, {div} : Divehi, {doi}
14077 : Dogri, {dgr} : Dogrib, [{dra} : Dravidian (Other)], {dua} : Duala, {nl} :
14078 Dutch, {dum} : Middle Dutch (ca.1050-1350), {dyu} : Dyula, {dz} : Dzongkha,
14079 {efi} : Efik, {egy} : Ancient Egyptian, {eka} : Ekajuk, {elx} : Elamite,
14080 {en} : English, {enm} : Old English (1100-1500), {ang} : Old English
14081 (ca.450-1100), {eo} : Esperanto, {et} : Estonian, {ewe} : Ewe, {ewo} :
14082 Ewondo, {fan} : Fang, {fat} : Fanti, {fo} : Faroese, {fj} : Fijian, {fi} :
14083 Finnish, [{fiu} : Finno-Ugrian (Other)], {fon} : Fon, {fr} : French, {frm}
14084 : Middle French (ca.1400-1600), {fro} : Old French (842-ca.1400), {fy} :
14085 Frisian, {fur} : Friulian, {ful} : Fulah, {gaa} : Ga, {gd} : Scots Gaelic,
14086 {gl} : Gallegan, {lug} : Ganda, {gay} : Gayo, {gba} : Gbaya, {gez} : Geez,
14087 {ka} : Georgian, {de} : German, {gmh} : Middle High German (ca.1050-1500),
14088 {goh} : Old High German (ca.750-1050), [{gem} : Germanic (Other)], {gil} :
14089 Gilbertese, {gon} : Gondi, {gor} : Gorontalo, {got} : Gothic, {grb} :
14090 Grebo, {grc} : Ancient Greek, {el} : Modern Greek, {gn} : Guarani, {gu} :
14091 Gujarati, {gwi} : Gwich'in, {hai} : Haida, {ha} : Hausa, {haw} : Hawaiian,
14092 {he} : Hebrew, {hz} : Herero, {hil} : Hiligaynon, {him} : Himachali, {hi} :
14093 Hindi, {ho} : Hiri Motu, {hit} : Hittite, {hmn} : Hmong, {hu} : Hungarian,
14094 {hup} : Hupa, {iba} : Iban, {is} : Icelandic, {ibo} : Igbo, {ijo} : Ijo,
14095 {ilo} : Iloko, [{inc} : Indic (Other)], [{ine} : Indo-European (Other)],
14096 {id} : Indonesian, {ia} : Interlingua (International Auxiliary Language
14097 Association), {ie} : Interlingue, {iu} : Inuktitut, {ik} : Inupiaq, [{ira}
14098 : Iranian (Other)], {ga} : Irish, {mga} : Middle Irish (900-1200), {sga} :
14099 Old Irish (to 900), [{iro} : Iroquoian languages], {it} : Italian, {ja} :
14100 Japanese, {jw} : Javanese, {jrb} : Judeo-Arabic, {jpr} : Judeo-Persian,
14101 {kab} : Kabyle, {kac} : Kachin, {kl} : Kalaallisut, {kam} : Kamba, {kn} :
14102 Kannada, {kau} : Kanuri, {kaa} : Kara-Kalpak, {kar} : Karen, {ks} :
14103 Kashmiri, {kaw} : Kawi, {kk} : Kazakh, {kha} : Khasi, {km} : Khmer, [{khi}
14104 : Khoisan (Other)], {kho} : Khotanese, {ki} : Kikuyu, {kmb} : Kimbundu,
14105 {rw} : Kinyarwanda, {ky} : Kirghiz, {i-klingon} : Klingon, {kv} : Komi,
14106 {kon} : Kongo, {kok} : Konkani, {ko} : Korean, {kos} : Kosraean, {kpe} :
14107 Kpelle, {kro} : Kru, {kj} : Kuanyama, {kum} : Kumyk, {ku} : Kurdish, {kru}
14108 : Kurukh, {kut} : Kutenai, {lad} : Ladino, {lah} : Lahnda, {lam} : Lamba,
14109 {lo} : Lao, {la} : Latin, {lv} : Latvian, {lb} : Letzeburgesch, {lez} :
14110 Lezghian, {ln} : Lingala, {lt} : Lithuanian, {nds} : Low German, {loz} :
14111 Lozi, {lub} : Luba-Katanga, {lua} : Luba-Lulua, {lui} : Luiseno, {lun} :
14112 Lunda, {luo} : Luo (Kenya and Tanzania), {lus} : Lushai, {mk} : Macedonian,
14113 {mad} : Madurese, {mag} : Magahi, {mai} : Maithili, {mak} : Makasar, {mg} :
14114 Malagasy, {ms} : Malay, {ml} : Malayalam, {mt} : Maltese, {mnc} : Manchu,
14115 {mdr} : Mandar, {man} : Mandingo, {mni} : Manipuri, [{mno} : Manobo
14116 languages], {gv} : Manx, {mi} : Maori, {mr} : Marathi, {chm} : Mari, {mh} :
14117 Marshall, {mwr} : Marwari, {mas} : Masai, [{myn} : Mayan languages], {men}
14118 : Mende, {mic} : Micmac, {min} : Minangkabau, {i-mingo} : Mingo, [{mis} :
14119 Miscellaneous languages], {moh} : Mohawk, {mo} : Moldavian, [{mkh} :
14120 Mon-Khmer (Other)], {lol} : Mongo, {mn} : Mongolian, {mos} : Mossi, [{mul}
14121 : Multiple languages], [{mun} : Munda languages], {nah} : Nahuatl, {na} :
14122 Nauru, {nv} : Navajo, {nd} : North Ndebele, {nr} : South Ndebele, {ng} :
14123 Ndonga, {ne} : Nepali, {new} : Newari, {nia} : Nias, [{nic} :
14124 Niger-Kordofanian (Other)], [{ssa} : Nilo-Saharan (Other)], {niu} : Niuean,
14125 {non} : Old Norse, [{nai} : North American Indian], {se} : Northern Sami,
14126 {no} : Norwegian, {nb} : Norwegian Bokmal, {nn} : Norwegian Nynorsk, [{nub}
14127 : Nubian languages], {nym} : Nyamwezi, {nyn} : Nyankole, {nyo} : Nyoro,
14128 {nzi} : Nzima, {oc} : Occitan (post 1500), {oji} : Ojibwa, {or} : Oriya,
14129 {om} : Oromo, {osa} : Osage, {os} : Ossetian; Ossetic, [{oto} : Otomian
14130 languages], {pal} : Pahlavi, {i-pwn} : Paiwan, {pau} : Palauan, {pi} :
14131 Pali, {pam} : Pampanga, {pag} : Pangasinan, {pa} : Panjabi, {pap} :
14132 Papiamento, [{paa} : Papuan (Other)], {fa} : Persian, {peo} : Old Persian
14133 (ca.600-400 B.C.), [{phi} : Philippine (Other)], {phn} : Phoenician, {pon}
14134 : Pohnpeian, {pl} : Polish, {pt} : Portuguese, [{pra} : Prakrit languages],
14135 {pro} : Old Provencal (to 1500), {ps} : Pushto, {qu} : Quechua, {rm} :
14136 Raeto-Romance, {raj} : Rajasthani, {rap} : Rapanui, {rar} : Rarotongan,
14137 [{qaa - qtz} : Reserved for local use.], [{roa} : Romance (Other)], {ro} :
14138 Romanian, {rom} : Romany, {rn} : Rundi, {ru} : Russian, [{sal} : Salishan
14139 languages], {sam} : Samaritan Aramaic, [{smi} : Sami languages (Other)],
14140 {sm} : Samoan, {sad} : Sandawe, {sg} : Sango, {sa} : Sanskrit, {sat} :
14141 Santali, {sc} : Sardinian, {sas} : Sasak, {sco} : Scots, {sel} : Selkup,
14142 [{sem} : Semitic (Other)], {sr} : Serbian, {srr} : Serer, {shn} : Shan,
14143 {sn} : Shona, {sid} : Sidamo, {sgn-...} : Sign Languages, {bla} : Siksika,
14144 {sd} : Sindhi, {si} : Sinhalese, [{sit} : Sino-Tibetan (Other)], [{sio} :
14145 Siouan languages], {den} : Slave (Athapascan), [{sla} : Slavic (Other)],
14146 {sk} : Slovak, {sl} : Slovenian, {sog} : Sogdian, {so} : Somali, {son} :
14147 Songhai, {snk} : Soninke, {wen} : Sorbian languages, {nso} : Northern
14148 Sotho, {st} : Southern Sotho, [{sai} : South American Indian (Other)], {es}
14149 : Spanish, {suk} : Sukuma, {sux} : Sumerian, {su} : Sundanese, {sus} :
14150 Susu, {sw} : Swahili, {ss} : Swati, {sv} : Swedish, {syr} : Syriac, {tl} :
14151 Tagalog, {ty} : Tahitian, [{tai} : Tai (Other)], {tg} : Tajik, {tmh} :
14152 Tamashek, {ta} : Tamil, {i-tao} : Tao, {tt} : Tatar, {i-tay} : Tayal, {te}
14153 : Telugu, {ter} : Tereno, {tet} : Tetum, {th} : Thai, {bo} : Tibetan, {tig}
14154 : Tigre, {ti} : Tigrinya, {tem} : Timne, {tiv} : Tiv, {tli} : Tlingit,
14155 {tpi} : Tok Pisin, {tkl} : Tokelau, {tog} : Tonga (Nyasa), {to} : Tonga
14156 (Tonga Islands), {tsi} : Tsimshian, {ts} : Tsonga, {i-tsu} : Tsou, {tn} :
14157 Tswana, {tum} : Tumbuka, {tr} : Turkish, {ota} : Ottoman Turkish
14158 (1500-1928), {tk} : Turkmen, {tvl} : Tuvalu, {tyv} : Tuvinian, {tw} : Twi,
14159 {uga} : Ugaritic, {ug} : Uighur, {uk} : Ukrainian, {umb} : Umbundu, {und} :
14160 Undetermined, {ur} : Urdu, {uz} : Uzbek, {vai} : Vai, {ven} : Venda, {vi} :
14161 Vietnamese, {vo} : Volapuk, {vot} : Votic, [{wak} : Wakashan languages],
14162 {wal} : Walamo, {war} : Waray, {was} : Washo, {cy} : Welsh, {wo} : Wolof,
14163 {x-...} : Unregistered (Semi-Private Use), {xh} : Xhosa, {sah} : Yakut,
14164 {yao} : Yao, {yap} : Yapese, {yi} : Yiddish, {yo} : Yoruba, [{ypk} : Yupik
14165 languages], {znd} : Zande, [{zap} : Zapotec], {zen} : Zenaga, {za} :
14166 Zhuang, {zu} : Zulu, {zun} : Zuni
14167
14168 =item SEE ALSO
14169
14170 =item COPYRIGHT AND DISCLAIMER
14171
14172 =item AUTHOR
14173
14174 =back
14175
14176 =head2 I18N::Langinfo - query locale information
14177
14178 =over 4
14179
14180 =item SYNOPSIS
14181
14182 =item DESCRIPTION
14183
14184 =over 4
14185
14186 =item EXPORT
14187
14188 =back
14189
14190 =item SEE ALSO
14191
14192 =item AUTHOR
14193
14194 =item COPYRIGHT AND LICENSE
14195
14196 =back
14197
14198 =head2 IO - load various IO modules
14199
14200 =over 4
14201
14202 =item SYNOPSIS
14203
14204 =item DESCRIPTION
14205
14206 =back
14207
14208 =head2 IO::Dir - supply object methods for directory handles
14209
14210 =over 4
14211
14212 =item SYNOPSIS
14213
14214 =item DESCRIPTION
14215
14216 new ( [ DIRNAME ] ), open ( DIRNAME ), read (), seek ( POS ), tell (),
14217 rewind (), close (), tie %hash, IO::Dir, DIRNAME [, OPTIONS ]
14218
14219 =item SEE ALSO
14220
14221 =item AUTHOR
14222
14223 =item COPYRIGHT
14224
14225 =back
14226
14227 =head2 IO::File - supply object methods for filehandles
14228
14229 =over 4
14230
14231 =item SYNOPSIS
14232
14233 =item DESCRIPTION
14234
14235 =item CONSTRUCTOR
14236
14237 new ( FILENAME [,MODE [,PERMS]] ), new_tmpfile
14238
14239 =item METHODS
14240
14241 open( FILENAME [,MODE [,PERMS]] )
14242
14243 =item SEE ALSO
14244
14245 =item HISTORY
14246
14247 =back
14248
14249 =head2 IO::Handle - supply object methods for I/O handles
14250
14251 =over 4
14252
14253 =item SYNOPSIS
14254
14255 =item DESCRIPTION
14256
14257 =item CONSTRUCTOR
14258
14259 new (), new_from_fd ( FD, MODE )
14260
14261 =item METHODS
14262
14263 $io->fdopen ( FD, MODE ), $io->opened, $io->getline, $io->getlines,
14264 $io->ungetc ( ORD ), $io->write ( BUF, LEN [, OFFSET ] ), $io->error,
14265 $io->clearerr, $io->sync, $io->flush, $io->printflush ( ARGS ),
14266 $io->blocking ( [ BOOL ] ), $io->untaint
14267
14268 =item NOTE
14269
14270 =item SEE ALSO
14271
14272 =item BUGS
14273
14274 =item HISTORY
14275
14276 =back
14277
14278 =head2 IO::Pipe - supply object methods for pipes
14279
14280 =over 4
14281
14282 =item SYNOPSIS
14283
14284 =item DESCRIPTION
14285
14286 =item CONSTRUCTOR
14287
14288 new ( [READER, WRITER] )
14289
14290 =item METHODS
14291
14292 reader ([ARGS]), writer ([ARGS]), handles ()
14293
14294 =item SEE ALSO
14295
14296 =item AUTHOR
14297
14298 =item COPYRIGHT
14299
14300 =back
14301
14302 =head2 IO::Poll - Object interface to system poll call
14303
14304 =over 4
14305
14306 =item SYNOPSIS
14307
14308 =item DESCRIPTION
14309
14310 =item METHODS
14311
14312 mask ( IO [, EVENT_MASK ] ), poll ( [ TIMEOUT ] ), events ( IO ), remove (
14313 IO ), handles( [ EVENT_MASK ] )
14314
14315 =item SEE ALSO
14316
14317 =item AUTHOR
14318
14319 =item COPYRIGHT
14320
14321 =back
14322
14323 =head2 IO::Seekable - supply seek based methods for I/O objects
14324
14325 =over 4
14326
14327 =item SYNOPSIS
14328
14329 =item DESCRIPTION
14330
14331 $io->getpos, $io->setpos, $io->seek ( POS, WHENCE ), WHENCE=0 (SEEK_SET),
14332 WHENCE=1 (SEEK_CUR), WHENCE=2 (SEEK_END), $io->sysseek( POS, WHENCE ),
14333 $io->tell
14334
14335 =item SEE ALSO
14336
14337 =item HISTORY
14338
14339 =back
14340
14341 =head2 IO::Select - OO interface to the select system call
14342
14343 =over 4
14344
14345 =item SYNOPSIS
14346
14347 =item DESCRIPTION
14348
14349 =item CONSTRUCTOR
14350
14351 new ( [ HANDLES ] )
14352
14353 =item METHODS
14354
14355 add ( HANDLES ), remove ( HANDLES ), exists ( HANDLE ), handles, can_read (
14356 [ TIMEOUT ] ), can_write ( [ TIMEOUT ] ), has_exception ( [ TIMEOUT ] ),
14357 count (), bits(), select ( READ, WRITE, ERROR [, TIMEOUT ] )
14358
14359 =item EXAMPLE
14360
14361 =item AUTHOR
14362
14363 =item COPYRIGHT
14364
14365 =back
14366
14367 =head2 IO::Socket - Object interface to socket communications
14368
14369 =over 4
14370
14371 =item SYNOPSIS
14372
14373 =item DESCRIPTION
14374
14375 =item CONSTRUCTOR
14376
14377 new ( [ARGS] )
14378
14379 =item METHODS
14380
14381 accept([PKG]), socketpair(DOMAIN, TYPE, PROTOCOL), atmark, connected,
14382 protocol, sockdomain, sockopt(OPT [, VAL]), socktype, timeout([VAL])
14383
14384 =item SEE ALSO
14385
14386 =item AUTHOR
14387
14388 =item COPYRIGHT
14389
14390 =back
14391
14392 =head2 IO::Socket::INET - Object interface for AF_INET domain sockets
14393
14394 =over 4
14395
14396 =item SYNOPSIS
14397
14398 =item DESCRIPTION
14399
14400 =item CONSTRUCTOR
14401
14402 new ( [ARGS] )
14403
14404 =over 4
14405
14406 =item METHODS
14407
14408 sockaddr (), sockport (), sockhost (), peeraddr (), peerport (), peerhost
14409 ()
14410
14411 =back
14412
14413 =item SEE ALSO
14414
14415 =item AUTHOR
14416
14417 =item COPYRIGHT
14418
14419 =back
14420
14421 =head2 IO::Socket::UNIX - Object interface for AF_UNIX domain sockets
14422
14423 =over 4
14424
14425 =item SYNOPSIS
14426
14427 =item DESCRIPTION
14428
14429 =item CONSTRUCTOR
14430
14431 new ( [ARGS] )
14432
14433 =item METHODS
14434
14435 hostpath(), peerpath()
14436
14437 =item SEE ALSO
14438
14439 =item AUTHOR
14440
14441 =item COPYRIGHT
14442
14443 =back
14444
14445 =head2 IO::lib::IO::Dir, IO::Dir - supply object methods for directory
14446 handles
14447
14448 =over 4
14449
14450 =item SYNOPSIS
14451
14452 =item DESCRIPTION
14453
14454 new ( [ DIRNAME ] ), open ( DIRNAME ), read (), seek ( POS ), tell (),
14455 rewind (), close (), tie %hash, IO::Dir, DIRNAME [, OPTIONS ]
14456
14457 =item SEE ALSO
14458
14459 =item AUTHOR
14460
14461 =item COPYRIGHT
14462
14463 =back
14464
14465 =head2 IO::lib::IO::File, IO::File - supply object methods for filehandles
14466
14467 =over 4
14468
14469 =item SYNOPSIS
14470
14471 =item DESCRIPTION
14472
14473 =item CONSTRUCTOR
14474
14475 new ( FILENAME [,MODE [,PERMS]] ), new_tmpfile
14476
14477 =item METHODS
14478
14479 open( FILENAME [,MODE [,PERMS]] )
14480
14481 =item SEE ALSO
14482
14483 =item HISTORY
14484
14485 =back
14486
14487 =head2 IO::lib::IO::Handle, IO::Handle - supply object methods for I/O
14488 handles
14489
14490 =over 4
14491
14492 =item SYNOPSIS
14493
14494 =item DESCRIPTION
14495
14496 =item CONSTRUCTOR
14497
14498 new (), new_from_fd ( FD, MODE )
14499
14500 =item METHODS
14501
14502 $io->fdopen ( FD, MODE ), $io->opened, $io->getline, $io->getlines,
14503 $io->ungetc ( ORD ), $io->write ( BUF, LEN [, OFFSET ] ), $io->error,
14504 $io->clearerr, $io->sync, $io->flush, $io->printflush ( ARGS ),
14505 $io->blocking ( [ BOOL ] ), $io->untaint
14506
14507 =item NOTE
14508
14509 =item SEE ALSO
14510
14511 =item BUGS
14512
14513 =item HISTORY
14514
14515 =back
14516
14517 =head2 IO::lib::IO::Pipe, IO::Pipe - supply object methods for pipes
14518
14519 =over 4
14520
14521 =item SYNOPSIS
14522
14523 =item DESCRIPTION
14524
14525 =item CONSTRUCTOR
14526
14527 new ( [READER, WRITER] )
14528
14529 =item METHODS
14530
14531 reader ([ARGS]), writer ([ARGS]), handles ()
14532
14533 =item SEE ALSO
14534
14535 =item AUTHOR
14536
14537 =item COPYRIGHT
14538
14539 =back
14540
14541 =head2 IO::lib::IO::Poll, IO::Poll - Object interface to system poll call
14542
14543 =over 4
14544
14545 =item SYNOPSIS
14546
14547 =item DESCRIPTION
14548
14549 =item METHODS
14550
14551 mask ( IO [, EVENT_MASK ] ), poll ( [ TIMEOUT ] ), events ( IO ), remove (
14552 IO ), handles( [ EVENT_MASK ] )
14553
14554 =item SEE ALSO
14555
14556 =item AUTHOR
14557
14558 =item COPYRIGHT
14559
14560 =back
14561
14562 =head2 IO::lib::IO::Seekable, IO::Seekable - supply seek based methods for
14563 I/O objects
14564
14565 =over 4
14566
14567 =item SYNOPSIS
14568
14569 =item DESCRIPTION
14570
14571 $io->getpos, $io->setpos, $io->seek ( POS, WHENCE ), WHENCE=0 (SEEK_SET),
14572 WHENCE=1 (SEEK_CUR), WHENCE=2 (SEEK_END), $io->sysseek( POS, WHENCE ),
14573 $io->tell
14574
14575 =item SEE ALSO
14576
14577 =item HISTORY
14578
14579 =back
14580
14581 =head2 IO::lib::IO::Select, IO::Select - OO interface to the select system
14582 call
14583
14584 =over 4
14585
14586 =item SYNOPSIS
14587
14588 =item DESCRIPTION
14589
14590 =item CONSTRUCTOR
14591
14592 new ( [ HANDLES ] )
14593
14594 =item METHODS
14595
14596 add ( HANDLES ), remove ( HANDLES ), exists ( HANDLE ), handles, can_read (
14597 [ TIMEOUT ] ), can_write ( [ TIMEOUT ] ), has_exception ( [ TIMEOUT ] ),
14598 count (), bits(), select ( READ, WRITE, ERROR [, TIMEOUT ] )
14599
14600 =item EXAMPLE
14601
14602 =item AUTHOR
14603
14604 =item COPYRIGHT
14605
14606 =back
14607
14608 =head2 IO::lib::IO::Socket, IO::Socket - Object interface to socket
14609 communications
14610
14611 =over 4
14612
14613 =item SYNOPSIS
14614
14615 =item DESCRIPTION
14616
14617 =item CONSTRUCTOR
14618
14619 new ( [ARGS] )
14620
14621 =item METHODS
14622
14623 accept([PKG]), socketpair(DOMAIN, TYPE, PROTOCOL), atmark, connected,
14624 protocol, sockdomain, sockopt(OPT [, VAL]), socktype, timeout([VAL])
14625
14626 =item SEE ALSO
14627
14628 =item AUTHOR
14629
14630 =item COPYRIGHT
14631
14632 =back
14633
14634 =head2 IO::lib::IO::Socket::INET, IO::Socket::INET - Object interface for
14635 AF_INET domain sockets
14636
14637 =over 4
14638
14639 =item SYNOPSIS
14640
14641 =item DESCRIPTION
14642
14643 =item CONSTRUCTOR
14644
14645 new ( [ARGS] )
14646
14647 =over 4
14648
14649 =item METHODS
14650
14651 sockaddr (), sockport (), sockhost (), peeraddr (), peerport (), peerhost
14652 ()
14653
14654 =back
14655
14656 =item SEE ALSO
14657
14658 =item AUTHOR
14659
14660 =item COPYRIGHT
14661
14662 =back
14663
14664 =head2 IO::lib::IO::Socket::UNIX, IO::Socket::UNIX - Object interface for
14665 AF_UNIX domain sockets
14666
14667 =over 4
14668
14669 =item SYNOPSIS
14670
14671 =item DESCRIPTION
14672
14673 =item CONSTRUCTOR
14674
14675 new ( [ARGS] )
14676
14677 =item METHODS
14678
14679 hostpath(), peerpath()
14680
14681 =item SEE ALSO
14682
14683 =item AUTHOR
14684
14685 =item COPYRIGHT
14686
14687 =back
14688
14689 =head2 IPC::Msg - SysV Msg IPC object class
14690
14691 =over 4
14692
14693 =item SYNOPSIS
14694
14695 =item DESCRIPTION
14696
14697 =item METHODS
14698
14699 new ( KEY , FLAGS ), id, rcv ( BUF, LEN [, TYPE [, FLAGS ]] ), remove, set
14700 ( STAT ), set ( NAME => VALUE [, NAME => VALUE ...] ), snd ( TYPE, MSG [,
14701 FLAGS ] ), stat
14702
14703 =item SEE ALSO
14704
14705 =item AUTHOR
14706
14707 =item COPYRIGHT
14708
14709 =back
14710
14711 =head2 IPC::Open2, open2 - open a process for both reading and writing
14712
14713 =over 4
14714
14715 =item SYNOPSIS
14716
14717 =item DESCRIPTION
14718
14719 =item WARNING
14720
14721 =item SEE ALSO
14722
14723 =back
14724
14725 =head2 IPC::Open3, open3 - open a process for reading, writing, and error
14726 handling
14727
14728 =over 4
14729
14730 =item SYNOPSIS
14731
14732 =item DESCRIPTION
14733
14734 =item WARNING
14735
14736 =back
14737
14738 =head2 IPC::Semaphore - SysV Semaphore IPC object class
14739
14740 =over 4
14741
14742 =item SYNOPSIS
14743
14744 =item DESCRIPTION
14745
14746 =item METHODS
14747
14748 new ( KEY , NSEMS , FLAGS ), getall, getncnt ( SEM ), getpid ( SEM ),
14749 getval ( SEM ), getzcnt ( SEM ), id, op ( OPLIST ), remove, set ( STAT ),
14750 set ( NAME => VALUE [, NAME => VALUE ...] ), setall ( VALUES ), setval ( N
14751 , VALUE ), stat
14752
14753 =item SEE ALSO
14754
14755 =item AUTHOR
14756
14757 =item COPYRIGHT
14758
14759 =back
14760
14761 =head2 IPC::SysV - SysV IPC constants
14762
14763 =over 4
14764
14765 =item SYNOPSIS
14766
14767 =item DESCRIPTION
14768
14769 ftok( PATH, ID )
14770
14771 =item SEE ALSO
14772
14773 =item AUTHORS
14774
14775 =item COPYRIGHT
14776
14777 =back
14778
14779 =head2 IPC::SysV::Msg, IPC::Msg - SysV Msg IPC object class
14780
14781 =over 4
14782
14783 =item SYNOPSIS
14784
14785 =item DESCRIPTION
14786
14787 =item METHODS
14788
14789 new ( KEY , FLAGS ), id, rcv ( BUF, LEN [, TYPE [, FLAGS ]] ), remove, set
14790 ( STAT ), set ( NAME => VALUE [, NAME => VALUE ...] ), snd ( TYPE, MSG [,
14791 FLAGS ] ), stat
14792
14793 =item SEE ALSO
14794
14795 =item AUTHOR
14796
14797 =item COPYRIGHT
14798
14799 =back
14800
14801 =head2 IPC::SysV::Semaphore, IPC::Semaphore - SysV Semaphore IPC object
14802 class
14803
14804 =over 4
14805
14806 =item SYNOPSIS
14807
14808 =item DESCRIPTION
14809
14810 =item METHODS
14811
14812 new ( KEY , NSEMS , FLAGS ), getall, getncnt ( SEM ), getpid ( SEM ),
14813 getval ( SEM ), getzcnt ( SEM ), id, op ( OPLIST ), remove, set ( STAT ),
14814 set ( NAME => VALUE [, NAME => VALUE ...] ), setall ( VALUES ), setval ( N
14815 , VALUE ), stat
14816
14817 =item SEE ALSO
14818
14819 =item AUTHOR
14820
14821 =item COPYRIGHT
14822
14823 =back
14824
14825 =head2 List::Util - A selection of general-utility list subroutines
14826
14827 =over 4
14828
14829 =item SYNOPSIS
14830
14831 =item DESCRIPTION
14832
14833 first BLOCK LIST, max LIST, maxstr LIST, min LIST, minstr LIST, reduce
14834 BLOCK LIST, shuffle LIST, sum LIST
14835
14836 =item KNOWN BUGS
14837
14838 =item SUGGESTED ADDITIONS
14839
14840 =item COPYRIGHT
14841
14842 =back
14843
14844 =head2 List::Utilib::List::Util, List::Util - A selection of
14845 general-utility list subroutines
14846
14847 =over 4
14848
14849 =item SYNOPSIS
14850
14851 =item DESCRIPTION
14852
14853 first BLOCK LIST, max LIST, maxstr LIST, min LIST, minstr LIST, reduce
14854 BLOCK LIST, shuffle LIST, sum LIST
14855
14856 =item KNOWN BUGS
14857
14858 =item SUGGESTED ADDITIONS
14859
14860 =item COPYRIGHT
14861
14862 =back
14863
14864 =head2 List::Utilib::Scalar::Util, Scalar::Util - A selection of
14865 general-utility scalar subroutines
14866
14867 =over 4
14868
14869 =item SYNOPSIS
14870
14871 =item DESCRIPTION
14872
14873 blessed EXPR, dualvar NUM, STRING, isweak EXPR, openhandle FH, reftype
14874 EXPR, tainted EXPR, weaken REF
14875
14876 =item KNOWN BUGS
14877
14878 =item COPYRIGHT
14879
14880 =item BLATANT PLUG
14881
14882 =back
14883
14884 =head2 Locale::Constants - constants for Locale codes
14885
14886 =over 4
14887
14888 =item SYNOPSIS
14889
14890 =item DESCRIPTION
14891
14892 =item KNOWN BUGS AND LIMITATIONS
14893
14894 =item SEE ALSO
14895
14896 Locale::Language, Locale::Country, Locale::Script, Locale::Currency
14897
14898 =item AUTHOR
14899
14900 =item COPYRIGHT
14901
14902 =back
14903
14904 =head2 Locale::Country - ISO codes for country identification (ISO 3166)
14905
14906 =over 4
14907
14908 =item SYNOPSIS
14909
14910 =item DESCRIPTION
14911
14912 B<alpha-2>, B<alpha-3>, B<numeric>
14913
14914 =item CONVERSION ROUTINES
14915
14916 code2country( CODE, [ CODESET ] ), country2code( STRING, [ CODESET ] ),
14917 country_code2code( CODE, CODESET, CODESET )
14918
14919 =item QUERY ROUTINES
14920
14921 C<all_country_codes( [ CODESET ] )>, C<all_country_names( [ CODESET ] )>
14922
14923 =item SEMI-PRIVATE ROUTINES
14924
14925 =over 4
14926
14927 =item alias_code
14928
14929 =item rename_country
14930
14931 =back
14932
14933 =item EXAMPLES
14934
14935 =item DOMAIN NAMES
14936
14937 =item KNOWN BUGS AND LIMITATIONS
14938
14939 =item SEE ALSO
14940
14941 Locale::Language, Locale::Script, Locale::Currency, Locale::SubCountry, ISO
14942 3166-1, http://www.iso.org/iso/en/prods-services/iso3166ma/index.html,
14943 http://www.egt.ie/standards/iso3166/iso3166-1-en.html,
14944 http://www.cia.gov/cia/publications/factbook/docs/app-f.html
14945
14946 =item AUTHOR
14947
14948 =item COPYRIGHT
14949
14950 =back
14951
14952 =head2 Locale::Currency - ISO three letter codes for currency
14953 identification (ISO 4217)
14954
14955 =over 4
14956
14957 =item SYNOPSIS
14958
14959 =item DESCRIPTION
14960
14961 XTS, XXX
14962
14963 =item CONVERSION ROUTINES
14964
14965 code2currency(), currency2code()
14966
14967 =item QUERY ROUTINES
14968
14969 C<all_currency_codes()>, C<all_currency_names()>
14970
14971 =item EXAMPLES
14972
14973 =item KNOWN BUGS AND LIMITATIONS
14974
14975 =item SEE ALSO
14976
14977 Locale::Country, Locale::Script, ISO 4217:1995,
14978 http://www.bsi-global.com/iso4217currency
14979
14980 =item AUTHOR
14981
14982 =item COPYRIGHT
14983
14984 =back
14985
14986 =head2 Locale::Language - ISO two letter codes for language identification
14987 (ISO 639)
14988
14989 =over 4
14990
14991 =item SYNOPSIS
14992
14993 =item DESCRIPTION
14994
14995 =item CONVERSION ROUTINES
14996
14997 code2language(), language2code()
14998
14999 =item QUERY ROUTINES
15000
15001 C<all_language_codes()>, C<all_language_names()>
15002
15003 =item EXAMPLES
15004
15005 =item KNOWN BUGS AND LIMITATIONS
15006
15007 =item SEE ALSO
15008
15009 Locale::Country, Locale::Script, Locale::Currency, ISO 639:1988 (E/F),
15010 http://lcweb.loc.gov/standards/iso639-2/langhome.html
15011
15012 =item AUTHOR
15013
15014 =item COPYRIGHT
15015
15016 =back
15017
15018 =head2 Locale::Maketext -- framework for localization
15019
15020 =over 4
15021
15022 =item SYNOPSIS
15023
15024 =item DESCRIPTION
15025
15026 =item QUICK OVERVIEW
15027
15028 =item METHODS
15029
15030 =over 4
15031
15032 =item Construction Methods
15033
15034 =item The "maketext" Method
15035
15036 $lh->fail_with I<or> $lh->fail_with(I<PARAM>), $lh->failure_handler_auto
15037
15038 =item Utility Methods
15039
15040 $language->quant($number, $singular), $language->quant($number, $singular,
15041 $plural), $language->quant($number, $singular, $plural, $negative),
15042 $language->numf($number), $language->sprintf($format, @items),
15043 $language->language_tag(), $language->encoding()
15044
15045 =item Language Handle Attributes and Internals
15046
15047 =back
15048
15049 =item LANGUAGE CLASS HIERARCHIES
15050
15051 =item ENTRIES IN EACH LEXICON
15052
15053 =item BRACKET NOTATION
15054
15055 =item AUTO LEXICONS
15056
15057 =item CONTROLLING LOOKUP FAILURE
15058
15059 =item HOW TO USE MAKETEXT
15060
15061 =item SEE ALSO
15062
15063 =item COPYRIGHT AND DISCLAIMER
15064
15065 =item AUTHOR
15066
15067 =back
15068
15069 =head2 Locale::Maketext::TPJ13 -- article about software localization
15070
15071 =over 4
15072
15073 =item SYNOPSIS
15074
15075 =item DESCRIPTION
15076
15077 =item Localization and Perl: gettext breaks, Maketext fixes
15078
15079 =over 4
15080
15081 =item A Localization Horror Story: It Could Happen To You
15082
15083 =item The Linguistic View
15084
15085 =item Breaking gettext
15086
15087 =item Replacing gettext
15088
15089 =item Buzzwords: Abstraction and Encapsulation
15090
15091 =item Buzzword: Isomorphism
15092
15093 =item Buzzword: Inheritance
15094
15095 =item Buzzword: Concision
15096
15097 =item The Devil in the Details
15098
15099 =item The Proof in the Pudding: Localizing Web Sites
15100
15101 =item References
15102
15103 =back
15104
15105 =back
15106
15107 =head2 Locale::Script - ISO codes for script identification (ISO 15924)
15108
15109 =over 4
15110
15111 =item SYNOPSIS
15112
15113 =item DESCRIPTION
15114
15115 B<alpha-2>, B<alpha-3>, B<numeric>
15116
15117 =over 4
15118
15119 =item SPECIAL CODES
15120
15121 =back
15122
15123 =item CONVERSION ROUTINES
15124
15125 code2script( CODE, [ CODESET ] ), script2code( STRING, [ CODESET ] ),
15126 script_code2code( CODE, CODESET, CODESET )
15127
15128 =item QUERY ROUTINES
15129
15130 C<all_script_codes ( [ CODESET ] )>, C<all_script_names ( [ CODESET ] )>
15131
15132 =item EXAMPLES
15133
15134 =item KNOWN BUGS AND LIMITATIONS
15135
15136 =item SEE ALSO
15137
15138 Locale::Language, Locale::Currency, Locale::Country, ISO 15924,
15139 http://www.evertype.com/standards/iso15924/
15140
15141 =item AUTHOR
15142
15143 =item COPYRIGHT
15144
15145 =back
15146
15147 =head2 MIME::Base64 - Encoding and decoding of base64 strings
15148
15149 =over 4
15150
15151 =item SYNOPSIS
15152
15153 =item DESCRIPTION
15154
15155 encode_base64($str, [$eol]), decode_base64($str)
15156
15157 =item DIAGNOSTICS
15158
15159 Premature end of base64 data, Premature padding of base64 data
15160
15161 =item EXAMPLES
15162
15163 =item COPYRIGHT
15164
15165 =back
15166
15167 =head2 MIME::Base64::QuotedPrint, MIME::QuotedPrint - Encoding and decoding
15168 of quoted-printable strings
15169
15170 =over 4
15171
15172 =item SYNOPSIS
15173
15174 =item DESCRIPTION
15175
15176 encode_qp($str), decode_qp($str);
15177
15178 =item COPYRIGHT
15179
15180 =back
15181
15182 =head2 MIME::QuotedPrint - Encoding and decoding of quoted-printable
15183 strings
15184
15185 =over 4
15186
15187 =item SYNOPSIS
15188
15189 =item DESCRIPTION
15190
15191 encode_qp($str), decode_qp($str);
15192
15193 =item COPYRIGHT
15194
15195 =back
15196
15197 =head2 Math::BigFloat - Arbitrary size floating point math package
15198
15199 =over 4
15200
15201 =item SYNOPSIS
15202
15203 =item DESCRIPTION
15204
15205 =over 4
15206
15207 =item Canonical notation
15208
15209 =item Output
15210
15211 =item C<mantissa()>, C<exponent()> and C<parts()>
15212
15213 =item Accuracy vs. Precision
15214
15215 =item Rounding
15216
15217 ffround ( +$scale ), ffround ( -$scale ), ffround ( 0 ), fround  ( +$scale
15218 ), fround  ( -$scale ) and fround ( 0 )
15219
15220 =back
15221
15222 =item EXAMPLES
15223
15224   # not ready yet
15225
15226 =item Autocreating constants
15227
15228 =over 4
15229
15230 =item Math library
15231
15232 =item Using Math::BigInt::Lite
15233
15234 =back
15235
15236 =item BUGS
15237
15238 =item CAVEAT
15239
15240 stringify, bstr(), bdiv, Modifying and =, bpow
15241
15242 =item LICENSE
15243
15244 =item AUTHORS
15245
15246 =back
15247
15248 =head2 Math::BigInt - Arbitrary size integer math package
15249
15250 =over 4
15251
15252 =item SYNOPSIS
15253
15254 =item DESCRIPTION
15255
15256 Canonical notation, Input, Output
15257
15258 =item METHODS
15259
15260 =over 4
15261
15262 =item config
15263
15264 =item accuracy
15265
15266 =item brsft
15267
15268 =item new
15269
15270 =item bnan
15271
15272 =item bzero
15273
15274 =item binf
15275
15276 =item bone
15277
15278 =item is_one()/is_zero()/is_nan()/is_inf()
15279
15280 =item is_positive()/is_negative()
15281
15282         $x->is_positive();              # true if >= 0
15283         $x->is_negative();              # true if <  0
15284
15285 =item is_odd()/is_even()/is_int()
15286
15287 =item bcmp
15288
15289 =item bacmp
15290
15291 =item sign
15292
15293 =item bcmp
15294
15295 =item bneg
15296
15297 =item babs
15298
15299 =item bnorm
15300
15301 =item bnot
15302
15303 =item binc
15304
15305 =item bdec
15306
15307 =item badd
15308
15309 =item bsub
15310
15311 =item bmul
15312
15313 =item bdiv
15314
15315 =item bmod
15316
15317 =item bmodinv
15318
15319 =item bmodpow
15320
15321 =item bpow
15322
15323 =item blsft
15324
15325 =item brsft
15326
15327 =item band
15328
15329 =item bior
15330
15331 =item bxor
15332
15333 =item bnot
15334
15335 =item bsqrt
15336
15337 =item bfac
15338
15339 =item round
15340
15341 =item bround
15342
15343 =item bfround
15344
15345 =item bfloor
15346
15347 =item bceil
15348
15349 =item bgcd
15350
15351 =item blcm
15352
15353 =item exponent
15354
15355 =item mantissa
15356
15357 =item parts
15358
15359 =item copy
15360
15361 =item as_number
15362
15363 =item bsstr
15364
15365 =item as_hex
15366
15367 =item as_bin
15368
15369 =back
15370
15371 =item ACCURACY and PRECISION
15372
15373 =over 4
15374
15375 =item Precision P
15376
15377 =item Accuracy A
15378
15379 =item Fallback F
15380
15381 =item Rounding mode R
15382
15383 'trunc', 'even', 'odd', '+inf', '-inf', 'zero', Precision, Accuracy
15384 (significant digits), Setting/Accessing, Creating numbers, Usage,
15385 Precedence, Overriding globals, Local settings, Rounding, Default values,
15386 Remarks
15387
15388 =back
15389
15390 =item INTERNALS
15391
15392 =over 4
15393
15394 =item MATH LIBRARY
15395
15396 =item SIGN
15397
15398 =item mantissa(), exponent() and parts()
15399
15400 =back
15401
15402 =item EXAMPLES
15403
15404   use Math::BigInt;
15405
15406 =item Autocreating constants
15407
15408 =item PERFORMANCE
15409
15410 =over 4
15411
15412 =item Alternative math libraries
15413
15414 =item SUBCLASSING
15415
15416 =back
15417
15418 =item Subclassing Math::BigInt
15419
15420 =item UPGRADING
15421
15422 =over 4
15423
15424 =item Auto-upgrade
15425
15426 bsqrt(), div(), blog()
15427
15428 =back
15429
15430 =item BUGS
15431
15432 Out of Memory!, Fails to load Calc on Perl prior 5.6.0
15433
15434 =item CAVEATS
15435
15436 stringify, bstr(), bsstr() and 'cmp', int(), length, bdiv, infinity
15437 handling, Modifying and =, bpow, Overloading -$x, Mixing different object
15438 types, bsqrt(), brsft()
15439
15440 =item LICENSE
15441
15442 =item SEE ALSO
15443
15444 =item AUTHORS
15445
15446 =back
15447
15448 =head2 Math::BigInt::Calc - Pure Perl module to support Math::BigInt
15449
15450 =over 4
15451
15452 =item SYNOPSIS
15453
15454 =item DESCRIPTION
15455
15456 =item EXPORT
15457
15458 =item WRAP YOUR OWN
15459
15460 =item LICENSE
15461
15462 This program is free software; you may redistribute it and/or modify it
15463 under
15464 the same terms as Perl itself.
15465
15466 =item AUTHORS
15467
15468 =item SEE ALSO
15469
15470 =back
15471
15472 =head2 Math::BigRat - arbitrarily big rationals
15473
15474 =over 4
15475
15476 =item SYNOPSIS
15477
15478 =item DESCRIPTION
15479
15480 =over 4
15481
15482 =item MATH LIBRARY
15483
15484 =back
15485
15486 =item METHODS
15487
15488 =over 4
15489
15490 =item new()
15491
15492 =item numerator()
15493
15494 =item denominator()
15495
15496         $d = $x->denominator();
15497
15498 =item parts()
15499
15500 =item as_number()
15501
15502 =item bfac()
15503
15504 =item blog()
15505
15506 =item bround()/round()/bfround()
15507
15508 =back
15509
15510 =item BUGS
15511
15512 =item LICENSE
15513
15514 =item SEE ALSO
15515
15516 =item AUTHORS
15517
15518 =back
15519
15520 =head2 Math::Complex - complex numbers and associated mathematical
15521 functions
15522
15523 =over 4
15524
15525 =item SYNOPSIS
15526
15527 =item DESCRIPTION
15528
15529 =item OPERATIONS
15530
15531 =item CREATION
15532
15533 =item STRINGIFICATION
15534
15535 =over 4
15536
15537 =item CHANGED IN PERL 5.6
15538
15539 =back
15540
15541 =item USAGE
15542
15543 =item ERRORS DUE TO DIVISION BY ZERO OR LOGARITHM OF ZERO
15544
15545 =item ERRORS DUE TO INDIGESTIBLE ARGUMENTS
15546
15547 =item BUGS
15548
15549 =item AUTHORS
15550
15551 =back
15552
15553 =head2 Math::Trig - trigonometric functions
15554
15555 =over 4
15556
15557 =item SYNOPSIS
15558
15559 =item DESCRIPTION
15560
15561 =item TRIGONOMETRIC FUNCTIONS
15562
15563 B<tan>
15564
15565 =over 4
15566
15567 =item ERRORS DUE TO DIVISION BY ZERO
15568
15569 =item SIMPLE (REAL) ARGUMENTS, COMPLEX RESULTS
15570
15571 =back
15572
15573 =item PLANE ANGLE CONVERSIONS
15574
15575 =item RADIAL COORDINATE CONVERSIONS
15576
15577 =over 4
15578
15579 =item COORDINATE SYSTEMS
15580
15581 =item 3-D ANGLE CONVERSIONS
15582
15583 cartesian_to_cylindrical, cartesian_to_spherical, cylindrical_to_cartesian,
15584 cylindrical_to_spherical, spherical_to_cartesian, spherical_to_cylindrical
15585
15586 =back
15587
15588 =item GREAT CIRCLE DISTANCES AND DIRECTIONS
15589
15590 =item EXAMPLES
15591
15592 =over 4
15593
15594 =item CAVEAT FOR GREAT CIRCLE FORMULAS
15595
15596 =back
15597
15598 =item BUGS
15599
15600 =item AUTHORS
15601
15602 =back
15603
15604 =head2 Memoize - Make functions faster by trading space for time
15605
15606 =over 4
15607
15608 =item SYNOPSIS
15609
15610 =item DESCRIPTION
15611
15612 =item DETAILS
15613
15614 =item OPTIONS
15615
15616 =over 4
15617
15618 =item INSTALL
15619
15620 =item NORMALIZER
15621
15622 =item C<SCALAR_CACHE>, C<LIST_CACHE>
15623
15624 C<MEMORY>, C<HASH>, C<TIE>, C<FAULT>, C<MERGE>
15625
15626 =back
15627
15628 =item OTHER FACILITIES
15629
15630 =over 4
15631
15632 =item C<unmemoize>
15633
15634 =item C<flush_cache>
15635
15636 =back
15637
15638 =item CAVEATS
15639
15640 =item PERSISTENT CACHE SUPPORT
15641
15642 =item EXPIRATION SUPPORT
15643
15644 =item BUGS
15645
15646 =item MAILING LIST
15647
15648 =item AUTHOR
15649
15650 =item COPYRIGHT AND LICENSE
15651
15652 =item THANK YOU
15653
15654 =back
15655
15656 =head2 Memoize::AnyDBM_File - glue to provide EXISTS for AnyDBM_File for
15657 Storable use
15658
15659 =over 4
15660
15661 =item DESCRIPTION
15662
15663 =back
15664
15665 =head2 Memoize::Expire - Plug-in module for automatic expiration of
15666 memoized values
15667
15668 =over 4
15669
15670 =item SYNOPSIS
15671
15672 =item DESCRIPTION
15673
15674 =item INTERFACE
15675
15676  TIEHASH,  EXISTS,  STORE
15677
15678 =item ALTERNATIVES
15679
15680 =item CAVEATS
15681
15682 =item AUTHOR
15683
15684 =item SEE ALSO
15685
15686 =back
15687
15688 =head2 Memoize::ExpireFile - test for Memoize expiration semantics
15689
15690 =over 4
15691
15692 =item DESCRIPTION
15693
15694 =back
15695
15696 =head2 Memoize::ExpireTest - test for Memoize expiration semantics
15697
15698 =over 4
15699
15700 =item DESCRIPTION
15701
15702 =back
15703
15704 =head2 Memoize::NDBM_File - glue to provide EXISTS for NDBM_File for
15705 Storable use
15706
15707 =over 4
15708
15709 =item DESCRIPTION
15710
15711 =back
15712
15713 =head2 Memoize::SDBM_File - glue to provide EXISTS for SDBM_File for
15714 Storable use
15715
15716 =over 4
15717
15718 =item DESCRIPTION
15719
15720 =back
15721
15722 =head2 Memoize::Storable - store Memoized data in Storable database
15723
15724 =over 4
15725
15726 =item DESCRIPTION
15727
15728 =back
15729
15730 =head2 NDBM_File - Tied access to ndbm files
15731
15732 =over 4
15733
15734 =item SYNOPSIS
15735
15736 =item DESCRIPTION
15737
15738 C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR>
15739
15740 =item DIAGNOSTICS
15741
15742 =over 4
15743
15744 =item C<ndbm store returned -1, errno 22, key "..." at ...>
15745
15746 =back
15747
15748 =item BUGS AND WARNINGS
15749
15750 =back
15751
15752 =head2 NEXT - Provide a pseudo-class NEXT that allows method redispatch
15753
15754 =over 4
15755
15756 =item SYNOPSIS
15757
15758 =item DESCRIPTION
15759
15760 =over 4
15761
15762 =item Enforcing redispatch
15763
15764 =item Avoiding repetitions
15765
15766 =back
15767
15768 =item AUTHOR
15769
15770 =item BUGS AND IRRITATIONS
15771
15772 =item COPYRIGHT
15773
15774 =back
15775
15776 =head2 Net::Cmd - Network Command class (as used by FTP, SMTP etc)
15777
15778 =over 4
15779
15780 =item SYNOPSIS
15781
15782 =item DESCRIPTION
15783
15784 =item USER METHODS
15785
15786 debug ( VALUE ), message (), code (), ok (), status (), datasend ( DATA ),
15787 dataend ()
15788
15789 =item CLASS METHODS
15790
15791 debug_print ( DIR, TEXT ), debug_text ( TEXT ), command ( CMD [, ARGS, ...
15792 ]), unsupported (), response (), parse_response ( TEXT ), getline (),
15793 ungetline ( TEXT ), read_until_dot (), tied_fh ()
15794
15795 =item EXPORTS
15796
15797 =item AUTHOR
15798
15799 =item COPYRIGHT
15800
15801 =back
15802
15803 =head2 Net::Config - Local configuration data for libnet
15804
15805 =over 4
15806
15807 =item SYNOPSYS
15808
15809 =item DESCRIPTION
15810
15811 =item METHODS
15812
15813 requires_firewall HOST
15814
15815 =item NetConfig VALUES
15816
15817 nntp_hosts, snpp_hosts, pop3_hosts, smtp_hosts, ph_hosts, daytime_hosts,
15818 time_hosts, inet_domain, ftp_firewall, ftp_firewall_type, ftp_ext_passive,
15819 ftp_int_pasive, local_netmask, test_hosts, test_exists
15820
15821 =back
15822
15823 =head2 Net::Domain - Attempt to evaluate the current host's internet name
15824 and domain
15825
15826 =over 4
15827
15828 =item SYNOPSIS
15829
15830 =item DESCRIPTION
15831
15832 hostfqdn (), hostname (), hostdomain ()
15833
15834 =item AUTHOR
15835
15836 =item COPYRIGHT
15837
15838 =back
15839
15840 =head2 Net::FTP - FTP Client class
15841
15842 =over 4
15843
15844 =item SYNOPSIS
15845
15846 =item DESCRIPTION
15847
15848 =item OVERVIEW
15849
15850 =item CONSTRUCTOR
15851
15852 new (HOST [,OPTIONS])
15853
15854 =item METHODS
15855
15856 login ([LOGIN [,PASSWORD [, ACCOUNT] ] ]), authorize ( [AUTH [, RESP]]),
15857 site (ARGS), type (TYPE [, ARGS]), ascii ([ARGS]) binary([ARGS])
15858 ebcdic([ARGS]) byte([ARGS]), rename ( OLDNAME, NEWNAME ), delete ( FILENAME
15859 ), cwd ( [ DIR ] ), cdup (), pwd (), restart ( WHERE ), rmdir ( DIR ),
15860 mkdir ( DIR [, RECURSE ]), ls ( [ DIR ] ), dir ( [ DIR ] ), get (
15861 REMOTE_FILE [, LOCAL_FILE [, WHERE]] ), put ( LOCAL_FILE [, REMOTE_FILE ]
15862 ), put_unique ( LOCAL_FILE [, REMOTE_FILE ] ), append ( LOCAL_FILE [,
15863 REMOTE_FILE ] ), unique_name (), mdtm ( FILE ), size ( FILE ), supported (
15864 CMD ), hash ( [FILEHANDLE_GLOB_REF],[ BYTES_PER_HASH_MARK] ), nlst ( [ DIR
15865 ] ), list ( [ DIR ] ), retr ( FILE ), stor ( FILE ), stou ( FILE ), appe (
15866 FILE ), port ( [ PORT ] ), pasv (), pasv_xfer ( SRC_FILE, DEST_SERVER [,
15867 DEST_FILE ] ), pasv_xfer_unique ( SRC_FILE, DEST_SERVER [, DEST_FILE ] ),
15868 pasv_wait ( NON_PASV_SERVER ), abort (), quit ()
15869
15870 =over 4
15871
15872 =item Methods for the adventurous
15873
15874 quot (CMD [,ARGS])
15875
15876 =back
15877
15878 =item THE dataconn CLASS
15879
15880 read ( BUFFER, SIZE [, TIMEOUT ] ), write ( BUFFER, SIZE [, TIMEOUT ] ),
15881 bytes_read (), abort (), close ()
15882
15883 =item UNIMPLEMENTED
15884
15885 B<ALLO>, B<SMNT>, B<HELP>, B<MODE>, B<SYST>, B<STAT>, B<STRU>, B<REIN>
15886
15887 =item REPORTING BUGS
15888
15889 =item AUTHOR
15890
15891 =item SEE ALSO
15892
15893 =item USE EXAMPLES
15894
15895 http://www.csh.rit.edu/~adam/Progs/autoftp-2.0.tar.gz
15896
15897 =item CREDITS
15898
15899 =item COPYRIGHT
15900
15901 =back
15902
15903 =head2 Net::NNTP - NNTP Client class
15904
15905 =over 4
15906
15907 =item SYNOPSIS
15908
15909 =item DESCRIPTION
15910
15911 =item CONSTRUCTOR
15912
15913 new ( [ HOST ] [, OPTIONS ])
15914
15915 =item METHODS
15916
15917 article ( [ MSGID|MSGNUM ], [FH] ), body ( [ MSGID|MSGNUM ], [FH] ), head (
15918 [ MSGID|MSGNUM ], [FH] ), articlefh ( [ MSGID|MSGNUM ] ), bodyfh ( [
15919 MSGID|MSGNUM ] ), headfh ( [ MSGID|MSGNUM ] ), nntpstat ( [ MSGID|MSGNUM ]
15920 ), group ( [ GROUP ] ), ihave ( MSGID [, MESSAGE ]), last (), date (),
15921 postok (), authinfo ( USER, PASS ), list (), newgroups ( SINCE [,
15922 DISTRIBUTIONS ]), newnews ( SINCE [, GROUPS [, DISTRIBUTIONS ]]), next (),
15923 post ( [ MESSAGE ] ), postfh (), slave (), quit ()
15924
15925 =over 4
15926
15927 =item Extension methods
15928
15929 newsgroups ( [ PATTERN ] ), distributions (), subscriptions (),
15930 overview_fmt (), active_times (), active ( [ PATTERN ] ), xgtitle ( PATTERN
15931 ), xhdr ( HEADER, MESSAGE-SPEC ), xover ( MESSAGE-SPEC ), xpath (
15932 MESSAGE-ID ), xpat ( HEADER, PATTERN, MESSAGE-SPEC), xrover, listgroup ( [
15933 GROUP ] ), reader
15934
15935 =back
15936
15937 =item UNSUPPORTED
15938
15939 =item DEFINITIONS
15940
15941 MESSAGE-SPEC, PATTERN, Examples, C<[^]-]>, C<*bdc>, C<[0-9a-zA-Z]>, C<a??d>
15942
15943 =item SEE ALSO
15944
15945 =item AUTHOR
15946
15947 =item COPYRIGHT
15948
15949 =back
15950
15951 =head2 Net::POP3 - Post Office Protocol 3 Client class (RFC1939)
15952
15953 =over 4
15954
15955 =item SYNOPSIS
15956
15957 =item DESCRIPTION
15958
15959 =item EXAMPLES
15960
15961 =item CONSTRUCTOR
15962
15963 new ( [ HOST, ] [ OPTIONS ] )
15964
15965 =item METHODS
15966
15967 user ( USER ), pass ( PASS ), login ( [ USER [, PASS ]] ), apop ( [ USER [,
15968 PASS ]] ), top ( MSGNUM [, NUMLINES ] ), list ( [ MSGNUM ] ), get ( MSGNUM
15969 [, FH ] ), getfh ( MSGNUM ), last (), popstat (), ping ( USER ), uidl ( [
15970 MSGNUM ] ), delete ( MSGNUM ), reset (), quit ()
15971
15972 =item NOTES
15973
15974 =item SEE ALSO
15975
15976 =item AUTHOR
15977
15978 =item COPYRIGHT
15979
15980 =back
15981
15982 =head2 Net::Ping - check a remote host for reachability
15983
15984 =over 4
15985
15986 =item SYNOPSIS
15987
15988 =item DESCRIPTION
15989
15990 =over 4
15991
15992 =item Functions
15993
15994 Net::Ping->new([$proto [, $def_timeout [, $bytes]]]);, $p->source_verify( {
15995 0 | 1 } );, $p->hires( { 0 | 1 } );, $p->bind($local_addr);, $p->ping($host
15996 [, $timeout]);, $p->open($host);, $p->close();, pingecho($host [,
15997 $timeout]);
15998
15999 =back
16000
16001 =item WARNING
16002
16003 =item NOTES
16004
16005 =item AUTHORS
16006
16007 =item COPYRIGHT
16008
16009 =back
16010
16011 =head2 Net::SMTP - Simple Mail Transfer Protocol Client
16012
16013 =over 4
16014
16015 =item SYNOPSIS
16016
16017 =item DESCRIPTION
16018
16019 =item EXAMPLES
16020
16021 =item CONSTRUCTOR
16022
16023 new Net::SMTP [ HOST, ] [ OPTIONS ]
16024
16025 =item METHODS
16026
16027 banner (), domain (), hello ( DOMAIN ), etrn ( DOMAIN ), auth ( USERNAME,
16028 PASSWORD ), mail ( ADDRESS [, OPTIONS] ), send ( ADDRESS ), send_or_mail (
16029 ADDRESS ), send_and_mail ( ADDRESS ), reset (), recipient ( ADDRESS [,
16030 ADDRESS [ ...]] [, OPTIONS ] ), to ( ADDRESS [, ADDRESS [...]] ), cc (
16031 ADDRESS [, ADDRESS [...]] ), bcc ( ADDRESS [, ADDRESS [...]] ), data ( [
16032 DATA ] ), expand ( ADDRESS ), verify ( ADDRESS ), help ( [ $subject ] ),
16033 quit ()
16034
16035 =item ADDRESSES
16036
16037 =item SEE ALSO
16038
16039 =item AUTHOR
16040
16041 =item COPYRIGHT
16042
16043 =back
16044
16045 =head2 Net::Time - time and daytime network client interface
16046
16047 =over 4
16048
16049 =item SYNOPSIS
16050
16051 =item DESCRIPTION
16052
16053 inet_time ( [HOST [, PROTOCOL [, TIMEOUT]]]), inet_daytime ( [HOST [,
16054 PROTOCOL [, TIMEOUT]]])
16055
16056 =item AUTHOR
16057
16058 =item COPYRIGHT
16059
16060 =back
16061
16062 =head2 Net::hostent - by-name interface to Perl's built-in gethost*()
16063 functions
16064
16065 =over 4
16066
16067 =item SYNOPSIS
16068
16069 =item DESCRIPTION
16070
16071 =item EXAMPLES
16072
16073 =item NOTE
16074
16075 =item AUTHOR
16076
16077 =back
16078
16079 =head2 Net::libnetFAQ, libnetFAQ - libnet Frequently Asked Questions
16080
16081 =over 4
16082
16083 =item DESCRIPTION
16084
16085 =over 4
16086
16087 =item Where to get this document
16088
16089 =item How to contribute to this document
16090
16091 =back
16092
16093 =item Author and Copyright Information
16094
16095 =over 4
16096
16097 =item Disclaimer
16098
16099 =back
16100
16101 =item Obtaining and installing libnet
16102
16103 =over 4
16104
16105 =item What is libnet ?
16106
16107 =item Which version of perl do I need ?
16108
16109 =item What other modules do I need ?
16110
16111 =item What machines support libnet ?
16112
16113 =item Where can I get the latest libnet release
16114
16115 =back
16116
16117 =item Using Net::FTP
16118
16119 =over 4
16120
16121 =item How do I download files from an FTP server ?
16122
16123 =item How do I transfer files in binary mode ?
16124
16125 =item How can I get the size of a file on a remote FTP server ?
16126
16127 =item How can I get the modification time of a file on a remote FTP server
16128 ?
16129
16130 =item How can I change the permissions of a file on a remote server ?
16131
16132 =item Can I do a reget operation like the ftp command ?
16133
16134 =item How do I get a directory listing from an FTP server ?
16135
16136 =item Changing directory to "" does not fail ?
16137
16138 =item I am behind a SOCKS firewall, but the Firewall option does not work ?
16139
16140 =item I am behind an FTP proxy firewall, but cannot access machines outside
16141 ?
16142
16143 =item My ftp proxy firewall does not listen on port 21
16144
16145 =item Is it possible to change the file permissions of a file on an FTP
16146 server ?
16147
16148 =item I have seen scripts call a method message, but cannot find it
16149 documented ?
16150
16151 =item Why does Net::FTP not implement mput and mget methods
16152
16153 =back
16154
16155 =item Using Net::SMTP
16156
16157 =over 4
16158
16159 =item Why can't the part of an Email address after the @ be used as the
16160 hostname ?
16161
16162 =item Why does Net::SMTP not do DNS MX lookups ?
16163
16164 =item The verify method always returns true ?
16165
16166 =back
16167
16168 =item Debugging scripts
16169
16170 =over 4
16171
16172 =item How can I debug my scripts that use Net::* modules ?
16173
16174 =back
16175
16176 =item AUTHOR AND COPYRIGHT
16177
16178 =back
16179
16180 =head2 Net::netent - by-name interface to Perl's built-in getnet*()
16181 functions
16182
16183 =over 4
16184
16185 =item SYNOPSIS
16186
16187 =item DESCRIPTION
16188
16189 =item EXAMPLES
16190
16191 =item NOTE
16192
16193 =item AUTHOR
16194
16195 =back
16196
16197 =head2 Net::protoent - by-name interface to Perl's built-in getproto*()
16198 functions
16199
16200 =over 4
16201
16202 =item SYNOPSIS
16203
16204 =item DESCRIPTION
16205
16206 =item NOTE
16207
16208 =item AUTHOR
16209
16210 =back
16211
16212 =head2 Net::servent - by-name interface to Perl's built-in getserv*()
16213 functions
16214
16215 =over 4
16216
16217 =item SYNOPSIS
16218
16219 =item DESCRIPTION
16220
16221 =item EXAMPLES
16222
16223 =item NOTE
16224
16225 =item AUTHOR
16226
16227 =back
16228
16229 =head2 Netrc, Net::Netrc - OO interface to users netrc file
16230
16231 =over 4
16232
16233 =item SYNOPSIS
16234
16235 =item DESCRIPTION
16236
16237 =item THE .netrc FILE
16238
16239 machine name, default, login name, password string, account string, macdef
16240 name
16241
16242 =item CONSTRUCTOR
16243
16244 lookup ( MACHINE [, LOGIN ])
16245
16246 =item METHODS
16247
16248 login (), password (), account (), lpa ()
16249
16250 =item AUTHOR
16251
16252 =item SEE ALSO
16253
16254 =item COPYRIGHT
16255
16256 =back
16257
16258 =head2 O - Generic interface to Perl Compiler backends
16259
16260 =over 4
16261
16262 =item SYNOPSIS
16263
16264 =item DESCRIPTION
16265
16266 =item CONVENTIONS
16267
16268 =item IMPLEMENTATION
16269
16270 =item BUGS
16271
16272 =item AUTHOR
16273
16274 =back
16275
16276 =head2 ODBM_File - Tied access to odbm files
16277
16278 =over 4
16279
16280 =item SYNOPSIS
16281
16282 =item DESCRIPTION
16283
16284 C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR>
16285
16286 =item DIAGNOSTICS
16287
16288 =over 4
16289
16290 =item C<odbm store returned -1, errno 22, key "..." at ...>
16291
16292 =back
16293
16294 =item BUGS AND WARNINGS
16295
16296 =back
16297
16298 =head2 Opcode - Disable named opcodes when compiling perl code
16299
16300 =over 4
16301
16302 =item SYNOPSIS
16303
16304 =item DESCRIPTION
16305
16306 =item NOTE
16307
16308 =item WARNING
16309
16310 =item Operator Names and Operator Lists
16311
16312 an operator name (opname), an operator tag name (optag), a negated opname
16313 or optag, an operator set (opset)
16314
16315 =item Opcode Functions
16316
16317 opcodes, opset (OP, ...), opset_to_ops (OPSET), opset_to_hex (OPSET),
16318 full_opset, empty_opset, invert_opset (OPSET), verify_opset (OPSET, ...),
16319 define_optag (OPTAG, OPSET), opmask_add (OPSET), opmask, opdesc (OP, ...),
16320 opdump (PAT)
16321
16322 =item Manipulating Opsets
16323
16324 =item TO DO (maybe)
16325
16326 =back
16327
16328 =over 4
16329
16330 =item Predefined Opcode Tags
16331
16332 :base_core, :base_mem, :base_loop, :base_io, :base_orig, :base_math,
16333 :base_thread, :default, :filesys_read, :sys_db, :browse, :filesys_open,
16334 :filesys_write, :subprocess, :ownprocess, :others, :still_to_be_decided,
16335 :dangerous
16336
16337 =item SEE ALSO
16338
16339 =item AUTHORS
16340
16341 =back
16342
16343 =head2 Opcode::Safe, Safe - Compile and execute code in restricted
16344 compartments
16345
16346 =over 4
16347
16348 =item SYNOPSIS
16349
16350 =item DESCRIPTION
16351
16352 a new namespace, an operator mask
16353
16354 =item WARNING
16355
16356 =over 4
16357
16358 =item RECENT CHANGES
16359
16360 =item Methods in class Safe
16361
16362 permit (OP, ...), permit_only (OP, ...), deny (OP, ...), deny_only (OP,
16363 ...), trap (OP, ...), untrap (OP, ...), share (NAME, ...), share_from
16364 (PACKAGE, ARRAYREF), varglob (VARNAME), reval (STRING), rdo (FILENAME),
16365 root (NAMESPACE), mask (MASK)
16366
16367 =item Some Safety Issues
16368
16369 Memory, CPU, Snooping, Signals, State Changes
16370
16371 =item AUTHOR
16372
16373 =back
16374
16375 =back
16376
16377 =head2 Opcode::ops, ops - Perl pragma to restrict unsafe operations when
16378 compiling
16379
16380 =over 4
16381
16382 =item SYNOPSIS
16383
16384 =item DESCRIPTION
16385
16386 =item SEE ALSO
16387
16388 =back
16389
16390 =head2 POSIX - Perl interface to IEEE Std 1003.1
16391
16392 =over 4
16393
16394 =item SYNOPSIS
16395
16396 =item DESCRIPTION
16397
16398 =item NOTE
16399
16400 =item CAVEATS
16401
16402 =item FUNCTIONS
16403
16404 _exit, abort, abs, access, acos, alarm, asctime, asin, assert, atan, atan2,
16405 atexit, atof, atoi, atol, bsearch, calloc, ceil, chdir, chmod, chown,
16406 clearerr, clock, close, closedir, cos, cosh, creat, ctermid, ctime,
16407 cuserid, difftime, div, dup, dup2, errno, execl, execle, execlp, execv,
16408 execve, execvp, exit, exp, fabs, fclose, fcntl, fdopen, feof, ferror,
16409 fflush, fgetc, fgetpos, fgets, fileno, floor, fmod, fopen, fork, fpathconf,
16410 fprintf, fputc, fputs, fread, free, freopen, frexp, fscanf, fseek, fsetpos,
16411 fstat, ftell, fwrite, getc, getchar, getcwd, getegid, getenv, geteuid,
16412 getgid, getgrgid, getgrnam, getgroups, getlogin, getpgrp, getpid, getppid,
16413 getpwnam, getpwuid, gets, getuid, gmtime, isalnum, isalpha, isatty,
16414 iscntrl, isdigit, isgraph, islower, isprint, ispunct, isspace, isupper,
16415 isxdigit, kill, labs, ldexp, ldiv, link, localeconv, localtime, log, log10,
16416 longjmp, lseek, malloc, mblen, mbstowcs, mbtowc, memchr, memcmp, memcpy,
16417 memmove, memset, mkdir, mkfifo, mktime, modf, nice, offsetof, open,
16418 opendir, pathconf, pause, perror, pipe, pow, printf, putc, putchar, puts,
16419 qsort, raise, rand, read, readdir, realloc, remove, rename, rewind,
16420 rewinddir, rmdir, scanf, setgid, setjmp, setlocale, setpgid, setsid,
16421 setuid, sigaction, siglongjmp, sigpending, sigprocmask, sigsetjmp,
16422 sigsuspend, sin, sinh, sleep, sprintf, sqrt, srand, sscanf, stat, strcat,
16423 strchr, strcmp, strcoll, strcpy, strcspn, strerror, strftime, strlen,
16424 strncat, strncmp, strncpy, strpbrk, strrchr, strspn, strstr, strtod,
16425 strtok, strtol, strtoul, strxfrm, sysconf, system, tan, tanh, tcdrain,
16426 tcflow, tcflush, tcgetpgrp, tcsendbreak, tcsetpgrp, time, times, tmpfile,
16427 tmpnam, tolower, toupper, ttyname, tzname, tzset, umask, uname, ungetc,
16428 unlink, utime, vfprintf, vprintf, vsprintf, wait, waitpid, wcstombs,
16429 wctomb, write
16430
16431 =item CLASSES
16432
16433 =over 4
16434
16435 =item POSIX::SigAction
16436
16437 new
16438
16439 =item POSIX::SigSet
16440
16441 new, addset, delset, emptyset, fillset, ismember
16442
16443 =item POSIX::Termios
16444
16445 new, getattr, getcc, getcflag, getiflag, getispeed, getlflag, getoflag,
16446 getospeed, setattr, setcc, setcflag, setiflag, setispeed, setlflag,
16447 setoflag, setospeed, Baud rate values, Terminal interface values, c_cc
16448 field values, c_cflag field values, c_iflag field values, c_lflag field
16449 values, c_oflag field values
16450
16451 =back
16452
16453 =item PATHNAME CONSTANTS
16454
16455 Constants
16456
16457 =item POSIX CONSTANTS
16458
16459 Constants
16460
16461 =item SYSTEM CONFIGURATION
16462
16463 Constants
16464
16465 =item ERRNO
16466
16467 Constants
16468
16469 =item FCNTL
16470
16471 Constants
16472
16473 =item FLOAT
16474
16475 Constants
16476
16477 =item LIMITS
16478
16479 Constants
16480
16481 =item LOCALE
16482
16483 Constants
16484
16485 =item MATH
16486
16487 Constants
16488
16489 =item SIGNAL
16490
16491 Constants
16492
16493 =item STAT
16494
16495 Constants, Macros
16496
16497 =item STDLIB
16498
16499 Constants
16500
16501 =item STDIO
16502
16503 Constants
16504
16505 =item TIME
16506
16507 Constants
16508
16509 =item UNISTD
16510
16511 Constants
16512
16513 =item WAIT
16514
16515 Constants, WNOHANG, WUNTRACED, Macros, WIFEXITED, WEXITSTATUS, WIFSIGNALED,
16516 WTERMSIG, WIFSTOPPED, WSTOPSIG
16517
16518 =back
16519
16520 =head2 PerlIO - On demand loader for PerlIO layers and root of PerlIO::*
16521 name space
16522
16523 =over 4
16524
16525 =item SYNOPSIS
16526
16527 =item DESCRIPTION
16528
16529 unix, stdio, perlio, crlf, utf8, bytes, raw, pop
16530
16531 =over 4
16532
16533 =item Alternatives to raw
16534
16535 =item Defaults and how to override them
16536
16537 =back
16538
16539 =item AUTHOR
16540
16541 =item SEE ALSO
16542
16543 =back
16544
16545 =head2 PerlIO::encoding - encoding layer
16546
16547 =over 4
16548
16549 =item SYNOPSIS
16550
16551 =item DESCRIPTION
16552
16553 =item SEE ALSO
16554
16555 =back
16556
16557 =head2 PerlIO::scalar - support module for in-memory IO.
16558
16559 =over 4
16560
16561 =item SYNOPSIS
16562
16563 =item DESCRIPTION
16564
16565 =back
16566
16567 =head2 PerlIO::via - Helper class for PerlIO layers implemented in perl
16568
16569 =over 4
16570
16571 =item SYNOPSIS
16572
16573 =item DESCRIPTION
16574
16575 =item EXPECTED METHODS
16576
16577 $class->PUSHED([$mode[,$fh]]), $obj->POPPED([$fh]),
16578 $obj->OPEN($path,$mode[,$fh]), $obj->BINMODE([,$fh]),
16579 $obj->FDOPEN($fd[,$fh]), $obj->SYSOPEN($path,$imode,$perm,[,$fh]),
16580 $obj->FILENO($fh), $obj->READ($buffer,$len,$fh), $obj->WRITE($buffer,$fh),
16581 $obj->FILL($fh), $obj->CLOSE($fh), $obj->SEEK($posn,$whence,$fh),
16582 $obj->TELL($fh), $obj->UNREAD($buffer,$fh), $obj->FLUSH($fh),
16583 $obj->SETLINEBUF($fh), $obj->CLEARERR($fh), $obj->ERROR($fh),
16584 $obj->EOF($fh)
16585
16586 =item EXAMPLES
16587
16588 =over 4
16589
16590 =item Example - a Hexadecimal Handle
16591
16592 =back
16593
16594 =back
16595
16596 =head2 PerlIO::via::QuotedPrint - PerlIO layer for quoted-printable strings
16597
16598 =over 4
16599
16600 =item SYNOPSIS
16601
16602 =item DESCRIPTION
16603
16604 =item SEE ALSO
16605
16606 =item COPYRIGHT
16607
16608 =back
16609
16610 =head2 Pod::Checker, podchecker() - check pod documents for syntax errors
16611
16612 =over 4
16613
16614 =item SYNOPSIS
16615
16616 =item OPTIONS/ARGUMENTS
16617
16618 =over 4
16619
16620 =item podchecker()
16621
16622 B<-warnings> =E<gt> I<val>
16623
16624 =back
16625
16626 =item DESCRIPTION
16627
16628 =item DIAGNOSTICS
16629
16630 =over 4
16631
16632 =item Errors
16633
16634 empty =headn, =over on line I<N> without closing =back, =item without
16635 previous =over, =back without previous =over, No argument for =begin, =end
16636 without =begin, Nested =begin's, =for without formatter specification,
16637 unresolved internal link I<NAME>, Unknown command "I<CMD>", Unknown
16638 interior-sequence "I<SEQ>", nested commands
16639 I<CMD>E<lt>...I<CMD>E<lt>...E<gt>...E<gt>, garbled entity I<STRING>, Entity
16640 number out of range, malformed link LE<lt>E<gt>, nonempty ZE<lt>E<gt>,
16641 empty XE<lt>E<gt>, Spurious text after =pod / =cut, Spurious character(s)
16642 after =back
16643
16644 =item Warnings
16645
16646 multiple occurrence of link target I<name>, line containing nothing but
16647 whitespace in paragraph, file does not start with =head, previous =item has
16648 no contents, preceding non-item paragraph(s), =item type mismatch (I<one>
16649 vs. I<two>), I<N> unescaped C<E<lt>E<gt>> in paragraph, Unknown entity, No
16650 items in =over, No argument for =item, empty section in previous paragraph,
16651 Verbatim paragraph in NAME section
16652
16653 =item Hyperlinks
16654
16655 ignoring leading/trailing whitespace in link, (section) in '$page'
16656 deprecated, alternative text/node '%s' contains non-escaped | or /
16657
16658 =back
16659
16660 =item RETURN VALUE
16661
16662 =item EXAMPLES
16663
16664 =item INTERFACE
16665
16666 =back
16667
16668 C<Pod::Checker-E<gt>new( %options )>
16669
16670 C<$checker-E<gt>poderror( @args )>, C<$checker-E<gt>poderror( {%opts},
16671 @args )>
16672
16673 C<$checker-E<gt>num_errors()>
16674
16675 C<$checker-E<gt>name()>
16676
16677 C<$checker-E<gt>node()>
16678
16679 C<$checker-E<gt>idx()>
16680
16681 C<$checker-E<gt>hyperlink()>
16682
16683 =over 4
16684
16685 =item AUTHOR
16686
16687 =back
16688
16689 =head2 Pod::Find - find POD documents in directory trees
16690
16691 =over 4
16692
16693 =item SYNOPSIS
16694
16695 =item DESCRIPTION
16696
16697 =back
16698
16699 =over 4
16700
16701 =item C<pod_find( { %opts } , @directories )>
16702
16703 C<-verbose =E<gt> 1>, C<-perl =E<gt> 1>, C<-script =E<gt> 1>, C<-inc =E<gt>
16704 1>
16705
16706 =back
16707
16708 =over 4
16709
16710 =item C<simplify_name( $str )>
16711
16712 =back
16713
16714 =over 4
16715
16716 =item C<pod_where( { %opts }, $pod )>
16717
16718 C<-inc =E<gt> 1>, C<-dirs =E<gt> [ $dir1, $dir2, ... ]>, C<-verbose =E<gt>
16719 1>
16720
16721 =back
16722
16723 =over 4
16724
16725 =item C<contains_pod( $file , $verbose )>
16726
16727 =back
16728
16729 =over 4
16730
16731 =item AUTHOR
16732
16733 =item SEE ALSO
16734
16735 =back
16736
16737 =head2 Pod::Html - module to convert pod files to HTML
16738
16739 =over 4
16740
16741 =item SYNOPSIS
16742
16743 =item DESCRIPTION
16744
16745 =item ARGUMENTS
16746
16747 backlink, cachedir, css, flush, header, help, htmldir, htmlroot, index,
16748 infile, libpods, netscape, outfile, podpath, podroot, quiet, recurse,
16749 title, verbose
16750
16751 =item EXAMPLE
16752
16753 =item ENVIRONMENT
16754
16755 =item AUTHOR
16756
16757 =item SEE ALSO
16758
16759 =item COPYRIGHT
16760
16761 =back
16762
16763 =head2 Pod::InputObjects - objects representing POD input paragraphs,
16764 commands, etc.
16765
16766 =over 4
16767
16768 =item SYNOPSIS
16769
16770 =item REQUIRES
16771
16772 =item EXPORTS
16773
16774 =item DESCRIPTION
16775
16776 package B<Pod::InputSource>, package B<Pod::Paragraph>, package
16777 B<Pod::InteriorSequence>, package B<Pod::ParseTree>
16778
16779 =back
16780
16781 =over 4
16782
16783 =item B<Pod::InputSource>
16784
16785 =back
16786
16787 =over 4
16788
16789 =item B<new()>
16790
16791 =back
16792
16793 =over 4
16794
16795 =item B<name()>
16796
16797 =back
16798
16799 =over 4
16800
16801 =item B<handle()>
16802
16803 =back
16804
16805 =over 4
16806
16807 =item B<was_cutting()>
16808
16809 =back
16810
16811 =over 4
16812
16813 =item B<Pod::Paragraph>
16814
16815 =back
16816
16817 =over 4
16818
16819 =item Pod::Paragraph-E<gt>B<new()>
16820
16821 =back
16822
16823 =over 4
16824
16825 =item $pod_para-E<gt>B<cmd_name()>
16826
16827 =back
16828
16829 =over 4
16830
16831 =item $pod_para-E<gt>B<text()>
16832
16833 =back
16834
16835 =over 4
16836
16837 =item $pod_para-E<gt>B<raw_text()>
16838
16839 =back
16840
16841 =over 4
16842
16843 =item $pod_para-E<gt>B<cmd_prefix()>
16844
16845 =back
16846
16847 =over 4
16848
16849 =item $pod_para-E<gt>B<cmd_separator()>
16850
16851 =back
16852
16853 =over 4
16854
16855 =item $pod_para-E<gt>B<parse_tree()>
16856
16857 =back
16858
16859 =over 4
16860
16861 =item $pod_para-E<gt>B<file_line()>
16862
16863 =back
16864
16865 =over 4
16866
16867 =item B<Pod::InteriorSequence>
16868
16869 =back
16870
16871 =over 4
16872
16873 =item Pod::InteriorSequence-E<gt>B<new()>
16874
16875 =back
16876
16877 =over 4
16878
16879 =item $pod_seq-E<gt>B<cmd_name()>
16880
16881 =back
16882
16883 =over 4
16884
16885 =item $pod_seq-E<gt>B<prepend()>
16886
16887 =back
16888
16889 =over 4
16890
16891 =item $pod_seq-E<gt>B<append()>
16892
16893 =back
16894
16895 =over 4
16896
16897 =item $pod_seq-E<gt>B<nested()>
16898
16899 =back
16900
16901 =over 4
16902
16903 =item $pod_seq-E<gt>B<raw_text()>
16904
16905 =back
16906
16907 =over 4
16908
16909 =item $pod_seq-E<gt>B<left_delimiter()>
16910
16911 =back
16912
16913 =over 4
16914
16915 =item $pod_seq-E<gt>B<right_delimiter()>
16916
16917 =back
16918
16919 =over 4
16920
16921 =item $pod_seq-E<gt>B<parse_tree()>
16922
16923 =back
16924
16925 =over 4
16926
16927 =item $pod_seq-E<gt>B<file_line()>
16928
16929 =back
16930
16931 =over 4
16932
16933 =item Pod::InteriorSequence::B<DESTROY()>
16934
16935 =back
16936
16937 =over 4
16938
16939 =item B<Pod::ParseTree>
16940
16941 =back
16942
16943 =over 4
16944
16945 =item Pod::ParseTree-E<gt>B<new()>
16946
16947 =back
16948
16949 =over 4
16950
16951 =item $ptree-E<gt>B<top()>
16952
16953 =back
16954
16955 =over 4
16956
16957 =item $ptree-E<gt>B<children()>
16958
16959 =back
16960
16961 =over 4
16962
16963 =item $ptree-E<gt>B<prepend()>
16964
16965 =back
16966
16967 =over 4
16968
16969 =item $ptree-E<gt>B<append()>
16970
16971 =back
16972
16973 =over 4
16974
16975 =item $ptree-E<gt>B<raw_text()>
16976
16977 =back
16978
16979 =over 4
16980
16981 =item Pod::ParseTree::B<DESTROY()>
16982
16983 =back
16984
16985 =over 4
16986
16987 =item SEE ALSO
16988
16989 =item AUTHOR
16990
16991 =back
16992
16993 =head2 Pod::LaTeX - Convert Pod data to formatted Latex
16994
16995 =over 4
16996
16997 =item SYNOPSIS
16998
16999 =item DESCRIPTION
17000
17001 =back
17002
17003 =over 4
17004
17005 =item OBJECT METHODS
17006
17007 C<initialize>
17008
17009 =back
17010
17011 =over 4
17012
17013 =item Data Accessors
17014
17015 B<AddPreamble>
17016
17017 =back
17018
17019 B<AddPostamble>
17020
17021 B<Head1Level>
17022
17023 B<Label>
17024
17025 B<LevelNoNum>
17026
17027 B<MakeIndex>
17028
17029 B<ReplaceNAMEwithSection>
17030
17031 B<StartWithNewPage>
17032
17033 B<TableOfContents>
17034
17035 B<UniqueLabels>
17036
17037 B<UserPreamble>
17038
17039 B<UserPostamble>
17040
17041 B<Lists>
17042
17043 =over 4
17044
17045 =item Subclassed methods
17046
17047 =back
17048
17049 B<begin_pod>
17050
17051 B<end_pod>
17052
17053 B<command>
17054
17055 B<verbatim>
17056
17057 B<textblock>
17058
17059 B<interior_sequence>
17060
17061 =over 4
17062
17063 =item List Methods
17064
17065 B<begin_list>
17066
17067 =back
17068
17069 B<end_list>
17070
17071 B<add_item>
17072
17073 =over 4
17074
17075 =item Methods for headings
17076
17077 B<head>
17078
17079 =back
17080
17081 =over 4
17082
17083 =item Internal methods
17084
17085 B<_output>
17086
17087 =back
17088
17089 B<_replace_special_chars>
17090
17091 B<_replace_special_chars_late>
17092
17093 B<_create_label>
17094
17095 B<_create_index>
17096
17097 B<_clean_latex_commands>
17098
17099 B<_split_delimited>
17100
17101 =over 4
17102
17103 =item NOTES
17104
17105 =item SEE ALSO
17106
17107 =item AUTHORS
17108
17109 =item COPYRIGHT
17110
17111 =item REVISION
17112
17113 =back
17114
17115 =head2 Pod::Man - Convert POD data to formatted *roff input
17116
17117 =over 4
17118
17119 =item SYNOPSIS
17120
17121 =item DESCRIPTION
17122
17123 center, date, fixed, fixedbold, fixeditalic, fixedbolditalic, name, quotes,
17124 release, section
17125
17126 =item DIAGNOSTICS
17127
17128 roff font should be 1 or 2 chars, not "%s", Invalid link %s, Invalid quote
17129 specification "%s", %s:%d: Unknown command paragraph "%s", %s:%d: Unknown
17130 escape EE<lt>%sE<gt>, %s:%d: Unknown formatting code %s, %s:%d: Unmatched
17131 =back
17132
17133 =item BUGS
17134
17135 =item CAVEATS
17136
17137 =item SEE ALSO
17138
17139 =item AUTHOR
17140
17141 =item COPYRIGHT AND LICENSE
17142
17143 =back
17144
17145 =head2 Pod::ParseLink -- Parse an LE<lt>E<gt> formatting code in POD text
17146
17147 =over 4
17148
17149 =item SYNOPSIS
17150
17151 =item DESCRIPTION
17152
17153 =item AUTHOR
17154
17155 =item COPYRIGHT AND LICENSE
17156
17157 =back
17158
17159 =head2 Pod::ParseUtils - helpers for POD parsing and conversion
17160
17161 =over 4
17162
17163 =item SYNOPSIS
17164
17165 =item DESCRIPTION
17166
17167 =back
17168
17169 =over 4
17170
17171 =item Pod::List
17172
17173 Pod::List-E<gt>new()
17174
17175 =back
17176
17177 $list-E<gt>file()
17178
17179 $list-E<gt>start()
17180
17181 $list-E<gt>indent()
17182
17183 $list-E<gt>type()
17184
17185 $list-E<gt>rx()
17186
17187 $list-E<gt>item()
17188
17189 $list-E<gt>parent()
17190
17191 $list-E<gt>tag()
17192
17193 =over 4
17194
17195 =item Pod::Hyperlink
17196
17197 Pod::Hyperlink-E<gt>new()
17198
17199 =back
17200
17201 $link-E<gt>parse($string)
17202
17203 $link-E<gt>markup($string)
17204
17205 $link-E<gt>text()
17206
17207 $link-E<gt>warning()
17208
17209 $link-E<gt>file(), $link-E<gt>line()
17210
17211 $link-E<gt>page()
17212
17213 $link-E<gt>node()
17214
17215 $link-E<gt>alttext()
17216
17217 $link-E<gt>type()
17218
17219 $link-E<gt>link()
17220
17221 =over 4
17222
17223 =item Pod::Cache
17224
17225 Pod::Cache-E<gt>new()
17226
17227 =back
17228
17229 $cache-E<gt>item()
17230
17231 $cache-E<gt>find_page($name)
17232
17233 =over 4
17234
17235 =item Pod::Cache::Item
17236
17237 Pod::Cache::Item-E<gt>new()
17238
17239 =back
17240
17241 $cacheitem-E<gt>page()
17242
17243 $cacheitem-E<gt>description()
17244
17245 $cacheitem-E<gt>path()
17246
17247 $cacheitem-E<gt>file()
17248
17249 $cacheitem-E<gt>nodes()
17250
17251 $cacheitem-E<gt>find_node($name)
17252
17253 $cacheitem-E<gt>idx()
17254
17255 =over 4
17256
17257 =item AUTHOR
17258
17259 =item SEE ALSO
17260
17261 =back
17262
17263 =head2 Pod::Parser - base class for creating POD filters and translators
17264
17265 =over 4
17266
17267 =item SYNOPSIS
17268
17269 =item REQUIRES
17270
17271 =item EXPORTS
17272
17273 =item DESCRIPTION
17274
17275 =item QUICK OVERVIEW
17276
17277 =item PARSING OPTIONS
17278
17279 B<-want_nonPODs> (default: unset), B<-process_cut_cmd> (default: unset),
17280 B<-warnings> (default: unset)
17281
17282 =back
17283
17284 =over 4
17285
17286 =item RECOMMENDED SUBROUTINE/METHOD OVERRIDES
17287
17288 =back
17289
17290 =over 4
17291
17292 =item B<command()>
17293
17294 C<$cmd>, C<$text>, C<$line_num>, C<$pod_para>
17295
17296 =back
17297
17298 =over 4
17299
17300 =item B<verbatim()>
17301
17302 C<$text>, C<$line_num>, C<$pod_para>
17303
17304 =back
17305
17306 =over 4
17307
17308 =item B<textblock()>
17309
17310 C<$text>, C<$line_num>, C<$pod_para>
17311
17312 =back
17313
17314 =over 4
17315
17316 =item B<interior_sequence()>
17317
17318 =back
17319
17320 =over 4
17321
17322 =item OPTIONAL SUBROUTINE/METHOD OVERRIDES
17323
17324 =back
17325
17326 =over 4
17327
17328 =item B<new()>
17329
17330 =back
17331
17332 =over 4
17333
17334 =item B<initialize()>
17335
17336 =back
17337
17338 =over 4
17339
17340 =item B<begin_pod()>
17341
17342 =back
17343
17344 =over 4
17345
17346 =item B<begin_input()>
17347
17348 =back
17349
17350 =over 4
17351
17352 =item B<end_input()>
17353
17354 =back
17355
17356 =over 4
17357
17358 =item B<end_pod()>
17359
17360 =back
17361
17362 =over 4
17363
17364 =item B<preprocess_line()>
17365
17366 =back
17367
17368 =over 4
17369
17370 =item B<preprocess_paragraph()>
17371
17372 =back
17373
17374 =over 4
17375
17376 =item METHODS FOR PARSING AND PROCESSING
17377
17378 =back
17379
17380 =over 4
17381
17382 =item B<parse_text()>
17383
17384 B<-expand_seq> =E<gt> I<code-ref>|I<method-name>, B<-expand_text> =E<gt>
17385 I<code-ref>|I<method-name>, B<-expand_ptree> =E<gt>
17386 I<code-ref>|I<method-name>
17387
17388 =back
17389
17390 =over 4
17391
17392 =item B<interpolate()>
17393
17394 =back
17395
17396 =over 4
17397
17398 =item B<parse_paragraph()>
17399
17400 =back
17401
17402 =over 4
17403
17404 =item B<parse_from_filehandle()>
17405
17406 =back
17407
17408 =over 4
17409
17410 =item B<parse_from_file()>
17411
17412 =back
17413
17414 =over 4
17415
17416 =item ACCESSOR METHODS
17417
17418 =back
17419
17420 =over 4
17421
17422 =item B<errorsub()>
17423
17424 =back
17425
17426 =over 4
17427
17428 =item B<cutting()>
17429
17430 =back
17431
17432 =over 4
17433
17434 =item B<parseopts()>
17435
17436 =back
17437
17438 =over 4
17439
17440 =item B<output_file()>
17441
17442 =back
17443
17444 =over 4
17445
17446 =item B<output_handle()>
17447
17448 =back
17449
17450 =over 4
17451
17452 =item B<input_file()>
17453
17454 =back
17455
17456 =over 4
17457
17458 =item B<input_handle()>
17459
17460 =back
17461
17462 =over 4
17463
17464 =item B<input_streams()>
17465
17466 =back
17467
17468 =over 4
17469
17470 =item B<top_stream()>
17471
17472 =back
17473
17474 =over 4
17475
17476 =item PRIVATE METHODS AND DATA
17477
17478 =back
17479
17480 =over 4
17481
17482 =item B<_push_input_stream()>
17483
17484 =back
17485
17486 =over 4
17487
17488 =item B<_pop_input_stream()>
17489
17490 =back
17491
17492 =over 4
17493
17494 =item TREE-BASED PARSING
17495
17496 =item SEE ALSO
17497
17498 =item AUTHOR
17499
17500 =back
17501
17502 =head2 Pod::Plainer - Perl extension for converting Pod to old style Pod.
17503
17504 =over 4
17505
17506 =item SYNOPSIS
17507
17508 =item DESCRIPTION
17509
17510 =over 4
17511
17512 =item EXPORT
17513
17514 =back
17515
17516 =item AUTHOR
17517
17518 =item SEE ALSO
17519
17520 =back
17521
17522 =head2 Pod::Select, podselect() - extract selected sections of POD from
17523 input
17524
17525 =over 4
17526
17527 =item SYNOPSIS
17528
17529 =item REQUIRES
17530
17531 =item EXPORTS
17532
17533 =item DESCRIPTION
17534
17535 =item SECTION SPECIFICATIONS
17536
17537 =item RANGE SPECIFICATIONS
17538
17539 =back
17540
17541 =over 4
17542
17543 =item OBJECT METHODS
17544
17545 =back
17546
17547 =over 4
17548
17549 =item B<curr_headings()>
17550
17551 =back
17552
17553 =over 4
17554
17555 =item B<select()>
17556
17557 =back
17558
17559 =over 4
17560
17561 =item B<add_selection()>
17562
17563 =back
17564
17565 =over 4
17566
17567 =item B<clear_selections()>
17568
17569 =back
17570
17571 =over 4
17572
17573 =item B<match_section()>
17574
17575 =back
17576
17577 =over 4
17578
17579 =item B<is_selected()>
17580
17581 =back
17582
17583 =over 4
17584
17585 =item EXPORTED FUNCTIONS
17586
17587 =back
17588
17589 =over 4
17590
17591 =item B<podselect()>
17592
17593 B<-output>, B<-sections>, B<-ranges>
17594
17595 =back
17596
17597 =over 4
17598
17599 =item PRIVATE METHODS AND DATA
17600
17601 =back
17602
17603 =over 4
17604
17605 =item B<_compile_section_spec()>
17606
17607 =back
17608
17609 =over 4
17610
17611 =item $self->{_SECTION_HEADINGS}
17612
17613 =back
17614
17615 =over 4
17616
17617 =item $self->{_SELECTED_SECTIONS}
17618
17619 =back
17620
17621 =over 4
17622
17623 =item SEE ALSO
17624
17625 =item AUTHOR
17626
17627 =back
17628
17629 =head2 Pod::Text - Convert POD data to formatted ASCII text
17630
17631 =over 4
17632
17633 =item SYNOPSIS
17634
17635 =item DESCRIPTION
17636
17637 alt, code, indent, loose, quotes, sentence, width
17638
17639 =item DIAGNOSTICS
17640
17641 Bizarre space in item, Item called without tag, Can't open %s for reading:
17642 %s, Invalid quote specification "%s", %s:%d: Unknown command paragraph: %s,
17643 %s:%d: Unknown escape: %s, %s:%d: Unknown formatting code: %s, %s:%d:
17644 Unmatched =back
17645
17646 =item RESTRICTIONS
17647
17648 =item NOTES
17649
17650 =item SEE ALSO
17651
17652 =item AUTHOR
17653
17654 =item COPYRIGHT AND LICENSE
17655
17656 =back
17657
17658 =head2 Pod::Text::Color - Convert POD data to formatted color ASCII text
17659
17660 =over 4
17661
17662 =item SYNOPSIS
17663
17664 =item DESCRIPTION
17665
17666 =item BUGS
17667
17668 =item SEE ALSO
17669
17670 =item AUTHOR
17671
17672 =item COPYRIGHT AND LICENSE
17673
17674 =back
17675
17676 =head2 Pod::Text::Overstrike - Convert POD data to formatted overstrike
17677 text
17678
17679 =over 4
17680
17681 =item SYNOPSIS
17682
17683 =item DESCRIPTION
17684
17685 =item BUGS
17686
17687 =item SEE ALSO
17688
17689 =item AUTHOR
17690
17691 =item COPYRIGHT AND LICENSE
17692
17693 =back
17694
17695 =head2 Pod::Text::Termcap, Pod::Text::Color - Convert POD data to ASCII
17696 text with format escapes
17697
17698 =over 4
17699
17700 =item SYNOPSIS
17701
17702 =item DESCRIPTION
17703
17704 =item NOTES
17705
17706 =item SEE ALSO
17707
17708 =item AUTHOR
17709
17710 =item COPYRIGHT AND LICENSE
17711
17712 =back
17713
17714 =head2 Pod::Usage, pod2usage() - print a usage message from embedded pod
17715 documentation
17716
17717 =over 4
17718
17719 =item SYNOPSIS
17720
17721 =item ARGUMENTS
17722
17723 C<-message>, C<-msg>, C<-exitval>, C<-verbose>, C<-output>, C<-input>,
17724 C<-pathlist>
17725
17726 =item DESCRIPTION
17727
17728 =item EXAMPLES
17729
17730 =over 4
17731
17732 =item Recommended Use
17733
17734 =back
17735
17736 =item CAVEATS
17737
17738 =item AUTHOR
17739
17740 =item ACKNOWLEDGEMENTS
17741
17742 =back
17743
17744 =head2 Pod::t::basic, basic.pod - Test of various basic POD features in
17745 translators.
17746
17747 =over 4
17748
17749 =item HEADINGS
17750
17751 =item This C<is> a "level 1" heading
17752
17753 =over 4
17754
17755 =item ``Level'' "2 I<heading>
17756
17757 =back
17758
17759 =item This C<is> a "level 1" heading
17760
17761 =over 4
17762
17763 =item ``Level'' 2 I<heading>
17764
17765 =back
17766
17767 =item LINKS
17768
17769 =item OVER AND ITEMS
17770
17771 This  is a test, a, b, a, b, c, d, "foo", B<bar>, C<baz>, Some longer item
17772 text
17773
17774 =item FORMATTING CODES
17775
17776 E<amp>, E<apos>, E<lt>, E<gt>, E<quot>, E<sol>
17777
17778 =item VERBATIM
17779
17780 =item CONCLUSION
17781
17782 =back
17783
17784 =head2 Pod::t::htmlescp, Escape Sequences Test
17785
17786 =over 4
17787
17788 =item DESCRIPTION
17789
17790 =back
17791
17792 =head2 Pod::t::htmlview, Test HTML Rendering
17793
17794 =over 4
17795
17796 =item SYNOPSIS
17797
17798 =item DESCRIPTION
17799
17800 =item METHODS =E<gt> OTHER STUFF
17801
17802 =over 4
17803
17804 =item new()
17805
17806 foo, bar, baz, C<Black> Cat, Sat S<I<on> the>, MatE<lt>!E<gt>, 1 Cat, 2
17807 Sat, 3 Mat
17808
17809 =item old()
17810
17811 =back
17812
17813 =item TESTING FOR AND BEGIN
17814
17815 =item TESTING URLs hyperlinking
17816
17817 =item SEE ALSO
17818
17819 =back
17820
17821 =head2 SDBM_File - Tied access to sdbm files
17822
17823 =over 4
17824
17825 =item SYNOPSIS
17826
17827 =item DESCRIPTION
17828
17829 C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR>
17830
17831 =item DIAGNOSTICS
17832
17833 =over 4
17834
17835 =item C<sdbm store returned -1, errno 22, key "..." at ...>
17836
17837 =back
17838
17839 =item BUGS AND WARNINGS
17840
17841 =back
17842
17843 =head2 Safe - Compile and execute code in restricted compartments
17844
17845 =over 4
17846
17847 =item SYNOPSIS
17848
17849 =item DESCRIPTION
17850
17851 a new namespace, an operator mask
17852
17853 =item WARNING
17854
17855 =over 4
17856
17857 =item RECENT CHANGES
17858
17859 =item Methods in class Safe
17860
17861 permit (OP, ...), permit_only (OP, ...), deny (OP, ...), deny_only (OP,
17862 ...), trap (OP, ...), untrap (OP, ...), share (NAME, ...), share_from
17863 (PACKAGE, ARRAYREF), varglob (VARNAME), reval (STRING), rdo (FILENAME),
17864 root (NAMESPACE), mask (MASK)
17865
17866 =item Some Safety Issues
17867
17868 Memory, CPU, Snooping, Signals, State Changes
17869
17870 =item AUTHOR
17871
17872 =back
17873
17874 =back
17875
17876 =head2 Scalar::Util - A selection of general-utility scalar subroutines
17877
17878 =over 4
17879
17880 =item SYNOPSIS
17881
17882 =item DESCRIPTION
17883
17884 blessed EXPR, dualvar NUM, STRING, isweak EXPR, openhandle FH, reftype
17885 EXPR, tainted EXPR, weaken REF
17886
17887 =item KNOWN BUGS
17888
17889 =item COPYRIGHT
17890
17891 =item BLATANT PLUG
17892
17893 =back
17894
17895 =head2 Search::Dict, look - search for key in dictionary file
17896
17897 =over 4
17898
17899 =item SYNOPSIS
17900
17901 =item DESCRIPTION
17902
17903 =back
17904
17905 =head2 SelectSaver - save and restore selected file handle
17906
17907 =over 4
17908
17909 =item SYNOPSIS
17910
17911 =item DESCRIPTION
17912
17913 =back
17914
17915 =head2 SelfLoader - load functions only on demand
17916
17917 =over 4
17918
17919 =item SYNOPSIS
17920
17921 =item DESCRIPTION
17922
17923 =over 4
17924
17925 =item The __DATA__ token
17926
17927 =item SelfLoader autoloading
17928
17929 =item Autoloading and package lexicals
17930
17931 =item SelfLoader and AutoLoader
17932
17933 =item __DATA__, __END__, and the FOOBAR::DATA filehandle.
17934
17935 =item Classes and inherited methods.
17936
17937 =back
17938
17939 =item Multiple packages and fully qualified subroutine names
17940
17941 =back
17942
17943 =head2 Shell - run shell commands transparently within perl
17944
17945 =over 4
17946
17947 =item SYNOPSIS
17948
17949 =item DESCRIPTION
17950
17951 =over 4
17952
17953 =item OBJECT ORIENTED SYNTAX
17954
17955 =back
17956
17957 =item AUTHOR
17958
17959 =back
17960
17961 =head2 Socket, sockaddr_in, sockaddr_un, inet_aton, inet_ntoa - load the C
17962 socket.h defines and structure manipulators
17963
17964 =over 4
17965
17966 =item SYNOPSIS
17967
17968 =item DESCRIPTION
17969
17970 inet_aton HOSTNAME, inet_ntoa IP_ADDRESS, INADDR_ANY, INADDR_BROADCAST,
17971 INADDR_LOOPBACK, INADDR_NONE, sockaddr_family SOCKADDR, sockaddr_in PORT,
17972 ADDRESS, sockaddr_in SOCKADDR_IN, pack_sockaddr_in PORT, IP_ADDRESS,
17973 unpack_sockaddr_in SOCKADDR_IN, sockaddr_un PATHNAME, sockaddr_un
17974 SOCKADDR_UN, pack_sockaddr_un PATH, unpack_sockaddr_un SOCKADDR_UN
17975
17976 =back
17977
17978 =head2 Storable - persistence for Perl data structures
17979
17980 =over 4
17981
17982 =item SYNOPSIS
17983
17984 =item DESCRIPTION
17985
17986 =item MEMORY STORE
17987
17988 =item ADVISORY LOCKING
17989
17990 =item SPEED
17991
17992 =item CANONICAL REPRESENTATION
17993
17994 =item FORWARD COMPATIBILITY
17995
17996 utf8 data, restricted hashes, files from future versions of Storable
17997
17998 =item ERROR REPORTING
17999
18000 =item WIZARDS ONLY
18001
18002 =over 4
18003
18004 =item Hooks
18005
18006 C<STORABLE_freeze> I<obj>, I<cloning>, C<STORABLE_thaw> I<obj>, I<cloning>,
18007 I<serialized>, ..
18008
18009 =item Predicates
18010
18011 C<Storable::last_op_in_netorder>, C<Storable::is_storing>,
18012 C<Storable::is_retrieving>
18013
18014 =item Recursion
18015
18016 =item Deep Cloning
18017
18018 =back
18019
18020 =item Storable magic
18021
18022 =item EXAMPLES
18023
18024 =item WARNING
18025
18026 =item BUGS
18027
18028 =over 4
18029
18030 =item 64 bit data in perl 5.6.0 and 5.6.1
18031
18032 =back
18033
18034 =item CREDITS
18035
18036 =item AUTHOR
18037
18038 =item SEE ALSO
18039
18040 =back
18041
18042 =head2 Switch - A switch statement for Perl
18043
18044 =over 4
18045
18046 =item VERSION
18047
18048 =item SYNOPSIS
18049
18050 =item BACKGROUND
18051
18052 =item DESCRIPTION
18053
18054 =over 4
18055
18056 =item Allowing fall-through
18057
18058 =item Automating fall-through
18059
18060 =item Alternative syntax
18061
18062 =item Higher-order Operations
18063
18064 =back
18065
18066 =item DEPENDENCIES
18067
18068 =item AUTHOR
18069
18070 =item BUGS
18071
18072 =item LIMITATION
18073
18074 =item COPYRIGHT
18075
18076 =back
18077
18078 =head2 Symbol - manipulate Perl symbols and their names
18079
18080 =over 4
18081
18082 =item SYNOPSIS
18083
18084 =item DESCRIPTION
18085
18086 =back
18087
18088 =head2 Sys::Hostname - Try every conceivable way to get hostname
18089
18090 =over 4
18091
18092 =item SYNOPSIS
18093
18094 =item DESCRIPTION
18095
18096 =item AUTHOR
18097
18098 =back
18099
18100 =head2 Syslog, Sys::Syslog, openlog, closelog, setlogmask, syslog - Perl
18101 interface to the UNIX syslog(3) calls
18102
18103 =over 4
18104
18105 =item SYNOPSIS
18106
18107 =item DESCRIPTION
18108
18109 openlog $ident, $logopt, $facility, syslog $priority, $format, @args,
18110 setlogmask $mask_priority, setlogsock $sock_type [$stream_location] (added
18111 in 5.004_02), closelog
18112
18113 =item EXAMPLES
18114
18115 =item SEE ALSO
18116
18117 =item AUTHOR
18118
18119 =back
18120
18121 =head2 Syslog::Syslog, Sys::Syslog, openlog, closelog, setlogmask, syslog -
18122 Perl 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 Term::ANSIColor - Color screen output using ANSI escape sequences
18143
18144 =over 4
18145
18146 =item SYNOPSIS
18147
18148 =item DESCRIPTION
18149
18150 =item DIAGNOSTICS
18151
18152 Bad escape sequence %s, Bareword "%s" not allowed while "strict subs" in
18153 use, Invalid attribute name %s, Name "%s" used only once: possible typo, No
18154 comma allowed after filehandle, No name for escape sequence %s
18155
18156 =item ENVIRONMENT
18157
18158 ANSI_COLORS_DISABLED
18159
18160 =item RESTRICTIONS
18161
18162 =item NOTES
18163
18164 =item SEE ALSO
18165
18166 =item AUTHORS
18167
18168 =item LICENSE
18169
18170 =back
18171
18172 =head2 Term::Cap - Perl termcap interface
18173
18174 =over 4
18175
18176 =item SYNOPSIS
18177
18178 =item DESCRIPTION
18179
18180 =over 4
18181
18182 =item METHODS
18183
18184 =back
18185
18186 =back
18187
18188 B<Tgetent>, OSPEED, TERM
18189
18190 B<Tpad>, B<$string>, B<$cnt>, B<$FH>
18191
18192 B<Tputs>, B<$cap>, B<$cnt>, B<$FH>
18193
18194 B<Tgoto>, B<$cap>, B<$col>, B<$row>, B<$FH>
18195
18196 B<Trequire>
18197
18198 =over 4
18199
18200 =item EXAMPLES
18201
18202 =item COPYRIGHT AND LICENSE
18203
18204 =item AUTHOR
18205
18206 =item SEE ALSO
18207
18208 =back
18209
18210 =head2 Term::Complete - Perl word completion module
18211
18212 =over 4
18213
18214 =item SYNOPSIS
18215
18216 =item DESCRIPTION
18217
18218 E<lt>tabE<gt>, ^D, ^U, E<lt>delE<gt>, E<lt>bsE<gt>
18219
18220 =item DIAGNOSTICS
18221
18222 =item BUGS
18223
18224 =item AUTHOR
18225
18226 =back
18227
18228 =head2 Term::ReadLine - Perl interface to various C<readline> packages. If
18229 no real package is found, substitutes stubs instead of basic functions.
18230
18231 =over 4
18232
18233 =item SYNOPSIS
18234
18235 =item DESCRIPTION
18236
18237 =item Minimal set of supported functions
18238
18239 C<ReadLine>, C<new>, C<readline>, C<addhistory>, C<IN>, $C<OUT>,
18240 C<MinLine>, C<findConsole>, Attribs, C<Features>
18241
18242 =item Additional supported functions
18243
18244 C<tkRunning>, C<ornaments>, C<newTTY>
18245
18246 =item EXPORTS
18247
18248 =item ENVIRONMENT
18249
18250 =item CAVEATS
18251
18252 =back
18253
18254 =head2 Test - provides a simple framework for writing test scripts
18255
18256 =over 4
18257
18258 =item SYNOPSIS
18259
18260 =item DESCRIPTION
18261
18262 =over 4
18263
18264 =item Functions
18265
18266 B<plan>
18267
18268 =back
18269
18270 =back
18271
18272 B<_to_value>
18273
18274 B<ok>
18275
18276 =over 4
18277
18278 =item TEST TYPES
18279
18280 NORMAL TESTS, SKIPPED TESTS, TODO TESTS
18281
18282 =item ONFAIL
18283
18284 =item BUGS and CAVEATS
18285
18286 =item NOTE
18287
18288 =item SEE ALSO
18289
18290 =item AUTHOR
18291
18292 =back
18293
18294 =head2 Test::Builder - Backend for building test libraries
18295
18296 =over 4
18297
18298 =item SYNOPSIS
18299
18300 =item DESCRIPTION
18301
18302 =over 4
18303
18304 =item Construction
18305
18306 B<new>
18307
18308 =back
18309
18310 =back
18311
18312 =over 4
18313
18314 =item Setting up tests
18315
18316 B<exported_to>
18317
18318 =back
18319
18320 B<plan>
18321
18322 B<expected_tests>
18323
18324 B<no_plan>
18325
18326 B<skip_all>
18327
18328 =over 4
18329
18330 =item Running tests
18331
18332 B<ok>
18333
18334 =back
18335
18336 B<is_eq>, B<is_num>
18337
18338 B<isnt_eq>, B<isnt_num>
18339
18340 B<like>, B<unlike>
18341
18342 B<maybe_regex>
18343
18344 B<cmp_ok>
18345
18346 B<BAILOUT>
18347
18348 B<skip>
18349
18350 B<todo_skip>
18351
18352 B<skip_rest>
18353
18354 =over 4
18355
18356 =item Test style
18357
18358 B<level>
18359
18360 =back
18361
18362 B<use_numbers>
18363
18364 B<no_header>, B<no_ending>
18365
18366 =over 4
18367
18368 =item Output
18369
18370 B<diag>
18371
18372 =back
18373
18374 B<_print>
18375
18376 B<output>, B<failure_output>, B<todo_output>
18377
18378 =over 4
18379
18380 =item Test Status and Info
18381
18382 B<current_test>
18383
18384 =back
18385
18386 B<summary>
18387
18388 B<details>  I<UNIMPLEMENTED>, B<todo>
18389
18390 B<caller>
18391
18392 B<_sanity_check>
18393
18394 B<_whoa>
18395
18396 B<_my_exit>
18397
18398 =over 4
18399
18400 =item THREADS
18401
18402 =item EXAMPLES
18403
18404 =item SEE ALSO
18405
18406 =item AUTHORS
18407
18408 =item COPYRIGHT
18409
18410 =back
18411
18412 =head2 Test::Harness - run perl standard test scripts with statistics
18413
18414 =over 4
18415
18416 =item SYNOPSIS
18417
18418 =item DESCRIPTION
18419
18420 =over 4
18421
18422 =item The test script output
18423
18424 B<'1..M'>, B<'ok', 'not ok'.  Ok?>, B<test numbers>, B<test names>,
18425 B<Skipping tests>, B<Todo tests>, B<Bail out!>, B<Comments>, B<Anything
18426 else>
18427
18428 =item Taint mode
18429
18430 =item Configuration variables.
18431
18432 B<$Test::Harness::verbose>, B<$Test::Harness::switches>
18433
18434 =item Failure
18435
18436 B<Failed Test>, B<Stat>, B<Wstat>, B<Total>, B<Fail>, B<Failed>, B<List of
18437 Failed>
18438
18439 =item Functions
18440
18441 B<runtests>
18442
18443 =back
18444
18445 =back
18446
18447 B<_all_ok>
18448
18449 B<_globdir>
18450
18451 B<_run_all_tests>
18452
18453 B<_mk_leader>
18454
18455 B<_leader_width>
18456
18457 =over 4
18458
18459 =item EXPORT
18460
18461 =item DIAGNOSTICS
18462
18463 C<All tests successful.\nFiles=%d,  Tests=%d, %s>, C<FAILED tests
18464 %s\n\tFailed %d/%d tests, %.2f%% okay.>, C<Test returned status %d (wstat
18465 %d)>, C<Failed 1 test, %.2f%% okay. %s>, C<Failed %d/%d tests, %.2f%% okay.
18466 %s>, C<FAILED--Further testing stopped: %s>
18467
18468 =item ENVIRONMENT
18469
18470 C<HARNESS_ACTIVE>, C<HARNESS_COLUMNS>, C<HARNESS_COMPILE_TEST>,
18471 C<HARNESS_FILELEAK_IN_DIR>, C<HARNESS_IGNORE_EXITCODE>, C<HARNESS_NOTTY>,
18472 C<HARNESS_PERL_SWITCHES>, C<HARNESS_VERBOSE>
18473
18474 =item EXAMPLE
18475
18476 =item SEE ALSO
18477
18478 =item AUTHORS
18479
18480 =item TODO
18481
18482 =item BUGS
18483
18484 =back
18485
18486 =head2 Test::Harness::Assert - simple assert
18487
18488 =over 4
18489
18490 =item SYNOPSIS
18491
18492 =item DESCRIPTION
18493
18494 =over 4
18495
18496 =item Functions
18497
18498 B<assert>
18499
18500 =back
18501
18502 =back
18503
18504 =over 4
18505
18506 =item AUTHOR
18507
18508 =item SEE ALSO
18509
18510 =back
18511
18512 =head2 Test::Harness::Iterator - Internal Test::Harness Iterator
18513
18514 =over 4
18515
18516 =item SYNOPSIS
18517
18518 =item DESCRIPTION
18519
18520 =back
18521
18522 =head2 Test::Harness::Straps - detailed analysis of test results
18523
18524 =over 4
18525
18526 =item SYNOPSIS
18527
18528 =item DESCRIPTION
18529
18530 =over 4
18531
18532 =item Construction
18533
18534 B<new>
18535
18536 =back
18537
18538 =back
18539
18540 B<_init>
18541
18542 =over 4
18543
18544 =item Analysis
18545
18546 B<analyze>
18547
18548 =back
18549
18550 B<analyze_fh>
18551
18552 B<analyze_file>
18553
18554 B<_switches>
18555
18556 B<_INC2PERL5LIB>
18557
18558 B<_filtered_INC>
18559
18560 B<_restore_PERL5LIB>
18561
18562 =over 4
18563
18564 =item Parsing
18565
18566 B<_is_comment>
18567
18568 =back
18569
18570 B<_is_header>
18571
18572 B<_is_test>
18573
18574 B<_is_bail_out>
18575
18576 B<_reset_file_state>
18577
18578 =over 4
18579
18580 =item Results
18581
18582 B<_detailize>
18583
18584 =back
18585
18586 =over 4
18587
18588 =item EXAMPLES
18589
18590 =item AUTHOR
18591
18592 =item SEE ALSO
18593
18594 =back
18595
18596 =head2 Test::More - yet another framework for writing test scripts
18597
18598 =over 4
18599
18600 =item SYNOPSIS
18601
18602 =item DESCRIPTION
18603
18604 =over 4
18605
18606 =item I love it when a plan comes together
18607
18608 =back
18609
18610 =back
18611
18612 =over 4
18613
18614 =item Test names
18615
18616 =item I'm ok, you're not ok.
18617
18618 B<ok>
18619
18620 =back
18621
18622 B<is>, B<isnt>
18623
18624 B<like>
18625
18626 B<unlike>
18627
18628 B<cmp_ok>
18629
18630 B<can_ok>
18631
18632 B<isa_ok>
18633
18634 B<pass>, B<fail>
18635
18636 =over 4
18637
18638 =item Diagnostics
18639
18640 B<diag>
18641
18642 =back
18643
18644 =over 4
18645
18646 =item Module tests
18647
18648 B<use_ok>
18649
18650 =back
18651
18652 B<require_ok>
18653
18654 =over 4
18655
18656 =item Conditional tests
18657
18658 B<SKIP: BLOCK>
18659
18660 =back
18661
18662 B<TODO: BLOCK>, B<todo_skip>
18663
18664 When do I use SKIP vs. TODO?
18665
18666 =over 4
18667
18668 =item Comparison functions
18669
18670 B<is_deeply>
18671
18672 =back
18673
18674 B<eq_array>
18675
18676 B<eq_hash>
18677
18678 B<eq_set>
18679
18680 =over 4
18681
18682 =item Extending and Embedding Test::More
18683
18684 B<builder>
18685
18686 =back
18687
18688 =over 4
18689
18690 =item NOTES
18691
18692 =item BUGS and CAVEATS
18693
18694 Making your own ok(), The eq_* family has some caveats, Test::Harness
18695 upgrades
18696
18697 =item HISTORY
18698
18699 =item SEE ALSO
18700
18701 =item AUTHORS
18702
18703 =item COPYRIGHT
18704
18705 =back
18706
18707 =head2 Test::Simple - Basic utilities for writing tests.
18708
18709 =over 4
18710
18711 =item SYNOPSIS
18712
18713 =item DESCRIPTION
18714
18715 B<ok>
18716
18717 =back
18718
18719 =over 4
18720
18721 =item EXAMPLE
18722
18723 =item CAVEATS
18724
18725 =item NOTES
18726
18727 =item HISTORY
18728
18729 =item SEE ALSO
18730
18731 L<Test::More>, L<Test>, L<Test::Unit>, L<Test::Inline>, L<SelfTest>,
18732 L<Test::Harness>
18733
18734 =item AUTHORS
18735
18736 =item COPYRIGHT
18737
18738 =back
18739
18740 =head2 Test::Tutorial - A tutorial about writing really basic tests
18741
18742 =over 4
18743
18744 =item DESCRIPTION
18745
18746 =over 4
18747
18748 =item Nuts and bolts of testing.
18749
18750 =item Where to start?
18751
18752 =item Names
18753
18754 =item Test the manual
18755
18756 =item Sometimes the tests are wrong
18757
18758 =item Testing lots of values
18759
18760 =item Informative names
18761
18762 =item Skipping tests
18763
18764 =item Todo tests
18765
18766 =item Testing with taint mode.
18767
18768 =back
18769
18770 =item FOOTNOTES
18771
18772 =item AUTHORS
18773
18774 =item COPYRIGHT
18775
18776 =back
18777
18778 =head2 Text::Abbrev, abbrev - create an abbreviation table from a list
18779
18780 =over 4
18781
18782 =item SYNOPSIS
18783
18784 =item DESCRIPTION
18785
18786 =item EXAMPLE
18787
18788 =back
18789
18790 =head2 Text::Balanced - Extract delimited text sequences from strings.
18791
18792 =over 4
18793
18794 =item SYNOPSIS
18795
18796 =item DESCRIPTION
18797
18798 =over 4
18799
18800 =item General behaviour in list contexts
18801
18802 [0], [1], [2]
18803
18804 =item General behaviour in scalar and void contexts
18805
18806 =item A note about prefixes
18807
18808 =item C<extract_delimited>
18809
18810 =item C<extract_bracketed>
18811
18812 =item C<extract_tagged>
18813
18814 C<reject =E<gt> $listref>, C<ignore =E<gt> $listref>, C<fail =E<gt> $str>,
18815 [0], [1], [2], [3], [4], [5]
18816
18817 =item C<gen_extract_tagged>
18818
18819 =item C<extract_quotelike>
18820
18821 [0], [1], [2], [3], [4], [5], [6], [7], [8], [9], [10]
18822
18823 =item C<extract_quotelike> and "here documents"
18824
18825 [0], [1], [2], [3], [4], [5], [6], [7..10]
18826
18827 =item C<extract_codeblock>
18828
18829 =item C<extract_multiple>
18830
18831 =item C<gen_delimited_pat>
18832
18833 =back
18834
18835 =item DIAGNOSTICS
18836
18837  C<Did not find a suitable bracket: "%s">,  C<Did not find prefix: /%s/>,
18838 C<Did not find opening bracket after prefix: "%s">,  C<No quotelike
18839 operator found after prefix: "%s">,  C<Unmatched closing bracket: "%c">,
18840 C<Unmatched opening bracket(s): "%s">, C<Unmatched embedded quote (%s)>,
18841 C<Did not find closing delimiter to match '%s'>,  C<Mismatched closing
18842 bracket: expected "%c" but found "%s">,  C<No block delimiter found after
18843 quotelike "%s">, C<Did not find leading dereferencer>, C<Bad identifier
18844 after dereferencer>, C<Did not find expected opening bracket at %s>,
18845 C<Improperly nested codeblock at %s>,  C<Missing second block for quotelike
18846 "%s">, C<No match found for opening bracket>, C<Did not find opening tag:
18847 /%s/>, C<Unable to construct closing tag to match: /%s/>, C<Found invalid
18848 nested tag: %s>, C<Found unbalanced nested tag: %s>, C<Did not find closing
18849 tag>
18850
18851 =item AUTHOR
18852
18853 =item BUGS AND IRRITATIONS
18854
18855 =item COPYRIGHT
18856
18857 =back
18858
18859 =head2 Text::ParseWords - parse text into an array of tokens or array of
18860 arrays
18861
18862 =over 4
18863
18864 =item SYNOPSIS
18865
18866 =item DESCRIPTION
18867
18868 =item EXAMPLES
18869
18870 =item AUTHORS
18871
18872 =back
18873
18874 =head2 Text::Soundex - Implementation of the Soundex Algorithm as Described
18875 by Knuth
18876
18877 =over 4
18878
18879 =item SYNOPSIS
18880
18881 =item DESCRIPTION
18882
18883 =item EXAMPLES
18884
18885 =item LIMITATIONS
18886
18887 =item AUTHOR
18888
18889 =back
18890
18891 =head2 Text::Tabs -- expand and unexpand tabs per the unix expand(1) and
18892 unexpand(1)
18893
18894 =over 4
18895
18896 =item SYNOPSIS
18897
18898 =item DESCRIPTION
18899
18900 =item BUGS
18901
18902 =item AUTHOR
18903
18904 =back
18905
18906 =head2 Text::Wrap - line wrapping to form simple paragraphs
18907
18908 =over 4
18909
18910 =item SYNOPSIS
18911
18912 =item DESCRIPTION
18913
18914 =item OVERRIDES
18915
18916 =item EXAMPLE
18917
18918 =item AUTHOR
18919
18920 =back
18921
18922 =head2 Thread - manipulate threads in Perl (for old code only)
18923
18924 =over 4
18925
18926 =item CAVEAT
18927
18928 =item SYNOPSIS
18929
18930 =item DESCRIPTION
18931
18932 =item FUNCTIONS
18933
18934 $thread = Thread->new(\&start_sub), $thread = Thread->new(\&start_sub,
18935 LIST), lock VARIABLE, async BLOCK;, Thread->self, cond_wait VARIABLE,
18936 cond_signal VARIABLE, cond_broadcast VARIABLE, yield
18937
18938 =item METHODS
18939
18940 join, eval, detach, equal, tid, flags, done
18941
18942 =item LIMITATIONS
18943
18944 =item SEE ALSO
18945
18946 =back
18947
18948 =head2 Thread::Queue - thread-safe queues
18949
18950 =over 4
18951
18952 =item SYNOPSIS
18953
18954 =item DESCRIPTION
18955
18956 =item FUNCTIONS AND METHODS
18957
18958 new, enqueue LIST, dequeue, dequeue_nb, pending
18959
18960 =item SEE ALSO
18961
18962 =back
18963
18964 =head2 Thread::Semaphore - thread-safe semaphores
18965
18966 =over 4
18967
18968 =item SYNOPSIS
18969
18970 =item DESCRIPTION
18971
18972 =item FUNCTIONS AND METHODS
18973
18974 new, new NUMBER, down, down NUMBER, up, up NUMBER
18975
18976 =back
18977
18978 =head2 Thread::Signal - Start a thread which runs signal handlers reliably
18979 (for old code)
18980
18981 =over 4
18982
18983 =item CAVEAT
18984
18985 =item SYNOPSIS
18986
18987 =item DESCRIPTION
18988
18989 =item BUGS
18990
18991 =back
18992
18993 =head2 Thread::Specific - thread-specific keys
18994
18995 =over 4
18996
18997 =item SYNOPSIS
18998
18999 =item DESCRIPTION
19000
19001 =back
19002
19003 =head2 Tie::Array - base class for tied arrays
19004
19005 =over 4
19006
19007 =item SYNOPSIS
19008
19009 =item DESCRIPTION
19010
19011 TIEARRAY classname, LIST, STORE this, index, value, FETCH this, index,
19012 FETCHSIZE this, STORESIZE this, count, EXTEND this, count, EXISTS this,
19013 key, DELETE this, key, CLEAR this, DESTROY this, PUSH this, LIST, POP this,
19014 SHIFT this, UNSHIFT this, LIST, SPLICE this, offset, length, LIST
19015
19016 =item CAVEATS
19017
19018 =item AUTHOR
19019
19020 =back
19021
19022 =head2 Tie::File - Access the lines of a disk file via a Perl array
19023
19024 =over 4
19025
19026 =item SYNOPSIS
19027
19028 =item DESCRIPTION
19029
19030 =over 4
19031
19032 =item C<recsep>
19033
19034 =item C<autochomp>
19035
19036 =item C<mode>
19037
19038 =item C<memory>
19039
19040 =item C<dw_size>
19041
19042 =item Option Format
19043
19044 =back
19045
19046 =item Public Methods
19047
19048 =over 4
19049
19050 =item C<flock>
19051
19052 =item C<autochomp>
19053
19054 =item C<defer>, C<flush>, C<discard>, and C<autodefer>
19055
19056 =back
19057
19058 =item Tying to an already-opened filehandle
19059
19060 =item Deferred Writing
19061
19062 =over 4
19063
19064 =item Autodeferring
19065
19066 =back
19067
19068 =item CAVEATS
19069
19070 =item SUBCLASSING
19071
19072 =item WHAT ABOUT C<DB_File>?
19073
19074 =item AUTHOR
19075
19076 =item LICENSE
19077
19078 =item WARRANTY
19079
19080 =item THANKS
19081
19082 =item TODO
19083
19084 =back
19085
19086 =head2 Tie::Handle, Tie::StdHandle  - base class definitions for tied
19087 handles
19088
19089 =over 4
19090
19091 =item SYNOPSIS
19092
19093 =item DESCRIPTION
19094
19095 TIEHANDLE classname, LIST, WRITE this, scalar, length, offset, PRINT this,
19096 LIST, PRINTF this, format, LIST, READ this, scalar, length, offset,
19097 READLINE this, GETC this, CLOSE this, OPEN this, filename, BINMODE this,
19098 EOF this, TELL this, SEEK this, offset, whence, DESTROY this
19099
19100 =item MORE INFORMATION
19101
19102 =item COMPATIBILITY
19103
19104 =back
19105
19106 =head2 Tie::Hash, Tie::StdHash, Tie::ExtraHash - base class definitions for
19107 tied hashes
19108
19109 =over 4
19110
19111 =item SYNOPSIS
19112
19113 =item DESCRIPTION
19114
19115 TIEHASH classname, LIST, STORE this, key, value, FETCH this, key, FIRSTKEY
19116 this, NEXTKEY this, lastkey, EXISTS this, key, DELETE this, key, CLEAR this
19117
19118 =item Inheriting from B<Tie::StdHash>
19119
19120 =item Inheriting from B<Tie::ExtraHash>
19121
19122 =item C<UNTIE> and C<DESTROY>
19123
19124 =item MORE INFORMATION
19125
19126 =back
19127
19128 =head2 Tie::Memoize - add data to hash when needed
19129
19130 =over 4
19131
19132 =item SYNOPSIS
19133
19134 =item DESCRIPTION
19135
19136 =item Inheriting from B<Tie::Memoize>
19137
19138 =item EXAMPLE
19139
19140 =item BUGS
19141
19142 =item AUTHOR
19143
19144 =back
19145
19146 =head2 Tie::RefHash - use references as hash keys
19147
19148 =over 4
19149
19150 =item SYNOPSIS
19151
19152 =item DESCRIPTION
19153
19154 =item EXAMPLE
19155
19156 =item AUTHOR
19157
19158 =item VERSION
19159
19160 =item SEE ALSO
19161
19162 =back
19163
19164 =head2 Tie::Scalar, Tie::StdScalar - base class definitions for tied
19165 scalars
19166
19167 =over 4
19168
19169 =item SYNOPSIS
19170
19171 =item DESCRIPTION
19172
19173 TIESCALAR classname, LIST, FETCH this, STORE this, value, DESTROY this
19174
19175 =item MORE INFORMATION
19176
19177 =back
19178
19179 =head2 Tie::SubstrHash - Fixed-table-size, fixed-key-length hashing
19180
19181 =over 4
19182
19183 =item SYNOPSIS
19184
19185 =item DESCRIPTION
19186
19187 =item CAVEATS
19188
19189 =back
19190
19191 =head2 Time::HiRes - High resolution alarm, sleep, gettimeofday, interval
19192 timers
19193
19194 =over 4
19195
19196 =item SYNOPSIS
19197
19198 =item DESCRIPTION
19199
19200 gettimeofday (), usleep ( $useconds ), ualarm ( $useconds [,
19201 $interval_useconds ] ), tv_interval, time (), sleep ( $floating_seconds ),
19202 alarm ( $floating_seconds [, $interval_floating_seconds ] ), setitimer,
19203 getitimer ( $which )
19204
19205 =item EXAMPLES
19206
19207 =item C API
19208
19209 =item CAVEATS
19210
19211 =item AUTHORS
19212
19213 =item REVISION
19214
19215 =item COPYRIGHT
19216
19217 =back
19218
19219 =head2 Time::Local - efficiently compute time from local and GMT time
19220
19221 =over 4
19222
19223 =item SYNOPSIS
19224
19225 =item DESCRIPTION
19226
19227 =item IMPLEMENTATION
19228
19229 =item BUGS
19230
19231 =back
19232
19233 =head2 Time::gmtime - by-name interface to Perl's built-in gmtime()
19234 function
19235
19236 =over 4
19237
19238 =item SYNOPSIS
19239
19240 =item DESCRIPTION
19241
19242 =item NOTE
19243
19244 =item AUTHOR
19245
19246 =back
19247
19248 =head2 Time::localtime - by-name interface to Perl's built-in localtime()
19249 function
19250
19251 =over 4
19252
19253 =item SYNOPSIS
19254
19255 =item DESCRIPTION
19256
19257 =item NOTE
19258
19259 =item AUTHOR
19260
19261 =back
19262
19263 =head2 Time::tm - internal object used by Time::gmtime and Time::localtime
19264
19265 =over 4
19266
19267 =item SYNOPSIS
19268
19269 =item DESCRIPTION
19270
19271 =item AUTHOR
19272
19273 =back
19274
19275 =head2 UNIVERSAL - base class for ALL classes (blessed references)
19276
19277 =over 4
19278
19279 =item SYNOPSIS
19280
19281 =item DESCRIPTION
19282
19283 $obj->isa( TYPE ), CLASS->isa( TYPE ), isa( VAL, TYPE ), $obj->can( METHOD
19284 ), CLASS->can( METHOD ), can( VAL, METHOD ), VERSION ( [ REQUIRE ] )
19285
19286 =back
19287
19288 =head2 Unicode::Collate - Unicode Collation Algorithm
19289
19290 =over 4
19291
19292 =item SYNOPSIS
19293
19294 =item DESCRIPTION
19295
19296 =over 4
19297
19298 =item Constructor and Tailoring
19299
19300 alternate, backwards, entry, ignoreName, ignoreChar, level, normalization,
19301 overrideCJK, overrideHangul, preprocess, rearrange, table, undefName,
19302 undefChar, katakana_before_hiragana, upper_before_lower
19303
19304 =item Methods for Collation
19305
19306 C<@sorted = $Collator-E<gt>sort(@not_sorted)>, C<$result =
19307 $Collator-E<gt>cmp($a, $b)>, C<$result = $Collator-E<gt>eq($a, $b)>,
19308 C<$result = $Collator-E<gt>ne($a, $b)>, C<$result = $Collator-E<gt>lt($a,
19309 $b)>, C<$result = $Collator-E<gt>le($a, $b)>, C<$result =
19310 $Collator-E<gt>gt($a, $b)>, C<$result = $Collator-E<gt>ge($a, $b)>,
19311 C<$sortKey = $Collator-E<gt>getSortKey($string)>, C<$sortKeyForm =
19312 $Collator-E<gt>viewSortKey($string)>, C<$position =
19313 $Collator-E<gt>index($string, $substring)>, C<($position, $length) =
19314 $Collator-E<gt>index($string, $substring)>
19315
19316 =item Other Methods
19317
19318 UCA_Version, Base_Unicode_Version
19319
19320 =item EXPORT
19321
19322 =item TODO
19323
19324 =item CAVEAT
19325
19326 =item BUGS
19327
19328 =back
19329
19330 =item AUTHOR
19331
19332 =item SEE ALSO
19333
19334 http://www.unicode.org/unicode/reports/tr10/,
19335 http://www.unicode.org/unicode/reports/tr10/allkeys.txt,
19336 http://www.unicode.org/unicode/reports/tr15/,
19337 http://www.unicode.org/unicode/reports/tr18, L<Unicode::Normalize>
19338
19339 =back
19340
19341 =head2 Unicode::Normalize - Unicode Normalization Forms
19342
19343 =over 4
19344
19345 =item SYNOPSIS
19346
19347 =item DESCRIPTION
19348
19349 =over 4
19350
19351 =item Normalization Forms
19352
19353 C<$NFD_string = NFD($string)>, C<$NFC_string = NFC($string)>,
19354 C<$NFKD_string = NFKD($string)>, C<$NFKC_string = NFKC($string)>,
19355 C<$normalized_string = normalize($form_name, $string)>
19356
19357 =item Decomposition and Composition
19358
19359 C<$decomposed_string = decompose($string)>, C<$decomposed_string =
19360 decompose($string, $useCompatMapping)>, C<$reordered_string  =
19361 reorder($string)>, C<$composed_string   = compose($string)>
19362
19363 =item Quick Check
19364
19365 C<$result = checkNFD($string)>, C<$result = checkNFC($string)>, C<$result =
19366 checkNFKD($string)>, C<$result = checkNFKC($string)>, C<$result =
19367 check($form_name, $string)>
19368
19369 =item Character Data
19370
19371 C<$canonical_decomposed = getCanon($codepoint)>,
19372 C<$compatibility_decomposed = getCompat($codepoint)>,
19373 C<$codepoint_composite = getComposite($codepoint_here, $codepoint_next)>,
19374 C<$combining_class = getCombinClass($codepoint)>, C<$is_exclusion =
19375 isExclusion($codepoint)>, C<$is_singleton = isSingleton($codepoint)>,
19376 C<$is_non_startar_decomposition = isNonStDecomp($codepoint)>,
19377 C<$may_be_composed_with_prev_char = isComp2nd($codepoint)>
19378
19379 =item EXPORT
19380
19381 =back
19382
19383 =item AUTHOR
19384
19385 =item SEE ALSO
19386
19387 http://www.unicode.org/unicode/reports/tr15/,
19388 http://www.unicode.org/Public/UNIDATA/DerivedNormalizationProps.txt
19389
19390 =back
19391
19392 =head2 Unicode::UCD - Unicode character database
19393
19394 =over 4
19395
19396 =item SYNOPSIS
19397
19398 =item DESCRIPTION
19399
19400 =back
19401
19402 =over 4
19403
19404 =item charinfo
19405
19406 =back
19407
19408 =over 4
19409
19410 =item charblock
19411
19412 =back
19413
19414 =over 4
19415
19416 =item charscript
19417
19418 =back
19419
19420 =over 4
19421
19422 =item charblocks
19423
19424 =back
19425
19426 =over 4
19427
19428 =item charscripts
19429
19430 =back
19431
19432 =over 4
19433
19434 =item Blocks versus Scripts
19435
19436 =item Matching Scripts and Blocks
19437
19438 =item Code Point Arguments
19439
19440 =item charinrange
19441
19442 =back
19443
19444 =over 4
19445
19446 =item compexcl
19447
19448 =back
19449
19450 =over 4
19451
19452 =item casefold
19453
19454 =back
19455
19456 =over 4
19457
19458 =item casespec
19459
19460 =back
19461
19462 =over 4
19463
19464 =item Unicode::UCD::UnicodeVersion
19465
19466 =back
19467
19468 =over 4
19469
19470 =item Implementation Note
19471
19472 =back
19473
19474 =over 4
19475
19476 =item BUGS
19477
19478 =item AUTHOR
19479
19480 =back
19481
19482 =head2 User::grent - by-name interface to Perl's built-in getgr*()
19483 functions
19484
19485 =over 4
19486
19487 =item SYNOPSIS
19488
19489 =item DESCRIPTION
19490
19491 =item NOTE
19492
19493 =item AUTHOR
19494
19495 =back
19496
19497 =head2 User::pwent - by-name interface to Perl's built-in getpw*()
19498 functions
19499
19500 =over 4
19501
19502 =item SYNOPSIS
19503
19504 =item DESCRIPTION
19505
19506 =over 4
19507
19508 =item System Specifics
19509
19510 =back
19511
19512 =item NOTE
19513
19514 =item AUTHOR
19515
19516 =item HISTORY
19517
19518 March 18th, 2000
19519
19520 =back
19521
19522 =head2 Win32 - Interfaces to some Win32 API Functions
19523
19524 =over 4
19525
19526 =item DESCRIPTION
19527
19528 =over 4
19529
19530 =item Alphabetical Listing of Win32 Functions
19531
19532 Win32::AbortSystemShutdown(MACHINE), Win32::BuildNumber(),
19533 Win32::CopyFile(FROM, TO, OVERWRITE), Win32::DomainName(),
19534 Win32::ExpandEnvironmentStrings(STRING), Win32::FormatMessage(ERRORCODE),
19535 Win32::FsType(), Win32::FreeLibrary(HANDLE), Win32::GetArchName(),
19536 Win32::GetChipName(), Win32::GetCwd(), Win32::GetFullPathName(FILENAME),
19537 Win32::GetLastError(), Win32::GetLongPathName(PATHNAME),
19538 Win32::GetNextAvailDrive(), Win32::GetOSVersion(), Win32::GetOSName(),
19539 Win32::GetShortPathName(PATHNAME), Win32::GetProcAddress(INSTANCE,
19540 PROCNAME), Win32::GetTickCount(), Win32::InitiateSystemShutdown,
19541 Win32::IsWinNT(), Win32::IsWin95(), Win32::LoadLibrary(LIBNAME),
19542 Win32::LoginName(), Win32::LookupAccountName(SYSTEM, ACCOUNT, DOMAIN, SID,
19543 SIDTYPE), Win32::LookupAccountSID(SYSTEM, SID, ACCOUNT, DOMAIN, SIDTYPE),
19544 Win32::MsgBox(MESSAGE [, FLAGS [, TITLE]]), Win32::NodeName(),
19545 Win32::RegisterServer(LIBRARYNAME), Win32::SetChildShowWindow(SHOWWINDOW),
19546 Win32::SetCwd(NEWDIRECTORY), Win32::SetLastError(ERROR),
19547 Win32::Sleep(TIME), Win32::Spawn(COMMAND, ARGS, PID),
19548 Win32::UnregisterServer(LIBRARYNAME)
19549
19550 =back
19551
19552 =back
19553
19554 =head2 XSLoader - Dynamically load C libraries into Perl code
19555
19556 =over 4
19557
19558 =item SYNOPSIS
19559
19560 =item DESCRIPTION
19561
19562 =item AUTHOR
19563
19564 =back
19565
19566 =head1 AUXILIARY DOCUMENTATION
19567
19568 Here should be listed all the extra programs' documentation, but they
19569 don't all have manual pages yet:
19570
19571 =over 4
19572
19573 =item a2p
19574
19575 =item s2p
19576
19577 =item find2perl
19578
19579 =item h2ph
19580
19581 =item c2ph
19582
19583 =item h2xs
19584
19585 =item xsubpp
19586
19587 =item pod2man
19588
19589 =item wrapsuid
19590
19591 =back
19592
19593 =head1 AUTHOR
19594
19595 Larry Wall <F<larry@wall.org>>, with the help of oodles
19596 of other folks.
19597