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 glob() now returns filenames in alphabetical order
5299
5300 =item Deprecations
5301
5302 =back
5303
5304 =item Core Enhancements
5305
5306 =over 4
5307
5308 =item Unicode Overhaul
5309
5310 =item PerlIO is Now The Default
5311
5312 =item ithreads
5313
5314 =item Restricted Hashes
5315
5316 =item Safe Signals
5317
5318 =item Understanding of Numbers
5319
5320 =item Arrays now always interpolate into double-quoted strings [561]
5321
5322 =item Miscellaneous Changes
5323
5324 =back
5325
5326 =item Modules and Pragmata
5327
5328 =over 4
5329
5330 =item New Modules and Pragmata
5331
5332 =item Updated And Improved Modules and Pragmata
5333
5334 =back
5335
5336 =item Utility Changes
5337
5338 =item New Documentation
5339
5340 =item Performance Enhancements
5341
5342 =item Installation and Configuration Improvements
5343
5344 =over 4
5345
5346 =item Generic Improvements
5347
5348 =item New Or Improved Platforms
5349
5350 =back
5351
5352 =item Selected Bug Fixes
5353
5354 =over 4
5355
5356 =item Platform Specific Changes and Fixes
5357
5358 =back
5359
5360 =item New or Changed Diagnostics
5361
5362 =item Changed Internals
5363
5364 =item Security Vulnerability Closed [561]
5365
5366 =item New Tests
5367
5368 =item Known Problems
5369
5370 =over 4
5371
5372 =item AIX
5373
5374 =item Alpha systems with old gccs fail several tests
5375
5376 =item AmigaOS
5377
5378 =item BeOS
5379
5380 =item Cygwin "unable to remap"
5381
5382 =item Cygwin ndbm tests fail on FAT
5383
5384 =item DJGPP does not build
5385
5386 =item ext/threads/t/libc
5387
5388 =item FreeBSD built with ithreads coredumps reading large directories
5389
5390 =item FreeBSD Failing locale Test 117 For ISO 8859-15 Locales
5391
5392 =item IRIX fails ext/List/Util/t/shuffle.t
5393
5394 =item Modifying $_ Inside for(..)
5395
5396 =item mod_perl 1.26 Doesn't Build With Threaded Perl
5397
5398 =item lib/ftmp-security tests warn 'system possibly insecure'
5399
5400 =item HP-UX lib/posix Subtest 9 Fails When LP64-Configured
5401
5402 =item Linux with glibc 2.2.5 fails t/op/int subtest #6 with -Duse64bitint
5403
5404 =item Linux With Sfio Fails op/misc Test 48
5405
5406 =item libwww-perl (LWP) fails base/date #51
5407
5408 =item Mac OS X
5409
5410 =item OS/2 Test Failures
5411
5412 =item op/sprintf tests 91, 129, and 130
5413
5414 =item Solaris 2.5
5415
5416 =item Solaris x86 Fails Tests With -Duse64bitint
5417
5418 =item SUPER-UX (NEC SX)
5419
5420 =item PDL failing some tests
5421
5422 =item Perl_get_sv
5423
5424 =item Term::ReadKey not working on Win32
5425
5426 =item Failure of Thread (5.005-style) tests
5427
5428 =item Timing problems
5429
5430 =item Unicode in package/class and subroutine names does not work
5431
5432 =item UNICOS/mk
5433
5434 =item UTS
5435
5436 =item VOS (Stratus)
5437
5438 =item VMS
5439
5440 =item Win32
5441
5442 =item XML::Parser not working
5443
5444 =item z/OS (OS/390)
5445
5446 =item Localising Tied Arrays and Hashes Is Broken
5447
5448 =item Self-tying Problems
5449
5450 =item Tied/Magical Array/Hash Elements Do Not Autovivify
5451
5452 =item Building Extensions Can Fail Because Of Largefiles
5453
5454 =item Unicode Support on EBCDIC Still Spotty
5455
5456 =item The Compiler Suite Is Still Very Experimental
5457
5458 =item Seen In Perl 5.7 But Gone Now
5459
5460 =back
5461
5462 =item Reporting Bugs
5463
5464 =item SEE ALSO
5465
5466 =item HISTORY
5467
5468 =back
5469
5470 =head2 perl572delta - what's new for perl v5.7.2
5471
5472 =over 4
5473
5474 =item DESCRIPTION
5475
5476 =item Security Vulnerability Closed
5477
5478 =item Incompatible Changes
5479
5480 =over 4
5481
5482 =item 64-bit platforms and malloc
5483
5484 =item AIX Dynaloading
5485
5486 =item Socket Extension Dynamic in VMS
5487
5488 =item Different Definition of the Unicode Character Classes \p{In...}
5489
5490 =item Deprecations
5491
5492 =back
5493
5494 =item Core Enhancements
5495
5496 =item Modules and Pragmata
5497
5498 =over 4
5499
5500 =item New Modules and Distributions
5501
5502 =item Updated And Improved Modules and Pragmata
5503
5504 =back
5505
5506 =item Utility Changes
5507
5508 =item New Documentation
5509
5510 =item Installation and Configuration Improvements
5511
5512 =over 4
5513
5514 =item New Or Improved Platforms
5515
5516 =item Generic Improvements
5517
5518 =back
5519
5520 =item Selected Bug Fixes
5521
5522 =over 4
5523
5524 =item Platform Specific Changes and Fixes
5525
5526 =back
5527
5528 =item New or Changed Diagnostics
5529
5530 =item Source Code Enhancements
5531
5532 =over 4
5533
5534 =item MAGIC constants
5535
5536 =item Better commented code
5537
5538 =item Regex pre-/post-compilation items matched up
5539
5540 =item gcc -Wall
5541
5542 =back
5543
5544 =item New Tests
5545
5546 =item Known Problems
5547
5548 =over 4
5549
5550 =item AIX
5551
5552 =item Amiga Perl Invoking Mystery
5553
5554 =item lib/ftmp-security tests warn 'system possibly insecure'
5555
5556 =item Cygwin intermittent failures of lib/Memoize/t/expire_file 11 and 12
5557
5558 =item HP-UX lib/io_multihomed Fails When LP64-Configured
5559
5560 =item  HP-UX lib/posix Subtest 9 Fails When LP64-Configured
5561
5562 =item Linux With Sfio Fails op/misc Test 48
5563
5564 =item OS/390
5565
5566 =item op/sprintf tests 129 and 130
5567
5568 =item  Failure of Thread tests
5569
5570 =item UNICOS
5571
5572 =item UTS
5573
5574 =item VMS
5575
5576 =item Win32
5577
5578 =item Localising a Tied Variable Leaks Memory
5579
5580 =item Self-tying of Arrays and Hashes Is Forbidden
5581
5582 =item Variable Attributes are not Currently Usable for Tieing
5583
5584 =item Building Extensions Can Fail Because Of Largefiles
5585
5586 =item The Compiler Suite Is Still Experimental
5587
5588 =item The Long Double Support is Still Experimental
5589
5590 =back
5591
5592 =item Reporting Bugs
5593
5594 =item SEE ALSO
5595
5596 =item HISTORY
5597
5598 =back
5599
5600 =head2 perl571delta - what's new for perl v5.7.1
5601
5602 =over 4
5603
5604 =item DESCRIPTION
5605
5606 =item Security Vulnerability Closed
5607
5608 =item Incompatible Changes
5609
5610 =item Core Enhancements
5611
5612 =over 4
5613
5614 =item AUTOLOAD Is Now Lvaluable
5615
5616 =item PerlIO is Now The Default
5617
5618 =item Signals Are Now Safe
5619
5620 =back
5621
5622 =item Modules and Pragmata
5623
5624 =over 4
5625
5626 =item New Modules
5627
5628 =item Updated And Improved Modules and Pragmata
5629
5630 =back
5631
5632 =item Performance Enhancements
5633
5634 =item Utility Changes
5635
5636 =item New Documentation
5637
5638 =over 4
5639
5640 =item perlclib
5641
5642 =item perliol
5643
5644 =item README.aix
5645
5646 =item README.bs2000
5647
5648 =item README.macos
5649
5650 =item README.mpeix
5651
5652 =item README.solaris
5653
5654 =item README.vos
5655
5656 =item Porting/repository.pod
5657
5658 =back
5659
5660 =item Installation and Configuration Improvements
5661
5662 =over 4
5663
5664 =item New Or Improved Platforms
5665
5666 =item Generic Improvements
5667
5668 d_cmsghdr, d_fcntl_can_lock, d_fsync, d_getitimer, d_getpagsz, d_msghdr_s,
5669 need_va_copy, d_readv, d_recvmsg, d_sendmsg, sig_size, d_sockatmark,
5670 d_strtoq, d_u32align, d_ualarm, d_usleep
5671
5672 =back
5673
5674 =item Selected Bug Fixes
5675
5676 =over 4
5677
5678 =item Platform Specific Changes and Fixes
5679
5680 =back
5681
5682 =item New or Changed Diagnostics
5683
5684 =item Changed Internals
5685
5686 =item New Tests
5687
5688 =item Known Problems
5689
5690 =over 4
5691
5692 =item AIX vac 5.0.0.0 May Produce Buggy Code For Perl
5693
5694 =item lib/ftmp-security tests warn 'system possibly insecure'
5695
5696 =item lib/io_multihomed Fails In LP64-Configured HP-UX
5697
5698 =item Test lib/posix Subtest 9 Fails In LP64-Configured HP-UX
5699
5700 =item lib/b test 19
5701
5702 =item Linux With Sfio Fails op/misc Test 48
5703
5704 =item sigaction test 13 in VMS
5705
5706 =item sprintf tests 129 and 130
5707
5708 =item  Failure of Thread tests
5709
5710 =item Localising a Tied Variable Leaks Memory
5711
5712 =item Self-tying of Arrays and Hashes Is Forbidden
5713
5714 =item Building Extensions Can Fail Because Of Largefiles
5715
5716 =item The Compiler Suite Is Still Experimental
5717
5718 =back
5719
5720 =item Reporting Bugs
5721
5722 =item SEE ALSO
5723
5724 =item HISTORY
5725
5726 =back
5727
5728 =head2 perl570delta - what's new for perl v5.7.0
5729
5730 =over 4
5731
5732 =item DESCRIPTION
5733
5734 =item Security Vulnerability Closed
5735
5736 =item Incompatible Changes
5737
5738 =item Core Enhancements
5739
5740 =item Modules and Pragmata
5741
5742 =over 4
5743
5744 =item New Modules
5745
5746 =item Updated And Improved Modules and Pragmata
5747
5748 =back
5749
5750 =item Utility Changes
5751
5752 =item New Documentation
5753
5754 =item Performance Enhancements
5755
5756 =item Installation and Configuration Improvements
5757
5758 =over 4
5759
5760 =item Generic Improvements
5761
5762 =back
5763
5764 =item Selected Bug Fixes
5765
5766 =over 4
5767
5768 =item Platform Specific Changes and Fixes
5769
5770 =back
5771
5772 =item New or Changed Diagnostics
5773
5774 =item Changed Internals
5775
5776 =item Known Problems
5777
5778 =over 4
5779
5780 =item Unicode Support Still Far From Perfect
5781
5782 =item EBCDIC Still A Lost Platform
5783
5784 =item Building Extensions Can Fail Because Of Largefiles
5785
5786 =item ftmp-security tests warn 'system possibly insecure'
5787
5788 =item Test lib/posix Subtest 9 Fails In LP64-Configured HP-UX
5789
5790 =item Long Doubles Still Don't Work In Solaris
5791
5792 =item Linux With Sfio Fails op/misc Test 48
5793
5794 =item Storable tests fail in some platforms
5795
5796 =item Threads Are Still Experimental
5797
5798 =item The Compiler Suite Is Still Experimental
5799
5800 =back
5801
5802 =item Reporting Bugs
5803
5804 =item SEE ALSO
5805
5806 =item HISTORY
5807
5808 =back
5809
5810 =head2 perl561delta - what's new for perl v5.6.x
5811
5812 =over 4
5813
5814 =item DESCRIPTION
5815
5816 =item Summary of changes between 5.6.0 and 5.6.1
5817
5818 =over 4
5819
5820 =item Security Issues
5821
5822 =item Core bug fixes
5823
5824 C<UNIVERSAL::isa()>, Memory leaks, Numeric conversions, qw(a\\b), caller(),
5825 Bugs in regular expressions, "slurp" mode, Autovivification of symbolic
5826 references to special variables, Lexical warnings, Spurious warnings and
5827 errors, glob(), Tainting, sort(), #line directives, Subroutine prototypes,
5828 map(), Debugger, PERL5OPT, chop(), Unicode support, 64-bit support,
5829 Compiler, Lvalue subroutines, IO::Socket, File::Find, xsubpp, C<no
5830 Module;>, Tests
5831
5832 =item Core features
5833
5834 =item Configuration issues
5835
5836 =item Documentation
5837
5838 =item Bundled modules
5839
5840 B::Concise, File::Temp, Pod::LaTeX, Pod::Text::Overstrike, CGI, CPAN,
5841 Class::Struct, DB_File, Devel::Peek, File::Find, Getopt::Long, IO::Poll,
5842 IPC::Open3, Math::BigFloat, Math::Complex, Net::Ping, Opcode, Pod::Parser,
5843 Pod::Text, SDBM_File, Sys::Syslog, Tie::RefHash, Tie::SubstrHash
5844
5845 =item Platform-specific improvements
5846
5847 NCR MP-RAS, NonStop-UX
5848
5849 =back
5850
5851 =item Core Enhancements
5852
5853 =over 4
5854
5855 =item Interpreter cloning, threads, and concurrency
5856
5857 =item Lexically scoped warning categories
5858
5859 =item Unicode and UTF-8 support
5860
5861 =item Support for interpolating named characters
5862
5863 =item "our" declarations
5864
5865 =item Support for strings represented as a vector of ordinals
5866
5867 =item Improved Perl version numbering system
5868
5869 =item New syntax for declaring subroutine attributes
5870
5871 =item File and directory handles can be autovivified
5872
5873 =item open() with more than two arguments
5874
5875 =item 64-bit support
5876
5877 =item Large file support
5878
5879 =item Long doubles
5880
5881 =item "more bits"
5882
5883 =item Enhanced support for sort() subroutines
5884
5885 =item C<sort $coderef @foo> allowed
5886
5887 =item File globbing implemented internally
5888
5889 =item Support for CHECK blocks
5890
5891 =item POSIX character class syntax [: :] supported
5892
5893 =item Better pseudo-random number generator
5894
5895 =item Improved C<qw//> operator
5896
5897 =item Better worst-case behavior of hashes
5898
5899 =item pack() format 'Z' supported
5900
5901 =item pack() format modifier '!' supported
5902
5903 =item pack() and unpack() support counted strings
5904
5905 =item Comments in pack() templates
5906
5907 =item Weak references
5908
5909 =item Binary numbers supported
5910
5911 =item Lvalue subroutines
5912
5913 =item Some arrows may be omitted in calls through references
5914
5915 =item Boolean assignment operators are legal lvalues
5916
5917 =item exists() is supported on subroutine names
5918
5919 =item exists() and delete() are supported on array elements
5920
5921 =item Pseudo-hashes work better
5922
5923 =item Automatic flushing of output buffers
5924
5925 =item Better diagnostics on meaningless filehandle operations
5926
5927 =item Where possible, buffered data discarded from duped input filehandle
5928
5929 =item eof() has the same old magic as <>
5930
5931 =item binmode() can be used to set :crlf and :raw modes
5932
5933 =item C<-T> filetest recognizes UTF-8 encoded files as "text"
5934
5935 =item system(), backticks and pipe open now reflect exec() failure
5936
5937 =item Improved diagnostics
5938
5939 =item Diagnostics follow STDERR
5940
5941 =item More consistent close-on-exec behavior
5942
5943 =item syswrite() ease-of-use
5944
5945 =item Better syntax checks on parenthesized unary operators
5946
5947 =item Bit operators support full native integer width
5948
5949 =item Improved security features
5950
5951 =item More functional bareword prototype (*)
5952
5953 =item C<require> and C<do> may be overridden
5954
5955 =item $^X variables may now have names longer than one character
5956
5957 =item New variable $^C reflects C<-c> switch
5958
5959 =item New variable $^V contains Perl version as a string
5960
5961 =item Optional Y2K warnings
5962
5963 =item Arrays now always interpolate into double-quoted strings
5964
5965 =back
5966
5967 =item Modules and Pragmata
5968
5969 =over 4
5970
5971 =item Modules
5972
5973 attributes, B, Benchmark, ByteLoader, constant, charnames, Data::Dumper,
5974 DB, DB_File, Devel::DProf, Devel::Peek, Dumpvalue, DynaLoader, English,
5975 Env, Fcntl, File::Compare, File::Find, File::Glob, File::Spec,
5976 File::Spec::Functions, Getopt::Long, IO, JPL, lib, Math::BigInt,
5977 Math::Complex, Math::Trig, Pod::Parser, Pod::InputObjects, Pod::Checker,
5978 podchecker, Pod::ParseUtils, Pod::Find, Pod::Select, podselect, Pod::Usage,
5979 pod2usage, Pod::Text and Pod::Man, SDBM_File, Sys::Syslog, Sys::Hostname,
5980 Term::ANSIColor, Time::Local, Win32, XSLoader, DBM Filters
5981
5982 =item Pragmata
5983
5984 =back
5985
5986 =item Utility Changes
5987
5988 =over 4
5989
5990 =item dprofpp
5991
5992 =item find2perl
5993
5994 =item h2xs
5995
5996 =item perlcc
5997
5998 =item perldoc
5999
6000 =item The Perl Debugger
6001
6002 =back
6003
6004 =item Improved Documentation
6005
6006 perlapi.pod, perlboot.pod, perlcompile.pod, perldbmfilter.pod,
6007 perldebug.pod, perldebguts.pod, perlfork.pod, perlfilter.pod, perlhack.pod,
6008 perlintern.pod, perllexwarn.pod, perlnumber.pod, perlopentut.pod,
6009 perlreftut.pod, perltootc.pod, perltodo.pod, perlunicode.pod
6010
6011 =item Performance enhancements
6012
6013 =over 4
6014
6015 =item Simple sort() using { $a <=> $b } and the like are optimized
6016
6017 =item Optimized assignments to lexical variables
6018
6019 =item Faster subroutine calls
6020
6021 =item delete(), each(), values() and hash iteration are faster
6022
6023 =back
6024
6025 =item Installation and Configuration Improvements
6026
6027 =over 4
6028
6029 =item -Dusethreads means something different
6030
6031 =item New Configure flags
6032
6033 =item Threadedness and 64-bitness now more daring
6034
6035 =item Long Doubles
6036
6037 =item -Dusemorebits
6038
6039 =item -Duselargefiles
6040
6041 =item installusrbinperl
6042
6043 =item SOCKS support
6044
6045 =item C<-A> flag
6046
6047 =item Enhanced Installation Directories
6048
6049 =item gcc automatically tried if 'cc' does not seem to be working
6050
6051 =back
6052
6053 =item Platform specific changes
6054
6055 =over 4
6056
6057 =item Supported platforms
6058
6059 =item DOS
6060
6061 =item OS390 (OpenEdition MVS)
6062
6063 =item VMS
6064
6065 =item Win32
6066
6067 =back
6068
6069 =item Significant bug fixes
6070
6071 =over 4
6072
6073 =item <HANDLE> on empty files
6074
6075 =item C<eval '...'> improvements
6076
6077 =item All compilation errors are true errors
6078
6079 =item Implicitly closed filehandles are safer
6080
6081 =item Behavior of list slices is more consistent
6082
6083 =item C<(\$)> prototype and C<$foo{a}>
6084
6085 =item C<goto &sub> and AUTOLOAD
6086
6087 =item C<-bareword> allowed under C<use integer>
6088
6089 =item Failures in DESTROY()
6090
6091 =item Locale bugs fixed
6092
6093 =item Memory leaks
6094
6095 =item Spurious subroutine stubs after failed subroutine calls
6096
6097 =item Taint failures under C<-U>
6098
6099 =item END blocks and the C<-c> switch
6100
6101 =item Potential to leak DATA filehandles
6102
6103 =back
6104
6105 =item New or Changed Diagnostics
6106
6107 "%s" variable %s masks earlier declaration in same %s, "my sub" not yet
6108 implemented, "our" variable %s redeclared, '!' allowed only after types %s,
6109 / cannot take a count, / must be followed by a, A or Z, / must be followed
6110 by a*, A* or Z*, / must follow a numeric type, /%s/: Unrecognized escape
6111 \\%c passed through, /%s/: Unrecognized escape \\%c in character class
6112 passed through, /%s/ should probably be written as "%s", %s() called too
6113 early to check prototype, %s argument is not a HASH or ARRAY element, %s
6114 argument is not a HASH or ARRAY element or slice, %s argument is not a
6115 subroutine name, %s package attribute may clash with future reserved word:
6116 %s, (in cleanup) %s, <> should be quotes, Attempt to join self, Bad evalled
6117 substitution pattern, Bad realloc() ignored, Bareword found in conditional,
6118 Binary number > 0b11111111111111111111111111111111 non-portable, Bit vector
6119 size > 32 non-portable, Buffer overflow in prime_env_iter: %s, Can't check
6120 filesystem of script "%s", Can't declare class for non-scalar %s in "%s",
6121 Can't declare %s in "%s", Can't ignore signal CHLD, forcing to default,
6122 Can't modify non-lvalue subroutine call, Can't read CRTL environ, Can't
6123 remove %s: %s, skipping file, Can't return %s from lvalue subroutine, Can't
6124 weaken a nonreference, Character class [:%s:] unknown, Character class
6125 syntax [%s] belongs inside character classes, Constant is not %s reference,
6126 constant(%s): %s, CORE::%s is not a keyword, defined(@array) is deprecated,
6127 defined(%hash) is deprecated, Did not produce a valid header, (Did you mean
6128 "local" instead of "our"?), Document contains no data, entering effective
6129 %s failed, false [] range "%s" in regexp, Filehandle %s opened only for
6130 output, flock() on closed filehandle %s, Global symbol "%s" requires
6131 explicit package name, Hexadecimal number > 0xffffffff non-portable,
6132 Ill-formed CRTL environ value "%s", Ill-formed message in prime_env_iter:
6133 |%s|, Illegal binary digit %s, Illegal binary digit %s ignored, Illegal
6134 number of bits in vec, Integer overflow in %s number, Invalid %s attribute:
6135 %s, Invalid %s attributes: %s, invalid [] range "%s" in regexp, Invalid
6136 separator character %s in attribute list, Invalid separator character %s in
6137 subroutine attribute list, leaving effective %s failed, Lvalue subs
6138 returning %s not implemented yet, Method %s not permitted, Missing
6139 %sbrace%s on \N{}, Missing command in piped open, Missing name in "my sub",
6140 No %s specified for -%c, No package name allowed for variable %s in "our",
6141 No space allowed after -%c, no UTC offset information; assuming local time
6142 is UTC, Octal number > 037777777777 non-portable, panic: del_backref,
6143 panic: kid popen errno read, panic: magic_killbackrefs, Parentheses missing
6144 around "%s" list, Possible unintended interpolation of %s in string,
6145 Possible Y2K bug: %s, pragma "attrs" is deprecated, use "sub NAME : ATTRS"
6146 instead, Premature end of script headers, Repeat count in pack overflows,
6147 Repeat count in unpack overflows, realloc() of freed memory ignored,
6148 Reference is already weak, setpgrp can't take arguments, Strange *+?{} on
6149 zero-length expression, switching effective %s is not implemented, This
6150 Perl can't reset CRTL environ elements (%s), This Perl can't set CRTL
6151 environ elements (%s=%s), Too late to run %s block, Unknown open() mode
6152 '%s', Unknown process %x sent message to prime_env_iter: %s, Unrecognized
6153 escape \\%c passed through, Unterminated attribute parameter in attribute
6154 list, Unterminated attribute list, Unterminated attribute parameter in
6155 subroutine attribute list, Unterminated subroutine attribute list, Value of
6156 CLI symbol "%s" too long, Version number must be a constant number
6157
6158 =item New tests
6159
6160 =item Incompatible Changes
6161
6162 =over 4
6163
6164 =item Perl Source Incompatibilities
6165
6166 CHECK is a new keyword, Treatment of list slices of undef has changed,
6167 Format of $English::PERL_VERSION is different, Literals of the form
6168 C<1.2.3> parse differently, Possibly changed pseudo-random number
6169 generator, Hashing function for hash keys has changed, C<undef> fails on
6170 read only values, Close-on-exec bit may be set on pipe and socket handles,
6171 Writing C<"$$1"> to mean C<"${$}1"> is unsupported, delete(), each(),
6172 values() and C<\(%h)>, vec(EXPR,OFFSET,BITS) enforces powers-of-two BITS,
6173 Text of some diagnostic output has changed, C<%@> has been removed,
6174 Parenthesized not() behaves like a list operator, Semantics of bareword
6175 prototype C<(*)> have changed, Semantics of bit operators may have changed
6176 on 64-bit platforms, More builtins taint their results
6177
6178 =item C Source Incompatibilities
6179
6180 C<PERL_POLLUTE>, C<PERL_IMPLICIT_CONTEXT>, C<PERL_POLLUTE_MALLOC>
6181
6182 =item Compatible C Source API Changes
6183
6184 C<PATCHLEVEL> is now C<PERL_VERSION>
6185
6186 =item Binary Incompatibilities
6187
6188 =back
6189
6190 =item Known Problems
6191
6192 =over 4
6193
6194 =item Localizing a tied hash element may leak memory
6195
6196 =item Known test failures
6197
6198 =item EBCDIC platforms not fully supported
6199
6200 =item UNICOS/mk CC failures during Configure run
6201
6202 =item Arrow operator and arrays
6203
6204 =item Experimental features
6205
6206 Threads, Unicode, 64-bit support, Lvalue subroutines, Weak references, The
6207 pseudo-hash data type, The Compiler suite, Internal implementation of file
6208 globbing, The DB module, The regular expression code constructs:
6209
6210 =back
6211
6212 =item Obsolete Diagnostics
6213
6214 Character class syntax [: :] is reserved for future extensions, Ill-formed
6215 logical name |%s| in prime_env_iter, In string, @%s now must be written as
6216 \@%s, Probable precedence problem on %s, regexp too big, Use of "$$<digit>"
6217 to mean "${$}<digit>" is deprecated
6218
6219 =item Reporting Bugs
6220
6221 =item SEE ALSO
6222
6223 =item HISTORY
6224
6225 =back
6226
6227 =head2 perl56delta - what's new for perl v5.6.0
6228
6229 =over 4
6230
6231 =item DESCRIPTION
6232
6233 =item Core Enhancements
6234
6235 =over 4
6236
6237 =item Interpreter cloning, threads, and concurrency
6238
6239 =item Lexically scoped warning categories
6240
6241 =item Unicode and UTF-8 support
6242
6243 =item Support for interpolating named characters
6244
6245 =item "our" declarations
6246
6247 =item Support for strings represented as a vector of ordinals
6248
6249 =item Improved Perl version numbering system
6250
6251 =item New syntax for declaring subroutine attributes
6252
6253 =item File and directory handles can be autovivified
6254
6255 =item open() with more than two arguments
6256
6257 =item 64-bit support
6258
6259 =item Large file support
6260
6261 =item Long doubles
6262
6263 =item "more bits"
6264
6265 =item Enhanced support for sort() subroutines
6266
6267 =item C<sort $coderef @foo> allowed
6268
6269 =item File globbing implemented internally
6270
6271 =item Support for CHECK blocks
6272
6273 =item POSIX character class syntax [: :] supported
6274
6275 =item Better pseudo-random number generator
6276
6277 =item Improved C<qw//> operator
6278
6279 =item Better worst-case behavior of hashes
6280
6281 =item pack() format 'Z' supported
6282
6283 =item pack() format modifier '!' supported
6284
6285 =item pack() and unpack() support counted strings
6286
6287 =item Comments in pack() templates
6288
6289 =item Weak references
6290
6291 =item Binary numbers supported
6292
6293 =item Lvalue subroutines
6294
6295 =item Some arrows may be omitted in calls through references
6296
6297 =item Boolean assignment operators are legal lvalues
6298
6299 =item exists() is supported on subroutine names
6300
6301 =item exists() and delete() are supported on array elements
6302
6303 =item Pseudo-hashes work better
6304
6305 =item Automatic flushing of output buffers
6306
6307 =item Better diagnostics on meaningless filehandle operations
6308
6309 =item Where possible, buffered data discarded from duped input filehandle
6310
6311 =item eof() has the same old magic as <>
6312
6313 =item binmode() can be used to set :crlf and :raw modes
6314
6315 =item C<-T> filetest recognizes UTF-8 encoded files as "text"
6316
6317 =item system(), backticks and pipe open now reflect exec() failure
6318
6319 =item Improved diagnostics
6320
6321 =item Diagnostics follow STDERR
6322
6323 =item More consistent close-on-exec behavior
6324
6325 =item syswrite() ease-of-use
6326
6327 =item Better syntax checks on parenthesized unary operators
6328
6329 =item Bit operators support full native integer width
6330
6331 =item Improved security features
6332
6333 =item More functional bareword prototype (*)
6334
6335 =item C<require> and C<do> may be overridden
6336
6337 =item $^X variables may now have names longer than one character
6338
6339 =item New variable $^C reflects C<-c> switch
6340
6341 =item New variable $^V contains Perl version as a string
6342
6343 =item Optional Y2K warnings
6344
6345 =item Arrays now always interpolate into double-quoted strings
6346
6347 =back
6348
6349 =item Modules and Pragmata
6350
6351 =over 4
6352
6353 =item Modules
6354
6355 attributes, B, Benchmark, ByteLoader, constant, charnames, Data::Dumper,
6356 DB, DB_File, Devel::DProf, Devel::Peek, Dumpvalue, DynaLoader, English,
6357 Env, Fcntl, File::Compare, File::Find, File::Glob, File::Spec,
6358 File::Spec::Functions, Getopt::Long, IO, JPL, lib, Math::BigInt,
6359 Math::Complex, Math::Trig, Pod::Parser, Pod::InputObjects, Pod::Checker,
6360 podchecker, Pod::ParseUtils, Pod::Find, Pod::Select, podselect, Pod::Usage,
6361 pod2usage, Pod::Text and Pod::Man, SDBM_File, Sys::Syslog, Sys::Hostname,
6362 Term::ANSIColor, Time::Local, Win32, XSLoader, DBM Filters
6363
6364 =item Pragmata
6365
6366 =back
6367
6368 =item Utility Changes
6369
6370 =over 4
6371
6372 =item dprofpp
6373
6374 =item find2perl
6375
6376 =item h2xs
6377
6378 =item perlcc
6379
6380 =item perldoc
6381
6382 =item The Perl Debugger
6383
6384 =back
6385
6386 =item Improved Documentation
6387
6388 perlapi.pod, perlboot.pod, perlcompile.pod, perldbmfilter.pod,
6389 perldebug.pod, perldebguts.pod, perlfork.pod, perlfilter.pod, perlhack.pod,
6390 perlintern.pod, perllexwarn.pod, perlnumber.pod, perlopentut.pod,
6391 perlreftut.pod, perltootc.pod, perltodo.pod, perlunicode.pod
6392
6393 =item Performance enhancements
6394
6395 =over 4
6396
6397 =item Simple sort() using { $a <=> $b } and the like are optimized
6398
6399 =item Optimized assignments to lexical variables
6400
6401 =item Faster subroutine calls
6402
6403 =item delete(), each(), values() and hash iteration are faster
6404
6405 =back
6406
6407 =item Installation and Configuration Improvements
6408
6409 =over 4
6410
6411 =item -Dusethreads means something different
6412
6413 =item New Configure flags
6414
6415 =item Threadedness and 64-bitness now more daring
6416
6417 =item Long Doubles
6418
6419 =item -Dusemorebits
6420
6421 =item -Duselargefiles
6422
6423 =item installusrbinperl
6424
6425 =item SOCKS support
6426
6427 =item C<-A> flag
6428
6429 =item Enhanced Installation Directories
6430
6431 =back
6432
6433 =item Platform specific changes
6434
6435 =over 4
6436
6437 =item Supported platforms
6438
6439 =item DOS
6440
6441 =item OS390 (OpenEdition MVS)
6442
6443 =item VMS
6444
6445 =item Win32
6446
6447 =back
6448
6449 =item Significant bug fixes
6450
6451 =over 4
6452
6453 =item <HANDLE> on empty files
6454
6455 =item C<eval '...'> improvements
6456
6457 =item All compilation errors are true errors
6458
6459 =item Implicitly closed filehandles are safer
6460
6461 =item Behavior of list slices is more consistent
6462
6463 =item C<(\$)> prototype and C<$foo{a}>
6464
6465 =item C<goto &sub> and AUTOLOAD
6466
6467 =item C<-bareword> allowed under C<use integer>
6468
6469 =item Failures in DESTROY()
6470
6471 =item Locale bugs fixed
6472
6473 =item Memory leaks
6474
6475 =item Spurious subroutine stubs after failed subroutine calls
6476
6477 =item Taint failures under C<-U>
6478
6479 =item END blocks and the C<-c> switch
6480
6481 =item Potential to leak DATA filehandles
6482
6483 =back
6484
6485 =item New or Changed Diagnostics
6486
6487 "%s" variable %s masks earlier declaration in same %s, "my sub" not yet
6488 implemented, "our" variable %s redeclared, '!' allowed only after types %s,
6489 / cannot take a count, / must be followed by a, A or Z, / must be followed
6490 by a*, A* or Z*, / must follow a numeric type, /%s/: Unrecognized escape
6491 \\%c passed through, /%s/: Unrecognized escape \\%c in character class
6492 passed through, /%s/ should probably be written as "%s", %s() called too
6493 early to check prototype, %s argument is not a HASH or ARRAY element, %s
6494 argument is not a HASH or ARRAY element or slice, %s argument is not a
6495 subroutine name, %s package attribute may clash with future reserved word:
6496 %s, (in cleanup) %s, <> should be quotes, Attempt to join self, Bad evalled
6497 substitution pattern, Bad realloc() ignored, Bareword found in conditional,
6498 Binary number > 0b11111111111111111111111111111111 non-portable, Bit vector
6499 size > 32 non-portable, Buffer overflow in prime_env_iter: %s, Can't check
6500 filesystem of script "%s", Can't declare class for non-scalar %s in "%s",
6501 Can't declare %s in "%s", Can't ignore signal CHLD, forcing to default,
6502 Can't modify non-lvalue subroutine call, Can't read CRTL environ, Can't
6503 remove %s: %s, skipping file, Can't return %s from lvalue subroutine, Can't
6504 weaken a nonreference, Character class [:%s:] unknown, Character class
6505 syntax [%s] belongs inside character classes, Constant is not %s reference,
6506 constant(%s): %s, CORE::%s is not a keyword, defined(@array) is deprecated,
6507 defined(%hash) is deprecated, Did not produce a valid header, (Did you mean
6508 "local" instead of "our"?), Document contains no data, entering effective
6509 %s failed, false [] range "%s" in regexp, Filehandle %s opened only for
6510 output, flock() on closed filehandle %s, Global symbol "%s" requires
6511 explicit package name, Hexadecimal number > 0xffffffff non-portable,
6512 Ill-formed CRTL environ value "%s", Ill-formed message in prime_env_iter:
6513 |%s|, Illegal binary digit %s, Illegal binary digit %s ignored, Illegal
6514 number of bits in vec, Integer overflow in %s number, Invalid %s attribute:
6515 %s, Invalid %s attributes: %s, invalid [] range "%s" in regexp, Invalid
6516 separator character %s in attribute list, Invalid separator character %s in
6517 subroutine attribute list, leaving effective %s failed, Lvalue subs
6518 returning %s not implemented yet, Method %s not permitted, Missing
6519 %sbrace%s on \N{}, Missing command in piped open, Missing name in "my sub",
6520 No %s specified for -%c, No package name allowed for variable %s in "our",
6521 No space allowed after -%c, no UTC offset information; assuming local time
6522 is UTC, Octal number > 037777777777 non-portable, panic: del_backref,
6523 panic: kid popen errno read, panic: magic_killbackrefs, Parentheses missing
6524 around "%s" list, Possible unintended interpolation of %s in string,
6525 Possible Y2K bug: %s, pragma "attrs" is deprecated, use "sub NAME : ATTRS"
6526 instead, Premature end of script headers, Repeat count in pack overflows,
6527 Repeat count in unpack overflows, realloc() of freed memory ignored,
6528 Reference is already weak, setpgrp can't take arguments, Strange *+?{} on
6529 zero-length expression, switching effective %s is not implemented, This
6530 Perl can't reset CRTL environ elements (%s), This Perl can't set CRTL
6531 environ elements (%s=%s), Too late to run %s block, Unknown open() mode
6532 '%s', Unknown process %x sent message to prime_env_iter: %s, Unrecognized
6533 escape \\%c passed through, Unterminated attribute parameter in attribute
6534 list, Unterminated attribute list, Unterminated attribute parameter in
6535 subroutine attribute list, Unterminated subroutine attribute list, Value of
6536 CLI symbol "%s" too long, Version number must be a constant number
6537
6538 =item New tests
6539
6540 =item Incompatible Changes
6541
6542 =over 4
6543
6544 =item Perl Source Incompatibilities
6545
6546 CHECK is a new keyword, Treatment of list slices of undef has changed,
6547 Format of $English::PERL_VERSION is different, Literals of the form
6548 C<1.2.3> parse differently, Possibly changed pseudo-random number
6549 generator, Hashing function for hash keys has changed, C<undef> fails on
6550 read only values, Close-on-exec bit may be set on pipe and socket handles,
6551 Writing C<"$$1"> to mean C<"${$}1"> is unsupported, delete(), each(),
6552 values() and C<\(%h)>, vec(EXPR,OFFSET,BITS) enforces powers-of-two BITS,
6553 Text of some diagnostic output has changed, C<%@> has been removed,
6554 Parenthesized not() behaves like a list operator, Semantics of bareword
6555 prototype C<(*)> have changed, Semantics of bit operators may have changed
6556 on 64-bit platforms, More builtins taint their results
6557
6558 =item C Source Incompatibilities
6559
6560 C<PERL_POLLUTE>, C<PERL_IMPLICIT_CONTEXT>, C<PERL_POLLUTE_MALLOC>
6561
6562 =item Compatible C Source API Changes
6563
6564 C<PATCHLEVEL> is now C<PERL_VERSION>
6565
6566 =item Binary Incompatibilities
6567
6568 =back
6569
6570 =item Known Problems
6571
6572 =over 4
6573
6574 =item Thread test failures
6575
6576 =item EBCDIC platforms not supported
6577
6578 =item In 64-bit HP-UX the lib/io_multihomed test may hang
6579
6580 =item NEXTSTEP 3.3 POSIX test failure
6581
6582 =item Tru64 (aka Digital UNIX, aka DEC OSF/1) lib/sdbm test failure with
6583 gcc
6584
6585 =item UNICOS/mk CC failures during Configure run
6586
6587 =item Arrow operator and arrays
6588
6589 =item Experimental features
6590
6591 Threads, Unicode, 64-bit support, Lvalue subroutines, Weak references, The
6592 pseudo-hash data type, The Compiler suite, Internal implementation of file
6593 globbing, The DB module, The regular expression code constructs:
6594
6595 =back
6596
6597 =item Obsolete Diagnostics
6598
6599 Character class syntax [: :] is reserved for future extensions, Ill-formed
6600 logical name |%s| in prime_env_iter, In string, @%s now must be written as
6601 \@%s, Probable precedence problem on %s, regexp too big, Use of "$$<digit>"
6602 to mean "${$}<digit>" is deprecated
6603
6604 =item Reporting Bugs
6605
6606 =item SEE ALSO
6607
6608 =item HISTORY
6609
6610 =back
6611
6612 =head2 perl5005delta - what's new for perl5.005
6613
6614 =over 4
6615
6616 =item DESCRIPTION
6617
6618 =item About the new versioning system
6619
6620 =item Incompatible Changes
6621
6622 =over 4
6623
6624 =item WARNING:  This version is not binary compatible with Perl 5.004.
6625
6626 =item Default installation structure has changed
6627
6628 =item Perl Source Compatibility
6629
6630 =item C Source Compatibility
6631
6632 =item Binary Compatibility
6633
6634 =item Security fixes may affect compatibility
6635
6636 =item Relaxed new mandatory warnings introduced in 5.004
6637
6638 =item Licensing
6639
6640 =back
6641
6642 =item Core Changes
6643
6644 =over 4
6645
6646 =item Threads
6647
6648 =item Compiler
6649
6650 =item Regular Expressions
6651
6652 Many new and improved optimizations, Many bug fixes, New regular expression
6653 constructs, New operator for precompiled regular expressions, Other
6654 improvements, Incompatible changes
6655
6656 =item   Improved malloc()
6657
6658 =item Quicksort is internally implemented
6659
6660 =item Reliable signals
6661
6662 =item Reliable stack pointers
6663
6664 =item More generous treatment of carriage returns
6665
6666 =item Memory leaks
6667
6668 =item Better support for multiple interpreters
6669
6670 =item Behavior of local() on array and hash elements is now well-defined
6671
6672 =item C<%!> is transparently tied to the L<Errno> module
6673
6674 =item Pseudo-hashes are supported
6675
6676 =item C<EXPR foreach EXPR> is supported
6677
6678 =item Keywords can be globally overridden
6679
6680 =item C<$^E> is meaningful on Win32
6681
6682 =item C<foreach (1..1000000)> optimized
6683
6684 =item C<Foo::> can be used as implicitly quoted package name
6685
6686 =item C<exists $Foo::{Bar::}> tests existence of a package
6687
6688 =item Better locale support
6689
6690 =item Experimental support for 64-bit platforms
6691
6692 =item prototype() returns useful results on builtins
6693
6694 =item Extended support for exception handling
6695
6696 =item Re-blessing in DESTROY() supported for chaining DESTROY() methods
6697
6698 =item All C<printf> format conversions are handled internally
6699
6700 =item New C<INIT> keyword
6701
6702 =item New C<lock> keyword
6703
6704 =item New C<qr//> operator
6705
6706 =item C<our> is now a reserved word
6707
6708 =item Tied arrays are now fully supported
6709
6710 =item Tied handles support is better
6711
6712 =item 4th argument to substr
6713
6714 =item Negative LENGTH argument to splice
6715
6716 =item Magic lvalues are now more magical
6717
6718 =item <> now reads in records
6719
6720 =back
6721
6722 =item Supported Platforms
6723
6724 =over 4
6725
6726 =item New Platforms
6727
6728 =item Changes in existing support
6729
6730 =back
6731
6732 =item Modules and Pragmata
6733
6734 =over 4
6735
6736 =item New Modules
6737
6738 B, Data::Dumper, Dumpvalue, Errno, File::Spec, ExtUtils::Installed,
6739 ExtUtils::Packlist, Fatal, IPC::SysV, Test, Tie::Array, Tie::Handle,
6740 Thread, attrs, fields, re
6741
6742 =item Changes in existing modules
6743
6744 Benchmark, Carp, CGI, Fcntl, Math::Complex, Math::Trig, POSIX, DB_File,
6745 MakeMaker, CPAN, Cwd
6746
6747 =back
6748
6749 =item Utility Changes
6750
6751 =item Documentation Changes
6752
6753 =item New Diagnostics
6754
6755 Ambiguous call resolved as CORE::%s(), qualify as such or use &, Bad index
6756 while coercing array into hash, Bareword "%s" refers to nonexistent
6757 package, Can't call method "%s" on an undefined value, Can't check
6758 filesystem of script "%s" for nosuid, Can't coerce array into hash, Can't
6759 goto subroutine from an eval-string, Can't localize pseudo-hash element,
6760 Can't use %%! because Errno.pm is not available, Cannot find an opnumber
6761 for "%s", Character class syntax [. .] is reserved for future extensions,
6762 Character class syntax [: :] is reserved for future extensions, Character
6763 class syntax [= =] is reserved for future extensions, %s: Eval-group in
6764 insecure regular expression, %s: Eval-group not allowed, use re 'eval', %s:
6765 Eval-group not allowed at run time, Explicit blessing to '' (assuming
6766 package main), Illegal hex digit ignored, No such array field, No such
6767 field "%s" in variable %s of type %s, Out of memory during ridiculously
6768 large request, Range iterator outside integer range, Recursive inheritance
6769 detected while looking for method '%s' %s, Reference found where even-sized
6770 list expected, Undefined value assigned to typeglob, Use of reserved word
6771 "%s" is deprecated, perl: warning: Setting locale failed
6772
6773 =item Obsolete Diagnostics
6774
6775 Can't mktemp(), Can't write to temp file for B<-e>: %s, Cannot open
6776 temporary file, regexp too big
6777
6778 =item Configuration Changes
6779
6780 =item BUGS
6781
6782 =item SEE ALSO
6783
6784 =item HISTORY
6785
6786 =back
6787
6788 =head2 perl5004delta - what's new for perl5.004
6789
6790 =over 4
6791
6792 =item DESCRIPTION
6793
6794 =item Supported Environments
6795
6796 =item Core Changes
6797
6798 =over 4
6799
6800 =item List assignment to %ENV works
6801
6802 =item Change to "Can't locate Foo.pm in @INC" error
6803
6804 =item Compilation option: Binary compatibility with 5.003
6805
6806 =item $PERL5OPT environment variable
6807
6808 =item Limitations on B<-M>, B<-m>, and B<-T> options
6809
6810 =item More precise warnings
6811
6812 =item Deprecated: Inherited C<AUTOLOAD> for non-methods
6813
6814 =item Previously deprecated %OVERLOAD is no longer usable
6815
6816 =item Subroutine arguments created only when they're modified
6817
6818 =item Group vector changeable with C<$)>
6819
6820 =item Fixed parsing of $$<digit>, &$<digit>, etc.
6821
6822 =item Fixed localization of $<digit>, $&, etc.
6823
6824 =item No resetting of $. on implicit close
6825
6826 =item C<wantarray> may return undef
6827
6828 =item C<eval EXPR> determines value of EXPR in scalar context
6829
6830 =item Changes to tainting checks
6831
6832 No glob() or <*>, No spawning if tainted $CDPATH, $ENV, $BASH_ENV, No
6833 spawning if tainted $TERM doesn't look like a terminal name
6834
6835 =item New Opcode module and revised Safe module
6836
6837 =item Embedding improvements
6838
6839 =item Internal change: FileHandle class based on IO::* classes
6840
6841 =item Internal change: PerlIO abstraction interface
6842
6843 =item New and changed syntax
6844
6845 $coderef->(PARAMS)
6846
6847 =item New and changed builtin constants
6848
6849 __PACKAGE__
6850
6851 =item New and changed builtin variables
6852
6853 $^E, $^H, $^M
6854
6855 =item New and changed builtin functions
6856
6857 delete on slices, flock, printf and sprintf, keys as an lvalue, my() in
6858 Control Structures, pack() and unpack(), sysseek(), use VERSION, use Module
6859 VERSION LIST, prototype(FUNCTION), srand, $_ as Default, C<m//gc> does not
6860 reset search position on failure, C<m//x> ignores whitespace before ?*+{},
6861 nested C<sub{}> closures work now, formats work right on changing lexicals
6862
6863 =item New builtin methods
6864
6865 isa(CLASS), can(METHOD), VERSION( [NEED] )
6866
6867 =item TIEHANDLE now supported
6868
6869 TIEHANDLE classname, LIST, PRINT this, LIST, PRINTF this, LIST, READ this
6870 LIST, READLINE this, GETC this, DESTROY this
6871
6872 =item Malloc enhancements
6873
6874 -DPERL_EMERGENCY_SBRK, -DPACK_MALLOC, -DTWO_POT_OPTIMIZE
6875
6876 =item Miscellaneous efficiency enhancements
6877
6878 =back
6879
6880 =item Support for More Operating Systems
6881
6882 =over 4
6883
6884 =item Win32
6885
6886 =item Plan 9
6887
6888 =item QNX
6889
6890 =item AmigaOS
6891
6892 =back
6893
6894 =item Pragmata
6895
6896 use autouse MODULE => qw(sub1 sub2 sub3), use blib, use blib 'dir', use
6897 constant NAME => VALUE, use locale, use ops, use vmsish
6898
6899 =item Modules
6900
6901 =over 4
6902
6903 =item Required Updates
6904
6905 =item Installation directories
6906
6907 =item Module information summary
6908
6909 =item Fcntl
6910
6911 =item IO
6912
6913 =item Math::Complex
6914
6915 =item Math::Trig
6916
6917 =item DB_File
6918
6919 =item Net::Ping
6920
6921 =item Object-oriented overrides for builtin operators
6922
6923 =back
6924
6925 =item Utility Changes
6926
6927 =over 4
6928
6929 =item pod2html
6930
6931 Sends converted HTML to standard output
6932
6933 =item xsubpp
6934
6935 C<void> XSUBs now default to returning nothing
6936
6937 =back
6938
6939 =item C Language API Changes
6940
6941 C<gv_fetchmethod> and C<perl_call_sv>, C<perl_eval_pv>, Extended API for
6942 manipulating hashes
6943
6944 =item Documentation Changes
6945
6946 L<perldelta>, L<perlfaq>, L<perllocale>, L<perltoot>, L<perlapio>,
6947 L<perlmodlib>, L<perldebug>, L<perlsec>
6948
6949 =item New Diagnostics
6950
6951 "my" variable %s masks earlier declaration in same scope, %s argument is
6952 not a HASH element or slice, Allocation too large: %lx, Allocation too
6953 large, Applying %s to %s will act on scalar(%s), Attempt to free
6954 nonexistent shared string, Attempt to use reference as lvalue in substr,
6955 Bareword "%s" refers to nonexistent package, Can't redefine active sort
6956 subroutine %s, Can't use bareword ("%s") as %s ref while "strict refs" in
6957 use, Cannot resolve method `%s' overloading `%s' in package `%s', Constant
6958 subroutine %s redefined, Constant subroutine %s undefined, Copy method did
6959 not return a reference, Died, Exiting pseudo-block via %s, Identifier too
6960 long, Illegal character %s (carriage return), Illegal switch in PERL5OPT:
6961 %s, Integer overflow in hex number, Integer overflow in octal number,
6962 internal error: glob failed, Invalid conversion in %s: "%s", Invalid type
6963 in pack: '%s', Invalid type in unpack: '%s', Name "%s::%s" used only once:
6964 possible typo, Null picture in formline, Offset outside string, Out of
6965 memory!, Out of memory during request for %s, panic: frexp, Possible
6966 attempt to put comments in qw() list, Possible attempt to separate words
6967 with commas, Scalar value @%s{%s} better written as $%s{%s}, Stub found
6968 while resolving method `%s' overloading `%s' in %s, Too late for "B<-T>"
6969 option, untie attempted while %d inner references still exist, Unrecognized
6970 character %s, Unsupported function fork, Use of "$$<digit>" to mean
6971 "${$}<digit>" is deprecated, Value of %s can be "0"; test with defined(),
6972 Variable "%s" may be unavailable, Variable "%s" will not stay shared,
6973 Warning: something's wrong, Ill-formed logical name |%s| in prime_env_iter,
6974 Got an error from DosAllocMem, Malformed PERLLIB_PREFIX, PERL_SH_DIR too
6975 long, Process terminated by SIG%s
6976
6977 =item BUGS
6978
6979 =item SEE ALSO
6980
6981 =item HISTORY
6982
6983 =back
6984
6985 =head2 perlaix, README.aix - Perl version 5 on IBM Unix (AIX) systems
6986
6987 =over 4
6988
6989 =item DESCRIPTION
6990
6991 =over 4
6992
6993 =item Compiling Perl 5 on AIX
6994
6995 =item OS level
6996
6997 =item Building Dynamic Extensions on AIX
6998
6999 =item The IBM ANSI C Compiler
7000
7001 =item Using GNU's gcc for building perl
7002
7003 =item Using Large Files with Perl
7004
7005 =item Threaded Perl
7006
7007 =item 64-bit Perl
7008
7009 =item AIX 4.2 and extensions using C++ with statics
7010
7011 =back
7012
7013 =item AUTHOR
7014
7015 =item DATE
7016
7017 =back
7018
7019 =head2 perlapollo, README.apollo - Perl version 5 on Apollo DomainOS
7020
7021 =over 4
7022
7023 =item DESCRIPTION
7024
7025 =item AUTHOR
7026
7027 =back
7028
7029 =head2 perlamiga - Perl under Amiga OS
7030
7031 =over 4
7032
7033 =item NOTE
7034
7035 =item SYNOPSIS
7036
7037 =back
7038
7039 =over 4
7040
7041 =item DESCRIPTION
7042
7043 =over 4
7044
7045 =item Prerequisites for Compiling Perl on AmigaOS
7046
7047 B<Unix emulation for AmigaOS: ixemul.library>, B<Version of Amiga OS>
7048
7049 =item Starting Perl programs under AmigaOS
7050
7051 =item Shortcomings of Perl under AmigaOS
7052
7053 =back
7054
7055 =item INSTALLATION
7056
7057 =item Accessing documentation
7058
7059 =over 4
7060
7061 =item Manpages for Perl on AmigaOS
7062
7063 =item Perl HTML Documentation on AmigaOS
7064
7065 =item Perl GNU Info Files on AmigaOS
7066
7067 =item Perl LaTeX Documentation on AmigaOS
7068
7069 =back
7070
7071 =item BUILDING PERL ON AMIGAOS
7072
7073 =over 4
7074
7075 =item Build Prerequisites for Perl on AmigaOS
7076
7077 =item Getting the Perl Source for AmigaOS
7078
7079 =item Making Perl on AmigaOS
7080
7081 =item Testing Perl on AmigaOS
7082
7083 =item Installing the built Perl on AmigaOS
7084
7085 =back
7086
7087 =item PERL 5.8.0 BROKEN IN AMIGAOS
7088
7089 =item AUTHORS
7090
7091 =item SEE ALSO
7092
7093 =back
7094
7095 =head2 perlbeos, README.beos - Perl version 5 on BeOS
7096
7097 =over 4
7098
7099 =item DESCRIPTION
7100
7101 =over 4
7102
7103 =item General Issues with Perl on BeOS
7104
7105 =item BeOS Release-specific Notes
7106
7107 R4 x86, R4 PPC
7108
7109 =item Contact Information
7110
7111 =item Update 2002-05-30
7112
7113 =back
7114
7115 =back
7116
7117 =head2 perlbs2000, README.BS2000 - building and installing Perl for BS2000.
7118
7119 =over 4
7120
7121 =item SYNOPSIS
7122
7123 =item DESCRIPTION
7124
7125 =over 4
7126
7127 =item gzip on BS2000
7128
7129 =item bison on BS2000
7130
7131 =item Unpacking Perl Distribution on BS2000
7132
7133 =item Compiling Perl on BS2000
7134
7135 =item Testing Perl on BS2000
7136
7137 =item Installing Perl on BS2000
7138
7139 =item Using Perl in the Posix-Shell of BS2000
7140
7141 =item Using Perl in "native" BS2000
7142
7143 =item Floating point anomalies on BS2000
7144
7145 =back
7146
7147 =item AUTHORS
7148
7149 =item SEE ALSO
7150
7151 =over 4
7152
7153 =item Mailing list
7154
7155 =back
7156
7157 =item HISTORY
7158
7159 =back
7160
7161 =over 4
7162
7163 =item Name
7164
7165 =item Description
7166
7167 =item Build
7168
7169 =over 4
7170
7171 =item Tools & SDK
7172
7173 =item Make
7174
7175 =back
7176
7177 =item Acknowledgements
7178
7179 =item Author
7180
7181 =back
7182
7183 =head2 perlcygwin, README.cygwin - Perl for Cygwin
7184
7185 =over 4
7186
7187 =item SYNOPSIS
7188
7189 =item PREREQUISITES FOR COMPILING PERL ON CYGWIN
7190
7191 =over 4
7192
7193 =item Cygwin = GNU+Cygnus+Windows (Don't leave UNIX without it)
7194
7195 =item Cygwin Configuration
7196
7197 C<PATH>, I<nroff>, Permissions
7198
7199 =back
7200
7201 =item CONFIGURE PERL ON CYGWIN
7202
7203 =over 4
7204
7205 =item Stripping Perl Binaries on Cygwin
7206
7207 =item Optional Libraries for Perl on Cygwin
7208
7209 C<-lcrypt>, C<-lgdbm> (C<use GDBM_File>), C<-ldb> (C<use DB_File>),
7210 C<-lcygipc> (C<use IPC::SysV>), C<-lutil>
7211
7212 =item Configure-time Options for Perl on Cygwin
7213
7214 C<-Uusedl>, C<-Uusemymalloc>, C<-Uuseperlio>, C<-Dusemultiplicity>,
7215 C<-Duse64bitint>, C<-Duselongdouble>, C<-Dusethreads>, C<-Duselargefiles>,
7216 C<-Dmksymlinks>
7217
7218 =item Suspicious Warnings on Cygwin
7219
7220 I<dlsym()>, Win9x and C<d_eofnblk>, Compiler/Preprocessor defines
7221
7222 =back
7223
7224 =item MAKE ON CYGWIN
7225
7226 =over 4
7227
7228 =item Warnings on Cygwin
7229
7230 =item ld2 on Cygwin
7231
7232 =back
7233
7234 =item TEST ON CYGWIN
7235
7236 =over 4
7237
7238 =item File Permissions on Cygwin
7239
7240 =item NDBM_File does not work on FAT filesystems
7241
7242 =item Script Portability on Cygwin
7243
7244 Pathnames, Text/Binary, F<.exe>, chown(), Miscellaneous
7245
7246 =back
7247
7248 =item INSTALL PERL ON CYGWIN
7249
7250 =item MANIFEST ON CYGWIN
7251
7252 Documentation, Build, Configure, Make, Install, Tests, Compiled Perl
7253 Source, Compiled Module Source, Perl Modules/Scripts
7254
7255 =item BUGS ON CYGWIN
7256
7257 =item AUTHORS
7258
7259 =item HISTORY
7260
7261 =back
7262
7263 =head2 perldgux - Perl under DG/UX.
7264
7265 =over 4
7266
7267 =item SYNOPSIS
7268
7269 =back
7270
7271 =over 4
7272
7273 =item DESCRIPTION
7274
7275 =item BUILDING PERL ON DG/UX
7276
7277 =over 4
7278
7279 =item Non-threaded Perl on DG/UX
7280
7281 =item Threaded Perl on DG/UX
7282
7283 =item Testing Perl on DG/UX
7284
7285 =item Installing the built perl on DG/UX
7286
7287 =back
7288
7289 =item AUTHOR
7290
7291 =item SEE ALSO
7292
7293 =back
7294
7295 =head2 perldos - Perl under DOS, W31, W95.
7296
7297 =over 4
7298
7299 =item SYNOPSIS
7300
7301 =item DESCRIPTION
7302
7303 =over 4
7304
7305 =item Prerequisites for Compiling Perl on DOS
7306
7307 DJGPP, Pthreads
7308
7309 =item Shortcomings of Perl under DOS
7310
7311 =item Building Perl on DOS
7312
7313 =item Testing Perl on DOS
7314
7315 =item Installation of Perl on DOS
7316
7317 =back
7318
7319 =item BUILDING AND INSTALLING MODULES ON DOS
7320
7321 =over 4
7322
7323 =item Building Prerequisites for Perl on DOS
7324
7325 =item Unpacking CPAN Modules on DOS
7326
7327 =item Building Non-XS Modules on DOS
7328
7329 =item Building XS Modules on DOS
7330
7331 =back
7332
7333 =item AUTHOR
7334
7335 =item SEE ALSO
7336
7337 =back
7338
7339 =head2 perlepoc, README.epoc - Perl for EPOC
7340
7341 =over 4
7342
7343 =item SYNOPSIS
7344
7345 =item INTRODUCTION
7346
7347 =item INSTALLING PERL ON EPOC
7348
7349 =item STARTING PERL ON EPOC
7350
7351 =over 4
7352
7353 =item Editors on Epoc
7354
7355 =item Features of Perl on Epoc
7356
7357 =item Restrictions of Perl on Epoc
7358
7359 =item Compiling Perl 5 on the EPOC cross compiling environment
7360
7361 =back
7362
7363 =item SUPPORT STATUS OF PERL ON EPOC
7364
7365 =item AUTHOR
7366
7367 =item LAST UPDATE
7368
7369 =back
7370
7371 =head2 perlfreebsd, README.freebsd - Perl version 5 on FreeBSD systems
7372
7373 =over 4
7374
7375 =item DESCRIPTION
7376
7377 =over 4
7378
7379 =item FreeBSD core dumps from readdir_r with ithreads
7380
7381 =item $^X doesn't always contain a full path in FreeBSD
7382
7383 =item Perl will no longer be part of "base FreeBSD"
7384
7385 =back
7386
7387 =item AUTHOR
7388
7389 =back
7390
7391 =head2 perlhpux, README.hpux - Perl version 5 on Hewlett-Packard Unix
7392 (HP-UX) systems
7393
7394 =over 4
7395
7396 =item DESCRIPTION
7397
7398 =over 4
7399
7400 =item Using perl as shipped with HP-UX
7401
7402 =item Compiling Perl 5 on HP-UX
7403
7404 =item PA-RISC
7405
7406 =item PA-RISC 1.0
7407
7408 =item PA-RISC 1.1
7409
7410 =item PA-RISC 2.0
7411
7412 =item Itanium
7413
7414 =item Portability Between PA-RISC Versions
7415
7416 =item Itanium Processor Family and HP-UX
7417
7418 =item Building Dynamic Extensions on HP-UX
7419
7420 =item The HP ANSI C Compiler
7421
7422 =item The GNU C Compiler
7423
7424 =item Using Large Files with Perl on HP-UX
7425
7426 =item Threaded Perl on HP-UX
7427
7428 =item 64-bit Perl on HP-UX
7429
7430 =item Oracle on HP-UX
7431
7432 =item GDBM and Threads on HP-UX
7433
7434 =item NFS filesystems and utime(2) on HP-UX
7435
7436 =item perl -P and // and HP-UX
7437
7438 =item HP-UX Kernel Parameters (maxdsiz) for Compiling Perl
7439
7440 =back
7441
7442 =item nss_delete core dump from op/pwent or op/grent
7443
7444 =item AUTHOR
7445
7446 =item DATE
7447
7448 =back
7449
7450 =head2 perlhurd, README.hurd - Perl version 5 on Hurd
7451
7452 =over 4
7453
7454 =item DESCRIPTION
7455
7456 =over 4
7457
7458 =item Known Problems with Perl on Hurd
7459
7460 =back
7461
7462 =item AUTHOR
7463
7464 =back
7465
7466 =head2 perlirix, README.irix - Perl version 5 on Irix systems
7467
7468 =over 4
7469
7470 =item DESCRIPTION
7471
7472 =over 4
7473
7474 =item Building 32-bit Perl in Irix
7475
7476 =item Building 64-bit Perl in Irix
7477
7478 =item About Compiler Versions of Irix
7479
7480 =item Linker Problems in Irix
7481
7482 =item Malloc in Irix
7483
7484 =item Building with threads in Irix
7485
7486 =back
7487
7488 =item AUTHOR
7489
7490 =back
7491
7492 =head2 perlmachten, README.machten - Perl version 5 on Power MachTen
7493 systems
7494
7495 =over 4
7496
7497 =item DESCRIPTION
7498
7499 =over 4
7500
7501 =item Compiling Perl 5 on MachTen
7502
7503 =item Failures during C<make test> on MachTen
7504
7505 op/lexassign.t, pragma/warnings.t
7506
7507 =item Building external modules on MachTen
7508
7509 =back
7510
7511 =item AUTHOR
7512
7513 =item DATE
7514
7515 =back
7516
7517 =head2 perlmacos, README.macos - Perl under Mac OS (Classic)
7518
7519 =over 4
7520
7521 =item SYNOPSIS
7522
7523 =item DESCRIPTION
7524
7525 =item AUTHOR
7526
7527 =item DATE
7528
7529 =back
7530
7531 =head2 perlmint, README.mint - Perl version 5 on Atari MiNT
7532
7533 =over 4
7534
7535 =item DESCRIPTION
7536
7537 =item Known problems with Perl on MiNT
7538
7539 =item AUTHOR
7540
7541 =back
7542
7543 =head2 perlmpeix, README.mpeix - Perl/iX for HP e3000 MPE
7544
7545 =over 4
7546
7547 =item SYNOPSIS
7548
7549 =item NOTE
7550
7551 =item Binary distribution from HP
7552
7553 =item What's New in Perl for MPE/iX
7554
7555 =item Welcome to Perl/iX
7556
7557 =item System Requirements for Perl/iX
7558
7559 =item How to Obtain Perl/iX
7560
7561 =item Perl/iX Distribution Contents Highlights
7562
7563 README, INSTALL, LIBSHP3K, PERL, .cpan/, lib/, man/,
7564 public_html/feedback.cgi, src/perl-5.6.0-mpe
7565
7566 =item How to Compile Perl/iX
7567
7568  4,  6
7569
7570 =item Getting Started with Perl/iX
7571
7572 =item MPE/iX Implementation Considerations
7573
7574 =item Known Perl/iX Bugs Under Investigation
7575
7576 =item Perl/iX To-Do List
7577
7578 =item Perl/iX Change History
7579
7580 =item AUTHOR
7581
7582 =item Name
7583
7584 =item Description
7585
7586 =item Build
7587
7588 =over 4
7589
7590 =item Tools & SDK
7591
7592 =item Setup
7593
7594 SetNWBld.bat, Buildtype.bat
7595
7596 =item Make
7597
7598 =item Interpreter
7599
7600 =item Extensions
7601
7602 =back
7603
7604 =item Install
7605
7606 =item Build new extensions
7607
7608 =item Acknowledgements
7609
7610 =item Authors
7611
7612 =item Date
7613
7614 =back
7615
7616 =head2 perlos2 - Perl under OS/2, DOS, Win0.3*, Win0.95 and WinNT.
7617
7618 =over 4
7619
7620 =item SYNOPSIS
7621
7622 =back
7623
7624 =over 4
7625
7626 =item DESCRIPTION
7627
7628 =over 4
7629
7630 =item Target
7631
7632 =item Other OSes
7633
7634 =item Prerequisites
7635
7636 EMX, RSX, HPFS, pdksh
7637
7638 =item Starting Perl programs under OS/2 (and DOS and...)
7639
7640 =item Starting OS/2 (and DOS) programs under Perl
7641
7642 =back
7643
7644 =item Frequently asked questions
7645
7646 =over 4
7647
7648 =item "It does not work"
7649
7650 =item I cannot run external programs
7651
7652 =item I cannot embed perl into my program, or use F<perl.dll> from my
7653 program.
7654
7655 Is your program EMX-compiled with C<-Zmt -Zcrtdll>?, Did you use
7656 L<ExtUtils::Embed>?
7657
7658 =item C<``> and pipe-C<open> do not work under DOS.
7659
7660 =item Cannot start C<find.exe "pattern" file>
7661
7662 =back
7663
7664 =item INSTALLATION
7665
7666 =over 4
7667
7668 =item Automatic binary installation
7669
7670 C<PERL_BADLANG>, C<PERL_BADFREE>, F<Config.pm>
7671
7672 =item Manual binary installation
7673
7674 Perl VIO and PM executables (dynamically linked), Perl_ VIO executable
7675 (statically linked), Executables for Perl utilities, Main Perl library,
7676 Additional Perl modules, Tools to compile Perl modules, Manpages for Perl
7677 and utilities, Manpages for Perl modules, Source for Perl documentation,
7678 Perl manual in F<.INF> format, Pdksh
7679
7680 =item B<Warning>
7681
7682 =back
7683
7684 =item Accessing documentation
7685
7686 =over 4
7687
7688 =item OS/2 F<.INF> file
7689
7690 =item Plain text
7691
7692 =item Manpages
7693
7694 =item HTML
7695
7696 =item GNU C<info> files
7697
7698 =item F<PDF> files
7699
7700 =item C<LaTeX> docs
7701
7702 =back
7703
7704 =item BUILD
7705
7706 =over 4
7707
7708 =item The short story
7709
7710 =item Prerequisites
7711
7712 =item Getting perl source
7713
7714 =item Application of the patches
7715
7716 =item Hand-editing
7717
7718 =item Making
7719
7720 =item Testing
7721
7722 A lot of C<bad free>, Process terminated by SIGTERM/SIGINT, F<op/fs.t>,
7723 F<op/stat.t>
7724
7725 =item Installing the built perl
7726
7727 =item C<a.out>-style build
7728
7729 =back
7730
7731 =item Build FAQ
7732
7733 =over 4
7734
7735 =item Some C</> became C<\> in pdksh.
7736
7737 =item C<'errno'> - unresolved external
7738
7739 =item Problems with tr or sed
7740
7741 =item Some problem (forget which ;-)
7742
7743 =item Library ... not found
7744
7745 =item Segfault in make
7746
7747 =item op/sprintf test failure
7748
7749 =back
7750
7751 =item Specific (mis)features of OS/2 port
7752
7753 =over 4
7754
7755 =item C<setpriority>, C<getpriority>
7756
7757 =item C<system()>
7758
7759 =item C<extproc> on the first line
7760
7761 =item Additional modules:
7762
7763 =item Prebuilt methods:
7764
7765 C<File::Copy::syscopy>, C<DynaLoader::mod2fname>,  C<Cwd::current_drive()>,
7766  C<Cwd::sys_chdir(name)>,  C<Cwd::change_drive(name)>,
7767 C<Cwd::sys_is_absolute(name)>,  C<Cwd::sys_is_rooted(name)>,
7768 C<Cwd::sys_is_relative(name)>,  C<Cwd::sys_cwd(name)>,
7769 C<Cwd::sys_abspath(name, dir)>,  C<Cwd::extLibpath([type])>,
7770 C<Cwd::extLibpath_set( path [, type ] )>,
7771 C<OS2::Error(do_harderror,do_exception)>, C<OS2::Errors2Drive(drive)>,
7772 OS2::SysInfo(), OS2::BootDrive(), C<OS2::MorphPM(serve)>,
7773 C<OS2::UnMorphPM(serve)>, C<OS2::Serve_Messages(force)>,
7774 C<OS2::Process_Messages(force [, cnt])>, C<OS2::_control87(new,mask)>,
7775 OS2::get_control87(), C<OS2::set_control87_em(new=MCW_EM,mask=MCW_EM)>,
7776 C<OS2::DLLname([how [, \&xsub]])>
7777
7778 =item Prebuilt variables:
7779
7780 $OS2::emx_rev, $OS2::emx_env, $OS2::os_ver, $OS2::is_aout, $OS2::can_fork,
7781 $OS2::nsyserror
7782
7783 =item Misfeatures
7784
7785 =item Modifications
7786
7787 C<popen>, C<tmpnam>, C<tmpfile>, C<ctermid>, C<stat>, C<mkdir>, C<rmdir>,
7788 C<flock>
7789
7790 =item Identifying DLLs
7791
7792 =item Centralized management of resources
7793
7794 C<HAB>, C<HMQ>, Treating errors reported by OS/2 API,
7795 C<CheckOSError(expr)>, C<CheckWinError(expr)>, C<SaveWinError(expr)>,
7796 C<SaveCroakWinError(expr,die,name1,name2)>, C<WinError_2_Perl_rc>,
7797 C<FillWinError>, C<FillOSError(rc)>, Loading DLLs and ordinals in DLLs
7798
7799 =back
7800
7801 =item Perl flavors
7802
7803 =over 4
7804
7805 =item F<perl.exe>
7806
7807 =item F<perl_.exe>
7808
7809 =item F<perl__.exe>
7810
7811 =item F<perl___.exe>
7812
7813 =item Why strange names?
7814
7815 =item Why dynamic linking?
7816
7817 =item Why chimera build?
7818
7819 =back
7820
7821 =item ENVIRONMENT
7822
7823 =over 4
7824
7825 =item C<PERLLIB_PREFIX>
7826
7827 =item C<PERL_BADLANG>
7828
7829 =item C<PERL_BADFREE>
7830
7831 =item C<PERL_SH_DIR>
7832
7833 =item C<USE_PERL_FLOCK>
7834
7835 =item C<TMP> or C<TEMP>
7836
7837 =back
7838
7839 =item Evolution
7840
7841 =over 4
7842
7843 =item Text-mode filehandles
7844
7845 =item Priorities
7846
7847 =item DLL name mangling: pre 5.6.2
7848
7849 =item DLL name mangling: 5.6.2 and beyond
7850
7851 Global DLLs, specific DLLs, C<BEGINLIBPATH> and C<ENDLIBPATH>, F<.> from
7852 C<LIBPATH>
7853
7854 =item DLL forwarder generation
7855
7856 =item Threading
7857
7858 =item Calls to external programs
7859
7860 =item Memory allocation
7861
7862 =item Threads
7863
7864 C<COND_WAIT>, F<os2.c>
7865
7866 =back
7867
7868 =item BUGS
7869
7870 =back
7871
7872 =over 4
7873
7874 =item AUTHOR
7875
7876 =item SEE ALSO
7877
7878 =back
7879
7880 =head2 perlos390, README.os390 - building and installing Perl for OS/390
7881 and z/OS
7882
7883 =over 4
7884
7885 =item SYNOPSIS
7886
7887 =item DESCRIPTION
7888
7889 =over 4
7890
7891 =item Tools
7892
7893 =item Unpacking Perl distribution on OS/390
7894
7895 =item Setup and utilities for Perl on OS/390
7896
7897 =item Configure Perl on OS/390
7898
7899 =item Build, Test, Install Perl on OS/390
7900
7901 =item Build Anomalies with Perl on OS/390
7902
7903 =item Testing Anomalies with Perl on OS/390
7904
7905 =item Installation Anomalies with Perl on OS/390
7906
7907 =item Usage Hints for Perl on OS/390
7908
7909 =item Floating Point Anomalies with Perl on OS/390
7910
7911 =item Modules and Extensions for Perl on OS/390
7912
7913 =back
7914
7915 =item AUTHORS
7916
7917 =item SEE ALSO
7918
7919 =over 4
7920
7921 =item Mailing list for Perl on OS/390
7922
7923 =back
7924
7925 =item HISTORY
7926
7927 =back
7928
7929 =head2 perlqnx, README.qnx - Perl version 5 on QNX
7930
7931 =over 4
7932
7933 =item DESCRIPTION
7934
7935 =over 4
7936
7937 =item Required Software for Compiling Perl on QNX4
7938
7939 /bin/sh, ar, nm, cpp, make
7940
7941 =item Outstanding Issues with Perl on QNX4
7942
7943 =item QNX auxiliary files
7944
7945 qnx/ar, qnx/cpp
7946
7947 =item Outstanding issues with perl under QNX6
7948
7949 =back
7950
7951 =item AUTHOR
7952
7953 =back
7954
7955 =head2 perlplan9 - Plan 9-specific documentation for Perl
7956
7957 =over 4
7958
7959 =item DESCRIPTION
7960
7961 =over 4
7962
7963 =item Invoking Perl
7964
7965 =item What's in Plan 9 Perl
7966
7967 =item What's not in Plan 9 Perl
7968
7969 =item Perl5 Functions not currently supported in Plan 9 Perl
7970
7971 =item Signals in Plan 9 Perl
7972
7973 =back
7974
7975 =item COMPILING AND INSTALLING PERL ON PLAN 9
7976
7977 =over 4
7978
7979 =item Installing Perl Documentation on Plan 9
7980
7981 =back
7982
7983 =item BUGS
7984
7985 =item Revision date
7986
7987 =item AUTHOR
7988
7989 =back
7990
7991 =head2 perlsolaris, README.solaris - Perl version 5 on Solaris systems
7992
7993 =over 4
7994
7995 =item DESCRIPTION
7996
7997 =over 4
7998
7999 =item Solaris Version Numbers.
8000
8001 =back
8002
8003 =item RESOURCES
8004
8005 Solaris FAQ, Precompiled Binaries, Solaris Documentation
8006
8007 =item SETTING UP
8008
8009 =over 4
8010
8011 =item File Extraction Problems on Solaris.
8012
8013 =item Compiler and Related Tools on Solaris.
8014
8015 =item Environment for Compiling Perl on Solaris
8016
8017 =back
8018
8019 =item RUN CONFIGURE.
8020
8021 =over 4
8022
8023 =item 64-bit Issues with Perl on Solaris.
8024
8025 =item Threads in Perl on Solaris.
8026
8027 =item Malloc Issues with Perl on Solaris.
8028
8029 =back
8030
8031 =item MAKE PROBLEMS.
8032
8033 Dynamic Loading Problems With GNU as and GNU ld, ld.so.1: ./perl: fatal:
8034 relocation error:, dlopen: stub interception failed, #error "No
8035 DATAMODEL_NATIVE specified", sh: ar: not found
8036
8037 =item MAKE TEST
8038
8039 =over 4
8040
8041 =item op/stat.t test 4 in Solaris
8042
8043 =item nss_delete core dump from op/pwent or op/grent
8044
8045 =back
8046
8047 =item PREBUILT BINARIES OF PERL FOR SOLARIS.
8048
8049 =item RUNTIME ISSUES FOR PERL ON SOLARIS.
8050
8051 =over 4
8052
8053 =item Limits on Numbers of Open Files on Solaris.
8054
8055 =back
8056
8057 =item SOLARIS-SPECIFIC MODULES.
8058
8059 =item SOLARIS-SPECIFIC PROBLEMS WITH MODULES.
8060
8061 =over 4
8062
8063 =item Proc::ProcessTable on Solaris
8064
8065 =item BSD::Resource on Solaris
8066
8067 =item Net::SSLeay on Solaris
8068
8069 =back
8070
8071 =item AUTHOR
8072
8073 =item LAST MODIFIED
8074
8075 =back
8076
8077 =head2 perltru64, README.tru64 - Perl version 5 on Tru64 (formerly known as
8078 Digital UNIX formerly known as DEC OSF/1) systems
8079
8080 =over 4
8081
8082 =item DESCRIPTION
8083
8084 =over 4
8085
8086 =item Compiling Perl 5 on Tru64
8087
8088 =item Using Large Files with Perl on Tru64
8089
8090 =item Threaded Perl on Tru64
8091
8092 =item Long Doubles on Tru64
8093
8094 =item 64-bit Perl on Tru64
8095
8096 =item Warnings about floating-point overflow when compiling Perl on Tru64
8097
8098 =back
8099
8100 =item Testing Perl on Tru64
8101
8102 =item ext/ODBM_File/odbm Test Failing With Static Builds
8103
8104 =item Perl Fails Because Of Unresolved Symbol sockatmark
8105
8106 =item AUTHOR
8107
8108 =back
8109
8110 =head2 perluts - Perl under UTS
8111
8112 =over 4
8113
8114 =item SYNOPSIS
8115
8116 =item DESCRIPTION
8117
8118 =item BUILDING PERL ON UTS
8119
8120 =item Installing the built perl on UTS
8121
8122 =item AUTHOR
8123
8124 =back
8125
8126 =head2 perlvmesa, README.vmesa - building and installing Perl for VM/ESA.
8127
8128 =over 4
8129
8130 =item SYNOPSIS
8131
8132 =item DESCRIPTION
8133
8134 =over 4
8135
8136 =item Unpacking Perl Distribution on VM/ESA
8137
8138 =item Setup Perl and utilities on VM/ESA
8139
8140 =item Configure Perl on VM/ESA
8141
8142 =item Testing Anomalies of Perl on VM/ESA
8143
8144 =item Usage Hints for Perl on VM/ESA
8145
8146 =back
8147
8148 =item AUTHORS
8149
8150 =item SEE ALSO
8151
8152 =over 4
8153
8154 =item Mailing list for Perl on VM/ESA
8155
8156 =back
8157
8158 =back
8159
8160 =head2 perlvms - VMS-specific documentation for Perl
8161
8162 =over 4
8163
8164 =item DESCRIPTION
8165
8166 =item Installation
8167
8168 =item Organization of Perl Images
8169
8170 =over 4
8171
8172 =item Core Images
8173
8174 =item Perl Extensions
8175
8176 =item Installing static extensions
8177
8178 =item Installing dynamic extensions
8179
8180 =back
8181
8182 =item File specifications
8183
8184 =over 4
8185
8186 =item Syntax
8187
8188 =item Wildcard expansion
8189
8190 =item Pipes
8191
8192 =back
8193
8194 =item PERL5LIB and PERLLIB
8195
8196 =item Command line
8197
8198 =over 4
8199
8200 =item I/O redirection and backgrounding
8201
8202 =item Command line switches
8203
8204 -i, -S, -u
8205
8206 =back
8207
8208 =item Perl functions
8209
8210 File tests, backticks, binmode FILEHANDLE, crypt PLAINTEXT, USER, dump,
8211 exec LIST, fork, getpwent, getpwnam, getpwuid, gmtime, kill, qx//, select
8212 (system call), stat EXPR, system LIST, time, times, unlink LIST, utime
8213 LIST, waitpid PID,FLAGS
8214
8215 =item Perl variables
8216
8217 %ENV, CRTL_ENV, CLISYM_[LOCAL], Any other string, $!, $^E, $?, $|
8218
8219 =item Standard modules with VMS-specific differences
8220
8221 =over 4
8222
8223 =item SDBM_File
8224
8225 =back
8226
8227 =item Revision date
8228
8229 =item AUTHOR
8230
8231 =back
8232
8233 =head2 perlvos, README.vos - Perl for Stratus VOS
8234
8235 =over 4
8236
8237 =item SYNOPSIS
8238
8239 =over 4
8240
8241 =item Multiple methods to build perl for VOS
8242
8243 =item Stratus POSIX Support
8244
8245 =back
8246
8247 =item INSTALLING PERL IN VOS
8248
8249 =over 4
8250
8251 =item Compiling Perl 5 on VOS
8252
8253 =item Installing Perl 5 on VOS
8254
8255 =back
8256
8257 =item USING PERL IN VOS
8258
8259 =over 4
8260
8261 =item Unimplemented Features of Perl on VOS
8262
8263 =item Restrictions of Perl on VOS
8264
8265 =item Handling of underflow and overflow
8266
8267 =back
8268
8269 =item TEST STATUS
8270
8271 =item SUPPORT STATUS
8272
8273 =item AUTHOR
8274
8275 =item LAST UPDATE
8276
8277 =back
8278
8279 =head2 perlwin32 - Perl under Windows
8280
8281 =over 4
8282
8283 =item SYNOPSIS
8284
8285 =item DESCRIPTION
8286
8287 =over 4
8288
8289 =item Setting Up Perl on Win32
8290
8291 Make, Command Shell, Borland C++, Microsoft Visual C++, Microsoft Platform
8292 SDK 64-bit Compiler, Mingw32 with GCC
8293
8294 =item Building
8295
8296 =item Testing Perl on Win32
8297
8298 =item Installation of Perl on Win32
8299
8300 =item Usage Hints for Perl on Win32
8301
8302 Environment Variables, File Globbing, Using perl from the command line,
8303 Building Extensions, Command-line Wildcard Expansion, Win32 Specific
8304 Extensions, Notes on 64-bit Windows
8305
8306 =item Running Perl Scripts
8307
8308 Miscellaneous Things
8309
8310 =back
8311
8312 =item BUGS AND CAVEATS
8313
8314 =item AUTHORS
8315
8316 Gary Ng E<lt>71564.1743@CompuServe.COME<gt>, Gurusamy Sarathy
8317 E<lt>gsar@activestate.comE<gt>, Nick Ing-Simmons
8318 E<lt>nick@ing-simmons.netE<gt>
8319
8320 =item SEE ALSO
8321
8322 =item HISTORY
8323
8324 =back
8325
8326 =head1 PRAGMA DOCUMENTATION
8327
8328 =head2 attrs - set/get attributes of a subroutine (deprecated)
8329
8330 =over 4
8331
8332 =item SYNOPSIS
8333
8334 =item DESCRIPTION
8335
8336 method, locked
8337
8338 =back
8339
8340 =head2 re - Perl pragma to alter regular expression behaviour
8341
8342 =over 4
8343
8344 =item SYNOPSIS
8345
8346 =item DESCRIPTION
8347
8348 =back
8349
8350 =head2 threadshared::shared, threads::shared - Perl extension for sharing
8351 data structures between threads
8352
8353 =over 4
8354
8355 =item SYNOPSIS
8356
8357 =item DESCRIPTION
8358
8359 =item EXPORT
8360
8361 =item FUNCTIONS
8362
8363 share VARIABLE, lock VARIABLE, cond_wait VARIABLE, cond_signal VARIABLE,
8364 cond_broadcast VARIABLE
8365
8366 =item NOTES
8367
8368 =item BUGS
8369
8370 =item AUTHOR
8371
8372 =item SEE ALSO
8373
8374 =back
8375
8376 =head2 threads - Perl extension allowing use of interpreter based threads
8377 from perl
8378
8379 =over 4
8380
8381 =item SYNOPSIS
8382
8383 =item DESCRIPTION
8384
8385 $thread = threads->create(function, LIST), $thread->join, $thread->detach,
8386 threads->self, $thread->tid, threads->object( tid ), threads->yield();,
8387 threads->list();, async BLOCK;
8388
8389 =item WARNINGS
8390
8391 A thread exited while %d other threads were still running
8392
8393 =item TODO
8394
8395 =item BUGS
8396
8397 Parent-Child threads, Returning objects, Creating threads inside BEGIN
8398 blocks, PERL_OLD_SIGNALS are not threadsafe, will not be
8399
8400 =item AUTHOR and COPYRIGHT
8401
8402 =item SEE ALSO
8403
8404 =back
8405
8406 =head2 attributes - get/set subroutine or variable attributes
8407
8408 =over 4
8409
8410 =item SYNOPSIS
8411
8412 =item DESCRIPTION
8413
8414 =over 4
8415
8416 =item Built-in Attributes
8417
8418 locked, method, lvalue
8419
8420 =item Available Subroutines
8421
8422 get, reftype
8423
8424 =item Package-specific Attribute Handling
8425
8426 FETCH_I<type>_ATTRIBUTES, MODIFY_I<type>_ATTRIBUTES
8427
8428 =item Syntax of Attribute Lists
8429
8430 =back
8431
8432 =item EXPORTS
8433
8434 =over 4
8435
8436 =item Default exports
8437
8438 =item Available exports
8439
8440 =item Export tags defined
8441
8442 =back
8443
8444 =item EXAMPLES
8445
8446 =item SEE ALSO
8447
8448 =back
8449
8450 =head2 attrs - set/get attributes of a subroutine (deprecated)
8451
8452 =over 4
8453
8454 =item SYNOPSIS
8455
8456 =item DESCRIPTION
8457
8458 method, locked
8459
8460 =back
8461
8462 =head2 autouse - postpone load of modules until a function is used
8463
8464 =over 4
8465
8466 =item SYNOPSIS
8467
8468 =item DESCRIPTION
8469
8470 =item WARNING
8471
8472 =item AUTHOR
8473
8474 =item SEE ALSO
8475
8476 =back
8477
8478 =head2 base - Establish IS-A relationship with base class at compile time
8479
8480 =over 4
8481
8482 =item SYNOPSIS
8483
8484 =item DESCRIPTION
8485
8486 =item HISTORY
8487
8488 =item SEE ALSO
8489
8490 =back
8491
8492 =head2 bigint - Transparent big integer support for Perl
8493
8494 =over 4
8495
8496 =item SYNOPSIS
8497
8498 =item DESCRIPTION
8499
8500 =over 4
8501
8502 =item OPTIONS
8503
8504 a or accuracy, p or precision, t or trace, l or lib, v or version
8505
8506 =item MATH LIBRARY
8507
8508 =item INTERNAL FORMAT
8509
8510 =item SIGN
8511
8512 =item METHODS
8513
8514 =back
8515
8516 =item MODULES USED
8517
8518 =item EXAMPLES
8519
8520 =item LICENSE
8521
8522 =item SEE ALSO
8523
8524 =item AUTHORS
8525
8526 =back
8527
8528 =head2 bignum - Transparent BigNumber support for Perl
8529
8530 =over 4
8531
8532 =item SYNOPSIS
8533
8534 =item DESCRIPTION
8535
8536 =over 4
8537
8538 =item OPTIONS
8539
8540 a or accuracy, p or precision, t or trace, l or lib, v or version
8541
8542 =item MATH LIBRARY
8543
8544 =item INTERNAL FORMAT
8545
8546 =item SIGN
8547
8548 =item METHODS
8549
8550 =back
8551
8552 =item MODULES USED
8553
8554 =item EXAMPLES
8555
8556 =item LICENSE
8557
8558 =item SEE ALSO
8559
8560 =item AUTHORS
8561
8562 =back
8563
8564 =head2 bigrat - Transparent BigNumber/BigRational support for Perl
8565
8566 =over 4
8567
8568 =item SYNOPSIS
8569
8570 =item DESCRIPTION
8571
8572 =over 4
8573
8574 =item MODULES USED
8575
8576 =item MATH LIBRARY
8577
8578 =item SIGN
8579
8580 =item METHODS
8581
8582 =back
8583
8584 =item EXAMPLES
8585
8586         perl -Mbigrat -le 'print sqrt(33)'
8587         perl -Mbigrat -le 'print 2*255'
8588         perl -Mbigrat -le 'print 4.5+2*255'
8589         perl -Mbigrat -le 'print 3/7 + 5/7 + 8/3'
8590         perl -Mbigrat -le 'print 12->is_odd()';
8591
8592 =item LICENSE
8593
8594 =item SEE ALSO
8595
8596 =item AUTHORS
8597
8598 =back
8599
8600 =head2 blib - Use MakeMaker's uninstalled version of a package
8601
8602 =over 4
8603
8604 =item SYNOPSIS
8605
8606 =item DESCRIPTION
8607
8608 =item BUGS
8609
8610 =item AUTHOR
8611
8612 =back
8613
8614 =head2 bytes - Perl pragma to force byte semantics rather than character
8615 semantics
8616
8617 =over 4
8618
8619 =item SYNOPSIS
8620
8621 =item DESCRIPTION
8622
8623 =item SEE ALSO
8624
8625 =back
8626
8627 =head2 charnames - define character names for C<\N{named}> string literal
8628 escapes
8629
8630 =over 4
8631
8632 =item SYNOPSIS
8633
8634 =item DESCRIPTION
8635
8636 =item CUSTOM TRANSLATORS
8637
8638 =item charnames::viacode(code)
8639
8640 =item charnames::vianame(name)
8641
8642 =item ALIASES
8643
8644 =item ILLEGAL CHARACTERS
8645
8646 =item BUGS
8647
8648 =back
8649
8650 =head2 constant - Perl pragma to declare constants
8651
8652 =over 4
8653
8654 =item SYNOPSIS
8655
8656 =item DESCRIPTION
8657
8658 =item NOTES
8659
8660 =over 4
8661
8662 =item List constants
8663
8664 =item Defining multiple constants at once
8665
8666 =item Magic constants
8667
8668 =back
8669
8670 =item TECHNICAL NOTES
8671
8672 =item BUGS
8673
8674 =item AUTHOR
8675
8676 =item COPYRIGHT
8677
8678 =back
8679
8680 =head2 diagnostics - Perl compiler pragma to force verbose warning
8681 diagnostics
8682
8683 =over 4
8684
8685 =item SYNOPSIS
8686
8687 =item DESCRIPTION
8688
8689 =over 4
8690
8691 =item The C<diagnostics> Pragma
8692
8693 =item The I<splain> Program
8694
8695 =back
8696
8697 =item EXAMPLES
8698
8699 =item INTERNALS
8700
8701 =item BUGS
8702
8703 =item AUTHOR
8704
8705 =back
8706
8707 =head2 encoding - allows you to write your script in non-ascii or non-utf8
8708
8709 =over 4
8710
8711 =item SYNOPSIS
8712
8713 =item ABSTRACT
8714
8715 =item USAGE
8716
8717 use encoding [I<ENCNAME>] ;, use encoding I<ENCNAME> [ STDIN =E<gt>
8718 I<ENCNAME_IN> ...] ;, no encoding;
8719
8720 =item CAVEATS
8721
8722 =over 4
8723
8724 =item NOT SCOPED
8725
8726 =item DO NOT MIX MULTIPLE ENCODINGS
8727
8728 =back
8729
8730 =item Non-ASCII Identifiers and Filter option
8731
8732 use encoding I<ENCNAME> Filter=E<gt>1;
8733
8734 =item EXAMPLE - Greekperl
8735
8736 =item KNOWN PROBLEMS
8737
8738 =item SEE ALSO
8739
8740 =back
8741
8742 =head2 fields - compile-time class fields
8743
8744 =over 4
8745
8746 =item SYNOPSIS
8747
8748 =item DESCRIPTION
8749
8750 new, phash
8751
8752 =item SEE ALSO
8753
8754 =back
8755
8756 =head2 filetest - Perl pragma to control the filetest permission operators
8757
8758 =over 4
8759
8760 =item SYNOPSIS
8761
8762 =item DESCRIPTION
8763
8764 =over 4
8765
8766 =item subpragma access
8767
8768 =back
8769
8770 =back
8771
8772 =head2 if - C<use> a Perl module if a condition holds
8773
8774 =over 4
8775
8776 =item SYNOPSIS
8777
8778 =item DESCRIPTION
8779
8780 =item BUGS
8781
8782 =item AUTHOR
8783
8784 =back
8785
8786 =head2 integer - Perl pragma to use integer arithmetic instead of floating
8787 point
8788
8789 =over 4
8790
8791 =item SYNOPSIS
8792
8793 =item DESCRIPTION
8794
8795 =back
8796
8797 =head2 less - perl pragma to request less of something from the compiler
8798
8799 =over 4
8800
8801 =item SYNOPSIS
8802
8803 =item DESCRIPTION
8804
8805 =back
8806
8807 =head2 lib - manipulate @INC at compile time
8808
8809 =over 4
8810
8811 =item SYNOPSIS
8812
8813 =item DESCRIPTION
8814
8815 =over 4
8816
8817 =item Adding directories to @INC
8818
8819 =item Deleting directories from @INC
8820
8821 =item Restoring original @INC
8822
8823 =back
8824
8825 =item CAVEATS
8826
8827 =item NOTES
8828
8829 =item SEE ALSO
8830
8831 =item AUTHOR
8832
8833 =back
8834
8835 =head2 locale - Perl pragma to use and avoid POSIX locales for built-in
8836 operations
8837
8838 =over 4
8839
8840 =item SYNOPSIS
8841
8842 =item DESCRIPTION
8843
8844 =back
8845
8846 =head2 open - perl pragma to set default PerlIO layers for input and output
8847
8848 =over 4
8849
8850 =item SYNOPSIS
8851
8852 =item DESCRIPTION
8853
8854 =item NONPERLIO FUNCTIONALITY
8855
8856 =item IMPLEMENTATION DETAILS
8857
8858 =item SEE ALSO
8859
8860 =back
8861
8862 =head2 ops - Perl pragma to restrict unsafe operations when compiling
8863
8864 =over 4
8865
8866 =item SYNOPSIS
8867
8868 =item DESCRIPTION
8869
8870 =item SEE ALSO
8871
8872 =back
8873
8874 =head2 overload - Package for overloading perl operations
8875
8876 =over 4
8877
8878 =item SYNOPSIS
8879
8880 =item DESCRIPTION
8881
8882 =over 4
8883
8884 =item Declaration of overloaded functions
8885
8886 =item Calling Conventions for Binary Operations
8887
8888 FALSE, TRUE, C<undef>
8889
8890 =item Calling Conventions for Unary Operations
8891
8892 =item Calling Conventions for Mutators
8893
8894 C<++> and C<-->, C<x=> and other assignment versions
8895
8896 =item Overloadable Operations
8897
8898 I<Arithmetic operations>, I<Comparison operations>, I<Bit operations>,
8899 I<Increment and decrement>, I<Transcendental functions>, I<Boolean, string
8900 and numeric conversion>, I<Iteration>, I<Dereferencing>, I<Special>
8901
8902 =item Inheritance and overloading
8903
8904 Strings as values of C<use overload> directive, Overloading of an operation
8905 is inherited by derived classes
8906
8907 =back
8908
8909 =item SPECIAL SYMBOLS FOR C<use overload>
8910
8911 =over 4
8912
8913 =item Last Resort
8914
8915 =item Fallback
8916
8917 C<undef>, TRUE, defined, but FALSE
8918
8919 =item Copy Constructor
8920
8921 B<Example>
8922
8923 =back
8924
8925 =item MAGIC AUTOGENERATION
8926
8927 I<Assignment forms of arithmetic operations>, I<Conversion operations>,
8928 I<Increment and decrement>, C<abs($a)>, I<Unary minus>, I<Negation>,
8929 I<Concatenation>, I<Comparison operations>, I<Iterator>, I<Dereferencing>,
8930 I<Copy operator>
8931
8932 =item Losing overloading
8933
8934 =item Run-time Overloading
8935
8936 =item Public functions
8937
8938 overload::StrVal(arg), overload::Overloaded(arg), overload::Method(obj,op)
8939
8940 =item Overloading constants
8941
8942 integer, float, binary, q, qr
8943
8944 =item IMPLEMENTATION
8945
8946 =item Metaphor clash
8947
8948 =item Cookbook
8949
8950 =over 4
8951
8952 =item Two-face scalars
8953
8954 =item Two-face references
8955
8956 =item Symbolic calculator
8957
8958 =item I<Really> symbolic calculator
8959
8960 =back
8961
8962 =item AUTHOR
8963
8964 =item DIAGNOSTICS
8965
8966 Odd number of arguments for overload::constant, `%s' is not an overloadable
8967 type, `%s' is not a code reference
8968
8969 =item BUGS
8970
8971 =back
8972
8973 =head2 re - Perl pragma to alter regular expression behaviour
8974
8975 =over 4
8976
8977 =item SYNOPSIS
8978
8979 =item DESCRIPTION
8980
8981 =back
8982
8983 =head2 sigtrap - Perl pragma to enable simple signal handling
8984
8985 =over 4
8986
8987 =item SYNOPSIS
8988
8989 =item DESCRIPTION
8990
8991 =item OPTIONS
8992
8993 =over 4
8994
8995 =item SIGNAL HANDLERS
8996
8997 B<stack-trace>, B<die>, B<handler> I<your-handler>
8998
8999 =item SIGNAL LISTS
9000
9001 B<normal-signals>, B<error-signals>, B<old-interface-signals>
9002
9003 =item OTHER
9004
9005 B<untrapped>, B<any>, I<signal>, I<number>
9006
9007 =back
9008
9009 =item EXAMPLES
9010
9011 =back
9012
9013 =head2 sort - perl pragma to control sort() behaviour
9014
9015 =over 4
9016
9017 =item SYNOPSIS
9018
9019 =item DESCRIPTION
9020
9021 =item CAVEATS
9022
9023 =back
9024
9025 =head2 strict - Perl pragma to restrict unsafe constructs
9026
9027 =over 4
9028
9029 =item SYNOPSIS
9030
9031 =item DESCRIPTION
9032
9033 C<strict refs>, C<strict vars>, C<strict subs>
9034
9035 =back
9036
9037 =head2 subs - Perl pragma to predeclare sub names
9038
9039 =over 4
9040
9041 =item SYNOPSIS
9042
9043 =item DESCRIPTION
9044
9045 =back
9046
9047 =head2 threads - Perl extension allowing use of interpreter based threads
9048 from perl
9049
9050 =over 4
9051
9052 =item SYNOPSIS
9053
9054 =item DESCRIPTION
9055
9056 $thread = threads->create(function, LIST), $thread->join, $thread->detach,
9057 threads->self, $thread->tid, threads->object( tid ), threads->yield();,
9058 threads->list();, async BLOCK;
9059
9060 =item WARNINGS
9061
9062 A thread exited while %d other threads were still running
9063
9064 =item TODO
9065
9066 =item BUGS
9067
9068 Parent-Child threads, Returning objects, Creating threads inside BEGIN
9069 blocks, PERL_OLD_SIGNALS are not threadsafe, will not be
9070
9071 =item AUTHOR and COPYRIGHT
9072
9073 =item SEE ALSO
9074
9075 =back
9076
9077 =head2 threadshared, threads::shared - Perl extension for sharing data
9078 structures between threads
9079
9080 =over 4
9081
9082 =item SYNOPSIS
9083
9084 =item DESCRIPTION
9085
9086 =item EXPORT
9087
9088 =item FUNCTIONS
9089
9090 share VARIABLE, lock VARIABLE, cond_wait VARIABLE, cond_signal VARIABLE,
9091 cond_broadcast VARIABLE
9092
9093 =item NOTES
9094
9095 =item BUGS
9096
9097 =item AUTHOR
9098
9099 =item SEE ALSO
9100
9101 =back
9102
9103 =head2 utf8 - Perl pragma to enable/disable UTF-8 (or UTF-EBCDIC) in source
9104 code
9105
9106 =over 4
9107
9108 =item SYNOPSIS
9109
9110 =item DESCRIPTION
9111
9112 =over 4
9113
9114 =item Utility functions
9115
9116 $num_octets = utf8::upgrade($string);, utf8::downgrade($string[, FAIL_OK]),
9117 utf8::encode($string), $flag = utf8::decode($string), $flag =
9118 utf8::valid(STRING)
9119
9120 =back
9121
9122 =item BUGS
9123
9124 =item SEE ALSO
9125
9126 =back
9127
9128 =head2 vars - Perl pragma to predeclare global variable names (obsolete)
9129
9130 =over 4
9131
9132 =item SYNOPSIS
9133
9134 =item DESCRIPTION
9135
9136 =back
9137
9138 =head2 vmsish - Perl pragma to control VMS-specific language features
9139
9140 =over 4
9141
9142 =item SYNOPSIS
9143
9144 =item DESCRIPTION
9145
9146 C<vmsish status>, C<vmsish exit>, C<vmsish time>, C<vmsish hushed>
9147
9148 =back
9149
9150 =head2 warnings - Perl pragma to control optional warnings
9151
9152 =over 4
9153
9154 =item SYNOPSIS
9155
9156 =item DESCRIPTION
9157
9158 use warnings::register, warnings::enabled(), warnings::enabled($category),
9159 warnings::enabled($object), warnings::warn($message),
9160 warnings::warn($category, $message), warnings::warn($object, $message),
9161 warnings::warnif($message), warnings::warnif($category, $message),
9162 warnings::warnif($object, $message)
9163
9164 =back
9165
9166 =head2 warnings::register - warnings import function
9167
9168 =over 4
9169
9170 =item SYNOPSIS
9171
9172 =item DESCRIPTION
9173
9174 =back
9175
9176 =head1 MODULE DOCUMENTATION
9177
9178 =head2 AnyDBM_File - provide framework for multiple DBMs
9179
9180 =over 4
9181
9182 =item SYNOPSIS
9183
9184 =item DESCRIPTION
9185
9186 =over 4
9187
9188 =item DBM Comparisons
9189
9190 [0], [1], [2], [3]
9191
9192 =back
9193
9194 =item SEE ALSO
9195
9196 =back
9197
9198 =head2 Attribute::Handlers - Simpler definition of attribute handlers
9199
9200 =over 4
9201
9202 =item VERSION
9203
9204 =item SYNOPSIS
9205
9206 =item DESCRIPTION
9207
9208 [0], [1], [2], [3], [4], [5]
9209
9210 =over 4
9211
9212 =item Typed lexicals
9213
9214 =item Type-specific attribute handlers
9215
9216 =item Non-interpretive attribute handlers
9217
9218 =item Phase-specific attribute handlers
9219
9220 =item Attributes as C<tie> interfaces
9221
9222 =back
9223
9224 =item EXAMPLES
9225
9226 =item DIAGNOSTICS
9227
9228 C<Bad attribute type: ATTR(%s)>, C<Attribute handler %s doesn't handle %s
9229 attributes>, C<Declaration of %s attribute in package %s may clash with
9230 future reserved word>, C<Can't have two ATTR specifiers on one subroutine>,
9231 C<Can't autotie a %s>, C<Internal error: %s symbol went missing>, C<Won't
9232 be able to apply END handler>
9233
9234 =item AUTHOR
9235
9236 =item BUGS
9237
9238 =item COPYRIGHT
9239
9240 =back
9241
9242 =head2 AutoLoader - load subroutines only on demand
9243
9244 =over 4
9245
9246 =item SYNOPSIS
9247
9248 =item DESCRIPTION
9249
9250 =over 4
9251
9252 =item Subroutine Stubs
9253
9254 =item Using B<AutoLoader>'s AUTOLOAD Subroutine
9255
9256 =item Overriding B<AutoLoader>'s AUTOLOAD Subroutine
9257
9258 =item Package Lexicals
9259
9260 =item Not Using AutoLoader
9261
9262 =item B<AutoLoader> vs. B<SelfLoader>
9263
9264 =back
9265
9266 =item CAVEATS
9267
9268 =item SEE ALSO
9269
9270 =back
9271
9272 =head2 AutoSplit - split a package for autoloading
9273
9274 =over 4
9275
9276 =item SYNOPSIS
9277
9278 =item DESCRIPTION
9279
9280 $keep, $check, $modtime
9281
9282 =over 4
9283
9284 =item Multiple packages
9285
9286 =back
9287
9288 =item DIAGNOSTICS
9289
9290 =back
9291
9292 =head2 B - The Perl Compiler
9293
9294 =over 4
9295
9296 =item SYNOPSIS
9297
9298 =item DESCRIPTION
9299
9300 =item OVERVIEW OF CLASSES
9301
9302 =over 4
9303
9304 =item SV-RELATED CLASSES
9305
9306 =item B::SV METHODS
9307
9308 REFCNT, FLAGS
9309
9310 =item B::IV METHODS
9311
9312 IV, IVX, UVX, int_value, needs64bits, packiv
9313
9314 =item B::NV METHODS
9315
9316 NV, NVX
9317
9318 =item B::RV METHODS
9319
9320 RV
9321
9322 =item B::PV METHODS
9323
9324 PV, RV, PVX
9325
9326 =item B::PVMG METHODS
9327
9328 MAGIC, SvSTASH
9329
9330 =item B::MAGIC METHODS
9331
9332 MOREMAGIC, precomp, PRIVATE, TYPE, FLAGS, OBJ, PTR, REGEX
9333
9334 =item B::PVLV METHODS
9335
9336 TARGOFF, TARGLEN, TYPE, TARG
9337
9338 =item B::BM METHODS
9339
9340 USEFUL, PREVIOUS, RARE, TABLE
9341
9342 =item B::GV METHODS
9343
9344 is_empty, NAME, SAFENAME, STASH, SV, IO, FORM, AV, HV, EGV, CV, CVGEN,
9345 LINE, FILE, FILEGV, GvREFCNT, FLAGS
9346
9347 =item B::IO METHODS
9348
9349 LINES, PAGE, PAGE_LEN, LINES_LEFT, TOP_NAME, TOP_GV, FMT_NAME, FMT_GV,
9350 BOTTOM_NAME, BOTTOM_GV, SUBPROCESS, IoTYPE, IoFLAGS, IsSTD
9351
9352 =item B::AV METHODS
9353
9354 FILL, MAX, OFF, ARRAY, AvFLAGS
9355
9356 =item B::CV METHODS
9357
9358 STASH, START, ROOT, GV, FILE, DEPTH, PADLIST, OUTSIDE, XSUB, XSUBANY,
9359 CvFLAGS, const_sv
9360
9361 =item B::HV METHODS
9362
9363 FILL, MAX, KEYS, RITER, NAME, PMROOT, ARRAY
9364
9365 =item OP-RELATED CLASSES
9366
9367 =item B::OP METHODS
9368
9369 next, sibling, name, ppaddr, desc, targ, type, seq, flags, private
9370
9371 =item B::UNOP METHOD
9372
9373 first
9374
9375 =item B::BINOP METHOD
9376
9377 last
9378
9379 =item B::LOGOP METHOD
9380
9381 other
9382
9383 =item B::LISTOP METHOD
9384
9385 children
9386
9387 =item B::PMOP METHODS
9388
9389 pmreplroot, pmreplstart, pmnext, pmregexp, pmflags, pmdynflags,
9390 pmpermflags, precomp, pmoffet
9391
9392 =item B::SVOP METHOD
9393
9394 sv, gv
9395
9396 =item B::PADOP METHOD
9397
9398 padix
9399
9400 =item B::PVOP METHOD
9401
9402 pv
9403
9404 =item B::LOOP METHODS
9405
9406 redoop, nextop, lastop
9407
9408 =item B::COP METHODS
9409
9410 label, stash, file, cop_seq, arybase, line
9411
9412 =back
9413
9414 =item FUNCTIONS EXPORTED BY C<B>
9415
9416 main_cv, init_av, begin_av, end_av, main_root, main_start, comppadlist,
9417 regex_padav, sv_undef, sv_yes, sv_no, amagic_generation, walkoptree(OP,
9418 METHOD), walkoptree_debug(DEBUG), walksymtable(SYMREF, METHOD, RECURSE,
9419 PREFIX), svref_2object(SV), ppname(OPNUM), hash(STR), cast_I32(I), minus_c,
9420 cstring(STR), perlstring(STR), class(OBJ), threadsv_names
9421
9422 =item AUTHOR
9423
9424 =back
9425
9426 =head2 B::Asmdata - Autogenerated data about Perl ops, used to generate
9427 bytecode
9428
9429 =over 4
9430
9431 =item SYNOPSIS
9432
9433 =item DESCRIPTION
9434
9435 %insn_data, @insn_name, @optype, @specialsv_name
9436
9437 =item AUTHOR
9438
9439 =back
9440
9441 =head2 B::Assembler - Assemble Perl bytecode
9442
9443 =over 4
9444
9445 =item SYNOPSIS
9446
9447 =item DESCRIPTION
9448
9449 =item AUTHORS
9450
9451 =back
9452
9453 =head2 B::Bblock - Walk basic blocks
9454
9455 =over 4
9456
9457 =item SYNOPSIS
9458
9459 =item DESCRIPTION
9460
9461 =over 4
9462
9463 =item Functions
9464
9465 B<find_leaders>
9466
9467 =back
9468
9469 =item AUTHOR
9470
9471 =back
9472
9473 =head2 B::Bytecode - Perl compiler's bytecode backend
9474
9475 =over 4
9476
9477 =item SYNOPSIS
9478
9479 =item DESCRIPTION
9480
9481 =item OPTIONS
9482
9483 B<-ofilename>, B<-afilename>, B<-->, B<-f>, B<-fcompress-nullops>,
9484 B<-fomit-sequence-numbers>, B<-fbypass-nullops>, B<-On>, B<-D>, B<-Do>,
9485 B<-Db>, B<-Da>, B<-DC>, B<-S>, B<-upackage>
9486
9487 =item EXAMPLES
9488
9489 =item BUGS
9490
9491 =item AUTHORS
9492
9493 =back
9494
9495 =head2 B::C - Perl compiler's C backend
9496
9497 =over 4
9498
9499 =item SYNOPSIS
9500
9501 =item DESCRIPTION
9502
9503 =item OPTIONS
9504
9505 B<-ofilename>, B<-v>, B<-->, B<-uPackname>, B<-D>, B<-Do>, B<-Dc>, B<-DA>,
9506 B<-DC>, B<-DM>, B<-f>, B<-fcog>, B<-fsave-data>, B<-fppaddr>, B<-fwarn-sv>,
9507 B<-fuse-script-name>, B<-fsave-sig-hash>, B<-On>, B<-O0>, B<-O1>, B<-O2>,
9508 B<-llimit>
9509
9510 =item EXAMPLES
9511
9512 =item BUGS
9513
9514 =item AUTHOR
9515
9516 =back
9517
9518 =head2 B::CC - Perl compiler's optimized C translation backend
9519
9520 =over 4
9521
9522 =item SYNOPSIS
9523
9524 =item DESCRIPTION
9525
9526 =item OPTIONS
9527
9528 B<-ofilename>, B<-v>, B<-->, B<-uPackname>, B<-mModulename>, B<-D>, B<-Dr>,
9529 B<-DO>, B<-Ds>, B<-Dp>, B<-Dq>, B<-Dl>, B<-Dt>, B<-f>,
9530 B<-ffreetmps-each-bblock>, B<-ffreetmps-each-loop>, B<-fomit-taint>, B<-On>
9531
9532 =item EXAMPLES
9533
9534 =item BUGS
9535
9536 =item DIFFERENCES
9537
9538 =over 4
9539
9540 =item Loops
9541
9542 =item Context of ".."
9543
9544 =item Arithmetic
9545
9546 =item Deprecated features
9547
9548 =back
9549
9550 =item AUTHOR
9551
9552 =back
9553
9554 =head2 B::Concise - Walk Perl syntax tree, printing concise info about ops
9555
9556 =over 4
9557
9558 =item SYNOPSIS
9559
9560 =item DESCRIPTION
9561
9562 =item EXAMPLE
9563
9564 =item OPTIONS
9565
9566 B<-basic>, B<-exec>, B<-tree>, B<-compact>, B<-loose>, B<-vt>, B<-ascii>,
9567 B<-main>, B<-base>I<n>, B<-bigendian>, B<-littleendian>, B<-concise>,
9568 B<-terse>, B<-linenoise>, B<-debug>, B<-env>
9569
9570 =item FORMATTING SPECIFICATIONS
9571
9572 B<(x(>I<exec_text>B<;>I<basic_text>B<)x)>, B<(*(>I<text>B<)*)>,
9573 B<(*(>I<text1>B<;>I<text2>B<)*)>, B<(?(>I<text1>B<#>I<var>I<Text2>B<)?)>,
9574 B<#>I<var>, B<#>I<var>I<N>, B<~>, B<#addr>, B<#arg>, B<#class>,
9575 B<#classsym>, B<#coplabel>, B<#exname>, B<#extarg>, B<#firstaddr>,
9576 B<#flags>, B<#flagval>, B<#hyphseq>, B<#label>, B<#lastaddr>, B<#name>,
9577 B<#NAME>, B<#next>, B<#nextaddr>, B<#noise>, B<#private>, B<#privval>,
9578 B<#seq>, B<#seqnum>, B<#sibaddr>, B<#svaddr>, B<#svclass>, B<#svval>,
9579 B<#targ>, B<#targarg>, B<#targarglife>, B<#typenum>
9580
9581 =item ABBREVIATIONS
9582
9583 =over 4
9584
9585 =item OP flags abbreviations
9586
9587 =item OP class abbreviations
9588
9589 =back
9590
9591 =item Using B::Concise outside of the O framework
9592
9593 =item AUTHOR
9594
9595 =back
9596
9597 =head2 B::Debug - Walk Perl syntax tree, printing debug info about ops
9598
9599 =over 4
9600
9601 =item SYNOPSIS
9602
9603 =item DESCRIPTION
9604
9605 =item AUTHOR
9606
9607 =back
9608
9609 =head2 B::Deparse - Perl compiler backend to produce perl code
9610
9611 =over 4
9612
9613 =item SYNOPSIS
9614
9615 =item DESCRIPTION
9616
9617 =item OPTIONS
9618
9619 B<-l>, B<-p>, B<-P>, B<-q>, B<-f>I<FILE>, B<-s>I<LETTERS>, B<C>,
9620 B<i>I<NUMBER>, B<T>, B<v>I<STRING>B<.>, B<-x>I<LEVEL>
9621
9622 =item USING B::Deparse AS A MODULE
9623
9624 =over 4
9625
9626 =item Synopsis
9627
9628 =item Description
9629
9630 =item new
9631
9632 =item ambient_pragmas
9633
9634 strict, $[, bytes, utf8, integer, re, warnings, hint_bits, warning_bits
9635
9636 =item coderef2text
9637
9638 =back
9639
9640 =item BUGS
9641
9642 =item AUTHOR
9643
9644 =back
9645
9646 =head2 B::Disassembler - Disassemble Perl bytecode
9647
9648 =over 4
9649
9650 =item SYNOPSIS
9651
9652 =item DESCRIPTION
9653
9654 =item AUTHOR
9655
9656 =back
9657
9658 =head2 B::Lint - Perl lint
9659
9660 =over 4
9661
9662 =item SYNOPSIS
9663
9664 =item DESCRIPTION
9665
9666 =item OPTIONS AND LINT CHECKS
9667
9668 B<context>, B<implicit-read> and B<implicit-write>, B<dollar-underscore>,
9669 B<private-names>, B<undefined-subs>, B<regexp-variables>, B<all>, B<none>
9670
9671 =item NON LINT-CHECK OPTIONS
9672
9673 B<-u Package>
9674
9675 =item BUGS
9676
9677 =item AUTHOR
9678
9679 =back
9680
9681 =head2 B::O, O - Generic interface to Perl Compiler backends
9682
9683 =over 4
9684
9685 =item SYNOPSIS
9686
9687 =item DESCRIPTION
9688
9689 =item CONVENTIONS
9690
9691 =item IMPLEMENTATION
9692
9693 =item BUGS
9694
9695 =item AUTHOR
9696
9697 =back
9698
9699 =head2 B::Showlex - Show lexical variables used in functions or files
9700
9701 =over 4
9702
9703 =item SYNOPSIS
9704
9705 =item DESCRIPTION
9706
9707 =item AUTHOR
9708
9709 =back
9710
9711 =head2 B::Stackobj - Helper module for CC backend
9712
9713 =over 4
9714
9715 =item SYNOPSIS
9716
9717 =item DESCRIPTION
9718
9719 =item AUTHOR
9720
9721 =back
9722
9723 =head2 B::Stash - show what stashes are loaded
9724
9725 =head2 B::Terse - Walk Perl syntax tree, printing terse info about ops
9726
9727 =over 4
9728
9729 =item SYNOPSIS
9730
9731 =item DESCRIPTION
9732
9733 =item AUTHOR
9734
9735 =back
9736
9737 =head2 B::Xref - Generates cross reference reports for Perl programs
9738
9739 =over 4
9740
9741 =item SYNOPSIS
9742
9743 =item DESCRIPTION
9744
9745 =item OPTIONS
9746
9747 C<-oFILENAME>, C<-r>, C<-d>, C<-D[tO]>
9748
9749 =item BUGS
9750
9751 =item AUTHOR
9752
9753 =back
9754
9755 =head2 Bblock, B::Bblock - Walk basic blocks
9756
9757 =over 4
9758
9759 =item SYNOPSIS
9760
9761 =item DESCRIPTION
9762
9763 =over 4
9764
9765 =item Functions
9766
9767 B<find_leaders>
9768
9769 =back
9770
9771 =item AUTHOR
9772
9773 =back
9774
9775 =head2 Benchmark - benchmark running times of Perl code
9776
9777 =over 4
9778
9779 =item SYNOPSIS
9780
9781 =item DESCRIPTION
9782
9783 =over 4
9784
9785 =item Methods
9786
9787 new, debug, iters
9788
9789 =item Standard Exports
9790
9791 timeit(COUNT, CODE), timethis ( COUNT, CODE, [ TITLE, [ STYLE ]] ),
9792 timethese ( COUNT, CODEHASHREF, [ STYLE ] ), timediff ( T1, T2 ), timestr (
9793 TIMEDIFF, [ STYLE, [ FORMAT ] ] )
9794
9795 =item Optional Exports
9796
9797 clearcache ( COUNT ), clearallcache ( ), cmpthese ( COUT, CODEHASHREF, [
9798 STYLE ] ), cmpthese ( RESULTSHASHREF, [ STYLE ] ), countit(TIME, CODE),
9799 disablecache ( ), enablecache ( ), timesum ( T1, T2 )
9800
9801 =back
9802
9803 =item NOTES
9804
9805 =item EXAMPLES
9806
9807 =item INHERITANCE
9808
9809 =item CAVEATS
9810
9811 =item SEE ALSO
9812
9813 =item AUTHORS
9814
9815 =item MODIFICATION HISTORY
9816
9817 =back
9818
9819 =head2 ByteLoader - load byte compiled perl code
9820
9821 =over 4
9822
9823 =item SYNOPSIS
9824
9825 =item DESCRIPTION
9826
9827 =item AUTHOR
9828
9829 =item SEE ALSO
9830
9831 =back
9832
9833 =head2 Bytecode, B::Bytecode - Perl compiler's bytecode backend
9834
9835 =over 4
9836
9837 =item SYNOPSIS
9838
9839 =item DESCRIPTION
9840
9841 =item OPTIONS
9842
9843 B<-ofilename>, B<-afilename>, B<-->, B<-f>, B<-fcompress-nullops>,
9844 B<-fomit-sequence-numbers>, B<-fbypass-nullops>, B<-On>, B<-D>, B<-Do>,
9845 B<-Db>, B<-Da>, B<-DC>, B<-S>, B<-upackage>
9846
9847 =item EXAMPLES
9848
9849 =item BUGS
9850
9851 =item AUTHORS
9852
9853 =back
9854
9855 =head2 CGI - Simple Common Gateway Interface Class
9856
9857 =over 4
9858
9859 =item SYNOPSIS
9860
9861 =item ABSTRACT
9862
9863 =item DESCRIPTION
9864
9865 =over 4
9866
9867 =item PROGRAMMING STYLE
9868
9869 =item CALLING CGI.PM ROUTINES
9870
9871 =item CREATING A NEW QUERY OBJECT (OBJECT-ORIENTED STYLE):
9872
9873 =item CREATING A NEW QUERY OBJECT FROM AN INPUT FILE
9874
9875 =item FETCHING A LIST OF KEYWORDS FROM THE QUERY:
9876
9877 =item FETCHING THE NAMES OF ALL THE PARAMETERS PASSED TO YOUR SCRIPT:
9878
9879 =item FETCHING THE VALUE OR VALUES OF A SINGLE NAMED PARAMETER:
9880
9881 =item SETTING THE VALUE(S) OF A NAMED PARAMETER:
9882
9883 =item APPENDING ADDITIONAL VALUES TO A NAMED PARAMETER:
9884
9885 =item IMPORTING ALL PARAMETERS INTO A NAMESPACE:
9886
9887 =item DELETING A PARAMETER COMPLETELY:
9888
9889 =item DELETING ALL PARAMETERS:
9890
9891 =item DIRECT ACCESS TO THE PARAMETER LIST:
9892
9893 =item FETCHING THE PARAMETER LIST AS A HASH:
9894
9895 =item SAVING THE STATE OF THE SCRIPT TO A FILE:
9896
9897 =item RETRIEVING CGI ERRORS
9898
9899 =item USING THE FUNCTION-ORIENTED INTERFACE
9900
9901 B<:cgi>, B<:form>, B<:html2>, B<:html3>, B<:html4>, B<:netscape>, B<:html>,
9902 B<:standard>, B<:all>
9903
9904 =item PRAGMAS
9905
9906 -any, -compile, -nosticky, -no_undef_params, -no_xhtml, -nph,
9907 -newstyle_urls, -oldstyle_urls, -autoload, -no_debug, -debug,
9908 -private_tempfiles
9909
9910 =item SPECIAL FORMS FOR IMPORTING HTML-TAG FUNCTIONS
9911
9912 1. start_table() (generates a <table> tag), 2. end_table() (generates a
9913 </table> tag), 3. start_ul() (generates a <ul> tag), 4. end_ul() (generates
9914 a </ul> tag)
9915
9916 =back
9917
9918 =item GENERATING DYNAMIC DOCUMENTS
9919
9920 =over 4
9921
9922 =item CREATING A STANDARD HTTP HEADER:
9923
9924 =item GENERATING A REDIRECTION HEADER
9925
9926 =item CREATING THE HTML DOCUMENT HEADER
9927
9928 B<Parameters:>, 4, 5, 6..
9929
9930 =item ENDING THE HTML DOCUMENT:
9931
9932 =item CREATING A SELF-REFERENCING URL THAT PRESERVES STATE INFORMATION:
9933
9934 =item OBTAINING THE SCRIPT'S URL
9935
9936 B<-absolute>, B<-relative>, B<-full>, B<-path> (B<-path_info>), B<-query>
9937 (B<-query_string>), B<-base>
9938
9939 =item MIXING POST AND URL PARAMETERS
9940
9941 =back
9942
9943 =item CREATING STANDARD HTML ELEMENTS:
9944
9945 =over 4
9946
9947 =item PROVIDING ARGUMENTS TO HTML SHORTCUTS
9948
9949 =item THE DISTRIBUTIVE PROPERTY OF HTML SHORTCUTS
9950
9951 =item HTML SHORTCUTS AND LIST INTERPOLATION
9952
9953 =item NON-STANDARD HTML SHORTCUTS
9954
9955 =item AUTOESCAPING HTML
9956
9957 $escaped_string = escapeHTML("unescaped string");, $charset =
9958 charset([$charset]);, $flag = autoEscape([$flag]);
9959
9960 =item PRETTY-PRINTING HTML
9961
9962 =back
9963
9964 =item CREATING FILL-OUT FORMS:
9965
9966 =over 4
9967
9968 =item CREATING AN ISINDEX TAG
9969
9970 =item STARTING AND ENDING A FORM
9971
9972 B<application/x-www-form-urlencoded>, B<multipart/form-data>
9973
9974 =item CREATING A TEXT FIELD
9975
9976 B<Parameters>
9977
9978 =item CREATING A BIG TEXT FIELD
9979
9980 =item CREATING A PASSWORD FIELD
9981
9982 =item CREATING A FILE UPLOAD FIELD
9983
9984 B<Parameters>
9985
9986 =item CREATING A POPUP MENU
9987
9988 =item CREATING A SCROLLING LIST
9989
9990 B<Parameters:>
9991
9992 =item CREATING A GROUP OF RELATED CHECKBOXES
9993
9994 B<Parameters:>
9995
9996 =item CREATING A STANDALONE CHECKBOX
9997
9998 B<Parameters:>
9999
10000 =item CREATING A RADIO BUTTON GROUP
10001
10002 B<Parameters:>
10003
10004 =item CREATING A SUBMIT BUTTON
10005
10006 B<Parameters:>
10007
10008 =item CREATING A RESET BUTTON
10009
10010 =item CREATING A DEFAULT BUTTON
10011
10012 =item CREATING A HIDDEN FIELD
10013
10014 B<Parameters:>
10015
10016 =item CREATING A CLICKABLE IMAGE BUTTON
10017
10018 B<Parameters:>
10019
10020 =item CREATING A JAVASCRIPT ACTION BUTTON
10021
10022 =back
10023
10024 =item HTTP COOKIES
10025
10026 1. an expiration time, 2. a domain, 3. a path, 4. a "secure" flag,
10027 B<-name>, B<-value>, B<-path>, B<-domain>, B<-expires>, B<-secure>
10028
10029 =item WORKING WITH FRAMES
10030
10031 1. Create a <Frameset> document, 2. Specify the destination for the
10032 document in the HTTP header, 3. Specify the destination for the document in
10033 the <form> tag
10034
10035 =item LIMITED SUPPORT FOR CASCADING STYLE SHEETS
10036
10037 =item DEBUGGING
10038
10039 =over 4
10040
10041 =item DUMPING OUT ALL THE NAME/VALUE PAIRS
10042
10043 =back
10044
10045 =item FETCHING ENVIRONMENT VARIABLES
10046
10047 B<Accept()>, B<raw_cookie()>, B<user_agent()>, B<path_info()>,
10048 B<path_translated()>, B<remote_host()>, B<script_name()>, B<referer()>,
10049 B<auth_type ()>, B<server_name ()>, B<virtual_host ()>, B<server_port ()>,
10050 B<server_software ()>, B<remote_user ()>, B<user_name ()>,
10051 B<request_method()>, B<content_type()>, B<http()>, B<https()>
10052
10053 =item USING NPH SCRIPTS
10054
10055 In the B<use> statement, By calling the B<nph()> method:, By using B<-nph>
10056 parameters
10057
10058 =item Server Push
10059
10060 multipart_init(), multipart_start(), multipart_end(), multipart_final()
10061
10062 =item Avoiding Denial of Service Attacks
10063
10064 B<$CGI::POST_MAX>, B<$CGI::DISABLE_UPLOADS>, B<1. On a script-by-script
10065 basis>, B<2. Globally for all scripts>
10066
10067 =item COMPATIBILITY WITH CGI-LIB.PL
10068
10069 =item AUTHOR INFORMATION
10070
10071 =item CREDITS
10072
10073 Matt Heffron (heffron@falstaff.css.beckman.com), James Taylor
10074 (james.taylor@srs.gov), Scott Anguish <sanguish@digifix.com>, Mike Jewell
10075 (mlj3u@virginia.edu), Timothy Shimmin (tes@kbs.citri.edu.au), Joergen Haegg
10076 (jh@axis.se), Laurent Delfosse (delfosse@delfosse.com), Richard Resnick
10077 (applepi1@aol.com), Craig Bishop (csb@barwonwater.vic.gov.au), Tony Curtis
10078 (tc@vcpc.univie.ac.at), Tim Bunce (Tim.Bunce@ig.co.uk), Tom Christiansen
10079 (tchrist@convex.com), Andreas Koenig (k@franz.ww.TU-Berlin.DE), Tim
10080 MacKenzie (Tim.MacKenzie@fulcrum.com.au), Kevin B. Hendricks
10081 (kbhend@dogwood.tyler.wm.edu), Stephen Dahmen (joyfire@inxpress.net), Ed
10082 Jordan (ed@fidalgo.net), David Alan Pisoni (david@cnation.com), Doug
10083 MacEachern (dougm@opengroup.org), Robin Houston (robin@oneworld.org),
10084 ...and many many more..
10085
10086 =item A COMPLETE EXAMPLE OF A SIMPLE FORM-BASED SCRIPT
10087
10088 =item BUGS
10089
10090 =item SEE ALSO
10091
10092 =back
10093
10094 =head2 CGI::Apache - Backward compatibility module for CGI.pm
10095
10096 =over 4
10097
10098 =item SYNOPSIS
10099
10100 =item ABSTRACT
10101
10102 =item DESCRIPTION
10103
10104 =item AUTHOR INFORMATION
10105
10106 =item BUGS
10107
10108 =item SEE ALSO
10109
10110 =back
10111
10112 =head2 CGI::Carp, B<CGI::Carp> - CGI routines for writing to the HTTPD (or
10113 other) error log
10114
10115 =over 4
10116
10117 =item SYNOPSIS
10118
10119 =item DESCRIPTION
10120
10121 =item REDIRECTING ERROR MESSAGES
10122
10123 =item MAKING PERL ERRORS APPEAR IN THE BROWSER WINDOW
10124
10125 =over 4
10126
10127 =item Changing the default message
10128
10129 =back
10130
10131 =item MAKING WARNINGS APPEAR AS HTML COMMENTS
10132
10133 =item CHANGE LOG
10134
10135 =item AUTHORS
10136
10137 =item SEE ALSO
10138
10139 =back
10140
10141 =head2 CGI::Cookie - Interface to Netscape Cookies
10142
10143 =over 4
10144
10145 =item SYNOPSIS
10146
10147 =item DESCRIPTION
10148
10149 =item USING CGI::Cookie
10150
10151 B<1. expiration date>, B<2. domain>, B<3. path>, B<4. secure flag>
10152
10153 =over 4
10154
10155 =item Creating New Cookies
10156
10157 =item Sending the Cookie to the Browser
10158
10159 =item Recovering Previous Cookies
10160
10161 =item Manipulating Cookies
10162
10163 B<name()>, B<value()>, B<domain()>, B<path()>, B<expires()>
10164
10165 =back
10166
10167 =item AUTHOR INFORMATION
10168
10169 =item BUGS
10170
10171 =item SEE ALSO
10172
10173 =back
10174
10175 =head2 CGI::Fast - CGI Interface for Fast CGI
10176
10177 =over 4
10178
10179 =item SYNOPSIS
10180
10181 =item DESCRIPTION
10182
10183 =item OTHER PIECES OF THE PUZZLE
10184
10185 =item WRITING FASTCGI PERL SCRIPTS
10186
10187 =item INSTALLING FASTCGI SCRIPTS
10188
10189 =item USING FASTCGI SCRIPTS AS CGI SCRIPTS
10190
10191 =item EXTERNAL FASTCGI SERVER INVOCATION
10192
10193 FCGI_SOCKET_PATH, FCGI_LISTEN_QUEUE
10194
10195 =item CAVEATS
10196
10197 =item AUTHOR INFORMATION
10198
10199 =item BUGS
10200
10201 =item SEE ALSO
10202
10203 =back
10204
10205 =head2 CGI::Pretty - module to produce nicely formatted HTML code
10206
10207 =over 4
10208
10209 =item SYNOPSIS
10210
10211 =item DESCRIPTION
10212
10213 =over 4
10214
10215 =item Tags that won't be formatted
10216
10217 =item Customizing the Indenting
10218
10219 =back
10220
10221 =item BUGS
10222
10223 =item AUTHOR
10224
10225 =item SEE ALSO
10226
10227 =back
10228
10229 =head2 CGI::Push - Simple Interface to Server Push
10230
10231 =over 4
10232
10233 =item SYNOPSIS
10234
10235 =item DESCRIPTION
10236
10237 =item USING CGI::Push
10238
10239 -next_page, -last_page, -type, -delay, -cookie, -target, -expires, -nph
10240
10241 =over 4
10242
10243 =item Heterogeneous Pages
10244
10245 =item Changing the Page Delay on the Fly
10246
10247 =back
10248
10249 =item INSTALLING CGI::Push SCRIPTS
10250
10251 =item AUTHOR INFORMATION
10252
10253 =item BUGS
10254
10255 =item SEE ALSO
10256
10257 =back
10258
10259 =head2 CGI::Switch - Backward compatibility module for defunct CGI::Switch
10260
10261 =over 4
10262
10263 =item SYNOPSIS
10264
10265 =item ABSTRACT
10266
10267 =item DESCRIPTION
10268
10269 =item AUTHOR INFORMATION
10270
10271 =item BUGS
10272
10273 =item SEE ALSO
10274
10275 =back
10276
10277 =head2 CGI::Util - Internal utilities used by CGI module
10278
10279 =over 4
10280
10281 =item SYNOPSIS
10282
10283 =item DESCRIPTION
10284
10285 =item AUTHOR INFORMATION
10286
10287 =item SEE ALSO
10288
10289 =back
10290
10291 =head2 CPAN - query, download and build perl modules from CPAN sites
10292
10293 =over 4
10294
10295 =item SYNOPSIS
10296
10297 =item DESCRIPTION
10298
10299 =over 4
10300
10301 =item Interactive Mode
10302
10303 Searching for authors, bundles, distribution files and modules, make, test,
10304 install, clean  modules or distributions, get, readme, look module or
10305 distribution, ls author, Signals
10306
10307 =item CPAN::Shell
10308
10309 =item autobundle
10310
10311 =item recompile
10312
10313 =item The four C<CPAN::*> Classes: Author, Bundle, Module, Distribution
10314
10315 =item Programmer's interface
10316
10317 expand($type,@things), expandany(@things), Programming Examples
10318
10319 =item Methods in the other Classes
10320
10321 CPAN::Author::as_glimpse(), CPAN::Author::as_string(),
10322 CPAN::Author::email(), CPAN::Author::fullname(), CPAN::Author::name(),
10323 CPAN::Bundle::as_glimpse(), CPAN::Bundle::as_string(),
10324 CPAN::Bundle::clean(), CPAN::Bundle::contains(),
10325 CPAN::Bundle::force($method,@args), CPAN::Bundle::get(),
10326 CPAN::Bundle::inst_file(), CPAN::Bundle::inst_version(),
10327 CPAN::Bundle::uptodate(), CPAN::Bundle::install(), CPAN::Bundle::make(),
10328 CPAN::Bundle::readme(), CPAN::Bundle::test(),
10329 CPAN::Distribution::as_glimpse(), CPAN::Distribution::as_string(),
10330 CPAN::Distribution::clean(), CPAN::Distribution::containsmods(),
10331 CPAN::Distribution::cvs_import(), CPAN::Distribution::dir(),
10332 CPAN::Distribution::force($method,@args), CPAN::Distribution::get(),
10333 CPAN::Distribution::install(), CPAN::Distribution::isa_perl(),
10334 CPAN::Distribution::look(), CPAN::Distribution::make(),
10335 CPAN::Distribution::prereq_pm(), CPAN::Distribution::readme(),
10336 CPAN::Distribution::test(), CPAN::Distribution::uptodate(),
10337 CPAN::Index::force_reload(), CPAN::Index::reload(), CPAN::InfoObj::dump(),
10338 CPAN::Module::as_glimpse(), CPAN::Module::as_string(),
10339 CPAN::Module::clean(), CPAN::Module::cpan_file(),
10340 CPAN::Module::cpan_version(), CPAN::Module::cvs_import(),
10341 CPAN::Module::description(), CPAN::Module::force($method,@args),
10342 CPAN::Module::get(), CPAN::Module::inst_file(),
10343 CPAN::Module::inst_version(), CPAN::Module::install(),
10344 CPAN::Module::look(), CPAN::Module::make(),
10345 CPAN::Module::manpage_headline(), CPAN::Module::readme(),
10346 CPAN::Module::test(), CPAN::Module::uptodate(), CPAN::Module::userid()
10347
10348 =item Cache Manager
10349
10350 =item Bundles
10351
10352 =item Prerequisites
10353
10354 =item Finding packages and VERSION
10355
10356 =item Debugging
10357
10358 =item Floppy, Zip, Offline Mode
10359
10360 =back
10361
10362 =item CONFIGURATION
10363
10364 C<o conf E<lt>scalar optionE<gt>>, C<o conf E<lt>scalar optionE<gt>
10365 E<lt>valueE<gt>>, C<o conf E<lt>list optionE<gt>>, C<o conf E<lt>list
10366 optionE<gt> [shift|pop]>, C<o conf E<lt>list optionE<gt>
10367 [unshift|push|splice] E<lt>listE<gt>>
10368
10369 =over 4
10370
10371 =item Note on urllist parameter's format
10372
10373 =item urllist parameter has CD-ROM support
10374
10375 =back
10376
10377 =item SECURITY
10378
10379 =item EXPORT
10380
10381 =item POPULATE AN INSTALLATION WITH LOTS OF MODULES
10382
10383 =item WORKING WITH CPAN.pm BEHIND FIREWALLS
10384
10385 =over 4
10386
10387 =item Three basic types of firewalls
10388
10389 http firewall, ftp firewall, One way visibility, SOCKS, IP Masquerade
10390
10391 =item Configuring lynx or ncftp for going through a firewall
10392
10393 =back
10394
10395 =item FAQ
10396
10397 1), 2), 3), 4), 5), 6), 7), 8), 9), 10)
10398
10399 =item BUGS
10400
10401 =item AUTHOR
10402
10403 =item TRANSLATIONS
10404
10405 =item SEE ALSO
10406
10407 =back
10408
10409 =head2 CPAN::FirstTime - Utility for CPAN::Config file Initialization
10410
10411 =over 4
10412
10413 =item SYNOPSIS
10414
10415 =item DESCRIPTION
10416
10417 =back
10418
10419 =head2 CPANox, CPAN::Nox - Wrapper around CPAN.pm without using any XS
10420 module
10421
10422 =over 4
10423
10424 =item SYNOPSIS
10425
10426 =item DESCRIPTION
10427
10428 =item  SEE ALSO
10429
10430 =back
10431
10432 =head2 Carp, carp    - warn of errors (from perspective of caller)
10433
10434 =over 4
10435
10436 =item SYNOPSIS
10437
10438 =item DESCRIPTION
10439
10440 =over 4
10441
10442 =item Forcing a Stack Trace
10443
10444 =back
10445
10446 =item BUGS
10447
10448 =back
10449
10450 =head2 Carp::Heavy, Carp heavy machinery - no user serviceable parts inside
10451
10452 =head2 Class::ISA -- report the search path for a class's ISA tree
10453
10454 =over 4
10455
10456 =item SYNOPSIS
10457
10458 =item DESCRIPTION
10459
10460 =item FUNCTIONS
10461
10462 the function Class::ISA::super_path($CLASS), the function
10463 Class::ISA::self_and_super_path($CLASS), the function
10464 Class::ISA::self_and_super_versions($CLASS)
10465
10466 =item CAUTIONARY NOTES
10467
10468 =item COPYRIGHT
10469
10470 =item AUTHOR
10471
10472 =back
10473
10474 =head2 Class::Struct - declare struct-like datatypes as Perl classes
10475
10476 =over 4
10477
10478 =item SYNOPSIS
10479
10480 =item DESCRIPTION
10481
10482 =over 4
10483
10484 =item The C<struct()> function
10485
10486 =item Class Creation at Compile Time
10487
10488 =item Element Types and Accessor Methods
10489
10490 Scalar (C<'$'> or C<'*$'>), Array (C<'@'> or C<'*@'>), Hash (C<'%'> or
10491 C<'*%'>), Class (C<'Class_Name'> or C<'*Class_Name'>)
10492
10493 =item Initializing with C<new>
10494
10495 =back
10496
10497 =item EXAMPLES
10498
10499 Example 1, Example 2, Example 3
10500
10501 =item Author and Modification History
10502
10503 =back
10504
10505 =head2 Config - access Perl configuration information
10506
10507 =over 4
10508
10509 =item SYNOPSIS
10510
10511 =item DESCRIPTION
10512
10513 myconfig(), config_sh(), config_vars(@names)
10514
10515 =item EXAMPLE
10516
10517 =item WARNING
10518
10519 =item GLOSSARY
10520
10521 =over 4
10522
10523 =item _
10524
10525 C<_a>, C<_exe>, C<_o>
10526
10527 =item a
10528
10529 C<afs>, C<afsroot>, C<alignbytes>, C<ansi2knr>, C<aphostname>,
10530 C<api_revision>, C<api_subversion>, C<api_version>, C<api_versionstring>,
10531 C<ar>, C<archlib>, C<archlibexp>, C<archname64>, C<archname>, C<archobjs>,
10532 C<asctime_r_proto>, C<awk>
10533
10534 =item b
10535
10536 C<baserev>, C<bash>, C<bin>, C<binexp>, C<bison>, C<byacc>, C<byteorder>
10537
10538 =item c
10539
10540 C<c>, C<castflags>, C<cat>, C<cc>, C<cccdlflags>, C<ccdlflags>, C<ccflags>,
10541 C<ccflags_uselargefiles>, C<ccname>, C<ccsymbols>, C<ccversion>, C<cf_by>,
10542 C<cf_email>, C<cf_time>, C<charsize>, C<chgrp>, C<chmod>, C<chown>,
10543 C<clocktype>, C<comm>, C<compress>, C<contains>, C<cp>, C<cpio>, C<cpp>,
10544 C<cpp_stuff>, C<cppccsymbols>, C<cppflags>, C<cpplast>, C<cppminus>,
10545 C<cpprun>, C<cppstdin>, C<cppsymbols>, C<crypt_r_proto>, C<cryptlib>,
10546 C<csh>, C<ctermid_r_proto>, C<ctime_r_proto>
10547
10548 =item d
10549
10550 C<d__fwalk>, C<d_access>, C<d_accessx>, C<d_alarm>, C<d_archlib>,
10551 C<d_asctime_r>, C<d_atolf>, C<d_atoll>, C<d_attribut>, C<d_bcmp>,
10552 C<d_bcopy>, C<d_bsd>, C<d_bsdgetpgrp>, C<d_bsdsetpgrp>, C<d_bzero>,
10553 C<d_casti32>, C<d_castneg>, C<d_charvspr>, C<d_chown>, C<d_chroot>,
10554 C<d_chsize>, C<d_class>, C<d_closedir>, C<d_cmsghdr_s>, C<d_const>,
10555 C<d_crypt>, C<d_crypt_r>, C<d_csh>, C<d_ctermid_r>, C<d_ctime_r>,
10556 C<d_cuserid>, C<d_dbl_dig>, C<d_dbminitproto>, C<d_difftime>, C<d_dirfd>,
10557 C<d_dirnamlen>, C<d_dlerror>, C<d_dlopen>, C<d_dlsymun>, C<d_dosuid>,
10558 C<d_drand48_r>, C<d_drand48proto>, C<d_dup2>, C<d_eaccess>, C<d_endgrent>,
10559 C<d_endgrent_r>, C<d_endhent>, C<d_endhostent_r>, C<d_endnent>,
10560 C<d_endnetent_r>, C<d_endpent>, C<d_endprotoent_r>, C<d_endpwent>,
10561 C<d_endpwent_r>, C<d_endsent>, C<d_endservent_r>, C<d_eofnblk>,
10562 C<d_eunice>, C<d_fchdir>, C<d_fchmod>, C<d_fchown>, C<d_fcntl>,
10563 C<d_fcntl_can_lock>, C<d_fd_macros>, C<d_fd_set>, C<d_fds_bits>,
10564 C<d_fgetpos>, C<d_finite>, C<d_finitel>, C<d_flexfnam>, C<d_flock>,
10565 C<d_flockproto>, C<d_fork>, C<d_fp_class>, C<d_fpathconf>, C<d_fpclass>,
10566 C<d_fpclassify>, C<d_fpclassl>, C<d_fpos64_t>, C<d_frexpl>, C<d_fs_data_s>,
10567 C<d_fseeko>, C<d_fsetpos>, C<d_fstatfs>, C<d_fstatvfs>, C<d_fsync>,
10568 C<d_ftello>, C<d_ftime>, C<d_Gconvert>, C<d_getcwd>, C<d_getespwnam>,
10569 C<d_getfsstat>, C<d_getgrent>, C<d_getgrent_r>, C<d_getgrgid_r>,
10570 C<d_getgrnam_r>, C<d_getgrps>, C<d_gethbyaddr>, C<d_gethbyname>,
10571 C<d_gethent>, C<d_gethname>, C<d_gethostbyaddr_r>, C<d_gethostbyname_r>,
10572 C<d_gethostent_r>, C<d_gethostprotos>, C<d_getitimer>, C<d_getlogin>,
10573 C<d_getlogin_r>, C<d_getmnt>, C<d_getmntent>, C<d_getnbyaddr>,
10574 C<d_getnbyname>, C<d_getnent>, C<d_getnetbyaddr_r>, C<d_getnetbyname_r>,
10575 C<d_getnetent_r>, C<d_getnetprotos>, C<d_getpagsz>, C<d_getpbyname>,
10576 C<d_getpbynumber>, C<d_getpent>, C<d_getpgid>, C<d_getpgrp2>, C<d_getpgrp>,
10577 C<d_getppid>, C<d_getprior>, C<d_getprotobyname_r>,
10578 C<d_getprotobynumber_r>, C<d_getprotoent_r>, C<d_getprotoprotos>,
10579 C<d_getprpwnam>, C<d_getpwent>, C<d_getpwent_r>, C<d_getpwnam_r>,
10580 C<d_getpwuid_r>, C<d_getsbyname>, C<d_getsbyport>, C<d_getsent>,
10581 C<d_getservbyname_r>, C<d_getservbyport_r>, C<d_getservent_r>,
10582 C<d_getservprotos>, C<d_getspnam>, C<d_getspnam_r>, C<d_gettimeod>,
10583 C<d_gmtime_r>, C<d_gnulibc>, C<d_grpasswd>, C<d_hasmntopt>, C<d_htonl>,
10584 C<d_index>, C<d_inetaton>, C<d_int64_t>, C<d_isascii>, C<d_isfinite>,
10585 C<d_isinf>, C<d_isnan>, C<d_isnanl>, C<d_killpg>, C<d_lchown>,
10586 C<d_ldbl_dig>, C<d_link>, C<d_localtime_r>, C<d_locconv>, C<d_lockf>,
10587 C<d_longdbl>, C<d_longlong>, C<d_lseekproto>, C<d_lstat>, C<d_madvise>,
10588 C<d_mblen>, C<d_mbstowcs>, C<d_mbtowc>, C<d_memchr>, C<d_memcmp>,
10589 C<d_memcpy>, C<d_memmove>, C<d_memset>, C<d_mkdir>, C<d_mkdtemp>,
10590 C<d_mkfifo>, C<d_mkstemp>, C<d_mkstemps>, C<d_mktime>, C<d_mmap>,
10591 C<d_modfl>, C<d_modfl_pow32_bug>, C<d_mprotect>, C<d_msg>, C<d_msg_ctrunc>,
10592 C<d_msg_dontroute>, C<d_msg_oob>, C<d_msg_peek>, C<d_msg_proxy>,
10593 C<d_msgctl>, C<d_msgget>, C<d_msghdr_s>, C<d_msgrcv>, C<d_msgsnd>,
10594 C<d_msync>, C<d_munmap>, C<d_mymalloc>, C<d_nice>, C<d_nl_langinfo>,
10595 C<d_nv_preserves_uv>, C<d_off64_t>, C<d_old_pthread_create_joinable>,
10596 C<d_oldpthreads>, C<d_oldsock>, C<d_open3>, C<d_pathconf>, C<d_pause>,
10597 C<d_perl_otherlibdirs>, C<d_phostname>, C<d_pipe>, C<d_poll>,
10598 C<d_portable>, C<d_PRId64>, C<d_PRIeldbl>, C<d_PRIEUldbl>, C<d_PRIfldbl>,
10599 C<d_PRIFUldbl>, C<d_PRIgldbl>, C<d_PRIGUldbl>, C<d_PRIi64>, C<d_PRIo64>,
10600 C<d_PRIu64>, C<d_PRIx64>, C<d_PRIXU64>, C<d_procselfexe>,
10601 C<d_pthread_atfork>, C<d_pthread_yield>, C<d_pwage>, C<d_pwchange>,
10602 C<d_pwclass>, C<d_pwcomment>, C<d_pwexpire>, C<d_pwgecos>, C<d_pwpasswd>,
10603 C<d_pwquota>, C<d_qgcvt>, C<d_quad>, C<d_random_r>, C<d_readdir64_r>,
10604 C<d_readdir>, C<d_readdir_r>, C<d_readlink>, C<d_readv>, C<d_recvmsg>,
10605 C<d_rename>, C<d_rewinddir>, C<d_rmdir>, C<d_safebcpy>, C<d_safemcpy>,
10606 C<d_sanemcmp>, C<d_sbrkproto>, C<d_sched_yield>, C<d_scm_rights>,
10607 C<d_SCNfldbl>, C<d_seekdir>, C<d_select>, C<d_sem>, C<d_semctl>,
10608 C<d_semctl_semid_ds>, C<d_semctl_semun>, C<d_semget>, C<d_semop>,
10609 C<d_sendmsg>, C<d_setegid>, C<d_seteuid>, C<d_setgrent>, C<d_setgrent_r>,
10610 C<d_setgrps>, C<d_sethent>, C<d_sethostent_r>, C<d_setitimer>,
10611 C<d_setlinebuf>, C<d_setlocale>, C<d_setlocale_r>, C<d_setnent>,
10612 C<d_setnetent_r>, C<d_setpent>, C<d_setpgid>, C<d_setpgrp2>, C<d_setpgrp>,
10613 C<d_setprior>, C<d_setproctitle>, C<d_setprotoent_r>, C<d_setpwent>,
10614 C<d_setpwent_r>, C<d_setregid>, C<d_setresgid>, C<d_setresuid>,
10615 C<d_setreuid>, C<d_setrgid>, C<d_setruid>, C<d_setsent>, C<d_setservent_r>,
10616 C<d_setsid>, C<d_setvbuf>, C<d_sfio>, C<d_shm>, C<d_shmat>,
10617 C<d_shmatprototype>, C<d_shmctl>, C<d_shmdt>, C<d_shmget>, C<d_sigaction>,
10618 C<d_sigprocmask>, C<d_sigsetjmp>, C<d_sockatmark>, C<d_sockatmarkproto>,
10619 C<d_socket>, C<d_socklen_t>, C<d_sockpair>, C<d_socks5_init>, C<d_sqrtl>,
10620 C<d_srand48_r>, C<d_srandom_r>, C<d_sresgproto>, C<d_sresuproto>,
10621 C<d_statblks>, C<d_statfs_f_flags>, C<d_statfs_s>, C<d_statvfs>,
10622 C<d_stdio_cnt_lval>, C<d_stdio_ptr_lval>, C<d_stdio_ptr_lval_nochange_cnt>,
10623 C<d_stdio_ptr_lval_sets_cnt>, C<d_stdio_stream_array>, C<d_stdiobase>,
10624 C<d_stdstdio>, C<d_strchr>, C<d_strcoll>, C<d_strctcpy>, C<d_strerrm>,
10625 C<d_strerror>, C<d_strerror_r>, C<d_strftime>, C<d_strtod>, C<d_strtol>,
10626 C<d_strtold>, C<d_strtoll>, C<d_strtoq>, C<d_strtoul>, C<d_strtoull>,
10627 C<d_strtouq>, C<d_strxfrm>, C<d_suidsafe>, C<d_symlink>, C<d_syscall>,
10628 C<d_syscallproto>, C<d_sysconf>, C<d_sysernlst>, C<d_syserrlst>,
10629 C<d_system>, C<d_tcgetpgrp>, C<d_tcsetpgrp>, C<d_telldir>,
10630 C<d_telldirproto>, C<d_time>, C<d_times>, C<d_tm_tm_gmtoff>,
10631 C<d_tm_tm_zone>, C<d_tmpnam_r>, C<d_truncate>, C<d_ttyname_r>, C<d_tzname>,
10632 C<d_u32align>, C<d_ualarm>, C<d_umask>, C<d_uname>, C<d_union_semun>,
10633 C<d_unordered>, C<d_usleep>, C<d_usleepproto>, C<d_ustat>, C<d_vendorarch>,
10634 C<d_vendorbin>, C<d_vendorlib>, C<d_vfork>, C<d_void_closedir>,
10635 C<d_voidsig>, C<d_voidtty>, C<d_volatile>, C<d_vprintf>, C<d_wait4>,
10636 C<d_waitpid>, C<d_wcstombs>, C<d_wctomb>, C<d_writev>, C<d_xenix>, C<date>,
10637 C<db_hashtype>, C<db_prefixtype>, C<db_version_major>, C<db_version_minor>,
10638 C<db_version_patch>, C<defvoidused>, C<direntrytype>, C<dlext>, C<dlsrc>,
10639 C<doublesize>, C<drand01>, C<drand48_r_proto>, C<dynamic_ext>
10640
10641 =item e
10642
10643 C<eagain>, C<ebcdic>, C<echo>, C<egrep>, C<emacs>, C<endgrent_r_proto>,
10644 C<endhostent_r_proto>, C<endnetent_r_proto>, C<endprotoent_r_proto>,
10645 C<endpwent_r_proto>, C<endservent_r_proto>, C<eunicefix>, C<exe_ext>,
10646 C<expr>, C<extensions>, C<extras>
10647
10648 =item f
10649
10650 C<fflushall>, C<fflushNULL>, C<find>, C<firstmakefile>, C<flex>,
10651 C<fpossize>, C<fpostype>, C<freetype>, C<from>, C<full_ar>, C<full_csh>,
10652 C<full_sed>
10653
10654 =item g
10655
10656 C<gccosandvers>, C<gccversion>, C<getgrent_r_proto>, C<getgrgid_r_proto>,
10657 C<getgrnam_r_proto>, C<gethostbyaddr_r_proto>, C<gethostbyname_r_proto>,
10658 C<gethostent_r_proto>, C<getlogin_r_proto>, C<getnetbyaddr_r_proto>,
10659 C<getnetbyname_r_proto>, C<getnetent_r_proto>, C<getprotobyname_r_proto>,
10660 C<getprotobynumber_r_proto>, C<getprotoent_r_proto>, C<getpwent_r_proto>,
10661 C<getpwnam_r_proto>, C<getpwuid_r_proto>, C<getservbyname_r_proto>,
10662 C<getservbyport_r_proto>, C<getservent_r_proto>, C<getspnam_r_proto>,
10663 C<gidformat>, C<gidsign>, C<gidsize>, C<gidtype>, C<glibpth>, C<gmake>,
10664 C<gmtime_r_proto>, C<gnulibc_version>, C<grep>, C<groupcat>, C<groupstype>,
10665 C<gzip>
10666
10667 =item h
10668
10669 C<h_fcntl>, C<h_sysfile>, C<hint>, C<hostcat>
10670
10671 =item i
10672
10673 C<i16size>, C<i16type>, C<i32size>, C<i32type>, C<i64size>, C<i64type>,
10674 C<i8size>, C<i8type>, C<i_arpainet>, C<i_bsdioctl>, C<i_crypt>, C<i_db>,
10675 C<i_dbm>, C<i_dirent>, C<i_dld>, C<i_dlfcn>, C<i_fcntl>, C<i_float>,
10676 C<i_fp>, C<i_fp_class>, C<i_gdbm>, C<i_grp>, C<i_ieeefp>, C<i_inttypes>,
10677 C<i_langinfo>, C<i_libutil>, C<i_limits>, C<i_locale>, C<i_machcthr>,
10678 C<i_malloc>, C<i_math>, C<i_memory>, C<i_mntent>, C<i_ndbm>, C<i_netdb>,
10679 C<i_neterrno>, C<i_netinettcp>, C<i_niin>, C<i_poll>, C<i_prot>,
10680 C<i_pthread>, C<i_pwd>, C<i_rpcsvcdbm>, C<i_sfio>, C<i_sgtty>, C<i_shadow>,
10681 C<i_socks>, C<i_stdarg>, C<i_stddef>, C<i_stdlib>, C<i_string>,
10682 C<i_sunmath>, C<i_sysaccess>, C<i_sysdir>, C<i_sysfile>, C<i_sysfilio>,
10683 C<i_sysin>, C<i_sysioctl>, C<i_syslog>, C<i_sysmman>, C<i_sysmode>,
10684 C<i_sysmount>, C<i_sysndir>, C<i_sysparam>, C<i_sysresrc>, C<i_syssecrt>,
10685 C<i_sysselct>, C<i_syssockio>, C<i_sysstat>, C<i_sysstatfs>,
10686 C<i_sysstatvfs>, C<i_systime>, C<i_systimek>, C<i_systimes>, C<i_systypes>,
10687 C<i_sysuio>, C<i_sysun>, C<i_sysutsname>, C<i_sysvfs>, C<i_syswait>,
10688 C<i_termio>, C<i_termios>, C<i_time>, C<i_unistd>, C<i_ustat>, C<i_utime>,
10689 C<i_values>, C<i_varargs>, C<i_varhdr>, C<i_vfork>,
10690 C<ignore_versioned_solibs>, C<inc_version_list>, C<inc_version_list_init>,
10691 C<incpath>, C<inews>, C<installarchlib>, C<installbin>, C<installman1dir>,
10692 C<installman3dir>, C<installprefix>, C<installprefixexp>,
10693 C<installprivlib>, C<installscript>, C<installsitearch>, C<installsitebin>,
10694 C<installsitelib>, C<installstyle>, C<installusrbinperl>,
10695 C<installvendorarch>, C<installvendorbin>, C<installvendorlib>, C<intsize>,
10696 C<issymlink>, C<ivdformat>, C<ivsize>, C<ivtype>
10697
10698 =item k
10699
10700 C<known_extensions>, C<ksh>
10701
10702 =item l
10703
10704 C<ld>, C<lddlflags>, C<ldflags>, C<ldflags_uselargefiles>, C<ldlibpthname>,
10705 C<less>, C<lib_ext>, C<libc>, C<libperl>, C<libpth>, C<libs>, C<libsdirs>,
10706 C<libsfiles>, C<libsfound>, C<libspath>, C<libswanted>,
10707 C<libswanted_uselargefiles>, C<line>, C<lint>, C<lkflags>, C<ln>, C<lns>,
10708 C<localtime_r_proto>, C<locincpth>, C<loclibpth>, C<longdblsize>,
10709 C<longlongsize>, C<longsize>, C<lp>, C<lpr>, C<ls>, C<lseeksize>,
10710 C<lseektype>
10711
10712 =item m
10713
10714 C<mail>, C<mailx>, C<make>, C<make_set_make>, C<mallocobj>, C<mallocsrc>,
10715 C<malloctype>, C<man1dir>, C<man1direxp>, C<man1ext>, C<man3dir>,
10716 C<man3direxp>, C<man3ext>
10717
10718 =item M
10719
10720 C<Mcc>, C<mips_type>, C<mkdir>, C<mmaptype>, C<modetype>, C<more>,
10721 C<multiarch>, C<mv>, C<myarchname>, C<mydomain>, C<myhostname>, C<myuname>
10722
10723 =item n
10724
10725 C<n>, C<need_va_copy>, C<netdb_hlen_type>, C<netdb_host_type>,
10726 C<netdb_name_type>, C<netdb_net_type>, C<nm>, C<nm_opt>, C<nm_so_opt>,
10727 C<nonxs_ext>, C<nroff>, C<nv_preserves_uv_bits>, C<nveformat>,
10728 C<nvEUformat>, C<nvfformat>, C<nvFUformat>, C<nvgformat>, C<nvGUformat>,
10729 C<nvsize>, C<nvtype>
10730
10731 =item o
10732
10733 C<o_nonblock>, C<obj_ext>, C<old_pthread_create_joinable>, C<optimize>,
10734 C<orderlib>, C<osname>, C<osvers>, C<otherlibdirs>
10735
10736 =item p
10737
10738 C<package>, C<pager>, C<passcat>, C<patchlevel>, C<path_sep>, C<perl5>,
10739 C<perl>, C<perl_patchlevel>
10740
10741 =item P
10742
10743 C<PERL_REVISION>, C<PERL_SUBVERSION>, C<PERL_VERSION>, C<perladmin>,
10744 C<perllibs>, C<perlpath>, C<pg>, C<phostname>, C<pidtype>, C<plibpth>,
10745 C<pm_apiversion>, C<pmake>, C<pr>, C<prefix>, C<prefixexp>, C<privlib>,
10746 C<privlibexp>, C<procselfexe>, C<prototype>, C<ptrsize>
10747
10748 =item q
10749
10750 C<quadkind>, C<quadtype>
10751
10752 =item r
10753
10754 C<randbits>, C<randfunc>, C<random_r_proto>, C<randseedtype>, C<ranlib>,
10755 C<rd_nodata>, C<readdir64_r_proto>, C<readdir_r_proto>, C<revision>, C<rm>,
10756 C<rmail>, C<run>, C<runnm>
10757
10758 =item s
10759
10760 C<sched_yield>, C<scriptdir>, C<scriptdirexp>, C<sed>, C<seedfunc>,
10761 C<selectminbits>, C<selecttype>, C<sendmail>, C<setgrent_r_proto>,
10762 C<sethostent_r_proto>, C<setlocale_r_proto>, C<setnetent_r_proto>,
10763 C<setprotoent_r_proto>, C<setpwent_r_proto>, C<setservent_r_proto>, C<sh>,
10764 C<shar>, C<sharpbang>, C<shmattype>, C<shortsize>, C<shrpenv>, C<shsharp>,
10765 C<sig_count>, C<sig_name>, C<sig_name_init>, C<sig_num>, C<sig_num_init>,
10766 C<sig_size>, C<signal_t>, C<sitearch>, C<sitearchexp>, C<sitebin>,
10767 C<sitebinexp>, C<sitelib>, C<sitelib_stem>, C<sitelibexp>, C<siteprefix>,
10768 C<siteprefixexp>, C<sizesize>, C<sizetype>, C<sleep>, C<smail>, C<so>,
10769 C<sockethdr>, C<socketlib>, C<socksizetype>, C<sort>, C<spackage>,
10770 C<spitshell>, C<sPRId64>, C<sPRIeldbl>, C<sPRIEUldbl>, C<sPRIfldbl>,
10771 C<sPRIFUldbl>, C<sPRIgldbl>, C<sPRIGUldbl>, C<sPRIi64>, C<sPRIo64>,
10772 C<sPRIu64>, C<sPRIx64>, C<sPRIXU64>, C<srand48_r_proto>,
10773 C<srandom_r_proto>, C<src>, C<sSCNfldbl>, C<ssizetype>, C<startperl>,
10774 C<startsh>, C<static_ext>, C<stdchar>, C<stdio_base>, C<stdio_bufsiz>,
10775 C<stdio_cnt>, C<stdio_filbuf>, C<stdio_ptr>, C<stdio_stream_array>,
10776 C<strerror_r_proto>, C<strings>, C<submit>, C<subversion>, C<sysman>
10777
10778 =item t
10779
10780 C<tail>, C<tar>, C<targetarch>, C<tbl>, C<tee>, C<test>, C<timeincl>,
10781 C<timetype>, C<tmpnam_r_proto>, C<to>, C<touch>, C<tr>, C<trnl>, C<troff>,
10782 C<ttyname_r_proto>
10783
10784 =item u
10785
10786 C<u16size>, C<u16type>, C<u32size>, C<u32type>, C<u64size>, C<u64type>,
10787 C<u8size>, C<u8type>, C<uidformat>, C<uidsign>, C<uidsize>, C<uidtype>,
10788 C<uname>, C<uniq>, C<uquadtype>, C<use5005threads>, C<use64bitall>,
10789 C<use64bitint>, C<usecrosscompile>, C<usedl>, C<useithreads>,
10790 C<uselargefiles>, C<uselongdouble>, C<usemorebits>, C<usemultiplicity>,
10791 C<usemymalloc>, C<usenm>, C<useopcode>, C<useperlio>, C<useposix>,
10792 C<usereentrant>, C<usesfio>, C<useshrplib>, C<usesocks>, C<usethreads>,
10793 C<usevendorprefix>, C<usevfork>, C<usrinc>, C<uuname>, C<uvoformat>,
10794 C<uvsize>, C<uvtype>, C<uvuformat>, C<uvxformat>, C<uvXUformat>
10795
10796 =item v
10797
10798 C<vendorarch>, C<vendorarchexp>, C<vendorbin>, C<vendorbinexp>,
10799 C<vendorlib>, C<vendorlib_stem>, C<vendorlibexp>, C<vendorprefix>,
10800 C<vendorprefixexp>, C<version>, C<version_patchlevel_string>,
10801 C<versiononly>, C<vi>, C<voidflags>
10802
10803 =item x
10804
10805 C<xlibpth>, C<xs_apiversion>
10806
10807 =item y
10808
10809 C<yacc>, C<yaccflags>
10810
10811 =item z
10812
10813 C<zcat>, C<zip>
10814
10815 =back
10816
10817 =item NOTE
10818
10819 =back
10820
10821 =head2 Cwd - get pathname of current working directory
10822
10823 =over 4
10824
10825 =item SYNOPSIS
10826
10827 =item DESCRIPTION
10828
10829 =over 4
10830
10831 =item getcwd and friends
10832
10833 getcwd, cwd, fastcwd, fastgetcwd
10834
10835 =item abs_path and friends
10836
10837 abs_path, realpath, fast_abs_path
10838
10839 =item $ENV{PWD}
10840
10841 =back
10842
10843 =item NOTES
10844
10845 =item SEE ALSO
10846
10847 =back
10848
10849 =head2 DB - programmatic interface to the Perl debugging API (draft,
10850 subject to
10851 change)
10852
10853 =over 4
10854
10855 =item SYNOPSIS
10856
10857 =item DESCRIPTION
10858
10859 =over 4
10860
10861 =item Global Variables
10862
10863  $DB::sub,  %DB::sub,  $DB::single,  $DB::signal,  $DB::trace,  @DB::args,
10864 @DB::dbline,  %DB::dbline,  $DB::package,  $DB::filename,  $DB::subname,
10865 $DB::lineno
10866
10867 =item API Methods
10868
10869 CLIENT->register(), CLIENT->evalcode(STRING), CLIENT->skippkg('D::hide'),
10870 CLIENT->run(), CLIENT->step(), CLIENT->next(), CLIENT->done()
10871
10872 =item Client Callback Methods
10873
10874 CLIENT->init(), CLIENT->prestop([STRING]), CLIENT->stop(), CLIENT->idle(),
10875 CLIENT->poststop([STRING]), CLIENT->evalcode(STRING), CLIENT->cleanup(),
10876 CLIENT->output(LIST)
10877
10878 =back
10879
10880 =item BUGS
10881
10882 =item AUTHOR
10883
10884 =back
10885
10886 =head2 DB_File - Perl5 access to Berkeley DB version 1.x
10887
10888 =over 4
10889
10890 =item SYNOPSIS
10891
10892 =item DESCRIPTION
10893
10894 B<DB_HASH>, B<DB_BTREE>, B<DB_RECNO>
10895
10896 =over 4
10897
10898 =item Using DB_File with Berkeley DB version 2 or greater
10899
10900 =item Interface to Berkeley DB
10901
10902 =item Opening a Berkeley DB Database File
10903
10904 =item Default Parameters
10905
10906 =item In Memory Databases
10907
10908 =back
10909
10910 =item DB_HASH
10911
10912 =over 4
10913
10914 =item A Simple Example
10915
10916 =back
10917
10918 =item DB_BTREE
10919
10920 =over 4
10921
10922 =item Changing the BTREE sort order
10923
10924 =item Handling Duplicate Keys
10925
10926 =item The get_dup() Method
10927
10928 =item The find_dup() Method
10929
10930 =item The del_dup() Method
10931
10932 =item Matching Partial Keys
10933
10934 =back
10935
10936 =item DB_RECNO
10937
10938 =over 4
10939
10940 =item The 'bval' Option
10941
10942 =item A Simple Example
10943
10944 =item Extra RECNO Methods
10945
10946 B<$X-E<gt>push(list) ;>, B<$value = $X-E<gt>pop ;>, B<$X-E<gt>shift>,
10947 B<$X-E<gt>unshift(list) ;>, B<$X-E<gt>length>, B<$X-E<gt>splice(offset,
10948 length, elements);>
10949
10950 =item Another Example
10951
10952 =back
10953
10954 =item THE API INTERFACE
10955
10956 B<$status = $X-E<gt>get($key, $value [, $flags]) ;>, B<$status =
10957 $X-E<gt>put($key, $value [, $flags]) ;>, B<$status = $X-E<gt>del($key [,
10958 $flags]) ;>, B<$status = $X-E<gt>fd ;>, B<$status = $X-E<gt>seq($key,
10959 $value, $flags) ;>, B<$status = $X-E<gt>sync([$flags]) ;>
10960
10961 =item DBM FILTERS
10962
10963 B<filter_store_key>, B<filter_store_value>, B<filter_fetch_key>,
10964 B<filter_fetch_value>
10965
10966 =over 4
10967
10968 =item The Filter
10969
10970 =item An Example -- the NULL termination problem.
10971
10972 =item Another Example -- Key is a C int.
10973
10974 =back
10975
10976 =item HINTS AND TIPS
10977
10978 =over 4
10979
10980 =item Locking: The Trouble with fd
10981
10982 =item Safe ways to lock a database
10983
10984 B<Tie::DB_Lock>, B<Tie::DB_LockFile>, B<DB_File::Lock>
10985
10986 =item Sharing Databases With C Applications
10987
10988 =item The untie() Gotcha
10989
10990 =back
10991
10992 =item COMMON QUESTIONS
10993
10994 =over 4
10995
10996 =item Why is there Perl source in my database?
10997
10998 =item How do I store complex data structures with DB_File?
10999
11000 =item What does "Invalid Argument" mean?
11001
11002 =item What does "Bareword 'DB_File' not allowed" mean?
11003
11004 =back
11005
11006 =item REFERENCES
11007
11008 =item HISTORY
11009
11010 =item BUGS
11011
11012 =item AVAILABILITY
11013
11014 =item COPYRIGHT
11015
11016 =item SEE ALSO
11017
11018 =item AUTHOR
11019
11020 =back
11021
11022 =head2 Data::Dumper - stringified perl data structures, suitable for both
11023 printing and C<eval>
11024
11025 =over 4
11026
11027 =item SYNOPSIS
11028
11029 =item DESCRIPTION
11030
11031 =over 4
11032
11033 =item Methods
11034
11035 I<PACKAGE>->new(I<ARRAYREF [>, I<ARRAYREF]>), I<$OBJ>->Dump  I<or>
11036 I<PACKAGE>->Dump(I<ARRAYREF [>, I<ARRAYREF]>), I<$OBJ>->Seen(I<[HASHREF]>),
11037 I<$OBJ>->Values(I<[ARRAYREF]>), I<$OBJ>->Names(I<[ARRAYREF]>),
11038 I<$OBJ>->Reset
11039
11040 =item Functions
11041
11042 Dumper(I<LIST>)
11043
11044 =item Configuration Variables or Methods
11045
11046 $Data::Dumper::Indent  I<or>  I<$OBJ>->Indent(I<[NEWVAL]>),
11047 $Data::Dumper::Purity  I<or>  I<$OBJ>->Purity(I<[NEWVAL]>),
11048 $Data::Dumper::Pad  I<or>  I<$OBJ>->Pad(I<[NEWVAL]>),
11049 $Data::Dumper::Varname  I<or>  I<$OBJ>->Varname(I<[NEWVAL]>),
11050 $Data::Dumper::Useqq  I<or>  I<$OBJ>->Useqq(I<[NEWVAL]>),
11051 $Data::Dumper::Terse  I<or>  I<$OBJ>->Terse(I<[NEWVAL]>),
11052 $Data::Dumper::Freezer  I<or>  $I<OBJ>->Freezer(I<[NEWVAL]>),
11053 $Data::Dumper::Toaster  I<or>  $I<OBJ>->Toaster(I<[NEWVAL]>),
11054 $Data::Dumper::Deepcopy  I<or>  $I<OBJ>->Deepcopy(I<[NEWVAL]>),
11055 $Data::Dumper::Quotekeys  I<or>  $I<OBJ>->Quotekeys(I<[NEWVAL]>),
11056 $Data::Dumper::Bless  I<or>  $I<OBJ>->Bless(I<[NEWVAL]>),
11057 $Data::Dumper::Maxdepth  I<or>  $I<OBJ>->Maxdepth(I<[NEWVAL]>),
11058 $Data::Dumper::Useperl  I<or>  $I<OBJ>->Useperl(I<[NEWVAL]>),
11059 $Data::Dumper::Sortkeys  I<or>  $I<OBJ>->Sortkeys(I<[NEWVAL]>),
11060 $Data::Dumper::Deparse  I<or>  $I<OBJ>->Deparse(I<[NEWVAL]>)
11061
11062 =item Exports
11063
11064 Dumper
11065
11066 =back
11067
11068 =item EXAMPLES
11069
11070 =item BUGS
11071
11072 =item AUTHOR
11073
11074 =item VERSION
11075
11076 =item SEE ALSO
11077
11078 =back
11079
11080 =head2 Devel::DProf - a Perl code profiler
11081
11082 =over 4
11083
11084 =item SYNOPSIS
11085
11086 =item DESCRIPTION
11087
11088 =item PROFILE FORMAT
11089
11090 =item AUTOLOAD
11091
11092 =item ENVIRONMENT
11093
11094 =item BUGS
11095
11096 =item SEE ALSO
11097
11098 =back
11099
11100 =head2 Devel::PPPort, Perl/Pollution/Portability
11101
11102 =over 4
11103
11104 =item SYNOPSIS
11105
11106 =item DESCRIPTION
11107
11108 =over 4
11109
11110 =item WriteFile
11111
11112 =back
11113
11114 =item ppport.h
11115
11116 =item AUTHOR
11117
11118 =item SEE ALSO
11119
11120 =back
11121
11122 =head2 Devel::Peek - A data debugging tool for the XS programmer
11123
11124 =over 4
11125
11126 =item SYNOPSIS
11127
11128 =item DESCRIPTION
11129
11130 =over 4
11131
11132 =item Runtime debugging
11133
11134 =item Memory footprint debugging
11135
11136 =back
11137
11138 =item EXAMPLES
11139
11140 =over 4
11141
11142 =item A simple scalar string
11143
11144 =item A simple scalar number
11145
11146 =item A simple scalar with an extra reference
11147
11148 =item A reference to a simple scalar
11149
11150 =item A reference to an array
11151
11152 =item A reference to a hash
11153
11154 =item Dumping a large array or hash
11155
11156 =item A reference to an SV which holds a C pointer
11157
11158 =item A reference to a subroutine
11159
11160 =back
11161
11162 =item EXPORTS
11163
11164 =item BUGS
11165
11166 =item AUTHOR
11167
11168 =item SEE ALSO
11169
11170 =back
11171
11172 =head2 Devel::SelfStubber - generate stubs for a SelfLoading module
11173
11174 =over 4
11175
11176 =item SYNOPSIS
11177
11178 =item DESCRIPTION
11179
11180 =back
11181
11182 =head2 Digest:: - Modules that calculate message digests
11183
11184 =over 4
11185
11186 =item SYNOPSIS
11187
11188 =item DESCRIPTION
11189
11190 I<binary>, I<hex>, I<base64>
11191
11192 =item OO INTERFACE
11193
11194 $ctx = Digest->XXX($arg,...), $ctx = Digest->new(XXX => $arg,...), $ctx =
11195 Digest::XXX->new($arg,...), $ctx->reset, $ctx->add($data,...),
11196 $ctx->addfile($io_handle), $ctx->digest, $ctx->hexdigest, $ctx->b64digest
11197
11198 =item SEE ALSO
11199
11200 =item AUTHOR
11201
11202 =back
11203
11204 =head2 Digest::MD5 - Perl interface to the MD5 Algorithm
11205
11206 =over 4
11207
11208 =item SYNOPSIS
11209
11210 =item DESCRIPTION
11211
11212 =item FUNCTIONS
11213
11214 md5($data,...), md5_hex($data,...), md5_base64($data,...)
11215
11216 =item METHODS
11217
11218 $md5 = Digest::MD5->new, $md5->reset, $md5->add($data,...),
11219 $md5->addfile($io_handle), $md5->digest, $md5->hexdigest, $md5->b64digest
11220
11221 =item EXAMPLES
11222
11223 =item SEE ALSO
11224
11225 =item COPYRIGHT
11226
11227 =item AUTHORS
11228
11229 =back
11230
11231 =head2 DirHandle - supply object methods for directory handles
11232
11233 =over 4
11234
11235 =item SYNOPSIS
11236
11237 =item DESCRIPTION
11238
11239 =item NOTES
11240
11241 =back
11242
11243 =head2 Dumpvalue - provides screen dump of Perl data.
11244
11245 =over 4
11246
11247 =item SYNOPSIS
11248
11249 =item DESCRIPTION
11250
11251 =over 4
11252
11253 =item Creation
11254
11255 C<arrayDepth>, C<hashDepth>, C<compactDump>, C<veryCompact>, C<globPrint>,
11256 C<dumpDBFiles>, C<dumpPackages>, C<dumpReused>, C<tick>, C<quoteHighBit>,
11257 C<printUndef>, C<usageOnly>, unctrl, subdump, bareStringify, quoteHighBit,
11258 stopDbSignal
11259
11260 =item Methods
11261
11262 dumpValue, dumpValues, stringify, dumpvars, set_quote, set_unctrl,
11263 compactDump, veryCompact, set, get
11264
11265 =back
11266
11267 =back
11268
11269 =head2 DynaLoader - Dynamically load C libraries into Perl code
11270
11271 =over 4
11272
11273 =item SYNOPSIS
11274
11275 =item DESCRIPTION
11276
11277 @dl_library_path, @dl_resolve_using, @dl_require_symbols, @dl_librefs,
11278 @dl_modules, dl_error(), $dl_debug, dl_findfile(), dl_expandspec(),
11279 dl_load_file(), dl_unload_file(), dl_loadflags(), dl_find_symbol(),
11280 dl_find_symbol_anywhere(), dl_undef_symbols(), dl_install_xsub(),
11281 bootstrap()
11282
11283 =item AUTHOR
11284
11285 =back
11286
11287 =head2 DynaLoader::XSLoader, XSLoader - Dynamically load C libraries into
11288 Perl code
11289
11290 =over 4
11291
11292 =item SYNOPSIS
11293
11294 =item DESCRIPTION
11295
11296 =item AUTHOR
11297
11298 =back
11299
11300 =head2 Encode - character encodings
11301
11302 =over 4
11303
11304 =item SYNOPSIS
11305
11306 =over 4
11307
11308 =item Table of Contents
11309
11310 =back
11311
11312 =item DESCRIPTION
11313
11314 =over 4
11315
11316 =item TERMINOLOGY
11317
11318 =back
11319
11320 =item PERL ENCODING API
11321
11322 $octets  = encode(ENCODING, $string [, CHECK]), $string = decode(ENCODING,
11323 $octets [, CHECK]), [$length =] from_to($octets, FROM_ENC, TO_ENC [,
11324 CHECK]), $octets = encode_utf8($string);, $string = decode_utf8($octets [,
11325 CHECK]);
11326
11327 =over 4
11328
11329 =item Listing available encodings
11330
11331 =item Defining Aliases
11332
11333 =back
11334
11335 =item Encoding via PerlIO
11336
11337 =item Handling Malformed Data
11338
11339 I<CHECK> = Encode::FB_DEFAULT ( == 0), I<CHECK> = Encode::FB_CROAK ( == 1),
11340 I<CHECK> = Encode::FB_QUIET, I<CHECK> = Encode::FB_WARN, perlqq mode
11341 (I<CHECK> = Encode::FB_PERLQQ), HTML charref mode (I<CHECK> =
11342 Encode::FB_HTMLCREF), XML charref mode (I<CHECK> = Encode::FB_XMLCREF), The
11343 bitmask
11344
11345 =over 4
11346
11347 =item Unimplemented fallback schemes
11348
11349 =back
11350
11351 =item Defining Encodings
11352
11353 =item The UTF-8 flag
11354
11355 Goal #1:, Goal #2:, Goal #3:, Goal #4:
11356
11357 =over 4
11358
11359 =item Messing with Perl's Internals
11360
11361 is_utf8(STRING [, CHECK]), _utf8_on(STRING), _utf8_off(STRING)
11362
11363 =back
11364
11365 =item SEE ALSO
11366
11367 =item MAINTAINER
11368
11369 =back
11370
11371 =head2 Encode::Alias - alias definitions to encodings
11372
11373 =over 4
11374
11375 =item SYNOPSIS
11376
11377 =item DESCRIPTION
11378
11379 As a simple string, As a qr// compiled regular expression, e.g.:, As a code
11380 reference, e.g.:
11381
11382 =over 4
11383
11384 =item Alias overloading
11385
11386 =back
11387
11388 =item SEE ALSO
11389
11390 =back
11391
11392 =head2 Encode::Byte - Single Byte Encodings
11393
11394 =over 4
11395
11396 =item SYNOPSIS
11397
11398 =item ABSTRACT
11399
11400 =item DESCRIPTION
11401
11402 =item SEE ALSO
11403
11404 =back
11405
11406 =head2   Encode::CJKConstants -- Internally used by Encode::??::ISO_2022_*
11407
11408 =head2 Encode::CN - China-based Chinese Encodings
11409
11410 =over 4
11411
11412 =item SYNOPSIS
11413
11414 =item DESCRIPTION
11415
11416 =item NOTES
11417
11418 =item BUGS
11419
11420 =item SEE ALSO
11421
11422 =back
11423
11424 =head2 Encode::CN::HZ -- internally used by Encode::CN
11425
11426 =head2 Encode::Config -- internally used by Encode
11427
11428 =head2 Encode::EBCDIC - EBCDIC Encodings
11429
11430 =over 4
11431
11432 =item SYNOPSIS
11433
11434 =item ABSTRACT
11435
11436 =item DESCRIPTION
11437
11438 =item SEE ALSO
11439
11440 =back
11441
11442 =head2 Encode::Encoding - Encode Implementation Base Class
11443
11444 =over 4
11445
11446 =item SYNOPSIS
11447
11448 =item DESCRIPTION
11449
11450 =over 4
11451
11452 =item Methods you should implement
11453
11454 -E<gt>encode($string [,$check]), -E<gt>decode($octets [,$check])
11455
11456 =item Other methods defined in Encode::Encodings
11457
11458 -E<gt>name, -E<gt>new_sequence, -E<gt>perlio_ok(), -E<gt>needs_lines()
11459
11460 =item Example: Encode::ROT13
11461
11462 =back
11463
11464 =item Why the heck Encode API is different?
11465
11466 =over 4
11467
11468 =item Compiled Encodings
11469
11470 =back
11471
11472 =item SEE ALSO
11473
11474 Scheme 1, Scheme 2, Other Schemes
11475
11476 =back
11477
11478 =head2 Encode::Guess -- Guesses encoding from data
11479
11480 =over 4
11481
11482 =item SYNOPSIS
11483
11484 =item ABSTRACT
11485
11486 =item DESCRIPTION
11487
11488 Encode::Guess->set_suspects, Encode::Guess->add_suspects,
11489 Encode::decode("Guess" ...), Encode::Guess->guess($data),
11490 guess_encoding($data, [, I<list of suspects>])
11491
11492 =item CAVEATS
11493
11494 =item TO DO
11495
11496 =item SEE ALSO
11497
11498 =back
11499
11500 =head2 Encode::JP - Japanese Encodings
11501
11502 =over 4
11503
11504 =item SYNOPSIS
11505
11506 =item ABSTRACT
11507
11508 =item DESCRIPTION
11509
11510 =item Note on ISO-2022-JP(-1)?
11511
11512 =item BUGS
11513
11514 =item SEE ALSO
11515
11516 =back
11517
11518 =head2 Encode::JP::H2Z -- internally used by Encode::JP::2022_JP*
11519
11520 =head2 Encode::JP::JIS7 -- internally used by Encode::JP
11521
11522 =head2 Encode::KR - Korean Encodings
11523
11524 =over 4
11525
11526 =item SYNOPSIS
11527
11528 =item DESCRIPTION
11529
11530 =item BUGS
11531
11532 =item SEE ALSO
11533
11534 =back
11535
11536 =head2 Encode::KR::2022_KR -- internally used by Encode::KR
11537
11538 =head2 Encode::MIME::Header -- MIME 'B' and 'Q' header encoding
11539
11540 =over 4
11541
11542 =item SYNOPSIS
11543
11544 =item ABSTRACT
11545
11546 =item DESCRIPTION
11547
11548 =item BUGS
11549
11550 =item SEE ALSO
11551
11552 =back
11553
11554 =head2 Encode::PerlIO -- a detailed document on Encode and PerlIO
11555
11556 =over 4
11557
11558 =item Overview
11559
11560 =item How does it work?
11561
11562 =item BUGS
11563
11564 =over 4
11565
11566 =item Workaround
11567
11568 =item How can I tell whether my encoding fully supports PerlIO ?
11569
11570 =back
11571
11572 =item SEE ALSO
11573
11574 =back
11575
11576 =head2 Encode::Supported -- Encodings supported by Encode
11577
11578 =over 4
11579
11580 =item DESCRIPTION
11581
11582 =over 4
11583
11584 =item Encoding Names
11585
11586 =back
11587
11588 =item Supported Encodings
11589
11590 =over 4
11591
11592 =item Built-in Encodings
11593
11594 =item Encode::Unicode -- other Unicode encodings
11595
11596 =item Encode::Byte -- Extended ASCII
11597
11598 ISO-8859 and corresponding vendor mappings, KOI8 - De Facto Standard for
11599 the Cyrillic world, gsm0338 - Hentai Latin 1
11600
11601 =item CJK: Chinese, Japanese, Korean (Multibyte)
11602
11603 Encode::CN -- Continental China, Encode::JP -- Japan, Encode::KR -- Korea,
11604 Encode::TW -- Taiwan, Encode::HanExtra -- More Chinese via CPAN,
11605 Encode::JIS2K -- JIS X 0213 encodings via CPAN
11606
11607 =item Miscellaneous encodings
11608
11609 Encode::EBCDIC, Encode::Symbols, Encode::MIME::Header, Encode::Guess
11610
11611 =back
11612
11613 =item Unsupported encodings
11614
11615   ISO-2022-JP-2 [RFC1554], ISO-2022-CN [RFC1922], Various HP-UX encodings,
11616 Cyrillic encoding ISO-IR-111, ISO-8859-8-1 [Hebrew], ISIRI 3342, Iran
11617 System, ISIRI 2900 [Farsi], Thai encoding TCVN, Vietnamese encodings VPS,
11618 Various Mac encodings, (Mac) Indic encodings
11619
11620 =item Encoding vs. Charset -- terminology
11621
11622 =item Encoding Classification (by Anton Tagunov and Dan Kogai)
11623
11624 =over 4
11625
11626 =item Microsoft-related naming mess
11627
11628 KS_C_5601-1987, GB2312, Big5, Shift_JIS
11629
11630 =back
11631
11632 =item Glossary
11633
11634 character repertoire, coded character set (CCS), character encoding scheme
11635 (CES), charset (in MIME context), EUC, ISO-2022, UCS, UCS-2, Unicode, UTF,
11636 UTF-16
11637
11638 =item See Also
11639
11640 =item References
11641
11642 ECMA, ECMA-035 (eq C<ISO-2022>), IANA, Assigned Charset Names by IANA, ISO,
11643 RFC, UC, Unicode Glossary
11644
11645 =over 4
11646
11647 =item Other Notable Sites
11648
11649 czyborra.com, CJK.inf, Jungshik Shin's Hangul FAQ, debian.org:
11650 "Introduction to i18n"
11651
11652 =item Offline sources
11653
11654 C<CJKV Information Processing> by Ken Lunde
11655
11656 =back
11657
11658 =back
11659
11660 =head2 Encode::Symbol - Symbol Encodings
11661
11662 =over 4
11663
11664 =item SYNOPSIS
11665
11666 =item ABSTRACT
11667
11668 =item DESCRIPTION
11669
11670 =item SEE ALSO
11671
11672 =back
11673
11674 =head2 Encode::TW - Taiwan-based Chinese Encodings
11675
11676 =over 4
11677
11678 =item SYNOPSIS
11679
11680 =item DESCRIPTION
11681
11682 =item NOTES
11683
11684 =item BUGS
11685
11686 =item SEE ALSO
11687
11688 =back
11689
11690 =head2 Encode::Unicode -- Various Unicode Transformation Formats
11691
11692 =over 4
11693
11694 =item SYNOPSIS
11695
11696 =item ABSTRACT
11697
11698 L<http://www.unicode.org/glossary/> says:, Quick Reference
11699
11700 =item Size, Endianness, and BOM
11701
11702 =over 4
11703
11704 =item by size
11705
11706 =item by endianness
11707
11708 BOM as integer when fetched in network byte order
11709
11710 =back
11711
11712 =item Surrogate Pairs
11713
11714 =item SEE ALSO
11715
11716 =back
11717
11718 =head2 Encode::lib::Encode::Alias, Encode::Alias - alias definitions to
11719 encodings
11720
11721 =over 4
11722
11723 =item SYNOPSIS
11724
11725 =item DESCRIPTION
11726
11727 As a simple string, As a qr// compiled regular expression, e.g.:, As a code
11728 reference, e.g.:
11729
11730 =over 4
11731
11732 =item Alias overloading
11733
11734 =back
11735
11736 =item SEE ALSO
11737
11738 =back
11739
11740 =head2 Encode::lib::Encode::CJKConstants,   Encode::CJKConstants.pm --
11741 Internally used by Encode::??::ISO_2022_*
11742
11743 =head2 Encode::lib::Encode::CN::HZ, Encode::CN::HZ -- internally used by
11744 Encode::CN
11745
11746 =head2 Encode::lib::Encode::Config, Encode::Config -- internally used by
11747 Encode
11748
11749 =head2 Encode::lib::Encode::Encoding, Encode::Encoding - Encode
11750 Implementation Base Class
11751
11752 =over 4
11753
11754 =item SYNOPSIS
11755
11756 =item DESCRIPTION
11757
11758 =over 4
11759
11760 =item Methods you should implement
11761
11762 -E<gt>encode($string [,$check]), -E<gt>decode($octets [,$check])
11763
11764 =item Other methods defined in Encode::Encodings
11765
11766 -E<gt>name, -E<gt>new_sequence, -E<gt>perlio_ok(), -E<gt>needs_lines()
11767
11768 =item Example: Encode::ROT13
11769
11770 =back
11771
11772 =item Why the heck Encode API is different?
11773
11774 =over 4
11775
11776 =item Compiled Encodings
11777
11778 =back
11779
11780 =item SEE ALSO
11781
11782 Scheme 1, Scheme 2, Other Schemes
11783
11784 =back
11785
11786 =head2 Encode::lib::Encode::Guess, Encode::Guess -- Guesses encoding from
11787 data
11788
11789 =over 4
11790
11791 =item SYNOPSIS
11792
11793 =item ABSTRACT
11794
11795 =item DESCRIPTION
11796
11797 Encode::Guess->set_suspects, Encode::Guess->add_suspects,
11798 Encode::decode("Guess" ...), Encode::Guess->guess($data),
11799 guess_encoding($data, [, I<list of suspects>])
11800
11801 =item CAVEATS
11802
11803 =item TO DO
11804
11805 =item SEE ALSO
11806
11807 =back
11808
11809 =head2 Encode::lib::Encode::JP::H2Z, Encode::JP::H2Z -- internally used by
11810 Encode::JP::2022_JP*
11811
11812 =head2 Encode::lib::Encode::JP::JIS7, Encode::JP::JIS7 -- internally used
11813 by Encode::JP
11814
11815 =head2 Encode::lib::Encode::KR::2022_KR, Encode::KR::2022_KR -- internally
11816 used by Encode::KR
11817
11818 =head2 Encode::lib::Encode::MIME::Header, Encode::MIME::Header -- MIME 'B'
11819 and 'Q' header encoding
11820
11821 =over 4
11822
11823 =item SYNOPSIS
11824
11825 =item ABSTRACT
11826
11827 =item DESCRIPTION
11828
11829 =item BUGS
11830
11831 =item SEE ALSO
11832
11833 =back
11834
11835 =head2 Encode::lib::Encode::PerlIO, Encode::PerlIO -- a detailed document
11836 on Encode and PerlIO
11837
11838 =over 4
11839
11840 =item Overview
11841
11842 =item How does it work?
11843
11844 =item BUGS
11845
11846 =over 4
11847
11848 =item Workaround
11849
11850 =item How can I tell whether my encoding fully supports PerlIO ?
11851
11852 =back
11853
11854 =item SEE ALSO
11855
11856 =back
11857
11858 =head2 Encode::lib::Encode::Supported, Encode::Supported -- Encodings
11859 supported by Encode
11860
11861 =over 4
11862
11863 =item DESCRIPTION
11864
11865 =over 4
11866
11867 =item Encoding Names
11868
11869 =back
11870
11871 =item Supported Encodings
11872
11873 =over 4
11874
11875 =item Built-in Encodings
11876
11877 =item Encode::Unicode -- other Unicode encodings
11878
11879 =item Encode::Byte -- Extended ASCII
11880
11881 ISO-8859 and corresponding vendor mappings, KOI8 - De Facto Standard for
11882 the Cyrillic world, gsm0338 - Hentai Latin 1
11883
11884 =item CJK: Chinese, Japanese, Korean (Multibyte)
11885
11886 Encode::CN -- Continental China, Encode::JP -- Japan, Encode::KR -- Korea,
11887 Encode::TW -- Taiwan, Encode::HanExtra -- More Chinese via CPAN,
11888 Encode::JIS2K -- JIS X 0213 encodings via CPAN
11889
11890 =item Miscellaneous encodings
11891
11892 Encode::EBCDIC, Encode::Symbols, Encode::MIME::Header, Encode::Guess
11893
11894 =back
11895
11896 =item Unsupported encodings
11897
11898   ISO-2022-JP-2 [RFC1554], ISO-2022-CN [RFC1922], Various HP-UX encodings,
11899 Cyrillic encoding ISO-IR-111, ISO-8859-8-1 [Hebrew], ISIRI 3342, Iran
11900 System, ISIRI 2900 [Farsi], Thai encoding TCVN, Vietnamese encodings VPS,
11901 Various Mac encodings, (Mac) Indic encodings
11902
11903 =item Encoding vs. Charset -- terminology
11904
11905 =item Encoding Classification (by Anton Tagunov and Dan Kogai)
11906
11907 =over 4
11908
11909 =item Microsoft-related naming mess
11910
11911 KS_C_5601-1987, GB2312, Big5, Shift_JIS
11912
11913 =back
11914
11915 =item Glossary
11916
11917 character repertoire, coded character set (CCS), character encoding scheme
11918 (CES), charset (in MIME context), EUC, ISO-2022, UCS, UCS-2, Unicode, UTF,
11919 UTF-16
11920
11921 =item See Also
11922
11923 =item References
11924
11925 ECMA, ECMA-035 (eq C<ISO-2022>), IANA, Assigned Charset Names by IANA, ISO,
11926 RFC, UC, Unicode Glossary
11927
11928 =over 4
11929
11930 =item Other Notable Sites
11931
11932 czyborra.com, CJK.inf, Jungshik Shin's Hangul FAQ, debian.org:
11933 "Introduction to i18n"
11934
11935 =item Offline sources
11936
11937 C<CJKV Information Processing> by Ken Lunde
11938
11939 =back
11940
11941 =back
11942
11943 =head2 Encode::lib::Encoder, Encode::Encoder -- Object Oriented Encoder
11944
11945 =over 4
11946
11947 =item SYNOPSIS
11948
11949   use Encode::Encoder;
11950   # Encode::encode("ISO-8859-1", $data);
11951   Encode::Encoder->new($data)->iso_8859_1; # OOP way
11952   # shortcut
11953   use Encode::Encoder qw(encoder);
11954   encoder($data)->iso_8859_1;
11955   # you can stack them!
11956   encoder($data)->iso_8859_1->base64;  # provided base64() is defined
11957   # you can use it as a decoder as well
11958   encoder($base64)->bytes('base64')->latin1;
11959   # stringified
11960   print encoder($data)->utf8->latin1;  # prints the string in latin1
11961   # numified
11962   encoder("\x{abcd}\x{ef}g")->utf8 == 6; # true. bytes::length($data)
11963
11964 =item ABSTRACT
11965
11966 =item Description
11967
11968 =over 4
11969
11970 =item Predefined Methods
11971
11972 $e = Encode::Encoder-E<gt>new([$data, $encoding]);, encoder(),
11973 $e-E<gt>data([$data]), $e-E<gt>encoding([$encoding]),
11974 $e-E<gt>bytes([$encoding])
11975
11976 =item Example: base64 transcoder
11977
11978 =item Operator Overloading
11979
11980 =back
11981
11982 =item SEE ALSO
11983
11984 =back
11985
11986 =head2 Encodencoding, encoding - allows you to write your script in
11987 non-ascii or non-utf8
11988
11989 =over 4
11990
11991 =item SYNOPSIS
11992
11993 =item ABSTRACT
11994
11995 =item USAGE
11996
11997 use encoding [I<ENCNAME>] ;, use encoding I<ENCNAME> [ STDIN =E<gt>
11998 I<ENCNAME_IN> ...] ;, no encoding;
11999
12000 =item CAVEATS
12001
12002 =over 4
12003
12004 =item NOT SCOPED
12005
12006 =item DO NOT MIX MULTIPLE ENCODINGS
12007
12008 =back
12009
12010 =item Non-ASCII Identifiers and Filter option
12011
12012 use encoding I<ENCNAME> Filter=E<gt>1;
12013
12014 =item EXAMPLE - Greekperl
12015
12016 =item KNOWN PROBLEMS
12017
12018 =item SEE ALSO
12019
12020 =back
12021
12022 =head2 Encoder, Encode::Encoder -- Object Oriented Encoder
12023
12024 =over 4
12025
12026 =item SYNOPSIS
12027
12028   use Encode::Encoder;
12029   # Encode::encode("ISO-8859-1", $data);
12030   Encode::Encoder->new($data)->iso_8859_1; # OOP way
12031   # shortcut
12032   use Encode::Encoder qw(encoder);
12033   encoder($data)->iso_8859_1;
12034   # you can stack them!
12035   encoder($data)->iso_8859_1->base64;  # provided base64() is defined
12036   # you can use it as a decoder as well
12037   encoder($base64)->bytes('base64')->latin1;
12038   # stringified
12039   print encoder($data)->utf8->latin1;  # prints the string in latin1
12040   # numified
12041   encoder("\x{abcd}\x{ef}g")->utf8 == 6; # true. bytes::length($data)
12042
12043 =item ABSTRACT
12044
12045 =item Description
12046
12047 =over 4
12048
12049 =item Predefined Methods
12050
12051 $e = Encode::Encoder-E<gt>new([$data, $encoding]);, encoder(),
12052 $e-E<gt>data([$data]), $e-E<gt>encoding([$encoding]),
12053 $e-E<gt>bytes([$encoding])
12054
12055 =item Example: base64 transcoder
12056
12057 =item Operator Overloading
12058
12059 =back
12060
12061 =item SEE ALSO
12062
12063 =back
12064
12065 =head2 English - use nice English (or awk) names for ugly punctuation
12066 variables
12067
12068 =over 4
12069
12070 =item SYNOPSIS
12071
12072 =item DESCRIPTION
12073
12074 =item PERFORMANCE
12075
12076 =back
12077
12078 =head2 Env - perl module that imports environment variables as scalars or
12079 arrays
12080
12081 =over 4
12082
12083 =item SYNOPSIS
12084
12085 =item DESCRIPTION
12086
12087 =item LIMITATIONS
12088
12089 =item AUTHOR
12090
12091 =back
12092
12093 =head2 Errno - System errno constants
12094
12095 =over 4
12096
12097 =item SYNOPSIS
12098
12099 =item DESCRIPTION
12100
12101 =item CAVEATS
12102
12103 =item AUTHOR
12104
12105 =item COPYRIGHT
12106
12107 =back
12108
12109 =head2 Exporter - Implements default import method for modules
12110
12111 =over 4
12112
12113 =item SYNOPSIS
12114
12115 =item DESCRIPTION
12116
12117 =over 4
12118
12119 =item How to Export
12120
12121 =item Selecting What To Export
12122
12123 =item How to Import
12124
12125 C<use ModuleName;>, C<use ModuleName ();>, C<use ModuleName qw(...);>
12126
12127 =back
12128
12129 =item Advanced features
12130
12131 =over 4
12132
12133 =item Specialised Import Lists
12134
12135 =item Exporting without using Exporter's import method
12136
12137 =item Module Version Checking
12138
12139 =item Managing Unknown Symbols
12140
12141 =item Tag Handling Utility Functions
12142
12143 =item Generating combined tags
12144
12145 =item C<AUTOLOAD>ed Constants
12146
12147 =back
12148
12149 =back
12150
12151 =head2 Exporter::Heavy - Exporter guts
12152
12153 =over 4
12154
12155 =item SYNOPSIS
12156
12157 =item DESCRIPTION
12158
12159 =back
12160
12161 =head2 ExtUtils::Command - utilities to replace common UNIX commands in
12162 Makefiles etc.
12163
12164 =over 4
12165
12166 =item SYNOPSIS
12167
12168 =item DESCRIPTION
12169
12170 =back
12171
12172 cat
12173
12174 eqtime src dst
12175
12176 rm_rf files...
12177
12178 rm_f files...
12179
12180 touch files ..
12181
12182 mv source... destination
12183
12184 cp source... destination
12185
12186 chmod mode files..
12187
12188 mkpath directory..
12189
12190 test_f file
12191
12192 =over 4
12193
12194 =item BUGS
12195
12196 =item SEE ALSO
12197
12198 =item AUTHOR
12199
12200 =back
12201
12202 =head2 ExtUtils::Command::MM - Commands for the MM's to use in Makefiles
12203
12204 =over 4
12205
12206 =item SYNOPSIS
12207
12208 =item DESCRIPTION
12209
12210 B<test_harness>
12211
12212 =back
12213
12214 =head2 ExtUtils::Constant - generate XS code to import C header constants
12215
12216 =over 4
12217
12218 =item SYNOPSIS
12219
12220 =item DESCRIPTION
12221
12222 =item USAGE
12223
12224 IV, UV, NV, PV, PVN, SV, YES, NO, UNDEF
12225
12226 =item FUNCTIONS
12227
12228 =back
12229
12230 C_stringify NAME
12231
12232 perl_stringify NAME
12233
12234 constant_types
12235
12236 memEQ_clause NAME, CHECKED_AT, INDENT
12237
12238 assign INDENT, TYPE, PRE, POST, VALUE..
12239
12240 return_clause
12241
12242 switch_clause INDENT, NAMELEN, ITEMHASH, ITEM..
12243
12244 params WHAT
12245
12246 dump_names
12247
12248 dogfood
12249
12250 C_constant, name, type, value, macro, default, pre, post, def_pre =item
12251 def_post, utf8
12252
12253 XS_constant PACKAGE, TYPES, SUBNAME, C_SUBNAME
12254
12255 autoload PACKAGE, VERSION, AUTOLOADER
12256
12257 WriteMakefileSnippet
12258
12259 WriteConstants ATTRIBUTE =E<gt> VALUE [, ...], NAME, DEFAULT_TYPE,
12260 BREAKOUT_AT, NAMES, C_FILE, XS_FILE, SUBNAME, C_SUBNAME
12261
12262 =over 4
12263
12264 =item AUTHOR
12265
12266 =back
12267
12268 =head2 ExtUtils::Embed - Utilities for embedding Perl in C/C++ applications
12269
12270 =over 4
12271
12272 =item SYNOPSIS
12273
12274 =item DESCRIPTION
12275
12276 =item @EXPORT
12277
12278 =item FUNCTIONS
12279
12280 xsinit(), Examples, ldopts(), Examples, perl_inc(), ccflags(), ccdlflags(),
12281 ccopts(), xsi_header(), xsi_protos(@modules), xsi_body(@modules)
12282
12283 =item EXAMPLES
12284
12285 =item SEE ALSO
12286
12287 =item AUTHOR
12288
12289 =back
12290
12291 =head2 ExtUtils::Install - install files from here to there
12292
12293 =over 4
12294
12295 =item SYNOPSIS
12296
12297 =item DESCRIPTION
12298
12299 =back
12300
12301 =head2 ExtUtils::Installed - Inventory management of installed modules
12302
12303 =over 4
12304
12305 =item SYNOPSIS
12306
12307 =item DESCRIPTION
12308
12309 =item USAGE
12310
12311 =item FUNCTIONS
12312
12313 new(), modules(), files(), directories(), directory_tree(), validate(),
12314 packlist(), version()
12315
12316 =item EXAMPLE
12317
12318 =item AUTHOR
12319
12320 =back
12321
12322 =head2 ExtUtils::Liblist - determine libraries to use and how to use them
12323
12324 =over 4
12325
12326 =item SYNOPSIS
12327
12328 =item DESCRIPTION
12329
12330 For static extensions, For dynamic extensions at build/link time, For
12331 dynamic extensions at load time
12332
12333 =over 4
12334
12335 =item EXTRALIBS
12336
12337 =item LDLOADLIBS and LD_RUN_PATH
12338
12339 =item BSLOADLIBS
12340
12341 =back
12342
12343 =item PORTABILITY
12344
12345 =over 4
12346
12347 =item VMS implementation
12348
12349 =item Win32 implementation
12350
12351 =back
12352
12353 =item SEE ALSO
12354
12355 =back
12356
12357 =head2 ExtUtils::MM - OS adjusted ExtUtils::MakeMaker subclass
12358
12359 =over 4
12360
12361 =item SYNOPSIS
12362
12363 =item DESCRIPTION
12364
12365 =back
12366
12367 =head2 ExtUtils::MM_Any - Platform agnostic MM methods
12368
12369 =over 4
12370
12371 =item SYNOPSIS
12372
12373 =item DESCRIPTION
12374
12375 =item Inherently Cross-Platform Methods
12376
12377 =over 4
12378
12379 =item File::Spec wrappers  B<DEPRECATED>
12380
12381 canonpath
12382
12383 =back
12384
12385 =back
12386
12387 catdir
12388
12389 catfile
12390
12391 curdir
12392
12393 file_name_is_absolute
12394
12395 path
12396
12397 rootdir
12398
12399 updir
12400
12401 =over 4
12402
12403 =item Thought To Be Cross-Platform Methods
12404
12405 test_via_harness
12406
12407 =back
12408
12409 test_via_script
12410
12411 =over 4
12412
12413 =item AUTHOR
12414
12415 =back
12416
12417 =head2 ExtUtils::MM_BeOS - methods to override UN*X behaviour in
12418 ExtUtils::MakeMaker
12419
12420 =over 4
12421
12422 =item SYNOPSIS
12423
12424 =item DESCRIPTION
12425
12426 =back
12427
12428 perl_archive
12429
12430 =head2 ExtUtils::MM_Cygwin - methods to override UN*X behaviour in
12431 ExtUtils::MakeMaker
12432
12433 =over 4
12434
12435 =item SYNOPSIS
12436
12437 =item DESCRIPTION
12438
12439 canonpath, cflags, manifypods, perl_archive
12440
12441 =back
12442
12443 =head2 ExtUtils::MM_DOS - DOS specific subclass of ExtUtils::MM_Unix
12444
12445 =over 4
12446
12447 =item SYNOPSIS
12448
12449 =item DESCRIPTION
12450
12451 =over 4
12452
12453 =item Overridden methods
12454
12455 B<replace_manpage_separator>
12456
12457 =back
12458
12459 =back
12460
12461 =over 4
12462
12463 =item AUTHOR
12464
12465 =item SEE ALSO
12466
12467 =back
12468
12469 =head2 ExtUtils::MM_MacOS - methods to override UN*X behaviour in
12470 ExtUtils::MakeMaker
12471
12472 =over 4
12473
12474 =item SYNOPSIS
12475
12476 =item DESCRIPTION
12477
12478 =back
12479
12480 maybe_command
12481
12482 guess_name
12483
12484 macify
12485
12486 patternify
12487
12488 init_main
12489
12490 init_others
12491
12492 init_dirscan
12493
12494 libscan (o)
12495
12496 constants (o)
12497
12498 static (o)
12499
12500 dlsyms (o)
12501
12502 dynamic (o)
12503
12504 clean (o)
12505
12506 realclean (o)
12507
12508 rulez (o)
12509
12510 processPL (o)
12511
12512 =head2 ExtUtils::MM_NW5 - methods to override UN*X behaviour in
12513 ExtUtils::MakeMaker
12514
12515 =over 4
12516
12517 =item SYNOPSIS
12518
12519 =item DESCRIPTION
12520
12521 =back
12522
12523 constants (o)
12524
12525 static_lib (o)
12526
12527 dynamic_lib (o)
12528
12529 =head2 ExtUtils::MM_OS2 - methods to override UN*X behaviour in
12530 ExtUtils::MakeMaker
12531
12532 =over 4
12533
12534 =item SYNOPSIS
12535
12536 =item DESCRIPTION
12537
12538 =item METHODS
12539
12540 =back
12541
12542 perl_archive_after
12543
12544 =head2 ExtUtils::MM_UWIN - U/WIN specific subclass of ExtUtils::MM_Unix
12545
12546 =over 4
12547
12548 =item SYNOPSIS
12549
12550 =item DESCRIPTION
12551
12552 =over 4
12553
12554 =item Overridden methods
12555
12556 B<replace_manpage_separator>
12557
12558 =back
12559
12560 =back
12561
12562 =over 4
12563
12564 =item AUTHOR
12565
12566 =item SEE ALSO
12567
12568 =back
12569
12570 =head2 ExtUtils::MM_Unix - methods used by ExtUtils::MakeMaker
12571
12572 =over 4
12573
12574 =item SYNOPSIS
12575
12576 =item DESCRIPTION
12577
12578 =item METHODS
12579
12580 =back
12581
12582 =over 4
12583
12584 =item SelfLoaded methods
12585
12586 c_o (o)
12587
12588 =back
12589
12590 cflags (o)
12591
12592 clean (o)
12593
12594 const_cccmd (o)
12595
12596 const_config (o)
12597
12598 const_loadlibs (o)
12599
12600 constants (o)
12601
12602 depend (o)
12603
12604 dir_target (o)
12605
12606 dist (o)
12607
12608 dist_basics (o)
12609
12610 dist_ci (o)
12611
12612 dist_core (o)
12613
12614 dist_dir
12615
12616 dist_test
12617
12618 dlsyms (o)
12619
12620 dynamic (o)
12621
12622 dynamic_bs (o)
12623
12624 dynamic_lib (o)
12625
12626 exescan
12627
12628 extliblist
12629
12630 find_perl
12631
12632 find_tests
12633
12634 =over 4
12635
12636 =item Methods to actually produce chunks of text for the Makefile
12637
12638 fixin
12639
12640 =back
12641
12642 force (o)
12643
12644 guess_name
12645
12646 has_link_code
12647
12648 init_dirscan
12649
12650 init_main
12651
12652 init_others
12653
12654 init_INST
12655
12656 init_INSTALL
12657
12658 init_lib2arch
12659
12660 init_PERL
12661
12662 init_PERM
12663
12664 install (o)
12665
12666 installbin (o)
12667
12668 libscan (o)
12669
12670 linkext (o)
12671
12672 lsdir
12673
12674 macro (o)
12675
12676 makeaperl (o)
12677
12678 makefile (o)
12679
12680 manifypods (o)
12681
12682 maybe_command
12683
12684 maybe_command_in_dirs
12685
12686 needs_linking (o)
12687
12688 nicetext
12689
12690 parse_abstract
12691
12692 parse_version
12693
12694 pasthru (o)
12695
12696 perl_script
12697
12698 perldepend (o)
12699
12700 perm_rw (o)
12701
12702 perm_rwx (o)
12703
12704 pm_to_blib
12705
12706 post_constants (o)
12707
12708 post_initialize (o)
12709
12710 postamble (o)
12711
12712 ppd
12713
12714 prefixify
12715
12716 processPL (o)
12717
12718 quote_paren
12719
12720 realclean (o)
12721
12722 replace_manpage_separator
12723
12724 static (o)
12725
12726 static_lib (o)
12727
12728 staticmake (o)
12729
12730 subdir_x (o)
12731
12732 subdirs (o)
12733
12734 test (o)
12735
12736 test_via_harness (override)
12737
12738 test_via_script (override)
12739
12740 tool_autosplit (o)
12741
12742 tools_other (o)
12743
12744 tool_xsubpp (o)
12745
12746 top_targets (o)
12747
12748 writedoc
12749
12750 xs_c (o)
12751
12752 xs_cpp (o)
12753
12754 xs_o (o)
12755
12756 perl_archive
12757
12758 perl_archive_after
12759
12760 export_list
12761
12762 =over 4
12763
12764 =item SEE ALSO
12765
12766 =back
12767
12768 =head2 ExtUtils::MM_VMS - methods to override UN*X behaviour in
12769 ExtUtils::MakeMaker
12770
12771 =over 4
12772
12773 =item SYNOPSIS
12774
12775 =item DESCRIPTION
12776
12777 =over 4
12778
12779 =item Methods always loaded
12780
12781 wraplist
12782
12783 =back
12784
12785 =back
12786
12787 =over 4
12788
12789 =item Methods
12790
12791 guess_name (override)
12792
12793 =back
12794
12795 find_perl (override)
12796
12797 maybe_command (override)
12798
12799 maybe_command_in_dirs (override)
12800
12801 perl_script (override)
12802
12803 replace_manpage_separator
12804
12805 init_main (override)
12806
12807 init_others (override)
12808
12809 constants (override)
12810
12811 cflags (override)
12812
12813 const_cccmd (override)
12814
12815 pm_to_blib (override)
12816
12817 tool_autosplit (override)
12818
12819 tool_sxubpp (override)
12820
12821 xsubpp_version (override)
12822
12823 tools_other (override)
12824
12825 dist (override)
12826
12827 c_o (override)
12828
12829 xs_c (override)
12830
12831 xs_o (override)
12832
12833 top_targets (override)
12834
12835 dlsyms (override)
12836
12837 dynamic_lib (override)
12838
12839 dynamic_bs (override)
12840
12841 static_lib (override)
12842
12843 manifypods (override)
12844
12845 processPL (override)
12846
12847 installbin (override)
12848
12849 subdir_x (override)
12850
12851 clean (override)
12852
12853 realclean (override)
12854
12855 dist_core (override)
12856
12857 dist_test (override)
12858
12859 install (override)
12860
12861 perldepend (override)
12862
12863 makefile (override)
12864
12865 find_tests (override)
12866
12867 test (override)
12868
12869 makeaperl (override)
12870
12871 nicetext (override)
12872
12873 prefixify (override)
12874
12875 =head2 ExtUtils::MM_Win32 - methods to override UN*X behaviour in
12876 ExtUtils::MakeMaker
12877
12878 =over 4
12879
12880 =item SYNOPSIS
12881
12882 =item DESCRIPTION
12883
12884 =back
12885
12886 constants (o)
12887
12888 static_lib (o)
12889
12890 dynamic_bs (o)
12891
12892 dynamic_lib (o)
12893
12894 perl_script
12895
12896 pm_to_blib
12897
12898 tool_autosplit (override)
12899
12900 tools_other (o)
12901
12902 xs_o (o)
12903
12904 top_targets (o)
12905
12906 manifypods (o)
12907
12908 dist_ci (o)
12909
12910 dist_core (o)
12911
12912 pasthru (o)
12913
12914 =head2 ExtUtils::MM_Win95 - method to customize MakeMaker for Win9X
12915
12916 =over 4
12917
12918 =item SYNOPSIS
12919
12920 =item DESCRIPTION
12921
12922 =back
12923
12924 =head2 ExtUtils::MY - ExtUtils::MakeMaker subclass for customization
12925
12926 =over 4
12927
12928 =item SYNOPSIS
12929
12930 =item DESCRIPTION
12931
12932 =back
12933
12934 =head2 ExtUtils::MakeMaker - create an extension Makefile
12935
12936 =over 4
12937
12938 =item SYNOPSIS
12939
12940 =item DESCRIPTION
12941
12942 =over 4
12943
12944 =item How To Write A Makefile.PL
12945
12946 =item Default Makefile Behaviour
12947
12948 =item make test
12949
12950 =item make testdb
12951
12952 =item make install
12953
12954 =item PREFIX and LIB attribute
12955
12956 =item AFS users
12957
12958 =item Static Linking of a new Perl Binary
12959
12960 =item Determination of Perl Library and Installation Locations
12961
12962 =item Which architecture dependent directory?
12963
12964 =item Using Attributes and Parameters
12965
12966 ABSTRACT, ABSTRACT_FROM, AUTHOR, BINARY_LOCATION, C, CCFLAGS, CONFIG,
12967 CONFIGURE, DEFINE, DIR, DISTNAME, DL_FUNCS, DL_VARS, EXCLUDE_EXT,
12968 EXE_FILES, FIRST_MAKEFILE, FULLPERL, FULLPERLRUN, FULLPERLRUNINST,
12969 FUNCLIST, H, IMPORTS, INC, INCLUDE_EXT, INSTALLARCHLIB, INSTALLBIN,
12970 INSTALLDIRS, INSTALLMAN1DIR, INSTALLMAN3DIR, INSTALLPRIVLIB, INSTALLSCRIPT,
12971 INSTALLSITEARCH, INSTALLSITEBIN, INSTALLSITELIB, INSTALLSITEMAN1DIR,
12972 INSTALLSITEMAN3DIR, INSTALLVENDORARCH, INSTALLVENDORBIN, INSTALLVENDORLIB,
12973 INSTALLVENDORMAN1DIR, INSTALLVENDORMAN3DIR, INST_ARCHLIB, INST_BIN,
12974 INST_LIB, INST_MAN1DIR, INST_MAN3DIR, INST_SCRIPT, LDDLFLAGS, LDFROM, LIB,
12975 LIBPERL_A, LIBS, LINKTYPE, MAKEAPERL, MAKEFILE, MAN1PODS, MAN3PODS,
12976 MAP_TARGET, MYEXTLIB, NAME, NEEDS_LINKING, NOECHO, NORECURS, NO_VC, OBJECT,
12977 OPTIMIZE, PERL, PERL_CORE, PERLMAINCC, PERL_ARCHLIB, PERL_LIB,
12978 PERL_MALLOC_OK, PERLRUN, PERLRUNINST, PERL_SRC, PERM_RW, PERM_RWX,
12979 PL_FILES, PM, PMLIBDIRS, PM_FILTER, POLLUTE, PPM_INSTALL_EXEC,
12980 PPM_INSTALL_SCRIPT, PREFIX, PREREQ_FATAL, PREREQ_PM, PREREQ_PRINT,
12981 PRINT_PREREQ, SITEPREFIX, SKIP, TYPEMAPS, VENDORPREFIX, VERBINST, VERSION,
12982 VERSION_FROM, XS, XSOPT, XSPROTOARG, XS_VERSION
12983
12984 =item Additional lowercase attributes
12985
12986 clean, depend, dist, dynamic_lib, linkext, macro, realclean, test,
12987 tool_autosplit
12988
12989 =item Overriding MakeMaker Methods
12990
12991 =item The End Of Cargo Cult Programming
12992
12993 C<<MAN3PODS => ' '>>
12994
12995 =item Hintsfile support
12996
12997 =item Distribution Support
12998
12999    make distcheck,    make skipcheck,    make distclean,    make manifest,
13000   make distdir,   make disttest,    make tardist,    make dist,    make
13001 uutardist,    make shdist,    make zipdist,    make ci
13002
13003 =item Disabling an extension
13004
13005 =back
13006
13007 =item ENVIRONMENT
13008
13009 PERL_MM_OPT, PERL_MM_USE_DEFAULT
13010
13011 =item SEE ALSO
13012
13013 =item AUTHORS
13014
13015 =back
13016
13017 =head2 ExtUtils::Manifest - utilities to write and check a MANIFEST file
13018
13019 =over 4
13020
13021 =item SYNOPSIS
13022
13023 =item DESCRIPTION
13024
13025 =item MANIFEST.SKIP
13026
13027 =item EXPORT_OK
13028
13029 =item GLOBAL VARIABLES
13030
13031 =item DIAGNOSTICS
13032
13033 C<Not in MANIFEST:> I<file>, C<Skipping> I<file>, C<No such file:> I<file>,
13034 C<MANIFEST:> I<$!>, C<Added to MANIFEST:> I<file>
13035
13036 =item ENVIRONMENT
13037
13038 B<PERL_MM_MANIFEST_DEBUG>
13039
13040 =item SEE ALSO
13041
13042 =item AUTHOR
13043
13044 =back
13045
13046 =head2 ExtUtils::Miniperl, writemain - write the C code for perlmain.c
13047
13048 =over 4
13049
13050 =item SYNOPSIS
13051
13052 =item DESCRIPTION
13053
13054 =item SEE ALSO
13055
13056 =back
13057
13058 =head2 ExtUtils::Mkbootstrap - make a bootstrap file for use by DynaLoader
13059
13060 =over 4
13061
13062 =item SYNOPSIS
13063
13064 =item DESCRIPTION
13065
13066 =back
13067
13068 =head2 ExtUtils::Mksymlists - write linker options files for dynamic
13069 extension
13070
13071 =over 4
13072
13073 =item SYNOPSIS
13074
13075 =item DESCRIPTION
13076
13077 DLBASE, DL_FUNCS, DL_VARS, FILE, FUNCLIST, IMPORTS, NAME
13078
13079 =item AUTHOR
13080
13081 =item REVISION
13082
13083 =back
13084
13085 =head2 ExtUtils::Packlist - manage .packlist files
13086
13087 =over 4
13088
13089 =item SYNOPSIS
13090
13091 =item DESCRIPTION
13092
13093 =item USAGE
13094
13095 =item FUNCTIONS
13096
13097 new(), read(), write(), validate(), packlist_file()
13098
13099 =item EXAMPLE
13100
13101 =item AUTHOR
13102
13103 =back
13104
13105 =head2 ExtUtils::testlib - add blib/* directories to @INC
13106
13107 =over 4
13108
13109 =item SYNOPSIS
13110
13111 =item DESCRIPTION
13112
13113 =back
13114
13115 =head2 Fatal - replace functions with equivalents which succeed or die
13116
13117 =over 4
13118
13119 =item SYNOPSIS
13120
13121 =item DESCRIPTION
13122
13123 =item AUTHOR
13124
13125 =back
13126
13127 =head2 Fcntl - load the C Fcntl.h defines
13128
13129 =over 4
13130
13131 =item SYNOPSIS
13132
13133 =item DESCRIPTION
13134
13135 =item NOTE
13136
13137 =item EXPORTED SYMBOLS
13138
13139 =back
13140
13141 =head2 File::Basename, fileparse - split a pathname into pieces
13142
13143 =over 4
13144
13145 =item SYNOPSIS
13146
13147 =item DESCRIPTION
13148
13149 fileparse_set_fstype, fileparse
13150
13151 =item EXAMPLES
13152
13153 C<basename>, C<dirname>
13154
13155 =back
13156
13157 =head2 File::CheckTree, validate - run many filetest checks on a tree
13158
13159 =over 4
13160
13161 =item SYNOPSIS
13162
13163 =item DESCRIPTION
13164
13165 =item AUTHOR
13166
13167 =item HISTORY
13168
13169 =back
13170
13171 =head2 File::Compare - Compare files or filehandles
13172
13173 =over 4
13174
13175 =item SYNOPSIS
13176
13177 =item DESCRIPTION
13178
13179 =item RETURN
13180
13181 =item AUTHOR
13182
13183 =back
13184
13185 =head2 File::Copy - Copy files or filehandles
13186
13187 =over 4
13188
13189 =item SYNOPSIS
13190
13191 =item DESCRIPTION
13192
13193 =over 4
13194
13195 =item Special behaviour if C<syscopy> is defined (OS/2, VMS and Win32)
13196
13197 rmscopy($from,$to[,$date_flag])
13198
13199 =back
13200
13201 =item RETURN
13202
13203 =item NOTES
13204
13205 =item AUTHOR
13206
13207 =back
13208
13209 =head2 File::DosGlob - DOS like globbing and then some
13210
13211 =over 4
13212
13213 =item SYNOPSIS
13214
13215 =item DESCRIPTION
13216
13217 =item NOTES
13218
13219 =item EXPORTS (by request only)
13220
13221 =item BUGS
13222
13223 =item AUTHOR
13224
13225 =item HISTORY
13226
13227 =item SEE ALSO
13228
13229 =back
13230
13231 =head2 File::Find - Traverse a directory tree.
13232
13233 =over 4
13234
13235 =item SYNOPSIS
13236
13237 =item DESCRIPTION
13238
13239 B<find>, B<finddepth>
13240
13241 =over 4
13242
13243 =item %options
13244
13245 C<wanted>, C<bydepth>, C<preprocess>, C<postprocess>, C<follow>,
13246 C<follow_fast>, C<follow_skip>, C<dangling_symlinks>, C<no_chdir>,
13247 C<untaint>, C<untaint_pattern>, C<untaint_skip>
13248
13249 =item The wanted function
13250
13251 C<$File::Find::dir> is the current directory name,, C<$_> is the current
13252 filename within that directory, C<$File::Find::name> is the complete
13253 pathname to the file
13254
13255 =back
13256
13257 =item WARNINGS
13258
13259 =item CAVEAT
13260
13261 $dont_use_nlink, symlinks
13262
13263 =item NOTES
13264
13265 =item HISTORY
13266
13267 =back
13268
13269 =head2 File::Glob - Perl extension for BSD glob routine
13270
13271 =over 4
13272
13273 =item SYNOPSIS
13274
13275 =item DESCRIPTION
13276
13277 C<GLOB_ERR>, C<GLOB_LIMIT>, C<GLOB_MARK>, C<GLOB_NOCASE>, C<GLOB_NOCHECK>,
13278 C<GLOB_NOSORT>, C<GLOB_BRACE>, C<GLOB_NOMAGIC>, C<GLOB_QUOTE>,
13279 C<GLOB_TILDE>, C<GLOB_CSH>, C<GLOB_ALPHASORT>
13280
13281 =item DIAGNOSTICS
13282
13283 C<GLOB_NOSPACE>, C<GLOB_ABEND>
13284
13285 =item NOTES
13286
13287 =item AUTHOR
13288
13289 =back
13290
13291 =head2 File::Path - create or remove directory trees
13292
13293 =over 4
13294
13295 =item SYNOPSIS
13296
13297 =item DESCRIPTION
13298
13299 =item AUTHORS
13300
13301 =back
13302
13303 =head2 File::Spec - portably perform operations on file names
13304
13305 =over 4
13306
13307 =item SYNOPSIS
13308
13309 =item DESCRIPTION
13310
13311 =item METHODS
13312
13313 canonpath, catdir, catfile, curdir, devnull, rootdir, tmpdir, updir,
13314 no_upwards, case_tolerant, file_name_is_absolute, path, join, splitpath,
13315 splitdir, catpath(), abs2rel, rel2abs()
13316
13317 =item SEE ALSO
13318
13319 =item AUTHORS
13320
13321 =back
13322
13323 =head2 File::Spec::Cygwin - methods for Cygwin file specs
13324
13325 =over 4
13326
13327 =item SYNOPSIS
13328
13329 =item DESCRIPTION
13330
13331 =back
13332
13333 =head2 File::Spec::Epoc - methods for Epoc file specs
13334
13335 =over 4
13336
13337 =item SYNOPSIS
13338
13339 =item DESCRIPTION
13340
13341 canonpath()
13342
13343 =back
13344
13345 =over 4
13346
13347 =item SEE ALSO
13348
13349 =back
13350
13351 =head2 File::Spec::Functions - portably perform operations on file names
13352
13353 =over 4
13354
13355 =item SYNOPSIS
13356
13357 =item DESCRIPTION
13358
13359 =over 4
13360
13361 =item Exports
13362
13363 =back
13364
13365 =item SEE ALSO
13366
13367 =back
13368
13369 =head2 File::Spec::Mac - File::Spec for Mac OS (Classic)
13370
13371 =over 4
13372
13373 =item SYNOPSIS
13374
13375 =item DESCRIPTION
13376
13377 =item METHODS
13378
13379 canonpath
13380
13381 =back
13382
13383 catdir()
13384
13385 catfile
13386
13387 curdir
13388
13389 devnull
13390
13391 rootdir
13392
13393 tmpdir
13394
13395 updir
13396
13397 file_name_is_absolute
13398
13399 path
13400
13401 splitpath
13402
13403 splitdir
13404
13405 catpath
13406
13407 abs2rel
13408
13409 rel2abs
13410
13411 =over 4
13412
13413 =item AUTHORS
13414
13415 =item SEE ALSO
13416
13417 =back
13418
13419 canonpath
13420
13421 splitpath
13422
13423 splitdir
13424
13425 catpath
13426
13427 =head2 File::Spec::OS2 - methods for OS/2 file specs
13428
13429 =over 4
13430
13431 =item SYNOPSIS
13432
13433 =item DESCRIPTION
13434
13435 =back
13436
13437 =head2 File::Spec::Unix - File::Spec for Unix, base for other File::Spec
13438 modules
13439
13440 =over 4
13441
13442 =item SYNOPSIS
13443
13444 =item DESCRIPTION
13445
13446 =item METHODS
13447
13448 canonpath()
13449
13450 =back
13451
13452 catdir()
13453
13454 catfile
13455
13456 curdir
13457
13458 devnull
13459
13460 rootdir
13461
13462 tmpdir
13463
13464 updir
13465
13466 no_upwards
13467
13468 case_tolerant
13469
13470 file_name_is_absolute
13471
13472 path
13473
13474 join
13475
13476 splitpath
13477
13478 splitdir
13479
13480 catpath()
13481
13482 abs2rel
13483
13484 rel2abs()
13485
13486 =over 4
13487
13488 =item SEE ALSO
13489
13490 =back
13491
13492 =head2 File::Spec::VMS - methods for VMS file specs
13493
13494 =over 4
13495
13496 =item SYNOPSIS
13497
13498 =item DESCRIPTION
13499
13500 eliminate_macros
13501
13502 =back
13503
13504 fixpath
13505
13506 =over 4
13507
13508 =item Methods always loaded
13509
13510 canonpath (override)
13511
13512 =back
13513
13514 catdir
13515
13516 catfile
13517
13518 curdir (override)
13519
13520 devnull (override)
13521
13522 rootdir (override)
13523
13524 tmpdir (override)
13525
13526 updir (override)
13527
13528 case_tolerant (override)
13529
13530 path (override)
13531
13532 file_name_is_absolute (override)
13533
13534 splitpath (override)
13535
13536 splitdir (override)
13537
13538 catpath (override)
13539
13540 abs2rel (override)
13541
13542 rel2abs (override)
13543
13544 =over 4
13545
13546 =item SEE ALSO
13547
13548 =back
13549
13550 =head2 File::Spec::Win32 - methods for Win32 file specs
13551
13552 =over 4
13553
13554 =item SYNOPSIS
13555
13556 =item DESCRIPTION
13557
13558 devnull
13559
13560 =back
13561
13562 tmpdir
13563
13564 catfile
13565
13566 canonpath
13567
13568 splitpath
13569
13570 splitdir
13571
13572 catpath
13573
13574 =over 4
13575
13576 =item Note For File::Spec::Win32 Maintainers
13577
13578 =back
13579
13580 =over 4
13581
13582 =item SEE ALSO
13583
13584 =back
13585
13586 =head2 File::Temp - return name and handle of a temporary file safely
13587
13588 =over 4
13589
13590 =item PORTABILITY
13591
13592 =item SYNOPSIS
13593
13594 =item DESCRIPTION
13595
13596 =back
13597
13598 =over 4
13599
13600 =item FUNCTIONS
13601
13602 B<tempfile>
13603
13604 =back
13605
13606 B<tempdir>
13607
13608 =over 4
13609
13610 =item MKTEMP FUNCTIONS
13611
13612 B<mkstemp>
13613
13614 =back
13615
13616 B<mkstemps>
13617
13618 B<mkdtemp>
13619
13620 B<mktemp>
13621
13622 =over 4
13623
13624 =item POSIX FUNCTIONS
13625
13626 B<tmpnam>
13627
13628 =back
13629
13630 B<tmpfile>
13631
13632 =over 4
13633
13634 =item ADDITIONAL FUNCTIONS
13635
13636 B<tempnam>
13637
13638 =back
13639
13640 =over 4
13641
13642 =item UTILITY FUNCTIONS
13643
13644 B<unlink0>
13645
13646 =back
13647
13648 =over 4
13649
13650 =item PACKAGE VARIABLES
13651
13652 B<safe_level>, STANDARD, MEDIUM, HIGH
13653
13654 =back
13655
13656 TopSystemUID
13657
13658 =over 4
13659
13660 =item WARNING
13661
13662 =over 4
13663
13664 =item Temporary files and NFS
13665
13666 =back
13667
13668 =item HISTORY
13669
13670 =item SEE ALSO
13671
13672 =item AUTHOR
13673
13674 =back
13675
13676 =head2 File::stat - by-name interface to Perl's built-in stat() functions
13677
13678 =over 4
13679
13680 =item SYNOPSIS
13681
13682 =item DESCRIPTION
13683
13684 =item NOTE
13685
13686 =item AUTHOR
13687
13688 =back
13689
13690 =head2 FileCache - keep more files open than the system permits
13691
13692 =over 4
13693
13694 =item SYNOPSIS
13695
13696 =item DESCRIPTION
13697
13698 cacheout EXPR, cacheout MODE, EXPR
13699
13700 =item CAVEATS
13701
13702 =item BUGS
13703
13704 =back
13705
13706 =head2 FileHandle - supply object methods for filehandles
13707
13708 =over 4
13709
13710 =item SYNOPSIS
13711
13712 =item DESCRIPTION
13713
13714 $fh->print, $fh->printf, $fh->getline, $fh->getlines
13715
13716 =item SEE ALSO
13717
13718 =back
13719
13720 =head2 Filter::Simple - Simplified source filtering
13721
13722 =over 4
13723
13724 =item SYNOPSIS
13725
13726 =item DESCRIPTION
13727
13728 =over 4
13729
13730 =item The Problem
13731
13732 =item A Solution
13733
13734 =item Disabling or changing <no> behaviour
13735
13736 =item All-in-one interface
13737
13738 =item Filtering only specific components of source code
13739
13740 C<"code">, C<"executable">, C<"quotelike">, C<"string">, C<"regex">,
13741 C<"all">
13742
13743 =item Filtering only the code parts of source code
13744
13745 Most source code ceases to be grammatically correct when it is broken up
13746 into the pieces between string literals and regexes. So the C<'code'>
13747 component filter behaves slightly differently from the other partial
13748 filters
13749 described in the previous section.
13750
13751 =item Using Filter::Simple with an explicit C<import> subroutine
13752
13753 =item Using Filter::Simple and Exporter together
13754
13755 =item How it works
13756
13757 =back
13758
13759 =item AUTHOR
13760
13761 =item COPYRIGHT
13762
13763 =back
13764
13765 =head2 Filter::Util::Call - Perl Source Filter Utility Module
13766
13767 =over 4
13768
13769 =item SYNOPSIS
13770
13771 =item DESCRIPTION
13772
13773 =over 4
13774
13775 =item B<use Filter::Util::Call>
13776
13777 =item B<import()>
13778
13779 =item B<filter() and anonymous sub>
13780
13781 B<$_>, B<$status>, B<filter_read> and B<filter_read_exact>, B<filter_del>
13782
13783 =back
13784
13785 =item EXAMPLES
13786
13787 =over 4
13788
13789 =item Example 1: A simple filter.
13790
13791 =item Example 2: Using the context
13792
13793 =item Example 3: Using the context within the filter
13794
13795 =item Example 4: Using filter_del
13796
13797 =back
13798
13799 =item Filter::Simple
13800
13801 =item AUTHOR
13802
13803 =item DATE
13804
13805 =back
13806
13807 =head2 FindBin - Locate directory of original perl script
13808
13809 =over 4
13810
13811 =item SYNOPSIS
13812
13813 =item DESCRIPTION
13814
13815 =item EXPORTABLE VARIABLES
13816
13817 =item KNOWN ISSUES
13818
13819 =item KNOWN BUGS
13820
13821 =item AUTHORS
13822
13823 =item COPYRIGHT
13824
13825 =back
13826
13827 =head2 GDBM_File - Perl5 access to the gdbm library.
13828
13829 =over 4
13830
13831 =item SYNOPSIS
13832
13833 =item DESCRIPTION
13834
13835 =item AVAILABILITY
13836
13837 =item BUGS
13838
13839 =item SEE ALSO
13840
13841 =back
13842
13843 =head2 Getopt::Long - Extended processing of command line options
13844
13845 =over 4
13846
13847 =item SYNOPSIS
13848
13849 =item DESCRIPTION
13850
13851 =item Command Line Options, an Introduction
13852
13853 =item Getting Started with Getopt::Long
13854
13855 =over 4
13856
13857 =item Simple options
13858
13859 =item A little bit less simple options
13860
13861 =item Mixing command line option with other arguments
13862
13863 =item Options with values
13864
13865 =item Options with multiple values
13866
13867 =item Options with hash values
13868
13869 =item User-defined subroutines to handle options
13870
13871 =item Options with multiple names
13872
13873 =item Case and abbreviations
13874
13875 =item Summary of Option Specifications
13876
13877 !, +, s, i, o, f, : I<type> [ I<desttype> ], : I<number> [ I<desttype> ], :
13878 + [ I<desttype> ]
13879
13880 =back
13881
13882 =item Advanced Possibilities
13883
13884 =over 4
13885
13886 =item Object oriented interface
13887
13888 =item Thread Safety
13889
13890 =item Documentation and help texts
13891
13892 =item Storing options in a hash
13893
13894 =item Bundling
13895
13896 =item The lonesome dash
13897
13898 =item Argument callback
13899
13900 =back
13901
13902 =item Configuring Getopt::Long
13903
13904 default, posix_default, auto_abbrev, getopt_compat, gnu_compat, gnu_getopt,
13905 require_order, permute, bundling (default: disabled), bundling_override
13906 (default: disabled), ignore_case  (default: enabled), ignore_case_always
13907 (default: disabled), pass_through (default: disabled), prefix,
13908 prefix_pattern, debug (default: disabled)
13909
13910 =item Return values and Errors
13911
13912 =item Legacy
13913
13914 =over 4
13915
13916 =item Default destinations
13917
13918 =item Alternative option starters
13919
13920 =item Configuration variables
13921
13922 =back
13923
13924 =item Trouble Shooting
13925
13926 =over 4
13927
13928 =item Warning: Ignoring '!' modifier for short option
13929
13930 =item GetOptions does not return a false result when an option is not
13931 supplied
13932
13933 =item GetOptions does not split the command line correctly
13934
13935 =item How do I put a "-?" option into a Getopt::Long?
13936
13937 =back
13938
13939 =item AUTHOR
13940
13941 =item COPYRIGHT AND DISCLAIMER
13942
13943 =back
13944
13945 =head2 Getopt::Std, getopt - Process single-character switches with switch
13946 clustering
13947
13948 =over 4
13949
13950 =item SYNOPSIS
13951
13952 =item DESCRIPTION
13953
13954 =back
13955
13956 =head2 Hash::Util - A selection of general-utility hash subroutines
13957
13958 =over 4
13959
13960 =item SYNOPSIS
13961
13962 =item DESCRIPTION
13963
13964 =over 4
13965
13966 =item Restricted hashes
13967
13968 lock_keys, unlock_keys
13969
13970 =back
13971
13972 =back
13973
13974 lock_value, unlock_value
13975
13976 B<lock_hash>, B<unlock_hash>
13977
13978 =over 4
13979
13980 =item AUTHOR
13981
13982 =item SEE ALSO
13983
13984 =back
13985
13986 =head2 I18N::Collate - compare 8-bit scalar data according to the current
13987 locale
13988
13989 =over 4
13990
13991 =item SYNOPSIS
13992
13993 =item DESCRIPTION
13994
13995 =back
13996
13997 =head2 I18N::LangTags - functions for dealing with RFC3066-style language
13998 tags
13999
14000 =over 4
14001
14002 =item SYNOPSIS
14003
14004 =item DESCRIPTION
14005
14006 =back
14007
14008 the function is_language_tag($lang1)
14009
14010 the function extract_language_tags($whatever)
14011
14012 the function same_language_tag($lang1, $lang2)
14013
14014 the function similarity_language_tag($lang1, $lang2)
14015
14016 the function is_dialect_of($lang1, $lang2)
14017
14018 the function super_languages($lang1)
14019
14020 the function locale2language_tag($locale_identifier)
14021
14022 the function encode_language_tag($lang1)
14023
14024 the function alternate_language_tags($lang1)
14025
14026 the function @langs = panic_languages(@accept_languages)
14027
14028 =over 4
14029
14030 =item ABOUT LOWERCASING
14031
14032 =item ABOUT UNICODE PLAINTEXT LANGUAGE TAGS
14033
14034 =item SEE ALSO
14035
14036 =item COPYRIGHT
14037
14038 =item AUTHOR
14039
14040 =back
14041
14042 =head2 I18N::LangTags::List -- tags and names for human languages
14043
14044 =over 4
14045
14046 =item SYNOPSIS
14047
14048 =item DESCRIPTION
14049
14050 =item ABOUT LANGUAGE TAGS
14051
14052 =item LIST OF LANGUAGES
14053
14054 {ab} : Abkhazian, {ace} : Achinese, {ach} : Acoli, {ada} : Adangme, {aa} :
14055 Afar, {afh} : Afrihili, {af} : Afrikaans, [{afa} : Afro-Asiatic (Other)],
14056 {aka} : Akan, {akk} : Akkadian, {sq} : Albanian, {ale} : Aleut, [{alg} :
14057 Algonquian languages], [{tut} : Altaic (Other)], {am} : Amharic, {i-ami} :
14058 Ami, [{apa} : Apache languages], {ar} : Arabic, {arc} : Aramaic, {arp} :
14059 Arapaho, {arn} : Araucanian, {arw} : Arawak, {hy} : Armenian, [{art} :
14060 Artificial (Other)], {as} : Assamese, [{ath} : Athapascan languages],
14061 [{aus} : Australian languages], [{map} : Austronesian (Other)], {ava} :
14062 Avaric, {ae} : Avestan, {awa} : Awadhi, {ay} : Aymara, {az} : Azerbaijani,
14063 {ban} : Balinese, [{bat} : Baltic (Other)], {bal} : Baluchi, {bam} :
14064 Bambara, [{bai} : Bamileke languages], {bad} : Banda, [{bnt} : Bantu
14065 (Other)], {bas} : Basa, {ba} : Bashkir, {eu} : Basque, {btk} : Batak
14066 (Indonesia), {bej} : Beja, {be} : Belarusian, {bem} : Bemba, {bn} :
14067 Bengali, [{ber} : Berber (Other)], {bho} : Bhojpuri, {bh} : Bihari, {bik} :
14068 Bikol, {bin} : Bini, {bi} : Bislama, {bs} : Bosnian, {bra} : Braj, {br} :
14069 Breton, {bug} : Buginese, {bg} : Bulgarian, {i-bnn} : Bunun, {bua} :
14070 Buriat, {my} : Burmese, {cad} : Caddo, {car} : Carib, {ca} : Catalan,
14071 [{cau} : Caucasian (Other)], {ceb} : Cebuano, [{cel} : Celtic (Other)],
14072 [{cai} : Central American Indian (Other)], {chg} : Chagatai, [{cmc} :
14073 Chamic languages], {ch} : Chamorro, {ce} : Chechen, {chr} : Cherokee, {chy}
14074 : Cheyenne, {chb} : Chibcha, {ny} : Chichewa, {zh} : Chinese, {chn} :
14075 Chinook Jargon, {chp} : Chipewyan, {cho} : Choctaw, {cu} : Church Slavic,
14076 {chk} : Chuukese, {cv} : Chuvash, {cop} : Coptic, {kw} : Cornish, {co} :
14077 Corsican, {cre} : Cree, {mus} : Creek, [{cpe} : English-based Creoles and
14078 pidgins (Other)], [{cpf} : French-based Creoles and pidgins (Other)],
14079 [{cpp} : Portuguese-based Creoles and pidgins (Other)], [{crp} : Creoles
14080 and pidgins (Other)], {hr} : Croatian, [{cus} : Cushitic (Other)], {cs} :
14081 Czech, {dak} : Dakota, {da} : Danish, {day} : Dayak, {i-default} : Default
14082 (Fallthru) Language, {del} : Delaware, {din} : Dinka, {div} : Divehi, {doi}
14083 : Dogri, {dgr} : Dogrib, [{dra} : Dravidian (Other)], {dua} : Duala, {nl} :
14084 Dutch, {dum} : Middle Dutch (ca.1050-1350), {dyu} : Dyula, {dz} : Dzongkha,
14085 {efi} : Efik, {egy} : Ancient Egyptian, {eka} : Ekajuk, {elx} : Elamite,
14086 {en} : English, {enm} : Old English (1100-1500), {ang} : Old English
14087 (ca.450-1100), {eo} : Esperanto, {et} : Estonian, {ewe} : Ewe, {ewo} :
14088 Ewondo, {fan} : Fang, {fat} : Fanti, {fo} : Faroese, {fj} : Fijian, {fi} :
14089 Finnish, [{fiu} : Finno-Ugrian (Other)], {fon} : Fon, {fr} : French, {frm}
14090 : Middle French (ca.1400-1600), {fro} : Old French (842-ca.1400), {fy} :
14091 Frisian, {fur} : Friulian, {ful} : Fulah, {gaa} : Ga, {gd} : Scots Gaelic,
14092 {gl} : Gallegan, {lug} : Ganda, {gay} : Gayo, {gba} : Gbaya, {gez} : Geez,
14093 {ka} : Georgian, {de} : German, {gmh} : Middle High German (ca.1050-1500),
14094 {goh} : Old High German (ca.750-1050), [{gem} : Germanic (Other)], {gil} :
14095 Gilbertese, {gon} : Gondi, {gor} : Gorontalo, {got} : Gothic, {grb} :
14096 Grebo, {grc} : Ancient Greek, {el} : Modern Greek, {gn} : Guarani, {gu} :
14097 Gujarati, {gwi} : Gwich'in, {hai} : Haida, {ha} : Hausa, {haw} : Hawaiian,
14098 {he} : Hebrew, {hz} : Herero, {hil} : Hiligaynon, {him} : Himachali, {hi} :
14099 Hindi, {ho} : Hiri Motu, {hit} : Hittite, {hmn} : Hmong, {hu} : Hungarian,
14100 {hup} : Hupa, {iba} : Iban, {is} : Icelandic, {ibo} : Igbo, {ijo} : Ijo,
14101 {ilo} : Iloko, [{inc} : Indic (Other)], [{ine} : Indo-European (Other)],
14102 {id} : Indonesian, {ia} : Interlingua (International Auxiliary Language
14103 Association), {ie} : Interlingue, {iu} : Inuktitut, {ik} : Inupiaq, [{ira}
14104 : Iranian (Other)], {ga} : Irish, {mga} : Middle Irish (900-1200), {sga} :
14105 Old Irish (to 900), [{iro} : Iroquoian languages], {it} : Italian, {ja} :
14106 Japanese, {jw} : Javanese, {jrb} : Judeo-Arabic, {jpr} : Judeo-Persian,
14107 {kab} : Kabyle, {kac} : Kachin, {kl} : Kalaallisut, {kam} : Kamba, {kn} :
14108 Kannada, {kau} : Kanuri, {kaa} : Kara-Kalpak, {kar} : Karen, {ks} :
14109 Kashmiri, {kaw} : Kawi, {kk} : Kazakh, {kha} : Khasi, {km} : Khmer, [{khi}
14110 : Khoisan (Other)], {kho} : Khotanese, {ki} : Kikuyu, {kmb} : Kimbundu,
14111 {rw} : Kinyarwanda, {ky} : Kirghiz, {i-klingon} : Klingon, {kv} : Komi,
14112 {kon} : Kongo, {kok} : Konkani, {ko} : Korean, {kos} : Kosraean, {kpe} :
14113 Kpelle, {kro} : Kru, {kj} : Kuanyama, {kum} : Kumyk, {ku} : Kurdish, {kru}
14114 : Kurukh, {kut} : Kutenai, {lad} : Ladino, {lah} : Lahnda, {lam} : Lamba,
14115 {lo} : Lao, {la} : Latin, {lv} : Latvian, {lb} : Letzeburgesch, {lez} :
14116 Lezghian, {ln} : Lingala, {lt} : Lithuanian, {nds} : Low German, {loz} :
14117 Lozi, {lub} : Luba-Katanga, {lua} : Luba-Lulua, {lui} : Luiseno, {lun} :
14118 Lunda, {luo} : Luo (Kenya and Tanzania), {lus} : Lushai, {mk} : Macedonian,
14119 {mad} : Madurese, {mag} : Magahi, {mai} : Maithili, {mak} : Makasar, {mg} :
14120 Malagasy, {ms} : Malay, {ml} : Malayalam, {mt} : Maltese, {mnc} : Manchu,
14121 {mdr} : Mandar, {man} : Mandingo, {mni} : Manipuri, [{mno} : Manobo
14122 languages], {gv} : Manx, {mi} : Maori, {mr} : Marathi, {chm} : Mari, {mh} :
14123 Marshall, {mwr} : Marwari, {mas} : Masai, [{myn} : Mayan languages], {men}
14124 : Mende, {mic} : Micmac, {min} : Minangkabau, {i-mingo} : Mingo, [{mis} :
14125 Miscellaneous languages], {moh} : Mohawk, {mo} : Moldavian, [{mkh} :
14126 Mon-Khmer (Other)], {lol} : Mongo, {mn} : Mongolian, {mos} : Mossi, [{mul}
14127 : Multiple languages], [{mun} : Munda languages], {nah} : Nahuatl, {na} :
14128 Nauru, {nv} : Navajo, {nd} : North Ndebele, {nr} : South Ndebele, {ng} :
14129 Ndonga, {ne} : Nepali, {new} : Newari, {nia} : Nias, [{nic} :
14130 Niger-Kordofanian (Other)], [{ssa} : Nilo-Saharan (Other)], {niu} : Niuean,
14131 {non} : Old Norse, [{nai} : North American Indian], {se} : Northern Sami,
14132 {no} : Norwegian, {nb} : Norwegian Bokmal, {nn} : Norwegian Nynorsk, [{nub}
14133 : Nubian languages], {nym} : Nyamwezi, {nyn} : Nyankole, {nyo} : Nyoro,
14134 {nzi} : Nzima, {oc} : Occitan (post 1500), {oji} : Ojibwa, {or} : Oriya,
14135 {om} : Oromo, {osa} : Osage, {os} : Ossetian; Ossetic, [{oto} : Otomian
14136 languages], {pal} : Pahlavi, {i-pwn} : Paiwan, {pau} : Palauan, {pi} :
14137 Pali, {pam} : Pampanga, {pag} : Pangasinan, {pa} : Panjabi, {pap} :
14138 Papiamento, [{paa} : Papuan (Other)], {fa} : Persian, {peo} : Old Persian
14139 (ca.600-400 B.C.), [{phi} : Philippine (Other)], {phn} : Phoenician, {pon}
14140 : Pohnpeian, {pl} : Polish, {pt} : Portuguese, [{pra} : Prakrit languages],
14141 {pro} : Old Provencal (to 1500), {ps} : Pushto, {qu} : Quechua, {rm} :
14142 Raeto-Romance, {raj} : Rajasthani, {rap} : Rapanui, {rar} : Rarotongan,
14143 [{qaa - qtz} : Reserved for local use.], [{roa} : Romance (Other)], {ro} :
14144 Romanian, {rom} : Romany, {rn} : Rundi, {ru} : Russian, [{sal} : Salishan
14145 languages], {sam} : Samaritan Aramaic, [{smi} : Sami languages (Other)],
14146 {sm} : Samoan, {sad} : Sandawe, {sg} : Sango, {sa} : Sanskrit, {sat} :
14147 Santali, {sc} : Sardinian, {sas} : Sasak, {sco} : Scots, {sel} : Selkup,
14148 [{sem} : Semitic (Other)], {sr} : Serbian, {srr} : Serer, {shn} : Shan,
14149 {sn} : Shona, {sid} : Sidamo, {sgn-...} : Sign Languages, {bla} : Siksika,
14150 {sd} : Sindhi, {si} : Sinhalese, [{sit} : Sino-Tibetan (Other)], [{sio} :
14151 Siouan languages], {den} : Slave (Athapascan), [{sla} : Slavic (Other)],
14152 {sk} : Slovak, {sl} : Slovenian, {sog} : Sogdian, {so} : Somali, {son} :
14153 Songhai, {snk} : Soninke, {wen} : Sorbian languages, {nso} : Northern
14154 Sotho, {st} : Southern Sotho, [{sai} : South American Indian (Other)], {es}
14155 : Spanish, {suk} : Sukuma, {sux} : Sumerian, {su} : Sundanese, {sus} :
14156 Susu, {sw} : Swahili, {ss} : Swati, {sv} : Swedish, {syr} : Syriac, {tl} :
14157 Tagalog, {ty} : Tahitian, [{tai} : Tai (Other)], {tg} : Tajik, {tmh} :
14158 Tamashek, {ta} : Tamil, {i-tao} : Tao, {tt} : Tatar, {i-tay} : Tayal, {te}
14159 : Telugu, {ter} : Tereno, {tet} : Tetum, {th} : Thai, {bo} : Tibetan, {tig}
14160 : Tigre, {ti} : Tigrinya, {tem} : Timne, {tiv} : Tiv, {tli} : Tlingit,
14161 {tpi} : Tok Pisin, {tkl} : Tokelau, {tog} : Tonga (Nyasa), {to} : Tonga
14162 (Tonga Islands), {tsi} : Tsimshian, {ts} : Tsonga, {i-tsu} : Tsou, {tn} :
14163 Tswana, {tum} : Tumbuka, {tr} : Turkish, {ota} : Ottoman Turkish
14164 (1500-1928), {tk} : Turkmen, {tvl} : Tuvalu, {tyv} : Tuvinian, {tw} : Twi,
14165 {uga} : Ugaritic, {ug} : Uighur, {uk} : Ukrainian, {umb} : Umbundu, {und} :
14166 Undetermined, {ur} : Urdu, {uz} : Uzbek, {vai} : Vai, {ven} : Venda, {vi} :
14167 Vietnamese, {vo} : Volapuk, {vot} : Votic, [{wak} : Wakashan languages],
14168 {wal} : Walamo, {war} : Waray, {was} : Washo, {cy} : Welsh, {wo} : Wolof,
14169 {x-...} : Unregistered (Semi-Private Use), {xh} : Xhosa, {sah} : Yakut,
14170 {yao} : Yao, {yap} : Yapese, {yi} : Yiddish, {yo} : Yoruba, [{ypk} : Yupik
14171 languages], {znd} : Zande, [{zap} : Zapotec], {zen} : Zenaga, {za} :
14172 Zhuang, {zu} : Zulu, {zun} : Zuni
14173
14174 =item SEE ALSO
14175
14176 =item COPYRIGHT AND DISCLAIMER
14177
14178 =item AUTHOR
14179
14180 =back
14181
14182 =head2 I18N::Langinfo - query locale information
14183
14184 =over 4
14185
14186 =item SYNOPSIS
14187
14188 =item DESCRIPTION
14189
14190 =over 4
14191
14192 =item EXPORT
14193
14194 =back
14195
14196 =item SEE ALSO
14197
14198 =item AUTHOR
14199
14200 =item COPYRIGHT AND LICENSE
14201
14202 =back
14203
14204 =head2 IO - load various IO modules
14205
14206 =over 4
14207
14208 =item SYNOPSIS
14209
14210 =item DESCRIPTION
14211
14212 =back
14213
14214 =head2 IO::Dir - supply object methods for directory handles
14215
14216 =over 4
14217
14218 =item SYNOPSIS
14219
14220 =item DESCRIPTION
14221
14222 new ( [ DIRNAME ] ), open ( DIRNAME ), read (), seek ( POS ), tell (),
14223 rewind (), close (), tie %hash, IO::Dir, DIRNAME [, OPTIONS ]
14224
14225 =item SEE ALSO
14226
14227 =item AUTHOR
14228
14229 =item COPYRIGHT
14230
14231 =back
14232
14233 =head2 IO::File - supply object methods for filehandles
14234
14235 =over 4
14236
14237 =item SYNOPSIS
14238
14239 =item DESCRIPTION
14240
14241 =item CONSTRUCTOR
14242
14243 new ( FILENAME [,MODE [,PERMS]] ), new_tmpfile
14244
14245 =item METHODS
14246
14247 open( FILENAME [,MODE [,PERMS]] )
14248
14249 =item SEE ALSO
14250
14251 =item HISTORY
14252
14253 =back
14254
14255 =head2 IO::Handle - supply object methods for I/O handles
14256
14257 =over 4
14258
14259 =item SYNOPSIS
14260
14261 =item DESCRIPTION
14262
14263 =item CONSTRUCTOR
14264
14265 new (), new_from_fd ( FD, MODE )
14266
14267 =item METHODS
14268
14269 $io->fdopen ( FD, MODE ), $io->opened, $io->getline, $io->getlines,
14270 $io->ungetc ( ORD ), $io->write ( BUF, LEN [, OFFSET ] ), $io->error,
14271 $io->clearerr, $io->sync, $io->flush, $io->printflush ( ARGS ),
14272 $io->blocking ( [ BOOL ] ), $io->untaint
14273
14274 =item NOTE
14275
14276 =item SEE ALSO
14277
14278 =item BUGS
14279
14280 =item HISTORY
14281
14282 =back
14283
14284 =head2 IO::Pipe - supply object methods for pipes
14285
14286 =over 4
14287
14288 =item SYNOPSIS
14289
14290 =item DESCRIPTION
14291
14292 =item CONSTRUCTOR
14293
14294 new ( [READER, WRITER] )
14295
14296 =item METHODS
14297
14298 reader ([ARGS]), writer ([ARGS]), handles ()
14299
14300 =item SEE ALSO
14301
14302 =item AUTHOR
14303
14304 =item COPYRIGHT
14305
14306 =back
14307
14308 =head2 IO::Poll - Object interface to system poll call
14309
14310 =over 4
14311
14312 =item SYNOPSIS
14313
14314 =item DESCRIPTION
14315
14316 =item METHODS
14317
14318 mask ( IO [, EVENT_MASK ] ), poll ( [ TIMEOUT ] ), events ( IO ), remove (
14319 IO ), handles( [ EVENT_MASK ] )
14320
14321 =item SEE ALSO
14322
14323 =item AUTHOR
14324
14325 =item COPYRIGHT
14326
14327 =back
14328
14329 =head2 IO::Seekable - supply seek based methods for I/O objects
14330
14331 =over 4
14332
14333 =item SYNOPSIS
14334
14335 =item DESCRIPTION
14336
14337 $io->getpos, $io->setpos, $io->seek ( POS, WHENCE ), WHENCE=0 (SEEK_SET),
14338 WHENCE=1 (SEEK_CUR), WHENCE=2 (SEEK_END), $io->sysseek( POS, WHENCE ),
14339 $io->tell
14340
14341 =item SEE ALSO
14342
14343 =item HISTORY
14344
14345 =back
14346
14347 =head2 IO::Select - OO interface to the select system call
14348
14349 =over 4
14350
14351 =item SYNOPSIS
14352
14353 =item DESCRIPTION
14354
14355 =item CONSTRUCTOR
14356
14357 new ( [ HANDLES ] )
14358
14359 =item METHODS
14360
14361 add ( HANDLES ), remove ( HANDLES ), exists ( HANDLE ), handles, can_read (
14362 [ TIMEOUT ] ), can_write ( [ TIMEOUT ] ), has_exception ( [ TIMEOUT ] ),
14363 count (), bits(), select ( READ, WRITE, ERROR [, TIMEOUT ] )
14364
14365 =item EXAMPLE
14366
14367 =item AUTHOR
14368
14369 =item COPYRIGHT
14370
14371 =back
14372
14373 =head2 IO::Socket - Object interface to socket communications
14374
14375 =over 4
14376
14377 =item SYNOPSIS
14378
14379 =item DESCRIPTION
14380
14381 =item CONSTRUCTOR
14382
14383 new ( [ARGS] )
14384
14385 =item METHODS
14386
14387 accept([PKG]), socketpair(DOMAIN, TYPE, PROTOCOL), atmark, connected,
14388 protocol, sockdomain, sockopt(OPT [, VAL]), socktype, timeout([VAL])
14389
14390 =item SEE ALSO
14391
14392 =item AUTHOR
14393
14394 =item COPYRIGHT
14395
14396 =back
14397
14398 =head2 IO::Socket::INET - Object interface for AF_INET domain sockets
14399
14400 =over 4
14401
14402 =item SYNOPSIS
14403
14404 =item DESCRIPTION
14405
14406 =item CONSTRUCTOR
14407
14408 new ( [ARGS] )
14409
14410 =over 4
14411
14412 =item METHODS
14413
14414 sockaddr (), sockport (), sockhost (), peeraddr (), peerport (), peerhost
14415 ()
14416
14417 =back
14418
14419 =item SEE ALSO
14420
14421 =item AUTHOR
14422
14423 =item COPYRIGHT
14424
14425 =back
14426
14427 =head2 IO::Socket::UNIX - Object interface for AF_UNIX domain sockets
14428
14429 =over 4
14430
14431 =item SYNOPSIS
14432
14433 =item DESCRIPTION
14434
14435 =item CONSTRUCTOR
14436
14437 new ( [ARGS] )
14438
14439 =item METHODS
14440
14441 hostpath(), peerpath()
14442
14443 =item SEE ALSO
14444
14445 =item AUTHOR
14446
14447 =item COPYRIGHT
14448
14449 =back
14450
14451 =head2 IO::lib::IO::Dir, IO::Dir - supply object methods for directory
14452 handles
14453
14454 =over 4
14455
14456 =item SYNOPSIS
14457
14458 =item DESCRIPTION
14459
14460 new ( [ DIRNAME ] ), open ( DIRNAME ), read (), seek ( POS ), tell (),
14461 rewind (), close (), tie %hash, IO::Dir, DIRNAME [, OPTIONS ]
14462
14463 =item SEE ALSO
14464
14465 =item AUTHOR
14466
14467 =item COPYRIGHT
14468
14469 =back
14470
14471 =head2 IO::lib::IO::File, IO::File - supply object methods for filehandles
14472
14473 =over 4
14474
14475 =item SYNOPSIS
14476
14477 =item DESCRIPTION
14478
14479 =item CONSTRUCTOR
14480
14481 new ( FILENAME [,MODE [,PERMS]] ), new_tmpfile
14482
14483 =item METHODS
14484
14485 open( FILENAME [,MODE [,PERMS]] )
14486
14487 =item SEE ALSO
14488
14489 =item HISTORY
14490
14491 =back
14492
14493 =head2 IO::lib::IO::Handle, IO::Handle - supply object methods for I/O
14494 handles
14495
14496 =over 4
14497
14498 =item SYNOPSIS
14499
14500 =item DESCRIPTION
14501
14502 =item CONSTRUCTOR
14503
14504 new (), new_from_fd ( FD, MODE )
14505
14506 =item METHODS
14507
14508 $io->fdopen ( FD, MODE ), $io->opened, $io->getline, $io->getlines,
14509 $io->ungetc ( ORD ), $io->write ( BUF, LEN [, OFFSET ] ), $io->error,
14510 $io->clearerr, $io->sync, $io->flush, $io->printflush ( ARGS ),
14511 $io->blocking ( [ BOOL ] ), $io->untaint
14512
14513 =item NOTE
14514
14515 =item SEE ALSO
14516
14517 =item BUGS
14518
14519 =item HISTORY
14520
14521 =back
14522
14523 =head2 IO::lib::IO::Pipe, IO::Pipe - supply object methods for pipes
14524
14525 =over 4
14526
14527 =item SYNOPSIS
14528
14529 =item DESCRIPTION
14530
14531 =item CONSTRUCTOR
14532
14533 new ( [READER, WRITER] )
14534
14535 =item METHODS
14536
14537 reader ([ARGS]), writer ([ARGS]), handles ()
14538
14539 =item SEE ALSO
14540
14541 =item AUTHOR
14542
14543 =item COPYRIGHT
14544
14545 =back
14546
14547 =head2 IO::lib::IO::Poll, IO::Poll - Object interface to system poll call
14548
14549 =over 4
14550
14551 =item SYNOPSIS
14552
14553 =item DESCRIPTION
14554
14555 =item METHODS
14556
14557 mask ( IO [, EVENT_MASK ] ), poll ( [ TIMEOUT ] ), events ( IO ), remove (
14558 IO ), handles( [ EVENT_MASK ] )
14559
14560 =item SEE ALSO
14561
14562 =item AUTHOR
14563
14564 =item COPYRIGHT
14565
14566 =back
14567
14568 =head2 IO::lib::IO::Seekable, IO::Seekable - supply seek based methods for
14569 I/O objects
14570
14571 =over 4
14572
14573 =item SYNOPSIS
14574
14575 =item DESCRIPTION
14576
14577 $io->getpos, $io->setpos, $io->seek ( POS, WHENCE ), WHENCE=0 (SEEK_SET),
14578 WHENCE=1 (SEEK_CUR), WHENCE=2 (SEEK_END), $io->sysseek( POS, WHENCE ),
14579 $io->tell
14580
14581 =item SEE ALSO
14582
14583 =item HISTORY
14584
14585 =back
14586
14587 =head2 IO::lib::IO::Select, IO::Select - OO interface to the select system
14588 call
14589
14590 =over 4
14591
14592 =item SYNOPSIS
14593
14594 =item DESCRIPTION
14595
14596 =item CONSTRUCTOR
14597
14598 new ( [ HANDLES ] )
14599
14600 =item METHODS
14601
14602 add ( HANDLES ), remove ( HANDLES ), exists ( HANDLE ), handles, can_read (
14603 [ TIMEOUT ] ), can_write ( [ TIMEOUT ] ), has_exception ( [ TIMEOUT ] ),
14604 count (), bits(), select ( READ, WRITE, ERROR [, TIMEOUT ] )
14605
14606 =item EXAMPLE
14607
14608 =item AUTHOR
14609
14610 =item COPYRIGHT
14611
14612 =back
14613
14614 =head2 IO::lib::IO::Socket, IO::Socket - Object interface to socket
14615 communications
14616
14617 =over 4
14618
14619 =item SYNOPSIS
14620
14621 =item DESCRIPTION
14622
14623 =item CONSTRUCTOR
14624
14625 new ( [ARGS] )
14626
14627 =item METHODS
14628
14629 accept([PKG]), socketpair(DOMAIN, TYPE, PROTOCOL), atmark, connected,
14630 protocol, sockdomain, sockopt(OPT [, VAL]), socktype, timeout([VAL])
14631
14632 =item SEE ALSO
14633
14634 =item AUTHOR
14635
14636 =item COPYRIGHT
14637
14638 =back
14639
14640 =head2 IO::lib::IO::Socket::INET, IO::Socket::INET - Object interface for
14641 AF_INET domain sockets
14642
14643 =over 4
14644
14645 =item SYNOPSIS
14646
14647 =item DESCRIPTION
14648
14649 =item CONSTRUCTOR
14650
14651 new ( [ARGS] )
14652
14653 =over 4
14654
14655 =item METHODS
14656
14657 sockaddr (), sockport (), sockhost (), peeraddr (), peerport (), peerhost
14658 ()
14659
14660 =back
14661
14662 =item SEE ALSO
14663
14664 =item AUTHOR
14665
14666 =item COPYRIGHT
14667
14668 =back
14669
14670 =head2 IO::lib::IO::Socket::UNIX, IO::Socket::UNIX - Object interface for
14671 AF_UNIX domain sockets
14672
14673 =over 4
14674
14675 =item SYNOPSIS
14676
14677 =item DESCRIPTION
14678
14679 =item CONSTRUCTOR
14680
14681 new ( [ARGS] )
14682
14683 =item METHODS
14684
14685 hostpath(), peerpath()
14686
14687 =item SEE ALSO
14688
14689 =item AUTHOR
14690
14691 =item COPYRIGHT
14692
14693 =back
14694
14695 =head2 IPC::Msg - SysV Msg IPC object class
14696
14697 =over 4
14698
14699 =item SYNOPSIS
14700
14701 =item DESCRIPTION
14702
14703 =item METHODS
14704
14705 new ( KEY , FLAGS ), id, rcv ( BUF, LEN [, TYPE [, FLAGS ]] ), remove, set
14706 ( STAT ), set ( NAME => VALUE [, NAME => VALUE ...] ), snd ( TYPE, MSG [,
14707 FLAGS ] ), stat
14708
14709 =item SEE ALSO
14710
14711 =item AUTHOR
14712
14713 =item COPYRIGHT
14714
14715 =back
14716
14717 =head2 IPC::Open2, open2 - open a process for both reading and writing
14718
14719 =over 4
14720
14721 =item SYNOPSIS
14722
14723 =item DESCRIPTION
14724
14725 =item WARNING
14726
14727 =item SEE ALSO
14728
14729 =back
14730
14731 =head2 IPC::Open3, open3 - open a process for reading, writing, and error
14732 handling
14733
14734 =over 4
14735
14736 =item SYNOPSIS
14737
14738 =item DESCRIPTION
14739
14740 =item WARNING
14741
14742 =back
14743
14744 =head2 IPC::Semaphore - SysV Semaphore IPC object class
14745
14746 =over 4
14747
14748 =item SYNOPSIS
14749
14750 =item DESCRIPTION
14751
14752 =item METHODS
14753
14754 new ( KEY , NSEMS , FLAGS ), getall, getncnt ( SEM ), getpid ( SEM ),
14755 getval ( SEM ), getzcnt ( SEM ), id, op ( OPLIST ), remove, set ( STAT ),
14756 set ( NAME => VALUE [, NAME => VALUE ...] ), setall ( VALUES ), setval ( N
14757 , VALUE ), stat
14758
14759 =item SEE ALSO
14760
14761 =item AUTHOR
14762
14763 =item COPYRIGHT
14764
14765 =back
14766
14767 =head2 IPC::SysV - SysV IPC constants
14768
14769 =over 4
14770
14771 =item SYNOPSIS
14772
14773 =item DESCRIPTION
14774
14775 ftok( PATH, ID )
14776
14777 =item SEE ALSO
14778
14779 =item AUTHORS
14780
14781 =item COPYRIGHT
14782
14783 =back
14784
14785 =head2 IPC::SysV::Msg, IPC::Msg - SysV Msg IPC object class
14786
14787 =over 4
14788
14789 =item SYNOPSIS
14790
14791 =item DESCRIPTION
14792
14793 =item METHODS
14794
14795 new ( KEY , FLAGS ), id, rcv ( BUF, LEN [, TYPE [, FLAGS ]] ), remove, set
14796 ( STAT ), set ( NAME => VALUE [, NAME => VALUE ...] ), snd ( TYPE, MSG [,
14797 FLAGS ] ), stat
14798
14799 =item SEE ALSO
14800
14801 =item AUTHOR
14802
14803 =item COPYRIGHT
14804
14805 =back
14806
14807 =head2 IPC::SysV::Semaphore, IPC::Semaphore - SysV Semaphore IPC object
14808 class
14809
14810 =over 4
14811
14812 =item SYNOPSIS
14813
14814 =item DESCRIPTION
14815
14816 =item METHODS
14817
14818 new ( KEY , NSEMS , FLAGS ), getall, getncnt ( SEM ), getpid ( SEM ),
14819 getval ( SEM ), getzcnt ( SEM ), id, op ( OPLIST ), remove, set ( STAT ),
14820 set ( NAME => VALUE [, NAME => VALUE ...] ), setall ( VALUES ), setval ( N
14821 , VALUE ), stat
14822
14823 =item SEE ALSO
14824
14825 =item AUTHOR
14826
14827 =item COPYRIGHT
14828
14829 =back
14830
14831 =head2 List::Util - A selection of general-utility list subroutines
14832
14833 =over 4
14834
14835 =item SYNOPSIS
14836
14837 =item DESCRIPTION
14838
14839 first BLOCK LIST, max LIST, maxstr LIST, min LIST, minstr LIST, reduce
14840 BLOCK LIST, shuffle LIST, sum LIST
14841
14842 =item KNOWN BUGS
14843
14844 =item SUGGESTED ADDITIONS
14845
14846 =item COPYRIGHT
14847
14848 =back
14849
14850 =head2 List::Utilib::List::Util, List::Util - A selection of
14851 general-utility list subroutines
14852
14853 =over 4
14854
14855 =item SYNOPSIS
14856
14857 =item DESCRIPTION
14858
14859 first BLOCK LIST, max LIST, maxstr LIST, min LIST, minstr LIST, reduce
14860 BLOCK LIST, shuffle LIST, sum LIST
14861
14862 =item KNOWN BUGS
14863
14864 =item SUGGESTED ADDITIONS
14865
14866 =item COPYRIGHT
14867
14868 =back
14869
14870 =head2 List::Utilib::Scalar::Util, Scalar::Util - A selection of
14871 general-utility scalar subroutines
14872
14873 =over 4
14874
14875 =item SYNOPSIS
14876
14877 =item DESCRIPTION
14878
14879 blessed EXPR, dualvar NUM, STRING, isweak EXPR, openhandle FH, reftype
14880 EXPR, tainted EXPR, weaken REF
14881
14882 =item KNOWN BUGS
14883
14884 =item COPYRIGHT
14885
14886 =item BLATANT PLUG
14887
14888 =back
14889
14890 =head2 Locale::Constants - constants for Locale codes
14891
14892 =over 4
14893
14894 =item SYNOPSIS
14895
14896 =item DESCRIPTION
14897
14898 =item KNOWN BUGS AND LIMITATIONS
14899
14900 =item SEE ALSO
14901
14902 Locale::Language, Locale::Country, Locale::Script, Locale::Currency
14903
14904 =item AUTHOR
14905
14906 =item COPYRIGHT
14907
14908 =back
14909
14910 =head2 Locale::Country - ISO codes for country identification (ISO 3166)
14911
14912 =over 4
14913
14914 =item SYNOPSIS
14915
14916 =item DESCRIPTION
14917
14918 B<alpha-2>, B<alpha-3>, B<numeric>
14919
14920 =item CONVERSION ROUTINES
14921
14922 code2country( CODE, [ CODESET ] ), country2code( STRING, [ CODESET ] ),
14923 country_code2code( CODE, CODESET, CODESET )
14924
14925 =item QUERY ROUTINES
14926
14927 C<all_country_codes( [ CODESET ] )>, C<all_country_names( [ CODESET ] )>
14928
14929 =item SEMI-PRIVATE ROUTINES
14930
14931 =over 4
14932
14933 =item alias_code
14934
14935 =item rename_country
14936
14937 =back
14938
14939 =item EXAMPLES
14940
14941 =item DOMAIN NAMES
14942
14943 =item KNOWN BUGS AND LIMITATIONS
14944
14945 =item SEE ALSO
14946
14947 Locale::Language, Locale::Script, Locale::Currency, Locale::SubCountry, ISO
14948 3166-1, http://www.iso.org/iso/en/prods-services/iso3166ma/index.html,
14949 http://www.egt.ie/standards/iso3166/iso3166-1-en.html,
14950 http://www.cia.gov/cia/publications/factbook/docs/app-f.html
14951
14952 =item AUTHOR
14953
14954 =item COPYRIGHT
14955
14956 =back
14957
14958 =head2 Locale::Currency - ISO three letter codes for currency
14959 identification (ISO 4217)
14960
14961 =over 4
14962
14963 =item SYNOPSIS
14964
14965 =item DESCRIPTION
14966
14967 XTS, XXX
14968
14969 =item CONVERSION ROUTINES
14970
14971 code2currency(), currency2code()
14972
14973 =item QUERY ROUTINES
14974
14975 C<all_currency_codes()>, C<all_currency_names()>
14976
14977 =item EXAMPLES
14978
14979 =item KNOWN BUGS AND LIMITATIONS
14980
14981 =item SEE ALSO
14982
14983 Locale::Country, Locale::Script, ISO 4217:1995,
14984 http://www.bsi-global.com/iso4217currency
14985
14986 =item AUTHOR
14987
14988 =item COPYRIGHT
14989
14990 =back
14991
14992 =head2 Locale::Language - ISO two letter codes for language identification
14993 (ISO 639)
14994
14995 =over 4
14996
14997 =item SYNOPSIS
14998
14999 =item DESCRIPTION
15000
15001 =item CONVERSION ROUTINES
15002
15003 code2language(), language2code()
15004
15005 =item QUERY ROUTINES
15006
15007 C<all_language_codes()>, C<all_language_names()>
15008
15009 =item EXAMPLES
15010
15011 =item KNOWN BUGS AND LIMITATIONS
15012
15013 =item SEE ALSO
15014
15015 Locale::Country, Locale::Script, Locale::Currency, ISO 639:1988 (E/F),
15016 http://lcweb.loc.gov/standards/iso639-2/langhome.html
15017
15018 =item AUTHOR
15019
15020 =item COPYRIGHT
15021
15022 =back
15023
15024 =head2 Locale::Maketext -- framework for localization
15025
15026 =over 4
15027
15028 =item SYNOPSIS
15029
15030 =item DESCRIPTION
15031
15032 =item QUICK OVERVIEW
15033
15034 =item METHODS
15035
15036 =over 4
15037
15038 =item Construction Methods
15039
15040 =item The "maketext" Method
15041
15042 $lh->fail_with I<or> $lh->fail_with(I<PARAM>), $lh->failure_handler_auto
15043
15044 =item Utility Methods
15045
15046 $language->quant($number, $singular), $language->quant($number, $singular,
15047 $plural), $language->quant($number, $singular, $plural, $negative),
15048 $language->numf($number), $language->sprintf($format, @items),
15049 $language->language_tag(), $language->encoding()
15050
15051 =item Language Handle Attributes and Internals
15052
15053 =back
15054
15055 =item LANGUAGE CLASS HIERARCHIES
15056
15057 =item ENTRIES IN EACH LEXICON
15058
15059 =item BRACKET NOTATION
15060
15061 =item AUTO LEXICONS
15062
15063 =item CONTROLLING LOOKUP FAILURE
15064
15065 =item HOW TO USE MAKETEXT
15066
15067 =item SEE ALSO
15068
15069 =item COPYRIGHT AND DISCLAIMER
15070
15071 =item AUTHOR
15072
15073 =back
15074
15075 =head2 Locale::Maketext::TPJ13 -- article about software localization
15076
15077 =over 4
15078
15079 =item SYNOPSIS
15080
15081 =item DESCRIPTION
15082
15083 =item Localization and Perl: gettext breaks, Maketext fixes
15084
15085 =over 4
15086
15087 =item A Localization Horror Story: It Could Happen To You
15088
15089 =item The Linguistic View
15090
15091 =item Breaking gettext
15092
15093 =item Replacing gettext
15094
15095 =item Buzzwords: Abstraction and Encapsulation
15096
15097 =item Buzzword: Isomorphism
15098
15099 =item Buzzword: Inheritance
15100
15101 =item Buzzword: Concision
15102
15103 =item The Devil in the Details
15104
15105 =item The Proof in the Pudding: Localizing Web Sites
15106
15107 =item References
15108
15109 =back
15110
15111 =back
15112
15113 =head2 Locale::Script - ISO codes for script identification (ISO 15924)
15114
15115 =over 4
15116
15117 =item SYNOPSIS
15118
15119 =item DESCRIPTION
15120
15121 B<alpha-2>, B<alpha-3>, B<numeric>
15122
15123 =over 4
15124
15125 =item SPECIAL CODES
15126
15127 =back
15128
15129 =item CONVERSION ROUTINES
15130
15131 code2script( CODE, [ CODESET ] ), script2code( STRING, [ CODESET ] ),
15132 script_code2code( CODE, CODESET, CODESET )
15133
15134 =item QUERY ROUTINES
15135
15136 C<all_script_codes ( [ CODESET ] )>, C<all_script_names ( [ CODESET ] )>
15137
15138 =item EXAMPLES
15139
15140 =item KNOWN BUGS AND LIMITATIONS
15141
15142 =item SEE ALSO
15143
15144 Locale::Language, Locale::Currency, Locale::Country, ISO 15924,
15145 http://www.evertype.com/standards/iso15924/
15146
15147 =item AUTHOR
15148
15149 =item COPYRIGHT
15150
15151 =back
15152
15153 =head2 MIME::Base64 - Encoding and decoding of base64 strings
15154
15155 =over 4
15156
15157 =item SYNOPSIS
15158
15159 =item DESCRIPTION
15160
15161 encode_base64($str, [$eol]), decode_base64($str)
15162
15163 =item DIAGNOSTICS
15164
15165 Premature end of base64 data, Premature padding of base64 data
15166
15167 =item EXAMPLES
15168
15169 =item COPYRIGHT
15170
15171 =back
15172
15173 =head2 MIME::Base64::QuotedPrint, MIME::QuotedPrint - Encoding and decoding
15174 of quoted-printable strings
15175
15176 =over 4
15177
15178 =item SYNOPSIS
15179
15180 =item DESCRIPTION
15181
15182 encode_qp($str), decode_qp($str);
15183
15184 =item COPYRIGHT
15185
15186 =back
15187
15188 =head2 MIME::QuotedPrint - Encoding and decoding of quoted-printable
15189 strings
15190
15191 =over 4
15192
15193 =item SYNOPSIS
15194
15195 =item DESCRIPTION
15196
15197 encode_qp($str), decode_qp($str);
15198
15199 =item COPYRIGHT
15200
15201 =back
15202
15203 =head2 Math::BigFloat - Arbitrary size floating point math package
15204
15205 =over 4
15206
15207 =item SYNOPSIS
15208
15209 =item DESCRIPTION
15210
15211 =over 4
15212
15213 =item Canonical notation
15214
15215 =item Output
15216
15217 =item C<mantissa()>, C<exponent()> and C<parts()>
15218
15219 =item Accuracy vs. Precision
15220
15221 =item Rounding
15222
15223 ffround ( +$scale ), ffround ( -$scale ), ffround ( 0 ), fround  ( +$scale
15224 ), fround  ( -$scale ) and fround ( 0 )
15225
15226 =back
15227
15228 =item EXAMPLES
15229
15230   # not ready yet
15231
15232 =item Autocreating constants
15233
15234 =over 4
15235
15236 =item Math library
15237
15238 =item Using Math::BigInt::Lite
15239
15240 =back
15241
15242 =item BUGS
15243
15244 =item CAVEAT
15245
15246 stringify, bstr(), bdiv, Modifying and =, bpow
15247
15248 =item LICENSE
15249
15250 =item AUTHORS
15251
15252 =back
15253
15254 =head2 Math::BigInt - Arbitrary size integer math package
15255
15256 =over 4
15257
15258 =item SYNOPSIS
15259
15260 =item DESCRIPTION
15261
15262 Canonical notation, Input, Output
15263
15264 =item METHODS
15265
15266 =over 4
15267
15268 =item config
15269
15270 =item accuracy
15271
15272 =item brsft
15273
15274 =item new
15275
15276 =item bnan
15277
15278 =item bzero
15279
15280 =item binf
15281
15282 =item bone
15283
15284 =item is_one()/is_zero()/is_nan()/is_inf()
15285
15286 =item is_positive()/is_negative()
15287
15288         $x->is_positive();              # true if >= 0
15289         $x->is_negative();              # true if <  0
15290
15291 =item is_odd()/is_even()/is_int()
15292
15293 =item bcmp
15294
15295 =item bacmp
15296
15297 =item sign
15298
15299 =item bcmp
15300
15301 =item bneg
15302
15303 =item babs
15304
15305 =item bnorm
15306
15307 =item bnot
15308
15309 =item binc
15310
15311 =item bdec
15312
15313 =item badd
15314
15315 =item bsub
15316
15317 =item bmul
15318
15319 =item bdiv
15320
15321 =item bmod
15322
15323 =item bmodinv
15324
15325 =item bmodpow
15326
15327 =item bpow
15328
15329 =item blsft
15330
15331 =item brsft
15332
15333 =item band
15334
15335 =item bior
15336
15337 =item bxor
15338
15339 =item bnot
15340
15341 =item bsqrt
15342
15343 =item bfac
15344
15345 =item round
15346
15347 =item bround
15348
15349 =item bfround
15350
15351 =item bfloor
15352
15353 =item bceil
15354
15355 =item bgcd
15356
15357 =item blcm
15358
15359 =item exponent
15360
15361 =item mantissa
15362
15363 =item parts
15364
15365 =item copy
15366
15367 =item as_number
15368
15369 =item bsstr
15370
15371 =item as_hex
15372
15373 =item as_bin
15374
15375 =back
15376
15377 =item ACCURACY and PRECISION
15378
15379 =over 4
15380
15381 =item Precision P
15382
15383 =item Accuracy A
15384
15385 =item Fallback F
15386
15387 =item Rounding mode R
15388
15389 'trunc', 'even', 'odd', '+inf', '-inf', 'zero', Precision, Accuracy
15390 (significant digits), Setting/Accessing, Creating numbers, Usage,
15391 Precedence, Overriding globals, Local settings, Rounding, Default values,
15392 Remarks
15393
15394 =back
15395
15396 =item INTERNALS
15397
15398 =over 4
15399
15400 =item MATH LIBRARY
15401
15402 =item SIGN
15403
15404 =item mantissa(), exponent() and parts()
15405
15406 =back
15407
15408 =item EXAMPLES
15409
15410   use Math::BigInt;
15411
15412 =item Autocreating constants
15413
15414 =item PERFORMANCE
15415
15416 =over 4
15417
15418 =item Alternative math libraries
15419
15420 =item SUBCLASSING
15421
15422 =back
15423
15424 =item Subclassing Math::BigInt
15425
15426 =item UPGRADING
15427
15428 =over 4
15429
15430 =item Auto-upgrade
15431
15432 bsqrt(), div(), blog()
15433
15434 =back
15435
15436 =item BUGS
15437
15438 Out of Memory!, Fails to load Calc on Perl prior 5.6.0
15439
15440 =item CAVEATS
15441
15442 stringify, bstr(), bsstr() and 'cmp', int(), length, bdiv, infinity
15443 handling, Modifying and =, bpow, Overloading -$x, Mixing different object
15444 types, bsqrt(), brsft()
15445
15446 =item LICENSE
15447
15448 =item SEE ALSO
15449
15450 =item AUTHORS
15451
15452 =back
15453
15454 =head2 Math::BigInt::Calc - Pure Perl module to support Math::BigInt
15455
15456 =over 4
15457
15458 =item SYNOPSIS
15459
15460 =item DESCRIPTION
15461
15462 =item EXPORT
15463
15464 =item WRAP YOUR OWN
15465
15466 =item LICENSE
15467
15468 This program is free software; you may redistribute it and/or modify it
15469 under
15470 the same terms as Perl itself.
15471
15472 =item AUTHORS
15473
15474 =item SEE ALSO
15475
15476 =back
15477
15478 =head2 Math::BigRat - arbitrarily big rationals
15479
15480 =over 4
15481
15482 =item SYNOPSIS
15483
15484 =item DESCRIPTION
15485
15486 =over 4
15487
15488 =item MATH LIBRARY
15489
15490 =back
15491
15492 =item METHODS
15493
15494 =over 4
15495
15496 =item new()
15497
15498 =item numerator()
15499
15500 =item denominator()
15501
15502         $d = $x->denominator();
15503
15504 =item parts()
15505
15506 =item as_number()
15507
15508 =item bfac()
15509
15510 =item blog()
15511
15512 =item bround()/round()/bfround()
15513
15514 =back
15515
15516 =item BUGS
15517
15518 =item LICENSE
15519
15520 =item SEE ALSO
15521
15522 =item AUTHORS
15523
15524 =back
15525
15526 =head2 Math::Complex - complex numbers and associated mathematical
15527 functions
15528
15529 =over 4
15530
15531 =item SYNOPSIS
15532
15533 =item DESCRIPTION
15534
15535 =item OPERATIONS
15536
15537 =item CREATION
15538
15539 =item STRINGIFICATION
15540
15541 =over 4
15542
15543 =item CHANGED IN PERL 5.6
15544
15545 =back
15546
15547 =item USAGE
15548
15549 =item ERRORS DUE TO DIVISION BY ZERO OR LOGARITHM OF ZERO
15550
15551 =item ERRORS DUE TO INDIGESTIBLE ARGUMENTS
15552
15553 =item BUGS
15554
15555 =item AUTHORS
15556
15557 =back
15558
15559 =head2 Math::Trig - trigonometric functions
15560
15561 =over 4
15562
15563 =item SYNOPSIS
15564
15565 =item DESCRIPTION
15566
15567 =item TRIGONOMETRIC FUNCTIONS
15568
15569 B<tan>
15570
15571 =over 4
15572
15573 =item ERRORS DUE TO DIVISION BY ZERO
15574
15575 =item SIMPLE (REAL) ARGUMENTS, COMPLEX RESULTS
15576
15577 =back
15578
15579 =item PLANE ANGLE CONVERSIONS
15580
15581 =item RADIAL COORDINATE CONVERSIONS
15582
15583 =over 4
15584
15585 =item COORDINATE SYSTEMS
15586
15587 =item 3-D ANGLE CONVERSIONS
15588
15589 cartesian_to_cylindrical, cartesian_to_spherical, cylindrical_to_cartesian,
15590 cylindrical_to_spherical, spherical_to_cartesian, spherical_to_cylindrical
15591
15592 =back
15593
15594 =item GREAT CIRCLE DISTANCES AND DIRECTIONS
15595
15596 =item EXAMPLES
15597
15598 =over 4
15599
15600 =item CAVEAT FOR GREAT CIRCLE FORMULAS
15601
15602 =back
15603
15604 =item BUGS
15605
15606 =item AUTHORS
15607
15608 =back
15609
15610 =head2 Memoize - Make functions faster by trading space for time
15611
15612 =over 4
15613
15614 =item SYNOPSIS
15615
15616 =item DESCRIPTION
15617
15618 =item DETAILS
15619
15620 =item OPTIONS
15621
15622 =over 4
15623
15624 =item INSTALL
15625
15626 =item NORMALIZER
15627
15628 =item C<SCALAR_CACHE>, C<LIST_CACHE>
15629
15630 C<MEMORY>, C<HASH>, C<TIE>, C<FAULT>, C<MERGE>
15631
15632 =back
15633
15634 =item OTHER FACILITIES
15635
15636 =over 4
15637
15638 =item C<unmemoize>
15639
15640 =item C<flush_cache>
15641
15642 =back
15643
15644 =item CAVEATS
15645
15646 =item PERSISTENT CACHE SUPPORT
15647
15648 =item EXPIRATION SUPPORT
15649
15650 =item BUGS
15651
15652 =item MAILING LIST
15653
15654 =item AUTHOR
15655
15656 =item COPYRIGHT AND LICENSE
15657
15658 =item THANK YOU
15659
15660 =back
15661
15662 =head2 Memoize::AnyDBM_File - glue to provide EXISTS for AnyDBM_File for
15663 Storable use
15664
15665 =over 4
15666
15667 =item DESCRIPTION
15668
15669 =back
15670
15671 =head2 Memoize::Expire - Plug-in module for automatic expiration of
15672 memoized values
15673
15674 =over 4
15675
15676 =item SYNOPSIS
15677
15678 =item DESCRIPTION
15679
15680 =item INTERFACE
15681
15682  TIEHASH,  EXISTS,  STORE
15683
15684 =item ALTERNATIVES
15685
15686 =item CAVEATS
15687
15688 =item AUTHOR
15689
15690 =item SEE ALSO
15691
15692 =back
15693
15694 =head2 Memoize::ExpireFile - test for Memoize expiration semantics
15695
15696 =over 4
15697
15698 =item DESCRIPTION
15699
15700 =back
15701
15702 =head2 Memoize::ExpireTest - test for Memoize expiration semantics
15703
15704 =over 4
15705
15706 =item DESCRIPTION
15707
15708 =back
15709
15710 =head2 Memoize::NDBM_File - glue to provide EXISTS for NDBM_File for
15711 Storable use
15712
15713 =over 4
15714
15715 =item DESCRIPTION
15716
15717 =back
15718
15719 =head2 Memoize::SDBM_File - glue to provide EXISTS for SDBM_File for
15720 Storable use
15721
15722 =over 4
15723
15724 =item DESCRIPTION
15725
15726 =back
15727
15728 =head2 Memoize::Storable - store Memoized data in Storable database
15729
15730 =over 4
15731
15732 =item DESCRIPTION
15733
15734 =back
15735
15736 =head2 NDBM_File - Tied access to ndbm files
15737
15738 =over 4
15739
15740 =item SYNOPSIS
15741
15742 =item DESCRIPTION
15743
15744 C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR>
15745
15746 =item DIAGNOSTICS
15747
15748 =over 4
15749
15750 =item C<ndbm store returned -1, errno 22, key "..." at ...>
15751
15752 =back
15753
15754 =item BUGS AND WARNINGS
15755
15756 =back
15757
15758 =head2 NEXT - Provide a pseudo-class NEXT that allows method redispatch
15759
15760 =over 4
15761
15762 =item SYNOPSIS
15763
15764 =item DESCRIPTION
15765
15766 =over 4
15767
15768 =item Enforcing redispatch
15769
15770 =item Avoiding repetitions
15771
15772 =back
15773
15774 =item AUTHOR
15775
15776 =item BUGS AND IRRITATIONS
15777
15778 =item COPYRIGHT
15779
15780 =back
15781
15782 =head2 Net::Cmd - Network Command class (as used by FTP, SMTP etc)
15783
15784 =over 4
15785
15786 =item SYNOPSIS
15787
15788 =item DESCRIPTION
15789
15790 =item USER METHODS
15791
15792 debug ( VALUE ), message (), code (), ok (), status (), datasend ( DATA ),
15793 dataend ()
15794
15795 =item CLASS METHODS
15796
15797 debug_print ( DIR, TEXT ), debug_text ( TEXT ), command ( CMD [, ARGS, ...
15798 ]), unsupported (), response (), parse_response ( TEXT ), getline (),
15799 ungetline ( TEXT ), read_until_dot (), tied_fh ()
15800
15801 =item EXPORTS
15802
15803 =item AUTHOR
15804
15805 =item COPYRIGHT
15806
15807 =back
15808
15809 =head2 Net::Config - Local configuration data for libnet
15810
15811 =over 4
15812
15813 =item SYNOPSYS
15814
15815 =item DESCRIPTION
15816
15817 =item METHODS
15818
15819 requires_firewall HOST
15820
15821 =item NetConfig VALUES
15822
15823 nntp_hosts, snpp_hosts, pop3_hosts, smtp_hosts, ph_hosts, daytime_hosts,
15824 time_hosts, inet_domain, ftp_firewall, ftp_firewall_type, ftp_ext_passive,
15825 ftp_int_pasive, local_netmask, test_hosts, test_exists
15826
15827 =back
15828
15829 =head2 Net::Domain - Attempt to evaluate the current host's internet name
15830 and domain
15831
15832 =over 4
15833
15834 =item SYNOPSIS
15835
15836 =item DESCRIPTION
15837
15838 hostfqdn (), hostname (), hostdomain ()
15839
15840 =item AUTHOR
15841
15842 =item COPYRIGHT
15843
15844 =back
15845
15846 =head2 Net::FTP - FTP Client class
15847
15848 =over 4
15849
15850 =item SYNOPSIS
15851
15852 =item DESCRIPTION
15853
15854 =item OVERVIEW
15855
15856 =item CONSTRUCTOR
15857
15858 new (HOST [,OPTIONS])
15859
15860 =item METHODS
15861
15862 login ([LOGIN [,PASSWORD [, ACCOUNT] ] ]), authorize ( [AUTH [, RESP]]),
15863 site (ARGS), type (TYPE [, ARGS]), ascii ([ARGS]) binary([ARGS])
15864 ebcdic([ARGS]) byte([ARGS]), rename ( OLDNAME, NEWNAME ), delete ( FILENAME
15865 ), cwd ( [ DIR ] ), cdup (), pwd (), restart ( WHERE ), rmdir ( DIR ),
15866 mkdir ( DIR [, RECURSE ]), ls ( [ DIR ] ), dir ( [ DIR ] ), get (
15867 REMOTE_FILE [, LOCAL_FILE [, WHERE]] ), put ( LOCAL_FILE [, REMOTE_FILE ]
15868 ), put_unique ( LOCAL_FILE [, REMOTE_FILE ] ), append ( LOCAL_FILE [,
15869 REMOTE_FILE ] ), unique_name (), mdtm ( FILE ), size ( FILE ), supported (
15870 CMD ), hash ( [FILEHANDLE_GLOB_REF],[ BYTES_PER_HASH_MARK] ), nlst ( [ DIR
15871 ] ), list ( [ DIR ] ), retr ( FILE ), stor ( FILE ), stou ( FILE ), appe (
15872 FILE ), port ( [ PORT ] ), pasv (), pasv_xfer ( SRC_FILE, DEST_SERVER [,
15873 DEST_FILE ] ), pasv_xfer_unique ( SRC_FILE, DEST_SERVER [, DEST_FILE ] ),
15874 pasv_wait ( NON_PASV_SERVER ), abort (), quit ()
15875
15876 =over 4
15877
15878 =item Methods for the adventurous
15879
15880 quot (CMD [,ARGS])
15881
15882 =back
15883
15884 =item THE dataconn CLASS
15885
15886 read ( BUFFER, SIZE [, TIMEOUT ] ), write ( BUFFER, SIZE [, TIMEOUT ] ),
15887 bytes_read (), abort (), close ()
15888
15889 =item UNIMPLEMENTED
15890
15891 B<ALLO>, B<SMNT>, B<HELP>, B<MODE>, B<SYST>, B<STAT>, B<STRU>, B<REIN>
15892
15893 =item REPORTING BUGS
15894
15895 =item AUTHOR
15896
15897 =item SEE ALSO
15898
15899 =item USE EXAMPLES
15900
15901 http://www.csh.rit.edu/~adam/Progs/autoftp-2.0.tar.gz
15902
15903 =item CREDITS
15904
15905 =item COPYRIGHT
15906
15907 =back
15908
15909 =head2 Net::NNTP - NNTP Client class
15910
15911 =over 4
15912
15913 =item SYNOPSIS
15914
15915 =item DESCRIPTION
15916
15917 =item CONSTRUCTOR
15918
15919 new ( [ HOST ] [, OPTIONS ])
15920
15921 =item METHODS
15922
15923 article ( [ MSGID|MSGNUM ], [FH] ), body ( [ MSGID|MSGNUM ], [FH] ), head (
15924 [ MSGID|MSGNUM ], [FH] ), articlefh ( [ MSGID|MSGNUM ] ), bodyfh ( [
15925 MSGID|MSGNUM ] ), headfh ( [ MSGID|MSGNUM ] ), nntpstat ( [ MSGID|MSGNUM ]
15926 ), group ( [ GROUP ] ), ihave ( MSGID [, MESSAGE ]), last (), date (),
15927 postok (), authinfo ( USER, PASS ), list (), newgroups ( SINCE [,
15928 DISTRIBUTIONS ]), newnews ( SINCE [, GROUPS [, DISTRIBUTIONS ]]), next (),
15929 post ( [ MESSAGE ] ), postfh (), slave (), quit ()
15930
15931 =over 4
15932
15933 =item Extension methods
15934
15935 newsgroups ( [ PATTERN ] ), distributions (), subscriptions (),
15936 overview_fmt (), active_times (), active ( [ PATTERN ] ), xgtitle ( PATTERN
15937 ), xhdr ( HEADER, MESSAGE-SPEC ), xover ( MESSAGE-SPEC ), xpath (
15938 MESSAGE-ID ), xpat ( HEADER, PATTERN, MESSAGE-SPEC), xrover, listgroup ( [
15939 GROUP ] ), reader
15940
15941 =back
15942
15943 =item UNSUPPORTED
15944
15945 =item DEFINITIONS
15946
15947 MESSAGE-SPEC, PATTERN, Examples, C<[^]-]>, C<*bdc>, C<[0-9a-zA-Z]>, C<a??d>
15948
15949 =item SEE ALSO
15950
15951 =item AUTHOR
15952
15953 =item COPYRIGHT
15954
15955 =back
15956
15957 =head2 Net::POP3 - Post Office Protocol 3 Client class (RFC1939)
15958
15959 =over 4
15960
15961 =item SYNOPSIS
15962
15963 =item DESCRIPTION
15964
15965 =item EXAMPLES
15966
15967 =item CONSTRUCTOR
15968
15969 new ( [ HOST, ] [ OPTIONS ] )
15970
15971 =item METHODS
15972
15973 user ( USER ), pass ( PASS ), login ( [ USER [, PASS ]] ), apop ( [ USER [,
15974 PASS ]] ), top ( MSGNUM [, NUMLINES ] ), list ( [ MSGNUM ] ), get ( MSGNUM
15975 [, FH ] ), getfh ( MSGNUM ), last (), popstat (), ping ( USER ), uidl ( [
15976 MSGNUM ] ), delete ( MSGNUM ), reset (), quit ()
15977
15978 =item NOTES
15979
15980 =item SEE ALSO
15981
15982 =item AUTHOR
15983
15984 =item COPYRIGHT
15985
15986 =back
15987
15988 =head2 Net::Ping - check a remote host for reachability
15989
15990 =over 4
15991
15992 =item SYNOPSIS
15993
15994 =item DESCRIPTION
15995
15996 =over 4
15997
15998 =item Functions
15999
16000 Net::Ping->new([$proto [, $def_timeout [, $bytes]]]);, $p->source_verify( {
16001 0 | 1 } );, $p->hires( { 0 | 1 } );, $p->bind($local_addr);, $p->ping($host
16002 [, $timeout]);, $p->open($host);, $p->close();, pingecho($host [,
16003 $timeout]);
16004
16005 =back
16006
16007 =item WARNING
16008
16009 =item NOTES
16010
16011 =item AUTHORS
16012
16013 =item COPYRIGHT
16014
16015 =back
16016
16017 =head2 Net::SMTP - Simple Mail Transfer Protocol Client
16018
16019 =over 4
16020
16021 =item SYNOPSIS
16022
16023 =item DESCRIPTION
16024
16025 =item EXAMPLES
16026
16027 =item CONSTRUCTOR
16028
16029 new Net::SMTP [ HOST, ] [ OPTIONS ]
16030
16031 =item METHODS
16032
16033 banner (), domain (), hello ( DOMAIN ), etrn ( DOMAIN ), auth ( USERNAME,
16034 PASSWORD ), mail ( ADDRESS [, OPTIONS] ), send ( ADDRESS ), send_or_mail (
16035 ADDRESS ), send_and_mail ( ADDRESS ), reset (), recipient ( ADDRESS [,
16036 ADDRESS [ ...]] [, OPTIONS ] ), to ( ADDRESS [, ADDRESS [...]] ), cc (
16037 ADDRESS [, ADDRESS [...]] ), bcc ( ADDRESS [, ADDRESS [...]] ), data ( [
16038 DATA ] ), expand ( ADDRESS ), verify ( ADDRESS ), help ( [ $subject ] ),
16039 quit ()
16040
16041 =item ADDRESSES
16042
16043 =item SEE ALSO
16044
16045 =item AUTHOR
16046
16047 =item COPYRIGHT
16048
16049 =back
16050
16051 =head2 Net::Time - time and daytime network client interface
16052
16053 =over 4
16054
16055 =item SYNOPSIS
16056
16057 =item DESCRIPTION
16058
16059 inet_time ( [HOST [, PROTOCOL [, TIMEOUT]]]), inet_daytime ( [HOST [,
16060 PROTOCOL [, TIMEOUT]]])
16061
16062 =item AUTHOR
16063
16064 =item COPYRIGHT
16065
16066 =back
16067
16068 =head2 Net::hostent - by-name interface to Perl's built-in gethost*()
16069 functions
16070
16071 =over 4
16072
16073 =item SYNOPSIS
16074
16075 =item DESCRIPTION
16076
16077 =item EXAMPLES
16078
16079 =item NOTE
16080
16081 =item AUTHOR
16082
16083 =back
16084
16085 =head2 Net::libnetFAQ, libnetFAQ - libnet Frequently Asked Questions
16086
16087 =over 4
16088
16089 =item DESCRIPTION
16090
16091 =over 4
16092
16093 =item Where to get this document
16094
16095 =item How to contribute to this document
16096
16097 =back
16098
16099 =item Author and Copyright Information
16100
16101 =over 4
16102
16103 =item Disclaimer
16104
16105 =back
16106
16107 =item Obtaining and installing libnet
16108
16109 =over 4
16110
16111 =item What is libnet ?
16112
16113 =item Which version of perl do I need ?
16114
16115 =item What other modules do I need ?
16116
16117 =item What machines support libnet ?
16118
16119 =item Where can I get the latest libnet release
16120
16121 =back
16122
16123 =item Using Net::FTP
16124
16125 =over 4
16126
16127 =item How do I download files from an FTP server ?
16128
16129 =item How do I transfer files in binary mode ?
16130
16131 =item How can I get the size of a file on a remote FTP server ?
16132
16133 =item How can I get the modification time of a file on a remote FTP server
16134 ?
16135
16136 =item How can I change the permissions of a file on a remote server ?
16137
16138 =item Can I do a reget operation like the ftp command ?
16139
16140 =item How do I get a directory listing from an FTP server ?
16141
16142 =item Changing directory to "" does not fail ?
16143
16144 =item I am behind a SOCKS firewall, but the Firewall option does not work ?
16145
16146 =item I am behind an FTP proxy firewall, but cannot access machines outside
16147 ?
16148
16149 =item My ftp proxy firewall does not listen on port 21
16150
16151 =item Is it possible to change the file permissions of a file on an FTP
16152 server ?
16153
16154 =item I have seen scripts call a method message, but cannot find it
16155 documented ?
16156
16157 =item Why does Net::FTP not implement mput and mget methods
16158
16159 =back
16160
16161 =item Using Net::SMTP
16162
16163 =over 4
16164
16165 =item Why can't the part of an Email address after the @ be used as the
16166 hostname ?
16167
16168 =item Why does Net::SMTP not do DNS MX lookups ?
16169
16170 =item The verify method always returns true ?
16171
16172 =back
16173
16174 =item Debugging scripts
16175
16176 =over 4
16177
16178 =item How can I debug my scripts that use Net::* modules ?
16179
16180 =back
16181
16182 =item AUTHOR AND COPYRIGHT
16183
16184 =back
16185
16186 =head2 Net::netent - by-name interface to Perl's built-in getnet*()
16187 functions
16188
16189 =over 4
16190
16191 =item SYNOPSIS
16192
16193 =item DESCRIPTION
16194
16195 =item EXAMPLES
16196
16197 =item NOTE
16198
16199 =item AUTHOR
16200
16201 =back
16202
16203 =head2 Net::protoent - by-name interface to Perl's built-in getproto*()
16204 functions
16205
16206 =over 4
16207
16208 =item SYNOPSIS
16209
16210 =item DESCRIPTION
16211
16212 =item NOTE
16213
16214 =item AUTHOR
16215
16216 =back
16217
16218 =head2 Net::servent - by-name interface to Perl's built-in getserv*()
16219 functions
16220
16221 =over 4
16222
16223 =item SYNOPSIS
16224
16225 =item DESCRIPTION
16226
16227 =item EXAMPLES
16228
16229 =item NOTE
16230
16231 =item AUTHOR
16232
16233 =back
16234
16235 =head2 Netrc, Net::Netrc - OO interface to users netrc file
16236
16237 =over 4
16238
16239 =item SYNOPSIS
16240
16241 =item DESCRIPTION
16242
16243 =item THE .netrc FILE
16244
16245 machine name, default, login name, password string, account string, macdef
16246 name
16247
16248 =item CONSTRUCTOR
16249
16250 lookup ( MACHINE [, LOGIN ])
16251
16252 =item METHODS
16253
16254 login (), password (), account (), lpa ()
16255
16256 =item AUTHOR
16257
16258 =item SEE ALSO
16259
16260 =item COPYRIGHT
16261
16262 =back
16263
16264 =head2 O - Generic interface to Perl Compiler backends
16265
16266 =over 4
16267
16268 =item SYNOPSIS
16269
16270 =item DESCRIPTION
16271
16272 =item CONVENTIONS
16273
16274 =item IMPLEMENTATION
16275
16276 =item BUGS
16277
16278 =item AUTHOR
16279
16280 =back
16281
16282 =head2 ODBM_File - Tied access to odbm files
16283
16284 =over 4
16285
16286 =item SYNOPSIS
16287
16288 =item DESCRIPTION
16289
16290 C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR>
16291
16292 =item DIAGNOSTICS
16293
16294 =over 4
16295
16296 =item C<odbm store returned -1, errno 22, key "..." at ...>
16297
16298 =back
16299
16300 =item BUGS AND WARNINGS
16301
16302 =back
16303
16304 =head2 Opcode - Disable named opcodes when compiling perl code
16305
16306 =over 4
16307
16308 =item SYNOPSIS
16309
16310 =item DESCRIPTION
16311
16312 =item NOTE
16313
16314 =item WARNING
16315
16316 =item Operator Names and Operator Lists
16317
16318 an operator name (opname), an operator tag name (optag), a negated opname
16319 or optag, an operator set (opset)
16320
16321 =item Opcode Functions
16322
16323 opcodes, opset (OP, ...), opset_to_ops (OPSET), opset_to_hex (OPSET),
16324 full_opset, empty_opset, invert_opset (OPSET), verify_opset (OPSET, ...),
16325 define_optag (OPTAG, OPSET), opmask_add (OPSET), opmask, opdesc (OP, ...),
16326 opdump (PAT)
16327
16328 =item Manipulating Opsets
16329
16330 =item TO DO (maybe)
16331
16332 =back
16333
16334 =over 4
16335
16336 =item Predefined Opcode Tags
16337
16338 :base_core, :base_mem, :base_loop, :base_io, :base_orig, :base_math,
16339 :base_thread, :default, :filesys_read, :sys_db, :browse, :filesys_open,
16340 :filesys_write, :subprocess, :ownprocess, :others, :still_to_be_decided,
16341 :dangerous
16342
16343 =item SEE ALSO
16344
16345 =item AUTHORS
16346
16347 =back
16348
16349 =head2 Opcode::Safe, Safe - Compile and execute code in restricted
16350 compartments
16351
16352 =over 4
16353
16354 =item SYNOPSIS
16355
16356 =item DESCRIPTION
16357
16358 a new namespace, an operator mask
16359
16360 =item WARNING
16361
16362 =over 4
16363
16364 =item RECENT CHANGES
16365
16366 =item Methods in class Safe
16367
16368 permit (OP, ...), permit_only (OP, ...), deny (OP, ...), deny_only (OP,
16369 ...), trap (OP, ...), untrap (OP, ...), share (NAME, ...), share_from
16370 (PACKAGE, ARRAYREF), varglob (VARNAME), reval (STRING), rdo (FILENAME),
16371 root (NAMESPACE), mask (MASK)
16372
16373 =item Some Safety Issues
16374
16375 Memory, CPU, Snooping, Signals, State Changes
16376
16377 =item AUTHOR
16378
16379 =back
16380
16381 =back
16382
16383 =head2 Opcode::ops, ops - Perl pragma to restrict unsafe operations when
16384 compiling
16385
16386 =over 4
16387
16388 =item SYNOPSIS
16389
16390 =item DESCRIPTION
16391
16392 =item SEE ALSO
16393
16394 =back
16395
16396 =head2 POSIX - Perl interface to IEEE Std 1003.1
16397
16398 =over 4
16399
16400 =item SYNOPSIS
16401
16402 =item DESCRIPTION
16403
16404 =item NOTE
16405
16406 =item CAVEATS
16407
16408 =item FUNCTIONS
16409
16410 _exit, abort, abs, access, acos, alarm, asctime, asin, assert, atan, atan2,
16411 atexit, atof, atoi, atol, bsearch, calloc, ceil, chdir, chmod, chown,
16412 clearerr, clock, close, closedir, cos, cosh, creat, ctermid, ctime,
16413 cuserid, difftime, div, dup, dup2, errno, execl, execle, execlp, execv,
16414 execve, execvp, exit, exp, fabs, fclose, fcntl, fdopen, feof, ferror,
16415 fflush, fgetc, fgetpos, fgets, fileno, floor, fmod, fopen, fork, fpathconf,
16416 fprintf, fputc, fputs, fread, free, freopen, frexp, fscanf, fseek, fsetpos,
16417 fstat, ftell, fwrite, getc, getchar, getcwd, getegid, getenv, geteuid,
16418 getgid, getgrgid, getgrnam, getgroups, getlogin, getpgrp, getpid, getppid,
16419 getpwnam, getpwuid, gets, getuid, gmtime, isalnum, isalpha, isatty,
16420 iscntrl, isdigit, isgraph, islower, isprint, ispunct, isspace, isupper,
16421 isxdigit, kill, labs, ldexp, ldiv, link, localeconv, localtime, log, log10,
16422 longjmp, lseek, malloc, mblen, mbstowcs, mbtowc, memchr, memcmp, memcpy,
16423 memmove, memset, mkdir, mkfifo, mktime, modf, nice, offsetof, open,
16424 opendir, pathconf, pause, perror, pipe, pow, printf, putc, putchar, puts,
16425 qsort, raise, rand, read, readdir, realloc, remove, rename, rewind,
16426 rewinddir, rmdir, scanf, setgid, setjmp, setlocale, setpgid, setsid,
16427 setuid, sigaction, siglongjmp, sigpending, sigprocmask, sigsetjmp,
16428 sigsuspend, sin, sinh, sleep, sprintf, sqrt, srand, sscanf, stat, strcat,
16429 strchr, strcmp, strcoll, strcpy, strcspn, strerror, strftime, strlen,
16430 strncat, strncmp, strncpy, strpbrk, strrchr, strspn, strstr, strtod,
16431 strtok, strtol, strtoul, strxfrm, sysconf, system, tan, tanh, tcdrain,
16432 tcflow, tcflush, tcgetpgrp, tcsendbreak, tcsetpgrp, time, times, tmpfile,
16433 tmpnam, tolower, toupper, ttyname, tzname, tzset, umask, uname, ungetc,
16434 unlink, utime, vfprintf, vprintf, vsprintf, wait, waitpid, wcstombs,
16435 wctomb, write
16436
16437 =item CLASSES
16438
16439 =over 4
16440
16441 =item POSIX::SigAction
16442
16443 new
16444
16445 =item POSIX::SigSet
16446
16447 new, addset, delset, emptyset, fillset, ismember
16448
16449 =item POSIX::Termios
16450
16451 new, getattr, getcc, getcflag, getiflag, getispeed, getlflag, getoflag,
16452 getospeed, setattr, setcc, setcflag, setiflag, setispeed, setlflag,
16453 setoflag, setospeed, Baud rate values, Terminal interface values, c_cc
16454 field values, c_cflag field values, c_iflag field values, c_lflag field
16455 values, c_oflag field values
16456
16457 =back
16458
16459 =item PATHNAME CONSTANTS
16460
16461 Constants
16462
16463 =item POSIX CONSTANTS
16464
16465 Constants
16466
16467 =item SYSTEM CONFIGURATION
16468
16469 Constants
16470
16471 =item ERRNO
16472
16473 Constants
16474
16475 =item FCNTL
16476
16477 Constants
16478
16479 =item FLOAT
16480
16481 Constants
16482
16483 =item LIMITS
16484
16485 Constants
16486
16487 =item LOCALE
16488
16489 Constants
16490
16491 =item MATH
16492
16493 Constants
16494
16495 =item SIGNAL
16496
16497 Constants
16498
16499 =item STAT
16500
16501 Constants, Macros
16502
16503 =item STDLIB
16504
16505 Constants
16506
16507 =item STDIO
16508
16509 Constants
16510
16511 =item TIME
16512
16513 Constants
16514
16515 =item UNISTD
16516
16517 Constants
16518
16519 =item WAIT
16520
16521 Constants, WNOHANG, WUNTRACED, Macros, WIFEXITED, WEXITSTATUS, WIFSIGNALED,
16522 WTERMSIG, WIFSTOPPED, WSTOPSIG
16523
16524 =back
16525
16526 =head2 PerlIO - On demand loader for PerlIO layers and root of PerlIO::*
16527 name space
16528
16529 =over 4
16530
16531 =item SYNOPSIS
16532
16533 =item DESCRIPTION
16534
16535 unix, stdio, perlio, crlf, utf8, bytes, raw, pop
16536
16537 =over 4
16538
16539 =item Alternatives to raw
16540
16541 =item Defaults and how to override them
16542
16543 =back
16544
16545 =item AUTHOR
16546
16547 =item SEE ALSO
16548
16549 =back
16550
16551 =head2 PerlIO::encoding - encoding layer
16552
16553 =over 4
16554
16555 =item SYNOPSIS
16556
16557 =item DESCRIPTION
16558
16559 =item SEE ALSO
16560
16561 =back
16562
16563 =head2 PerlIO::scalar - support module for in-memory IO.
16564
16565 =over 4
16566
16567 =item SYNOPSIS
16568
16569 =item DESCRIPTION
16570
16571 =back
16572
16573 =head2 PerlIO::via - Helper class for PerlIO layers implemented in perl
16574
16575 =over 4
16576
16577 =item SYNOPSIS
16578
16579 =item DESCRIPTION
16580
16581 =item EXPECTED METHODS
16582
16583 $class->PUSHED([$mode[,$fh]]), $obj->POPPED([$fh]),
16584 $obj->OPEN($path,$mode[,$fh]), $obj->BINMODE([,$fh]),
16585 $obj->FDOPEN($fd[,$fh]), $obj->SYSOPEN($path,$imode,$perm,[,$fh]),
16586 $obj->FILENO($fh), $obj->READ($buffer,$len,$fh), $obj->WRITE($buffer,$fh),
16587 $obj->FILL($fh), $obj->CLOSE($fh), $obj->SEEK($posn,$whence,$fh),
16588 $obj->TELL($fh), $obj->UNREAD($buffer,$fh), $obj->FLUSH($fh),
16589 $obj->SETLINEBUF($fh), $obj->CLEARERR($fh), $obj->ERROR($fh),
16590 $obj->EOF($fh)
16591
16592 =item EXAMPLES
16593
16594 =over 4
16595
16596 =item Example - a Hexadecimal Handle
16597
16598 =back
16599
16600 =back
16601
16602 =head2 PerlIO::via::QuotedPrint - PerlIO layer for quoted-printable strings
16603
16604 =over 4
16605
16606 =item SYNOPSIS
16607
16608 =item DESCRIPTION
16609
16610 =item SEE ALSO
16611
16612 =item COPYRIGHT
16613
16614 =back
16615
16616 =head2 Pod::Checker, podchecker() - check pod documents for syntax errors
16617
16618 =over 4
16619
16620 =item SYNOPSIS
16621
16622 =item OPTIONS/ARGUMENTS
16623
16624 =over 4
16625
16626 =item podchecker()
16627
16628 B<-warnings> =E<gt> I<val>
16629
16630 =back
16631
16632 =item DESCRIPTION
16633
16634 =item DIAGNOSTICS
16635
16636 =over 4
16637
16638 =item Errors
16639
16640 empty =headn, =over on line I<N> without closing =back, =item without
16641 previous =over, =back without previous =over, No argument for =begin, =end
16642 without =begin, Nested =begin's, =for without formatter specification,
16643 unresolved internal link I<NAME>, Unknown command "I<CMD>", Unknown
16644 interior-sequence "I<SEQ>", nested commands
16645 I<CMD>E<lt>...I<CMD>E<lt>...E<gt>...E<gt>, garbled entity I<STRING>, Entity
16646 number out of range, malformed link LE<lt>E<gt>, nonempty ZE<lt>E<gt>,
16647 empty XE<lt>E<gt>, Spurious text after =pod / =cut, Spurious character(s)
16648 after =back
16649
16650 =item Warnings
16651
16652 multiple occurrence of link target I<name>, line containing nothing but
16653 whitespace in paragraph, file does not start with =head, previous =item has
16654 no contents, preceding non-item paragraph(s), =item type mismatch (I<one>
16655 vs. I<two>), I<N> unescaped C<E<lt>E<gt>> in paragraph, Unknown entity, No
16656 items in =over, No argument for =item, empty section in previous paragraph,
16657 Verbatim paragraph in NAME section
16658
16659 =item Hyperlinks
16660
16661 ignoring leading/trailing whitespace in link, (section) in '$page'
16662 deprecated, alternative text/node '%s' contains non-escaped | or /
16663
16664 =back
16665
16666 =item RETURN VALUE
16667
16668 =item EXAMPLES
16669
16670 =item INTERFACE
16671
16672 =back
16673
16674 C<Pod::Checker-E<gt>new( %options )>
16675
16676 C<$checker-E<gt>poderror( @args )>, C<$checker-E<gt>poderror( {%opts},
16677 @args )>
16678
16679 C<$checker-E<gt>num_errors()>
16680
16681 C<$checker-E<gt>name()>
16682
16683 C<$checker-E<gt>node()>
16684
16685 C<$checker-E<gt>idx()>
16686
16687 C<$checker-E<gt>hyperlink()>
16688
16689 =over 4
16690
16691 =item AUTHOR
16692
16693 =back
16694
16695 =head2 Pod::Find - find POD documents in directory trees
16696
16697 =over 4
16698
16699 =item SYNOPSIS
16700
16701 =item DESCRIPTION
16702
16703 =back
16704
16705 =over 4
16706
16707 =item C<pod_find( { %opts } , @directories )>
16708
16709 C<-verbose =E<gt> 1>, C<-perl =E<gt> 1>, C<-script =E<gt> 1>, C<-inc =E<gt>
16710 1>
16711
16712 =back
16713
16714 =over 4
16715
16716 =item C<simplify_name( $str )>
16717
16718 =back
16719
16720 =over 4
16721
16722 =item C<pod_where( { %opts }, $pod )>
16723
16724 C<-inc =E<gt> 1>, C<-dirs =E<gt> [ $dir1, $dir2, ... ]>, C<-verbose =E<gt>
16725 1>
16726
16727 =back
16728
16729 =over 4
16730
16731 =item C<contains_pod( $file , $verbose )>
16732
16733 =back
16734
16735 =over 4
16736
16737 =item AUTHOR
16738
16739 =item SEE ALSO
16740
16741 =back
16742
16743 =head2 Pod::Html - module to convert pod files to HTML
16744
16745 =over 4
16746
16747 =item SYNOPSIS
16748
16749 =item DESCRIPTION
16750
16751 =item ARGUMENTS
16752
16753 backlink, cachedir, css, flush, header, help, htmldir, htmlroot, index,
16754 infile, libpods, netscape, outfile, podpath, podroot, quiet, recurse,
16755 title, verbose
16756
16757 =item EXAMPLE
16758
16759 =item ENVIRONMENT
16760
16761 =item AUTHOR
16762
16763 =item SEE ALSO
16764
16765 =item COPYRIGHT
16766
16767 =back
16768
16769 =head2 Pod::InputObjects - objects representing POD input paragraphs,
16770 commands, etc.
16771
16772 =over 4
16773
16774 =item SYNOPSIS
16775
16776 =item REQUIRES
16777
16778 =item EXPORTS
16779
16780 =item DESCRIPTION
16781
16782 package B<Pod::InputSource>, package B<Pod::Paragraph>, package
16783 B<Pod::InteriorSequence>, package B<Pod::ParseTree>
16784
16785 =back
16786
16787 =over 4
16788
16789 =item B<Pod::InputSource>
16790
16791 =back
16792
16793 =over 4
16794
16795 =item B<new()>
16796
16797 =back
16798
16799 =over 4
16800
16801 =item B<name()>
16802
16803 =back
16804
16805 =over 4
16806
16807 =item B<handle()>
16808
16809 =back
16810
16811 =over 4
16812
16813 =item B<was_cutting()>
16814
16815 =back
16816
16817 =over 4
16818
16819 =item B<Pod::Paragraph>
16820
16821 =back
16822
16823 =over 4
16824
16825 =item Pod::Paragraph-E<gt>B<new()>
16826
16827 =back
16828
16829 =over 4
16830
16831 =item $pod_para-E<gt>B<cmd_name()>
16832
16833 =back
16834
16835 =over 4
16836
16837 =item $pod_para-E<gt>B<text()>
16838
16839 =back
16840
16841 =over 4
16842
16843 =item $pod_para-E<gt>B<raw_text()>
16844
16845 =back
16846
16847 =over 4
16848
16849 =item $pod_para-E<gt>B<cmd_prefix()>
16850
16851 =back
16852
16853 =over 4
16854
16855 =item $pod_para-E<gt>B<cmd_separator()>
16856
16857 =back
16858
16859 =over 4
16860
16861 =item $pod_para-E<gt>B<parse_tree()>
16862
16863 =back
16864
16865 =over 4
16866
16867 =item $pod_para-E<gt>B<file_line()>
16868
16869 =back
16870
16871 =over 4
16872
16873 =item B<Pod::InteriorSequence>
16874
16875 =back
16876
16877 =over 4
16878
16879 =item Pod::InteriorSequence-E<gt>B<new()>
16880
16881 =back
16882
16883 =over 4
16884
16885 =item $pod_seq-E<gt>B<cmd_name()>
16886
16887 =back
16888
16889 =over 4
16890
16891 =item $pod_seq-E<gt>B<prepend()>
16892
16893 =back
16894
16895 =over 4
16896
16897 =item $pod_seq-E<gt>B<append()>
16898
16899 =back
16900
16901 =over 4
16902
16903 =item $pod_seq-E<gt>B<nested()>
16904
16905 =back
16906
16907 =over 4
16908
16909 =item $pod_seq-E<gt>B<raw_text()>
16910
16911 =back
16912
16913 =over 4
16914
16915 =item $pod_seq-E<gt>B<left_delimiter()>
16916
16917 =back
16918
16919 =over 4
16920
16921 =item $pod_seq-E<gt>B<right_delimiter()>
16922
16923 =back
16924
16925 =over 4
16926
16927 =item $pod_seq-E<gt>B<parse_tree()>
16928
16929 =back
16930
16931 =over 4
16932
16933 =item $pod_seq-E<gt>B<file_line()>
16934
16935 =back
16936
16937 =over 4
16938
16939 =item Pod::InteriorSequence::B<DESTROY()>
16940
16941 =back
16942
16943 =over 4
16944
16945 =item B<Pod::ParseTree>
16946
16947 =back
16948
16949 =over 4
16950
16951 =item Pod::ParseTree-E<gt>B<new()>
16952
16953 =back
16954
16955 =over 4
16956
16957 =item $ptree-E<gt>B<top()>
16958
16959 =back
16960
16961 =over 4
16962
16963 =item $ptree-E<gt>B<children()>
16964
16965 =back
16966
16967 =over 4
16968
16969 =item $ptree-E<gt>B<prepend()>
16970
16971 =back
16972
16973 =over 4
16974
16975 =item $ptree-E<gt>B<append()>
16976
16977 =back
16978
16979 =over 4
16980
16981 =item $ptree-E<gt>B<raw_text()>
16982
16983 =back
16984
16985 =over 4
16986
16987 =item Pod::ParseTree::B<DESTROY()>
16988
16989 =back
16990
16991 =over 4
16992
16993 =item SEE ALSO
16994
16995 =item AUTHOR
16996
16997 =back
16998
16999 =head2 Pod::LaTeX - Convert Pod data to formatted Latex
17000
17001 =over 4
17002
17003 =item SYNOPSIS
17004
17005 =item DESCRIPTION
17006
17007 =back
17008
17009 =over 4
17010
17011 =item OBJECT METHODS
17012
17013 C<initialize>
17014
17015 =back
17016
17017 =over 4
17018
17019 =item Data Accessors
17020
17021 B<AddPreamble>
17022
17023 =back
17024
17025 B<AddPostamble>
17026
17027 B<Head1Level>
17028
17029 B<Label>
17030
17031 B<LevelNoNum>
17032
17033 B<MakeIndex>
17034
17035 B<ReplaceNAMEwithSection>
17036
17037 B<StartWithNewPage>
17038
17039 B<TableOfContents>
17040
17041 B<UniqueLabels>
17042
17043 B<UserPreamble>
17044
17045 B<UserPostamble>
17046
17047 B<Lists>
17048
17049 =over 4
17050
17051 =item Subclassed methods
17052
17053 =back
17054
17055 B<begin_pod>
17056
17057 B<end_pod>
17058
17059 B<command>
17060
17061 B<verbatim>
17062
17063 B<textblock>
17064
17065 B<interior_sequence>
17066
17067 =over 4
17068
17069 =item List Methods
17070
17071 B<begin_list>
17072
17073 =back
17074
17075 B<end_list>
17076
17077 B<add_item>
17078
17079 =over 4
17080
17081 =item Methods for headings
17082
17083 B<head>
17084
17085 =back
17086
17087 =over 4
17088
17089 =item Internal methods
17090
17091 B<_output>
17092
17093 =back
17094
17095 B<_replace_special_chars>
17096
17097 B<_replace_special_chars_late>
17098
17099 B<_create_label>
17100
17101 B<_create_index>
17102
17103 B<_clean_latex_commands>
17104
17105 B<_split_delimited>
17106
17107 =over 4
17108
17109 =item NOTES
17110
17111 =item SEE ALSO
17112
17113 =item AUTHORS
17114
17115 =item COPYRIGHT
17116
17117 =item REVISION
17118
17119 =back
17120
17121 =head2 Pod::Man - Convert POD data to formatted *roff input
17122
17123 =over 4
17124
17125 =item SYNOPSIS
17126
17127 =item DESCRIPTION
17128
17129 center, date, fixed, fixedbold, fixeditalic, fixedbolditalic, name, quotes,
17130 release, section
17131
17132 =item DIAGNOSTICS
17133
17134 roff font should be 1 or 2 chars, not "%s", Invalid link %s, Invalid quote
17135 specification "%s", %s:%d: Unknown command paragraph "%s", %s:%d: Unknown
17136 escape EE<lt>%sE<gt>, %s:%d: Unknown formatting code %s, %s:%d: Unmatched
17137 =back
17138
17139 =item BUGS
17140
17141 =item CAVEATS
17142
17143 =item SEE ALSO
17144
17145 =item AUTHOR
17146
17147 =item COPYRIGHT AND LICENSE
17148
17149 =back
17150
17151 =head2 Pod::ParseLink - Parse an LE<lt>E<gt> formatting code in POD text
17152
17153 =over 4
17154
17155 =item SYNOPSIS
17156
17157 =item DESCRIPTION
17158
17159 =item SEE ALSO
17160
17161 =item AUTHOR
17162
17163 =item COPYRIGHT AND LICENSE
17164
17165 =back
17166
17167 =head2 Pod::ParseUtils - helpers for POD parsing and conversion
17168
17169 =over 4
17170
17171 =item SYNOPSIS
17172
17173 =item DESCRIPTION
17174
17175 =back
17176
17177 =over 4
17178
17179 =item Pod::List
17180
17181 Pod::List-E<gt>new()
17182
17183 =back
17184
17185 $list-E<gt>file()
17186
17187 $list-E<gt>start()
17188
17189 $list-E<gt>indent()
17190
17191 $list-E<gt>type()
17192
17193 $list-E<gt>rx()
17194
17195 $list-E<gt>item()
17196
17197 $list-E<gt>parent()
17198
17199 $list-E<gt>tag()
17200
17201 =over 4
17202
17203 =item Pod::Hyperlink
17204
17205 Pod::Hyperlink-E<gt>new()
17206
17207 =back
17208
17209 $link-E<gt>parse($string)
17210
17211 $link-E<gt>markup($string)
17212
17213 $link-E<gt>text()
17214
17215 $link-E<gt>warning()
17216
17217 $link-E<gt>file(), $link-E<gt>line()
17218
17219 $link-E<gt>page()
17220
17221 $link-E<gt>node()
17222
17223 $link-E<gt>alttext()
17224
17225 $link-E<gt>type()
17226
17227 $link-E<gt>link()
17228
17229 =over 4
17230
17231 =item Pod::Cache
17232
17233 Pod::Cache-E<gt>new()
17234
17235 =back
17236
17237 $cache-E<gt>item()
17238
17239 $cache-E<gt>find_page($name)
17240
17241 =over 4
17242
17243 =item Pod::Cache::Item
17244
17245 Pod::Cache::Item-E<gt>new()
17246
17247 =back
17248
17249 $cacheitem-E<gt>page()
17250
17251 $cacheitem-E<gt>description()
17252
17253 $cacheitem-E<gt>path()
17254
17255 $cacheitem-E<gt>file()
17256
17257 $cacheitem-E<gt>nodes()
17258
17259 $cacheitem-E<gt>find_node($name)
17260
17261 $cacheitem-E<gt>idx()
17262
17263 =over 4
17264
17265 =item AUTHOR
17266
17267 =item SEE ALSO
17268
17269 =back
17270
17271 =head2 Pod::Parser - base class for creating POD filters and translators
17272
17273 =over 4
17274
17275 =item SYNOPSIS
17276
17277 =item REQUIRES
17278
17279 =item EXPORTS
17280
17281 =item DESCRIPTION
17282
17283 =item QUICK OVERVIEW
17284
17285 =item PARSING OPTIONS
17286
17287 B<-want_nonPODs> (default: unset), B<-process_cut_cmd> (default: unset),
17288 B<-warnings> (default: unset)
17289
17290 =back
17291
17292 =over 4
17293
17294 =item RECOMMENDED SUBROUTINE/METHOD OVERRIDES
17295
17296 =back
17297
17298 =over 4
17299
17300 =item B<command()>
17301
17302 C<$cmd>, C<$text>, C<$line_num>, C<$pod_para>
17303
17304 =back
17305
17306 =over 4
17307
17308 =item B<verbatim()>
17309
17310 C<$text>, C<$line_num>, C<$pod_para>
17311
17312 =back
17313
17314 =over 4
17315
17316 =item B<textblock()>
17317
17318 C<$text>, C<$line_num>, C<$pod_para>
17319
17320 =back
17321
17322 =over 4
17323
17324 =item B<interior_sequence()>
17325
17326 =back
17327
17328 =over 4
17329
17330 =item OPTIONAL SUBROUTINE/METHOD OVERRIDES
17331
17332 =back
17333
17334 =over 4
17335
17336 =item B<new()>
17337
17338 =back
17339
17340 =over 4
17341
17342 =item B<initialize()>
17343
17344 =back
17345
17346 =over 4
17347
17348 =item B<begin_pod()>
17349
17350 =back
17351
17352 =over 4
17353
17354 =item B<begin_input()>
17355
17356 =back
17357
17358 =over 4
17359
17360 =item B<end_input()>
17361
17362 =back
17363
17364 =over 4
17365
17366 =item B<end_pod()>
17367
17368 =back
17369
17370 =over 4
17371
17372 =item B<preprocess_line()>
17373
17374 =back
17375
17376 =over 4
17377
17378 =item B<preprocess_paragraph()>
17379
17380 =back
17381
17382 =over 4
17383
17384 =item METHODS FOR PARSING AND PROCESSING
17385
17386 =back
17387
17388 =over 4
17389
17390 =item B<parse_text()>
17391
17392 B<-expand_seq> =E<gt> I<code-ref>|I<method-name>, B<-expand_text> =E<gt>
17393 I<code-ref>|I<method-name>, B<-expand_ptree> =E<gt>
17394 I<code-ref>|I<method-name>
17395
17396 =back
17397
17398 =over 4
17399
17400 =item B<interpolate()>
17401
17402 =back
17403
17404 =over 4
17405
17406 =item B<parse_paragraph()>
17407
17408 =back
17409
17410 =over 4
17411
17412 =item B<parse_from_filehandle()>
17413
17414 =back
17415
17416 =over 4
17417
17418 =item B<parse_from_file()>
17419
17420 =back
17421
17422 =over 4
17423
17424 =item ACCESSOR METHODS
17425
17426 =back
17427
17428 =over 4
17429
17430 =item B<errorsub()>
17431
17432 =back
17433
17434 =over 4
17435
17436 =item B<cutting()>
17437
17438 =back
17439
17440 =over 4
17441
17442 =item B<parseopts()>
17443
17444 =back
17445
17446 =over 4
17447
17448 =item B<output_file()>
17449
17450 =back
17451
17452 =over 4
17453
17454 =item B<output_handle()>
17455
17456 =back
17457
17458 =over 4
17459
17460 =item B<input_file()>
17461
17462 =back
17463
17464 =over 4
17465
17466 =item B<input_handle()>
17467
17468 =back
17469
17470 =over 4
17471
17472 =item B<input_streams()>
17473
17474 =back
17475
17476 =over 4
17477
17478 =item B<top_stream()>
17479
17480 =back
17481
17482 =over 4
17483
17484 =item PRIVATE METHODS AND DATA
17485
17486 =back
17487
17488 =over 4
17489
17490 =item B<_push_input_stream()>
17491
17492 =back
17493
17494 =over 4
17495
17496 =item B<_pop_input_stream()>
17497
17498 =back
17499
17500 =over 4
17501
17502 =item TREE-BASED PARSING
17503
17504 =item SEE ALSO
17505
17506 =item AUTHOR
17507
17508 =back
17509
17510 =head2 Pod::Plainer - Perl extension for converting Pod to old style Pod.
17511
17512 =over 4
17513
17514 =item SYNOPSIS
17515
17516 =item DESCRIPTION
17517
17518 =over 4
17519
17520 =item EXPORT
17521
17522 =back
17523
17524 =item AUTHOR
17525
17526 =item SEE ALSO
17527
17528 =back
17529
17530 =head2 Pod::Select, podselect() - extract selected sections of POD from
17531 input
17532
17533 =over 4
17534
17535 =item SYNOPSIS
17536
17537 =item REQUIRES
17538
17539 =item EXPORTS
17540
17541 =item DESCRIPTION
17542
17543 =item SECTION SPECIFICATIONS
17544
17545 =item RANGE SPECIFICATIONS
17546
17547 =back
17548
17549 =over 4
17550
17551 =item OBJECT METHODS
17552
17553 =back
17554
17555 =over 4
17556
17557 =item B<curr_headings()>
17558
17559 =back
17560
17561 =over 4
17562
17563 =item B<select()>
17564
17565 =back
17566
17567 =over 4
17568
17569 =item B<add_selection()>
17570
17571 =back
17572
17573 =over 4
17574
17575 =item B<clear_selections()>
17576
17577 =back
17578
17579 =over 4
17580
17581 =item B<match_section()>
17582
17583 =back
17584
17585 =over 4
17586
17587 =item B<is_selected()>
17588
17589 =back
17590
17591 =over 4
17592
17593 =item EXPORTED FUNCTIONS
17594
17595 =back
17596
17597 =over 4
17598
17599 =item B<podselect()>
17600
17601 B<-output>, B<-sections>, B<-ranges>
17602
17603 =back
17604
17605 =over 4
17606
17607 =item PRIVATE METHODS AND DATA
17608
17609 =back
17610
17611 =over 4
17612
17613 =item B<_compile_section_spec()>
17614
17615 =back
17616
17617 =over 4
17618
17619 =item $self->{_SECTION_HEADINGS}
17620
17621 =back
17622
17623 =over 4
17624
17625 =item $self->{_SELECTED_SECTIONS}
17626
17627 =back
17628
17629 =over 4
17630
17631 =item SEE ALSO
17632
17633 =item AUTHOR
17634
17635 =back
17636
17637 =head2 Pod::Text - Convert POD data to formatted ASCII text
17638
17639 =over 4
17640
17641 =item SYNOPSIS
17642
17643 =item DESCRIPTION
17644
17645 alt, code, indent, loose, quotes, sentence, width
17646
17647 =item DIAGNOSTICS
17648
17649 Bizarre space in item, Item called without tag, Can't open %s for reading:
17650 %s, Invalid quote specification "%s", %s:%d: Unknown command paragraph: %s,
17651 %s:%d: Unknown escape: %s, %s:%d: Unknown formatting code: %s, %s:%d:
17652 Unmatched =back
17653
17654 =item RESTRICTIONS
17655
17656 =item NOTES
17657
17658 =item SEE ALSO
17659
17660 =item AUTHOR
17661
17662 =item COPYRIGHT AND LICENSE
17663
17664 =back
17665
17666 =head2 Pod::Text::Color - Convert POD data to formatted color ASCII text
17667
17668 =over 4
17669
17670 =item SYNOPSIS
17671
17672 =item DESCRIPTION
17673
17674 =item BUGS
17675
17676 =item SEE ALSO
17677
17678 =item AUTHOR
17679
17680 =item COPYRIGHT AND LICENSE
17681
17682 =back
17683
17684 =head2 Pod::Text::Overstrike - Convert POD data to formatted overstrike
17685 text
17686
17687 =over 4
17688
17689 =item SYNOPSIS
17690
17691 =item DESCRIPTION
17692
17693 =item BUGS
17694
17695 =item SEE ALSO
17696
17697 =item AUTHOR
17698
17699 =item COPYRIGHT AND LICENSE
17700
17701 =back
17702
17703 =head2 Pod::Text::Termcap - Convert POD data to ASCII text with format
17704 escapes
17705
17706 =over 4
17707
17708 =item SYNOPSIS
17709
17710 =item DESCRIPTION
17711
17712 =item NOTES
17713
17714 =item SEE ALSO
17715
17716 =item AUTHOR
17717
17718 =item COPYRIGHT AND LICENSE
17719
17720 =back
17721
17722 =head2 Pod::Usage, pod2usage() - print a usage message from embedded pod
17723 documentation
17724
17725 =over 4
17726
17727 =item SYNOPSIS
17728
17729 =item ARGUMENTS
17730
17731 C<-message>, C<-msg>, C<-exitval>, C<-verbose>, C<-output>, C<-input>,
17732 C<-pathlist>
17733
17734 =item DESCRIPTION
17735
17736 =item EXAMPLES
17737
17738 =over 4
17739
17740 =item Recommended Use
17741
17742 =back
17743
17744 =item CAVEATS
17745
17746 =item AUTHOR
17747
17748 =item ACKNOWLEDGEMENTS
17749
17750 =back
17751
17752 =head2 Pod::t::basic, basic.pod - Test of various basic POD features in
17753 translators.
17754
17755 =over 4
17756
17757 =item HEADINGS
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 This C<is> a "level 1" heading
17768
17769 =over 4
17770
17771 =item ``Level'' 2 I<heading>
17772
17773 =back
17774
17775 =item LINKS
17776
17777 =item OVER AND ITEMS
17778
17779 This  is a test, a, b, a, b, c, d, "foo", B<bar>, C<baz>, Some longer item
17780 text
17781
17782 =item FORMATTING CODES
17783
17784 E<amp>, E<apos>, E<lt>, E<gt>, E<quot>, E<sol>
17785
17786 =item VERBATIM
17787
17788 =item CONCLUSION
17789
17790 =back
17791
17792 =head2 Pod::t::htmlescp, Escape Sequences Test
17793
17794 =over 4
17795
17796 =item DESCRIPTION
17797
17798 =back
17799
17800 =head2 Pod::t::htmlview, Test HTML Rendering
17801
17802 =over 4
17803
17804 =item SYNOPSIS
17805
17806 =item DESCRIPTION
17807
17808 =item METHODS =E<gt> OTHER STUFF
17809
17810 =over 4
17811
17812 =item new()
17813
17814 foo, bar, baz, C<Black> Cat, Sat S<I<on> the>, MatE<lt>!E<gt>, 1 Cat, 2
17815 Sat, 3 Mat
17816
17817 =item old()
17818
17819 =back
17820
17821 =item TESTING FOR AND BEGIN
17822
17823 =item TESTING URLs hyperlinking
17824
17825 =item SEE ALSO
17826
17827 =back
17828
17829 =head2 SDBM_File - Tied access to sdbm files
17830
17831 =over 4
17832
17833 =item SYNOPSIS
17834
17835 =item DESCRIPTION
17836
17837 C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR>
17838
17839 =item DIAGNOSTICS
17840
17841 =over 4
17842
17843 =item C<sdbm store returned -1, errno 22, key "..." at ...>
17844
17845 =back
17846
17847 =item BUGS AND WARNINGS
17848
17849 =back
17850
17851 =head2 Safe - Compile and execute code in restricted compartments
17852
17853 =over 4
17854
17855 =item SYNOPSIS
17856
17857 =item DESCRIPTION
17858
17859 a new namespace, an operator mask
17860
17861 =item WARNING
17862
17863 =over 4
17864
17865 =item RECENT CHANGES
17866
17867 =item Methods in class Safe
17868
17869 permit (OP, ...), permit_only (OP, ...), deny (OP, ...), deny_only (OP,
17870 ...), trap (OP, ...), untrap (OP, ...), share (NAME, ...), share_from
17871 (PACKAGE, ARRAYREF), varglob (VARNAME), reval (STRING), rdo (FILENAME),
17872 root (NAMESPACE), mask (MASK)
17873
17874 =item Some Safety Issues
17875
17876 Memory, CPU, Snooping, Signals, State Changes
17877
17878 =item AUTHOR
17879
17880 =back
17881
17882 =back
17883
17884 =head2 Scalar::Util - A selection of general-utility scalar subroutines
17885
17886 =over 4
17887
17888 =item SYNOPSIS
17889
17890 =item DESCRIPTION
17891
17892 blessed EXPR, dualvar NUM, STRING, isweak EXPR, openhandle FH, reftype
17893 EXPR, tainted EXPR, weaken REF
17894
17895 =item KNOWN BUGS
17896
17897 =item COPYRIGHT
17898
17899 =item BLATANT PLUG
17900
17901 =back
17902
17903 =head2 Search::Dict, look - search for key in dictionary file
17904
17905 =over 4
17906
17907 =item SYNOPSIS
17908
17909 =item DESCRIPTION
17910
17911 =back
17912
17913 =head2 SelectSaver - save and restore selected file handle
17914
17915 =over 4
17916
17917 =item SYNOPSIS
17918
17919 =item DESCRIPTION
17920
17921 =back
17922
17923 =head2 SelfLoader - load functions only on demand
17924
17925 =over 4
17926
17927 =item SYNOPSIS
17928
17929 =item DESCRIPTION
17930
17931 =over 4
17932
17933 =item The __DATA__ token
17934
17935 =item SelfLoader autoloading
17936
17937 =item Autoloading and package lexicals
17938
17939 =item SelfLoader and AutoLoader
17940
17941 =item __DATA__, __END__, and the FOOBAR::DATA filehandle.
17942
17943 =item Classes and inherited methods.
17944
17945 =back
17946
17947 =item Multiple packages and fully qualified subroutine names
17948
17949 =back
17950
17951 =head2 Shell - run shell commands transparently within perl
17952
17953 =over 4
17954
17955 =item SYNOPSIS
17956
17957 =item DESCRIPTION
17958
17959 =over 4
17960
17961 =item OBJECT ORIENTED SYNTAX
17962
17963 =back
17964
17965 =item AUTHOR
17966
17967 =back
17968
17969 =head2 Socket, sockaddr_in, sockaddr_un, inet_aton, inet_ntoa - load the C
17970 socket.h defines and structure manipulators
17971
17972 =over 4
17973
17974 =item SYNOPSIS
17975
17976 =item DESCRIPTION
17977
17978 inet_aton HOSTNAME, inet_ntoa IP_ADDRESS, INADDR_ANY, INADDR_BROADCAST,
17979 INADDR_LOOPBACK, INADDR_NONE, sockaddr_family SOCKADDR, sockaddr_in PORT,
17980 ADDRESS, sockaddr_in SOCKADDR_IN, pack_sockaddr_in PORT, IP_ADDRESS,
17981 unpack_sockaddr_in SOCKADDR_IN, sockaddr_un PATHNAME, sockaddr_un
17982 SOCKADDR_UN, pack_sockaddr_un PATH, unpack_sockaddr_un SOCKADDR_UN
17983
17984 =back
17985
17986 =head2 Storable - persistence for Perl data structures
17987
17988 =over 4
17989
17990 =item SYNOPSIS
17991
17992 =item DESCRIPTION
17993
17994 =item MEMORY STORE
17995
17996 =item ADVISORY LOCKING
17997
17998 =item SPEED
17999
18000 =item CANONICAL REPRESENTATION
18001
18002 =item FORWARD COMPATIBILITY
18003
18004 utf8 data, restricted hashes, files from future versions of Storable
18005
18006 =item ERROR REPORTING
18007
18008 =item WIZARDS ONLY
18009
18010 =over 4
18011
18012 =item Hooks
18013
18014 C<STORABLE_freeze> I<obj>, I<cloning>, C<STORABLE_thaw> I<obj>, I<cloning>,
18015 I<serialized>, ..
18016
18017 =item Predicates
18018
18019 C<Storable::last_op_in_netorder>, C<Storable::is_storing>,
18020 C<Storable::is_retrieving>
18021
18022 =item Recursion
18023
18024 =item Deep Cloning
18025
18026 =back
18027
18028 =item Storable magic
18029
18030 =item EXAMPLES
18031
18032 =item WARNING
18033
18034 =item BUGS
18035
18036 =over 4
18037
18038 =item 64 bit data in perl 5.6.0 and 5.6.1
18039
18040 =back
18041
18042 =item CREDITS
18043
18044 =item AUTHOR
18045
18046 =item SEE ALSO
18047
18048 =back
18049
18050 =head2 Switch - A switch statement for Perl
18051
18052 =over 4
18053
18054 =item VERSION
18055
18056 =item SYNOPSIS
18057
18058 =item BACKGROUND
18059
18060 =item DESCRIPTION
18061
18062 =over 4
18063
18064 =item Allowing fall-through
18065
18066 =item Automating fall-through
18067
18068 =item Alternative syntax
18069
18070 =item Higher-order Operations
18071
18072 =back
18073
18074 =item DEPENDENCIES
18075
18076 =item AUTHOR
18077
18078 =item BUGS
18079
18080 =item LIMITATION
18081
18082 =item COPYRIGHT
18083
18084 =back
18085
18086 =head2 Symbol - manipulate Perl symbols and their names
18087
18088 =over 4
18089
18090 =item SYNOPSIS
18091
18092 =item DESCRIPTION
18093
18094 =back
18095
18096 =head2 Sys::Hostname - Try every conceivable way to get hostname
18097
18098 =over 4
18099
18100 =item SYNOPSIS
18101
18102 =item DESCRIPTION
18103
18104 =item AUTHOR
18105
18106 =back
18107
18108 =head2 Syslog, Sys::Syslog, openlog, closelog, setlogmask, syslog - Perl
18109 interface to the UNIX syslog(3) calls
18110
18111 =over 4
18112
18113 =item SYNOPSIS
18114
18115 =item DESCRIPTION
18116
18117 openlog $ident, $logopt, $facility, syslog $priority, $format, @args,
18118 setlogmask $mask_priority, setlogsock $sock_type [$stream_location] (added
18119 in 5.004_02), closelog
18120
18121 =item EXAMPLES
18122
18123 =item SEE ALSO
18124
18125 =item AUTHOR
18126
18127 =back
18128
18129 =head2 Syslog::Syslog, Sys::Syslog, openlog, closelog, setlogmask, syslog -
18130 Perl interface to the UNIX syslog(3) calls
18131
18132 =over 4
18133
18134 =item SYNOPSIS
18135
18136 =item DESCRIPTION
18137
18138 openlog $ident, $logopt, $facility, syslog $priority, $format, @args,
18139 setlogmask $mask_priority, setlogsock $sock_type [$stream_location] (added
18140 in 5.004_02), closelog
18141
18142 =item EXAMPLES
18143
18144 =item SEE ALSO
18145
18146 =item AUTHOR
18147
18148 =back
18149
18150 =head2 Term::ANSIColor - Color screen output using ANSI escape sequences
18151
18152 =over 4
18153
18154 =item SYNOPSIS
18155
18156 =item DESCRIPTION
18157
18158 =item DIAGNOSTICS
18159
18160 Bad escape sequence %s, Bareword "%s" not allowed while "strict subs" in
18161 use, Invalid attribute name %s, Name "%s" used only once: possible typo, No
18162 comma allowed after filehandle, No name for escape sequence %s
18163
18164 =item ENVIRONMENT
18165
18166 ANSI_COLORS_DISABLED
18167
18168 =item RESTRICTIONS
18169
18170 =item NOTES
18171
18172 =item SEE ALSO
18173
18174 =item AUTHORS
18175
18176 =item COPYRIGHT AND LICENSE
18177
18178 =back
18179
18180 =head2 Term::Cap - Perl termcap interface
18181
18182 =over 4
18183
18184 =item SYNOPSIS
18185
18186 =item DESCRIPTION
18187
18188 =over 4
18189
18190 =item METHODS
18191
18192 =back
18193
18194 =back
18195
18196 B<Tgetent>, OSPEED, TERM
18197
18198 B<Tpad>, B<$string>, B<$cnt>, B<$FH>
18199
18200 B<Tputs>, B<$cap>, B<$cnt>, B<$FH>
18201
18202 B<Tgoto>, B<$cap>, B<$col>, B<$row>, B<$FH>
18203
18204 B<Trequire>
18205
18206 =over 4
18207
18208 =item EXAMPLES
18209
18210 =item COPYRIGHT AND LICENSE
18211
18212 =item AUTHOR
18213
18214 =item SEE ALSO
18215
18216 =back
18217
18218 =head2 Term::Complete - Perl word completion module
18219
18220 =over 4
18221
18222 =item SYNOPSIS
18223
18224 =item DESCRIPTION
18225
18226 E<lt>tabE<gt>, ^D, ^U, E<lt>delE<gt>, E<lt>bsE<gt>
18227
18228 =item DIAGNOSTICS
18229
18230 =item BUGS
18231
18232 =item AUTHOR
18233
18234 =back
18235
18236 =head2 Term::ReadLine - Perl interface to various C<readline> packages. If
18237 no real package is found, substitutes stubs instead of basic functions.
18238
18239 =over 4
18240
18241 =item SYNOPSIS
18242
18243 =item DESCRIPTION
18244
18245 =item Minimal set of supported functions
18246
18247 C<ReadLine>, C<new>, C<readline>, C<addhistory>, C<IN>, $C<OUT>,
18248 C<MinLine>, C<findConsole>, Attribs, C<Features>
18249
18250 =item Additional supported functions
18251
18252 C<tkRunning>, C<ornaments>, C<newTTY>
18253
18254 =item EXPORTS
18255
18256 =item ENVIRONMENT
18257
18258 =item CAVEATS
18259
18260 =back
18261
18262 =head2 Test - provides a simple framework for writing test scripts
18263
18264 =over 4
18265
18266 =item SYNOPSIS
18267
18268 =item DESCRIPTION
18269
18270 =over 4
18271
18272 =item Functions
18273
18274 B<plan>
18275
18276 =back
18277
18278 =back
18279
18280 B<_to_value>
18281
18282 B<ok>
18283
18284 =over 4
18285
18286 =item TEST TYPES
18287
18288 NORMAL TESTS, SKIPPED TESTS, TODO TESTS
18289
18290 =item ONFAIL
18291
18292 =item BUGS and CAVEATS
18293
18294 =item NOTE
18295
18296 =item SEE ALSO
18297
18298 =item AUTHOR
18299
18300 =back
18301
18302 =head2 Test::Builder - Backend for building test libraries
18303
18304 =over 4
18305
18306 =item SYNOPSIS
18307
18308 =item DESCRIPTION
18309
18310 =over 4
18311
18312 =item Construction
18313
18314 B<new>
18315
18316 =back
18317
18318 =back
18319
18320 =over 4
18321
18322 =item Setting up tests
18323
18324 B<exported_to>
18325
18326 =back
18327
18328 B<plan>
18329
18330 B<expected_tests>
18331
18332 B<no_plan>
18333
18334 B<skip_all>
18335
18336 =over 4
18337
18338 =item Running tests
18339
18340 B<ok>
18341
18342 =back
18343
18344 B<is_eq>, B<is_num>
18345
18346 B<isnt_eq>, B<isnt_num>
18347
18348 B<like>, B<unlike>
18349
18350 B<maybe_regex>
18351
18352 B<cmp_ok>
18353
18354 B<BAILOUT>
18355
18356 B<skip>
18357
18358 B<todo_skip>
18359
18360 B<skip_rest>
18361
18362 =over 4
18363
18364 =item Test style
18365
18366 B<level>
18367
18368 =back
18369
18370 B<use_numbers>
18371
18372 B<no_header>, B<no_ending>
18373
18374 =over 4
18375
18376 =item Output
18377
18378 B<diag>
18379
18380 =back
18381
18382 B<_print>
18383
18384 B<output>, B<failure_output>, B<todo_output>
18385
18386 =over 4
18387
18388 =item Test Status and Info
18389
18390 B<current_test>
18391
18392 =back
18393
18394 B<summary>
18395
18396 B<details>  I<UNIMPLEMENTED>, B<todo>
18397
18398 B<caller>
18399
18400 B<_sanity_check>
18401
18402 B<_whoa>
18403
18404 B<_my_exit>
18405
18406 =over 4
18407
18408 =item THREADS
18409
18410 =item EXAMPLES
18411
18412 =item SEE ALSO
18413
18414 =item AUTHORS
18415
18416 =item COPYRIGHT
18417
18418 =back
18419
18420 =head2 Test::Harness - run perl standard test scripts with statistics
18421
18422 =over 4
18423
18424 =item SYNOPSIS
18425
18426 =item DESCRIPTION
18427
18428 =over 4
18429
18430 =item The test script output
18431
18432 B<'1..M'>, B<'ok', 'not ok'.  Ok?>, B<test numbers>, B<test names>,
18433 B<Skipping tests>, B<Todo tests>, B<Bail out!>, B<Comments>, B<Anything
18434 else>
18435
18436 =item Taint mode
18437
18438 =item Configuration variables.
18439
18440 B<$Test::Harness::verbose>, B<$Test::Harness::switches>
18441
18442 =item Failure
18443
18444 B<Failed Test>, B<Stat>, B<Wstat>, B<Total>, B<Fail>, B<Failed>, B<List of
18445 Failed>
18446
18447 =item Functions
18448
18449 B<runtests>
18450
18451 =back
18452
18453 =back
18454
18455 B<_all_ok>
18456
18457 B<_globdir>
18458
18459 B<_run_all_tests>
18460
18461 B<_mk_leader>
18462
18463 B<_leader_width>
18464
18465 =over 4
18466
18467 =item EXPORT
18468
18469 =item DIAGNOSTICS
18470
18471 C<All tests successful.\nFiles=%d,  Tests=%d, %s>, C<FAILED tests
18472 %s\n\tFailed %d/%d tests, %.2f%% okay.>, C<Test returned status %d (wstat
18473 %d)>, C<Failed 1 test, %.2f%% okay. %s>, C<Failed %d/%d tests, %.2f%% okay.
18474 %s>, C<FAILED--Further testing stopped: %s>
18475
18476 =item ENVIRONMENT
18477
18478 C<HARNESS_ACTIVE>, C<HARNESS_COLUMNS>, C<HARNESS_COMPILE_TEST>,
18479 C<HARNESS_FILELEAK_IN_DIR>, C<HARNESS_IGNORE_EXITCODE>, C<HARNESS_NOTTY>,
18480 C<HARNESS_PERL_SWITCHES>, C<HARNESS_VERBOSE>
18481
18482 =item EXAMPLE
18483
18484 =item SEE ALSO
18485
18486 =item AUTHORS
18487
18488 =item TODO
18489
18490 =item BUGS
18491
18492 =back
18493
18494 =head2 Test::Harness::Assert - simple assert
18495
18496 =over 4
18497
18498 =item SYNOPSIS
18499
18500 =item DESCRIPTION
18501
18502 =over 4
18503
18504 =item Functions
18505
18506 B<assert>
18507
18508 =back
18509
18510 =back
18511
18512 =over 4
18513
18514 =item AUTHOR
18515
18516 =item SEE ALSO
18517
18518 =back
18519
18520 =head2 Test::Harness::Iterator - Internal Test::Harness Iterator
18521
18522 =over 4
18523
18524 =item SYNOPSIS
18525
18526 =item DESCRIPTION
18527
18528 =back
18529
18530 =head2 Test::Harness::Straps - detailed analysis of test results
18531
18532 =over 4
18533
18534 =item SYNOPSIS
18535
18536 =item DESCRIPTION
18537
18538 =over 4
18539
18540 =item Construction
18541
18542 B<new>
18543
18544 =back
18545
18546 =back
18547
18548 B<_init>
18549
18550 =over 4
18551
18552 =item Analysis
18553
18554 B<analyze>
18555
18556 =back
18557
18558 B<analyze_fh>
18559
18560 B<analyze_file>
18561
18562 B<_switches>
18563
18564 B<_INC2PERL5LIB>
18565
18566 B<_filtered_INC>
18567
18568 B<_restore_PERL5LIB>
18569
18570 =over 4
18571
18572 =item Parsing
18573
18574 B<_is_comment>
18575
18576 =back
18577
18578 B<_is_header>
18579
18580 B<_is_test>
18581
18582 B<_is_bail_out>
18583
18584 B<_reset_file_state>
18585
18586 =over 4
18587
18588 =item Results
18589
18590 B<_detailize>
18591
18592 =back
18593
18594 =over 4
18595
18596 =item EXAMPLES
18597
18598 =item AUTHOR
18599
18600 =item SEE ALSO
18601
18602 =back
18603
18604 =head2 Test::More - yet another framework for writing test scripts
18605
18606 =over 4
18607
18608 =item SYNOPSIS
18609
18610 =item DESCRIPTION
18611
18612 =over 4
18613
18614 =item I love it when a plan comes together
18615
18616 =back
18617
18618 =back
18619
18620 =over 4
18621
18622 =item Test names
18623
18624 =item I'm ok, you're not ok.
18625
18626 B<ok>
18627
18628 =back
18629
18630 B<is>, B<isnt>
18631
18632 B<like>
18633
18634 B<unlike>
18635
18636 B<cmp_ok>
18637
18638 B<can_ok>
18639
18640 B<isa_ok>
18641
18642 B<pass>, B<fail>
18643
18644 =over 4
18645
18646 =item Diagnostics
18647
18648 B<diag>
18649
18650 =back
18651
18652 =over 4
18653
18654 =item Module tests
18655
18656 B<use_ok>
18657
18658 =back
18659
18660 B<require_ok>
18661
18662 =over 4
18663
18664 =item Conditional tests
18665
18666 B<SKIP: BLOCK>
18667
18668 =back
18669
18670 B<TODO: BLOCK>, B<todo_skip>
18671
18672 When do I use SKIP vs. TODO?
18673
18674 =over 4
18675
18676 =item Comparison functions
18677
18678 B<is_deeply>
18679
18680 =back
18681
18682 B<eq_array>
18683
18684 B<eq_hash>
18685
18686 B<eq_set>
18687
18688 =over 4
18689
18690 =item Extending and Embedding Test::More
18691
18692 B<builder>
18693
18694 =back
18695
18696 =over 4
18697
18698 =item NOTES
18699
18700 =item BUGS and CAVEATS
18701
18702 Making your own ok(), The eq_* family has some caveats, Test::Harness
18703 upgrades
18704
18705 =item HISTORY
18706
18707 =item SEE ALSO
18708
18709 =item AUTHORS
18710
18711 =item COPYRIGHT
18712
18713 =back
18714
18715 =head2 Test::Simple - Basic utilities for writing tests.
18716
18717 =over 4
18718
18719 =item SYNOPSIS
18720
18721 =item DESCRIPTION
18722
18723 B<ok>
18724
18725 =back
18726
18727 =over 4
18728
18729 =item EXAMPLE
18730
18731 =item CAVEATS
18732
18733 =item NOTES
18734
18735 =item HISTORY
18736
18737 =item SEE ALSO
18738
18739 L<Test::More>, L<Test>, L<Test::Unit>, L<Test::Inline>, L<SelfTest>,
18740 L<Test::Harness>
18741
18742 =item AUTHORS
18743
18744 =item COPYRIGHT
18745
18746 =back
18747
18748 =head2 Test::Tutorial - A tutorial about writing really basic tests
18749
18750 =over 4
18751
18752 =item DESCRIPTION
18753
18754 =over 4
18755
18756 =item Nuts and bolts of testing.
18757
18758 =item Where to start?
18759
18760 =item Names
18761
18762 =item Test the manual
18763
18764 =item Sometimes the tests are wrong
18765
18766 =item Testing lots of values
18767
18768 =item Informative names
18769
18770 =item Skipping tests
18771
18772 =item Todo tests
18773
18774 =item Testing with taint mode.
18775
18776 =back
18777
18778 =item FOOTNOTES
18779
18780 =item AUTHORS
18781
18782 =item COPYRIGHT
18783
18784 =back
18785
18786 =head2 Text::Abbrev, abbrev - create an abbreviation table from a list
18787
18788 =over 4
18789
18790 =item SYNOPSIS
18791
18792 =item DESCRIPTION
18793
18794 =item EXAMPLE
18795
18796 =back
18797
18798 =head2 Text::Balanced - Extract delimited text sequences from strings.
18799
18800 =over 4
18801
18802 =item SYNOPSIS
18803
18804 =item DESCRIPTION
18805
18806 =over 4
18807
18808 =item General behaviour in list contexts
18809
18810 [0], [1], [2]
18811
18812 =item General behaviour in scalar and void contexts
18813
18814 =item A note about prefixes
18815
18816 =item C<extract_delimited>
18817
18818 =item C<extract_bracketed>
18819
18820 =item C<extract_tagged>
18821
18822 C<reject =E<gt> $listref>, C<ignore =E<gt> $listref>, C<fail =E<gt> $str>,
18823 [0], [1], [2], [3], [4], [5]
18824
18825 =item C<gen_extract_tagged>
18826
18827 =item C<extract_quotelike>
18828
18829 [0], [1], [2], [3], [4], [5], [6], [7], [8], [9], [10]
18830
18831 =item C<extract_quotelike> and "here documents"
18832
18833 [0], [1], [2], [3], [4], [5], [6], [7..10]
18834
18835 =item C<extract_codeblock>
18836
18837 =item C<extract_multiple>
18838
18839 =item C<gen_delimited_pat>
18840
18841 =back
18842
18843 =item DIAGNOSTICS
18844
18845  C<Did not find a suitable bracket: "%s">,  C<Did not find prefix: /%s/>,
18846 C<Did not find opening bracket after prefix: "%s">,  C<No quotelike
18847 operator found after prefix: "%s">,  C<Unmatched closing bracket: "%c">,
18848 C<Unmatched opening bracket(s): "%s">, C<Unmatched embedded quote (%s)>,
18849 C<Did not find closing delimiter to match '%s'>,  C<Mismatched closing
18850 bracket: expected "%c" but found "%s">,  C<No block delimiter found after
18851 quotelike "%s">, C<Did not find leading dereferencer>, C<Bad identifier
18852 after dereferencer>, C<Did not find expected opening bracket at %s>,
18853 C<Improperly nested codeblock at %s>,  C<Missing second block for quotelike
18854 "%s">, C<No match found for opening bracket>, C<Did not find opening tag:
18855 /%s/>, C<Unable to construct closing tag to match: /%s/>, C<Found invalid
18856 nested tag: %s>, C<Found unbalanced nested tag: %s>, C<Did not find closing
18857 tag>
18858
18859 =item AUTHOR
18860
18861 =item BUGS AND IRRITATIONS
18862
18863 =item COPYRIGHT
18864
18865 =back
18866
18867 =head2 Text::ParseWords - parse text into an array of tokens or array of
18868 arrays
18869
18870 =over 4
18871
18872 =item SYNOPSIS
18873
18874 =item DESCRIPTION
18875
18876 =item EXAMPLES
18877
18878 =item AUTHORS
18879
18880 =back
18881
18882 =head2 Text::Soundex - Implementation of the Soundex Algorithm as Described
18883 by Knuth
18884
18885 =over 4
18886
18887 =item SYNOPSIS
18888
18889 =item DESCRIPTION
18890
18891 =item EXAMPLES
18892
18893 =item LIMITATIONS
18894
18895 =item AUTHOR
18896
18897 =back
18898
18899 =head2 Text::Tabs -- expand and unexpand tabs per the unix expand(1) and
18900 unexpand(1)
18901
18902 =over 4
18903
18904 =item SYNOPSIS
18905
18906 =item DESCRIPTION
18907
18908 =item BUGS
18909
18910 =item AUTHOR
18911
18912 =back
18913
18914 =head2 Text::Wrap - line wrapping to form simple paragraphs
18915
18916 =over 4
18917
18918 =item SYNOPSIS
18919
18920 =item DESCRIPTION
18921
18922 =item OVERRIDES
18923
18924 =item EXAMPLE
18925
18926 =item AUTHOR
18927
18928 =back
18929
18930 =head2 Thread - manipulate threads in Perl (for old code only)
18931
18932 =over 4
18933
18934 =item CAVEAT
18935
18936 =item SYNOPSIS
18937
18938 =item DESCRIPTION
18939
18940 =item FUNCTIONS
18941
18942 $thread = Thread->new(\&start_sub), $thread = Thread->new(\&start_sub,
18943 LIST), lock VARIABLE, async BLOCK;, Thread->self, cond_wait VARIABLE,
18944 cond_signal VARIABLE, cond_broadcast VARIABLE, yield
18945
18946 =item METHODS
18947
18948 join, eval, detach, equal, tid, flags, done
18949
18950 =item LIMITATIONS
18951
18952 =item SEE ALSO
18953
18954 =back
18955
18956 =head2 Thread::Queue - thread-safe queues
18957
18958 =over 4
18959
18960 =item SYNOPSIS
18961
18962 =item DESCRIPTION
18963
18964 =item FUNCTIONS AND METHODS
18965
18966 new, enqueue LIST, dequeue, dequeue_nb, pending
18967
18968 =item SEE ALSO
18969
18970 =back
18971
18972 =head2 Thread::Semaphore - thread-safe semaphores
18973
18974 =over 4
18975
18976 =item SYNOPSIS
18977
18978 =item DESCRIPTION
18979
18980 =item FUNCTIONS AND METHODS
18981
18982 new, new NUMBER, down, down NUMBER, up, up NUMBER
18983
18984 =back
18985
18986 =head2 Thread::Signal - Start a thread which runs signal handlers reliably
18987 (for old code)
18988
18989 =over 4
18990
18991 =item CAVEAT
18992
18993 =item SYNOPSIS
18994
18995 =item DESCRIPTION
18996
18997 =item BUGS
18998
18999 =back
19000
19001 =head2 Thread::Specific - thread-specific keys
19002
19003 =over 4
19004
19005 =item SYNOPSIS
19006
19007 =item DESCRIPTION
19008
19009 =back
19010
19011 =head2 Tie::Array - base class for tied arrays
19012
19013 =over 4
19014
19015 =item SYNOPSIS
19016
19017 =item DESCRIPTION
19018
19019 TIEARRAY classname, LIST, STORE this, index, value, FETCH this, index,
19020 FETCHSIZE this, STORESIZE this, count, EXTEND this, count, EXISTS this,
19021 key, DELETE this, key, CLEAR this, DESTROY this, PUSH this, LIST, POP this,
19022 SHIFT this, UNSHIFT this, LIST, SPLICE this, offset, length, LIST
19023
19024 =item CAVEATS
19025
19026 =item AUTHOR
19027
19028 =back
19029
19030 =head2 Tie::File - Access the lines of a disk file via a Perl array
19031
19032 =over 4
19033
19034 =item SYNOPSIS
19035
19036 =item DESCRIPTION
19037
19038 =over 4
19039
19040 =item C<recsep>
19041
19042 =item C<autochomp>
19043
19044 =item C<mode>
19045
19046 =item C<memory>
19047
19048 =item C<dw_size>
19049
19050 =item Option Format
19051
19052 =back
19053
19054 =item Public Methods
19055
19056 =over 4
19057
19058 =item C<flock>
19059
19060 =item C<autochomp>
19061
19062 =item C<defer>, C<flush>, C<discard>, and C<autodefer>
19063
19064 =back
19065
19066 =item Tying to an already-opened filehandle
19067
19068 =item Deferred Writing
19069
19070 =over 4
19071
19072 =item Autodeferring
19073
19074 =back
19075
19076 =item CAVEATS
19077
19078 =item SUBCLASSING
19079
19080 =item WHAT ABOUT C<DB_File>?
19081
19082 =item AUTHOR
19083
19084 =item LICENSE
19085
19086 =item WARRANTY
19087
19088 =item THANKS
19089
19090 =item TODO
19091
19092 =back
19093
19094 =head2 Tie::Handle, Tie::StdHandle  - base class definitions for tied
19095 handles
19096
19097 =over 4
19098
19099 =item SYNOPSIS
19100
19101 =item DESCRIPTION
19102
19103 TIEHANDLE classname, LIST, WRITE this, scalar, length, offset, PRINT this,
19104 LIST, PRINTF this, format, LIST, READ this, scalar, length, offset,
19105 READLINE this, GETC this, CLOSE this, OPEN this, filename, BINMODE this,
19106 EOF this, TELL this, SEEK this, offset, whence, DESTROY this
19107
19108 =item MORE INFORMATION
19109
19110 =item COMPATIBILITY
19111
19112 =back
19113
19114 =head2 Tie::Hash, Tie::StdHash, Tie::ExtraHash - base class definitions for
19115 tied hashes
19116
19117 =over 4
19118
19119 =item SYNOPSIS
19120
19121 =item DESCRIPTION
19122
19123 TIEHASH classname, LIST, STORE this, key, value, FETCH this, key, FIRSTKEY
19124 this, NEXTKEY this, lastkey, EXISTS this, key, DELETE this, key, CLEAR this
19125
19126 =item Inheriting from B<Tie::StdHash>
19127
19128 =item Inheriting from B<Tie::ExtraHash>
19129
19130 =item C<UNTIE> and C<DESTROY>
19131
19132 =item MORE INFORMATION
19133
19134 =back
19135
19136 =head2 Tie::Memoize - add data to hash when needed
19137
19138 =over 4
19139
19140 =item SYNOPSIS
19141
19142 =item DESCRIPTION
19143
19144 =item Inheriting from B<Tie::Memoize>
19145
19146 =item EXAMPLE
19147
19148 =item BUGS
19149
19150 =item AUTHOR
19151
19152 =back
19153
19154 =head2 Tie::RefHash - use references as hash keys
19155
19156 =over 4
19157
19158 =item SYNOPSIS
19159
19160 =item DESCRIPTION
19161
19162 =item EXAMPLE
19163
19164 =item AUTHOR
19165
19166 =item VERSION
19167
19168 =item SEE ALSO
19169
19170 =back
19171
19172 =head2 Tie::Scalar, Tie::StdScalar - base class definitions for tied
19173 scalars
19174
19175 =over 4
19176
19177 =item SYNOPSIS
19178
19179 =item DESCRIPTION
19180
19181 TIESCALAR classname, LIST, FETCH this, STORE this, value, DESTROY this
19182
19183 =item MORE INFORMATION
19184
19185 =back
19186
19187 =head2 Tie::SubstrHash - Fixed-table-size, fixed-key-length hashing
19188
19189 =over 4
19190
19191 =item SYNOPSIS
19192
19193 =item DESCRIPTION
19194
19195 =item CAVEATS
19196
19197 =back
19198
19199 =head2 Time::HiRes - High resolution alarm, sleep, gettimeofday, interval
19200 timers
19201
19202 =over 4
19203
19204 =item SYNOPSIS
19205
19206 =item DESCRIPTION
19207
19208 gettimeofday (), usleep ( $useconds ), ualarm ( $useconds [,
19209 $interval_useconds ] ), tv_interval, time (), sleep ( $floating_seconds ),
19210 alarm ( $floating_seconds [, $interval_floating_seconds ] ), setitimer,
19211 getitimer ( $which )
19212
19213 =item EXAMPLES
19214
19215 =item C API
19216
19217 =item CAVEATS
19218
19219 =item AUTHORS
19220
19221 =item REVISION
19222
19223 =item COPYRIGHT
19224
19225 =back
19226
19227 =head2 Time::Local - efficiently compute time from local and GMT time
19228
19229 =over 4
19230
19231 =item SYNOPSIS
19232
19233 =item DESCRIPTION
19234
19235 =item IMPLEMENTATION
19236
19237 =item BUGS
19238
19239 =back
19240
19241 =head2 Time::gmtime - by-name interface to Perl's built-in gmtime()
19242 function
19243
19244 =over 4
19245
19246 =item SYNOPSIS
19247
19248 =item DESCRIPTION
19249
19250 =item NOTE
19251
19252 =item AUTHOR
19253
19254 =back
19255
19256 =head2 Time::localtime - by-name interface to Perl's built-in localtime()
19257 function
19258
19259 =over 4
19260
19261 =item SYNOPSIS
19262
19263 =item DESCRIPTION
19264
19265 =item NOTE
19266
19267 =item AUTHOR
19268
19269 =back
19270
19271 =head2 Time::tm - internal object used by Time::gmtime and Time::localtime
19272
19273 =over 4
19274
19275 =item SYNOPSIS
19276
19277 =item DESCRIPTION
19278
19279 =item AUTHOR
19280
19281 =back
19282
19283 =head2 UNIVERSAL - base class for ALL classes (blessed references)
19284
19285 =over 4
19286
19287 =item SYNOPSIS
19288
19289 =item DESCRIPTION
19290
19291 $obj->isa( TYPE ), CLASS->isa( TYPE ), isa( VAL, TYPE ), $obj->can( METHOD
19292 ), CLASS->can( METHOD ), can( VAL, METHOD ), VERSION ( [ REQUIRE ] )
19293
19294 =back
19295
19296 =head2 Unicode::Collate - Unicode Collation Algorithm
19297
19298 =over 4
19299
19300 =item SYNOPSIS
19301
19302 =item DESCRIPTION
19303
19304 =over 4
19305
19306 =item Constructor and Tailoring
19307
19308 alternate, backwards, entry, ignoreName, ignoreChar, level, normalization,
19309 overrideCJK, overrideHangul, preprocess, rearrange, table, undefName,
19310 undefChar, katakana_before_hiragana, upper_before_lower
19311
19312 =item Methods for Collation
19313
19314 C<@sorted = $Collator-E<gt>sort(@not_sorted)>, C<$result =
19315 $Collator-E<gt>cmp($a, $b)>, C<$result = $Collator-E<gt>eq($a, $b)>,
19316 C<$result = $Collator-E<gt>ne($a, $b)>, C<$result = $Collator-E<gt>lt($a,
19317 $b)>, C<$result = $Collator-E<gt>le($a, $b)>, C<$result =
19318 $Collator-E<gt>gt($a, $b)>, C<$result = $Collator-E<gt>ge($a, $b)>,
19319 C<$sortKey = $Collator-E<gt>getSortKey($string)>, C<$sortKeyForm =
19320 $Collator-E<gt>viewSortKey($string)>, C<$position =
19321 $Collator-E<gt>index($string, $substring)>, C<($position, $length) =
19322 $Collator-E<gt>index($string, $substring)>
19323
19324 =item Other Methods
19325
19326 UCA_Version, Base_Unicode_Version
19327
19328 =item EXPORT
19329
19330 =item TODO
19331
19332 =item CAVEAT
19333
19334 =item BUGS
19335
19336 =back
19337
19338 =item AUTHOR
19339
19340 =item SEE ALSO
19341
19342 http://www.unicode.org/unicode/reports/tr10/,
19343 http://www.unicode.org/unicode/reports/tr10/allkeys.txt,
19344 http://www.unicode.org/unicode/reports/tr15/,
19345 http://www.unicode.org/unicode/reports/tr18, L<Unicode::Normalize>
19346
19347 =back
19348
19349 =head2 Unicode::Normalize - Unicode Normalization Forms
19350
19351 =over 4
19352
19353 =item SYNOPSIS
19354
19355 =item DESCRIPTION
19356
19357 =over 4
19358
19359 =item Normalization Forms
19360
19361 C<$NFD_string = NFD($string)>, C<$NFC_string = NFC($string)>,
19362 C<$NFKD_string = NFKD($string)>, C<$NFKC_string = NFKC($string)>,
19363 C<$normalized_string = normalize($form_name, $string)>
19364
19365 =item Decomposition and Composition
19366
19367 C<$decomposed_string = decompose($string)>, C<$decomposed_string =
19368 decompose($string, $useCompatMapping)>, C<$reordered_string  =
19369 reorder($string)>, C<$composed_string   = compose($string)>
19370
19371 =item Quick Check
19372
19373 C<$result = checkNFD($string)>, C<$result = checkNFC($string)>, C<$result =
19374 checkNFKD($string)>, C<$result = checkNFKC($string)>, C<$result =
19375 check($form_name, $string)>
19376
19377 =item Character Data
19378
19379 C<$canonical_decomposed = getCanon($codepoint)>,
19380 C<$compatibility_decomposed = getCompat($codepoint)>,
19381 C<$codepoint_composite = getComposite($codepoint_here, $codepoint_next)>,
19382 C<$combining_class = getCombinClass($codepoint)>, C<$is_exclusion =
19383 isExclusion($codepoint)>, C<$is_singleton = isSingleton($codepoint)>,
19384 C<$is_non_startar_decomposition = isNonStDecomp($codepoint)>,
19385 C<$may_be_composed_with_prev_char = isComp2nd($codepoint)>
19386
19387 =item EXPORT
19388
19389 =back
19390
19391 =item AUTHOR
19392
19393 =item SEE ALSO
19394
19395 http://www.unicode.org/unicode/reports/tr15/,
19396 http://www.unicode.org/Public/UNIDATA/DerivedNormalizationProps.txt
19397
19398 =back
19399
19400 =head2 Unicode::UCD - Unicode character database
19401
19402 =over 4
19403
19404 =item SYNOPSIS
19405
19406 =item DESCRIPTION
19407
19408 =back
19409
19410 =over 4
19411
19412 =item charinfo
19413
19414 =back
19415
19416 =over 4
19417
19418 =item charblock
19419
19420 =back
19421
19422 =over 4
19423
19424 =item charscript
19425
19426 =back
19427
19428 =over 4
19429
19430 =item charblocks
19431
19432 =back
19433
19434 =over 4
19435
19436 =item charscripts
19437
19438 =back
19439
19440 =over 4
19441
19442 =item Blocks versus Scripts
19443
19444 =item Matching Scripts and Blocks
19445
19446 =item Code Point Arguments
19447
19448 =item charinrange
19449
19450 =back
19451
19452 =over 4
19453
19454 =item compexcl
19455
19456 =back
19457
19458 =over 4
19459
19460 =item casefold
19461
19462 =back
19463
19464 =over 4
19465
19466 =item casespec
19467
19468 =back
19469
19470 =over 4
19471
19472 =item Unicode::UCD::UnicodeVersion
19473
19474 =back
19475
19476 =over 4
19477
19478 =item Implementation Note
19479
19480 =back
19481
19482 =over 4
19483
19484 =item BUGS
19485
19486 =item AUTHOR
19487
19488 =back
19489
19490 =head2 User::grent - by-name interface to Perl's built-in getgr*()
19491 functions
19492
19493 =over 4
19494
19495 =item SYNOPSIS
19496
19497 =item DESCRIPTION
19498
19499 =item NOTE
19500
19501 =item AUTHOR
19502
19503 =back
19504
19505 =head2 User::pwent - by-name interface to Perl's built-in getpw*()
19506 functions
19507
19508 =over 4
19509
19510 =item SYNOPSIS
19511
19512 =item DESCRIPTION
19513
19514 =over 4
19515
19516 =item System Specifics
19517
19518 =back
19519
19520 =item NOTE
19521
19522 =item AUTHOR
19523
19524 =item HISTORY
19525
19526 March 18th, 2000
19527
19528 =back
19529
19530 =head2 Win32 - Interfaces to some Win32 API Functions
19531
19532 =over 4
19533
19534 =item DESCRIPTION
19535
19536 =over 4
19537
19538 =item Alphabetical Listing of Win32 Functions
19539
19540 Win32::AbortSystemShutdown(MACHINE), Win32::BuildNumber(),
19541 Win32::CopyFile(FROM, TO, OVERWRITE), Win32::DomainName(),
19542 Win32::ExpandEnvironmentStrings(STRING), Win32::FormatMessage(ERRORCODE),
19543 Win32::FsType(), Win32::FreeLibrary(HANDLE), Win32::GetArchName(),
19544 Win32::GetChipName(), Win32::GetCwd(), Win32::GetFullPathName(FILENAME),
19545 Win32::GetLastError(), Win32::GetLongPathName(PATHNAME),
19546 Win32::GetNextAvailDrive(), Win32::GetOSVersion(), Win32::GetOSName(),
19547 Win32::GetShortPathName(PATHNAME), Win32::GetProcAddress(INSTANCE,
19548 PROCNAME), Win32::GetTickCount(), Win32::InitiateSystemShutdown,
19549 Win32::IsWinNT(), Win32::IsWin95(), Win32::LoadLibrary(LIBNAME),
19550 Win32::LoginName(), Win32::LookupAccountName(SYSTEM, ACCOUNT, DOMAIN, SID,
19551 SIDTYPE), Win32::LookupAccountSID(SYSTEM, SID, ACCOUNT, DOMAIN, SIDTYPE),
19552 Win32::MsgBox(MESSAGE [, FLAGS [, TITLE]]), Win32::NodeName(),
19553 Win32::RegisterServer(LIBRARYNAME), Win32::SetChildShowWindow(SHOWWINDOW),
19554 Win32::SetCwd(NEWDIRECTORY), Win32::SetLastError(ERROR),
19555 Win32::Sleep(TIME), Win32::Spawn(COMMAND, ARGS, PID),
19556 Win32::UnregisterServer(LIBRARYNAME)
19557
19558 =back
19559
19560 =back
19561
19562 =head2 XSLoader - Dynamically load C libraries into Perl code
19563
19564 =over 4
19565
19566 =item SYNOPSIS
19567
19568 =item DESCRIPTION
19569
19570 =item AUTHOR
19571
19572 =back
19573
19574 =head1 AUXILIARY DOCUMENTATION
19575
19576 Here should be listed all the extra programs' documentation, but they
19577 don't all have manual pages yet:
19578
19579 =over 4
19580
19581 =item a2p
19582
19583 =item s2p
19584
19585 =item find2perl
19586
19587 =item h2ph
19588
19589 =item c2ph
19590
19591 =item h2xs
19592
19593 =item xsubpp
19594
19595 =item pod2man
19596
19597 =item wrapsuid
19598
19599 =back
19600
19601 =head1 AUTHOR
19602
19603 Larry Wall <F<larry@wall.org>>, with the help of oodles
19604 of other folks.
19605