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