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 =item Passing Symbol Table Entries (typeglobs)
 352
 353 =item When to Still Use local()
 354
 355 =item Pass by Reference
 356
 357 =item Prototypes
 358
 359 =item Constant Functions
 360
 361 =item Overriding Built-in Functions
 362
 363 =item Autoloading
 364
 365 =item Subroutine Attributes
 366
 367 =back
 368
 369 =item SEE ALSO
 370
 371 =back
 372
 373 =head2 perlfunc - Perl builtin functions
 374
 375 =over 4
 376
 377 =item DESCRIPTION
 378
 379 =over 4
 380
 381 =item Perl Functions by Category
 382
 383 Functions for SCALARs or strings, Regular expressions and pattern matching,
 384 Numeric functions, Functions for real @ARRAYs, Functions for list data,
 385 Functions for real %HASHes, Input and output functions, Functions for fixed
 386 length data or records, Functions for filehandles, files, or directories,
 387 Keywords related to the control flow of your perl program, Keywords related
 388 to scoping, Miscellaneous functions, Functions for processes and process
 389 groups, Keywords related to perl modules, Keywords related to classes and
 390 object-orientedness, Low-level socket functions, System V interprocess
 391 communication functions, Fetching user and group info, Fetching network
 392 info, Time-related functions, Functions new in perl5, Functions obsoleted
 393 in perl5
 394
 395 =item Portability
 396
 397 =item Alphabetical Listing of Perl Functions
 398
 399 I<-X> FILEHANDLE, I<-X> EXPR, I<-X>, abs VALUE, abs, accept
 400 NEWSOCKET,GENERICSOCKET, alarm SECONDS, alarm, atan2 Y,X, bind SOCKET,NAME,
 401 binmode FILEHANDLE, DISCIPLINE, binmode FILEHANDLE, bless REF,CLASSNAME,
 402 bless REF, caller EXPR, caller, chdir EXPR, chmod LIST, chomp VARIABLE,
 403 chomp( LIST ), chomp, chop VARIABLE, chop( LIST ), chop, chown LIST, chr
 404 NUMBER, chr, chroot FILENAME, chroot, close FILEHANDLE, close, closedir
 405 DIRHANDLE, connect SOCKET,NAME, continue BLOCK, cos EXPR, cos, crypt
 406 PLAINTEXT,SALT, dbmclose HASH, dbmopen HASH,DBNAME,MASK, defined EXPR,
 407 defined, delete EXPR, die LIST, do BLOCK, do SUBROUTINE(LIST), do EXPR,
 408 dump LABEL, dump, each HASH, eof FILEHANDLE, eof (), eof, eval EXPR, eval
 409 BLOCK, exec LIST, exec PROGRAM LIST, exists EXPR, exit EXPR, exp EXPR, exp,
 410 fcntl FILEHANDLE,FUNCTION,SCALAR, fileno FILEHANDLE, flock
 411 FILEHANDLE,OPERATION, fork, format, formline PICTURE,LIST, getc FILEHANDLE,
 412 getc, getlogin, getpeername SOCKET, getpgrp PID, getppid, getpriority
 413 WHICH,WHO, getpwnam NAME, getgrnam NAME, gethostbyname NAME, getnetbyname
 414 NAME, getprotobyname NAME, getpwuid UID, getgrgid GID, getservbyname
 415 NAME,PROTO, gethostbyaddr ADDR,ADDRTYPE, getnetbyaddr ADDR,ADDRTYPE,
 416 getprotobynumber NUMBER, getservbyport PORT,PROTO, getpwent, getgrent,
 417 gethostent, getnetent, getprotoent, getservent, setpwent, setgrent,
 418 sethostent STAYOPEN, setnetent STAYOPEN, setprotoent STAYOPEN, setservent
 419 STAYOPEN, endpwent, endgrent, endhostent, endnetent, endprotoent,
 420 endservent, getsockname SOCKET, getsockopt SOCKET,LEVEL,OPTNAME, glob EXPR,
 421 glob, gmtime EXPR, goto LABEL, goto EXPR, goto &NAME, grep BLOCK LIST, grep
 422 EXPR,LIST, hex EXPR, hex, import, index STR,SUBSTR,POSITION, index
 423 STR,SUBSTR, int EXPR, int, ioctl FILEHANDLE,FUNCTION,SCALAR, join
 424 EXPR,LIST, keys HASH, kill SIGNAL, LIST, last LABEL, last, lc EXPR, lc,
 425 lcfirst EXPR, lcfirst, length EXPR, length, link OLDFILE,NEWFILE, listen
 426 SOCKET,QUEUESIZE, local EXPR, localtime EXPR, lock THING, log EXPR, log,
 427 lstat EXPR, lstat, m//, map BLOCK LIST, map EXPR,LIST, mkdir FILENAME,MASK,
 428 mkdir FILENAME, msgctl ID,CMD,ARG, msgget KEY,FLAGS, msgrcv
 429 ID,VAR,SIZE,TYPE,FLAGS, msgsnd ID,MSG,FLAGS, my EXPR, my EXPR : ATTRIBUTES,
 430 next LABEL, next, no Module VERSION LIST, no Module VERSION, no Module
 431 LIST, no Module, oct EXPR, oct, open FILEHANDLE,EXPR, open
 432 FILEHANDLE,MODE,EXPR, open FILEHANDLE,MODE,EXPR,LIST, open
 433 FILEHANDLE,MODE,REFERENCE, open FILEHANDLE, opendir DIRHANDLE,EXPR, ord
 434 EXPR, ord, our EXPR, our EXPR : ATTRIBUTES, pack TEMPLATE,LIST, package
 435 NAMESPACE, package, pipe READHANDLE,WRITEHANDLE, pop ARRAY, pop, pos
 436 SCALAR, pos, print FILEHANDLE LIST, print LIST, print, printf FILEHANDLE
 437 FORMAT, LIST, printf FORMAT, LIST, prototype FUNCTION, push ARRAY,LIST,
 438 q/STRING/, qq/STRING/, qr/STRING/, qx/STRING/, qw/STRING/, quotemeta EXPR,
 439 quotemeta, rand EXPR, rand, read FILEHANDLE,SCALAR,LENGTH,OFFSET, read
 440 FILEHANDLE,SCALAR,LENGTH, readdir DIRHANDLE, readline EXPR, readlink EXPR,
 441 readlink, readpipe EXPR, recv SOCKET,SCALAR,LENGTH,FLAGS, redo LABEL, redo,
 442 ref EXPR, ref, rename OLDNAME,NEWNAME, require VERSION, require EXPR,
 443 require, reset EXPR, reset, return EXPR, return, reverse LIST, rewinddir
 444 DIRHANDLE, rindex STR,SUBSTR,POSITION, rindex STR,SUBSTR, rmdir FILENAME,
 445 rmdir, s///, scalar EXPR, seek FILEHANDLE,POSITION,WHENCE, seekdir
 446 DIRHANDLE,POS, select FILEHANDLE, select, select RBITS,WBITS,EBITS,TIMEOUT,
 447 semctl ID,SEMNUM,CMD,ARG, semget KEY,NSEMS,FLAGS, semop KEY,OPSTRING, send
 448 SOCKET,MSG,FLAGS,TO, send SOCKET,MSG,FLAGS, setpgrp PID,PGRP, setpriority
 449 WHICH,WHO,PRIORITY, setsockopt SOCKET,LEVEL,OPTNAME,OPTVAL, shift ARRAY,
 450 shift, shmctl ID,CMD,ARG, shmget KEY,SIZE,FLAGS, shmread ID,VAR,POS,SIZE,
 451 shmwrite ID,STRING,POS,SIZE, shutdown SOCKET,HOW, sin EXPR, sin, sleep
 452 EXPR, sleep, socket SOCKET,DOMAIN,TYPE,PROTOCOL, socketpair
 453 SOCKET1,SOCKET2,DOMAIN,TYPE,PROTOCOL, sort SUBNAME LIST, sort BLOCK LIST,
 454 sort LIST, splice ARRAY,OFFSET,LENGTH,LIST, splice ARRAY,OFFSET,LENGTH,
 455 splice ARRAY,OFFSET, splice ARRAY, split /PATTERN/,EXPR,LIMIT, split
 456 /PATTERN/,EXPR, split /PATTERN/, split, sprintf FORMAT, LIST, sqrt EXPR,
 457 sqrt, srand EXPR, srand, stat FILEHANDLE, stat EXPR, stat, study SCALAR,
 458 study, sub BLOCK, sub NAME, sub NAME BLOCK, substr
 459 EXPR,OFFSET,LENGTH,REPLACEMENT, substr EXPR,OFFSET,LENGTH, substr
 460 EXPR,OFFSET, symlink OLDFILE,NEWFILE, syscall LIST, sysopen
 461 FILEHANDLE,FILENAME,MODE, sysopen FILEHANDLE,FILENAME,MODE,PERMS, sysread
 462 FILEHANDLE,SCALAR,LENGTH,OFFSET, sysread FILEHANDLE,SCALAR,LENGTH, sysseek
 463 FILEHANDLE,POSITION,WHENCE, system LIST, system PROGRAM LIST, syswrite
 464 FILEHANDLE,SCALAR,LENGTH,OFFSET, syswrite FILEHANDLE,SCALAR,LENGTH,
 465 syswrite FILEHANDLE,SCALAR, tell FILEHANDLE, tell, telldir DIRHANDLE, tie
 466 VARIABLE,CLASSNAME,LIST, tied VARIABLE, time, times, tr///, truncate
 467 FILEHANDLE,LENGTH, truncate EXPR,LENGTH, uc EXPR, uc, ucfirst EXPR,
 468 ucfirst, umask EXPR, umask, undef EXPR, undef, unlink LIST, unlink, unpack
 469 TEMPLATE,EXPR, untie VARIABLE, unshift ARRAY,LIST, use Module VERSION LIST,
 470 use Module VERSION, use Module LIST, use Module, use VERSION, utime LIST,
 471 values HASH, vec EXPR,OFFSET,BITS, wait, waitpid PID,FLAGS, wantarray, warn
 472 LIST, write FILEHANDLE, write EXPR, write, y///
 473
 474 =back
 475
 476 =back
 477
 478 =head2 perlreftut - Mark's very short tutorial about references
 479
 480 =over 4
 481
 482 =item DESCRIPTION
 483
 484 =item Who Needs Complicated Data Structures?
 485
 486 =item The Solution
 487
 488 =item Syntax
 489
 490 =over 4
 491
 492 =item Making References
 493
 494 =item Using References
 495
 496 =back
 497
 498 =item An Example
 499
 500 =item Arrow Rule
 501
 502 =item Solution
 503
 504 =item The Rest
 505
 506 =item Summary
 507
 508 =item Credits
 509
 510 =over 4
 511
 512 =item Distribution Conditions
 513
 514 =back
 515
 516 =back
 517
 518 =head2 perldsc - Perl Data Structures Cookbook
 519
 520 =over 4
 521
 522 =item DESCRIPTION
 523
 524 arrays of arrays, hashes of arrays, arrays of hashes, hashes of hashes,
 525 more elaborate constructs
 526
 527 =item REFERENCES
 528
 529 =item COMMON MISTAKES
 530
 531 =item CAVEAT ON PRECEDENCE
 532
 533 =item WHY YOU SHOULD ALWAYS C<use strict>
 534
 535 =item DEBUGGING
 536
 537 =item CODE EXAMPLES
 538
 539 =item ARRAYS OF ARRAYS
 540
 541 =over 4
 542
 543 =item Declaration of an ARRAY OF ARRAYS
 544
 545 =item Generation of an ARRAY OF ARRAYS
 546
 547 =item Access and Printing of an ARRAY OF ARRAYS
 548
 549 =back
 550
 551 =item HASHES OF ARRAYS
 552
 553 =over 4
 554
 555 =item Declaration of a HASH OF ARRAYS
 556
 557 =item Generation of a HASH OF ARRAYS
 558
 559 =item Access and Printing of a HASH OF ARRAYS
 560
 561 =back
 562
 563 =item ARRAYS OF HASHES
 564
 565 =over 4
 566
 567 =item Declaration of an ARRAY OF HASHES
 568
 569 =item Generation of an ARRAY OF HASHES
 570
 571 =item Access and Printing of an ARRAY OF HASHES
 572
 573 =back
 574
 575 =item HASHES OF HASHES
 576
 577 =over 4
 578
 579 =item Declaration of a HASH OF HASHES
 580
 581 =item Generation of a HASH OF HASHES
 582
 583 =item Access and Printing of a HASH OF HASHES
 584
 585 =back
 586
 587 =item MORE ELABORATE RECORDS
 588
 589 =over 4
 590
 591 =item Declaration of MORE ELABORATE RECORDS
 592
 593 =item Declaration of a HASH OF COMPLEX RECORDS
 594
 595 =item Generation of a HASH OF COMPLEX RECORDS
 596
 597 =back
 598
 599 =item Database Ties
 600
 601 =item SEE ALSO
 602
 603 =item AUTHOR
 604
 605 =back
 606
 607 =head2 perlrequick - Perl regular expressions quick start
 608
 609 =over 4
 610
 611 =item DESCRIPTION
 612
 613 =item The Guide
 614
 615 =over 4
 616
 617 =item Simple word matching
 618
 619 =item Using character classes
 620
 621 =item Matching this or that
 622
 623 =item Grouping things and hierarchical matching
 624
 625 =item Extracting matches
 626
 627 =item Matching repetitions
 628
 629 =item More matching
 630
 631 =item Search and replace
 632
 633 =item The split operator
 634
 635 =back
 636
 637 =item BUGS
 638
 639 =item SEE ALSO
 640
 641 =item AUTHOR AND COPYRIGHT
 642
 643 =over 4
 644
 645 =item Acknowledgments
 646
 647 =back
 648
 649 =back
 650
 651 =head2 perlpod - the Plain Old Documentation format
 652
 653 =over 4
 654
 655 =item DESCRIPTION
 656
 657 =over 4
 658
 659 =item Ordinary Paragraph
 660
 661 =item Verbatim Paragraph
 662
 663 =item Command Paragraph
 664
 665 C<=head1 I<Heading Text>>, C<=head2 I<Heading Text>>, C<=head3 I<Heading
 666 Text>>, C<=head4 I<Heading Text>>, C<=over I<indentlevel>>, C<=item
 667 I<stuff...>>, C<=back>, C<=cut>, C<=pod>, C<=begin I<formatname>>, C<=end
 668 I<formatname>>, C<=for I<formatname> I<text...>>
 669
 670 =item Formatting Codes
 671
 672 C<IE<lt>textE<gt>> -- italic text, C<BE<lt>textE<gt>> -- bold text,
 673 C<CE<lt>codeE<gt>> -- code text, C<LE<lt>nameE<gt>> -- a hyperlink,
 674 C<EE<lt>escapeE<gt>> -- a character escape, C<FE<lt>filenameE<gt>> -- used
 675 for filenames, C<SE<lt>textE<gt>> -- text contains non-breaking spaces,
 676 C<XE<lt>topic nameE<gt>> -- an index entry, C<ZE<lt>E<gt>> -- a null
 677 (zero-effect) formatting code
 678
 679 =item The Intent
 680
 681 =item Embedding Pods in Perl Modules
 682
 683 =item Hints for Writing Pod
 684
 685 =back
 686
 687 =item SEE ALSO
 688
 689 =item AUTHOR
 690
 691 =back
 692
 693 =head2 perlpodspec - Plain Old Documentation: format specification and
 694 notes
 695
 696 =over 4
 697
 698 =item DESCRIPTION
 699
 700 =item Pod Definitions
 701
 702 =item Pod Commands
 703
 704 "=head1", "=head2", "=head3", "=head4", "=pod", "=cut", "=over", "=item",
 705 "=back", "=begin formatname", "=end formatname", "=for formatname text..."
 706
 707 =item Pod Formatting Codes
 708
 709 C<IE<lt>textE<gt>> -- italic text, C<BE<lt>textE<gt>> -- bold text,
 710 C<CE<lt>codeE<gt>> -- code text, C<FE<lt>filenameE<gt>> -- style for
 711 filenames, C<XE<lt>topic nameE<gt>> -- an index entry, C<ZE<lt>E<gt>> -- a
 712 null (zero-effect) formatting code, C<LE<lt>nameE<gt>> -- a hyperlink,
 713 C<EE<lt>escapeE<gt>> -- a character escape, C<SE<lt>textE<gt>> -- text
 714 contains non-breaking spaces
 715
 716 =item Notes on Implementing Pod Processors
 717
 718 =item About LE<lt>...E<gt> Codes
 719
 720 First:, Second:, Third:, Fourth:, Fifth:, Sixth:
 721
 722 =item About =over...=back Regions
 723
 724 =item About Data Paragraphs and "=begin/=end" Regions
 725
 726 =item SEE ALSO
 727
 728 =item AUTHOR
 729
 730 =back
 731
 732 =head2 perlstyle - Perl style guide
 733
 734 =over 4
 735
 736 =item DESCRIPTION
 737
 738 =back
 739
 740 =head2 perltrap - Perl traps for the unwary
 741
 742 =over 4
 743
 744 =item DESCRIPTION
 745
 746 =over 4
 747
 748 =item Awk Traps
 749
 750 =item C Traps
 751
 752 =item Sed Traps
 753
 754 =item Shell Traps
 755
 756 =item Perl Traps
 757
 758 =item Perl4 to Perl5 Traps
 759
 760 Discontinuance, Deprecation, and BugFix traps, Parsing Traps, Numerical
 761 Traps, General data type traps, Context Traps - scalar, list contexts,
 762 Precedence Traps, General Regular Expression Traps using s///, etc,
 763 Subroutine, Signal, Sorting Traps, OS Traps, DBM Traps, Unclassified Traps
 764
 765 =item Discontinuance, Deprecation, and BugFix traps
 766
 767 Discontinuance, Deprecation, BugFix, Discontinuance, Discontinuance,
 768 Discontinuance, BugFix, Discontinuance, Discontinuance, BugFix,
 769 Discontinuance, Deprecation, Discontinuance, Discontinuance
 770
 771 =item Parsing Traps
 772
 773 Parsing, Parsing, Parsing, Parsing, Parsing
 774
 775 =item Numerical Traps
 776
 777 Numerical, Numerical, Numerical, Bitwise string ops
 778
 779 =item General data type traps
 780
 781 (Arrays), (Arrays), (Hashes), (Globs), (Globs), (Scalar String),
 782 (Constants), (Scalars), (Variable Suicide)
 783
 784 =item Context Traps - scalar, list contexts
 785
 786 (list context), (scalar context), (scalar context), (list, builtin)
 787
 788 =item Precedence Traps
 789
 790 Precedence, Precedence, Precedence, Precedence, Precedence, Precedence,
 791 Precedence
 792
 793 =item General Regular Expression Traps using s///, etc.
 794
 795 Regular Expression, Regular Expression, Regular Expression, Regular
 796 Expression, Regular Expression, Regular Expression, Regular Expression,
 797 Regular Expression
 798
 799 =item Subroutine, Signal, Sorting Traps
 800
 801 (Signals), (Sort Subroutine), warn() won't let you specify a filehandle
 802
 803 =item OS Traps
 804
 805 (SysV), (SysV)
 806
 807 =item Interpolation Traps
 808
 809 Interpolation, Interpolation, Interpolation, Interpolation, Interpolation,
 810 Interpolation, Interpolation, Interpolation, Interpolation
 811
 812 =item DBM Traps
 813
 814 DBM, DBM
 815
 816 =item Unclassified Traps
 817
 818 C<require>/C<do> trap using returned value, C<split> on empty string with
 819 LIMIT specified
 820
 821 =back
 822
 823 =back
 824
 825 =head2 perlrun - how to execute the Perl interpreter
 826
 827 =over 4
 828
 829 =item SYNOPSIS
 830
 831 =item DESCRIPTION
 832
 833 =over 4
 834
 835 =item #! and quoting on non-Unix systems
 836
 837 OS/2, MS-DOS, Win95/NT, Macintosh, VMS
 838
 839 =item Location of Perl
 840
 841 =item Command Switches
 842
 843 B<-0>[I<digits>], B<-a>, B<-C>, B<-c>, B<-d>, B<-d:>I<foo[=bar,baz]>,
 844 B<-D>I<letters>, B<-D>I<number>, B<-e> I<commandline>, B<-F>I<pattern>,
 845 B<-h>, B<-i>[I<extension>], B<-I>I<directory>, B<-l>[I<octnum>],
 846 B<-m>[B<->]I<module>, B<-M>[B<->]I<module>, B<-M>[B<->]I<'module ...'>,
 847 B<-[mM]>[B<->]I<module=arg[,arg]...>, B<-n>, B<-p>, B<-P>, B<-s>, B<-S>,
 848 B<-t>, B<-T>, B<-u>, B<-U>, B<-v>, B<-V>, B<-V:>I<name>, B<-w>, B<-W>,
 849 B<-X>, B<-x> I<directory>
 850
 851 =back
 852
 853 =item ENVIRONMENT
 854
 855 HOME, LOGDIR, PATH, PERL5LIB, PERL5OPT, PERLIO, :bytes, :crlf, :mmap,
 856 :perlio, :raw, :stdio, :unix, :utf8, :win32, PERLIO_DEBUG, PERLLIB,
 857 PERL5DB, PERL5SHELL (specific to the Win32 port), PERL_DEBUG_MSTATS,
 858 PERL_DESTRUCT_LEVEL, PERL_ENCODING, PERL_ROOT (specific to the VMS port),
 859 SYS$LOGIN (specific to the VMS port)
 860
 861 =back
 862
 863 =head2 perldiag - various Perl diagnostics
 864
 865 =over 4
 866
 867 =item DESCRIPTION
 868
 869 =back
 870
 871 =head2 perllexwarn - Perl Lexical Warnings
 872
 873 =over 4
 874
 875 =item DESCRIPTION
 876
 877 =over 4
 878
 879 =item Default Warnings and Optional Warnings
 880
 881 =item What's wrong with B<-w> and C<$^W>
 882
 883 =item Controlling Warnings from the Command Line
 884
 885 B<-w>, B<-W>, B<-X>
 886
 887 =item Backward Compatibility
 888
 889 =item Category Hierarchy
 890
 891 =item Fatal Warnings
 892
 893 =item Reporting Warnings from a Module
 894
 895 =back
 896
 897 =item TODO
 898
 899 =item SEE ALSO
 900
 901 =item AUTHOR
 902
 903 =back
 904
 905 =head2 perldebtut - Perl debugging tutorial
 906
 907 =over 4
 908
 909 =item DESCRIPTION
 910
 911 =item use strict
 912
 913 =item Looking at data and -w and v
 914
 915 =item help
 916
 917 =item Stepping through code
 918
 919 =item Placeholder for a, w, t, T
 920
 921 =item REGULAR EXPRESSIONS
 922
 923 =item OUTPUT TIPS
 924
 925 =item CGI
 926
 927 =item GUIs
 928
 929 =item SUMMARY
 930
 931 =item SEE ALSO
 932
 933 =item AUTHOR
 934
 935 =item CONTRIBUTORS
 936
 937 =back
 938
 939 =head2 perldebug - Perl debugging
 940
 941 =over 4
 942
 943 =item DESCRIPTION
 944
 945 =item The Perl Debugger
 946
 947 =over 4
 948
 949 =item Debugger Commands
 950
 951 h, h [command], h h, p expr, x [maxdepth] expr, V [pkg [vars]], X [vars], y
 952 [level [vars]], T, s [expr], n [expr], r, <CR>, c [line|sub], l, l
 953 min+incr, l min-max, l line, l subname, -, v [line], f filename, /pattern/,
 954 ?pattern?, L [abw], S [[!]regex], t, t expr, b, b [line] [condition], b
 955 subname [condition], b postpone subname [condition], b load filename, b
 956 compile subname, B line, B *, a [line] command, A line, A *, w expr, W
 957 expr, W *, o, o booloption .., o anyoption? .., o option=value .., < ?, < [
 958 command ], << command, > ?, > command, >> command, { ?, { [ command ], {{
 959 command, ! number, ! -number, ! pattern, !! cmd, @ file, H -number, q or
 960 ^D, R, |dbcmd, ||dbcmd, command, m expr, M, man [manpage]
 961
 962 =item Configurable Options
 963
 964 C<recallCommand>, C<ShellBang>, C<pager>, C<tkRunning>, C<signalLevel>,
 965 C<warnLevel>, C<dieLevel>, C<AutoTrace>, C<LineInfo>, C<inhibit_exit>,
 966 C<PrintRet>, C<ornaments>, C<frame>, C<maxTraceLen>, C<windowSize>,
 967 C<arrayDepth>, C<hashDepth>, C<dumpDepth>, C<compactDump>, C<veryCompact>,
 968 C<globPrint>, C<DumpDBFiles>, C<DumpPackages>, C<DumpReused>, C<quote>,
 969 C<HighBit>, C<undefPrint>, C<UsageOnly>, C<TTY>, C<noTTY>, C<ReadLine>,
 970 C<NonStop>
 971
 972 =item Debugger input/output
 973
 974 Prompt, Multiline commands, Stack backtrace, Line Listing Format, Frame
 975 listing
 976
 977 =item Debugging compile-time statements
 978
 979 =item Debugger Customization
 980
 981 =item Readline Support
 982
 983 =item Editor Support for Debugging
 984
 985 =item The Perl Profiler
 986
 987 =back
 988
 989 =item Debugging regular expressions
 990
 991 =item Debugging memory usage
 992
 993 =item SEE ALSO
 994
 995 =item BUGS
 996
 997 =back
 998
 999 =head2 perlvar - Perl predefined variables
1000
1001 =over 4
1002
1003 =item DESCRIPTION
1004
1005 =over 4
1006
1007 =item Predefined Names
1008
1009 $ARG, $_, $a, $b, $<I<digits>>, $MATCH, $&, $PREMATCH, $`, $POSTMATCH, $',
1010 $LAST_PAREN_MATCH, $+, $^N, @LAST_MATCH_END, @+, $MULTILINE_MATCHING, $*,
1011 HANDLE->input_line_number(EXPR), $INPUT_LINE_NUMBER, $NR, $,
1012 IO::Handle->input_record_separator(EXPR), $INPUT_RECORD_SEPARATOR, $RS, $/,
1013 HANDLE->autoflush(EXPR), $OUTPUT_AUTOFLUSH, $|,
1014 IO::Handle->output_field_separator EXPR, $OUTPUT_FIELD_SEPARATOR, $OFS, $,,
1015 IO::Handle->output_record_separator EXPR, $OUTPUT_RECORD_SEPARATOR, $ORS,
1016 $\, $LIST_SEPARATOR, $", $SUBSCRIPT_SEPARATOR, $SUBSEP, $;, $OFMT, $#,
1017 HANDLE->format_page_number(EXPR), $FORMAT_PAGE_NUMBER, $%,
1018 HANDLE->format_lines_per_page(EXPR), $FORMAT_LINES_PER_PAGE, $=,
1019 HANDLE->format_lines_left(EXPR), $FORMAT_LINES_LEFT, $-, @LAST_MATCH_START,
1020 @-, C<$`> is the same as C<substr($var, 0, $-[0])>, C<$&> is the same as
1021 C<substr($var, $-[0], $+[0] - $-[0])>, C<$'> is the same as C<substr($var,
1022 $+[0])>, C<$1> is the same as C<substr($var, $-[1], $+[1] - $-[1])>, C<$2>
1023 is the same as C<substr($var, $-[2], $+[2] - $-[2])>, C<$3> is the same as
1024 C<substr $var, $-[3], $+[3] - $-[3])>, HANDLE->format_name(EXPR),
1025 $FORMAT_NAME, $~, HANDLE->format_top_name(EXPR), $FORMAT_TOP_NAME, $^,
1026 IO::Handle->format_line_break_characters EXPR,
1027 $FORMAT_LINE_BREAK_CHARACTERS, $:, IO::Handle->format_formfeed EXPR,
1028 $FORMAT_FORMFEED, $^L, $ACCUMULATOR, $^A, $CHILD_ERROR, $?, ${^ENCODING},
1029 $OS_ERROR, $ERRNO, $!, %!, $EXTENDED_OS_ERROR, $^E, $EVAL_ERROR, $@,
1030 $PROCESS_ID, $PID, $$, $REAL_USER_ID, $UID, $<, $EFFECTIVE_USER_ID, $EUID,
1031 $>, $REAL_GROUP_ID, $GID, $(, $EFFECTIVE_GROUP_ID, $EGID, $),
1032 $PROGRAM_NAME, $0, $[, $], $COMPILING, $^C, $DEBUGGING, $^D,
1033 $SYSTEM_FD_MAX, $^F, $^H, %^H, $INPLACE_EDIT, $^I, $^M, $OSNAME, $^O,
1034 ${^OPEN}, $PERLDB, $^P, 0x01, 0x02, 0x04, 0x08, 0x10, 0x20, 0x40, 0x80,
1035 0x100, 0x200, $LAST_REGEXP_CODE_RESULT, $^R, $EXCEPTIONS_BEING_CAUGHT, $^S,
1036 $BASETIME, $^T, ${^TAINT}, $PERL_VERSION, $^V, $WARNING, $^W,
1037 ${^WARNING_BITS}, ${^WIDE_SYSTEM_CALLS}, $EXECUTABLE_NAME, $^X, ARGV,
1038 $ARGV, @ARGV, @F, @INC, @_, %INC, %ENV, $ENV{expr}, %SIG, $SIG{expr}
1039
1040 =item Error Indicators
1041
1042 =item Technical Note on the Syntax of Variable Names
1043
1044 =back
1045
1046 =item BUGS
1047
1048 =back
1049
1050 =head2 perllol - Manipulating Arrays of Arrays in Perl
1051
1052 =over 4
1053
1054 =item DESCRIPTION
1055
1056 =over 4
1057
1058 =item Declaration and Access of Arrays of Arrays
1059
1060 =item Growing Your Own
1061
1062 =item Access and Printing
1063
1064 =item Slices
1065
1066 =back
1067
1068 =item SEE ALSO
1069
1070 =item AUTHOR
1071
1072 =back
1073
1074 =head2 perlopentut - tutorial on opening things in Perl
1075
1076 =over 4
1077
1078 =item DESCRIPTION
1079
1080 =item Open E<agrave> la shell
1081
1082 =over 4
1083
1084 =item Simple Opens
1085
1086 =item Pipe Opens
1087
1088 =item The Minus File
1089
1090 =item Mixing Reads and Writes
1091
1092 =item Filters
1093
1094 =back
1095
1096 =item Open E<agrave> la C
1097
1098 =over 4
1099
1100 =item Permissions E<agrave> la mode
1101
1102 =back
1103
1104 =item Obscure Open Tricks
1105
1106 =over 4
1107
1108 =item Re-Opening Files (dups)
1109
1110 =item Dispelling the Dweomer
1111
1112 =item Paths as Opens
1113
1114 =item Single Argument Open
1115
1116 =item Playing with STDIN and STDOUT
1117
1118 =back
1119
1120 =item Other I/O Issues
1121
1122 =over 4
1123
1124 =item Opening Non-File Files
1125
1126 =item Binary Files
1127
1128 =item File Locking
1129
1130 =back
1131
1132 =item SEE ALSO
1133
1134 =item AUTHOR and COPYRIGHT
1135
1136 =item HISTORY
1137
1138 =back
1139
1140 =head2 perlpacktut - tutorial on C<pack> and C<unpack>
1141
1142 =over 4
1143
1144 =item DESCRIPTION
1145
1146 =item The Basic Principle
1147
1148 =item Packing Text
1149
1150 =item Packing Numbers
1151
1152 =over 4
1153
1154 =item Integers
1155
1156 =item Unpacking a Stack Frame
1157
1158 =item How to Eat an Egg on a Net
1159
1160 =item Floating point Numbers
1161
1162 =back
1163
1164 =item Exotic Templates
1165
1166 =over 4
1167
1168 =item Bit Strings
1169
1170 =item Uuencoding
1171
1172 =item Doing Sums
1173
1174 =item  Unicode
1175
1176 =item Another Portable Binary Encoding
1177
1178 =back
1179
1180 =item Lengths and Widths
1181
1182 =over 4
1183
1184 =item String Lengths
1185
1186 =item Dynamic Templates
1187
1188 =back
1189
1190 =item Packing and Unpacking C Structures
1191
1192 =over 4
1193
1194 =item The Alignment Pit
1195
1196 =item Alignment, Take 2
1197
1198 =item Alignment, Take 3
1199
1200 =item Pointers for How to Use Them
1201
1202 =back
1203
1204 =item Pack Recipes
1205
1206 =item Funnies Section
1207
1208 =item Authors
1209
1210 =back
1211
1212 =head2 perlretut - Perl regular expressions tutorial
1213
1214 =over 4
1215
1216 =item DESCRIPTION
1217
1218 =item Part 1: The basics
1219
1220 =over 4
1221
1222 =item Simple word matching
1223
1224 =item Using character classes
1225
1226 =item Matching this or that
1227
1228 =item Grouping things and hierarchical matching
1229
1230 =item Extracting matches
1231
1232 =item Matching repetitions
1233
1234 =item Building a regexp
1235
1236 =item Using regular expressions in Perl
1237
1238 =back
1239
1240 =item Part 2: Power tools
1241
1242 =over 4
1243
1244 =item More on characters, strings, and character classes
1245
1246 =item Compiling and saving regular expressions
1247
1248 =item Embedding comments and modifiers in a regular expression
1249
1250 =item Non-capturing groupings
1251
1252 =item Looking ahead and looking behind
1253
1254 =item Using independent subexpressions to prevent backtracking
1255
1256 =item Conditional expressions
1257
1258 =item A bit of magic: executing Perl code in a regular expression
1259
1260 =item Pragmas and debugging
1261
1262 =back
1263
1264 =item BUGS
1265
1266 =item SEE ALSO
1267
1268 =item AUTHOR AND COPYRIGHT
1269
1270 =over 4
1271
1272 =item Acknowledgments
1273
1274 =back
1275
1276 =back
1277
1278 =head2 perlre - Perl regular expressions
1279
1280 =over 4
1281
1282 =item DESCRIPTION
1283
1284 i, m, s, x
1285
1286 =over 4
1287
1288 =item Regular Expressions
1289
1290 [1], [2], [3], cntrl, graph, print, punct, xdigit
1291
1292 =item Extended Patterns
1293
1294 C<(?#text)>, C<(?imsx-imsx)>, C<(?:pattern)>, C<(?imsx-imsx:pattern)>,
1295 C<(?=pattern)>, C<(?!pattern)>, C<(?<=pattern)>, C<(?<!pattern)>, C<(?{
1296 code })>, C<(??{ code })>, C<< (?>pattern) >>,
1297 C<(?(condition)yes-pattern|no-pattern)>, C<(?(condition)yes-pattern)>
1298
1299 =item Backtracking
1300
1301 =item Version 8 Regular Expressions
1302
1303 =item Warning on \1 vs $1
1304
1305 =item Repeated patterns matching zero-length substring
1306
1307 =item Combining pieces together
1308
1309 C<ST>, C<S|T>, C<S{REPEAT_COUNT}>, C<S{min,max}>, C<S{min,max}?>, C<S?>,
1310 C<S*>, C<S+>, C<S??>, C<S*?>, C<S+?>, C<< (?>S) >>, C<(?=S)>, C<(?<=S)>,
1311 C<(?!S)>, C<(?<!S)>, C<(??{ EXPR })>,
1312 C<(?(condition)yes-pattern|no-pattern)>
1313
1314 =item Creating custom RE engines
1315
1316 =back
1317
1318 =item BUGS
1319
1320 =item SEE ALSO
1321
1322 =back
1323
1324 =head2 perlref - Perl references and nested data structures
1325
1326 =over 4
1327
1328 =item NOTE
1329
1330 =item DESCRIPTION
1331
1332 =over 4
1333
1334 =item Making References
1335
1336 =item Using References
1337
1338 =item Symbolic references
1339
1340 =item Not-so-symbolic references
1341
1342 =item Pseudo-hashes: Using an array as a hash
1343
1344 =item Function Templates
1345
1346 =back
1347
1348 =item WARNING
1349
1350 =item SEE ALSO
1351
1352 =back
1353
1354 =head2 perlform - Perl formats
1355
1356 =over 4
1357
1358 =item DESCRIPTION
1359
1360 =over 4
1361
1362 =item Format Variables
1363
1364 =back
1365
1366 =item NOTES
1367
1368 =over 4
1369
1370 =item Footers
1371
1372 =item Accessing Formatting Internals
1373
1374 =back
1375
1376 =item WARNINGS
1377
1378 =back
1379
1380 =head2 perlboot - Beginner's Object-Oriented Tutorial
1381
1382 =over 4
1383
1384 =item DESCRIPTION
1385
1386 =over 4
1387
1388 =item If we could talk to the animals...
1389
1390 =item Introducing the method invocation arrow
1391
1392 =item Invoking a barnyard
1393
1394 =item The extra parameter of method invocation
1395
1396 =item Calling a second method to simplify things
1397
1398 =item Inheriting the windpipes
1399
1400 =item A few notes about @ISA
1401
1402 =item Overriding the methods
1403
1404 =item Starting the search from a different place
1405
1406 =item The SUPER way of doing things
1407
1408 =item Where we're at so far...
1409
1410 =item A horse is a horse, of course of course -- or is it?
1411
1412 =item Invoking an instance method
1413
1414 =item Accessing the instance data
1415
1416 =item How to build a horse
1417
1418 =item Inheriting the constructor
1419
1420 =item Making a method work with either classes or instances
1421
1422 =item Adding parameters to a method
1423
1424 =item More interesting instances
1425
1426 =item A horse of a different color
1427
1428 =item Summary
1429
1430 =back
1431
1432 =item SEE ALSO
1433
1434 =item COPYRIGHT
1435
1436 =back
1437
1438 =head2 perltoot - Tom's object-oriented tutorial for perl
1439
1440 =over 4
1441
1442 =item DESCRIPTION
1443
1444 =item Creating a Class
1445
1446 =over 4
1447
1448 =item Object Representation
1449
1450 =item Class Interface
1451
1452 =item Constructors and Instance Methods
1453
1454 =item Planning for the Future: Better Constructors
1455
1456 =item Destructors
1457
1458 =item Other Object Methods
1459
1460 =back
1461
1462 =item Class Data
1463
1464 =over 4
1465
1466 =item Accessing Class Data
1467
1468 =item Debugging Methods
1469
1470 =item Class Destructors
1471
1472 =item Documenting the Interface
1473
1474 =back
1475
1476 =item Aggregation
1477
1478 =item Inheritance
1479
1480 =over 4
1481
1482 =item Overridden Methods
1483
1484 =item Multiple Inheritance
1485
1486 =item UNIVERSAL: The Root of All Objects
1487
1488 =back
1489
1490 =item Alternate Object Representations
1491
1492 =over 4
1493
1494 =item Arrays as Objects
1495
1496 =item Closures as Objects
1497
1498 =back
1499
1500 =item AUTOLOAD: Proxy Methods
1501
1502 =over 4
1503
1504 =item Autoloaded Data Methods
1505
1506 =item Inherited Autoloaded Data Methods
1507
1508 =back
1509
1510 =item Metaclassical Tools
1511
1512 =over 4
1513
1514 =item Class::Struct
1515
1516 =item Data Members as Variables
1517
1518 =back
1519
1520 =item NOTES
1521
1522 =over 4
1523
1524 =item Object Terminology
1525
1526 =back
1527
1528 =item SEE ALSO
1529
1530 =item AUTHOR AND COPYRIGHT
1531
1532 =item COPYRIGHT
1533
1534 =over 4
1535
1536 =item Acknowledgments
1537
1538 =back
1539
1540 =back
1541
1542 =head2 perltooc - Tom's OO Tutorial for Class Data in Perl
1543
1544 =over 4
1545
1546 =item DESCRIPTION
1547
1548 =item Class Data in a Can
1549
1550 =item Class Data as Package Variables
1551
1552 =over 4
1553
1554 =item Putting All Your Eggs in One Basket
1555
1556 =item Inheritance Concerns
1557
1558 =item The Eponymous Meta-Object
1559
1560 =item Indirect References to Class Data
1561
1562 =item Monadic Classes
1563
1564 =item Translucent Attributes
1565
1566 =back
1567
1568 =item Class Data as Lexical Variables
1569
1570 =over 4
1571
1572 =item Privacy and Responsibility
1573
1574 =item File-Scoped Lexicals
1575
1576 =item More Inheritance Concerns
1577
1578 =item Locking the Door and Throwing Away the Key
1579
1580 =item Translucency Revisited
1581
1582 =back
1583
1584 =item NOTES
1585
1586 =item SEE ALSO
1587
1588 =item AUTHOR AND COPYRIGHT
1589
1590 =item ACKNOWLEDGEMENTS
1591
1592 =item HISTORY
1593
1594 =back
1595
1596 =head2 perlobj - Perl objects
1597
1598 =over 4
1599
1600 =item DESCRIPTION
1601
1602 =over 4
1603
1604 =item An Object is Simply a Reference
1605
1606 =item A Class is Simply a Package
1607
1608 =item A Method is Simply a Subroutine
1609
1610 =item Method Invocation
1611
1612 =item Indirect Object Syntax
1613
1614 =item Default UNIVERSAL methods
1615
1616 isa(CLASS), can(METHOD), VERSION( [NEED] )
1617
1618 =item Destructors
1619
1620 =item Summary
1621
1622 =item Two-Phased Garbage Collection
1623
1624 =back
1625
1626 =item SEE ALSO
1627
1628 =back
1629
1630 =head2 perlbot - Bag'o Object Tricks (the BOT)
1631
1632 =over 4
1633
1634 =item DESCRIPTION
1635
1636 =item OO SCALING TIPS
1637
1638 =item INSTANCE VARIABLES
1639
1640 =item SCALAR INSTANCE VARIABLES
1641
1642 =item INSTANCE VARIABLE INHERITANCE
1643
1644 =item OBJECT RELATIONSHIPS
1645
1646 =item OVERRIDING SUPERCLASS METHODS
1647
1648 =item USING RELATIONSHIP WITH SDBM
1649
1650 =item THINKING OF CODE REUSE
1651
1652 =item CLASS CONTEXT AND THE OBJECT
1653
1654 =item INHERITING A CONSTRUCTOR
1655
1656 =item DELEGATION
1657
1658 =back
1659
1660 =head2 perltie - how to hide an object class in a simple variable
1661
1662 =over 4
1663
1664 =item SYNOPSIS
1665
1666 =item DESCRIPTION
1667
1668 =over 4
1669
1670 =item Tying Scalars
1671
1672 TIESCALAR classname, LIST, FETCH this, STORE this, value, UNTIE this,
1673 DESTROY this
1674
1675 =item Tying Arrays
1676
1677 TIEARRAY classname, LIST, FETCH this, index, STORE this, index, value,
1678 FETCHSIZE this, STORESIZE this, count, EXTEND this, count, EXISTS this,
1679 key, DELETE this, key, CLEAR this, PUSH this, LIST, POP this, SHIFT this,
1680 UNSHIFT this, LIST, SPLICE this, offset, length, LIST, UNTIE this, DESTROY
1681 this
1682
1683 =item Tying Hashes
1684
1685 USER, HOME, CLOBBER, LIST, TIEHASH classname, LIST, FETCH this, key, STORE
1686 this, key, value, DELETE this, key, CLEAR this, EXISTS this, key, FIRSTKEY
1687 this, NEXTKEY this, lastkey, UNTIE this, DESTROY this
1688
1689 =item Tying FileHandles
1690
1691 TIEHANDLE classname, LIST, WRITE this, LIST, PRINT this, LIST, PRINTF this,
1692 LIST, READ this, LIST, READLINE this, GETC this, CLOSE this, UNTIE this,
1693 DESTROY this
1694
1695 =item UNTIE this
1696
1697 =item The C<untie> Gotcha
1698
1699 =back
1700
1701 =item SEE ALSO
1702
1703 =item BUGS
1704
1705 =item AUTHOR
1706
1707 =back
1708
1709 =head2 perlipc - Perl interprocess communication (signals, fifos, pipes,
1710 safe subprocesses, sockets, and semaphores)
1711
1712 =over 4
1713
1714 =item DESCRIPTION
1715
1716 =item Signals
1717
1718 =item Named Pipes
1719
1720 =over 4
1721
1722 =item WARNING
1723
1724 =back
1725
1726 =item Using open() for IPC
1727
1728 =over 4
1729
1730 =item Filehandles
1731
1732 =item Background Processes
1733
1734 =item Complete Dissociation of Child from Parent
1735
1736 =item Safe Pipe Opens
1737
1738 =item Bidirectional Communication with Another Process
1739
1740 =item Bidirectional Communication with Yourself
1741
1742 =back
1743
1744 =item Sockets: Client/Server Communication
1745
1746 =over 4
1747
1748 =item Internet Line Terminators
1749
1750 =item Internet TCP Clients and Servers
1751
1752 =item Unix-Domain TCP Clients and Servers
1753
1754 =back
1755
1756 =item TCP Clients with IO::Socket
1757
1758 =over 4
1759
1760 =item A Simple Client
1761
1762 C<Proto>, C<PeerAddr>, C<PeerPort>
1763
1764 =item A Webget Client
1765
1766 =item Interactive Client with IO::Socket
1767
1768 =back
1769
1770 =item TCP Servers with IO::Socket
1771
1772 Proto, LocalPort, Listen, Reuse
1773
1774 =item UDP: Message Passing
1775
1776 =item SysV IPC
1777
1778 =item NOTES
1779
1780 =item BUGS
1781
1782 =item AUTHOR
1783
1784 =item SEE ALSO
1785
1786 =back
1787
1788 =head2 perlfork - Perl's fork() emulation (EXPERIMENTAL, subject to change)
1789
1790 =over 4
1791
1792 =item SYNOPSIS
1793
1794 =item DESCRIPTION
1795
1796 =over 4
1797
1798 =item Behavior of other Perl features in forked pseudo-processes
1799
1800 $$ or $PROCESS_ID, %ENV, chdir() and all other builtins that accept
1801 filenames, wait() and waitpid(), kill(), exec(), exit(), Open handles to
1802 files, directories and network sockets
1803
1804 =item Resource limits
1805
1806 =item Killing the parent process
1807
1808 =item Lifetime of the parent process and pseudo-processes
1809
1810 =item CAVEATS AND LIMITATIONS
1811
1812 BEGIN blocks, Open filehandles, Forking pipe open() not yet implemented,
1813 Global state maintained by XSUBs, Interpreter embedded in larger
1814 application, Thread-safety of extensions
1815
1816 =back
1817
1818 =item BUGS
1819
1820 =item AUTHOR
1821
1822 =item SEE ALSO
1823
1824 =back
1825
1826 =head2 perlnumber - semantics of numbers and numeric operations in Perl
1827
1828 =over 4
1829
1830 =item SYNOPSIS
1831
1832 =item DESCRIPTION
1833
1834 =item Storing numbers
1835
1836 =item Numeric operators and numeric conversions
1837
1838 =item Flavors of Perl numeric operations
1839
1840 Arithmetic operators except, C<no integer>, Arithmetic operators except,
1841 C<use integer>, Bitwise operators, C<no integer>, Bitwise operators, C<use
1842 integer>, Operators which expect an integer, Operators which expect a
1843 string
1844
1845 =item AUTHOR
1846
1847 =item SEE ALSO
1848
1849 =back
1850
1851 =head2 perlthrtut - tutorial on threads in Perl
1852
1853 =over 4
1854
1855 =item DESCRIPTION
1856
1857 =item Status
1858
1859 =item What Is A Thread Anyway?
1860
1861 =item Threaded Program Models
1862
1863 =over 4
1864
1865 =item Boss/Worker
1866
1867 =item Work Crew
1868
1869 =item Pipeline
1870
1871 =back
1872
1873 =item Native threads
1874
1875 =item What kind of threads are Perl threads?
1876
1877 =item Threadsafe Modules
1878
1879 =item Thread Basics
1880
1881 =over 4
1882
1883 =item Basic Thread Support
1884
1885 =item Creating Threads
1886
1887 =item Giving up control
1888
1889 =item Waiting For A Thread To Exit
1890
1891 =item Ignoring A Thread
1892
1893 =back
1894
1895 =item Threads And Data
1896
1897 =over 4
1898
1899 =item Shared And Unshared Data
1900
1901 =item Thread Pitfalls: Races
1902
1903 =back
1904
1905 =item Synchronization and control
1906
1907 =over 4
1908
1909 =item Controlling access: lock()
1910
1911 =item A Thread Pitfall: Deadlocks
1912
1913 =item Queues: Passing Data Around
1914
1915 =item Semaphores: Synchronizing Data Access
1916
1917 =item Basic semaphores
1918
1919 =item Advanced Semaphores
1920
1921 =item cond_wait() and cond_signal()
1922
1923 =back
1924
1925 =item General Thread Utility Routines
1926
1927 =over 4
1928
1929 =item What Thread Am I In?
1930
1931 =item Thread IDs
1932
1933 =item Are These Threads The Same?
1934
1935 =item What Threads Are Running?
1936
1937 =back
1938
1939 =item A Complete Example
1940
1941 =item Performance considerations
1942
1943 =item Conclusion
1944
1945 =item Bibliography
1946
1947 =over 4
1948
1949 =item Introductory Texts
1950
1951 =item OS-Related References
1952
1953 =item Other References
1954
1955 =back
1956
1957 =item Acknowledgements
1958
1959 =item AUTHOR
1960
1961 =item Copyrights
1962
1963 =back
1964
1965 =head2 perlothrtut - old tutorial on threads in Perl
1966
1967 =over 4
1968
1969 =item DESCRIPTION
1970
1971 =item What Is A Thread Anyway?
1972
1973 =item Threaded Program Models
1974
1975 =over 4
1976
1977 =item Boss/Worker
1978
1979 =item Work Crew
1980
1981 =item Pipeline
1982
1983 =back
1984
1985 =item Native threads
1986
1987 =item What kind of threads are perl threads?
1988
1989 =item Threadsafe Modules
1990
1991 =item Thread Basics
1992
1993 =over 4
1994
1995 =item Basic Thread Support
1996
1997 =item Creating Threads
1998
1999 =item Giving up control
2000
2001 =item Waiting For A Thread To Exit
2002
2003 =item Errors In Threads
2004
2005 =item Ignoring A Thread
2006
2007 =back
2008
2009 =item Threads And Data
2010
2011 =over 4
2012
2013 =item Shared And Unshared Data
2014
2015 =item Thread Pitfall: Races
2016
2017 =item Controlling access: lock()
2018
2019 =item Thread Pitfall: Deadlocks
2020
2021 =item Queues: Passing Data Around
2022
2023 =back
2024
2025 =item Threads And Code
2026
2027 =over 4
2028
2029 =item Semaphores: Synchronizing Data Access
2030
2031 Basic semaphores, Advanced Semaphores
2032
2033 =item Attributes: Restricting Access To Subroutines
2034
2035 =item Subroutine Locks
2036
2037 =item Methods
2038
2039 =item Locking A Subroutine
2040
2041 =back
2042
2043 =item General Thread Utility Routines
2044
2045 =over 4
2046
2047 =item What Thread Am I In?
2048
2049 =item Thread IDs
2050
2051 =item Are These Threads The Same?
2052
2053 =item What Threads Are Running?
2054
2055 =back
2056
2057 =item A Complete Example
2058
2059 =item Conclusion
2060
2061 =item Bibliography
2062
2063 =over 4
2064
2065 =item Introductory Texts
2066
2067 =item OS-Related References
2068
2069 =item Other References
2070
2071 =back
2072
2073 =item Acknowledgements
2074
2075 =item AUTHOR
2076
2077 =item Copyrights
2078
2079 =back
2080
2081 =head2 perlport - Writing portable Perl
2082
2083 =over 4
2084
2085 =item DESCRIPTION
2086
2087 Not all Perl programs have to be portable, Nearly all of Perl already I<is>
2088 portable
2089
2090 =item ISSUES
2091
2092 =over 4
2093
2094 =item Newlines
2095
2096 =item Numbers endianness and Width
2097
2098 =item Files and Filesystems
2099
2100 =item System Interaction
2101
2102 =item Interprocess Communication (IPC)
2103
2104 =item External Subroutines (XS)
2105
2106 =item Standard Modules
2107
2108 =item Time and Date
2109
2110 =item Character sets and character encoding
2111
2112 =item Internationalisation
2113
2114 =item System Resources
2115
2116 =item Security
2117
2118 =item Style
2119
2120 =back
2121
2122 =item CPAN Testers
2123
2124 Mailing list: cpan-testers@perl.org, Testing results:
2125 http://testers.cpan.org/
2126
2127 =item PLATFORMS
2128
2129 =over 4
2130
2131 =item Unix
2132
2133 =item DOS and Derivatives
2134
2135 =item S<Mac OS>
2136
2137 =item VMS
2138
2139 =item VOS
2140
2141 =item EBCDIC Platforms
2142
2143 =item Acorn RISC OS
2144
2145 =item Other perls
2146
2147 =back
2148
2149 =item FUNCTION IMPLEMENTATIONS
2150
2151 =over 4
2152
2153 =item Alphabetical Listing of Perl Functions
2154
2155 -I<X> FILEHANDLE, -I<X> EXPR, -I<X>, alarm SECONDS, alarm, binmode
2156 FILEHANDLE, chmod LIST, chown LIST, chroot FILENAME, chroot, crypt
2157 PLAINTEXT,SALT, dbmclose HASH, dbmopen HASH,DBNAME,MODE, dump LABEL, exec
2158 LIST, exit EXPR, exit, fcntl FILEHANDLE,FUNCTION,SCALAR, flock
2159 FILEHANDLE,OPERATION, fork, getlogin, getpgrp PID, getppid, getpriority
2160 WHICH,WHO, getpwnam NAME, getgrnam NAME, getnetbyname NAME, getpwuid UID,
2161 getgrgid GID, getnetbyaddr ADDR,ADDRTYPE, getprotobynumber NUMBER,
2162 getservbyport PORT,PROTO, getpwent, getgrent, gethostent, getnetent,
2163 getprotoent, getservent, sethostent STAYOPEN, setnetent STAYOPEN,
2164 setprotoent STAYOPEN, setservent STAYOPEN, endpwent, endgrent, endhostent,
2165 endnetent, endprotoent, endservent, getsockopt SOCKET,LEVEL,OPTNAME, glob
2166 EXPR, glob, ioctl FILEHANDLE,FUNCTION,SCALAR, kill SIGNAL, LIST, link
2167 OLDFILE,NEWFILE, lstat FILEHANDLE, lstat EXPR, lstat, msgctl ID,CMD,ARG,
2168 msgget KEY,FLAGS, msgsnd ID,MSG,FLAGS, msgrcv ID,VAR,SIZE,TYPE,FLAGS, open
2169 FILEHANDLE,EXPR, open FILEHANDLE, pipe READHANDLE,WRITEHANDLE, readlink
2170 EXPR, readlink, select RBITS,WBITS,EBITS,TIMEOUT, semctl ID,SEMNUM,CMD,ARG,
2171 semget KEY,NSEMS,FLAGS, semop KEY,OPSTRING, setgrent, setpgrp PID,PGRP,
2172 setpriority WHICH,WHO,PRIORITY, setpwent, setsockopt
2173 SOCKET,LEVEL,OPTNAME,OPTVAL, shmctl ID,CMD,ARG, shmget KEY,SIZE,FLAGS,
2174 shmread ID,VAR,POS,SIZE, shmwrite ID,STRING,POS,SIZE, sockatmark SOCKET,
2175 socketpair SOCKET1,SOCKET2,DOMAIN,TYPE,PROTOCOL, stat FILEHANDLE, stat
2176 EXPR, stat, symlink OLDFILE,NEWFILE, syscall LIST, sysopen
2177 FILEHANDLE,FILENAME,MODE,PERMS, system LIST, times, truncate
2178 FILEHANDLE,LENGTH, truncate EXPR,LENGTH, umask EXPR, umask, utime LIST,
2179 wait, waitpid PID,FLAGS
2180
2181 =back
2182
2183 =item CHANGES
2184
2185 v1.48, 02 February 2001, v1.47, 22 March 2000, v1.46, 12 February 2000,
2186 v1.45, 20 December 1999, v1.44, 19 July 1999, v1.43, 24 May 1999, v1.42, 22
2187 May 1999, v1.41, 19 May 1999, v1.40, 11 April 1999, v1.39, 11 February
2188 1999, v1.38, 31 December 1998, v1.37, 19 December 1998, v1.36, 9 September
2189 1998, v1.35, 13 August 1998, v1.33, 06 August 1998, v1.32, 05 August 1998,
2190 v1.30, 03 August 1998, v1.23, 10 July 1998
2191
2192 =item Supported Platforms
2193
2194 =item SEE ALSO
2195
2196 =item AUTHORS / CONTRIBUTORS
2197
2198 =back
2199
2200 =head2 perllocale - Perl locale handling (internationalization and
2201 localization)
2202
2203 =over 4
2204
2205 =item DESCRIPTION
2206
2207 =item PREPARING TO USE LOCALES
2208
2209 =item USING LOCALES
2210
2211 =over 4
2212
2213 =item The use locale pragma
2214
2215 =item The setlocale function
2216
2217 =item Finding locales
2218
2219 =item LOCALE PROBLEMS
2220
2221 =item Temporarily fixing locale problems
2222
2223 =item Permanently fixing locale problems
2224
2225 =item Permanently fixing your system's locale configuration
2226
2227 =item Fixing system locale configuration
2228
2229 =item The localeconv function
2230
2231 =item I18N::Langinfo
2232
2233 =back
2234
2235 =item LOCALE CATEGORIES
2236
2237 =over 4
2238
2239 =item Category LC_COLLATE: Collation
2240
2241 =item Category LC_CTYPE: Character Types
2242
2243 =item Category LC_NUMERIC: Numeric Formatting
2244
2245 =item Category LC_MONETARY: Formatting of monetary amounts
2246
2247 =item LC_TIME
2248
2249 =item Other categories
2250
2251 =back
2252
2253 =item SECURITY
2254
2255 =item ENVIRONMENT
2256
2257 PERL_BADLANG, LC_ALL, LANGUAGE, LC_CTYPE, LC_COLLATE, LC_MONETARY,
2258 LC_NUMERIC, LC_TIME, LANG
2259
2260 =item NOTES
2261
2262 =over 4
2263
2264 =item Backward compatibility
2265
2266 =item I18N:Collate obsolete
2267
2268 =item Sort speed and memory use impacts
2269
2270 =item write() and LC_NUMERIC
2271
2272 =item Freely available locale definitions
2273
2274 =item I18n and l10n
2275
2276 =item An imperfect standard
2277
2278 =back
2279
2280 =item Unicode and UTF-8
2281
2282 =item BUGS
2283
2284 =over 4
2285
2286 =item Broken systems
2287
2288 =back
2289
2290 =item SEE ALSO
2291
2292 =item HISTORY
2293
2294 =back
2295
2296 =head2 perluniintro - Perl Unicode introduction
2297
2298 =over 4
2299
2300 =item DESCRIPTION
2301
2302 =over 4
2303
2304 =item Unicode
2305
2306 =item Perl's Unicode Support
2307
2308 =item Perl's Unicode Model
2309
2310 =item Unicode and EBCDIC
2311
2312 =item Creating Unicode
2313
2314 =item Handling Unicode
2315
2316 =item Legacy Encodings
2317
2318 =item Unicode I/O
2319
2320 =item Displaying Unicode As Text
2321
2322 =item Special Cases
2323
2324 =item Advanced Topics
2325
2326 =item Miscellaneous
2327
2328 =item Questions With Answers
2329
2330 , , , , , ,
2331
2332 =item Hexadecimal Notation
2333
2334 =item Further Resources
2335
2336 =back
2337
2338 =item UNICODE IN OLDER PERLS
2339
2340 =item SEE ALSO
2341
2342 =item ACKNOWLEDGEMENTS
2343
2344 =item AUTHOR, COPYRIGHT, AND LICENSE
2345
2346 =back
2347
2348 =head2 perlunicode - Unicode support in Perl
2349
2350 =over 4
2351
2352 =item DESCRIPTION
2353
2354 =over 4
2355
2356 =item Important Caveats
2357
2358 Input and Output Disciplines, Regular Expressions, C<use utf8> still needed
2359 to enable UTF-8/UTF-EBCDIC in scripts
2360
2361 =item Byte and Character semantics
2362
2363 =item Effects of character semantics
2364
2365 =item Scripts
2366
2367 =item Blocks
2368
2369 =item User-defined Character Properties
2370
2371 =item Character encodings for input and output
2372
2373 =item Unicode Regular Expression Support Level
2374
2375 =item Unicode Encodings
2376
2377 =item Security Implications of Unicode
2378
2379 =item Unicode in Perl on EBCDIC
2380
2381 =item Locales
2382
2383 =item Using Unicode in XS
2384
2385 =back
2386
2387 =item BUGS
2388
2389 =over 4
2390
2391 =item Interaction with locales
2392
2393 =item Interaction with extensions
2394
2395 =item speed
2396
2397 =back
2398
2399 =item SEE ALSO
2400
2401 =back
2402
2403 =head2 perlebcdic - Considerations for running Perl on EBCDIC platforms
2404
2405 =over 4
2406
2407 =item DESCRIPTION
2408
2409 =item COMMON CHARACTER CODE SETS
2410
2411 =over 4
2412
2413 =item ASCII
2414
2415 =item ISO 8859
2416
2417 =item Latin 1 (ISO 8859-1)
2418
2419 =item EBCDIC
2420
2421 =item 13 variant characters
2422
2423 =item 0037
2424
2425 =item 1047
2426
2427 =item POSIX-BC
2428
2429 =item Unicode code points versus EBCDIC code points
2430
2431 =item Remaining Perl Unicode problems in EBCDIC
2432
2433 =item Unicode and UTF
2434
2435 =item Using Encode
2436
2437 =back
2438
2439 =item SINGLE OCTET TABLES
2440
2441 recipe 0, recipe 1, recipe 2, recipe 3, recipe 4, recipe 5, recipe 6
2442
2443 =item IDENTIFYING CHARACTER CODE SETS
2444
2445 =item CONVERSIONS
2446
2447 =over 4
2448
2449 =item tr///
2450
2451 =item iconv
2452
2453 =item C RTL
2454
2455 =back
2456
2457 =item OPERATOR DIFFERENCES
2458
2459 =item FUNCTION DIFFERENCES
2460
2461 chr(), ord(), pack(), print(), printf(), sort(), sprintf(), unpack()
2462
2463 =item REGULAR EXPRESSION DIFFERENCES
2464
2465 =item SOCKETS
2466
2467 =item SORTING
2468
2469 =over 4
2470
2471 =item Ignore ASCII vs. EBCDIC sort differences.
2472
2473 =item MONO CASE then sort data.
2474
2475 =item Convert, sort data, then re convert.
2476
2477 =item Perform sorting on one type of machine only.
2478
2479 =back
2480
2481 =item TRANSFORMATION FORMATS
2482
2483 =over 4
2484
2485 =item URL decoding and encoding
2486
2487 =item uu encoding and decoding
2488
2489 =item Quoted-Printable encoding and decoding
2490
2491 =item Caesarian ciphers
2492
2493 =back
2494
2495 =item Hashing order and checksums
2496
2497 =item I18N AND L10N
2498
2499 =item MULTI OCTET CHARACTER SETS
2500
2501 =item OS ISSUES
2502
2503 =over 4
2504
2505 =item OS/400
2506
2507 IFS access
2508
2509 =item OS/390, z/OS
2510
2511 chcp, dataset access, OS/390, z/OS iconv, locales
2512
2513 =item VM/ESA?
2514
2515 =item POSIX-BC?
2516
2517 =back
2518
2519 =item BUGS
2520
2521 =item SEE ALSO
2522
2523 =item REFERENCES
2524
2525 =item HISTORY
2526
2527 =item AUTHOR
2528
2529 =back
2530
2531 =head2 perlsec - Perl security
2532
2533 =over 4
2534
2535 =item DESCRIPTION
2536
2537 =over 4
2538
2539 =item Laundering and Detecting Tainted Data
2540
2541 =item Switches On the "#!" Line
2542
2543 =item Cleaning Up Your Path
2544
2545 =item Security Bugs
2546
2547 =item Protecting Your Programs
2548
2549 =item Unicode
2550
2551 =back
2552
2553 =item SEE ALSO
2554
2555 =back
2556
2557 =head2 perlmod - Perl modules (packages and symbol tables)
2558
2559 =over 4
2560
2561 =item DESCRIPTION
2562
2563 =over 4
2564
2565 =item Packages
2566
2567 =item Symbol Tables
2568
2569 =item Package Constructors and Destructors
2570
2571 =item Perl Classes
2572
2573 =item Perl Modules
2574
2575 =item Making your module threadsafe
2576
2577 =back
2578
2579 =item SEE ALSO
2580
2581 =back
2582
2583 =head2 perlmodinstall - Installing CPAN Modules
2584
2585 =over 4
2586
2587 =item DESCRIPTION
2588
2589 =over 4
2590
2591 =item PREAMBLE
2592
2593 B<DECOMPRESS> the file, B<UNPACK> the file into a directory, B<BUILD> the
2594 module (sometimes unnecessary), B<INSTALL> the module
2595
2596 =back
2597
2598 =item PORTABILITY
2599
2600 =item HEY
2601
2602 =item AUTHOR
2603
2604 =item COPYRIGHT
2605
2606 =back
2607
2608 =head2 perlmodlib - constructing new Perl modules and finding existing ones
2609
2610 =over 4
2611
2612 =item DESCRIPTION
2613
2614 =item THE PERL MODULE LIBRARY
2615
2616 =over 4
2617
2618 =item Pragmatic Modules
2619
2620 attributes, attrs, autouse, base, bigint, bignum, bigrat, blib, bytes,
2621 charnames, constant, diagnostics, encoding, fields, filetest, if, integer,
2622 less, locale, open, ops, overload, re, sigtrap, sort, strict, subs,
2623 threads, utf8, vars, vmsish, warnings, warnings::register
2624
2625 =item Standard Modules
2626
2627 AnyDBM_File, Attribute::Handlers, AutoLoader, AutoSplit, B, B::Asmdata,
2628 B::Assembler, B::Bblock, B::Bytecode, B::C, B::CC, B::Concise, B::Debug,
2629 B::Deparse, B::Disassembler, B::Lint, B::Showlex, B::Stackobj, B::Stash,
2630 B::Terse, B::Xref, Benchmark, ByteLoader, CGI, CGI::Apache, CGI::Carp,
2631 CGI::Cookie, CGI::Fast, CGI::Pretty, CGI::Push, CGI::Switch, CGI::Util,
2632 CPAN, CPAN::FirstTime, CPAN::Nox, Carp, Carp::Heavy, Class::ISA,
2633 Class::Struct, Cwd, DB, DB_File, Devel::SelfStubber, Digest, DirHandle,
2634 Dumpvalue, Encode, English, Env, Exporter, Exporter::Heavy,
2635 ExtUtils::Command, ExtUtils::Command::MM, ExtUtils::Constant,
2636 ExtUtils::Embed, ExtUtils::Install, ExtUtils::Installed, ExtUtils::Liblist,
2637 ExtUtils::MM, ExtUtils::MM_Any, ExtUtils::MM_BeOS, ExtUtils::MM_Cygwin,
2638 ExtUtils::MM_DOS, ExtUtils::MM_MacOS, ExtUtils::MM_NW5, ExtUtils::MM_OS2,
2639 ExtUtils::MM_UWIN, ExtUtils::MM_Unix, ExtUtils::MM_VMS, ExtUtils::MM_Win32,
2640 ExtUtils::MM_Win95, ExtUtils::MY, ExtUtils::MakeMaker, ExtUtils::Manifest,
2641 ExtUtils::Mkbootstrap, ExtUtils::Mksymlists, ExtUtils::Packlist,
2642 ExtUtils::testlib, Fatal, Fcntl, File::Basename, File::CheckTree,
2643 File::Compare, File::Copy, File::DosGlob, File::Find, File::Path,
2644 File::Spec, File::Spec::Cygwin, File::Spec::Epoc, File::Spec::Functions,
2645 File::Spec::Mac, File::Spec::OS2, File::Spec::Unix, File::Spec::VMS,
2646 File::Spec::Win32, File::Temp, File::stat, FileCache, FileHandle,
2647 Filter::Simple, FindBin, Getopt::Long, Getopt::Std, Hash::Util,
2648 I18N::Collate, I18N::LangTags, I18N::LangTags::List, IO, IPC::Open2,
2649 IPC::Open3, Locale::Constants, Locale::Country, Locale::Currency,
2650 Locale::Language, Locale::Maketext, Locale::Maketext::TPJ13,
2651 Locale::Script, Math::BigFloat, Math::BigInt, Math::BigInt::Calc,
2652 Math::BigRat, Math::Complex, Math::Trig, Memoize, Memoize::AnyDBM_File,
2653 Memoize::Expire, Memoize::ExpireFile, Memoize::ExpireTest,
2654 Memoize::NDBM_File, Memoize::SDBM_File, Memoize::Storable, NDBM_File, NEXT,
2655 Net::Cmd, Net::Config, Net::Domain, Net::FTP, Net::NNTP, Net::Netrc,
2656 Net::POP3, Net::Ping, Net::SMTP, Net::Time, Net::hostent, Net::libnetFAQ,
2657 Net::netent, Net::protoent, Net::servent, O, ODBM_File, Opcode, POSIX,
2658 PerlIO, Pod::Checker, Pod::Find, Pod::Functions, Pod::Html,
2659 Pod::InputObjects, Pod::LaTeX, Pod::Man, Pod::ParseLink, Pod::ParseUtils,
2660 Pod::Parser, Pod::Plainer, Pod::Select, Pod::Text, Pod::Text::Color,
2661 Pod::Text::Overstrike, Pod::Text::Termcap, Pod::Usage, Pod::t::basic,
2662 SDBM_File, Safe, Search::Dict, SelectSaver, SelfLoader, Shell, Socket,
2663 Storable, Switch, Symbol, Term::ANSIColor, Term::Cap, Term::Complete,
2664 Term::ReadLine, Test, Test::Builder, Test::Harness, Test::Harness::Assert,
2665 Test::Harness::Iterator, Test::Harness::Straps, Test::More, Test::Simple,
2666 Test::Tutorial, Text::Abbrev, Text::Balanced, Text::ParseWords,
2667 Text::Soundex, Text::Tabs, Text::Wrap, Thread, Tie::Array, Tie::File,
2668 Tie::Handle, Tie::Hash, Tie::Memoize, Tie::RefHash, Tie::Scalar,
2669 Tie::SubstrHash, Time::Local, Time::gmtime, Time::localtime, Time::tm,
2670 UNIVERSAL, Unicode::Collate, Unicode::UCD, User::grent, User::pwent, Win32
2671
2672 =item Extension Modules
2673
2674 =back
2675
2676 =item CPAN
2677
2678 =over 4
2679
2680 =item Africa
2681
2682 =item Asia
2683
2684 =item Central America
2685
2686 =item Europe
2687
2688 =item North America
2689
2690 =item Oceania
2691
2692 =item South America
2693
2694 =back
2695
2696 =item Modules: Creation, Use, and Abuse
2697
2698 =over 4
2699
2700 =item Guidelines for Module Creation
2701
2702 =item Guidelines for Converting Perl 4 Library Scripts into Modules
2703
2704 =item Guidelines for Reusing Application Code
2705
2706 =back
2707
2708 =item NOTE
2709
2710 =back
2711
2712 =head2 perlmodstyle - Perl module style guide
2713
2714 =over 4
2715
2716 =item INTRODUCTION
2717
2718 =item QUICK CHECKLIST
2719
2720 =over 4
2721
2722 =item Before you start
2723
2724 =item The API
2725
2726 =item Stability
2727
2728 =item Documentation
2729
2730 =item Release considerations
2731
2732 =back
2733
2734 =item BEFORE YOU START WRITING A MODULE
2735
2736 =over 4
2737
2738 =item Has it been done before?
2739
2740 =item Do one thing and do it well
2741
2742 =item What's in a name?
2743
2744 =back
2745
2746 =item DESIGNING AND WRITING YOUR MODULE
2747
2748 =over 4
2749
2750 =item To OO or not to OO?
2751
2752 =item Designing your API
2753
2754 Write simple routines to do simple things, Separate functionality from
2755 output, Provide sensible shortcuts and defaults, Naming conventions,
2756 Parameter passing
2757
2758 =item Strictness and warnings
2759
2760 =item Backwards compatibility
2761
2762 =item Error handling and messages
2763
2764 =back
2765
2766 =item DOCUMENTING YOUR MODULE
2767
2768 =over 4
2769
2770 =item POD
2771
2772 =item README, INSTALL, release notes, changelogs
2773
2774 =back
2775
2776 =item RELEASE CONSIDERATIONS
2777
2778 =over 4
2779
2780 =item Version numbering
2781
2782 =item Pre-requisites
2783
2784 =item Testing
2785
2786 =item Packaging
2787
2788 =item Licensing
2789
2790 =back
2791
2792 =item COMMON PITFALLS
2793
2794 =over 4
2795
2796 =item Reinventing the wheel
2797
2798 =item Trying to do too much
2799
2800 =item Inappropriate documentation
2801
2802 =back
2803
2804 =item SEE ALSO
2805
2806 L<perlstyle>, L<perlnewmod>, L<perlpod>, L<podchecker>, Testing tools,
2807 http://pause.perl.org/, Any good book on software engineering
2808
2809 =item AUTHOR
2810
2811 =back
2812
2813 =head2 perlnewmod - preparing a new module for distribution
2814
2815 =over 4
2816
2817 =item DESCRIPTION
2818
2819 =over 4
2820
2821 =item Warning
2822
2823 =item What should I make into a module?
2824
2825 =item Step-by-step: Preparing the ground
2826
2827 Look around, Check it's new, Discuss the need, Choose a name, Check again
2828
2829 =item Step-by-step: Making the module
2830
2831 Start with F<h2xs>, Use L<strict|strict> and L<warnings|warnings>, Use
2832 L<Carp|Carp>, Use L<Exporter|Exporter> - wisely!, Use L<plain old
2833 documentation|perlpod>, Write tests, Write the README
2834
2835 =item Step-by-step: Distributing your module
2836
2837 Get a CPAN user ID, C<perl Makefile.PL; make test; make dist>, Upload the
2838 tarball, Announce to the modules list, Announce to clpa, Fix bugs!
2839
2840 =back
2841
2842 =item AUTHOR
2843
2844 =item SEE ALSO
2845
2846 =back
2847
2848 =head2 perlfaq1 - General Questions About Perl ($Revision: 1.8 $, $Date:
2849 2002/04/07 18:46:13 $)
2850
2851 =over 4
2852
2853 =item DESCRIPTION
2854
2855 =over 4
2856
2857 =item What is Perl?
2858
2859 =item Who supports Perl?  Who develops it?  Why is it free?
2860
2861 =item Which version of Perl should I use?
2862
2863 =item What are perl4 and perl5?
2864
2865 =item What is perl6?
2866
2867 =item How stable is Perl?
2868
2869 =item Is Perl difficult to learn?
2870
2871 =item How does Perl compare with other languages like Java, Python, REXX,
2872 Scheme, or Tcl?
2873
2874 =item Can I do [task] in Perl?
2875
2876 =item When shouldn't I program in Perl?
2877
2878 =item What's the difference between "perl" and "Perl"?
2879
2880 =item Is it a Perl program or a Perl script?
2881
2882 =item What is a JAPH?
2883
2884 =item Where can I get a list of Larry Wall witticisms?
2885
2886 =item How can I convince my sysadmin/supervisor/employees to use version
2887 5/5.6.1/Perl instead of some other language?
2888
2889 =back
2890
2891 =item AUTHOR AND COPYRIGHT
2892
2893 =back
2894
2895 =head2 perlfaq2 - Obtaining and Learning about Perl ($Revision: 1.13 $,
2896 $Date: 2002/04/26 16:56:35 $)
2897
2898 =over 4
2899
2900 =item DESCRIPTION
2901
2902 =over 4
2903
2904 =item What machines support Perl?  Where do I get it?
2905
2906 =item How can I get a binary version of Perl?
2907
2908 =item I don't have a C compiler on my system.  How can I compile perl?
2909
2910 =item I copied the Perl binary from one machine to another, but scripts
2911 don't work.
2912
2913 =item I grabbed the sources and tried to compile but gdbm/dynamic
2914 loading/malloc/linking/... failed.  How do I make it work?
2915
2916 =item What modules and extensions are available for Perl?  What is CPAN?
2917 What does CPAN/src/... mean?
2918
2919 =item Is there an ISO or ANSI certified version of Perl?
2920
2921 =item Where can I get information on Perl?
2922
2923 =item What are the Perl newsgroups on Usenet?  Where do I post questions?
2924
2925 =item Where should I post source code?
2926
2927 =item Perl Books
2928
2929 References, Tutorials, Task-Oriented, Special Topics
2930
2931 =item Perl in Magazines
2932
2933 =item Perl on the Net: FTP and WWW Access
2934
2935 =item What mailing lists are there for Perl?
2936
2937 =item Archives of comp.lang.perl.misc
2938
2939 =item Where can I buy a commercial version of Perl?
2940
2941 =item Where do I send bug reports?
2942
2943 =item What is perl.com? Perl Mongers? pm.org? perl.org? cpan.org?
2944
2945 =back
2946
2947 =item AUTHOR AND COPYRIGHT
2948
2949 =back
2950
2951 =head2 perlfaq3 - Programming Tools ($Revision: 1.22 $, $Date: 2002/05/06
2952 13:11:13 $)
2953
2954 =over 4
2955
2956 =item DESCRIPTION
2957
2958 =over 4
2959
2960 =item How do I do (anything)?
2961
2962 =item How can I use Perl interactively?
2963
2964 =item Is there a Perl shell?
2965
2966 =item How do I debug my Perl programs?
2967
2968 =item How do I profile my Perl programs?
2969
2970 =item How do I cross-reference my Perl programs?
2971
2972 =item Is there a pretty-printer (formatter) for Perl?
2973
2974 =item Is there a ctags for Perl?
2975
2976 =item Is there an IDE or Windows Perl Editor?
2977
2978 Komodo, The Object System, Open Perl IDE, PerlBuilder, visiPerl+, OptiPerl,
2979 CodeMagicCD, GNU Emacs, MicroEMACS, XEmacs, Elvis, Vile, Vim, Codewright,
2980 MultiEdit, SlickEdit, Bash, Ksh, Tcsh, Zsh, BBEdit and BBEdit Lite, Alpha
2981
2982 =item Where can I get Perl macros for vi?
2983
2984 =item Where can I get perl-mode for emacs?
2985
2986 =item How can I use curses with Perl?
2987
2988 =item How can I use X or Tk with Perl?
2989
2990 =item How can I generate simple menus without using CGI or Tk?
2991
2992 =item How can I make my Perl program run faster?
2993
2994 =item How can I make my Perl program take less memory?
2995
2996 Don't slurp!, Use map and grep selectively, Avoid unnecessary quotes and
2997 stringification, Pass by reference, Tie large variables to disk
2998
2999 =item Is it unsafe to return a pointer to local data?
3000
3001 =item How can I free an array or hash so my program shrinks?
3002
3003 =item How can I make my CGI script more efficient?
3004
3005 =item How can I hide the source for my Perl program?
3006
3007 =item How can I compile my Perl program into byte code or C?
3008
3009 =item How can I compile Perl into Java?
3010
3011 =item How can I get C<#!perl> to work on [MS-DOS,NT,...]?
3012
3013 =item Can I write useful Perl programs on the command line?
3014
3015 =item Why don't Perl one-liners work on my DOS/Mac/VMS system?
3016
3017 =item Where can I learn about CGI or Web programming in Perl?
3018
3019 =item Where can I learn about object-oriented Perl programming?
3020
3021 =item Where can I learn about linking C with Perl? [h2xs, xsubpp]
3022
3023 =item I've read perlembed, perlguts, etc., but I can't embed perl in
3024 my C program; what am I doing wrong?
3025
3026 =item When I tried to run my script, I got this message. What does it mean?
3027
3028 =item What's MakeMaker?
3029
3030 =back
3031
3032 =item AUTHOR AND COPYRIGHT
3033
3034 =back
3035
3036 =head2 perlfaq4 - Data Manipulation ($Revision: 1.21 $, $Date: 2002/05/06
3037 13:08:46 $)
3038
3039 =over 4
3040
3041 =item DESCRIPTION
3042
3043 =item Data: Numbers
3044
3045 =over 4
3046
3047 =item Why am I getting long decimals (eg, 19.9499999999999) instead of the
3048 numbers I should be getting (eg, 19.95)?
3049
3050 =item Why isn't my octal data interpreted correctly?
3051
3052 =item Does Perl have a round() function?  What about ceil() and floor()?
3053 Trig functions?
3054
3055 =item How do I convert between numeric representations?
3056
3057 B<How do I convert hexadecimal into decimal:>, B<How do I convert from
3058 decimal to hexadecimal:>, B<How do I convert from octal to decimal:>, B<How
3059 do I convert from decimal to octal:>, B<How do I convert from binary to
3060 decimal:>, B<How do I convert from decimal to binary:>
3061
3062 =item Why doesn't & work the way I want it to?
3063
3064 =item How do I multiply matrices?
3065
3066 =item How do I perform an operation on a series of integers?
3067
3068 =item How can I output Roman numerals?
3069
3070 =item Why aren't my random numbers random?
3071
3072 =item How do I get a random number between X and Y?
3073
3074 =back
3075
3076 =item Data: Dates
3077
3078 =over 4
3079
3080 =item How do I find the week-of-the-year/day-of-the-year?
3081
3082 =item How do I find the current century or millennium?
3083
3084 =item How can I compare two dates and find the difference?
3085
3086 =item How can I take a string and turn it into epoch seconds?
3087
3088 =item How can I find the Julian Day?
3089
3090 =item How do I find yesterday's date?
3091
3092 =item Does Perl have a Year 2000 problem?  Is Perl Y2K compliant?
3093
3094 =back
3095
3096 =item Data: Strings
3097
3098 =over 4
3099
3100 =item How do I validate input?
3101
3102 =item How do I unescape a string?
3103
3104 =item How do I remove consecutive pairs of characters?
3105
3106 =item How do I expand function calls in a string?
3107
3108 =item How do I find matching/nesting anything?
3109
3110 =item How do I reverse a string?
3111
3112 =item How do I expand tabs in a string?
3113
3114 =item How do I reformat a paragraph?
3115
3116 =item How can I access/change the first N letters of a string?
3117
3118 =item How do I change the Nth occurrence of something?
3119
3120 =item How can I count the number of occurrences of a substring within a
3121 string?
3122
3123 =item How do I capitalize all the words on one line?
3124
3125 =item How can I split a [character] delimited string except when inside
3126 [character]? (Comma-separated files)
3127
3128 =item How do I strip blank space from the beginning/end of a string?
3129
3130 =item How do I pad a string with blanks or pad a number with zeroes?
3131
3132 =item How do I extract selected columns from a string?
3133
3134 =item How do I find the soundex value of a string?
3135
3136 =item How can I expand variables in text strings?
3137
3138 =item What's wrong with always quoting "$vars"?
3139
3140 =item Why don't my <<HERE documents work?
3141
3142 1. There must be no space after the << part, 2. There (probably) should be
3143 a semicolon at the end, 3. You can't (easily) have any space in front of
3144 the tag
3145
3146 =back
3147
3148 =item Data: Arrays
3149
3150 =over 4
3151
3152 =item What is the difference between a list and an array?
3153
3154 =item What is the difference between $array[1] and @array[1]?
3155
3156 =item How can I remove duplicate elements from a list or array?
3157
3158 a), b), c), d), e)
3159
3160 =item How can I tell whether a certain element is contained in a list or
3161 array?
3162
3163 =item How do I compute the difference of two arrays?  How do I compute the
3164 intersection of two arrays?
3165
3166 =item How do I test whether two arrays or hashes are equal?
3167
3168 =item How do I find the first array element for which a condition is true?
3169
3170 =item How do I handle linked lists?
3171
3172 =item How do I handle circular lists?
3173
3174 =item How do I shuffle an array randomly?
3175
3176 =item How do I process/modify each element of an array?
3177
3178 =item How do I select a random element from an array?
3179
3180 =item How do I permute N elements of a list?
3181
3182 =item How do I sort an array by (anything)?
3183
3184 =item How do I manipulate arrays of bits?
3185
3186 =item Why does defined() return true on empty arrays and hashes?
3187
3188 =back
3189
3190 =item Data: Hashes (Associative Arrays)
3191
3192 =over 4
3193
3194 =item How do I process an entire hash?
3195
3196 =item What happens if I add or remove keys from a hash while iterating over
3197 it?
3198
3199 =item How do I look up a hash element by value?
3200
3201 =item How can I know how many entries are in a hash?
3202
3203 =item How do I sort a hash (optionally by value instead of key)?
3204
3205 =item How can I always keep my hash sorted?
3206
3207 =item What's the difference between "delete" and "undef" with hashes?
3208
3209 =item Why don't my tied hashes make the defined/exists distinction?
3210
3211 =item How do I reset an each() operation part-way through?
3212
3213 =item How can I get the unique keys from two hashes?
3214
3215 =item How can I store a multidimensional array in a DBM file?
3216
3217 =item How can I make my hash remember the order I put elements into it?
3218
3219 =item Why does passing a subroutine an undefined element in a hash create
3220 it?
3221
3222 =item How can I make the Perl equivalent of a C structure/C++ class/hash or
3223 array of hashes or arrays?
3224
3225 =item How can I use a reference as a hash key?
3226
3227 =back
3228
3229 =item Data: Misc
3230
3231 =over 4
3232
3233 =item How do I handle binary data correctly?
3234
3235 =item How do I determine whether a scalar is a number/whole/integer/float?
3236
3237 =item How do I keep persistent data across program calls?
3238
3239 =item How do I print out or copy a recursive data structure?
3240
3241 =item How do I define methods for every class/object?
3242
3243 =item How do I verify a credit card checksum?
3244
3245 =item How do I pack arrays of doubles or floats for XS code?
3246
3247 =back
3248
3249 =item AUTHOR AND COPYRIGHT
3250
3251 =back
3252
3253 =head2 perlfaq5 - Files and Formats ($Revision: 1.15 $, $Date: 2002/04/12
3254 02:02:05 $)
3255
3256 =over 4
3257
3258 =item DESCRIPTION
3259
3260 =over 4
3261
3262 =item How do I flush/unbuffer an output filehandle?  Why must I do this?
3263
3264 =item How do I change one line in a file/delete a line in a file/insert a
3265 line in the middle of a file/append to the beginning of a file?
3266
3267 =item How do I count the number of lines in a file?
3268
3269 =item How do I make a temporary file name?
3270
3271 =item How can I manipulate fixed-record-length files?
3272
3273 =item How can I make a filehandle local to a subroutine?  How do I pass
3274 filehandles between subroutines?  How do I make an array of filehandles?
3275
3276 =item How can I use a filehandle indirectly?
3277
3278 =item How can I set up a footer format to be used with write()?
3279
3280 =item How can I write() into a string?
3281
3282 =item How can I output my numbers with commas added?
3283
3284 =item How can I translate tildes (~) in a filename?
3285
3286 =item How come when I open a file read-write it wipes it out?
3287
3288 =item Why do I sometimes get an "Argument list too long" when I use <*>?
3289
3290 =item Is there a leak/bug in glob()?
3291
3292 =item How can I open a file with a leading ">" or trailing blanks?
3293
3294 =item How can I reliably rename a file?
3295
3296 =item How can I lock a file?
3297
3298 =item Why can't I just open(FH, ">file.lock")?
3299
3300 =item I still don't get locking.  I just want to increment the number in
3301 the file.  How can I do this?
3302
3303 =item All I want to do is append a small amount of text to the end of a
3304 file.  Do I still have to use locking?
3305
3306 =item How do I randomly update a binary file?
3307
3308 =item How do I get a file's timestamp in perl?
3309
3310 =item How do I set a file's timestamp in perl?
3311
3312 =item How do I print to more than one file at once?
3313
3314 =item How can I read in an entire file all at once?
3315
3316 =item How can I read in a file by paragraphs?
3317
3318 =item How can I read a single character from a file?  From the keyboard?
3319
3320 =item How can I tell whether there's a character waiting on a filehandle?
3321
3322 =item How do I do a C<tail -f> in perl?
3323
3324 =item How do I dup() a filehandle in Perl?
3325
3326 =item How do I close a file descriptor by number?
3327
3328 =item Why can't I use "C:\temp\foo" in DOS paths?  Why doesn't
3329 `C:\temp\foo.exe` work?
3330
3331 =item Why doesn't glob("*.*") get all the files?
3332
3333 =item Why does Perl let me delete read-only files?  Why does C<-i> clobber
3334 protected files?  Isn't this a bug in Perl?
3335
3336 =item How do I select a random line from a file?
3337
3338 =item Why do I get weird spaces when I print an array of lines?
3339
3340 =back
3341
3342 =item AUTHOR AND COPYRIGHT
3343
3344 =back
3345
3346 =head2 perlfaq6 - Regular Expressions ($Revision: 1.10 $, $Date: 2002/04/07
3347 18:32:57 $)
3348
3349 =over 4
3350
3351 =item DESCRIPTION
3352
3353 =over 4
3354
3355 =item How can I hope to use regular expressions without creating illegible
3356 and unmaintainable code?
3357
3358 Comments Outside the Regex, Comments Inside the Regex, Different Delimiters
3359
3360 =item I'm having trouble matching over more than one line.  What's wrong?
3361
3362 =item How can I pull out lines between two patterns that are themselves on
3363 different lines?
3364
3365 =item I put a regular expression into $/ but it didn't work. What's wrong?
3366
3367 =item How do I substitute case insensitively on the LHS while preserving
3368 case on the RHS?
3369
3370 =item How can I make C<\w> match national character sets?
3371
3372 =item How can I match a locale-smart version of C</[a-zA-Z]/>?
3373
3374 =item How can I quote a variable to use in a regex?
3375
3376 =item What is C</o> really for?
3377
3378 =item How do I use a regular expression to strip C style comments from a
3379 file?
3380
3381 =item Can I use Perl regular expressions to match balanced text?
3382
3383 =item What does it mean that regexes are greedy?  How can I get around it?
3384
3385 =item How do I process each word on each line?
3386
3387 =item How can I print out a word-frequency or line-frequency summary?
3388
3389 =item How can I do approximate matching?
3390
3391 =item How do I efficiently match many regular expressions at once?
3392
3393 =item Why don't word-boundary searches with C<\b> work for me?
3394
3395 =item Why does using $&, $`, or $' slow my program down?
3396
3397 =item What good is C<\G> in a regular expression?
3398
3399 =item Are Perl regexes DFAs or NFAs?  Are they POSIX compliant?
3400
3401 =item What's wrong with using grep or map in a void context?
3402
3403 =item How can I match strings with multibyte characters?
3404
3405 =item How do I match a pattern that is supplied by the user?
3406
3407 =back
3408
3409 =item AUTHOR AND COPYRIGHT
3410
3411 =back
3412
3413 =head2 perlfaq7 - General Perl Language Issues ($Revision: 1.8 $, $Date:
3414 2002/03/26 15:48:32 $)
3415
3416 =over 4
3417
3418 =item DESCRIPTION
3419
3420 =over 4
3421
3422 =item Can I get a BNF/yacc/RE for the Perl language?
3423
3424 =item What are all these $@%&* punctuation signs, and how do I know when to
3425 use them?
3426
3427 =item Do I always/never have to quote my strings or use semicolons and
3428 commas?
3429
3430 =item How do I skip some return values?
3431
3432 =item How do I temporarily block warnings?
3433
3434 =item What's an extension?
3435
3436 =item Why do Perl operators have different precedence than C operators?
3437
3438 =item How do I declare/create a structure?
3439
3440 =item How do I create a module?
3441
3442 =item How do I create a class?
3443
3444 =item How can I tell if a variable is tainted?
3445
3446 =item What's a closure?
3447
3448 =item What is variable suicide and how can I prevent it?
3449
3450 =item How can I pass/return a {Function, FileHandle, Array, Hash, Method,
3451 Regex}?
3452
3453 Passing Variables and Functions, Passing Filehandles, Passing Regexes,
3454 Passing Methods
3455
3456 =item How do I create a static variable?
3457
3458 =item What's the difference between dynamic and lexical (static) scoping?
3459 Between local() and my()?
3460
3461 =item How can I access a dynamic variable while a similarly named lexical
3462 is in scope?
3463
3464 =item What's the difference between deep and shallow binding?
3465
3466 =item Why doesn't "my($foo) = <FILE>;" work right?
3467
3468 =item How do I redefine a builtin function, operator, or method?
3469
3470 =item What's the difference between calling a function as &foo and foo()?
3471
3472 =item How do I create a switch or case statement?
3473
3474 =item How can I catch accesses to undefined variables/functions/methods?
3475
3476 =item Why can't a method included in this same file be found?
3477
3478 =item How can I find out my current package?
3479
3480 =item How can I comment out a large block of perl code?
3481
3482 =item How do I clear a package?
3483
3484 =item How can I use a variable as a variable name?
3485
3486 =back
3487
3488 =item AUTHOR AND COPYRIGHT
3489
3490 =back
3491
3492 =head2 perlfaq8 - System Interaction ($Revision: 1.7 $, $Date: 2002/04/18
3493 14:23:15 $)
3494
3495 =over 4
3496
3497 =item DESCRIPTION
3498
3499 =over 4
3500
3501 =item How do I find out which operating system I'm running under?
3502
3503 =item How come exec() doesn't return?
3504
3505 =item How do I do fancy stuff with the keyboard/screen/mouse?
3506
3507 Keyboard, Screen, Mouse
3508
3509 =item How do I print something out in color?
3510
3511 =item How do I read just one key without waiting for a return key?
3512
3513 =item How do I check whether input is ready on the keyboard?
3514
3515 =item How do I clear the screen?
3516
3517 =item How do I get the screen size?
3518
3519 =item How do I ask the user for a password?
3520
3521 =item How do I read and write the serial port?
3522
3523 lockfiles, open mode, end of line, flushing output, non-blocking input
3524
3525 =item How do I decode encrypted password files?
3526
3527 =item How do I start a process in the background?
3528
3529 STDIN, STDOUT, and STDERR are shared, Signals, Zombies
3530
3531 =item How do I trap control characters/signals?
3532
3533 =item How do I modify the shadow password file on a Unix system?
3534
3535 =item How do I set the time and date?
3536
3537 =item How can I sleep() or alarm() for under a second?
3538
3539 =item How can I measure time under a second?
3540
3541 =item How can I do an atexit() or setjmp()/longjmp()? (Exception handling)
3542
3543 =item Why doesn't my sockets program work under System V (Solaris)?  What
3544 does the error message "Protocol not supported" mean?
3545
3546 =item How can I call my system's unique C functions from Perl?
3547
3548 =item Where do I get the include files to do ioctl() or syscall()?
3549
3550 =item Why do setuid perl scripts complain about kernel problems?
3551
3552 =item How can I open a pipe both to and from a command?
3553
3554 =item Why can't I get the output of a command with system()?
3555
3556 =item How can I capture STDERR from an external command?
3557
3558 =item Why doesn't open() return an error when a pipe open fails?
3559
3560 =item What's wrong with using backticks in a void context?
3561
3562 =item How can I call backticks without shell processing?
3563
3564 =item Why can't my script read from STDIN after I gave it EOF (^D on Unix,
3565 ^Z on MS-DOS)?
3566
3567 =item How can I convert my shell script to perl?
3568
3569 =item Can I use perl to run a telnet or ftp session?
3570
3571 =item How can I write expect in Perl?
3572
3573 =item Is there a way to hide perl's command line from programs such as
3574 "ps"?
3575
3576 =item I {changed directory, modified my environment} in a perl script.  How
3577 come the change disappeared when I exited the script?  How do I get my
3578 changes to be visible?
3579
3580 Unix
3581
3582 =item How do I close a process's filehandle without waiting for it to
3583 complete?
3584
3585 =item How do I fork a daemon process?
3586
3587 =item How do I find out if I'm running interactively or not?
3588
3589 =item How do I timeout a slow event?
3590
3591 =item How do I set CPU limits?
3592
3593 =item How do I avoid zombies on a Unix system?
3594
3595 =item How do I use an SQL database?
3596
3597 =item How do I make a system() exit on control-C?
3598
3599 =item How do I open a file without blocking?
3600
3601 =item How do I install a module from CPAN?
3602
3603 =item What's the difference between require and use?
3604
3605 =item How do I keep my own module/library directory?
3606
3607 =item How do I add the directory my program lives in to the module/library
3608 search path?
3609
3610 =item How do I add a directory to my include path at runtime?
3611
3612 =item What is socket.ph and where do I get it?
3613
3614 =back
3615
3616 =item AUTHOR AND COPYRIGHT
3617
3618 =back
3619
3620 =head2 perlfaq9 - Networking ($Revision: 1.9 $, $Date: 2002/04/07 18:46:13
3621 $)
3622
3623 =over 4
3624
3625 =item DESCRIPTION
3626
3627 =over 4
3628
3629 =item What is the correct form of response from a CGI script?
3630
3631 =item My CGI script runs from the command line but not the browser.  (500
3632 Server Error)
3633
3634 =item How can I get better error messages from a CGI program?
3635
3636 =item How do I remove HTML from a string?
3637
3638 =item How do I extract URLs?
3639
3640 =item How do I download a file from the user's machine?  How do I open a
3641 file on another machine?
3642
3643 =item How do I make a pop-up menu in HTML?
3644
3645 =item How do I fetch an HTML file?
3646
3647 =item How do I automate an HTML form submission?
3648
3649 =item How do I decode or create those %-encodings on the web?
3650
3651 =item How do I redirect to another page?
3652
3653 =item How do I put a password on my web pages?
3654
3655 =item How do I edit my .htpasswd and .htgroup files with Perl?
3656
3657 =item How do I make sure users can't enter values into a form that cause my
3658 CGI script to do bad things?
3659
3660 =item How do I parse a mail header?
3661
3662 =item How do I decode a CGI form?
3663
3664 =item How do I check a valid mail address?
3665
3666 =item How do I decode a MIME/BASE64 string?
3667
3668 =item How do I return the user's mail address?
3669
3670 =item How do I send mail?
3671
3672 =item How do I use MIME to make an attachment to a mail message?
3673
3674 =item How do I read mail?
3675
3676 =item How do I find out my hostname/domainname/IP address?
3677
3678 =item How do I fetch a news article or the active newsgroups?
3679
3680 =item How do I fetch/put an FTP file?
3681
3682 =item How can I do RPC in Perl?
3683
3684 =back
3685
3686 =item AUTHOR AND COPYRIGHT
3687
3688 =back
3689
3690 =head2 perlcompile - Introduction to the Perl Compiler-Translator
3691
3692 =over 4
3693
3694 =item DESCRIPTION
3695
3696 =over 4
3697
3698 =item Layout
3699
3700 B::Bytecode, B::C, B::CC, B::Lint, B::Deparse, B::Xref
3701
3702 =back
3703
3704 =item Using The Back Ends
3705
3706 =over 4
3707
3708 =item The Cross Referencing Back End
3709
3710 i, &, s, r
3711
3712 =item The Decompiling Back End
3713
3714 =item The Lint Back End
3715
3716 =item The Simple C Back End
3717
3718 =item The Bytecode Back End
3719
3720 =item The Optimized C Back End
3721
3722 =back
3723
3724 =item Module List for the Compiler Suite
3725
3726 B, O, B::Asmdata, B::Assembler, B::Bblock, B::Bytecode, B::C, B::CC,
3727 B::Concise, B::Debug, B::Deparse, B::Disassembler, B::Lint, B::Showlex,
3728 B::Stackobj, B::Stash, B::Terse, B::Xref
3729
3730 =item KNOWN PROBLEMS
3731
3732 =item AUTHOR
3733
3734 =back
3735
3736 =head2 perlembed - how to embed perl in your C program
3737
3738 =over 4
3739
3740 =item DESCRIPTION
3741
3742 =over 4
3743
3744 =item PREAMBLE
3745
3746 B<Use C from Perl?>, B<Use a Unix program from Perl?>, B<Use Perl from
3747 Perl?>, B<Use C from C?>, B<Use Perl from C?>
3748
3749 =item ROADMAP
3750
3751 =item Compiling your C program
3752
3753 =item Adding a Perl interpreter to your C program
3754
3755 =item Calling a Perl subroutine from your C program
3756
3757 =item Evaluating a Perl statement from your C program
3758
3759 =item Performing Perl pattern matches and substitutions from your C program
3760
3761 =item Fiddling with the Perl stack from your C program
3762
3763 =item Maintaining a persistent interpreter
3764
3765 =item Execution of END blocks
3766
3767 =item Maintaining multiple interpreter instances
3768
3769 =item Using Perl modules, which themselves use C libraries, from your C
3770 program
3771
3772 =back
3773
3774 =item Embedding Perl under Win32
3775
3776 =item MORAL
3777
3778 =item AUTHOR
3779
3780 =item COPYRIGHT
3781
3782 =back
3783
3784 =head2 perldebguts - Guts of Perl debugging
3785
3786 =over 4
3787
3788 =item DESCRIPTION
3789
3790 =item Debugger Internals
3791
3792 =over 4
3793
3794 =item Writing Your Own Debugger
3795
3796 =back
3797
3798 =item Frame Listing Output Examples
3799
3800 =item Debugging regular expressions
3801
3802 =over 4
3803
3804 =item Compile-time output
3805
3806 C<anchored> I<STRING> C<at> I<POS>, C<floating> I<STRING> C<at>
3807 I<POS1..POS2>, C<matching floating/anchored>, C<minlen>, C<stclass>
3808 I<TYPE>, C<noscan>, C<isall>, C<GPOS>, C<plus>, C<implicit>, C<with eval>,
3809 C<anchored(TYPE)>
3810
3811 =item Types of nodes
3812
3813 =item Run-time output
3814
3815 =back
3816
3817 =item Debugging Perl memory usage
3818
3819 =over 4
3820
3821 =item Using C<$ENV{PERL_DEBUG_MSTATS}>
3822
3823 C<buckets SMALLEST(APPROX)..GREATEST(APPROX)>, Free/Used, C<Total sbrk():
3824 SBRKed/SBRKs:CONTINUOUS>, C<pad: 0>, C<heads: 2192>, C<chain: 0>, C<tail:
3825 6144>
3826
3827 =item Example of using B<-DL> switch
3828
3829 C<717>, C<002>, C<054>, C<602>, C<702>, C<704>
3830
3831 =item B<-DL> details
3832
3833 C<!!!>, C<!!>, C<!>
3834
3835 =item Limitations of B<-DL> statistics
3836
3837 =back
3838
3839 =item SEE ALSO
3840
3841 =back
3842
3843 =head2 perlxstut, perlXStut - Tutorial for writing XSUBs
3844
3845 =over 4
3846
3847 =item DESCRIPTION
3848
3849 =item SPECIAL NOTES
3850
3851 =over 4
3852
3853 =item make
3854
3855 =item Version caveat
3856
3857 =item Dynamic Loading versus Static Loading
3858
3859 =back
3860
3861 =item TUTORIAL
3862
3863 =over 4
3864
3865 =item EXAMPLE 1
3866
3867 =item EXAMPLE 2
3868
3869 =item What has gone on?
3870
3871 =item Writing good test scripts
3872
3873 =item EXAMPLE 3
3874
3875 =item What's new here?
3876
3877 =item Input and Output Parameters
3878
3879 =item The XSUBPP Program
3880
3881 =item The TYPEMAP file
3882
3883 =item Warning about Output Arguments
3884
3885 =item EXAMPLE 4
3886
3887 =item What has happened here?
3888
3889 =item Anatomy of .xs file
3890
3891 =item Getting the fat out of XSUBs
3892
3893 =item More about XSUB arguments
3894
3895 =item The Argument Stack
3896
3897 =item Extending your Extension
3898
3899 =item Documenting your Extension
3900
3901 =item Installing your Extension
3902
3903 =item EXAMPLE 5
3904
3905 =item New Things in this Example
3906
3907 =item EXAMPLE 6
3908
3909 =item New Things in this Example
3910
3911 =item EXAMPLE 7 (Coming Soon)
3912
3913 =item EXAMPLE 8 (Coming Soon)
3914
3915 =item EXAMPLE 9 Passing open files to XSes
3916
3917 =item Troubleshooting these Examples
3918
3919 =back
3920
3921 =item See also
3922
3923 =item Author
3924
3925 =over 4
3926
3927 =item Last Changed
3928
3929 =back
3930
3931 =back
3932
3933 =head2 perlxs - XS language reference manual
3934
3935 =over 4
3936
3937 =item DESCRIPTION
3938
3939 =over 4
3940
3941 =item Introduction
3942
3943 =item On The Road
3944
3945 =item The Anatomy of an XSUB
3946
3947 =item The Argument Stack
3948
3949 =item The RETVAL Variable
3950
3951 =item The MODULE Keyword
3952
3953 =item The PACKAGE Keyword
3954
3955 =item The PREFIX Keyword
3956
3957 =item The OUTPUT: Keyword
3958
3959 =item The NO_OUTPUT Keyword
3960
3961 =item The CODE: Keyword
3962
3963 =item The INIT: Keyword
3964
3965 =item The NO_INIT Keyword
3966
3967 =item Initializing Function Parameters
3968
3969 =item Default Parameter Values
3970
3971 =item The PREINIT: Keyword
3972
3973 =item The SCOPE: Keyword
3974
3975 =item The INPUT: Keyword
3976
3977 =item The IN/OUTLIST/IN_OUTLIST/OUT/IN_OUT Keywords
3978
3979 =item The C<length(NAME)> Keyword
3980
3981 =item Variable-length Parameter Lists
3982
3983 =item The C_ARGS: Keyword
3984
3985 =item The PPCODE: Keyword
3986
3987 =item Returning Undef And Empty Lists
3988
3989 =item The REQUIRE: Keyword
3990
3991 =item The CLEANUP: Keyword
3992
3993 =item The POSTCALL: Keyword
3994
3995 =item The BOOT: Keyword
3996
3997 =item The VERSIONCHECK: Keyword
3998
3999 =item The PROTOTYPES: Keyword
4000
4001 =item The PROTOTYPE: Keyword
4002
4003 =item The ALIAS: Keyword
4004
4005 =item The OVERLOAD: Keyword
4006
4007 =item The INTERFACE: Keyword
4008
4009 =item The INTERFACE_MACRO: Keyword
4010
4011 =item The INCLUDE: Keyword
4012
4013 =item The CASE: Keyword
4014
4015 =item The & Unary Operator
4016
4017 =item Inserting POD, Comments and C Preprocessor Directives
4018
4019 =item Using XS With C++
4020
4021 =item Interface Strategy
4022
4023 =item Perl Objects And C Structures
4024
4025 =item The Typemap
4026
4027 =item Safely Storing Static Data in XS
4028
4029 MY_CXT_KEY, typedef my_cxt_t, START_MY_CXT, MY_CXT_INIT, dMY_CXT, MY_CXT
4030
4031 =back
4032
4033 =item EXAMPLES
4034
4035 =item XS VERSION
4036
4037 =item AUTHOR
4038
4039 =back
4040
4041 =head2 perlclib - Internal replacements for standard C library functions
4042
4043 =over 4
4044
4045 =item DESCRIPTION
4046
4047 =over 4
4048
4049 =item Conventions
4050
4051 C<t>, C<p>, C<n>, C<s>
4052
4053 =item File Operations
4054
4055 =item File Input and Output
4056
4057 =item File Positioning
4058
4059 =item Memory Management and String Handling
4060
4061 =item Character Class Tests
4062
4063 =item F<stdlib.h> functions
4064
4065 =item Miscellaneous functions
4066
4067 =back
4068
4069 =item SEE ALSO
4070
4071 =back
4072
4073 =head2 perlguts - Introduction to the Perl API
4074
4075 =over 4
4076
4077 =item DESCRIPTION
4078
4079 =item Variables
4080
4081 =over 4
4082
4083 =item Datatypes
4084
4085 =item What is an "IV"?
4086
4087 =item Working with SVs
4088
4089 =item Offsets
4090
4091 =item What's Really Stored in an SV?
4092
4093 =item Working with AVs
4094
4095 =item Working with HVs
4096
4097 =item Hash API Extensions
4098
4099 =item References
4100
4101 =item Blessed References and Class Objects
4102
4103 =item Creating New Variables
4104
4105 GV_ADDMULTI, GV_ADDWARN
4106
4107 =item Reference Counts and Mortality
4108
4109 =item Stashes and Globs
4110
4111 =item Double-Typed SVs
4112
4113 =item Magic Variables
4114
4115 =item Assigning Magic
4116
4117 =item Magic Virtual Tables
4118
4119 =item Finding Magic
4120
4121 =item Understanding the Magic of Tied Hashes and Arrays
4122
4123 =item Localizing changes
4124
4125 C<SAVEINT(int i)>, C<SAVEIV(IV i)>, C<SAVEI32(I32 i)>, C<SAVELONG(long i)>,
4126 C<SAVESPTR(s)>, C<SAVEPPTR(p)>, C<SAVEFREESV(SV *sv)>, C<SAVEMORTALIZESV(SV
4127 *sv)>, C<SAVEFREEOP(OP *op)>, C<SAVEFREEPV(p)>, C<SAVECLEARSV(SV *sv)>,
4128 C<SAVEDELETE(HV *hv, char *key, I32 length)>,
4129 C<SAVEDESTRUCTOR(DESTRUCTORFUNC_NOCONTEXT_t f, void *p)>,
4130 C<SAVEDESTRUCTOR_X(DESTRUCTORFUNC_t f, void *p)>, C<SAVESTACK_POS()>, C<SV*
4131 save_scalar(GV *gv)>, C<AV* save_ary(GV *gv)>, C<HV* save_hash(GV *gv)>,
4132 C<void save_item(SV *item)>, C<void save_list(SV **sarg, I32 maxsarg)>,
4133 C<SV* save_svref(SV **sptr)>, C<void save_aptr(AV **aptr)>, C<void
4134 save_hptr(HV **hptr)>
4135
4136 =back
4137
4138 =item Subroutines
4139
4140 =over 4
4141
4142 =item XSUBs and the Argument Stack
4143
4144 =item Calling Perl Routines from within C Programs
4145
4146 =item Memory Allocation
4147
4148 =item PerlIO
4149
4150 =item Putting a C value on Perl stack
4151
4152 =item Scratchpads
4153
4154 =item Scratchpads and recursion
4155
4156 =back
4157
4158 =item Compiled code
4159
4160 =over 4
4161
4162 =item Code tree
4163
4164 =item Examining the tree
4165
4166 =item Compile pass 1: check routines
4167
4168 =item Compile pass 1a: constant folding
4169
4170 =item Compile pass 2: context propagation
4171
4172 =item Compile pass 3: peephole optimization
4173
4174 =item Pluggable runops
4175
4176 =back
4177
4178 =item Examining internal data structures with the C<dump> functions
4179
4180 =item How multiple interpreters and concurrency are supported
4181
4182 =over 4
4183
4184 =item Background and PERL_IMPLICIT_CONTEXT
4185
4186 =item So what happened to dTHR?
4187
4188 =item How do I use all this in extensions?
4189
4190 =item Should I do anything special if I call perl from multiple threads?
4191
4192 =item Future Plans and PERL_IMPLICIT_SYS
4193
4194 =back
4195
4196 =item Internal Functions
4197
4198 A, p, d, s, n, r, f, M, o, j, x
4199
4200 =over 4
4201
4202 =item Formatted Printing of IVs, UVs, and NVs
4203
4204 =item Pointer-To-Integer and Integer-To-Pointer
4205
4206 =item Source Documentation
4207
4208 =back
4209
4210 =item Unicode Support
4211
4212 =over 4
4213
4214 =item What B<is> Unicode, anyway?
4215
4216 =item How can I recognise a UTF8 string?
4217
4218 =item How does UTF8 represent Unicode characters?
4219
4220 =item How does Perl store UTF8 strings?
4221
4222 =item How do I convert a string to UTF8?
4223
4224 =item Is there anything else I need to know?
4225
4226 =back
4227
4228 =item Custom Operators
4229
4230 =item AUTHORS
4231
4232 =item SEE ALSO
4233
4234 =back
4235
4236 =head2 perlcall - Perl calling conventions from C
4237
4238 =over 4
4239
4240 =item DESCRIPTION
4241
4242 An Error Handler, An Event Driven Program
4243
4244 =item THE CALL_ FUNCTIONS
4245
4246 call_sv, call_pv, call_method, call_argv
4247
4248 =item FLAG VALUES
4249
4250 =over 4
4251
4252 =item  G_VOID
4253
4254 =item  G_SCALAR
4255
4256 =item G_ARRAY
4257
4258 =item G_DISCARD
4259
4260 =item G_NOARGS
4261
4262 =item G_EVAL
4263
4264 =item G_KEEPERR
4265
4266 =item Determining the Context
4267
4268 =back
4269
4270 =item KNOWN PROBLEMS
4271
4272 =item EXAMPLES
4273
4274 =over 4
4275
4276 =item No Parameters, Nothing returned
4277
4278 =item Passing Parameters
4279
4280 =item Returning a Scalar
4281
4282 =item Returning a list of values
4283
4284 =item Returning a list in a scalar context
4285
4286 =item Returning Data from Perl via the parameter list
4287
4288 =item Using G_EVAL
4289
4290 =item Using G_KEEPERR
4291
4292 =item Using call_sv
4293
4294 =item Using call_argv
4295
4296 =item Using call_method
4297
4298 =item Using GIMME_V
4299
4300 =item Using Perl to dispose of temporaries
4301
4302 =item Strategies for storing Callback Context Information
4303
4304 1. Ignore the problem - Allow only 1 callback, 2. Create a sequence of
4305 callbacks - hard wired limit, 3. Use a parameter to map to the Perl
4306 callback
4307
4308 =item Alternate Stack Manipulation
4309
4310 =item Creating and calling an anonymous subroutine in C
4311
4312 =back
4313
4314 =item SEE ALSO
4315
4316 =item AUTHOR
4317
4318 =item DATE
4319
4320 =back
4321
4322 =head2 perlutil - utilities packaged with the Perl distribution
4323
4324 =over 4
4325
4326 =item DESCRIPTION
4327
4328 =over 4
4329
4330 =item DOCUMENTATION
4331
4332 L<perldoc|perldoc>, L<pod2man|pod2man> and L<pod2text|pod2text>,
4333 L<pod2html|pod2html> and L<pod2latex|pod2latex>, L<pod2usage|pod2usage>,
4334 L<podselect|podselect>, L<podchecker|podchecker>, L<splain|splain>,
4335 L<roffitall|roffitall>
4336
4337 =item CONVERTORS
4338
4339 L<a2p|a2p>, L<s2p|s2p>, L<find2perl|find2perl>
4340
4341 =item Administration
4342
4343 L<libnetcfg|libnetcfg>
4344
4345 =item Development
4346
4347 L<perlbug|perlbug>, L<h2ph|h2ph>, L<c2ph|c2ph> and L<pstruct|pstruct>,
4348 L<h2xs|h2xs>, L<dprofpp|dprofpp>, L<perlcc|perlcc>
4349
4350 =item SEE ALSO
4351
4352 =back
4353
4354 =back
4355
4356 =head2 perlfilter - Source Filters
4357
4358 =over 4
4359
4360 =item DESCRIPTION
4361
4362 =item CONCEPTS
4363
4364 =item USING FILTERS
4365
4366 =item WRITING A SOURCE FILTER
4367
4368 =item WRITING A SOURCE FILTER IN C
4369
4370 B<Decryption Filters>
4371
4372 =item CREATING A SOURCE FILTER AS A SEPARATE EXECUTABLE
4373
4374 =item WRITING A SOURCE FILTER IN PERL
4375
4376 =item USING CONTEXT: THE DEBUG FILTER
4377
4378 =item CONCLUSION
4379
4380 =item REQUIREMENTS
4381
4382 =item AUTHOR
4383
4384 =item Copyrights
4385
4386 =back
4387
4388 =head2 perldbmfilter - Perl DBM Filters
4389
4390 =over 4
4391
4392 =item SYNOPSIS
4393
4394 =item DESCRIPTION
4395
4396 B<filter_store_key>, B<filter_store_value>, B<filter_fetch_key>,
4397 B<filter_fetch_value>
4398
4399 =over 4
4400
4401 =item The Filter
4402
4403 =item An Example -- the NULL termination problem.
4404
4405 =item Another Example -- Key is a C int.
4406
4407 =back
4408
4409 =item SEE ALSO
4410
4411 =item AUTHOR
4412
4413 =back
4414
4415 =head2 perlapi - autogenerated documentation for the perl public API
4416
4417 =over 4
4418
4419 =item DESCRIPTION
4420
4421 =item "Gimme" Values
4422
4423 GIMME, GIMME_V, G_ARRAY, G_DISCARD, G_EVAL, G_NOARGS, G_SCALAR, G_VOID
4424
4425 =item Array Manipulation Functions
4426
4427 AvFILL, av_clear, av_delete, av_exists, av_extend, av_fetch, av_fill,
4428 av_len, av_make, av_pop, av_push, av_shift, av_store, av_undef, av_unshift,
4429 get_av, newAV, Nullav, sortsv
4430
4431 =item Callback Functions
4432
4433 call_argv, call_method, call_pv, call_sv, ENTER, eval_pv, eval_sv,
4434 FREETMPS, LEAVE, SAVETMPS
4435
4436 =item Character classes
4437
4438 isALNUM, isALPHA, isDIGIT, isLOWER, isSPACE, isUPPER, toLOWER, toUPPER
4439
4440 =item Cloning an interpreter
4441
4442 perl_clone
4443
4444 =item CV Manipulation Functions
4445
4446 CvSTASH, get_cv, Nullcv
4447
4448 =item Embedding Functions
4449
4450 load_module, nothreadhook, perl_alloc, perl_construct, perl_destruct,
4451 perl_free, perl_parse, perl_run, require_pv
4452
4453 =item Functions in file pp_pack.c
4454
4455 pack_cat, unpack_str
4456
4457 =item Global Variables
4458
4459 PL_modglobal, PL_na, PL_sv_no, PL_sv_undef, PL_sv_yes
4460
4461 =item GV Functions
4462
4463 GvSV, gv_fetchmeth, gv_fetchmethod, gv_fetchmethod_autoload,
4464 gv_fetchmeth_autoload, gv_stashpv, gv_stashsv
4465
4466 =item Handy Values
4467
4468 HEf_SVKEY, Nullch, Nullsv
4469
4470 =item Hash Manipulation Functions
4471
4472 get_hv, HeHASH, HeKEY, HeKLEN, HePV, HeSVKEY, HeSVKEY_force, HeSVKEY_set,
4473 HeVAL, HvNAME, hv_clear, hv_delete, hv_delete_ent, hv_exists,
4474 hv_exists_ent, hv_fetch, hv_fetch_ent, hv_iterinit, hv_iterkey,
4475 hv_iterkeysv, hv_iternext, hv_iternextsv, hv_iternext_flags, hv_iterval,
4476 hv_magic, hv_store, hv_store_ent, hv_undef, newHV, Nullhv
4477
4478 =item Magical Functions
4479
4480 mg_clear, mg_copy, mg_find, mg_free, mg_get, mg_length, mg_magical, mg_set,
4481 SvGETMAGIC, SvLOCK, SvSETMAGIC, SvSetMagicSV, SvSetMagicSV_nosteal,
4482 SvSetSV, SvSetSV_nosteal, SvSHARE
4483
4484 =item Memory Management
4485
4486 Copy, Move, New, Newc, NEWSV, Newz, Renew, Renewc, Safefree, savepv,
4487 savepvn, savesharedpv, StructCopy, Zero
4488
4489 =item Miscellaneous Functions
4490
4491 fbm_compile, fbm_instr, form, getcwd_sv, strEQ, strGE, strGT, strLE, strLT,
4492 strNE, strnEQ, strnNE
4493
4494 =item Numeric functions
4495
4496 grok_bin, grok_hex, grok_number, grok_numeric_radix, grok_oct, scan_bin,
4497 scan_hex, scan_oct
4498
4499 =item Optree Manipulation Functions
4500
4501 cv_const_sv, newCONSTSUB, newXS
4502
4503 =item Stack Manipulation Macros
4504
4505 dMARK, dORIGMARK, dSP, EXTEND, MARK, ORIGMARK, POPi, POPl, POPn, POPp,
4506 POPpbytex, POPpx, POPs, PUSHi, PUSHMARK, PUSHn, PUSHp, PUSHs, PUSHu,
4507 PUTBACK, SP, SPAGAIN, XPUSHi, XPUSHn, XPUSHp, XPUSHs, XPUSHu, XSRETURN,
4508 XSRETURN_IV, XSRETURN_NO, XSRETURN_NV, XSRETURN_PV, XSRETURN_UNDEF,
4509 XSRETURN_YES, XST_mIV, XST_mNO, XST_mNV, XST_mPV, XST_mUNDEF, XST_mYES
4510
4511 =item SV Flags
4512
4513 svtype, SVt_IV, SVt_NV, SVt_PV, SVt_PVAV, SVt_PVCV, SVt_PVHV, SVt_PVMG
4514
4515 =item SV Manipulation Functions
4516
4517 get_sv, looks_like_number, newRV_inc, newRV_noinc, newSV, newSViv, newSVnv,
4518 newSVpv, newSVpvf, newSVpvn, newSVpvn_share, newSVrv, newSVsv, newSVuv,
4519 new_vstring, SvCUR, SvCUR_set, SvEND, SvGROW, SvIOK, SvIOKp, SvIOK_notUV,
4520 SvIOK_off, SvIOK_on, SvIOK_only, SvIOK_only_UV, SvIOK_UV, SvIV, SvIVx,
4521 SvIVX, SvLEN, SvNIOK, SvNIOKp, SvNIOK_off, SvNOK, SvNOKp, SvNOK_off,
4522 SvNOK_on, SvNOK_only, SvNV, SvNVX, SvNVx, SvOK, SvOOK, SvPOK, SvPOKp,
4523 SvPOK_off, SvPOK_on, SvPOK_only, SvPOK_only_UTF8, SvPV, SvPVbyte,
4524 SvPVbytex, SvPVbytex_force, SvPVbyte_force, SvPVbyte_nolen, SvPVutf8,
4525 SvPVutf8x, SvPVutf8x_force, SvPVutf8_force, SvPVutf8_nolen, SvPVx, SvPVX,
4526 SvPV_force, SvPV_force_nomg, SvPV_nolen, SvREFCNT, SvREFCNT_dec,
4527 SvREFCNT_inc, SvROK, SvROK_off, SvROK_on, SvRV, SvSTASH, SvTAINT,
4528 SvTAINTED, SvTAINTED_off, SvTAINTED_on, SvTRUE, SvTYPE, SvUNLOCK, SvUOK,
4529 SvUPGRADE, SvUTF8, SvUTF8_off, SvUTF8_on, SvUV, SvUVX, SvUVx, sv_2bool,
4530 sv_2cv, sv_2io, sv_2iv, sv_2mortal, sv_2nv, sv_2pvbyte, sv_2pvbyte_nolen,
4531 sv_2pvutf8, sv_2pvutf8_nolen, sv_2pv_flags, sv_2pv_nolen, sv_2uv,
4532 sv_backoff, sv_bless, sv_catpv, sv_catpvf, sv_catpvf_mg, sv_catpvn,
4533 sv_catpvn_flags, sv_catpvn_mg, sv_catpv_mg, sv_catsv, sv_catsv_flags,
4534 sv_catsv_mg, sv_chop, sv_clear, sv_cmp, sv_cmp_locale, sv_collxfrm,
4535 sv_copypv, sv_dec, sv_derived_from, sv_eq, sv_force_normal,
4536 sv_force_normal_flags, sv_free, sv_gets, sv_grow, sv_inc, sv_insert,
4537 sv_isa, sv_isobject, sv_iv, sv_len, sv_len_utf8, sv_magic, sv_magicext,
4538 sv_mortalcopy, sv_newmortal, sv_newref, sv_nolocking, sv_nosharing,
4539 sv_nounlocking, sv_nv, sv_pos_b2u, sv_pos_u2b, sv_pv, sv_pvbyte,
4540 sv_pvbyten, sv_pvbyten_force, sv_pvn, sv_pvn_force, sv_pvn_force_flags,
4541 sv_pvutf8, sv_pvutf8n, sv_pvutf8n_force, sv_reftype, sv_replace,
4542 sv_report_used, sv_reset, sv_rvweaken, sv_setiv, sv_setiv_mg, sv_setnv,
4543 sv_setnv_mg, sv_setpv, sv_setpvf, sv_setpvf_mg, sv_setpvn, sv_setpvn_mg,
4544 sv_setpv_mg, sv_setref_iv, sv_setref_nv, sv_setref_pv, sv_setref_pvn,
4545 sv_setref_uv, sv_setsv, sv_setsv_flags, sv_setsv_mg, sv_setuv, sv_setuv_mg,
4546 sv_taint, sv_tainted, sv_true, sv_unmagic, sv_unref, sv_unref_flags,
4547 sv_untaint, sv_upgrade, sv_usepvn, sv_usepvn_mg, sv_utf8_decode,
4548 sv_utf8_downgrade, sv_utf8_encode, sv_utf8_upgrade, sv_utf8_upgrade_flags,
4549 sv_uv, sv_vcatpvfn, sv_vsetpvfn
4550
4551 =item Unicode Support
4552
4553 bytes_from_utf8, bytes_to_utf8, ibcmp_utf8, is_utf8_char, is_utf8_string,
4554 pv_uni_display, sv_recode_to_utf8, sv_uni_display, to_utf8_case,
4555 to_utf8_fold, to_utf8_lower, to_utf8_title, to_utf8_upper, utf8n_to_uvchr,
4556 utf8n_to_uvuni, utf8_distance, utf8_hop, utf8_length, utf8_to_bytes,
4557 utf8_to_uvchr, utf8_to_uvuni, uvchr_to_utf8, uvuni_to_utf8_flags
4558
4559 =item Variables created by C<xsubpp> and C<xsubpp> internal functions
4560
4561 ax, CLASS, dAX, dITEMS, dXSARGS, dXSI32, items, ix, newXSproto, RETVAL, ST,
4562 THIS, XS, XSRETURN_EMPTY, XS_VERSION, XS_VERSION_BOOTCHECK
4563
4564 =item Warning and Dieing
4565
4566 croak, warn
4567
4568 =item AUTHORS
4569
4570 =item SEE ALSO
4571
4572 =back
4573
4574 =head2 perlintern - autogenerated documentation of purely B<internal>
4575                  Perl functions
4576
4577 =over 4
4578
4579 =item DESCRIPTION
4580
4581 =item Global Variables
4582
4583 PL_DBsingle, PL_DBsub, PL_DBtrace, PL_dowarn, PL_last_in_gv, PL_ofs_sv,
4584 PL_rs
4585
4586 =item GV Functions
4587
4588 is_gv_magical
4589
4590 =item IO Functions
4591
4592 start_glob
4593
4594 =item Pad Data Structures
4595
4596 CvPADLIST
4597
4598 =item Stack Manipulation Macros
4599
4600 djSP, LVRET
4601
4602 =item SV Manipulation Functions
4603
4604 report_uninit, sv_add_arena, sv_clean_all, sv_clean_objs, sv_free_arenas
4605
4606 =item AUTHORS
4607
4608 =item SEE ALSO
4609
4610 =back
4611
4612 =head2 perliol - C API for Perl's implementation of IO in Layers.
4613
4614 =over 4
4615
4616 =item SYNOPSIS
4617
4618 =item DESCRIPTION
4619
4620 =over 4
4621
4622 =item History and Background
4623
4624 =item Layers vs Disciplines
4625
4626 =item Data Structures
4627
4628 =item Functions and Attributes
4629
4630 =item Per-instance Data
4631
4632 =item Layers in action.
4633
4634 =item Per-instance flag bits
4635
4636 PERLIO_F_EOF, PERLIO_F_CANWRITE,  PERLIO_F_CANREAD, PERLIO_F_ERROR,
4637 PERLIO_F_TRUNCATE, PERLIO_F_APPEND, PERLIO_F_CRLF, PERLIO_F_UTF8,
4638 PERLIO_F_UNBUF, PERLIO_F_WRBUF, PERLIO_F_RDBUF, PERLIO_F_LINEBUF,
4639 PERLIO_F_TEMP, PERLIO_F_OPEN, PERLIO_F_FASTGETS
4640
4641 =item Methods in Detail
4642
4643 name, size, kind, PERLIO_K_BUFFERED, PERLIO_K_CANCRLF, PERLIO_K_FASTGETS,
4644 PERLIO_K_MULTIARG, PERLIO_K_RAW, Pushed, Popped, Open, Getarg, Fileno, Dup,
4645 Read, Write, Seek, Tell, Close, Flush, Fill, Eof, Error,  Clearerr,
4646 Setlinebuf, Get_base, Get_bufsiz, Get_ptr, Get_cnt, Set_ptrcnt
4647
4648 =item Core Layers
4649
4650 "unix", "perlio", "stdio", "crlf", "mmap", "pending", "raw", "utf8"
4651
4652 =item Extension Layers
4653
4654 ":encoding", ":Scalar", ":Via"
4655
4656 =back
4657
4658 =item TODO
4659
4660 =back
4661
4662 =head2 perlapio - perl's IO abstraction interface.
4663
4664 =over 4
4665
4666 =item SYNOPSIS
4667
4668 =item DESCRIPTION
4669
4670 1. USE_STDIO, 2. USE_SFIO, 3. USE_PERLIO, B<PerlIO_stdin()>,
4671 B<PerlIO_stdout()>, B<PerlIO_stderr()>, B<PerlIO_open(path, mode)>,
4672 B<PerlIO_fdopen(fd,mode)>, B<PerlIO_reopen(path,mode,f)>,
4673 B<PerlIO_printf(f,fmt,...)>, B<PerlIO_vprintf(f,fmt,a)>,
4674 B<PerlIO_stdoutf(fmt,...)>, B<PerlIO_read(f,buf,count)>,
4675 B<PerlIO_write(f,buf,count)>, B<PerlIO_close(f)>, B<PerlIO_puts(f,s)>,
4676 B<PerlIO_putc(f,c)>, B<PerlIO_ungetc(f,c)>, B<PerlIO_getc(f)>,
4677 B<PerlIO_eof(f)>, B<PerlIO_error(f)>, B<PerlIO_fileno(f)>,
4678 B<PerlIO_clearerr(f)>, B<PerlIO_flush(f)>, B<PerlIO_seek(f,offset,whence)>,
4679 B<PerlIO_tell(f)>, B<PerlIO_getpos(f,p)>, B<PerlIO_setpos(f,p)>,
4680 B<PerlIO_rewind(f)>, B<PerlIO_tmpfile()>, B<PerlIO_setlinebuf(f)>
4681
4682 =over 4
4683
4684 =item Co-existence with stdio
4685
4686 B<PerlIO_importFILE(f,flags)>, B<PerlIO_exportFILE(f,flags)>,
4687 B<PerlIO_releaseFILE(p,f)>, B<PerlIO_findFILE(f)>
4688
4689 =item "Fast gets" Functions
4690
4691 B<PerlIO_fast_gets(f)>, B<PerlIO_has_cntptr(f)>, B<PerlIO_get_cnt(f)>,
4692 B<PerlIO_get_ptr(f)>, B<PerlIO_set_ptrcnt(f,p,c)>, B<PerlIO_canset_cnt(f)>,
4693 B<PerlIO_set_cnt(f,c)>, B<PerlIO_has_base(f)>, B<PerlIO_get_base(f)>,
4694 B<PerlIO_get_bufsiz(f)>
4695
4696 =item Other Functions
4697
4698 PerlIO_apply_layers(f,mode,layers), PerlIO_binmode(f,ptype,imode,layers),
4699 'E<lt>' read, 'E<gt>' write, '+' read/write, PerlIO_debug(fmt,...)
4700
4701 =back
4702
4703 =back
4704
4705 =head2 perltodo - Perl TO-DO List
4706
4707 =over 4
4708
4709 =item DESCRIPTION
4710
4711 =item To do during 5.6.x
4712
4713 =over 4
4714
4715 =item Support for I/O disciplines
4716
4717 =item Autoload bytes.pm
4718
4719 =item Make "\u{XXXX}" et al work
4720
4721 =item Create a char *sv_pvprintify(sv, STRLEN *lenp, UV flags)
4722
4723 =item Overloadable regex assertions
4724
4725 =item Unicode
4726
4727 =item use Thread for iThreads
4728
4729 =item make perl_clone optionally clone ops
4730
4731 =item Work out exit/die semantics for threads
4732
4733 =item Typed lexicals for compiler
4734
4735 =item Compiler workarounds for Win32
4736
4737 =item AUTOLOADing in the compiler
4738
4739 =item Fixing comppadlist when compiling
4740
4741 =item Cleaning up exported namespace
4742
4743 =item Complete signal handling
4744
4745 =item Out-of-source builds
4746
4747 =item POSIX realtime support
4748
4749 =item UNIX98 support
4750
4751 =item IPv6 Support
4752
4753 =item Long double conversion
4754
4755 =item Locales
4756
4757 =item Thread-safe regexes
4758
4759 =item Arithmetic on non-Arabic numerals
4760
4761 =item POSIX Unicode character classes
4762
4763 =item Factoring out common suffices/prefices in regexps (trie optimization)
4764
4765 =item Security audit shipped utilities
4766
4767 =item Sort out the uid-setting mess
4768
4769 =item Custom opcodes
4770
4771 =item DLL Versioning
4772
4773 =item Introduce @( and @)
4774
4775 =item Floating point handling
4776
4777 =item IV/UV preservation
4778
4779 =item Replace pod2html with something using Pod::Parser
4780
4781 =item Automate module testing on CPAN
4782
4783 =item sendmsg and recvmsg
4784
4785 =item Rewrite perlre documentation
4786
4787 =item Convert example code to IO::Handle filehandles
4788
4789 =item Document Win32 choices
4790
4791 =item Check new modules
4792
4793 =item Make roffitall find pods and libs itself
4794
4795 =back
4796
4797 =item To do at some point
4798
4799 =over 4
4800
4801 =item Remove regular expression recursion
4802
4803 =item Memory leaks after failed eval
4804
4805 =item bitfields in pack
4806
4807 =item Cross compilation
4808
4809 =item Perl preprocessor / macros
4810
4811 =item Perl lexer in Perl
4812
4813 =item Using POSIX calls internally
4814
4815 =item -i rename file when changed
4816
4817 =item All ARGV input should act like E<lt>E<gt>
4818
4819 =item Support for rerunning debugger
4820
4821 =item Test Suite for the Debugger
4822
4823 =item my sub foo { }
4824
4825 =item One-pass global destruction
4826
4827 =item Rewrite regexp parser
4828
4829 =item Cache recently used regexps
4830
4831 =item Re-entrant functions
4832
4833 =item Cross-compilation support
4834
4835 =item Bit-shifting bitvectors
4836
4837 =item debugger pragma
4838
4839 =item use less pragma
4840
4841 =item switch structures
4842
4843 =item Cache eval tree
4844
4845 =item rcatmaybe
4846
4847 =item Shrink opcode tables
4848
4849 =item Optimize away @_
4850
4851 =item Prototypes versus indirect objects
4852
4853 =item Install HTML
4854
4855 =item Prototype method calls
4856
4857 =item Return context prototype declarations
4858
4859 =item magic_setisa
4860
4861 =item Garbage collection
4862
4863 =item IO tutorial
4864
4865 =item Rewrite perldoc
4866
4867 =item Install .3p manpages
4868
4869 =item Unicode tutorial
4870
4871 =item Update POSIX.pm for 1003.1-2
4872
4873 =item Retargetable installation
4874
4875 =item POSIX emulation on non-POSIX systems
4876
4877 =item Rename Win32 headers
4878
4879 =item Finish off lvalue functions
4880
4881 =item Update sprintf documentation
4882
4883 =item Use fchown/fchmod internally
4884
4885 =item Make v-strings overloaded objects
4886
4887 =item Allow restricted hash assignment
4888
4889 =item Should overload be inheritable?
4890
4891 =item Taint rethink
4892
4893 =back
4894
4895 =item Vague ideas
4896
4897 =over 4
4898
4899 =item ref() in list context
4900
4901 =item Make tr/// return histogram of characters in list context
4902
4903 =item Compile to real threaded code
4904
4905 =item Structured types
4906
4907 =item Modifiable $1 et al.
4908
4909 =item Procedural interfaces for IO::*, etc.
4910
4911 =item RPC modules
4912
4913 =item Attach/detach debugger from running program
4914
4915 =item GUI::Native
4916
4917 =item foreach(reverse ...)
4918
4919 =item Constant function cache
4920
4921 =item Approximate regular expression matching
4922
4923 =back
4924
4925 =item Ongoing
4926
4927 =over 4
4928
4929 =item Update guts documentation
4930
4931 =item Add more tests
4932
4933 =item Update auxiliary tools
4934
4935 =item Create debugging macros
4936
4937 =item truncate to the people
4938
4939 =item Unicode in Filenames
4940
4941 =back
4942
4943 =item Recently done things
4944
4945 =over 4
4946
4947 =item Alternative RE syntax module
4948
4949 =item Safe signal handling
4950
4951 =item Tie Modules
4952
4953 =item gettimeofday
4954
4955 =item setitimer and getimiter
4956
4957 =item Testing __DIE__ hook
4958
4959 =item CPP equivalent in Perl
4960
4961 =item Explicit switch statements
4962
4963 =item autocroak
4964
4965 =item UTF/EBCDIC
4966
4967 =item UTF Regexes
4968
4969 =item perlcc to produce executable
4970
4971 =item END blocks saved in compiled output
4972
4973 =item Secure temporary file module
4974
4975 =item Integrate Time::HiRes
4976
4977 =item Turn Cwd into XS
4978
4979 =item Mmap for input
4980
4981 =item Byte to/from UTF8 and UTF8 to/from local conversion
4982
4983 =item Add sockatmark support
4984
4985 =item Mailing list archives
4986
4987 =item Bug tracking
4988
4989 =item Integrate MacPerl
4990
4991 =item Web "nerve center" for Perl
4992
4993 =item Regular expression tutorial
4994
4995 =item Debugging Tutorial
4996
4997 =item Integrate new modules
4998
4999 =item Integrate profiler
5000
5001 =item Y2K error detection
5002
5003 =item Regular expression debugger
5004
5005 =item POD checker
5006
5007 =item "Dynamic" lexicals
5008
5009 =item Cache precompiled modules
5010
5011 =back
5012
5013 =item Deprecated Wishes
5014
5015 =over 4
5016
5017 =item Loop control on do{}
5018
5019 =item Lexically scoped typeglobs
5020
5021 =item format BOTTOM
5022
5023 =item report HANDLE
5024
5025 =item Generalised want()/caller())
5026
5027 =item Named prototypes
5028
5029 =item Built-in globbing
5030
5031 =item Regression tests for suidperl
5032
5033 =item Cached hash values
5034
5035 =item Add compression modules
5036
5037 =item Reorganise documentation into tutorials/references
5038
5039 =item Remove distinction between functions and operators
5040
5041 =item Make XS easier to use
5042
5043 =item Make embedding easier to use
5044
5045 =item man for perl
5046
5047 =item my $Package::variable
5048
5049 =item "or" tests defined, not truth
5050
5051 =item "class"-based lexicals
5052
5053 =item byteperl
5054
5055 =item Lazy evaluation / tail recursion removal
5056
5057 =item Make "use utf8" the default
5058
5059 =item Unicode collation and normalization
5060
5061 =item pack/unpack tutorial
5062
5063 =back
5064
5065 =back
5066
5067 =head2 perlhack - How to hack at the Perl internals
5068
5069 =over 4
5070
5071 =item DESCRIPTION
5072
5073 Does concept match the general goals of Perl?, Where is the
5074 implementation?, Backwards compatibility, Could it be a module instead?, Is
5075 the feature generic enough?, Does it potentially introduce new bugs?, Does
5076 it preclude other desirable features?, Is the implementation robust?, Is
5077 the implementation generic enough to be portable?, Is the implementation
5078 tested?, Is there enough documentation?, Is there another way to do it?,
5079 Does it create too much work?, Patches speak louder than words
5080
5081 =over 4
5082
5083 =item Keeping in sync
5084
5085 rsync'ing the source tree, Using rsync over the LAN, Using pushing over the
5086 NFS, rsync'ing the patches
5087
5088 =item Why rsync the source tree
5089
5090 It's easier to rsync the source tree, It's more recent, It's more reliable
5091
5092 =item Why rsync the patches
5093
5094 It's easier to rsync the patches, It's a good reference, Finding a start
5095 point, Finding how to fix a bug, Finding the source of misbehaviour
5096
5097 =item Perlbug remote interface
5098
5099 1 http://bugs.perl.org, 2 bugdb@perl.org, 3
5100 commands_and_bugdids@bugs.perl.org, notes, patches, tests
5101
5102 =item Submitting patches
5103
5104 L<perlguts>, L<perlxstut> and L<perlxs>, L<perlapi>,
5105 F<Porting/pumpkin.pod>, The perl5-porters FAQ
5106
5107 =item Finding Your Way Around
5108
5109 Core modules, Tests, Documentation, Configure, Interpreter
5110
5111 =item Elements of the interpreter
5112
5113 Startup, Parsing, Optimization, Running
5114
5115 =item Internal Variable Types
5116
5117 =item Op Trees
5118
5119 =item Stacks
5120
5121 Argument stack, Mark stack, Save stack
5122
5123 =item Millions of Macros
5124
5125 =item Poking at Perl
5126
5127 =item Using a source-level debugger
5128
5129 run [args], break function_name, break source.c:xxx, step, next, continue,
5130 finish, 'enter', print
5131
5132 =item Dumping Perl Data Structures
5133
5134 =item Patching
5135
5136 =item Patching a core module
5137
5138 =item Adding a new function to the core
5139
5140 =item Writing a test
5141
5142 F<t/base/>, F<t/cmd/>, F<t/comp/>, F<t/io/>, F<t/lib/>, F<t/op/>,
5143 F<t/pod/>, F<t/run/>, t/base t/comp, t/cmd t/run t/io t/op, t/lib ext lib
5144
5145 =item Special Make Test Targets
5146
5147 coretest, test.deparse, minitest, test.third check.third utest.third
5148 ucheck.third, test.torture torturetest, utest ucheck test.utf8 check.utf8
5149
5150 =back
5151
5152 =item EXTERNAL TOOLS FOR DEBUGGING PERL
5153
5154 =over 4
5155
5156 =item Rational Software's Purify
5157
5158 =item Purify on Unix
5159
5160 -Accflags=-DPURIFY, -Doptimize='-g', -Uusemymalloc, -Dusemultiplicity
5161
5162 =item Purify on NT
5163
5164 DEFINES, USE_MULTI = define, #PERL_MALLOC = define, CFG = Debug
5165
5166 =item Compaq's/Digital's Third Degree
5167
5168 =item PERL_DESTRUCT_LEVEL
5169
5170 =item Profiling
5171
5172 =item Gprof Profiling
5173
5174 -a, -b, -e routine, -f routine, -s, -z
5175
5176 =item GCC gcov Profiling
5177
5178 =item Pixie Profiling
5179
5180 -h, -l, -p[rocedures], -h[eavy], -i[nvocations], -l[ines], -testcoverage,
5181 -z[ero]
5182
5183 =item Miscellaneous tricks
5184
5185 =item CONCLUSION
5186
5187 I<The Road goes ever on and on, down from the door where it began.>
5188
5189 =back
5190
5191 =item AUTHOR
5192
5193 =back
5194
5195 =head2 perlhist - the Perl history records
5196
5197 =over 4
5198
5199 =item DESCRIPTION
5200
5201 =item INTRODUCTION
5202
5203 =item THE KEEPERS OF THE PUMPKIN
5204
5205 =over 4
5206
5207 =item PUMPKIN?
5208
5209 =back
5210
5211 =item THE RECORDS
5212
5213 =over 4
5214
5215 =item SELECTED RELEASE SIZES
5216
5217 =item SELECTED PATCH SIZES
5218
5219 =back
5220
5221 =item THE KEEPERS OF THE RECORDS
5222
5223 =back
5224
5225 =head2 perldelta - what is new for perl v5.8.0
5226
5227 =over 4
5228
5229 =item DESCRIPTION
5230
5231 =item Highlights In 5.8.0
5232
5233 =item Incompatible Changes
5234
5235 =over 4
5236
5237 =item Binary Incompatibility
5238
5239 =item 64-bit platforms and malloc
5240
5241 =item AIX Dynaloading
5242
5243 =item Attributes for C<my> variables now handled at run-time.
5244
5245 =item Socket Extension Dynamic in VMS
5246
5247 =item IEEE-format Floating Point Default on OpenVMS Alpha
5248
5249 =item New Unicode Properties
5250
5251 =item REF(...) Instead Of SCALAR(...)
5252
5253 =item pack/unpack D/F recycled
5254
5255 =item Deprecations
5256
5257 =back
5258
5259 =item Core Enhancements
5260
5261 =over 4
5262
5263 =item PerlIO is Now The Default
5264
5265 =item Restricted Hashes
5266
5267 =item Safe Signals
5268
5269 =item Unicode Overhaul
5270
5271 =item Understanding of Numbers
5272
5273 =item Miscellaneous Changes
5274
5275 =back
5276
5277 =item Modules and Pragmata
5278
5279 =over 4
5280
5281 =item New Modules and Pragmata
5282
5283 =item Updated And Improved Modules and Pragmata
5284
5285 =back
5286
5287 =item Utility Changes
5288
5289 =item New Documentation
5290
5291 =item Performance Enhancements
5292
5293 =item Installation and Configuration Improvements
5294
5295 =over 4
5296
5297 =item Generic Improvements
5298
5299 =item New Or Improved Platforms
5300
5301 =back
5302
5303 =item Selected Bug Fixes
5304
5305 =over 4
5306
5307 =item Platform Specific Changes and Fixes
5308
5309 =back
5310
5311 =item New or Changed Diagnostics
5312
5313 =item Changed Internals
5314
5315 =item Security Vulnerability Closed
5316
5317 =item New Tests
5318
5319 =item Known Problems
5320
5321 =over 4
5322
5323 =item AIX
5324
5325 =item Amiga Perl Invoking Mystery
5326
5327 =item FreeBSD Failing locale Test 117 For ISO8859-15 Locales
5328
5329 =item Modifying $_ Inside for(..)
5330
5331 =item mod_perl 1.26 Doesn't Build With Threaded Perl
5332
5333 =item lib/ftmp-security tests warn 'system possibly insecure'
5334
5335 =item HP-UX lib/posix Subtest 9 Fails When LP64-Configured
5336
5337 =item Linux With Sfio Fails op/misc Test 48
5338
5339 =item Mac OS X
5340
5341 =item op/sprintf tests 91, 129, and 130
5342
5343 =item Solaris 2.5
5344
5345 =item Failure of Thread (5.005-style) tests
5346
5347 =item UNICOS
5348
5349 =item UNICOS/mk
5350
5351 =item UTS
5352
5353 =item VMS
5354
5355 =item Win32
5356
5357 =item XML::Parser not working
5358
5359 =item z/OS (OS/390)
5360
5361 =item Localising Tied Arrays and Hashes Is Broken
5362
5363 =item Self-tying of Arrays and Hashes Is Forbidden
5364
5365 =item Building Extensions Can Fail Because Of Largefiles
5366
5367 =item Unicode Support on EBCDIC Still Spotty
5368
5369 =item The Compiler Suite Is Still Experimental
5370
5371 =item The Long Double Support Is Still Experimental
5372
5373 =item Seen In Perl 5.7 But Gone Now
5374
5375 =back
5376
5377 =item Reporting Bugs
5378
5379 =item SEE ALSO
5380
5381 =item HISTORY
5382
5383 =back
5384
5385 =head2 perl572delta - what's new for perl v5.7.2
5386
5387 =over 4
5388
5389 =item DESCRIPTION
5390
5391 =item Security Vulnerability Closed
5392
5393 =item Incompatible Changes
5394
5395 =over 4
5396
5397 =item 64-bit platforms and malloc
5398
5399 =item AIX Dynaloading
5400
5401 =item Socket Extension Dynamic in VMS
5402
5403 =item Different Definition of the Unicode Character Classes \p{In...}
5404
5405 =item Deprecations
5406
5407 =back
5408
5409 =item Core Enhancements
5410
5411 =item Modules and Pragmata
5412
5413 =over 4
5414
5415 =item New Modules and Distributions
5416
5417 =item Updated And Improved Modules and Pragmata
5418
5419 =back
5420
5421 =item Utility Changes
5422
5423 =item New Documentation
5424
5425 =item Installation and Configuration Improvements
5426
5427 =over 4
5428
5429 =item New Or Improved Platforms
5430
5431 =item Generic Improvements
5432
5433 =back
5434
5435 =item Selected Bug Fixes
5436
5437 =over 4
5438
5439 =item Platform Specific Changes and Fixes
5440
5441 =back
5442
5443 =item New or Changed Diagnostics
5444
5445 =item Source Code Enhancements
5446
5447 =over 4
5448
5449 =item MAGIC constants
5450
5451 =item Better commented code
5452
5453 =item Regex pre-/post-compilation items matched up
5454
5455 =item gcc -Wall
5456
5457 =back
5458
5459 =item New Tests
5460
5461 =item Known Problems
5462
5463 =over 4
5464
5465 =item AIX
5466
5467 =item Amiga Perl Invoking Mystery
5468
5469 =item lib/ftmp-security tests warn 'system possibly insecure'
5470
5471 =item Cygwin intermittent failures of lib/Memoize/t/expire_file 11 and 12
5472
5473 =item HP-UX lib/io_multihomed Fails When LP64-Configured
5474
5475 =item  HP-UX lib/posix Subtest 9 Fails When LP64-Configured
5476
5477 =item Linux With Sfio Fails op/misc Test 48
5478
5479 =item OS/390
5480
5481 =item op/sprintf tests 129 and 130
5482
5483 =item  Failure of Thread tests
5484
5485 =item UNICOS
5486
5487 =item UTS
5488
5489 =item VMS
5490
5491 =item Win32
5492
5493 =item Localising a Tied Variable Leaks Memory
5494
5495 =item Self-tying of Arrays and Hashes Is Forbidden
5496
5497 =item Variable Attributes are not Currently Usable for Tieing
5498
5499 =item Building Extensions Can Fail Because Of Largefiles
5500
5501 =item The Compiler Suite Is Still Experimental
5502
5503 =item The Long Double Support is Still Experimental
5504
5505 =back
5506
5507 =item Reporting Bugs
5508
5509 =item SEE ALSO
5510
5511 =item HISTORY
5512
5513 =back
5514
5515 =head2 perl571delta - what's new for perl v5.7.1
5516
5517 =over 4
5518
5519 =item DESCRIPTION
5520
5521 =item Security Vulnerability Closed
5522
5523 =item Incompatible Changes
5524
5525 =item Core Enhancements
5526
5527 =over 4
5528
5529 =item AUTOLOAD Is Now Lvaluable
5530
5531 =item PerlIO is Now The Default
5532
5533 =item Signals Are Now Safe
5534
5535 =back
5536
5537 =item Modules and Pragmata
5538
5539 =over 4
5540
5541 =item New Modules
5542
5543 =item Updated And Improved Modules and Pragmata
5544
5545 =back
5546
5547 =item Performance Enhancements
5548
5549 =item Utility Changes
5550
5551 =item New Documentation
5552
5553 =over 4
5554
5555 =item perlclib
5556
5557 =item perliol
5558
5559 =item README.aix
5560
5561 =item README.bs2000
5562
5563 =item README.macos
5564
5565 =item README.mpeix
5566
5567 =item README.solaris
5568
5569 =item README.vos
5570
5571 =item Porting/repository.pod
5572
5573 =back
5574
5575 =item Installation and Configuration Improvements
5576
5577 =over 4
5578
5579 =item New Or Improved Platforms
5580
5581 =item Generic Improvements
5582
5583 d_cmsghdr, d_fcntl_can_lock, d_fsync, d_getitimer, d_getpagsz, d_msghdr_s,
5584 need_va_copy, d_readv, d_recvmsg, d_sendmsg, sig_size, d_sockatmark,
5585 d_strtoq, d_u32align, d_ualarm, d_usleep
5586
5587 =back
5588
5589 =item Selected Bug Fixes
5590
5591 =over 4
5592
5593 =item Platform Specific Changes and Fixes
5594
5595 =back
5596
5597 =item New or Changed Diagnostics
5598
5599 =item Changed Internals
5600
5601 =item New Tests
5602
5603 =item Known Problems
5604
5605 =over 4
5606
5607 =item AIX vac 5.0.0.0 May Produce Buggy Code For Perl
5608
5609 =item lib/ftmp-security tests warn 'system possibly insecure'
5610
5611 =item lib/io_multihomed Fails In LP64-Configured HP-UX
5612
5613 =item Test lib/posix Subtest 9 Fails In LP64-Configured HP-UX
5614
5615 =item lib/b test 19
5616
5617 =item Linux With Sfio Fails op/misc Test 48
5618
5619 =item sigaction test 13 in VMS
5620
5621 =item sprintf tests 129 and 130
5622
5623 =item  Failure of Thread tests
5624
5625 =item Localising a Tied Variable Leaks Memory
5626
5627 =item Self-tying of Arrays and Hashes Is Forbidden
5628
5629 =item Building Extensions Can Fail Because Of Largefiles
5630
5631 =item The Compiler Suite Is Still Experimental
5632
5633 =back
5634
5635 =item Reporting Bugs
5636
5637 =item SEE ALSO
5638
5639 =item HISTORY
5640
5641 =back
5642
5643 =head2 perl570delta - what's new for perl v5.7.0
5644
5645 =over 4
5646
5647 =item DESCRIPTION
5648
5649 =item Security Vulnerability Closed
5650
5651 =item Incompatible Changes
5652
5653 =item Core Enhancements
5654
5655 =item Modules and Pragmata
5656
5657 =over 4
5658
5659 =item New Modules
5660
5661 =item Updated And Improved Modules and Pragmata
5662
5663 =back
5664
5665 =item Utility Changes
5666
5667 =item New Documentation
5668
5669 =item Performance Enhancements
5670
5671 =item Installation and Configuration Improvements
5672
5673 =over 4
5674
5675 =item Generic Improvements
5676
5677 =back
5678
5679 =item Selected Bug Fixes
5680
5681 =over 4
5682
5683 =item Platform Specific Changes and Fixes
5684
5685 =back
5686
5687 =item New or Changed Diagnostics
5688
5689 =item Changed Internals
5690
5691 =item Known Problems
5692
5693 =over 4
5694
5695 =item Unicode Support Still Far From Perfect
5696
5697 =item EBCDIC Still A Lost Platform
5698
5699 =item Building Extensions Can Fail Because Of Largefiles
5700
5701 =item ftmp-security tests warn 'system possibly insecure'
5702
5703 =item Test lib/posix Subtest 9 Fails In LP64-Configured HP-UX
5704
5705 =item Long Doubles Still Don't Work In Solaris
5706
5707 =item Linux With Sfio Fails op/misc Test 48
5708
5709 =item Storable tests fail in some platforms
5710
5711 =item Threads Are Still Experimental
5712
5713 =item The Compiler Suite Is Still Experimental
5714
5715 =back
5716
5717 =item Reporting Bugs
5718
5719 =item SEE ALSO
5720
5721 =item HISTORY
5722
5723 =back
5724
5725 =head2 perl561delta - what's new for perl v5.6.x
5726
5727 =over 4
5728
5729 =item DESCRIPTION
5730
5731 =item Summary of changes between 5.6.0 and 5.6.1
5732
5733 =over 4
5734
5735 =item Security Issues
5736
5737 =item Core bug fixes
5738
5739 C<UNIVERSAL::isa()>, Memory leaks, Numeric conversions, qw(a\\b), caller(),
5740 Bugs in regular expressions, "slurp" mode, Autovivification of symbolic
5741 references to special variables, Lexical warnings, Spurious warnings and
5742 errors, glob(), Tainting, sort(), #line directives, Subroutine prototypes,
5743 map(), Debugger, PERL5OPT, chop(), Unicode support, 64-bit support,
5744 Compiler, Lvalue subroutines, IO::Socket, File::Find, xsubpp, C<no
5745 Module;>, Tests
5746
5747 =item Core features
5748
5749 =item Configuration issues
5750
5751 =item Documentation
5752
5753 =item Bundled modules
5754
5755 B::Concise, File::Temp, Pod::LaTeX, Pod::Text::Overstrike, CGI, CPAN,
5756 Class::Struct, DB_File, Devel::Peek, File::Find, Getopt::Long, IO::Poll,
5757 IPC::Open3, Math::BigFloat, Math::Complex, Net::Ping, Opcode, Pod::Parser,
5758 Pod::Text, SDBM_File, Sys::Syslog, Tie::RefHash, Tie::SubstrHash
5759
5760 =item Platform-specific improvements
5761
5762 NCR MP-RAS, NonStop-UX
5763
5764 =back
5765
5766 =item Core Enhancements
5767
5768 =over 4
5769
5770 =item Interpreter cloning, threads, and concurrency
5771
5772 =item Lexically scoped warning categories
5773
5774 =item Unicode and UTF-8 support
5775
5776 =item Support for interpolating named characters
5777
5778 =item "our" declarations
5779
5780 =item Support for strings represented as a vector of ordinals
5781
5782 =item Improved Perl version numbering system
5783
5784 =item New syntax for declaring subroutine attributes
5785
5786 =item File and directory handles can be autovivified
5787
5788 =item open() with more than two arguments
5789
5790 =item 64-bit support
5791
5792 =item Large file support
5793
5794 =item Long doubles
5795
5796 =item "more bits"
5797
5798 =item Enhanced support for sort() subroutines
5799
5800 =item C<sort $coderef @foo> allowed
5801
5802 =item File globbing implemented internally
5803
5804 =item Support for CHECK blocks
5805
5806 =item POSIX character class syntax [: :] supported
5807
5808 =item Better pseudo-random number generator
5809
5810 =item Improved C<qw//> operator
5811
5812 =item Better worst-case behavior of hashes
5813
5814 =item pack() format 'Z' supported
5815
5816 =item pack() format modifier '!' supported
5817
5818 =item pack() and unpack() support counted strings
5819
5820 =item Comments in pack() templates
5821
5822 =item Weak references
5823
5824 =item Binary numbers supported
5825
5826 =item Lvalue subroutines
5827
5828 =item Some arrows may be omitted in calls through references
5829
5830 =item Boolean assignment operators are legal lvalues
5831
5832 =item exists() is supported on subroutine names
5833
5834 =item exists() and delete() are supported on array elements
5835
5836 =item Pseudo-hashes work better
5837
5838 =item Automatic flushing of output buffers
5839
5840 =item Better diagnostics on meaningless filehandle operations
5841
5842 =item Where possible, buffered data discarded from duped input filehandle
5843
5844 =item eof() has the same old magic as <>
5845
5846 =item binmode() can be used to set :crlf and :raw modes
5847
5848 =item C<-T> filetest recognizes UTF-8 encoded files as "text"
5849
5850 =item system(), backticks and pipe open now reflect exec() failure
5851
5852 =item Improved diagnostics
5853
5854 =item Diagnostics follow STDERR
5855
5856 =item More consistent close-on-exec behavior
5857
5858 =item syswrite() ease-of-use
5859
5860 =item Better syntax checks on parenthesized unary operators
5861
5862 =item Bit operators support full native integer width
5863
5864 =item Improved security features
5865
5866 =item More functional bareword prototype (*)
5867
5868 =item C<require> and C<do> may be overridden
5869
5870 =item $^X variables may now have names longer than one character
5871
5872 =item New variable $^C reflects C<-c> switch
5873
5874 =item New variable $^V contains Perl version as a string
5875
5876 =item Optional Y2K warnings
5877
5878 =item Arrays now always interpolate into double-quoted strings
5879
5880 =back
5881
5882 =item Modules and Pragmata
5883
5884 =over 4
5885
5886 =item Modules
5887
5888 attributes, B, Benchmark, ByteLoader, constant, charnames, Data::Dumper,
5889 DB, DB_File, Devel::DProf, Devel::Peek, Dumpvalue, DynaLoader, English,
5890 Env, Fcntl, File::Compare, File::Find, File::Glob, File::Spec,
5891 File::Spec::Functions, Getopt::Long, IO, JPL, lib, Math::BigInt,
5892 Math::Complex, Math::Trig, Pod::Parser, Pod::InputObjects, Pod::Checker,
5893 podchecker, Pod::ParseUtils, Pod::Find, Pod::Select, podselect, Pod::Usage,
5894 pod2usage, Pod::Text and Pod::Man, SDBM_File, Sys::Syslog, Sys::Hostname,
5895 Term::ANSIColor, Time::Local, Win32, XSLoader, DBM Filters
5896
5897 =item Pragmata
5898
5899 =back
5900
5901 =item Utility Changes
5902
5903 =over 4
5904
5905 =item dprofpp
5906
5907 =item find2perl
5908
5909 =item h2xs
5910
5911 =item perlcc
5912
5913 =item perldoc
5914
5915 =item The Perl Debugger
5916
5917 =back
5918
5919 =item Improved Documentation
5920
5921 perlapi.pod, perlboot.pod, perlcompile.pod, perldbmfilter.pod,
5922 perldebug.pod, perldebguts.pod, perlfork.pod, perlfilter.pod, perlhack.pod,
5923 perlintern.pod, perllexwarn.pod, perlnumber.pod, perlopentut.pod,
5924 perlreftut.pod, perltootc.pod, perltodo.pod, perlunicode.pod
5925
5926 =item Performance enhancements
5927
5928 =over 4
5929
5930 =item Simple sort() using { $a <=> $b } and the like are optimized
5931
5932 =item Optimized assignments to lexical variables
5933
5934 =item Faster subroutine calls
5935
5936 =item delete(), each(), values() and hash iteration are faster
5937
5938 =back
5939
5940 =item Installation and Configuration Improvements
5941
5942 =over 4
5943
5944 =item -Dusethreads means something different
5945
5946 =item New Configure flags
5947
5948 =item Threadedness and 64-bitness now more daring
5949
5950 =item Long Doubles
5951
5952 =item -Dusemorebits
5953
5954 =item -Duselargefiles
5955
5956 =item installusrbinperl
5957
5958 =item SOCKS support
5959
5960 =item C<-A> flag
5961
5962 =item Enhanced Installation Directories
5963
5964 =item gcc automatically tried if 'cc' does not seem to be working
5965
5966 =back
5967
5968 =item Platform specific changes
5969
5970 =over 4
5971
5972 =item Supported platforms
5973
5974 =item DOS
5975
5976 =item OS390 (OpenEdition MVS)
5977
5978 =item VMS
5979
5980 =item Win32
5981
5982 =back
5983
5984 =item Significant bug fixes
5985
5986 =over 4
5987
5988 =item <HANDLE> on empty files
5989
5990 =item C<eval '...'> improvements
5991
5992 =item All compilation errors are true errors
5993
5994 =item Implicitly closed filehandles are safer
5995
5996 =item Behavior of list slices is more consistent
5997
5998 =item C<(\$)> prototype and C<$foo{a}>
5999
6000 =item C<goto &sub> and AUTOLOAD
6001
6002 =item C<-bareword> allowed under C<use integer>
6003
6004 =item Failures in DESTROY()
6005
6006 =item Locale bugs fixed
6007
6008 =item Memory leaks
6009
6010 =item Spurious subroutine stubs after failed subroutine calls
6011
6012 =item Taint failures under C<-U>
6013
6014 =item END blocks and the C<-c> switch
6015
6016 =item Potential to leak DATA filehandles
6017
6018 =back
6019
6020 =item New or Changed Diagnostics
6021
6022 "%s" variable %s masks earlier declaration in same %s, "my sub" not yet
6023 implemented, "our" variable %s redeclared, '!' allowed only after types %s,
6024 / cannot take a count, / must be followed by a, A or Z, / must be followed
6025 by a*, A* or Z*, / must follow a numeric type, /%s/: Unrecognized escape
6026 \\%c passed through, /%s/: Unrecognized escape \\%c in character class
6027 passed through, /%s/ should probably be written as "%s", %s() called too
6028 early to check prototype, %s argument is not a HASH or ARRAY element, %s
6029 argument is not a HASH or ARRAY element or slice, %s argument is not a
6030 subroutine name, %s package attribute may clash with future reserved word:
6031 %s, (in cleanup) %s, <> should be quotes, Attempt to join self, Bad evalled
6032 substitution pattern, Bad realloc() ignored, Bareword found in conditional,
6033 Binary number > 0b11111111111111111111111111111111 non-portable, Bit vector
6034 size > 32 non-portable, Buffer overflow in prime_env_iter: %s, Can't check
6035 filesystem of script "%s", Can't declare class for non-scalar %s in "%s",
6036 Can't declare %s in "%s", Can't ignore signal CHLD, forcing to default,
6037 Can't modify non-lvalue subroutine call, Can't read CRTL environ, Can't
6038 remove %s: %s, skipping file, Can't return %s from lvalue subroutine, Can't
6039 weaken a nonreference, Character class [:%s:] unknown, Character class
6040 syntax [%s] belongs inside character classes, Constant is not %s reference,
6041 constant(%s): %s, CORE::%s is not a keyword, defined(@array) is deprecated,
6042 defined(%hash) is deprecated, Did not produce a valid header, (Did you mean
6043 "local" instead of "our"?), Document contains no data, entering effective
6044 %s failed, false [] range "%s" in regexp, Filehandle %s opened only for
6045 output, flock() on closed filehandle %s, Global symbol "%s" requires
6046 explicit package name, Hexadecimal number > 0xffffffff non-portable,
6047 Ill-formed CRTL environ value "%s", Ill-formed message in prime_env_iter:
6048 |%s|, Illegal binary digit %s, Illegal binary digit %s ignored, Illegal
6049 number of bits in vec, Integer overflow in %s number, Invalid %s attribute:
6050 %s, Invalid %s attributes: %s, invalid [] range "%s" in regexp, Invalid
6051 separator character %s in attribute list, Invalid separator character %s in
6052 subroutine attribute list, leaving effective %s failed, Lvalue subs
6053 returning %s not implemented yet, Method %s not permitted, Missing
6054 %sbrace%s on \N{}, Missing command in piped open, Missing name in "my sub",
6055 No %s specified for -%c, No package name allowed for variable %s in "our",
6056 No space allowed after -%c, no UTC offset information; assuming local time
6057 is UTC, Octal number > 037777777777 non-portable, panic: del_backref,
6058 panic: kid popen errno read, panic: magic_killbackrefs, Parentheses missing
6059 around "%s" list, Possible unintended interpolation of %s in string,
6060 Possible Y2K bug: %s, pragma "attrs" is deprecated, use "sub NAME : ATTRS"
6061 instead, Premature end of script headers, Repeat count in pack overflows,
6062 Repeat count in unpack overflows, realloc() of freed memory ignored,
6063 Reference is already weak, setpgrp can't take arguments, Strange *+?{} on
6064 zero-length expression, switching effective %s is not implemented, This
6065 Perl can't reset CRTL environ elements (%s), This Perl can't set CRTL
6066 environ elements (%s=%s), Too late to run %s block, Unknown open() mode
6067 '%s', Unknown process %x sent message to prime_env_iter: %s, Unrecognized
6068 escape \\%c passed through, Unterminated attribute parameter in attribute
6069 list, Unterminated attribute list, Unterminated attribute parameter in
6070 subroutine attribute list, Unterminated subroutine attribute list, Value of
6071 CLI symbol "%s" too long, Version number must be a constant number
6072
6073 =item New tests
6074
6075 =item Incompatible Changes
6076
6077 =over 4
6078
6079 =item Perl Source Incompatibilities
6080
6081 CHECK is a new keyword, Treatment of list slices of undef has changed,
6082 Format of $English::PERL_VERSION is different, Literals of the form
6083 C<1.2.3> parse differently, Possibly changed pseudo-random number
6084 generator, Hashing function for hash keys has changed, C<undef> fails on
6085 read only values, Close-on-exec bit may be set on pipe and socket handles,
6086 Writing C<"$$1"> to mean C<"${$}1"> is unsupported, delete(), each(),
6087 values() and C<\(%h)>, vec(EXPR,OFFSET,BITS) enforces powers-of-two BITS,
6088 Text of some diagnostic output has changed, C<%@> has been removed,
6089 Parenthesized not() behaves like a list operator, Semantics of bareword
6090 prototype C<(*)> have changed, Semantics of bit operators may have changed
6091 on 64-bit platforms, More builtins taint their results
6092
6093 =item C Source Incompatibilities
6094
6095 C<PERL_POLLUTE>, C<PERL_IMPLICIT_CONTEXT>, C<PERL_POLLUTE_MALLOC>
6096
6097 =item Compatible C Source API Changes
6098
6099 C<PATCHLEVEL> is now C<PERL_VERSION>
6100
6101 =item Binary Incompatibilities
6102
6103 =back
6104
6105 =item Known Problems
6106
6107 =over 4
6108
6109 =item Localizing a tied hash element may leak memory
6110
6111 =item Known test failures
6112
6113 , ,
6114
6115 =item EBCDIC platforms not fully supported
6116
6117 =item UNICOS/mk CC failures during Configure run
6118
6119 =item Arrow operator and arrays
6120
6121 =item Experimental features
6122
6123 Threads, Unicode, 64-bit support, Lvalue subroutines, Weak references, The
6124 pseudo-hash data type, The Compiler suite, Internal implementation of file
6125 globbing, The DB module, The regular expression code constructs:
6126
6127 =back
6128
6129 =item Obsolete Diagnostics
6130
6131 Character class syntax [: :] is reserved for future extensions, Ill-formed
6132 logical name |%s| in prime_env_iter, In string, @%s now must be written as
6133 \@%s, Probable precedence problem on %s, regexp too big, Use of "$$<digit>"
6134 to mean "${$}<digit>" is deprecated
6135
6136 =item Reporting Bugs
6137
6138 =item SEE ALSO
6139
6140 =item HISTORY
6141
6142 =back
6143
6144 =head2 perl56delta - what's new for perl v5.6.0
6145
6146 =over 4
6147
6148 =item DESCRIPTION
6149
6150 =item Core Enhancements
6151
6152 =over 4
6153
6154 =item Interpreter cloning, threads, and concurrency
6155
6156 =item Lexically scoped warning categories
6157
6158 =item Unicode and UTF-8 support
6159
6160 =item Support for interpolating named characters
6161
6162 =item "our" declarations
6163
6164 =item Support for strings represented as a vector of ordinals
6165
6166 =item Improved Perl version numbering system
6167
6168 =item New syntax for declaring subroutine attributes
6169
6170 =item File and directory handles can be autovivified
6171
6172 =item open() with more than two arguments
6173
6174 =item 64-bit support
6175
6176 =item Large file support
6177
6178 =item Long doubles
6179
6180 =item "more bits"
6181
6182 =item Enhanced support for sort() subroutines
6183
6184 =item C<sort $coderef @foo> allowed
6185
6186 =item File globbing implemented internally
6187
6188 =item Support for CHECK blocks
6189
6190 =item POSIX character class syntax [: :] supported
6191
6192 =item Better pseudo-random number generator
6193
6194 =item Improved C<qw//> operator
6195
6196 =item Better worst-case behavior of hashes
6197
6198 =item pack() format 'Z' supported
6199
6200 =item pack() format modifier '!' supported
6201
6202 =item pack() and unpack() support counted strings
6203
6204 =item Comments in pack() templates
6205
6206 =item Weak references
6207
6208 =item Binary numbers supported
6209
6210 =item Lvalue subroutines
6211
6212 =item Some arrows may be omitted in calls through references
6213
6214 =item Boolean assignment operators are legal lvalues
6215
6216 =item exists() is supported on subroutine names
6217
6218 =item exists() and delete() are supported on array elements
6219
6220 =item Pseudo-hashes work better
6221
6222 =item Automatic flushing of output buffers
6223
6224 =item Better diagnostics on meaningless filehandle operations
6225
6226 =item Where possible, buffered data discarded from duped input filehandle
6227
6228 =item eof() has the same old magic as <>
6229
6230 =item binmode() can be used to set :crlf and :raw modes
6231
6232 =item C<-T> filetest recognizes UTF-8 encoded files as "text"
6233
6234 =item system(), backticks and pipe open now reflect exec() failure
6235
6236 =item Improved diagnostics
6237
6238 =item Diagnostics follow STDERR
6239
6240 =item More consistent close-on-exec behavior
6241
6242 =item syswrite() ease-of-use
6243
6244 =item Better syntax checks on parenthesized unary operators
6245
6246 =item Bit operators support full native integer width
6247
6248 =item Improved security features
6249
6250 =item More functional bareword prototype (*)
6251
6252 =item C<require> and C<do> may be overridden
6253
6254 =item $^X variables may now have names longer than one character
6255
6256 =item New variable $^C reflects C<-c> switch
6257
6258 =item New variable $^V contains Perl version as a string
6259
6260 =item Optional Y2K warnings
6261
6262 =item Arrays now always interpolate into double-quoted strings
6263
6264 =back
6265
6266 =item Modules and Pragmata
6267
6268 =over 4
6269
6270 =item Modules
6271
6272 attributes, B, Benchmark, ByteLoader, constant, charnames, Data::Dumper,
6273 DB, DB_File, Devel::DProf, Devel::Peek, Dumpvalue, DynaLoader, English,
6274 Env, Fcntl, File::Compare, File::Find, File::Glob, File::Spec,
6275 File::Spec::Functions, Getopt::Long, IO, JPL, lib, Math::BigInt,
6276 Math::Complex, Math::Trig, Pod::Parser, Pod::InputObjects, Pod::Checker,
6277 podchecker, Pod::ParseUtils, Pod::Find, Pod::Select, podselect, Pod::Usage,
6278 pod2usage, Pod::Text and Pod::Man, SDBM_File, Sys::Syslog, Sys::Hostname,
6279 Term::ANSIColor, Time::Local, Win32, XSLoader, DBM Filters
6280
6281 =item Pragmata
6282
6283 =back
6284
6285 =item Utility Changes
6286
6287 =over 4
6288
6289 =item dprofpp
6290
6291 =item find2perl
6292
6293 =item h2xs
6294
6295 =item perlcc
6296
6297 =item perldoc
6298
6299 =item The Perl Debugger
6300
6301 =back
6302
6303 =item Improved Documentation
6304
6305 perlapi.pod, perlboot.pod, perlcompile.pod, perldbmfilter.pod,
6306 perldebug.pod, perldebguts.pod, perlfork.pod, perlfilter.pod, perlhack.pod,
6307 perlintern.pod, perllexwarn.pod, perlnumber.pod, perlopentut.pod,
6308 perlreftut.pod, perltootc.pod, perltodo.pod, perlunicode.pod
6309
6310 =item Performance enhancements
6311
6312 =over 4
6313
6314 =item Simple sort() using { $a <=> $b } and the like are optimized
6315
6316 =item Optimized assignments to lexical variables
6317
6318 =item Faster subroutine calls
6319
6320 =item delete(), each(), values() and hash iteration are faster
6321
6322 =back
6323
6324 =item Installation and Configuration Improvements
6325
6326 =over 4
6327
6328 =item -Dusethreads means something different
6329
6330 =item New Configure flags
6331
6332 =item Threadedness and 64-bitness now more daring
6333
6334 =item Long Doubles
6335
6336 =item -Dusemorebits
6337
6338 =item -Duselargefiles
6339
6340 =item installusrbinperl
6341
6342 =item SOCKS support
6343
6344 =item C<-A> flag
6345
6346 =item Enhanced Installation Directories
6347
6348 =back
6349
6350 =item Platform specific changes
6351
6352 =over 4
6353
6354 =item Supported platforms
6355
6356 =item DOS
6357
6358 =item OS390 (OpenEdition MVS)
6359
6360 =item VMS
6361
6362 =item Win32
6363
6364 =back
6365
6366 =item Significant bug fixes
6367
6368 =over 4
6369
6370 =item <HANDLE> on empty files
6371
6372 =item C<eval '...'> improvements
6373
6374 =item All compilation errors are true errors
6375
6376 =item Implicitly closed filehandles are safer
6377
6378 =item Behavior of list slices is more consistent
6379
6380 =item C<(\$)> prototype and C<$foo{a}>
6381
6382 =item C<goto &sub> and AUTOLOAD
6383
6384 =item C<-bareword> allowed under C<use integer>
6385
6386 =item Failures in DESTROY()
6387
6388 =item Locale bugs fixed
6389
6390 =item Memory leaks
6391
6392 =item Spurious subroutine stubs after failed subroutine calls
6393
6394 =item Taint failures under C<-U>
6395
6396 =item END blocks and the C<-c> switch
6397
6398 =item Potential to leak DATA filehandles
6399
6400 =back
6401
6402 =item New or Changed Diagnostics
6403
6404 "%s" variable %s masks earlier declaration in same %s, "my sub" not yet
6405 implemented, "our" variable %s redeclared, '!' allowed only after types %s,
6406 / cannot take a count, / must be followed by a, A or Z, / must be followed
6407 by a*, A* or Z*, / must follow a numeric type, /%s/: Unrecognized escape
6408 \\%c passed through, /%s/: Unrecognized escape \\%c in character class
6409 passed through, /%s/ should probably be written as "%s", %s() called too
6410 early to check prototype, %s argument is not a HASH or ARRAY element, %s
6411 argument is not a HASH or ARRAY element or slice, %s argument is not a
6412 subroutine name, %s package attribute may clash with future reserved word:
6413 %s, (in cleanup) %s, <> should be quotes, Attempt to join self, Bad evalled
6414 substitution pattern, Bad realloc() ignored, Bareword found in conditional,
6415 Binary number > 0b11111111111111111111111111111111 non-portable, Bit vector
6416 size > 32 non-portable, Buffer overflow in prime_env_iter: %s, Can't check
6417 filesystem of script "%s", Can't declare class for non-scalar %s in "%s",
6418 Can't declare %s in "%s", Can't ignore signal CHLD, forcing to default,
6419 Can't modify non-lvalue subroutine call, Can't read CRTL environ, Can't
6420 remove %s: %s, skipping file, Can't return %s from lvalue subroutine, Can't
6421 weaken a nonreference, Character class [:%s:] unknown, Character class
6422 syntax [%s] belongs inside character classes, Constant is not %s reference,
6423 constant(%s): %s, CORE::%s is not a keyword, defined(@array) is deprecated,
6424 defined(%hash) is deprecated, Did not produce a valid header, (Did you mean
6425 "local" instead of "our"?), Document contains no data, entering effective
6426 %s failed, false [] range "%s" in regexp, Filehandle %s opened only for
6427 output, flock() on closed filehandle %s, Global symbol "%s" requires
6428 explicit package name, Hexadecimal number > 0xffffffff non-portable,
6429 Ill-formed CRTL environ value "%s", Ill-formed message in prime_env_iter:
6430 |%s|, Illegal binary digit %s, Illegal binary digit %s ignored, Illegal
6431 number of bits in vec, Integer overflow in %s number, Invalid %s attribute:
6432 %s, Invalid %s attributes: %s, invalid [] range "%s" in regexp, Invalid
6433 separator character %s in attribute list, Invalid separator character %s in
6434 subroutine attribute list, leaving effective %s failed, Lvalue subs
6435 returning %s not implemented yet, Method %s not permitted, Missing
6436 %sbrace%s on \N{}, Missing command in piped open, Missing name in "my sub",
6437 No %s specified for -%c, No package name allowed for variable %s in "our",
6438 No space allowed after -%c, no UTC offset information; assuming local time
6439 is UTC, Octal number > 037777777777 non-portable, panic: del_backref,
6440 panic: kid popen errno read, panic: magic_killbackrefs, Parentheses missing
6441 around "%s" list, Possible unintended interpolation of %s in string,
6442 Possible Y2K bug: %s, pragma "attrs" is deprecated, use "sub NAME : ATTRS"
6443 instead, Premature end of script headers, Repeat count in pack overflows,
6444 Repeat count in unpack overflows, realloc() of freed memory ignored,
6445 Reference is already weak, setpgrp can't take arguments, Strange *+?{} on
6446 zero-length expression, switching effective %s is not implemented, This
6447 Perl can't reset CRTL environ elements (%s), This Perl can't set CRTL
6448 environ elements (%s=%s), Too late to run %s block, Unknown open() mode
6449 '%s', Unknown process %x sent message to prime_env_iter: %s, Unrecognized
6450 escape \\%c passed through, Unterminated attribute parameter in attribute
6451 list, Unterminated attribute list, Unterminated attribute parameter in
6452 subroutine attribute list, Unterminated subroutine attribute list, Value of
6453 CLI symbol "%s" too long, Version number must be a constant number
6454
6455 =item New tests
6456
6457 =item Incompatible Changes
6458
6459 =over 4
6460
6461 =item Perl Source Incompatibilities
6462
6463 CHECK is a new keyword, Treatment of list slices of undef has changed,
6464 Format of $English::PERL_VERSION is different, Literals of the form
6465 C<1.2.3> parse differently, Possibly changed pseudo-random number
6466 generator, Hashing function for hash keys has changed, C<undef> fails on
6467 read only values, Close-on-exec bit may be set on pipe and socket handles,
6468 Writing C<"$$1"> to mean C<"${$}1"> is unsupported, delete(), each(),
6469 values() and C<\(%h)>, vec(EXPR,OFFSET,BITS) enforces powers-of-two BITS,
6470 Text of some diagnostic output has changed, C<%@> has been removed,
6471 Parenthesized not() behaves like a list operator, Semantics of bareword
6472 prototype C<(*)> have changed, Semantics of bit operators may have changed
6473 on 64-bit platforms, More builtins taint their results
6474
6475 =item C Source Incompatibilities
6476
6477 C<PERL_POLLUTE>, C<PERL_IMPLICIT_CONTEXT>, C<PERL_POLLUTE_MALLOC>
6478
6479 =item Compatible C Source API Changes
6480
6481 C<PATCHLEVEL> is now C<PERL_VERSION>
6482
6483 =item Binary Incompatibilities
6484
6485 =back
6486
6487 =item Known Problems
6488
6489 =over 4
6490
6491 =item Thread test failures
6492
6493 =item EBCDIC platforms not supported
6494
6495 =item In 64-bit HP-UX the lib/io_multihomed test may hang
6496
6497 =item NEXTSTEP 3.3 POSIX test failure
6498
6499 =item Tru64 (aka Digital UNIX, aka DEC OSF/1) lib/sdbm test failure with
6500 gcc
6501
6502 =item UNICOS/mk CC failures during Configure run
6503
6504 =item Arrow operator and arrays
6505
6506 =item Experimental features
6507
6508 Threads, Unicode, 64-bit support, Lvalue subroutines, Weak references, The
6509 pseudo-hash data type, The Compiler suite, Internal implementation of file
6510 globbing, The DB module, The regular expression code constructs:
6511
6512 =back
6513
6514 =item Obsolete Diagnostics
6515
6516 Character class syntax [: :] is reserved for future extensions, Ill-formed
6517 logical name |%s| in prime_env_iter, In string, @%s now must be written as
6518 \@%s, Probable precedence problem on %s, regexp too big, Use of "$$<digit>"
6519 to mean "${$}<digit>" is deprecated
6520
6521 =item Reporting Bugs
6522
6523 =item SEE ALSO
6524
6525 =item HISTORY
6526
6527 =back
6528
6529 =head2 perl5005delta - what's new for perl5.005
6530
6531 =over 4
6532
6533 =item DESCRIPTION
6534
6535 =item About the new versioning system
6536
6537 =item Incompatible Changes
6538
6539 =over 4
6540
6541 =item WARNING:  This version is not binary compatible with Perl 5.004.
6542
6543 =item Default installation structure has changed
6544
6545 =item Perl Source Compatibility
6546
6547 =item C Source Compatibility
6548
6549 =item Binary Compatibility
6550
6551 =item Security fixes may affect compatibility
6552
6553 =item Relaxed new mandatory warnings introduced in 5.004
6554
6555 =item Licensing
6556
6557 =back
6558
6559 =item Core Changes
6560
6561 =over 4
6562
6563 =item Threads
6564
6565 =item Compiler
6566
6567 =item Regular Expressions
6568
6569 Many new and improved optimizations, Many bug fixes, New regular expression
6570 constructs, New operator for precompiled regular expressions, Other
6571 improvements, Incompatible changes
6572
6573 =item   Improved malloc()
6574
6575 =item Quicksort is internally implemented
6576
6577 =item Reliable signals
6578
6579 =item Reliable stack pointers
6580
6581 =item More generous treatment of carriage returns
6582
6583 =item Memory leaks
6584
6585 =item Better support for multiple interpreters
6586
6587 =item Behavior of local() on array and hash elements is now well-defined
6588
6589 =item C<%!> is transparently tied to the L<Errno> module
6590
6591 =item Pseudo-hashes are supported
6592
6593 =item C<EXPR foreach EXPR> is supported
6594
6595 =item Keywords can be globally overridden
6596
6597 =item C<$^E> is meaningful on Win32
6598
6599 =item C<foreach (1..1000000)> optimized
6600
6601 =item C<Foo::> can be used as implicitly quoted package name
6602
6603 =item C<exists $Foo::{Bar::}> tests existence of a package
6604
6605 =item Better locale support
6606
6607 =item Experimental support for 64-bit platforms
6608
6609 =item prototype() returns useful results on builtins
6610
6611 =item Extended support for exception handling
6612
6613 =item Re-blessing in DESTROY() supported for chaining DESTROY() methods
6614
6615 =item All C<printf> format conversions are handled internally
6616
6617 =item New C<INIT> keyword
6618
6619 =item New C<lock> keyword
6620
6621 =item New C<qr//> operator
6622
6623 =item C<our> is now a reserved word
6624
6625 =item Tied arrays are now fully supported
6626
6627 =item Tied handles support is better
6628
6629 =item 4th argument to substr
6630
6631 =item Negative LENGTH argument to splice
6632
6633 =item Magic lvalues are now more magical
6634
6635 =item <> now reads in records
6636
6637 =back
6638
6639 =item Supported Platforms
6640
6641 =over 4
6642
6643 =item New Platforms
6644
6645 =item Changes in existing support
6646
6647 =back
6648
6649 =item Modules and Pragmata
6650
6651 =over 4
6652
6653 =item New Modules
6654
6655 B, Data::Dumper, Dumpvalue, Errno, File::Spec, ExtUtils::Installed,
6656 ExtUtils::Packlist, Fatal, IPC::SysV, Test, Tie::Array, Tie::Handle,
6657 Thread, attrs, fields, re
6658
6659 =item Changes in existing modules
6660
6661 Benchmark, Carp, CGI, Fcntl, Math::Complex, Math::Trig, POSIX, DB_File,
6662 MakeMaker, CPAN, Cwd
6663
6664 =back
6665
6666 =item Utility Changes
6667
6668 =item Documentation Changes
6669
6670 =item New Diagnostics
6671
6672 Ambiguous call resolved as CORE::%s(), qualify as such or use &, Bad index
6673 while coercing array into hash, Bareword "%s" refers to nonexistent
6674 package, Can't call method "%s" on an undefined value, Can't check
6675 filesystem of script "%s" for nosuid, Can't coerce array into hash, Can't
6676 goto subroutine from an eval-string, Can't localize pseudo-hash element,
6677 Can't use %%! because Errno.pm is not available, Cannot find an opnumber
6678 for "%s", Character class syntax [. .] is reserved for future extensions,
6679 Character class syntax [: :] is reserved for future extensions, Character
6680 class syntax [= =] is reserved for future extensions, %s: Eval-group in
6681 insecure regular expression, %s: Eval-group not allowed, use re 'eval', %s:
6682 Eval-group not allowed at run time, Explicit blessing to '' (assuming
6683 package main), Illegal hex digit ignored, No such array field, No such
6684 field "%s" in variable %s of type %s, Out of memory during ridiculously
6685 large request, Range iterator outside integer range, Recursive inheritance
6686 detected while looking for method '%s' %s, Reference found where even-sized
6687 list expected, Undefined value assigned to typeglob, Use of reserved word
6688 "%s" is deprecated, perl: warning: Setting locale failed
6689
6690 =item Obsolete Diagnostics
6691
6692 Can't mktemp(), Can't write to temp file for B<-e>: %s, Cannot open
6693 temporary file, regexp too big
6694
6695 =item Configuration Changes
6696
6697 =item BUGS
6698
6699 =item SEE ALSO
6700
6701 =item HISTORY
6702
6703 =back
6704
6705 =head2 perl5004delta - what's new for perl5.004
6706
6707 =over 4
6708
6709 =item DESCRIPTION
6710
6711 =item Supported Environments
6712
6713 =item Core Changes
6714
6715 =over 4
6716
6717 =item List assignment to %ENV works
6718
6719 =item Change to "Can't locate Foo.pm in @INC" error
6720
6721 =item Compilation option: Binary compatibility with 5.003
6722
6723 =item $PERL5OPT environment variable
6724
6725 =item Limitations on B<-M>, B<-m>, and B<-T> options
6726
6727 =item More precise warnings
6728
6729 =item Deprecated: Inherited C<AUTOLOAD> for non-methods
6730
6731 =item Previously deprecated %OVERLOAD is no longer usable
6732
6733 =item Subroutine arguments created only when they're modified
6734
6735 =item Group vector changeable with C<$)>
6736
6737 =item Fixed parsing of $$<digit>, &$<digit>, etc.
6738
6739 =item Fixed localization of $<digit>, $&, etc.
6740
6741 =item No resetting of $. on implicit close
6742
6743 =item C<wantarray> may return undef
6744
6745 =item C<eval EXPR> determines value of EXPR in scalar context
6746
6747 =item Changes to tainting checks
6748
6749 No glob() or <*>, No spawning if tainted $CDPATH, $ENV, $BASH_ENV, No
6750 spawning if tainted $TERM doesn't look like a terminal name
6751
6752 =item New Opcode module and revised Safe module
6753
6754 =item Embedding improvements
6755
6756 =item Internal change: FileHandle class based on IO::* classes
6757
6758 =item Internal change: PerlIO abstraction interface
6759
6760 =item New and changed syntax
6761
6762 $coderef->(PARAMS)
6763
6764 =item New and changed builtin constants
6765
6766 __PACKAGE__
6767
6768 =item New and changed builtin variables
6769
6770 $^E, $^H, $^M
6771
6772 =item New and changed builtin functions
6773
6774 delete on slices, flock, printf and sprintf, keys as an lvalue, my() in
6775 Control Structures, pack() and unpack(), sysseek(), use VERSION, use Module
6776 VERSION LIST, prototype(FUNCTION), srand, $_ as Default, C<m//gc> does not
6777 reset search position on failure, C<m//x> ignores whitespace before ?*+{},
6778 nested C<sub{}> closures work now, formats work right on changing lexicals
6779
6780 =item New builtin methods
6781
6782 isa(CLASS), can(METHOD), VERSION( [NEED] )
6783
6784 =item TIEHANDLE now supported
6785
6786 TIEHANDLE classname, LIST, PRINT this, LIST, PRINTF this, LIST, READ this
6787 LIST, READLINE this, GETC this, DESTROY this
6788
6789 =item Malloc enhancements
6790
6791 -DPERL_EMERGENCY_SBRK, -DPACK_MALLOC, -DTWO_POT_OPTIMIZE
6792
6793 =item Miscellaneous efficiency enhancements
6794
6795 =back
6796
6797 =item Support for More Operating Systems
6798
6799 =over 4
6800
6801 =item Win32
6802
6803 =item Plan 9
6804
6805 =item QNX
6806
6807 =item AmigaOS
6808
6809 =back
6810
6811 =item Pragmata
6812
6813 use autouse MODULE => qw(sub1 sub2 sub3), use blib, use blib 'dir', use
6814 constant NAME => VALUE, use locale, use ops, use vmsish
6815
6816 =item Modules
6817
6818 =over 4
6819
6820 =item Required Updates
6821
6822 =item Installation directories
6823
6824 =item Module information summary
6825
6826 =item Fcntl
6827
6828 =item IO
6829
6830 =item Math::Complex
6831
6832 =item Math::Trig
6833
6834 =item DB_File
6835
6836 =item Net::Ping
6837
6838 =item Object-oriented overrides for builtin operators
6839
6840 =back
6841
6842 =item Utility Changes
6843
6844 =over 4
6845
6846 =item pod2html
6847
6848 Sends converted HTML to standard output
6849
6850 =item xsubpp
6851
6852 C<void> XSUBs now default to returning nothing
6853
6854 =back
6855
6856 =item C Language API Changes
6857
6858 C<gv_fetchmethod> and C<perl_call_sv>, C<perl_eval_pv>, Extended API for
6859 manipulating hashes
6860
6861 =item Documentation Changes
6862
6863 L<perldelta>, L<perlfaq>, L<perllocale>, L<perltoot>, L<perlapio>,
6864 L<perlmodlib>, L<perldebug>, L<perlsec>
6865
6866 =item New Diagnostics
6867
6868 "my" variable %s masks earlier declaration in same scope, %s argument is
6869 not a HASH element or slice, Allocation too large: %lx, Allocation too
6870 large, Applying %s to %s will act on scalar(%s), Attempt to free
6871 nonexistent shared string, Attempt to use reference as lvalue in substr,
6872 Bareword "%s" refers to nonexistent package, Can't redefine active sort
6873 subroutine %s, Can't use bareword ("%s") as %s ref while "strict refs" in
6874 use, Cannot resolve method `%s' overloading `%s' in package `%s', Constant
6875 subroutine %s redefined, Constant subroutine %s undefined, Copy method did
6876 not return a reference, Died, Exiting pseudo-block via %s, Identifier too
6877 long, Illegal character %s (carriage return), Illegal switch in PERL5OPT:
6878 %s, Integer overflow in hex number, Integer overflow in octal number,
6879 internal error: glob failed, Invalid conversion in %s: "%s", Invalid type
6880 in pack: '%s', Invalid type in unpack: '%s', Name "%s::%s" used only once:
6881 possible typo, Null picture in formline, Offset outside string, Out of
6882 memory!, Out of memory during request for %s, panic: frexp, Possible
6883 attempt to put comments in qw() list, Possible attempt to separate words
6884 with commas, Scalar value @%s{%s} better written as $%s{%s}, Stub found
6885 while resolving method `%s' overloading `%s' in %s, Too late for "B<-T>"
6886 option, untie attempted while %d inner references still exist, Unrecognized
6887 character %s, Unsupported function fork, Use of "$$<digit>" to mean
6888 "${$}<digit>" is deprecated, Value of %s can be "0"; test with defined(),
6889 Variable "%s" may be unavailable, Variable "%s" will not stay shared,
6890 Warning: something's wrong, Ill-formed logical name |%s| in prime_env_iter,
6891 Got an error from DosAllocMem, Malformed PERLLIB_PREFIX, PERL_SH_DIR too
6892 long, Process terminated by SIG%s
6893
6894 =item BUGS
6895
6896 =item SEE ALSO
6897
6898 =item HISTORY
6899
6900 =back
6901
6902 =head2 perlaix, README.aix - Perl version 5 on IBM Unix (AIX) systems
6903
6904 =over 4
6905
6906 =item DESCRIPTION
6907
6908 =over 4
6909
6910 =item Compiling Perl 5 on AIX
6911
6912 =item OS level
6913
6914 =item Building Dynamic Extensions on AIX
6915
6916 =item The IBM ANSI C Compiler
6917
6918 =item Using GNU's gcc for building perl
6919
6920 =item Using Large Files with Perl
6921
6922 =item Threaded Perl
6923
6924 =item 64-bit Perl
6925
6926 =item AIX 4.2 and extensions using C++ with statics
6927
6928 =back
6929
6930 =item AUTHOR
6931
6932 =item DATE
6933
6934 =back
6935
6936 =head2 perlapollo, README.apollo - Perl version 5 on Apollo DomainOS
6937
6938 =over 4
6939
6940 =item DESCRIPTION
6941
6942 =item AUTHOR
6943
6944 =back
6945
6946 =head2 perlamiga - Perl under Amiga OS
6947
6948 =over 4
6949
6950 =item SYNOPSIS
6951
6952 =back
6953
6954 =over 4
6955
6956 =item DESCRIPTION
6957
6958 =over 4
6959
6960 =item Prerequisites for Compiling Perl on AmigaOS
6961
6962 B<Unix emulation for AmigaOS: ixemul.library>, B<Version of Amiga OS>
6963
6964 =item Starting Perl programs under AmigaOS
6965
6966 =item Shortcomings of Perl under AmigaOS
6967
6968 =back
6969
6970 =item INSTALLATION
6971
6972 =item Accessing documentation
6973
6974 =over 4
6975
6976 =item Manpages for Perl on AmigaOS
6977
6978 =item Perl HTML Documentation on AmigaOS
6979
6980 =item Perl GNU Info Files on AmigaOS
6981
6982 =item Perl LaTeX Documentation on AmigaOS
6983
6984 =back
6985
6986 =item BUILDING PERL ON AMIGAOS
6987
6988 =over 4
6989
6990 =item Build Prerequisites for Perl on AmigaOS
6991
6992 =item Getting the Perl Source for AmigaOS
6993
6994 =item Making Perl on AmigaOS
6995
6996 =item Testing Perl on AmigaOS
6997
6998 =item Installing the built Perl on AmigaOS
6999
7000 =back
7001
7002 =item AUTHORS
7003
7004 =item SEE ALSO
7005
7006 =back
7007
7008 =head2 perlbeos, README.beos - Perl version 5 on BeOS
7009
7010 =over 4
7011
7012 =item DESCRIPTION
7013
7014 =over 4
7015
7016 =item General Issues with Perl on BeOS
7017
7018 =item BeOS Release-specific Notes
7019
7020 R4 x86, R4 PPC
7021
7022 =item Contact Information
7023
7024 =item Update 2002-03-02
7025
7026 =back
7027
7028 =back
7029
7030 =head2 perlbs2000, README.BS2000 - building and installing Perl for BS2000.
7031
7032 =over 4
7033
7034 =item SYNOPSIS
7035
7036 =item DESCRIPTION
7037
7038 =over 4
7039
7040 =item gzip on BS2000
7041
7042 =item bison on BS2000
7043
7044 =item Unpacking Perl Distribution on BS2000
7045
7046 =item Compiling Perl on BS2000
7047
7048 =item Testing Perl on BS2000
7049
7050 =item Installing Perl on BS2000
7051
7052 =item Using Perl in the Posix-Shell of BS2000
7053
7054 =item Using Perl in "native" BS2000
7055
7056 =item Floating point anomalies on BS2000
7057
7058 =back
7059
7060 =item AUTHORS
7061
7062 =item SEE ALSO
7063
7064 =over 4
7065
7066 =item Mailing list
7067
7068 =back
7069
7070 =item HISTORY
7071
7072 =back
7073
7074 =over 4
7075
7076 =item Name
7077
7078 =item Description
7079
7080 =item Build
7081
7082 =over 4
7083
7084 =item Tools & SDK
7085
7086 =item Make
7087
7088 =back
7089
7090 =item Acknowledgements
7091
7092 =item Author
7093
7094 =back
7095
7096 =head2 perlcygwin, README.cygwin - Perl for Cygwin
7097
7098 =over 4
7099
7100 =item SYNOPSIS
7101
7102 =item PREREQUISITES FOR COMPILING PERL ON CYGWIN
7103
7104 =over 4
7105
7106 =item Cygwin = GNU+Cygnus+Windows (Don't leave UNIX without it)
7107
7108 =item Cygwin Configuration
7109
7110 C<PATH>, I<nroff>, Permissions
7111
7112 =back
7113
7114 =item CONFIGURE PERL ON CYGWIN
7115
7116 =over 4
7117
7118 =item Stripping Perl Binaries on Cygwin
7119
7120 =item Optional Libraries for Perl on Cygwin
7121
7122 C<-lcrypt>, C<-lgdbm> (C<use GDBM_File>), C<-ldb> (C<use DB_File>),
7123 C<-lcygipc> (C<use IPC::SysV>)
7124
7125 =item Configure-time Options for Perl on Cygwin
7126
7127 C<-Uusedl>, C<-Uusemymalloc>, C<-Uuseperlio>, C<-Dusemultiplicity>,
7128 C<-Duse64bitint>, C<-Duselongdouble>, C<-Dusethreads>, C<-Duselargefiles>,
7129 C<-Dmksymlinks>
7130
7131 =item Suspicious Warnings on Cygwin
7132
7133 I<dlsym()>, Win9x and C<d_eofnblk>, Compiler/Preprocessor defines
7134
7135 =back
7136
7137 =item MAKE ON CYGWIN
7138
7139 =over 4
7140
7141 =item Warnings on Cygwin
7142
7143 =item ld2 on Cygwin
7144
7145 =back
7146
7147 =item TEST ON CYGWIN
7148
7149 =over 4
7150
7151 =item File Permissions on Cygwin
7152
7153 =item Script Portability on Cygwin
7154
7155 Pathnames, Text/Binary, F<.exe>, chown(), Miscellaneous
7156
7157 =back
7158
7159 =item INSTALL PERL ON CYGWIN
7160
7161 =item MANIFEST ON CYGWIN
7162
7163 Documentation, Build, Configure, Make, Install, Tests, Compiled Perl
7164 Source, Compiled Module Source, Perl Modules/Scripts
7165
7166 =item BUGS ON CYGWIN
7167
7168 =item AUTHORS
7169
7170 =item HISTORY
7171
7172 =back
7173
7174 =head2 perldgux - Perl under DG/UX.
7175
7176 =over 4
7177
7178 =item SYNOPSIS
7179
7180 =back
7181
7182 =over 4
7183
7184 =item DESCRIPTION
7185
7186 =item BUILDING PERL ON DG/UX
7187
7188 =over 4
7189
7190 =item Non-threaded Perl on DG/UX
7191
7192 =item Threaded Perl on DG/UX
7193
7194 =item Testing Perl on DG/UX
7195
7196 =item Installing the built perl on DG/UX
7197
7198 =back
7199
7200 =item AUTHOR
7201
7202 =item SEE ALSO
7203
7204 =back
7205
7206 =head2 perlepoc, README.epoc - Perl for EPOC
7207
7208 =over 4
7209
7210 =item SYNOPSIS
7211
7212 =item INTRODUCTION
7213
7214 =item INSTALLING PERL ON EPOC
7215
7216 =item STARTING PERL ON EPOC
7217
7218 =over 4
7219
7220 =item Editors on Epoc
7221
7222 =item Features of Perl on Epoc
7223
7224 =item Restrictions of Perl on Epoc
7225
7226 =item Compiling Perl 5 on the EPOC cross compiling environment
7227
7228 =back
7229
7230 =item SUPPORT STATUS OF PERL ON EPOC
7231
7232 =item AUTHOR
7233
7234 =item LAST UPDATE
7235
7236 =back
7237
7238 =head2 perlhpux, README.hpux - Perl version 5 on Hewlett-Packard Unix
7239 (HP-UX) systems
7240
7241 =over 4
7242
7243 =item DESCRIPTION
7244
7245 =over 4
7246
7247 =item Using perl as shipped with HP-UX
7248
7249 =item Compiling Perl 5 on HP-UX
7250
7251 =item PA-RISC
7252
7253 =item PA-RISC 1.0
7254
7255 =item PA-RISC 1.1
7256
7257 =item PA-RISC 2.0
7258
7259 =item Itanium
7260
7261 =item Portability Between PA-RISC Versions
7262
7263 =item Itanium Processor Family and HP-UX
7264
7265 =item Building Dynamic Extensions on HP-UX
7266
7267 =item The HP ANSI C Compiler
7268
7269 =item The GNU C Compiler
7270
7271 =item Using Large Files with Perl on HP-UX
7272
7273 =item Threaded Perl on HP-UX
7274
7275 =item 64-bit Perl on HP-UX
7276
7277 =item GDBM and Threads on HP-UX
7278
7279 =item NFS filesystems and utime(2) on HP-UX
7280
7281 =item perl -P and // and HP-UX
7282
7283 =item HP-UX Kernel Parameters (maxdsiz) for Compiling Perl
7284
7285 =back
7286
7287 =item nss_delete core dump from op/pwent or op/grent
7288
7289 =item AUTHOR
7290
7291 =item DATE
7292
7293 =back
7294
7295 =head2 perlhurd, README.hurd - Perl version 5 on Hurd
7296
7297 =over 4
7298
7299 =item DESCRIPTION
7300
7301 =over 4
7302
7303 =item Known Problems with Perl on Hurd
7304
7305 =back
7306
7307 =item AUTHOR
7308
7309 =back
7310
7311 =head2 perlmachten, README.machten - Perl version 5 on Power MachTen
7312 systems
7313
7314 =over 4
7315
7316 =item DESCRIPTION
7317
7318 =over 4
7319
7320 =item Compiling Perl 5 on MachTen
7321
7322 =item Failures during C<make test> on MachTen
7323
7324 op/lexassign.t, pragma/warnings.t
7325
7326 =item Building external modules on MachTen
7327
7328 =back
7329
7330 =item AUTHOR
7331
7332 =item DATE
7333
7334 =back
7335
7336 =head2 perlmacos, README.macos - Perl under Mac OS (Classic)
7337
7338 =over 4
7339
7340 =item SYNOPSIS
7341
7342 =item DESCRIPTION
7343
7344 =item AUTHOR
7345
7346 =item DATE
7347
7348 =back
7349
7350 =head2 perlmint, README.mint - Perl version 5 on Atari MiNT
7351
7352 =over 4
7353
7354 =item DESCRIPTION
7355
7356 =item Known problems with Perl on MiNT
7357
7358 =item AUTHOR
7359
7360 =back
7361
7362 =head2 perlmpeix, README.mpeix - Perl/iX for HP e3000 MPE
7363
7364 =over 4
7365
7366 =item SYNOPSIS
7367
7368 =item NOTE
7369
7370 =item Binary distribution from HP
7371
7372 =item What's New in Perl for MPE/iX
7373
7374 =item Welcome to Perl/iX
7375
7376 =item System Requirements for Perl/iX
7377
7378 =item How to Obtain Perl/iX
7379
7380 =item Perl/iX Distribution Contents Highlights
7381
7382 README, INSTALL, LIBSHP3K, PERL, .cpan/, lib/, man/,
7383 public_html/feedback.cgi, src/perl-5.6.0-mpe
7384
7385 =item How to Compile Perl/iX
7386
7387  4,  6
7388
7389 =item Getting Started with Perl/iX
7390
7391 =item MPE/iX Implementation Considerations
7392
7393 =item Known Perl/iX Bugs Under Investigation
7394
7395 =item Perl/iX To-Do List
7396
7397 =item Perl/iX Change History
7398
7399 =item AUTHOR
7400
7401 =item Name
7402
7403 =item Description
7404
7405 =item Build
7406
7407 =over 4
7408
7409 =item Tools & SDK
7410
7411 =item Setup
7412
7413 Buildtype.bat, SetNWBld.bat, MPKBuild.bat
7414
7415 =item Make
7416
7417 =item Interpreter
7418
7419 =item Extensions
7420
7421 =back
7422
7423 =item Install
7424
7425 =item Build new extensions
7426
7427 =item Known Issues
7428
7429 =item Acknowledgements
7430
7431 =item Authors
7432
7433 =item Date
7434
7435 =back
7436
7437 =head2 perlos2 - Perl under OS/2, DOS, Win0.3*, Win0.95 and WinNT.
7438
7439 =over 4
7440
7441 =item SYNOPSIS
7442
7443 =back
7444
7445 =over 4
7446
7447 =item DESCRIPTION
7448
7449 =over 4
7450
7451 =item Target
7452
7453 =item Other OSes
7454
7455 =item Prerequisites
7456
7457 EMX, RSX, HPFS, pdksh
7458
7459 =item Starting Perl programs under OS/2 (and DOS and...)
7460
7461 =item Starting OS/2 (and DOS) programs under Perl
7462
7463 =back
7464
7465 =item Frequently asked questions
7466
7467 =over 4
7468
7469 =item "It does not work"
7470
7471 =item I cannot run external programs
7472
7473 =item I cannot embed perl into my program, or use F<perl.dll> from my
7474 program.
7475
7476 Is your program EMX-compiled with C<-Zmt -Zcrtdll>?, Did you use
7477 L<ExtUtils::Embed>?
7478
7479 =item C<``> and pipe-C<open> do not work under DOS.
7480
7481 =item Cannot start C<find.exe "pattern" file>
7482
7483 =back
7484
7485 =item INSTALLATION
7486
7487 =over 4
7488
7489 =item Automatic binary installation
7490
7491 C<PERL_BADLANG>, C<PERL_BADFREE>, F<Config.pm>
7492
7493 =item Manual binary installation
7494
7495 Perl VIO and PM executables (dynamically linked), Perl_ VIO executable
7496 (statically linked), Executables for Perl utilities, Main Perl library,
7497 Additional Perl modules, Tools to compile Perl modules, Manpages for Perl
7498 and utilities, Manpages for Perl modules, Source for Perl documentation,
7499 Perl manual in F<.INF> format, Pdksh
7500
7501 =item B<Warning>
7502
7503 =back
7504
7505 =item Accessing documentation
7506
7507 =over 4
7508
7509 =item OS/2 F<.INF> file
7510
7511 =item Plain text
7512
7513 =item Manpages
7514
7515 =item HTML
7516
7517 =item GNU C<info> files
7518
7519 =item F<PDF> files
7520
7521 =item C<LaTeX> docs
7522
7523 =back
7524
7525 =item BUILD
7526
7527 =over 4
7528
7529 =item The short story
7530
7531 =item Prerequisites
7532
7533 =item Getting perl source
7534
7535 =item Application of the patches
7536
7537 =item Hand-editing
7538
7539 =item Making
7540
7541 =item Testing
7542
7543 A lot of C<bad free>, Process terminated by SIGTERM/SIGINT, F<op/fs.t>,
7544 F<op/stat.t>
7545
7546 =item Installing the built perl
7547
7548 =item C<a.out>-style build
7549
7550 =back
7551
7552 =item Build FAQ
7553
7554 =over 4
7555
7556 =item Some C</> became C<\> in pdksh.
7557
7558 =item C<'errno'> - unresolved external
7559
7560 =item Problems with tr or sed
7561
7562 =item Some problem (forget which ;-)
7563
7564 =item Library ... not found
7565
7566 =item Segfault in make
7567
7568 =item op/sprintf test failure
7569
7570 =back
7571
7572 =item Specific (mis)features of OS/2 port
7573
7574 =over 4
7575
7576 =item C<setpriority>, C<getpriority>
7577
7578 =item C<system()>
7579
7580 =item C<extproc> on the first line
7581
7582 =item Additional modules:
7583
7584 =item Prebuilt methods:
7585
7586 C<File::Copy::syscopy>, C<DynaLoader::mod2fname>,  C<Cwd::current_drive()>,
7587  C<Cwd::sys_chdir(name)>,  C<Cwd::change_drive(name)>,
7588 C<Cwd::sys_is_absolute(name)>,  C<Cwd::sys_is_rooted(name)>,
7589 C<Cwd::sys_is_relative(name)>,  C<Cwd::sys_cwd(name)>,
7590 C<Cwd::sys_abspath(name, dir)>,  C<Cwd::extLibpath([type])>,
7591 C<Cwd::extLibpath_set( path [, type ] )>,
7592 C<OS2::Error(do_harderror,do_exception)>, C<OS2::Errors2Drive(drive)>,
7593 OS2::SysInfo(), OS2::BootDrive(), C<OS2::MorphPM(serve)>,
7594 C<OS2::UnMorphPM(serve)>, C<OS2::Serve_Messages(force)>,
7595 C<OS2::Process_Messages(force [, cnt])>, C<OS2::_control87(new,mask)>,
7596 OS2::get_control87(), C<OS2::set_control87_em(new=MCW_EM,mask=MCW_EM)>
7597
7598 =item Prebuilt variables:
7599
7600 $OS2::emx_rev, $OS2::emx_env, $OS2::os_ver
7601
7602 =item Misfeatures
7603
7604 =item Modifications
7605
7606 C<popen>, C<tmpnam>, C<tmpfile>, C<ctermid>, C<stat>, C<mkdir>, C<rmdir>,
7607 C<flock>
7608
7609 =item Identifying DLLs
7610
7611 =item Centralized management of resources
7612
7613 C<HAB>, C<HMQ>
7614
7615 =back
7616
7617 =item Perl flavors
7618
7619 =over 4
7620
7621 =item F<perl.exe>
7622
7623 =item F<perl_.exe>
7624
7625 =item F<perl__.exe>
7626
7627 =item F<perl___.exe>
7628
7629 =item Why strange names?
7630
7631 =item Why dynamic linking?
7632
7633 =item Why chimera build?
7634
7635 =back
7636
7637 =item ENVIRONMENT
7638
7639 =over 4
7640
7641 =item C<PERLLIB_PREFIX>
7642
7643 =item C<PERL_BADLANG>
7644
7645 =item C<PERL_BADFREE>
7646
7647 =item C<PERL_SH_DIR>
7648
7649 =item C<USE_PERL_FLOCK>
7650
7651 =item C<TMP> or C<TEMP>
7652
7653 =back
7654
7655 =item Evolution
7656
7657 =over 4
7658
7659 =item Priorities
7660
7661 =item DLL name mangling: pre 5.6.2
7662
7663 =item DLL name mangling: 5.6.2 and beyond
7664
7665 Global DLLs, specific DLLs, C<BEGINLIBPATH> and C<ENDLIBPATH>, F<.> from
7666 C<LIBPATH>
7667
7668 =item DLL forwarder generation
7669
7670 =item Threading
7671
7672 =item Calls to external programs
7673
7674 =item Memory allocation
7675
7676 =item Threads
7677
7678 C<COND_WAIT>, F<os2.c>
7679
7680 =back
7681
7682 =item BUGS
7683
7684 =back
7685
7686 =over 4
7687
7688 =item AUTHOR
7689
7690 =item SEE ALSO
7691
7692 =back
7693
7694 =head2 perlos390, README.os390 - building and installing Perl for OS/390
7695 and z/OS
7696
7697 =over 4
7698
7699 =item SYNOPSIS
7700
7701 =item DESCRIPTION
7702
7703 =over 4
7704
7705 =item Tools
7706
7707 =item Unpacking Perl distribution on OS/390
7708
7709 =item Setup and utilities for Perl on OS/390
7710
7711 =item Configure Perl on OS/390
7712
7713 =item Build, Test, Install Perl on OS/390
7714
7715 =item Build Anomalies with Perl on OS/390
7716
7717 =item Testing Anomalies with Perl on OS/390
7718
7719 =item Installation Anomalies with Perl on OS/390
7720
7721 =item Usage Hints for Perl on OS/390
7722
7723 =item Floating Point Anomalies with Perl on OS/390
7724
7725 =item Modules and Extensions for Perl on OS/390
7726
7727 =back
7728
7729 =item AUTHORS
7730
7731 =item SEE ALSO
7732
7733 =over 4
7734
7735 =item Mailing list for Perl on OS/390
7736
7737 =back
7738
7739 =item HISTORY
7740
7741 =back
7742
7743 =head2 perlqnx, README.qnx - Perl version 5 on QNX
7744
7745 =over 4
7746
7747 =item DESCRIPTION
7748
7749 =over 4
7750
7751 =item Required Software for Compiling Perl on QNX4
7752
7753 /bin/sh, ar, nm, cpp, make
7754
7755 =item Outstanding Issues with Perl on QNX4
7756
7757 =item QNX auxiliary files
7758
7759 qnx/ar, qnx/cpp
7760
7761 =item Outstanding issues with perl under QNX6
7762
7763 =back
7764
7765 =item AUTHOR
7766
7767 =back
7768
7769 =head2 perlplan9 - Plan 9-specific documentation for Perl
7770
7771 =over 4
7772
7773 =item DESCRIPTION
7774
7775 =over 4
7776
7777 =item Invoking Perl
7778
7779 =item What's in Plan 9 Perl
7780
7781 =item What's not in Plan 9 Perl
7782
7783 =item Perl5 Functions not currently supported in Plan 9 Perl
7784
7785 =item Signals in Plan 9 Perl
7786
7787 =back
7788
7789 =item COMPILING AND INSTALLING PERL ON PLAN 9
7790
7791 =over 4
7792
7793 =item Installing Perl Documentation on Plan 9
7794
7795 =back
7796
7797 =item BUGS
7798
7799 =item Revision date
7800
7801 =item AUTHOR
7802
7803 =back
7804
7805 =head2 perlsolaris, README.solaris - Perl version 5 on Solaris systems
7806
7807 =over 4
7808
7809 =item DESCRIPTION
7810
7811 =over 4
7812
7813 =item Solaris Version Numbers.
7814
7815 =back
7816
7817 =item RESOURCES
7818
7819 Solaris FAQ, Precompiled Binaries, Solaris Documentation
7820
7821 =item SETTING UP
7822
7823 =over 4
7824
7825 =item File Extraction Problems on Solaris.
7826
7827 =item Compiler and Related Tools on Solaris.
7828
7829 =item Environment for Compiling Perl on Solaris
7830
7831 =back
7832
7833 =item RUN CONFIGURE.
7834
7835 =over 4
7836
7837 =item 64-bit Issues with Perl on Solaris.
7838
7839 =item Threads in Perl on Solaris.
7840
7841 =item Malloc Issues with Perl on Solaris.
7842
7843 =back
7844
7845 =item MAKE PROBLEMS.
7846
7847 Dynamic Loading Problems With GNU as and GNU ld, ld.so.1: ./perl: fatal:
7848 relocation error:, dlopen: stub interception failed, #error "No
7849 DATAMODEL_NATIVE specified", sh: ar: not found
7850
7851 =item MAKE TEST
7852
7853 =over 4
7854
7855 =item op/stat.t test 4 in Solaris
7856
7857 =item nss_delete core dump from op/pwent or op/grent
7858
7859 =back
7860
7861 =item PREBUILT BINARIES OF PERL FOR SOLARIS.
7862
7863 =item RUNTIME ISSUES FOR PERL ON SOLARIS.
7864
7865 =over 4
7866
7867 =item Limits on Numbers of Open Files on Solaris.
7868
7869 =back
7870
7871 =item SOLARIS-SPECIFIC MODULES.
7872
7873 =item SOLARIS-SPECIFIC PROBLEMS WITH MODULES.
7874
7875 =over 4
7876
7877 =item Proc::ProcessTable on Solaris
7878
7879 =item BSD::Resource on Solaris
7880
7881 =item Net::SSLeay on Solaris
7882
7883 =back
7884
7885 =item AUTHOR
7886
7887 =item LAST MODIFIED
7888
7889 =back
7890
7891 =head2 perltru64, README.tru64 - Perl version 5 on Tru64 (formerly known as
7892 Digital UNIX formerly known as DEC OSF/1) systems
7893
7894 =over 4
7895
7896 =item DESCRIPTION
7897
7898 =over 4
7899
7900 =item Compiling Perl 5 on Tru64
7901
7902 =item Using Large Files with Perl on Tru64
7903
7904 =item Threaded Perl on Tru64
7905
7906 =item Long Doubles on Tru64
7907
7908 =item 64-bit Perl on Tru64
7909
7910 =item Warnings about floating-point overflow when compiling Perl on Tru64
7911
7912 =back
7913
7914 =item Testing Perl on Tru64
7915
7916 =item ext/ODBM_File/odbm Test Failing With Static Builds
7917
7918 =item AUTHOR
7919
7920 =back
7921
7922 =head2 perluts - Perl under UTS
7923
7924 =over 4
7925
7926 =item SYNOPSIS
7927
7928 =item DESCRIPTION
7929
7930 =item BUILDING PERL ON UTS
7931
7932 =item Installing the built perl on UTS
7933
7934 =item AUTHOR
7935
7936 =back
7937
7938 =head2 perlvmesa, README.vmesa - building and installing Perl for VM/ESA.
7939
7940 =over 4
7941
7942 =item SYNOPSIS
7943
7944 =item DESCRIPTION
7945
7946 =over 4
7947
7948 =item Unpacking Perl Distribution on VM/ESA
7949
7950 =item Setup Perl and utilities on VM/ESA
7951
7952 =item Configure Perl on VM/ESA
7953
7954 =item Testing Anomalies of Perl on VM/ESA
7955
7956 =item Usage Hints for Perl on VM/ESA
7957
7958 =back
7959
7960 =item AUTHORS
7961
7962 =item SEE ALSO
7963
7964 =over 4
7965
7966 =item Mailing list for Perl on VM/ESA
7967
7968 =back
7969
7970 =back
7971
7972 =head2 perlvms - VMS-specific documentation for Perl
7973
7974 =over 4
7975
7976 =item DESCRIPTION
7977
7978 =item Installation
7979
7980 =item Organization of Perl Images
7981
7982 =over 4
7983
7984 =item Core Images
7985
7986 =item Perl Extensions
7987
7988 =item Installing static extensions
7989
7990 =item Installing dynamic extensions
7991
7992 =back
7993
7994 =item File specifications
7995
7996 =over 4
7997
7998 =item Syntax
7999
8000 =item Wildcard expansion
8001
8002 =item Pipes
8003
8004 =back
8005
8006 =item PERL5LIB and PERLLIB
8007
8008 =item Command line
8009
8010 =over 4
8011
8012 =item I/O redirection and backgrounding
8013
8014 =item Command line switches
8015
8016 -i, -S, -u
8017
8018 =back
8019
8020 =item Perl functions
8021
8022 File tests, backticks, binmode FILEHANDLE, crypt PLAINTEXT, USER, dump,
8023 exec LIST, fork, getpwent, getpwnam, getpwuid, gmtime, kill, qx//, select
8024 (system call), stat EXPR, system LIST, time, times, unlink LIST, utime
8025 LIST, waitpid PID,FLAGS
8026
8027 =item Perl variables
8028
8029 %ENV, CRTL_ENV, CLISYM_[LOCAL], Any other string, $!, $^E, $?, $|
8030
8031 =item Standard modules with VMS-specific differences
8032
8033 =over 4
8034
8035 =item SDBM_File
8036
8037 =back
8038
8039 =item Revision date
8040
8041 =item AUTHOR
8042
8043 =back
8044
8045 =head2 perlvos, README.vos - Perl for Stratus VOS
8046
8047 =over 4
8048
8049 =item SYNOPSIS
8050
8051 =over 4
8052
8053 =item Multiple methods to build perl for VOS
8054
8055 =item Stratus POSIX Support
8056
8057 =back
8058
8059 =item INSTALLING PERL IN VOS
8060
8061 =over 4
8062
8063 =item Compiling Perl 5 on VOS
8064
8065 =item Installing Perl 5 on VOS
8066
8067 =back
8068
8069 =item USING PERL IN VOS
8070
8071 =over 4
8072
8073 =item Unimplemented Features of Perl on VOS
8074
8075 =item Restrictions of Perl on VOS
8076
8077 =back
8078
8079 =item SUPPORT STATUS
8080
8081 =item AUTHOR
8082
8083 =item LAST UPDATE
8084
8085 =back
8086
8087 =head1 PRAGMA DOCUMENTATION
8088
8089 =head2 attrs - set/get attributes of a subroutine (deprecated)
8090
8091 =over 4
8092
8093 =item SYNOPSIS
8094
8095 =item DESCRIPTION
8096
8097 method, locked
8098
8099 =back
8100
8101 =head2 re - Perl pragma to alter regular expression behaviour
8102
8103 =over 4
8104
8105 =item SYNOPSIS
8106
8107 =item DESCRIPTION
8108
8109 =back
8110
8111 =head2 threadshared::queue, threads::shared::queue - thread-safe queues
8112
8113 =over 4
8114
8115 =item SYNOPSIS
8116
8117 =item DESCRIPTION
8118
8119 =item FUNCTIONS AND METHODS
8120
8121 new, enqueue LIST, dequeue, dequeue_nb, pending
8122
8123 =item SEE ALSO
8124
8125 =back
8126
8127 =head2 threadshared::semaphore, threads::shared::semaphore - thread-safe
8128 semaphores
8129
8130 =over 4
8131
8132 =item SYNOPSIS
8133
8134 =item DESCRIPTION
8135
8136 =item FUNCTIONS AND METHODS
8137
8138 new, new NUMBER, down, down NUMBER, up, up NUMBER
8139
8140 =back
8141
8142 =head2 threadshared::shared, threads::shared - Perl extension for sharing
8143 data structures between threads
8144
8145 =over 4
8146
8147 =item SYNOPSIS
8148
8149 =item DESCRIPTION
8150
8151 =item EXPORT
8152
8153 =item FUNCTIONS
8154
8155 share VARIABLE, lock VARIABLE, unlock VARIABLE, cond_wait VARIABLE,
8156 cond_signal VARIABLE, cond_broadcast VARIABLE
8157
8158 =item NOTES
8159
8160 =item BUGS
8161
8162 =item AUTHOR
8163
8164 =item SEE ALSO
8165
8166 =back
8167
8168 =head2 threads - Perl extension allowing use of interpreter based threads
8169 from perl
8170
8171 =over 4
8172
8173 =item SYNOPSIS
8174
8175 =item DESCRIPTION
8176
8177 $thread = threads->create(function, LIST), $thread->join, $thread->detach,
8178 threads->self, $thread->tid, threads->yield();, threads->list();, async
8179 BLOCK;
8180
8181 =item WARNINGS
8182
8183 A thread exited while %d other threads were still running
8184
8185 =item BUGS / TODO
8186
8187 Parent-Child threads, tid is I32, Returning objects, PERL_OLD_SIGNALS are
8188 not threadsafe, will not be
8189
8190 =item AUTHOR and COPYRIGHT
8191
8192 =item SEE ALSO
8193
8194 =back
8195
8196 =head2 attributes - get/set subroutine or variable attributes
8197
8198 =over 4
8199
8200 =item SYNOPSIS
8201
8202 =item DESCRIPTION
8203
8204 =over 4
8205
8206 =item Built-in Attributes
8207
8208 locked, method, lvalue
8209
8210 =item Available Subroutines
8211
8212 get, reftype
8213
8214 =item Package-specific Attribute Handling
8215
8216 FETCH_I<type>_ATTRIBUTES, MODIFY_I<type>_ATTRIBUTES
8217
8218 =item Syntax of Attribute Lists
8219
8220 =back
8221
8222 =item EXPORTS
8223
8224 =over 4
8225
8226 =item Default exports
8227
8228 =item Available exports
8229
8230 =item Export tags defined
8231
8232 =back
8233
8234 =item EXAMPLES
8235
8236 =item SEE ALSO
8237
8238 =back
8239
8240 =head2 attrs - set/get attributes of a subroutine (deprecated)
8241
8242 =over 4
8243
8244 =item SYNOPSIS
8245
8246 =item DESCRIPTION
8247
8248 method, locked
8249
8250 =back
8251
8252 =head2 autouse - postpone load of modules until a function is used
8253
8254 =over 4
8255
8256 =item SYNOPSIS
8257
8258 =item DESCRIPTION
8259
8260 =item WARNING
8261
8262 =item AUTHOR
8263
8264 =item SEE ALSO
8265
8266 =back
8267
8268 =head2 base - Establish IS-A relationship with base class at compile time
8269
8270 =over 4
8271
8272 =item SYNOPSIS
8273
8274 =item DESCRIPTION
8275
8276 =item HISTORY
8277
8278 =item SEE ALSO
8279
8280 =back
8281
8282 =head2 bigint - Transparent big integer support for Perl
8283
8284 =over 4
8285
8286 =item SYNOPSIS
8287
8288 =item DESCRIPTION
8289
8290 =over 4
8291
8292 =item OPTIONS
8293
8294 a or accuracy, p or precision, t or trace, l or lib, v or version
8295
8296 =item MATH LIBRARY
8297
8298 =item INTERNAL FORMAT
8299
8300 =item SIGN
8301
8302 =item METHODS
8303
8304 =back
8305
8306 =item MODULES USED
8307
8308 =item EXAMPLES
8309
8310 =item LICENSE
8311
8312 =item SEE ALSO
8313
8314 =item AUTHORS
8315
8316 =back
8317
8318 =head2 bignum - Transparent BigNumber support for Perl
8319
8320 =over 4
8321
8322 =item SYNOPSIS
8323
8324 =item DESCRIPTION
8325
8326 =over 4
8327
8328 =item OPTIONS
8329
8330 a or accuracy, p or precision, t or trace, l or lib, v or version
8331
8332 =item MATH LIBRARY
8333
8334 =item INTERNAL FORMAT
8335
8336 =item SIGN
8337
8338 =item METHODS
8339
8340 =back
8341
8342 =item MODULES USED
8343
8344 =item EXAMPLES
8345
8346 =item LICENSE
8347
8348 =item SEE ALSO
8349
8350 =item AUTHORS
8351
8352 =back
8353
8354 =head2 bigrat - Transparent BigNumber/BigRational support for Perl
8355
8356 =over 4
8357
8358 =item SYNOPSIS
8359
8360 =item DESCRIPTION
8361
8362 =over 4
8363
8364 =item MODULES USED
8365
8366 =item MATH LIBRARY
8367
8368 =item SIGN
8369
8370 =item METHODS
8371
8372 =back
8373
8374 =item EXAMPLES
8375
8376         perl -Mbigrat -le 'print sqrt(33)'
8377         perl -Mbigrat -le 'print 2*255'
8378         perl -Mbigrat -le 'print 4.5+2*255'
8379         perl -Mbigrat -le 'print 3/7 + 5/7 + 8/3'
8380         perl -Mbigrat -le 'print 12->is_odd()';
8381
8382 =item LICENSE
8383
8384 =item SEE ALSO
8385
8386 =item AUTHORS
8387
8388 =back
8389
8390 =head2 blib - Use MakeMaker's uninstalled version of a package
8391
8392 =over 4
8393
8394 =item SYNOPSIS
8395
8396 =item DESCRIPTION
8397
8398 =item BUGS
8399
8400 =item AUTHOR
8401
8402 =back
8403
8404 =head2 bytes - Perl pragma to force byte semantics rather than character
8405 semantics
8406
8407 =over 4
8408
8409 =item SYNOPSIS
8410
8411 =item DESCRIPTION
8412
8413 =item SEE ALSO
8414
8415 =back
8416
8417 =head2 charnames - define character names for C<\N{named}> string literal
8418 escapes
8419
8420 =over 4
8421
8422 =item SYNOPSIS
8423
8424 =item DESCRIPTION
8425
8426 =item CUSTOM TRANSLATORS
8427
8428 =item charnames::viacode(code)
8429
8430 =item charnames::vianame(code)
8431
8432 =item ALIASES
8433
8434 =item ILLEGAL CHARACTERS
8435
8436 =item BUGS
8437
8438 =back
8439
8440 =head2 constant - Perl pragma to declare constants
8441
8442 =over 4
8443
8444 =item SYNOPSIS
8445
8446 =item DESCRIPTION
8447
8448 =item NOTES
8449
8450 =over 4
8451
8452 =item List constants
8453
8454 =item Defining multiple constants at once
8455
8456 =item Magic constants
8457
8458 =back
8459
8460 =item TECHNICAL NOTES
8461
8462 =item BUGS
8463
8464 =item AUTHOR
8465
8466 =item COPYRIGHT
8467
8468 =back
8469
8470 =head2 diagnostics - Perl compiler pragma to force verbose warning
8471 diagnostics
8472
8473 =over 4
8474
8475 =item SYNOPSIS
8476
8477 =item DESCRIPTION
8478
8479 =over 4
8480
8481 =item The C<diagnostics> Pragma
8482
8483 =item The I<splain> Program
8484
8485 =back
8486
8487 =item EXAMPLES
8488
8489 =item INTERNALS
8490
8491 =item BUGS
8492
8493 =item AUTHOR
8494
8495 =back
8496
8497 =head2 encoding - allows you to write your script in non-ascii or non-utf8
8498
8499 =over 4
8500
8501 =item SYNOPSIS
8502
8503 =item ABSTRACT
8504
8505 =item USAGE
8506
8507 use encoding [I<ENCNAME>] ;, use encoding I<ENCNAME> [ STDIN =E<gt>
8508 I<ENCNAME_IN> ...] ;, no encoding;
8509
8510 =item CAVEATS
8511
8512 =over 4
8513
8514 =item NOT SCOPED
8515
8516 =item DO NOT MIX MULTIPLE ENCODINGS
8517
8518 =back
8519
8520 =item Non-ASCII Identifiers and Filter option
8521
8522 use encoding I<ENCNAME> Filter=E<gt>1;
8523
8524 =item EXAMPLE - Greekperl
8525
8526 =item KNOWN PROBLEMS
8527
8528 =item SEE ALSO
8529
8530 =back
8531
8532 =head2 fields - compile-time class fields
8533
8534 =over 4
8535
8536 =item SYNOPSIS
8537
8538 =item DESCRIPTION
8539
8540 new, phash
8541
8542 =item SEE ALSO
8543
8544 =back
8545
8546 =head2 filetest - Perl pragma to control the filetest permission operators
8547
8548 =over 4
8549
8550 =item SYNOPSIS
8551
8552 =item DESCRIPTION
8553
8554 =over 4
8555
8556 =item subpragma access
8557
8558 =back
8559
8560 =back
8561
8562 =head2 if - C<use> a Perl module if a condition holds
8563
8564 =over 4
8565
8566 =item SYNOPSIS
8567
8568 =item DESCRIPTION
8569
8570 =item BUGS
8571
8572 =item AUTHOR
8573
8574 =back
8575
8576 =head2 integer - Perl pragma to use integer arithmetic instead of floating
8577 point
8578
8579 =over 4
8580
8581 =item SYNOPSIS
8582
8583 =item DESCRIPTION
8584
8585 =back
8586
8587 =head2 less - perl pragma to request less of something from the compiler
8588
8589 =over 4
8590
8591 =item SYNOPSIS
8592
8593 =item DESCRIPTION
8594
8595 =back
8596
8597 =head2 lib - manipulate @INC at compile time
8598
8599 =over 4
8600
8601 =item SYNOPSIS
8602
8603 =item DESCRIPTION
8604
8605 =over 4
8606
8607 =item Adding directories to @INC
8608
8609 =item Deleting directories from @INC
8610
8611 =item Restoring original @INC
8612
8613 =back
8614
8615 =item CAVEATS
8616
8617 =item SEE ALSO
8618
8619 =item AUTHOR
8620
8621 =back
8622
8623 =head2 locale - Perl pragma to use and avoid POSIX locales for built-in
8624 operations
8625
8626 =over 4
8627
8628 =item SYNOPSIS
8629
8630 =item DESCRIPTION
8631
8632 =back
8633
8634 =head2 open - perl pragma to set default disciplines for input and output
8635
8636 =over 4
8637
8638 =item SYNOPSIS
8639
8640 =item DESCRIPTION
8641
8642 =item NONPERLIO FUNCTIONALITY
8643
8644 =item IMPLEMENTATION DETAILS
8645
8646 =item SEE ALSO
8647
8648 =back
8649
8650 =head2 ops - Perl pragma to restrict unsafe operations when compiling
8651
8652 =over 4
8653
8654 =item SYNOPSIS
8655
8656 =item DESCRIPTION
8657
8658 =item SEE ALSO
8659
8660 =back
8661
8662 =head2 overload - Package for overloading perl operations
8663
8664 =over 4
8665
8666 =item SYNOPSIS
8667
8668 =item DESCRIPTION
8669
8670 =over 4
8671
8672 =item Declaration of overloaded functions
8673
8674 =item Calling Conventions for Binary Operations
8675
8676 FALSE, TRUE, C<undef>
8677
8678 =item Calling Conventions for Unary Operations
8679
8680 =item Calling Conventions for Mutators
8681
8682 C<++> and C<-->, C<x=> and other assignment versions
8683
8684 =item Overloadable Operations
8685
8686 I<Arithmetic operations>, I<Comparison operations>, I<Bit operations>,
8687 I<Increment and decrement>, I<Transcendental functions>, I<Boolean, string
8688 and numeric conversion>, I<Iteration>, I<Dereferencing>, I<Special>
8689
8690 =item Inheritance and overloading
8691
8692 Strings as values of C<use overload> directive, Overloading of an operation
8693 is inherited by derived classes
8694
8695 =back
8696
8697 =item SPECIAL SYMBOLS FOR C<use overload>
8698
8699 =over 4
8700
8701 =item Last Resort
8702
8703 =item Fallback
8704
8705 C<undef>, TRUE, defined, but FALSE
8706
8707 =item Copy Constructor
8708
8709 B<Example>
8710
8711 =back
8712
8713 =item MAGIC AUTOGENERATION
8714
8715 I<Assignment forms of arithmetic operations>, I<Conversion operations>,
8716 I<Increment and decrement>, C<abs($a)>, I<Unary minus>, I<Negation>,
8717 I<Concatenation>, I<Comparison operations>, I<Iterator>, I<Dereferencing>,
8718 I<Copy operator>
8719
8720 =item Losing overloading
8721
8722 =item Run-time Overloading
8723
8724 =item Public functions
8725
8726 overload::StrVal(arg), overload::Overloaded(arg), overload::Method(obj,op)
8727
8728 =item Overloading constants
8729
8730 integer, float, binary, q, qr
8731
8732 =item IMPLEMENTATION
8733
8734 =item Metaphor clash
8735
8736 =item Cookbook
8737
8738 =over 4
8739
8740 =item Two-face scalars
8741
8742 =item Two-face references
8743
8744 =item Symbolic calculator
8745
8746 =item I<Really> symbolic calculator
8747
8748 =back
8749
8750 =item AUTHOR
8751
8752 =item DIAGNOSTICS
8753
8754 Odd number of arguments for overload::constant, `%s' is not an overloadable
8755 type, `%s' is not a code reference
8756
8757 =item BUGS
8758
8759 =back
8760
8761 =head2 re - Perl pragma to alter regular expression behaviour
8762
8763 =over 4
8764
8765 =item SYNOPSIS
8766
8767 =item DESCRIPTION
8768
8769 =back
8770
8771 =head2 sigtrap - Perl pragma to enable simple signal handling
8772
8773 =over 4
8774
8775 =item SYNOPSIS
8776
8777 =item DESCRIPTION
8778
8779 =item OPTIONS
8780
8781 =over 4
8782
8783 =item SIGNAL HANDLERS
8784
8785 B<stack-trace>, B<die>, B<handler> I<your-handler>
8786
8787 =item SIGNAL LISTS
8788
8789 B<normal-signals>, B<error-signals>, B<old-interface-signals>
8790
8791 =item OTHER
8792
8793 B<untrapped>, B<any>, I<signal>, I<number>
8794
8795 =back
8796
8797 =item EXAMPLES
8798
8799 =back
8800
8801 =head2 sort - perl pragma to control sort() behaviour
8802
8803 =over 4
8804
8805 =item SYNOPSIS
8806
8807 =item DESCRIPTION
8808
8809 =item CAVEATS
8810
8811 =back
8812
8813 =head2 strict - Perl pragma to restrict unsafe constructs
8814
8815 =over 4
8816
8817 =item SYNOPSIS
8818
8819 =item DESCRIPTION
8820
8821 C<strict refs>, C<strict vars>, C<strict subs>
8822
8823 =back
8824
8825 =head2 subs - Perl pragma to predeclare sub names
8826
8827 =over 4
8828
8829 =item SYNOPSIS
8830
8831 =item DESCRIPTION
8832
8833 =back
8834
8835 =head2 threads - Perl extension allowing use of interpreter based threads
8836 from perl
8837
8838 =over 4
8839
8840 =item SYNOPSIS
8841
8842 =item DESCRIPTION
8843
8844 $thread = threads->create(function, LIST), $thread->join, $thread->detach,
8845 threads->self, $thread->tid, threads->yield();, threads->list();, async
8846 BLOCK;
8847
8848 =item WARNINGS
8849
8850 Cleanup skipped %d active threads
8851
8852 =item BUGS / TODO
8853
8854 Parent-Child threads, tid is I32, Returning objects, PERL_OLD_SIGNALS are
8855 not threadsafe, will not be
8856
8857 =item AUTHOR and COPYRIGHT
8858
8859 =item SEE ALSO
8860
8861 =back
8862
8863 =head2 threadshared, threads::shared - Perl extension for sharing data
8864 structures between threads
8865
8866 =over 4
8867
8868 =item SYNOPSIS
8869
8870 =item DESCRIPTION
8871
8872 =item EXPORT
8873
8874 =item FUNCTIONS
8875
8876 share VARIABLE, lock VARIABLE, unlock VARIABLE, cond_wait VARIABLE,
8877 cond_signal VARIABLE, cond_broadcast VARIABLE
8878
8879 =item NOTES
8880
8881 =item BUGS
8882
8883 =item AUTHOR
8884
8885 =item SEE ALSO
8886
8887 =back
8888
8889 =head2 threadshared::queue, threads::shared::queue - thread-safe queues
8890
8891 =over 4
8892
8893 =item SYNOPSIS
8894
8895 =item DESCRIPTION
8896
8897 =item FUNCTIONS AND METHODS
8898
8899 new, enqueue LIST, dequeue, dequeue_nb, pending
8900
8901 =item SEE ALSO
8902
8903 =back
8904
8905 =head2 threadshared::semaphore, threads::shared::semaphore - thread-safe
8906 semaphores
8907
8908 =over 4
8909
8910 =item SYNOPSIS
8911
8912 =item DESCRIPTION
8913
8914 =item FUNCTIONS AND METHODS
8915
8916 new, new NUMBER, down, down NUMBER, up, up NUMBER
8917
8918 =back
8919
8920 =head2 utf8 - Perl pragma to enable/disable UTF-8 (or UTF-EBCDIC) in source
8921 code
8922
8923 =over 4
8924
8925 =item SYNOPSIS
8926
8927 =item DESCRIPTION
8928
8929 =over 4
8930
8931 =item Utility functions
8932
8933 $num_octets = utf8::upgrade($string);, utf8::downgrade($string[, FAIL_OK]),
8934 utf8::encode($string), $flag = utf8::decode($string), $flag =
8935 utf8::valid(STRING)
8936
8937 =back
8938
8939 =item SEE ALSO
8940
8941 =back
8942
8943 =head2 vars - Perl pragma to predeclare global variable names (obsolete)
8944
8945 =over 4
8946
8947 =item SYNOPSIS
8948
8949 =item DESCRIPTION
8950
8951 =back
8952
8953 =head2 vmsish - Perl pragma to control VMS-specific language features
8954
8955 =over 4
8956
8957 =item SYNOPSIS
8958
8959 =item DESCRIPTION
8960
8961 C<vmsish status>, C<vmsish exit>, C<vmsish time>, C<vmsish hushed>
8962
8963 =back
8964
8965 =head2 warnings - Perl pragma to control optional warnings
8966
8967 =over 4
8968
8969 =item SYNOPSIS
8970
8971 =item DESCRIPTION
8972
8973 use warnings::register, warnings::enabled(), warnings::enabled($category),
8974 warnings::enabled($object), warnings::warn($message),
8975 warnings::warn($category, $message), warnings::warn($object, $message),
8976 warnings::warnif($message), warnings::warnif($category, $message),
8977 warnings::warnif($object, $message)
8978
8979 =back
8980
8981 =head2 warnings::register - warnings import function
8982
8983 =over 4
8984
8985 =item SYNOPSIS
8986
8987 =item DESCRIPTION
8988
8989 =back
8990
8991 =head1 MODULE DOCUMENTATION
8992
8993 =head2 AnyDBM_File - provide framework for multiple DBMs
8994
8995 =over 4
8996
8997 =item SYNOPSIS
8998
8999 =item DESCRIPTION
9000
9001 =over 4
9002
9003 =item DBM Comparisons
9004
9005 [0], [1], [2], [3]
9006
9007 =back
9008
9009 =item SEE ALSO
9010
9011 =back
9012
9013 =head2 Attribute::Handlers - Simpler definition of attribute handlers
9014
9015 =over 4
9016
9017 =item VERSION
9018
9019 =item SYNOPSIS
9020
9021 =item DESCRIPTION
9022
9023 [0], [1], [2], [3], [4], [5]
9024
9025 =over 4
9026
9027 =item Typed lexicals
9028
9029 =item Type-specific attribute handlers
9030
9031 =item Non-interpretive attribute handlers
9032
9033 =item Phase-specific attribute handlers
9034
9035 =item Attributes as C<tie> interfaces
9036
9037 =back
9038
9039 =item EXAMPLES
9040
9041 =item DIAGNOSTICS
9042
9043 C<Bad attribute type: ATTR(%s)>, C<Attribute handler %s doesn't handle %s
9044 attributes>, C<Declaration of %s attribute in package %s may clash with
9045 future reserved word>, C<Can't have two ATTR specifiers on one subroutine>,
9046 C<Can't autotie a %s>, C<Internal error: %s symbol went missing>, C<Won't
9047 be able to apply END handler>
9048
9049 =item AUTHOR
9050
9051 =item BUGS
9052
9053 =item COPYRIGHT
9054
9055 =back
9056
9057 =head2 AutoLoader - load subroutines only on demand
9058
9059 =over 4
9060
9061 =item SYNOPSIS
9062
9063 =item DESCRIPTION
9064
9065 =over 4
9066
9067 =item Subroutine Stubs
9068
9069 =item Using B<AutoLoader>'s AUTOLOAD Subroutine
9070
9071 =item Overriding B<AutoLoader>'s AUTOLOAD Subroutine
9072
9073 =item Package Lexicals
9074
9075 =item Not Using AutoLoader
9076
9077 =item B<AutoLoader> vs. B<SelfLoader>
9078
9079 =back
9080
9081 =item CAVEATS
9082
9083 =item SEE ALSO
9084
9085 =back
9086
9087 =head2 AutoSplit - split a package for autoloading
9088
9089 =over 4
9090
9091 =item SYNOPSIS
9092
9093 =item DESCRIPTION
9094
9095 $keep, $check, $modtime
9096
9097 =over 4
9098
9099 =item Multiple packages
9100
9101 =back
9102
9103 =item DIAGNOSTICS
9104
9105 =back
9106
9107 =head2 B - The Perl Compiler
9108
9109 =over 4
9110
9111 =item SYNOPSIS
9112
9113 =item DESCRIPTION
9114
9115 =item OVERVIEW OF CLASSES
9116
9117 =over 4
9118
9119 =item SV-RELATED CLASSES
9120
9121 =item B::SV METHODS
9122
9123 REFCNT, FLAGS
9124
9125 =item B::IV METHODS
9126
9127 IV, IVX, UVX, int_value, needs64bits, packiv
9128
9129 =item B::NV METHODS
9130
9131 NV, NVX
9132
9133 =item B::RV METHODS
9134
9135 RV
9136
9137 =item B::PV METHODS
9138
9139 PV, RV, PVX
9140
9141 =item B::PVMG METHODS
9142
9143 MAGIC, SvSTASH
9144
9145 =item B::MAGIC METHODS
9146
9147 MOREMAGIC, precomp, PRIVATE, TYPE, FLAGS, OBJ, PTR, REGEX
9148
9149 =item B::PVLV METHODS
9150
9151 TARGOFF, TARGLEN, TYPE, TARG
9152
9153 =item B::BM METHODS
9154
9155 USEFUL, PREVIOUS, RARE, TABLE
9156
9157 =item B::GV METHODS
9158
9159 is_empty, NAME, SAFENAME, STASH, SV, IO, FORM, AV, HV, EGV, CV, CVGEN,
9160 LINE, FILE, FILEGV, GvREFCNT, FLAGS
9161
9162 =item B::IO METHODS
9163
9164 LINES, PAGE, PAGE_LEN, LINES_LEFT, TOP_NAME, TOP_GV, FMT_NAME, FMT_GV,
9165 BOTTOM_NAME, BOTTOM_GV, SUBPROCESS, IoTYPE, IoFLAGS, IsSTD
9166
9167 =item B::AV METHODS
9168
9169 FILL, MAX, OFF, ARRAY, AvFLAGS
9170
9171 =item B::CV METHODS
9172
9173 STASH, START, ROOT, GV, FILE, DEPTH, PADLIST, OUTSIDE, XSUB, XSUBANY,
9174 CvFLAGS, const_sv
9175
9176 =item B::HV METHODS
9177
9178 FILL, MAX, KEYS, RITER, NAME, PMROOT, ARRAY
9179
9180 =item OP-RELATED CLASSES
9181
9182 =item B::OP METHODS
9183
9184 next, sibling, name, ppaddr, desc, targ, type, seq, flags, private
9185
9186 =item B::UNOP METHOD
9187
9188 first
9189
9190 =item B::BINOP METHOD
9191
9192 last
9193
9194 =item B::LOGOP METHOD
9195
9196 other
9197
9198 =item B::LISTOP METHOD
9199
9200 children
9201
9202 =item B::PMOP METHODS
9203
9204 pmreplroot, pmreplstart, pmnext, pmregexp, pmflags, pmdynflags,
9205 pmpermflags, precomp, pmoffet
9206
9207 =item B::SVOP METHOD
9208
9209 sv, gv
9210
9211 =item B::PADOP METHOD
9212
9213 padix
9214
9215 =item B::PVOP METHOD
9216
9217 pv
9218
9219 =item B::LOOP METHODS
9220
9221 redoop, nextop, lastop
9222
9223 =item B::COP METHODS
9224
9225 label, stash, file, cop_seq, arybase, line
9226
9227 =back
9228
9229 =item FUNCTIONS EXPORTED BY C<B>
9230
9231 main_cv, init_av, begin_av, end_av, main_root, main_start, comppadlist,
9232 regex_padav, sv_undef, sv_yes, sv_no, amagic_generation, walkoptree(OP,
9233 METHOD), walkoptree_debug(DEBUG), walksymtable(SYMREF, METHOD, RECURSE,
9234 PREFIX), svref_2object(SV), ppname(OPNUM), hash(STR), cast_I32(I), minus_c,
9235 cstring(STR), perlstring(STR), class(OBJ), threadsv_names
9236
9237 =item AUTHOR
9238
9239 =back
9240
9241 =head2 B::Asmdata - Autogenerated data about Perl ops, used to generate
9242 bytecode
9243
9244 =over 4
9245
9246 =item SYNOPSIS
9247
9248 =item DESCRIPTION
9249
9250 %insn_data, @insn_name, @optype, @specialsv_name
9251
9252 =item AUTHOR
9253
9254 =back
9255
9256 =head2 B::Assembler - Assemble Perl bytecode
9257
9258 =over 4
9259
9260 =item SYNOPSIS
9261
9262 =item DESCRIPTION
9263
9264 =item AUTHORS
9265
9266 =back
9267
9268 =head2 B::Bblock - Walk basic blocks
9269
9270 =over 4
9271
9272 =item SYNOPSIS
9273
9274 =item DESCRIPTION
9275
9276 =over 4
9277
9278 =item Functions
9279
9280 B<find_leaders>
9281
9282 =back
9283
9284 =item AUTHOR
9285
9286 =back
9287
9288 =head2 B::Bytecode - Perl compiler's bytecode backend
9289
9290 =over 4
9291
9292 =item SYNOPSIS
9293
9294 =item DESCRIPTION
9295
9296 =item OPTIONS
9297
9298 B<-ofilename>, B<-afilename>, B<-->, B<-f>, B<-fcompress-nullops>,
9299 B<-fomit-sequence-numbers>, B<-fbypass-nullops>, B<-On>, B<-D>, B<-Do>,
9300 B<-Db>, B<-Da>, B<-DC>, B<-S>, B<-upackage>
9301
9302 =item EXAMPLES
9303
9304 =item BUGS
9305
9306 =item AUTHORS
9307
9308 =back
9309
9310 =head2 B::C - Perl compiler's C backend
9311
9312 =over 4
9313
9314 =item SYNOPSIS
9315
9316 =item DESCRIPTION
9317
9318 =item OPTIONS
9319
9320 B<-ofilename>, B<-v>, B<-->, B<-uPackname>, B<-D>, B<-Do>, B<-Dc>, B<-DA>,
9321 B<-DC>, B<-DM>, B<-f>, B<-fcog>, B<-fsave-data>, B<-fppaddr>, B<-fwarn-sv>,
9322 B<-fuse-script-name>, B<-fsave-sig-hash>, B<-On>, B<-O0>, B<-O1>, B<-O2>,
9323 B<-llimit>
9324
9325 =item EXAMPLES
9326
9327 =item BUGS
9328
9329 =item AUTHOR
9330
9331 =back
9332
9333 =head2 B::CC - Perl compiler's optimized C translation backend
9334
9335 =over 4
9336
9337 =item SYNOPSIS
9338
9339 =item DESCRIPTION
9340
9341 =item OPTIONS
9342
9343 B<-ofilename>, B<-v>, B<-->, B<-uPackname>, B<-mModulename>, B<-D>, B<-Dr>,
9344 B<-DO>, B<-Ds>, B<-Dp>, B<-Dq>, B<-Dl>, B<-Dt>, B<-f>,
9345 B<-ffreetmps-each-bblock>, B<-ffreetmps-each-loop>, B<-fomit-taint>, B<-On>
9346
9347 =item EXAMPLES
9348
9349 =item BUGS
9350
9351 =item DIFFERENCES
9352
9353 =over 4
9354
9355 =item Loops
9356
9357 =item Context of ".."
9358
9359 =item Arithmetic
9360
9361 =item Deprecated features
9362
9363 =back
9364
9365 =item AUTHOR
9366
9367 =back
9368
9369 =head2 B::Concise - Walk Perl syntax tree, printing concise info about ops
9370
9371 =over 4
9372
9373 =item SYNOPSIS
9374
9375 =item DESCRIPTION
9376
9377 =item EXAMPLE
9378
9379 =item OPTIONS
9380
9381 B<-basic>, B<-exec>, B<-tree>, B<-compact>, B<-loose>, B<-vt>, B<-ascii>,
9382 B<-main>, B<-base>I<n>, B<-bigendian>, B<-littleendian>, B<-concise>,
9383 B<-terse>, B<-linenoise>, B<-debug>, B<-env>
9384
9385 =item FORMATTING SPECIFICATIONS
9386
9387 B<(x(>I<exec_text>B<;>I<basic_text>B<)x)>, B<(*(>I<text>B<)*)>,
9388 B<(*(>I<text1>B<;>I<text2>B<)*)>, B<(?(>I<text1>B<#>I<var>I<Text2>B<)?)>,
9389 B<#>I<var>, B<#>I<var>I<N>, B<~>, B<#addr>, B<#arg>, B<#class>,
9390 B<#classsym>, B<#coplabel>, B<#exname>, B<#extarg>, B<#firstaddr>,
9391 B<#flags>, B<#flagval>, B<#hyphseq>, B<#label>, B<#lastaddr>, B<#name>,
9392 B<#NAME>, B<#next>, B<#nextaddr>, B<#noise>, B<#private>, B<#privval>,
9393 B<#seq>, B<#seqnum>, B<#sibaddr>, B<#svaddr>, B<#svclass>, B<#svval>,
9394 B<#targ>, B<#targarg>, B<#targarglife>, B<#typenum>
9395
9396 =item ABBREVIATIONS
9397
9398 =over 4
9399
9400 =item OP flags abbreviations
9401
9402 =item OP class abbreviations
9403
9404 =back
9405
9406 =item Using B::Concise outside of the O framework
9407
9408 =item AUTHOR
9409
9410 =back
9411
9412 =head2 B::Debug - Walk Perl syntax tree, printing debug info about ops
9413
9414 =over 4
9415
9416 =item SYNOPSIS
9417
9418 =item DESCRIPTION
9419
9420 =item AUTHOR
9421
9422 =back
9423
9424 =head2 B::Deparse - Perl compiler backend to produce perl code
9425
9426 =over 4
9427
9428 =item SYNOPSIS
9429
9430 =item DESCRIPTION
9431
9432 =item OPTIONS
9433
9434 B<-l>, B<-p>, B<-P>, B<-q>, B<-f>I<FILE>, B<-s>I<LETTERS>, B<C>,
9435 B<i>I<NUMBER>, B<T>, B<v>I<STRING>B<.>, B<-x>I<LEVEL>
9436
9437 =item USING B::Deparse AS A MODULE
9438
9439 =over 4
9440
9441 =item Synopsis
9442
9443 =item Description
9444
9445 =item new
9446
9447 =item ambient_pragmas
9448
9449 strict, $[, bytes, utf8, integer, re, warnings, hint_bits, warning_bits
9450
9451 =item coderef2text
9452
9453 =back
9454
9455 =item BUGS
9456
9457 =item AUTHOR
9458
9459 =back
9460
9461 =head2 B::Disassembler - Disassemble Perl bytecode
9462
9463 =over 4
9464
9465 =item SYNOPSIS
9466
9467 =item DESCRIPTION
9468
9469 =item AUTHOR
9470
9471 =back
9472
9473 =head2 B::Lint - Perl lint
9474
9475 =over 4
9476
9477 =item SYNOPSIS
9478
9479 =item DESCRIPTION
9480
9481 =item OPTIONS AND LINT CHECKS
9482
9483 B<context>, B<implicit-read> and B<implicit-write>, B<dollar-underscore>,
9484 B<private-names>, B<undefined-subs>, B<regexp-variables>, B<all>, B<none>
9485
9486 =item NON LINT-CHECK OPTIONS
9487
9488 B<-u Package>
9489
9490 =item BUGS
9491
9492 =item AUTHOR
9493
9494 =back
9495
9496 =head2 B::O, O - Generic interface to Perl Compiler backends
9497
9498 =over 4
9499
9500 =item SYNOPSIS
9501
9502 =item DESCRIPTION
9503
9504 =item CONVENTIONS
9505
9506 =item IMPLEMENTATION
9507
9508 =item BUGS
9509
9510 =item AUTHOR
9511
9512 =back
9513
9514 =head2 B::Showlex - Show lexical variables used in functions or files
9515
9516 =over 4
9517
9518 =item SYNOPSIS
9519
9520 =item DESCRIPTION
9521
9522 =item AUTHOR
9523
9524 =back
9525
9526 =head2 B::Stackobj - Helper module for CC backend
9527
9528 =over 4
9529
9530 =item SYNOPSIS
9531
9532 =item DESCRIPTION
9533
9534 =item AUTHOR
9535
9536 =back
9537
9538 =head2 B::Stash - show what stashes are loaded
9539
9540 =head2 B::Terse - Walk Perl syntax tree, printing terse info about ops
9541
9542 =over 4
9543
9544 =item SYNOPSIS
9545
9546 =item DESCRIPTION
9547
9548 =item AUTHOR
9549
9550 =back
9551
9552 =head2 B::Xref - Generates cross reference reports for Perl programs
9553
9554 =over 4
9555
9556 =item SYNOPSIS
9557
9558 =item DESCRIPTION
9559
9560 =item OPTIONS
9561
9562 C<-oFILENAME>, C<-r>, C<-d>, C<-D[tO]>
9563
9564 =item BUGS
9565
9566 =item AUTHOR
9567
9568 =back
9569
9570 =head2 Bblock, B::Bblock - Walk basic blocks
9571
9572 =over 4
9573
9574 =item SYNOPSIS
9575
9576 =item DESCRIPTION
9577
9578 =over 4
9579
9580 =item Functions
9581
9582 B<find_leaders>
9583
9584 =back
9585
9586 =item AUTHOR
9587
9588 =back
9589
9590 =head2 Benchmark - benchmark running times of Perl code
9591
9592 =over 4
9593
9594 =item SYNOPSIS
9595
9596 =item DESCRIPTION
9597
9598 =over 4
9599
9600 =item Methods
9601
9602 new, debug, iters
9603
9604 =item Standard Exports
9605
9606 timeit(COUNT, CODE), timethis ( COUNT, CODE, [ TITLE, [ STYLE ]] ),
9607 timethese ( COUNT, CODEHASHREF, [ STYLE ] ), timediff ( T1, T2 ), timestr (
9608 TIMEDIFF, [ STYLE, [ FORMAT ] ] )
9609
9610 =item Optional Exports
9611
9612 clearcache ( COUNT ), clearallcache ( ), cmpthese ( COUT, CODEHASHREF, [
9613 STYLE ] ), cmpthese ( RESULTSHASHREF, [ STYLE ] ), countit(TIME, CODE),
9614 disablecache ( ), enablecache ( ), timesum ( T1, T2 )
9615
9616 =back
9617
9618 =item NOTES
9619
9620 =item EXAMPLES
9621
9622 =item INHERITANCE
9623
9624 =item CAVEATS
9625
9626 =item SEE ALSO
9627
9628 =item AUTHORS
9629
9630 =item MODIFICATION HISTORY
9631
9632 =back
9633
9634 =head2 ByteLoader - load byte compiled perl code
9635
9636 =over 4
9637
9638 =item SYNOPSIS
9639
9640 =item DESCRIPTION
9641
9642 =item AUTHOR
9643
9644 =item SEE ALSO
9645
9646 =back
9647
9648 =head2 Bytecode, B::Bytecode - Perl compiler's bytecode backend
9649
9650 =over 4
9651
9652 =item SYNOPSIS
9653
9654 =item DESCRIPTION
9655
9656 =item OPTIONS
9657
9658 B<-ofilename>, B<-afilename>, B<-->, B<-f>, B<-fcompress-nullops>,
9659 B<-fomit-sequence-numbers>, B<-fbypass-nullops>, B<-On>, B<-D>, B<-Do>,
9660 B<-Db>, B<-Da>, B<-DC>, B<-S>, B<-upackage>
9661
9662 =item EXAMPLES
9663
9664 =item BUGS
9665
9666 =item AUTHORS
9667
9668 =back
9669
9670 =head2 CGI - Simple Common Gateway Interface Class
9671
9672 =over 4
9673
9674 =item SYNOPSIS
9675
9676 =item ABSTRACT
9677
9678 =item DESCRIPTION
9679
9680 =over 4
9681
9682 =item PROGRAMMING STYLE
9683
9684 =item CALLING CGI.PM ROUTINES
9685
9686 =item CREATING A NEW QUERY OBJECT (OBJECT-ORIENTED STYLE):
9687
9688 =item CREATING A NEW QUERY OBJECT FROM AN INPUT FILE
9689
9690 =item FETCHING A LIST OF KEYWORDS FROM THE QUERY:
9691
9692 =item FETCHING THE NAMES OF ALL THE PARAMETERS PASSED TO YOUR SCRIPT:
9693
9694 =item FETCHING THE VALUE OR VALUES OF A SINGLE NAMED PARAMETER:
9695
9696 =item SETTING THE VALUE(S) OF A NAMED PARAMETER:
9697
9698 =item APPENDING ADDITIONAL VALUES TO A NAMED PARAMETER:
9699
9700 =item IMPORTING ALL PARAMETERS INTO A NAMESPACE:
9701
9702 =item DELETING A PARAMETER COMPLETELY:
9703
9704 =item DELETING ALL PARAMETERS:
9705
9706 =item DIRECT ACCESS TO THE PARAMETER LIST:
9707
9708 =item FETCHING THE PARAMETER LIST AS A HASH:
9709
9710 =item SAVING THE STATE OF THE SCRIPT TO A FILE:
9711
9712 =item RETRIEVING CGI ERRORS
9713
9714 =item USING THE FUNCTION-ORIENTED INTERFACE
9715
9716 B<:cgi>, B<:form>, B<:html2>, B<:html3>, B<:html4>, B<:netscape>, B<:html>,
9717 B<:standard>, B<:all>
9718
9719 =item PRAGMAS
9720
9721 -any, -compile, -nosticky, -no_undef_params, -no_xhtml, -nph,
9722 -newstyle_urls, -oldstyle_urls, -autoload, -no_debug, -debug,
9723 -private_tempfiles
9724
9725 =item SPECIAL FORMS FOR IMPORTING HTML-TAG FUNCTIONS
9726
9727 1. start_table() (generates a <table> tag), 2. end_table() (generates a
9728 </table> tag), 3. start_ul() (generates a <ul> tag), 4. end_ul() (generates
9729 a </ul> tag)
9730
9731 =back
9732
9733 =item GENERATING DYNAMIC DOCUMENTS
9734
9735 =over 4
9736
9737 =item CREATING A STANDARD HTTP HEADER:
9738
9739 =item GENERATING A REDIRECTION HEADER
9740
9741 =item CREATING THE HTML DOCUMENT HEADER
9742
9743 B<Parameters:>, 4, 5, 6..
9744
9745 =item ENDING THE HTML DOCUMENT:
9746
9747 =item CREATING A SELF-REFERENCING URL THAT PRESERVES STATE INFORMATION:
9748
9749 =item OBTAINING THE SCRIPT'S URL
9750
9751 B<-absolute>, B<-relative>, B<-full>, B<-path> (B<-path_info>), B<-query>
9752 (B<-query_string>), B<-base>
9753
9754 =item MIXING POST AND URL PARAMETERS
9755
9756 =back
9757
9758 =item CREATING STANDARD HTML ELEMENTS:
9759
9760 =over 4
9761
9762 =item PROVIDING ARGUMENTS TO HTML SHORTCUTS
9763
9764 =item THE DISTRIBUTIVE PROPERTY OF HTML SHORTCUTS
9765
9766 =item HTML SHORTCUTS AND LIST INTERPOLATION
9767
9768 =item NON-STANDARD HTML SHORTCUTS
9769
9770 =item AUTOESCAPING HTML
9771
9772 $escaped_string = escapeHTML("unescaped string");, $charset =
9773 charset([$charset]);, $flag = autoEscape([$flag]);
9774
9775 =item PRETTY-PRINTING HTML
9776
9777 =back
9778
9779 =item CREATING FILL-OUT FORMS:
9780
9781 =over 4
9782
9783 =item CREATING AN ISINDEX TAG
9784
9785 =item STARTING AND ENDING A FORM
9786
9787 B<application/x-www-form-urlencoded>, B<multipart/form-data>
9788
9789 =item CREATING A TEXT FIELD
9790
9791 B<Parameters>
9792
9793 =item CREATING A BIG TEXT FIELD
9794
9795 =item CREATING A PASSWORD FIELD
9796
9797 =item CREATING A FILE UPLOAD FIELD
9798
9799 B<Parameters>
9800
9801 =item CREATING A POPUP MENU
9802
9803 =item CREATING A SCROLLING LIST
9804
9805 B<Parameters:>
9806
9807 =item CREATING A GROUP OF RELATED CHECKBOXES
9808
9809 B<Parameters:>
9810
9811 =item CREATING A STANDALONE CHECKBOX
9812
9813 B<Parameters:>
9814
9815 =item CREATING A RADIO BUTTON GROUP
9816
9817 B<Parameters:>
9818
9819 =item CREATING A SUBMIT BUTTON
9820
9821 B<Parameters:>
9822
9823 =item CREATING A RESET BUTTON
9824
9825 =item CREATING A DEFAULT BUTTON
9826
9827 =item CREATING A HIDDEN FIELD
9828
9829 B<Parameters:>
9830
9831 =item CREATING A CLICKABLE IMAGE BUTTON
9832
9833 B<Parameters:>
9834
9835 =item CREATING A JAVASCRIPT ACTION BUTTON
9836
9837 =back
9838
9839 =item HTTP COOKIES
9840
9841 1. an expiration time, 2. a domain, 3. a path, 4. a "secure" flag,
9842 B<-name>, B<-value>, B<-path>, B<-domain>, B<-expires>, B<-secure>
9843
9844 =item WORKING WITH FRAMES
9845
9846 1. Create a <Frameset> document, 2. Specify the destination for the
9847 document in the HTTP header, 3. Specify the destination for the document in
9848 the <form> tag
9849
9850 =item LIMITED SUPPORT FOR CASCADING STYLE SHEETS
9851
9852 =item DEBUGGING
9853
9854 =over 4
9855
9856 =item DUMPING OUT ALL THE NAME/VALUE PAIRS
9857
9858 =back
9859
9860 =item FETCHING ENVIRONMENT VARIABLES
9861
9862 B<Accept()>, B<raw_cookie()>, B<user_agent()>, B<path_info()>,
9863 B<path_translated()>, B<remote_host()>, B<script_name()>, B<referer()>,
9864 B<auth_type ()>, B<server_name ()>, B<virtual_host ()>, B<server_port ()>,
9865 B<server_software ()>, B<remote_user ()>, B<user_name ()>,
9866 B<request_method()>, B<content_type()>, B<http()>, B<https()>
9867
9868 =item USING NPH SCRIPTS
9869
9870 In the B<use> statement, By calling the B<nph()> method:, By using B<-nph>
9871 parameters
9872
9873 =item Server Push
9874
9875 multipart_init(), multipart_start(), multipart_end(), multipart_final()
9876
9877 =item Avoiding Denial of Service Attacks
9878
9879 B<$CGI::POST_MAX>, B<$CGI::DISABLE_UPLOADS>, B<1. On a script-by-script
9880 basis>, B<2. Globally for all scripts>
9881
9882 =item COMPATIBILITY WITH CGI-LIB.PL
9883
9884 =item AUTHOR INFORMATION
9885
9886 =item CREDITS
9887
9888 Matt Heffron (heffron@falstaff.css.beckman.com), James Taylor
9889 (james.taylor@srs.gov), Scott Anguish <sanguish@digifix.com>, Mike Jewell
9890 (mlj3u@virginia.edu), Timothy Shimmin (tes@kbs.citri.edu.au), Joergen Haegg
9891 (jh@axis.se), Laurent Delfosse (delfosse@delfosse.com), Richard Resnick
9892 (applepi1@aol.com), Craig Bishop (csb@barwonwater.vic.gov.au), Tony Curtis
9893 (tc@vcpc.univie.ac.at), Tim Bunce (Tim.Bunce@ig.co.uk), Tom Christiansen
9894 (tchrist@convex.com), Andreas Koenig (k@franz.ww.TU-Berlin.DE), Tim
9895 MacKenzie (Tim.MacKenzie@fulcrum.com.au), Kevin B. Hendricks
9896 (kbhend@dogwood.tyler.wm.edu), Stephen Dahmen (joyfire@inxpress.net), Ed
9897 Jordan (ed@fidalgo.net), David Alan Pisoni (david@cnation.com), Doug
9898 MacEachern (dougm@opengroup.org), Robin Houston (robin@oneworld.org),
9899 ...and many many more..
9900
9901 =item A COMPLETE EXAMPLE OF A SIMPLE FORM-BASED SCRIPT
9902
9903 =item BUGS
9904
9905 =item SEE ALSO
9906
9907 =back
9908
9909 =head2 CGI::Apache - Backward compatibility module for CGI.pm
9910
9911 =over 4
9912
9913 =item SYNOPSIS
9914
9915 =item ABSTRACT
9916
9917 =item DESCRIPTION
9918
9919 =item AUTHOR INFORMATION
9920
9921 =item BUGS
9922
9923 =item SEE ALSO
9924
9925 =back
9926
9927 =head2 CGI::Carp, B<CGI::Carp> - CGI routines for writing to the HTTPD (or
9928 other) error log
9929
9930 =over 4
9931
9932 =item SYNOPSIS
9933
9934 =item DESCRIPTION
9935
9936 =item REDIRECTING ERROR MESSAGES
9937
9938 =item MAKING PERL ERRORS APPEAR IN THE BROWSER WINDOW
9939
9940 =over 4
9941
9942 =item Changing the default message
9943
9944 =back
9945
9946 =item MAKING WARNINGS APPEAR AS HTML COMMENTS
9947
9948 =item CHANGE LOG
9949
9950 =item AUTHORS
9951
9952 =item SEE ALSO
9953
9954 =back
9955
9956 =head2 CGI::Cookie - Interface to Netscape Cookies
9957
9958 =over 4
9959
9960 =item SYNOPSIS
9961
9962 =item DESCRIPTION
9963
9964 =item USING CGI::Cookie
9965
9966 B<1. expiration date>, B<2. domain>, B<3. path>, B<4. secure flag>
9967
9968 =over 4
9969
9970 =item Creating New Cookies
9971
9972 =item Sending the Cookie to the Browser
9973
9974 =item Recovering Previous Cookies
9975
9976 =item Manipulating Cookies
9977
9978 B<name()>, B<value()>, B<domain()>, B<path()>, B<expires()>
9979
9980 =back
9981
9982 =item AUTHOR INFORMATION
9983
9984 =item BUGS
9985
9986 =item SEE ALSO
9987
9988 =back
9989
9990 =head2 CGI::Fast - CGI Interface for Fast CGI
9991
9992 =over 4
9993
9994 =item SYNOPSIS
9995
9996 =item DESCRIPTION
9997
9998 =item OTHER PIECES OF THE PUZZLE
9999
10000 =item WRITING FASTCGI PERL SCRIPTS
10001
10002 =item INSTALLING FASTCGI SCRIPTS
10003
10004 =item USING FASTCGI SCRIPTS AS CGI SCRIPTS
10005
10006 =item EXTERNAL FASTCGI SERVER INVOCATION
10007
10008 FCGI_SOCKET_PATH, FCGI_LISTEN_QUEUE
10009
10010 =item CAVEATS
10011
10012 =item AUTHOR INFORMATION
10013
10014 =item BUGS
10015
10016 =item SEE ALSO
10017
10018 =back
10019
10020 =head2 CGI::Pretty - module to produce nicely formatted HTML code
10021
10022 =over 4
10023
10024 =item SYNOPSIS
10025
10026 =item DESCRIPTION
10027
10028 =over 4
10029
10030 =item Tags that won't be formatted
10031
10032 =item Customizing the Indenting
10033
10034 =back
10035
10036 =item BUGS
10037
10038 =item AUTHOR
10039
10040 =item SEE ALSO
10041
10042 =back
10043
10044 =head2 CGI::Push - Simple Interface to Server Push
10045
10046 =over 4
10047
10048 =item SYNOPSIS
10049
10050 =item DESCRIPTION
10051
10052 =item USING CGI::Push
10053
10054 -next_page, -last_page, -type, -delay, -cookie, -target, -expires, -nph
10055
10056 =over 4
10057
10058 =item Heterogeneous Pages
10059
10060 =item Changing the Page Delay on the Fly
10061
10062 =back
10063
10064 =item INSTALLING CGI::Push SCRIPTS
10065
10066 =item AUTHOR INFORMATION
10067
10068 =item BUGS
10069
10070 =item SEE ALSO
10071
10072 =back
10073
10074 =head2 CGI::Switch - Backward compatibility module for defunct CGI::Switch
10075
10076 =over 4
10077
10078 =item SYNOPSIS
10079
10080 =item ABSTRACT
10081
10082 =item DESCRIPTION
10083
10084 =item AUTHOR INFORMATION
10085
10086 =item BUGS
10087
10088 =item SEE ALSO
10089
10090 =back
10091
10092 =head2 CGI::Util - Internal utilities used by CGI module
10093
10094 =over 4
10095
10096 =item SYNOPSIS
10097
10098 =item DESCRIPTION
10099
10100 =item AUTHOR INFORMATION
10101
10102 =item SEE ALSO
10103
10104 =back
10105
10106 =head2 CPAN - query, download and build perl modules from CPAN sites
10107
10108 =over 4
10109
10110 =item SYNOPSIS
10111
10112 =item DESCRIPTION
10113
10114 =over 4
10115
10116 =item Interactive Mode
10117
10118 Searching for authors, bundles, distribution files and modules, make, test,
10119 install, clean  modules or distributions, get, readme, look module or
10120 distribution, ls author, Signals
10121
10122 =item CPAN::Shell
10123
10124 =item autobundle
10125
10126 =item recompile
10127
10128 =item The four C<CPAN::*> Classes: Author, Bundle, Module, Distribution
10129
10130 =item Programmer's interface
10131
10132 expand($type,@things), expandany(@things), Programming Examples
10133
10134 =item Methods in the other Classes
10135
10136 CPAN::Author::as_glimpse(), CPAN::Author::as_string(),
10137 CPAN::Author::email(), CPAN::Author::fullname(), CPAN::Author::name(),
10138 CPAN::Bundle::as_glimpse(), CPAN::Bundle::as_string(),
10139 CPAN::Bundle::clean(), CPAN::Bundle::contains(),
10140 CPAN::Bundle::force($method,@args), CPAN::Bundle::get(),
10141 CPAN::Bundle::inst_file(), CPAN::Bundle::inst_version(),
10142 CPAN::Bundle::uptodate(), CPAN::Bundle::install(), CPAN::Bundle::make(),
10143 CPAN::Bundle::readme(), CPAN::Bundle::test(),
10144 CPAN::Distribution::as_glimpse(), CPAN::Distribution::as_string(),
10145 CPAN::Distribution::clean(), CPAN::Distribution::containsmods(),
10146 CPAN::Distribution::cvs_import(), CPAN::Distribution::dir(),
10147 CPAN::Distribution::force($method,@args), CPAN::Distribution::get(),
10148 CPAN::Distribution::install(), CPAN::Distribution::isa_perl(),
10149 CPAN::Distribution::look(), CPAN::Distribution::make(),
10150 CPAN::Distribution::prereq_pm(), CPAN::Distribution::readme(),
10151 CPAN::Distribution::test(), CPAN::Distribution::uptodate(),
10152 CPAN::Index::force_reload(), CPAN::Index::reload(), CPAN::InfoObj::dump(),
10153 CPAN::Module::as_glimpse(), CPAN::Module::as_string(),
10154 CPAN::Module::clean(), CPAN::Module::cpan_file(),
10155 CPAN::Module::cpan_version(), CPAN::Module::cvs_import(),
10156 CPAN::Module::description(), CPAN::Module::force($method,@args),
10157 CPAN::Module::get(), CPAN::Module::inst_file(),
10158 CPAN::Module::inst_version(), CPAN::Module::install(),
10159 CPAN::Module::look(), CPAN::Module::make(),
10160 CPAN::Module::manpage_headline(), CPAN::Module::readme(),
10161 CPAN::Module::test(), CPAN::Module::uptodate(), CPAN::Module::userid()
10162
10163 =item Cache Manager
10164
10165 =item Bundles
10166
10167 =item Prerequisites
10168
10169 =item Finding packages and VERSION
10170
10171 =item Debugging
10172
10173 =item Floppy, Zip, Offline Mode
10174
10175 =back
10176
10177 =item CONFIGURATION
10178
10179 C<o conf E<lt>scalar optionE<gt>>, C<o conf E<lt>scalar optionE<gt>
10180 E<lt>valueE<gt>>, C<o conf E<lt>list optionE<gt>>, C<o conf E<lt>list
10181 optionE<gt> [shift|pop]>, C<o conf E<lt>list optionE<gt>
10182 [unshift|push|splice] E<lt>listE<gt>>
10183
10184 =over 4
10185
10186 =item Note on urllist parameter's format
10187
10188 =item urllist parameter has CD-ROM support
10189
10190 =back
10191
10192 =item SECURITY
10193
10194 =item EXPORT
10195
10196 =item POPULATE AN INSTALLATION WITH LOTS OF MODULES
10197
10198 =item WORKING WITH CPAN.pm BEHIND FIREWALLS
10199
10200 =over 4
10201
10202 =item Three basic types of firewalls
10203
10204 http firewall, ftp firewall, One way visibility, SOCKS, IP Masquerade
10205
10206 =item Configuring lynx or ncftp for going through a firewall
10207
10208 =back
10209
10210 =item FAQ
10211
10212 1), 2), 3), 4), 5), 6), 7), 8), 9), 10)
10213
10214 =item BUGS
10215
10216 =item AUTHOR
10217
10218 =item TRANSLATIONS
10219
10220 =item SEE ALSO
10221
10222 =back
10223
10224 =head2 CPAN::FirstTime - Utility for CPAN::Config file Initialization
10225
10226 =over 4
10227
10228 =item SYNOPSIS
10229
10230 =item DESCRIPTION
10231
10232 =back
10233
10234 =head2 CPANox, CPAN::Nox - Wrapper around CPAN.pm without using any XS
10235 module
10236
10237 =over 4
10238
10239 =item SYNOPSIS
10240
10241 =item DESCRIPTION
10242
10243 =item  SEE ALSO
10244
10245 =back
10246
10247 =head2 Carp, carp    - warn of errors (from perspective of caller)
10248
10249 =over 4
10250
10251 =item SYNOPSIS
10252
10253 =item DESCRIPTION
10254
10255 =over 4
10256
10257 =item Forcing a Stack Trace
10258
10259 =back
10260
10261 =item BUGS
10262
10263 =back
10264
10265 =head2 Carp::Heavy, Carp heavy machinery - no user serviceable parts inside
10266
10267 =head2 Class::ISA -- report the search path for a class's ISA tree
10268
10269 =over 4
10270
10271 =item SYNOPSIS
10272
10273 =item DESCRIPTION
10274
10275 =item FUNCTIONS
10276
10277 the function Class::ISA::super_path($CLASS), the function
10278 Class::ISA::self_and_super_path($CLASS), the function
10279 Class::ISA::self_and_super_versions($CLASS)
10280
10281 =item CAUTIONARY NOTES
10282
10283 =item COPYRIGHT
10284
10285 =item AUTHOR
10286
10287 =back
10288
10289 =head2 Class::Struct - declare struct-like datatypes as Perl classes
10290
10291 =over 4
10292
10293 =item SYNOPSIS
10294
10295 =item DESCRIPTION
10296
10297 =over 4
10298
10299 =item The C<struct()> function
10300
10301 =item Class Creation at Compile Time
10302
10303 =item Element Types and Accessor Methods
10304
10305 Scalar (C<'$'> or C<'*$'>), Array (C<'@'> or C<'*@'>), Hash (C<'%'> or
10306 C<'*%'>), Class (C<'Class_Name'> or C<'*Class_Name'>)
10307
10308 =item Initializing with C<new>
10309
10310 =back
10311
10312 =item EXAMPLES
10313
10314 Example 1, Example 2, Example 3
10315
10316 =item Author and Modification History
10317
10318 =back
10319
10320 =head2 Config - access Perl configuration information
10321
10322 =over 4
10323
10324 =item SYNOPSIS
10325
10326 =item DESCRIPTION
10327
10328 myconfig(), config_sh(), config_vars(@names)
10329
10330 =item EXAMPLE
10331
10332 =item WARNING
10333
10334 =item GLOSSARY
10335
10336 =over 4
10337
10338 =item _
10339
10340 C<_a>, C<_exe>, C<_o>
10341
10342 =item a
10343
10344 C<afs>, C<afsroot>, C<alignbytes>, C<ansi2knr>, C<aphostname>,
10345 C<api_revision>, C<api_subversion>, C<api_version>, C<api_versionstring>,
10346 C<ar>, C<archlib>, C<archlibexp>, C<archname64>, C<archname>, C<archobjs>,
10347 C<asctime_r_proto>, C<awk>
10348
10349 =item b
10350
10351 C<baserev>, C<bash>, C<bin>, C<binexp>, C<bison>, C<byacc>, C<byteorder>
10352
10353 =item c
10354
10355 C<c>, C<castflags>, C<cat>, C<cc>, C<cccdlflags>, C<ccdlflags>, C<ccflags>,
10356 C<ccflags_uselargefiles>, C<ccname>, C<ccsymbols>, C<ccversion>, C<cf_by>,
10357 C<cf_email>, C<cf_time>, C<charsize>, C<chgrp>, C<chmod>, C<chown>,
10358 C<clocktype>, C<comm>, C<compress>, C<contains>, C<cp>, C<cpio>, C<cpp>,
10359 C<cpp_stuff>, C<cppccsymbols>, C<cppflags>, C<cpplast>, C<cppminus>,
10360 C<cpprun>, C<cppstdin>, C<cppsymbols>, C<crypt_r_proto>, C<cryptlib>,
10361 C<csh>, C<ctermid_r_proto>, C<ctime_r_proto>
10362
10363 =item d
10364
10365 C<d__fwalk>, C<d_access>, C<d_accessx>, C<d_alarm>, C<d_archlib>,
10366 C<d_asctime_r>, C<d_atolf>, C<d_atoll>, C<d_attribut>, C<d_bcmp>,
10367 C<d_bcopy>, C<d_bsd>, C<d_bsdgetpgrp>, C<d_bsdsetpgrp>, C<d_bzero>,
10368 C<d_casti32>, C<d_castneg>, C<d_charvspr>, C<d_chown>, C<d_chroot>,
10369 C<d_chsize>, C<d_class>, C<d_closedir>, C<d_cmsghdr_s>, C<d_const>,
10370 C<d_crypt>, C<d_crypt_r>, C<d_csh>, C<d_ctermid_r>, C<d_ctime_r>,
10371 C<d_cuserid>, C<d_dbl_dig>, C<d_dbminitproto>, C<d_difftime>, C<d_dirfd>,
10372 C<d_dirnamlen>, C<d_dlerror>, C<d_dlopen>, C<d_dlsymun>, C<d_dosuid>,
10373 C<d_drand48_r>, C<d_drand48proto>, C<d_dup2>, C<d_eaccess>, C<d_endgrent>,
10374 C<d_endgrent_r>, C<d_endhent>, C<d_endhostent_r>, C<d_endnent>,
10375 C<d_endnetent_r>, C<d_endpent>, C<d_endprotoent_r>, C<d_endpwent>,
10376 C<d_endpwent_r>, C<d_endsent>, C<d_endservent_r>, C<d_eofnblk>,
10377 C<d_eunice>, C<d_fchdir>, C<d_fchmod>, C<d_fchown>, C<d_fcntl>,
10378 C<d_fcntl_can_lock>, C<d_fd_macros>, C<d_fd_set>, C<d_fds_bits>,
10379 C<d_fgetpos>, C<d_finite>, C<d_finitel>, C<d_flexfnam>, C<d_flock>,
10380 C<d_flockproto>, C<d_fork>, C<d_fp_class>, C<d_fpathconf>, C<d_fpclass>,
10381 C<d_fpclassify>, C<d_fpclassl>, C<d_fpos64_t>, C<d_frexpl>, C<d_fs_data_s>,
10382 C<d_fseeko>, C<d_fsetpos>, C<d_fstatfs>, C<d_fstatvfs>, C<d_fsync>,
10383 C<d_ftello>, C<d_ftime>, C<d_Gconvert>, C<d_getcwd>, C<d_getespwnam>,
10384 C<d_getfsstat>, C<d_getgrent>, C<d_getgrent_r>, C<d_getgrgid_r>,
10385 C<d_getgrnam_r>, C<d_getgrps>, C<d_gethbyaddr>, C<d_gethbyname>,
10386 C<d_gethent>, C<d_gethname>, C<d_gethostbyaddr_r>, C<d_gethostbyname_r>,
10387 C<d_gethostent_r>, C<d_gethostprotos>, C<d_getitimer>, C<d_getlogin>,
10388 C<d_getlogin_r>, C<d_getmnt>, C<d_getmntent>, C<d_getnbyaddr>,
10389 C<d_getnbyname>, C<d_getnent>, C<d_getnetbyaddr_r>, C<d_getnetbyname_r>,
10390 C<d_getnetent_r>, C<d_getnetprotos>, C<d_getpagsz>, C<d_getpbyname>,
10391 C<d_getpbynumber>, C<d_getpent>, C<d_getpgid>, C<d_getpgrp2>, C<d_getpgrp>,
10392 C<d_getppid>, C<d_getprior>, C<d_getprotobyname_r>,
10393 C<d_getprotobynumber_r>, C<d_getprotoent_r>, C<d_getprotoprotos>,
10394 C<d_getprpwnam>, C<d_getpwent>, C<d_getpwent_r>, C<d_getpwnam_r>,
10395 C<d_getpwuid_r>, C<d_getsbyname>, C<d_getsbyport>, C<d_getsent>,
10396 C<d_getservbyname_r>, C<d_getservbyport_r>, C<d_getservent_r>,
10397 C<d_getservprotos>, C<d_getspnam>, C<d_getspnam_r>, C<d_gettimeod>,
10398 C<d_gmtime_r>, C<d_gnulibc>, C<d_grpasswd>, C<d_hasmntopt>, C<d_htonl>,
10399 C<d_index>, C<d_inetaton>, C<d_int64_t>, C<d_isascii>, C<d_isfinite>,
10400 C<d_isinf>, C<d_isnan>, C<d_isnanl>, C<d_killpg>, C<d_lchown>,
10401 C<d_ldbl_dig>, C<d_link>, C<d_localtime_r>, C<d_locconv>, C<d_lockf>,
10402 C<d_longdbl>, C<d_longlong>, C<d_lseekproto>, C<d_lstat>, C<d_madvise>,
10403 C<d_mblen>, C<d_mbstowcs>, C<d_mbtowc>, C<d_memchr>, C<d_memcmp>,
10404 C<d_memcpy>, C<d_memmove>, C<d_memset>, C<d_mkdir>, C<d_mkdtemp>,
10405 C<d_mkfifo>, C<d_mkstemp>, C<d_mkstemps>, C<d_mktime>, C<d_mmap>,
10406 C<d_modfl>, C<d_modfl_pow32_bug>, C<d_mprotect>, C<d_msg>, C<d_msg_ctrunc>,
10407 C<d_msg_dontroute>, C<d_msg_oob>, C<d_msg_peek>, C<d_msg_proxy>,
10408 C<d_msgctl>, C<d_msgget>, C<d_msghdr_s>, C<d_msgrcv>, C<d_msgsnd>,
10409 C<d_msync>, C<d_munmap>, C<d_mymalloc>, C<d_nice>, C<d_nl_langinfo>,
10410 C<d_nv_preserves_uv>, C<d_off64_t>, C<d_old_pthread_create_joinable>,
10411 C<d_oldpthreads>, C<d_oldsock>, C<d_open3>, C<d_pathconf>, C<d_pause>,
10412 C<d_perl_otherlibdirs>, C<d_phostname>, C<d_pipe>, C<d_poll>,
10413 C<d_portable>, C<d_PRId64>, C<d_PRIeldbl>, C<d_PRIEUldbl>, C<d_PRIfldbl>,
10414 C<d_PRIFUldbl>, C<d_PRIgldbl>, C<d_PRIGUldbl>, C<d_PRIi64>, C<d_PRIo64>,
10415 C<d_PRIu64>, C<d_PRIx64>, C<d_PRIXU64>, C<d_procselfexe>,
10416 C<d_pthread_atfork>, C<d_pthread_yield>, C<d_pwage>, C<d_pwchange>,
10417 C<d_pwclass>, C<d_pwcomment>, C<d_pwexpire>, C<d_pwgecos>, C<d_pwpasswd>,
10418 C<d_pwquota>, C<d_qgcvt>, C<d_quad>, C<d_random_r>, C<d_readdir64_r>,
10419 C<d_readdir>, C<d_readdir_r>, C<d_readlink>, C<d_readv>, C<d_recvmsg>,
10420 C<d_rename>, C<d_rewinddir>, C<d_rmdir>, C<d_safebcpy>, C<d_safemcpy>,
10421 C<d_sanemcmp>, C<d_sbrkproto>, C<d_sched_yield>, C<d_scm_rights>,
10422 C<d_SCNfldbl>, C<d_seekdir>, C<d_select>, C<d_sem>, C<d_semctl>,
10423 C<d_semctl_semid_ds>, C<d_semctl_semun>, C<d_semget>, C<d_semop>,
10424 C<d_sendmsg>, C<d_setegid>, C<d_seteuid>, C<d_setgrent>, C<d_setgrent_r>,
10425 C<d_setgrps>, C<d_sethent>, C<d_sethostent_r>, C<d_setitimer>,
10426 C<d_setlinebuf>, C<d_setlocale>, C<d_setlocale_r>, C<d_setnent>,
10427 C<d_setnetent_r>, C<d_setpent>, C<d_setpgid>, C<d_setpgrp2>, C<d_setpgrp>,
10428 C<d_setprior>, C<d_setproctitle>, C<d_setprotoent_r>, C<d_setpwent>,
10429 C<d_setpwent_r>, C<d_setregid>, C<d_setresgid>, C<d_setresuid>,
10430 C<d_setreuid>, C<d_setrgid>, C<d_setruid>, C<d_setsent>, C<d_setservent_r>,
10431 C<d_setsid>, C<d_setvbuf>, C<d_sfio>, C<d_shm>, C<d_shmat>,
10432 C<d_shmatprototype>, C<d_shmctl>, C<d_shmdt>, C<d_shmget>, C<d_sigaction>,
10433 C<d_sigprocmask>, C<d_sigsetjmp>, C<d_sockatmark>, C<d_sockatmarkproto>,
10434 C<d_socket>, C<d_socklen_t>, C<d_sockpair>, C<d_socks5_init>, C<d_sqrtl>,
10435 C<d_srand48_r>, C<d_srandom_r>, C<d_sresgproto>, C<d_sresuproto>,
10436 C<d_statblks>, C<d_statfs_f_flags>, C<d_statfs_s>, C<d_statvfs>,
10437 C<d_stdio_cnt_lval>, C<d_stdio_ptr_lval>, C<d_stdio_ptr_lval_nochange_cnt>,
10438 C<d_stdio_ptr_lval_sets_cnt>, C<d_stdio_stream_array>, C<d_stdiobase>,
10439 C<d_stdstdio>, C<d_strchr>, C<d_strcoll>, C<d_strctcpy>, C<d_strerrm>,
10440 C<d_strerror>, C<d_strerror_r>, C<d_strftime>, C<d_strtod>, C<d_strtol>,
10441 C<d_strtold>, C<d_strtoll>, C<d_strtoq>, C<d_strtoul>, C<d_strtoull>,
10442 C<d_strtouq>, C<d_strxfrm>, C<d_suidsafe>, C<d_symlink>, C<d_syscall>,
10443 C<d_syscallproto>, C<d_sysconf>, C<d_sysernlst>, C<d_syserrlst>,
10444 C<d_system>, C<d_tcgetpgrp>, C<d_tcsetpgrp>, C<d_telldir>,
10445 C<d_telldirproto>, C<d_time>, C<d_times>, C<d_tm_tm_gmtoff>,
10446 C<d_tm_tm_zone>, C<d_tmpnam_r>, C<d_truncate>, C<d_ttyname_r>, C<d_tzname>,
10447 C<d_u32align>, C<d_ualarm>, C<d_umask>, C<d_uname>, C<d_union_semun>,
10448 C<d_unordered>, C<d_usleep>, C<d_usleepproto>, C<d_ustat>, C<d_vendorarch>,
10449 C<d_vendorbin>, C<d_vendorlib>, C<d_vfork>, C<d_void_closedir>,
10450 C<d_voidsig>, C<d_voidtty>, C<d_volatile>, C<d_vprintf>, C<d_wait4>,
10451 C<d_waitpid>, C<d_wcstombs>, C<d_wctomb>, C<d_writev>, C<d_xenix>, C<date>,
10452 C<db_hashtype>, C<db_prefixtype>, C<db_version_major>, C<db_version_minor>,
10453 C<db_version_patch>, C<defvoidused>, C<direntrytype>, C<dlext>, C<dlsrc>,
10454 C<doublesize>, C<drand01>, C<drand48_r_proto>, C<dynamic_ext>
10455
10456 =item e
10457
10458 C<eagain>, C<ebcdic>, C<echo>, C<egrep>, C<emacs>, C<endgrent_r_proto>,
10459 C<endhostent_r_proto>, C<endnetent_r_proto>, C<endprotoent_r_proto>,
10460 C<endpwent_r_proto>, C<endservent_r_proto>, C<eunicefix>, C<exe_ext>,
10461 C<expr>, C<extensions>, C<extras>
10462
10463 =item f
10464
10465 C<fflushall>, C<fflushNULL>, C<find>, C<firstmakefile>, C<flex>,
10466 C<fpossize>, C<fpostype>, C<freetype>, C<from>, C<full_ar>, C<full_csh>,
10467 C<full_sed>
10468
10469 =item g
10470
10471 C<gccosandvers>, C<gccversion>, C<getgrent_r_proto>, C<getgrgid_r_proto>,
10472 C<getgrnam_r_proto>, C<gethostbyaddr_r_proto>, C<gethostbyname_r_proto>,
10473 C<gethostent_r_proto>, C<getlogin_r_proto>, C<getnetbyaddr_r_proto>,
10474 C<getnetbyname_r_proto>, C<getnetent_r_proto>, C<getprotobyname_r_proto>,
10475 C<getprotobynumber_r_proto>, C<getprotoent_r_proto>, C<getpwent_r_proto>,
10476 C<getpwnam_r_proto>, C<getpwuid_r_proto>, C<getservbyname_r_proto>,
10477 C<getservbyport_r_proto>, C<getservent_r_proto>, C<getspnam_r_proto>,
10478 C<gidformat>, C<gidsign>, C<gidsize>, C<gidtype>, C<glibpth>, C<gmake>,
10479 C<gmtime_r_proto>, C<grep>, C<groupcat>, C<groupstype>, C<gzip>
10480
10481 =item h
10482
10483 C<h_fcntl>, C<h_sysfile>, C<hint>, C<hostcat>
10484
10485 =item i
10486
10487 C<i16size>, C<i16type>, C<i32size>, C<i32type>, C<i64size>, C<i64type>,
10488 C<i8size>, C<i8type>, C<i_arpainet>, C<i_bsdioctl>, C<i_crypt>, C<i_db>,
10489 C<i_dbm>, C<i_dirent>, C<i_dld>, C<i_dlfcn>, C<i_fcntl>, C<i_float>,
10490 C<i_fp>, C<i_fp_class>, C<i_gdbm>, C<i_grp>, C<i_ieeefp>, C<i_inttypes>,
10491 C<i_langinfo>, C<i_libutil>, C<i_limits>, C<i_locale>, C<i_machcthr>,
10492 C<i_malloc>, C<i_math>, C<i_memory>, C<i_mntent>, C<i_ndbm>, C<i_netdb>,
10493 C<i_neterrno>, C<i_netinettcp>, C<i_niin>, C<i_poll>, C<i_prot>,
10494 C<i_pthread>, C<i_pwd>, C<i_rpcsvcdbm>, C<i_sfio>, C<i_sgtty>, C<i_shadow>,
10495 C<i_socks>, C<i_stdarg>, C<i_stddef>, C<i_stdlib>, C<i_string>,
10496 C<i_sunmath>, C<i_sysaccess>, C<i_sysdir>, C<i_sysfile>, C<i_sysfilio>,
10497 C<i_sysin>, C<i_sysioctl>, C<i_syslog>, C<i_sysmman>, C<i_sysmode>,
10498 C<i_sysmount>, C<i_sysndir>, C<i_sysparam>, C<i_sysresrc>, C<i_syssecrt>,
10499 C<i_sysselct>, C<i_syssockio>, C<i_sysstat>, C<i_sysstatfs>,
10500 C<i_sysstatvfs>, C<i_systime>, C<i_systimek>, C<i_systimes>, C<i_systypes>,
10501 C<i_sysuio>, C<i_sysun>, C<i_sysutsname>, C<i_sysvfs>, C<i_syswait>,
10502 C<i_termio>, C<i_termios>, C<i_time>, C<i_unistd>, C<i_ustat>, C<i_utime>,
10503 C<i_values>, C<i_varargs>, C<i_varhdr>, C<i_vfork>,
10504 C<ignore_versioned_solibs>, C<inc_version_list>, C<inc_version_list_init>,
10505 C<incpath>, C<inews>, C<installarchlib>, C<installbin>, C<installman1dir>,
10506 C<installman3dir>, C<installprefix>, C<installprefixexp>,
10507 C<installprivlib>, C<installscript>, C<installsitearch>, C<installsitebin>,
10508 C<installsitelib>, C<installstyle>, C<installusrbinperl>,
10509 C<installvendorarch>, C<installvendorbin>, C<installvendorlib>, C<intsize>,
10510 C<issymlink>, C<ivdformat>, C<ivsize>, C<ivtype>
10511
10512 =item k
10513
10514 C<known_extensions>, C<ksh>
10515
10516 =item l
10517
10518 C<ld>, C<lddlflags>, C<ldflags>, C<ldflags_uselargefiles>, C<ldlibpthname>,
10519 C<less>, C<lib_ext>, C<libc>, C<libperl>, C<libpth>, C<libs>, C<libsdirs>,
10520 C<libsfiles>, C<libsfound>, C<libspath>, C<libswanted>,
10521 C<libswanted_uselargefiles>, C<line>, C<lint>, C<lkflags>, C<ln>, C<lns>,
10522 C<localtime_r_proto>, C<locincpth>, C<loclibpth>, C<longdblsize>,
10523 C<longlongsize>, C<longsize>, C<lp>, C<lpr>, C<ls>, C<lseeksize>,
10524 C<lseektype>
10525
10526 =item m
10527
10528 C<mail>, C<mailx>, C<make>, C<make_set_make>, C<mallocobj>, C<mallocsrc>,
10529 C<malloctype>, C<man1dir>, C<man1direxp>, C<man1ext>, C<man3dir>,
10530 C<man3direxp>, C<man3ext>
10531
10532 =item M
10533
10534 C<Mcc>, C<mips_type>, C<mkdir>, C<mmaptype>, C<modetype>, C<more>,
10535 C<multiarch>, C<mv>, C<myarchname>, C<mydomain>, C<myhostname>, C<myuname>
10536
10537 =item n
10538
10539 C<n>, C<need_va_copy>, C<netdb_hlen_type>, C<netdb_host_type>,
10540 C<netdb_name_type>, C<netdb_net_type>, C<nm>, C<nm_opt>, C<nm_so_opt>,
10541 C<nonxs_ext>, C<nroff>, C<nv_preserves_uv_bits>, C<nveformat>,
10542 C<nvEUformat>, C<nvfformat>, C<nvFUformat>, C<nvgformat>, C<nvGUformat>,
10543 C<nvsize>, C<nvtype>
10544
10545 =item o
10546
10547 C<o_nonblock>, C<obj_ext>, C<old_pthread_create_joinable>, C<optimize>,
10548 C<orderlib>, C<osname>, C<osvers>, C<otherlibdirs>
10549
10550 =item p
10551
10552 C<package>, C<pager>, C<passcat>, C<patchlevel>, C<path_sep>, C<perl5>,
10553 C<perl>, C<perl_patchlevel>
10554
10555 =item P
10556
10557 C<PERL_REVISION>, C<PERL_SUBVERSION>, C<PERL_VERSION>, C<perladmin>,
10558 C<perllibs>, C<perlpath>, C<pg>, C<phostname>, C<pidtype>, C<plibpth>,
10559 C<pm_apiversion>, C<pmake>, C<pr>, C<prefix>, C<prefixexp>, C<privlib>,
10560 C<privlibexp>, C<procselfexe>, C<prototype>, C<ptrsize>
10561
10562 =item q
10563
10564 C<quadkind>, C<quadtype>
10565
10566 =item r
10567
10568 C<randbits>, C<randfunc>, C<random_r_proto>, C<randseedtype>, C<ranlib>,
10569 C<rd_nodata>, C<readdir64_r_proto>, C<readdir_r_proto>, C<revision>, C<rm>,
10570 C<rmail>, C<run>, C<runnm>
10571
10572 =item s
10573
10574 C<sched_yield>, C<scriptdir>, C<scriptdirexp>, C<sed>, C<seedfunc>,
10575 C<selectminbits>, C<selecttype>, C<sendmail>, C<setgrent_r_proto>,
10576 C<sethostent_r_proto>, C<setlocale_r_proto>, C<setnetent_r_proto>,
10577 C<setprotoent_r_proto>, C<setpwent_r_proto>, C<setservent_r_proto>, C<sh>,
10578 C<shar>, C<sharpbang>, C<shmattype>, C<shortsize>, C<shrpenv>, C<shsharp>,
10579 C<sig_count>, C<sig_name>, C<sig_name_init>, C<sig_num>, C<sig_num_init>,
10580 C<sig_size>, C<signal_t>, C<sitearch>, C<sitearchexp>, C<sitebin>,
10581 C<sitebinexp>, C<sitelib>, C<sitelib_stem>, C<sitelibexp>, C<siteprefix>,
10582 C<siteprefixexp>, C<sizesize>, C<sizetype>, C<sleep>, C<smail>, C<so>,
10583 C<sockethdr>, C<socketlib>, C<socksizetype>, C<sort>, C<spackage>,
10584 C<spitshell>, C<sPRId64>, C<sPRIeldbl>, C<sPRIEUldbl>, C<sPRIfldbl>,
10585 C<sPRIFUldbl>, C<sPRIgldbl>, C<sPRIGUldbl>, C<sPRIi64>, C<sPRIo64>,
10586 C<sPRIu64>, C<sPRIx64>, C<sPRIXU64>, C<srand48_r_proto>,
10587 C<srandom_r_proto>, C<src>, C<sSCNfldbl>, C<ssizetype>, C<startperl>,
10588 C<startsh>, C<static_ext>, C<stdchar>, C<stdio_base>, C<stdio_bufsiz>,
10589 C<stdio_cnt>, C<stdio_filbuf>, C<stdio_ptr>, C<stdio_stream_array>,
10590 C<strerror_r_proto>, C<strings>, C<submit>, C<subversion>, C<sysman>
10591
10592 =item t
10593
10594 C<tail>, C<tar>, C<targetarch>, C<tbl>, C<tee>, C<test>, C<timeincl>,
10595 C<timetype>, C<tmpnam_r_proto>, C<to>, C<touch>, C<tr>, C<trnl>, C<troff>,
10596 C<ttyname_r_proto>
10597
10598 =item u
10599
10600 C<u16size>, C<u16type>, C<u32size>, C<u32type>, C<u64size>, C<u64type>,
10601 C<u8size>, C<u8type>, C<uidformat>, C<uidsign>, C<uidsize>, C<uidtype>,
10602 C<uname>, C<uniq>, C<uquadtype>, C<use5005threads>, C<use64bitall>,
10603 C<use64bitint>, C<usecrosscompile>, C<usedl>, C<useithreads>,
10604 C<uselargefiles>, C<uselongdouble>, C<usemorebits>, C<usemultiplicity>,
10605 C<usemymalloc>, C<usenm>, C<useopcode>, C<useperlio>, C<useposix>,
10606 C<usereentrant>, C<usesfio>, C<useshrplib>, C<usesocks>, C<usethreads>,
10607 C<usevendorprefix>, C<usevfork>, C<usrinc>, C<uuname>, C<uvoformat>,
10608 C<uvsize>, C<uvtype>, C<uvuformat>, C<uvxformat>, C<uvXUformat>
10609
10610 =item v
10611
10612 C<vendorarch>, C<vendorarchexp>, C<vendorbin>, C<vendorbinexp>,
10613 C<vendorlib>, C<vendorlib_stem>, C<vendorlibexp>, C<vendorprefix>,
10614 C<vendorprefixexp>, C<version>, C<version_patchlevel_string>,
10615 C<versiononly>, C<vi>, C<voidflags>
10616
10617 =item x
10618
10619 C<xlibpth>, C<xs_apiversion>
10620
10621 =item y
10622
10623 C<yacc>, C<yaccflags>
10624
10625 =item z
10626
10627 C<zcat>, C<zip>
10628
10629 =back
10630
10631 =item NOTE
10632
10633 =back
10634
10635 =head2 Cwd - get pathname of current working directory
10636
10637 =over 4
10638
10639 =item SYNOPSIS
10640
10641 =item DESCRIPTION
10642
10643 =over 4
10644
10645 =item getcwd and friends
10646
10647 getcwd, cwd, fastcwd, fastgetcwd
10648
10649 =item abs_path and friends
10650
10651 abs_path, realpath, fast_abs_path
10652
10653 =item $ENV{PWD}
10654
10655 =back
10656
10657 =item NOTES
10658
10659 =item SEE ALSO
10660
10661 =back
10662
10663 =head2 DB - programmatic interface to the Perl debugging API (draft,
10664 subject to
10665 change)
10666
10667 =over 4
10668
10669 =item SYNOPSIS
10670
10671 =item DESCRIPTION
10672
10673 =over 4
10674
10675 =item Global Variables
10676
10677  $DB::sub,  %DB::sub,  $DB::single,  $DB::signal,  $DB::trace,  @DB::args,
10678 @DB::dbline,  %DB::dbline,  $DB::package,  $DB::filename,  $DB::subname,
10679 $DB::lineno
10680
10681 =item API Methods
10682
10683 CLIENT->register(), CLIENT->evalcode(STRING), CLIENT->skippkg('D::hide'),
10684 CLIENT->run(), CLIENT->step(), CLIENT->next(), CLIENT->done()
10685
10686 =item Client Callback Methods
10687
10688 CLIENT->init(), CLIENT->prestop([STRING]), CLIENT->stop(), CLIENT->idle(),
10689 CLIENT->poststop([STRING]), CLIENT->evalcode(STRING), CLIENT->cleanup(),
10690 CLIENT->output(LIST)
10691
10692 =back
10693
10694 =item BUGS
10695
10696 =item AUTHOR
10697
10698 =back
10699
10700 =head2 DB_File - Perl5 access to Berkeley DB version 1.x
10701
10702 =over 4
10703
10704 =item SYNOPSIS
10705
10706 =item DESCRIPTION
10707
10708 B<DB_HASH>, B<DB_BTREE>, B<DB_RECNO>
10709
10710 =over 4
10711
10712 =item Using DB_File with Berkeley DB version 2 or greater
10713
10714 =item Interface to Berkeley DB
10715
10716 =item Opening a Berkeley DB Database File
10717
10718 =item Default Parameters
10719
10720 =item In Memory Databases
10721
10722 =back
10723
10724 =item DB_HASH
10725
10726 =over 4
10727
10728 =item A Simple Example
10729
10730 =back
10731
10732 =item DB_BTREE
10733
10734 =over 4
10735
10736 =item Changing the BTREE sort order
10737
10738 =item Handling Duplicate Keys
10739
10740 =item The get_dup() Method
10741
10742 =item The find_dup() Method
10743
10744 =item The del_dup() Method
10745
10746 =item Matching Partial Keys
10747
10748 =back
10749
10750 =item DB_RECNO
10751
10752 =over 4
10753
10754 =item The 'bval' Option
10755
10756 =item A Simple Example
10757
10758 =item Extra RECNO Methods
10759
10760 B<$X-E<gt>push(list) ;>, B<$value = $X-E<gt>pop ;>, B<$X-E<gt>shift>,
10761 B<$X-E<gt>unshift(list) ;>, B<$X-E<gt>length>, B<$X-E<gt>splice(offset,
10762 length, elements);>
10763
10764 =item Another Example
10765
10766 =back
10767
10768 =item THE API INTERFACE
10769
10770 B<$status = $X-E<gt>get($key, $value [, $flags]) ;>, B<$status =
10771 $X-E<gt>put($key, $value [, $flags]) ;>, B<$status = $X-E<gt>del($key [,
10772 $flags]) ;>, B<$status = $X-E<gt>fd ;>, B<$status = $X-E<gt>seq($key,
10773 $value, $flags) ;>, B<$status = $X-E<gt>sync([$flags]) ;>
10774
10775 =item DBM FILTERS
10776
10777 B<filter_store_key>, B<filter_store_value>, B<filter_fetch_key>,
10778 B<filter_fetch_value>
10779
10780 =over 4
10781
10782 =item The Filter
10783
10784 =item An Example -- the NULL termination problem.
10785
10786 =item Another Example -- Key is a C int.
10787
10788 =back
10789
10790 =item HINTS AND TIPS
10791
10792 =over 4
10793
10794 =item Locking: The Trouble with fd
10795
10796 =item Safe ways to lock a database
10797
10798 B<Tie::DB_Lock>, B<Tie::DB_LockFile>, B<DB_File::Lock>
10799
10800 =item Sharing Databases With C Applications
10801
10802 =item The untie() Gotcha
10803
10804 =back
10805
10806 =item COMMON QUESTIONS
10807
10808 =over 4
10809
10810 =item Why is there Perl source in my database?
10811
10812 =item How do I store complex data structures with DB_File?
10813
10814 =item What does "Invalid Argument" mean?
10815
10816 =item What does "Bareword 'DB_File' not allowed" mean?
10817
10818 =back
10819
10820 =item REFERENCES
10821
10822 =item HISTORY
10823
10824 =item BUGS
10825
10826 =item AVAILABILITY
10827
10828 =item COPYRIGHT
10829
10830 =item SEE ALSO
10831
10832 =item AUTHOR
10833
10834 =back
10835
10836 =head2 Data::Dumper - stringified perl data structures, suitable for both
10837 printing and C<eval>
10838
10839 =over 4
10840
10841 =item SYNOPSIS
10842
10843 =item DESCRIPTION
10844
10845 =over 4
10846
10847 =item Methods
10848
10849 I<PACKAGE>->new(I<ARRAYREF [>, I<ARRAYREF]>), I<$OBJ>->Dump  I<or>
10850 I<PACKAGE>->Dump(I<ARRAYREF [>, I<ARRAYREF]>), I<$OBJ>->Seen(I<[HASHREF]>),
10851 I<$OBJ>->Values(I<[ARRAYREF]>), I<$OBJ>->Names(I<[ARRAYREF]>),
10852 I<$OBJ>->Reset
10853
10854 =item Functions
10855
10856 Dumper(I<LIST>)
10857
10858 =item Configuration Variables or Methods
10859
10860 $Data::Dumper::Indent  I<or>  I<$OBJ>->Indent(I<[NEWVAL]>),
10861 $Data::Dumper::Purity  I<or>  I<$OBJ>->Purity(I<[NEWVAL]>),
10862 $Data::Dumper::Pad  I<or>  I<$OBJ>->Pad(I<[NEWVAL]>),
10863 $Data::Dumper::Varname  I<or>  I<$OBJ>->Varname(I<[NEWVAL]>),
10864 $Data::Dumper::Useqq  I<or>  I<$OBJ>->Useqq(I<[NEWVAL]>),
10865 $Data::Dumper::Terse  I<or>  I<$OBJ>->Terse(I<[NEWVAL]>),
10866 $Data::Dumper::Freezer  I<or>  $I<OBJ>->Freezer(I<[NEWVAL]>),
10867 $Data::Dumper::Toaster  I<or>  $I<OBJ>->Toaster(I<[NEWVAL]>),
10868 $Data::Dumper::Deepcopy  I<or>  $I<OBJ>->Deepcopy(I<[NEWVAL]>),
10869 $Data::Dumper::Quotekeys  I<or>  $I<OBJ>->Quotekeys(I<[NEWVAL]>),
10870 $Data::Dumper::Bless  I<or>  $I<OBJ>->Bless(I<[NEWVAL]>),
10871 $Data::Dumper::Maxdepth  I<or>  $I<OBJ>->Maxdepth(I<[NEWVAL]>),
10872 $Data::Dumper::Useperl  I<or>  $I<OBJ>->Useperl(I<[NEWVAL]>),
10873 $Data::Dumper::Sortkeys  I<or>  $I<OBJ>->Sortkeys(I<[NEWVAL]>),
10874 $Data::Dumper::Deparse  I<or>  $I<OBJ>->Deparse(I<[NEWVAL]>)
10875
10876 =item Exports
10877
10878 Dumper
10879
10880 =back
10881
10882 =item EXAMPLES
10883
10884 =item BUGS
10885
10886 =item AUTHOR
10887
10888 =item VERSION
10889
10890 =item SEE ALSO
10891
10892 =back
10893
10894 =head2 Devel::DProf - a Perl code profiler
10895
10896 =over 4
10897
10898 =item SYNOPSIS
10899
10900 =item DESCRIPTION
10901
10902 =item PROFILE FORMAT
10903
10904 =item AUTOLOAD
10905
10906 =item ENVIRONMENT
10907
10908 =item BUGS
10909
10910 =item SEE ALSO
10911
10912 =back
10913
10914 =head2 Devel::PPPort, Perl/Pollution/Portability
10915
10916 =over 4
10917
10918 =item SYNOPSIS
10919
10920 =item DESCRIPTION
10921
10922 =over 4
10923
10924 =item WriteFile
10925
10926 =back
10927
10928 =item ppport.h
10929
10930 =item AUTHOR
10931
10932 =item SEE ALSO
10933
10934 =back
10935
10936 =head2 Devel::Peek - A data debugging tool for the XS programmer
10937
10938 =over 4
10939
10940 =item SYNOPSIS
10941
10942 =item DESCRIPTION
10943
10944 =over 4
10945
10946 =item Runtime debugging
10947
10948 =item Memory footprint debugging
10949
10950 =back
10951
10952 =item EXAMPLES
10953
10954 =over 4
10955
10956 =item A simple scalar string
10957
10958 =item A simple scalar number
10959
10960 =item A simple scalar with an extra reference
10961
10962 =item A reference to a simple scalar
10963
10964 =item A reference to an array
10965
10966 =item A reference to a hash
10967
10968 =item Dumping a large array or hash
10969
10970 =item A reference to an SV which holds a C pointer
10971
10972 =item A reference to a subroutine
10973
10974 =back
10975
10976 =item EXPORTS
10977
10978 =item BUGS
10979
10980 =item AUTHOR
10981
10982 =item SEE ALSO
10983
10984 =back
10985
10986 =head2 Devel::SelfStubber - generate stubs for a SelfLoading module
10987
10988 =over 4
10989
10990 =item SYNOPSIS
10991
10992 =item DESCRIPTION
10993
10994 =back
10995
10996 =head2 Digest:: - Modules that calculate message digests
10997
10998 =over 4
10999
11000 =item SYNOPSIS
11001
11002 =item DESCRIPTION
11003
11004 I<binary>, I<hex>, I<base64>
11005
11006 =item OO INTERFACE
11007
11008 $ctx = Digest->XXX($arg,...), $ctx = Digest->new(XXX => $arg,...), $ctx =
11009 Digest::XXX->new($arg,...), $ctx->reset, $ctx->add($data,...),
11010 $ctx->addfile($io_handle), $ctx->digest, $ctx->hexdigest, $ctx->b64digest
11011
11012 =item SEE ALSO
11013
11014 =item AUTHOR
11015
11016 =back
11017
11018 =head2 Digest::MD5 - Perl interface to the MD5 Algorithm
11019
11020 =over 4
11021
11022 =item SYNOPSIS
11023
11024 =item DESCRIPTION
11025
11026 =item FUNCTIONS
11027
11028 md5($data,...), md5_hex($data,...), md5_base64($data,...)
11029
11030 =item METHODS
11031
11032 $md5 = Digest::MD5->new, $md5->reset, $md5->add($data,...),
11033 $md5->addfile($io_handle), $md5->digest, $md5->hexdigest, $md5->b64digest
11034
11035 =item EXAMPLES
11036
11037 =item SEE ALSO
11038
11039 =item COPYRIGHT
11040
11041 =item AUTHORS
11042
11043 =back
11044
11045 =head2 DirHandle - supply object methods for directory handles
11046
11047 =over 4
11048
11049 =item SYNOPSIS
11050
11051 =item DESCRIPTION
11052
11053 =item NOTES
11054
11055 =back
11056
11057 =head2 Dumpvalue - provides screen dump of Perl data.
11058
11059 =over 4
11060
11061 =item SYNOPSIS
11062
11063 =item DESCRIPTION
11064
11065 =over 4
11066
11067 =item Creation
11068
11069 C<arrayDepth>, C<hashDepth>, C<compactDump>, C<veryCompact>, C<globPrint>,
11070 C<dumpDBFiles>, C<dumpPackages>, C<dumpReused>, C<tick>, C<quoteHighBit>,
11071 C<printUndef>, C<usageOnly>, unctrl, subdump, bareStringify, quoteHighBit,
11072 stopDbSignal
11073
11074 =item Methods
11075
11076 dumpValue, dumpValues, stringify, dumpvars, set_quote, set_unctrl,
11077 compactDump, veryCompact, set, get
11078
11079 =back
11080
11081 =back
11082
11083 =head2 DynaLoader - Dynamically load C libraries into Perl code
11084
11085 =over 4
11086
11087 =item SYNOPSIS
11088
11089 =item DESCRIPTION
11090
11091 @dl_library_path, @dl_resolve_using, @dl_require_symbols, @dl_librefs,
11092 @dl_modules, dl_error(), $dl_debug, dl_findfile(), dl_expandspec(),
11093 dl_load_file(), dl_unload_file(), dl_loadflags(), dl_find_symbol(),
11094 dl_find_symbol_anywhere(), dl_undef_symbols(), dl_install_xsub(),
11095 bootstrap()
11096
11097 =item AUTHOR
11098
11099 =back
11100
11101 =head2 DynaLoader::XSLoader, XSLoader - Dynamically load C libraries into
11102 Perl code
11103
11104 =over 4
11105
11106 =item SYNOPSIS
11107
11108 =item DESCRIPTION
11109
11110 =item AUTHOR
11111
11112 =back
11113
11114 =head2 Encode - character encodings
11115
11116 =over 4
11117
11118 =item SYNOPSIS
11119
11120 =over 4
11121
11122 =item Table of Contents
11123
11124 =back
11125
11126 =item DESCRIPTION
11127
11128 =over 4
11129
11130 =item TERMINOLOGY
11131
11132 =back
11133
11134 =item PERL ENCODING API
11135
11136 $octets  = encode(ENCODING, $string [, CHECK]), $string = decode(ENCODING,
11137 $octets [, CHECK]), [$length =] from_to($octets, FROM_ENC, TO_ENC [,
11138 CHECK]), $octets = encode_utf8($string);, $string = decode_utf8($octets [,
11139 CHECK]);
11140
11141 =over 4
11142
11143 =item Listing available encodings
11144
11145 =item Defining Aliases
11146
11147 =back
11148
11149 =item Encoding via PerlIO
11150
11151 =item Handling Malformed Data
11152
11153 I<CHECK> = Encode::FB_DEFAULT ( == 0), I<CHECK> = Encode::FB_CROAK ( == 1),
11154 I<CHECK> = Encode::FB_QUIET, I<CHECK> = Encode::FB_WARN, perlqq mode
11155 (I<CHECK> = Encode::FB_PERLQQ), HTML charref mode (I<CHECK> =
11156 Encode::FB_HTMLCREF), XML charref mode (I<CHECK> = Encode::FB_XMLCREF), The
11157 bitmask
11158
11159 =over 4
11160
11161 =item Unimplemented fallback schemes
11162
11163 =back
11164
11165 =item Defining Encodings
11166
11167 =item The UTF-8 flag
11168
11169 Goal #1:, Goal #2:, Goal #3:, Goal #4:
11170
11171 =over 4
11172
11173 =item Messing with Perl's Internals
11174
11175 is_utf8(STRING [, CHECK]), _utf8_on(STRING), _utf8_off(STRING)
11176
11177 =back
11178
11179 =item SEE ALSO
11180
11181 =item MAINTAINER
11182
11183 =back
11184
11185 =head2 Encode::Alias - alias definitions to encodings
11186
11187 =over 4
11188
11189 =item SYNOPSIS
11190
11191 =item DESCRIPTION
11192
11193 As a simple string, As a qr// compiled regular expression, e.g.:, As a code
11194 reference, e.g.:
11195
11196 =over 4
11197
11198 =item Alias overloading
11199
11200 =back
11201
11202 =item SEE ALSO
11203
11204 =back
11205
11206 =head2 Encode::Byte - Single Byte Encodings
11207
11208 =over 4
11209
11210 =item SYNOPSIS
11211
11212 =item ABSTRACT
11213
11214 =item DESCRIPTION
11215
11216 =item SEE ALSO
11217
11218 =back
11219
11220 =head2   Encode::CJKConstants -- Internally used by Encode::??::ISO_2022_*
11221
11222 =head2 Encode::CN - China-based Chinese Encodings
11223
11224 =over 4
11225
11226 =item SYNOPSIS
11227
11228 =item DESCRIPTION
11229
11230 =item NOTES
11231
11232 =item BUGS
11233
11234 =item SEE ALSO
11235
11236 =back
11237
11238 =head2 Encode::CN::HZ -- internally used by Encode::CN
11239
11240 =head2 Encode::Config -- internally used by Encode
11241
11242 =head2 Encode::EBCDIC - EBCDIC Encodings
11243
11244 =over 4
11245
11246 =item SYNOPSIS
11247
11248 =item ABSTRACT
11249
11250 =item DESCRIPTION
11251
11252 =item SEE ALSO
11253
11254 =back
11255
11256 =head2 Encode::Encoding - Encode Implementation Base Class
11257
11258 =over 4
11259
11260 =item SYNOPSIS
11261
11262 =item DESCRIPTION
11263
11264 =over 4
11265
11266 =item Methods you should implement
11267
11268 -E<gt>encode($string [,$check]), -E<gt>decode($octets [,$check])
11269
11270 =item Other methods defined in Encode::Encodings
11271
11272 -E<gt>name, -E<gt>new_sequence, -E<gt>perlio_ok(), -E<gt>needs_lines()
11273
11274 =item Example: Encode::ROT13
11275
11276 =back
11277
11278 =item Why the heck Encode API is different?
11279
11280 =over 4
11281
11282 =item Compiled Encodings
11283
11284 =back
11285
11286 =item SEE ALSO
11287
11288 Scheme 1, Scheme 2, Other Schemes
11289
11290 =back
11291
11292 =head2 Encode::Guess -- Guesses encoding from data
11293
11294 =over 4
11295
11296 =item SYNOPSIS
11297
11298 =item ABSTRACT
11299
11300 =item DESCRIPTION
11301
11302 Encode::Guess->set_suspects, Encode::Guess->add_suspects,
11303 Encode::decode("Guess" ...), Encode::Guess->guess($data),
11304 guess_encoding($data, [, I<list of suspects>])
11305
11306 =item CAVEATS
11307
11308 =item TO DO
11309
11310 =item SEE ALSO
11311
11312 =back
11313
11314 =head2 Encode::JP - Japanese Encodings
11315
11316 =over 4
11317
11318 =item SYNOPSIS
11319
11320 =item ABSTRACT
11321
11322 =item DESCRIPTION
11323
11324 =item Note on ISO-2022-JP(-1)?
11325
11326 =item BUGS
11327
11328 =item SEE ALSO
11329
11330 =back
11331
11332 =head2 Encode::JP::H2Z -- internally used by Encode::JP::2022_JP*
11333
11334 =head2 Encode::JP::JIS7 -- internally used by Encode::JP
11335
11336 =head2 Encode::KR - Korean Encodings
11337
11338 =over 4
11339
11340 =item SYNOPSIS
11341
11342 =item DESCRIPTION
11343
11344 =item BUGS
11345
11346 =item SEE ALSO
11347
11348 =back
11349
11350 =head2 Encode::KR::2022_KR -- internally used by Encode::KR
11351
11352 =head2 Encode::MIME::Header -- MIME 'B' and 'Q' header encoding
11353
11354 =over 4
11355
11356 =item SYNOPSIS
11357
11358 =item ABSTRACT
11359
11360 =item DESCRIPTION
11361
11362 =item BUGS
11363
11364 =item SEE ALSO
11365
11366 =back
11367
11368 =head2 Encode::PerlIO -- a detailed document on Encode and PerlIO
11369
11370 =over 4
11371
11372 =item Overview
11373
11374 =item How does it work?
11375
11376 =item BUGS
11377
11378 =over 4
11379
11380 =item Workaround
11381
11382 =item How can I tell whether my encoding fully supports PerlIO ?
11383
11384 =back
11385
11386 =item SEE ALSO
11387
11388 =back
11389
11390 =head2 Encode::Supported -- Encodings supported by Encode
11391
11392 =over 4
11393
11394 =item DESCRIPTION
11395
11396 =over 4
11397
11398 =item Encoding Names
11399
11400 =back
11401
11402 =item Supported Encodings
11403
11404 =over 4
11405
11406 =item Built-in Encodings
11407
11408 =item Encode::Unicode -- other Unicode encodings
11409
11410 =item Encode::Byte -- Extended ASCII
11411
11412 ISO-8859 and corresponding vendor mappings, KOI8 - De Facto Standard for
11413 the Cyrillic world, gsm0338 - Hentai Latin 1
11414
11415 =item CJK: Chinese, Japanese, Korean (Multibyte)
11416
11417 Encode::CN -- Continental China, Encode::JP -- Japan, Encode::KR -- Korea,
11418 Encode::TW -- Taiwan, Encode::HanExtra -- More Chinese via CPAN,
11419 Encode::JIS2K -- JIS X 0213 encodings via CPAN
11420
11421 =item Miscellaneous encodings
11422
11423 Encode::EBCDIC, Encode::Symbols, Encode::MIME::Header, Encode::Guess
11424
11425 =back
11426
11427 =item Unsupported encodings
11428
11429   ISO-2022-JP-2 [RFC1554], ISO-2022-CN [RFC1922], Various HP-UX encodings,
11430 Cyrillic encoding ISO-IR-111, ISO-8859-8-1 [Hebrew], ISIRI 3342, Iran
11431 System, ISIRI 2900 [Farsi], Thai encoding TCVN, Vietnamese encodings VPS,
11432 Various Mac encodings, (Mac) Indic encodings
11433
11434 =item Encoding vs. Charset -- terminology
11435
11436 =item Encoding Classification (by Anton Tagunov and Dan Kogai)
11437
11438 =over 4
11439
11440 =item Microsoft-related naming mess
11441
11442 KS_C_5601-1987, GB2312, Big5, Shift_JIS
11443
11444 =back
11445
11446 =item Glossary
11447
11448 character repertoire, coded character set (CCS), character encoding scheme
11449 (CES), charset (in MIME context), EUC, ISO-2022, UCS, UCS-2, Unicode, UTF,
11450 UTF-16
11451
11452 =item See Also
11453
11454 =item References
11455
11456 ECMA, ECMA-035 (eq C<ISO-2022>), IANA, Assigned Charset Names by IANA, ISO,
11457 RFC, UC, Unicode Glossary
11458
11459 =over 4
11460
11461 =item Other Notable Sites
11462
11463 czyborra.com, CJK.inf, Jungshik Shin's Hangul FAQ, debian.org:
11464 "Introduction to i18n"
11465
11466 =item Offline sources
11467
11468 C<CJKV Information Processing> by Ken Lunde
11469
11470 =back
11471
11472 =back
11473
11474 =head2 Encode::Symbol - Symbol Encodings
11475
11476 =over 4
11477
11478 =item SYNOPSIS
11479
11480 =item ABSTRACT
11481
11482 =item DESCRIPTION
11483
11484 =item SEE ALSO
11485
11486 =back
11487
11488 =head2 Encode::TW - Taiwan-based Chinese Encodings
11489
11490 =over 4
11491
11492 =item SYNOPSIS
11493
11494 =item DESCRIPTION
11495
11496 =item NOTES
11497
11498 =item BUGS
11499
11500 =item SEE ALSO
11501
11502 =back
11503
11504 =head2 Encode::Unicode -- Various Unicode Transformation Formats
11505
11506 =over 4
11507
11508 =item SYNOPSIS
11509
11510 =item ABSTRACT
11511
11512 L<http://www.unicode.org/glossary/> says:, Quick Reference
11513
11514 =item Size, Endianness, and BOM
11515
11516 =over 4
11517
11518 =item by size
11519
11520 =item by endianness
11521
11522 BOM as integer when fetched in network byte order
11523
11524 =back
11525
11526 =item Surrogate Pairs
11527
11528 =item SEE ALSO
11529
11530 =back
11531
11532 =head2 Encode::lib::Encode::Alias, Encode::Alias - alias definitions to
11533 encodings
11534
11535 =over 4
11536
11537 =item SYNOPSIS
11538
11539 =item DESCRIPTION
11540
11541 As a simple string, As a qr// compiled regular expression, e.g.:, As a code
11542 reference, e.g.:
11543
11544 =over 4
11545
11546 =item Alias overloading
11547
11548 =back
11549
11550 =item SEE ALSO
11551
11552 =back
11553
11554 =head2 Encode::lib::Encode::CJKConstants,   Encode::CJKConstants.pm --
11555 Internally used by Encode::??::ISO_2022_*
11556
11557 =head2 Encode::lib::Encode::CN::HZ, Encode::CN::HZ -- internally used by
11558 Encode::CN
11559
11560 =head2 Encode::lib::Encode::Config, Encode::Config -- internally used by
11561 Encode
11562
11563 =head2 Encode::lib::Encode::Encoding, Encode::Encoding - Encode
11564 Implementation Base Class
11565
11566 =over 4
11567
11568 =item SYNOPSIS
11569
11570 =item DESCRIPTION
11571
11572 =over 4
11573
11574 =item Methods you should implement
11575
11576 -E<gt>encode($string [,$check]), -E<gt>decode($octets [,$check])
11577
11578 =item Other methods defined in Encode::Encodings
11579
11580 -E<gt>name, -E<gt>new_sequence, -E<gt>perlio_ok(), -E<gt>needs_lines()
11581
11582 =item Example: Encode::ROT13
11583
11584 =back
11585
11586 =item Why the heck Encode API is different?
11587
11588 =over 4
11589
11590 =item Compiled Encodings
11591
11592 =back
11593
11594 =item SEE ALSO
11595
11596 Scheme 1, Scheme 2, Other Schemes
11597
11598 =back
11599
11600 =head2 Encode::lib::Encode::Guess, Encode::Guess -- Guesses encoding from
11601 data
11602
11603 =over 4
11604
11605 =item SYNOPSIS
11606
11607 =item ABSTRACT
11608
11609 =item DESCRIPTION
11610
11611 Encode::Guess->set_suspects, Encode::Guess->add_suspects,
11612 Encode::decode("Guess" ...), Encode::Guess->guess($data),
11613 guess_encoding($data, [, I<list of suspects>])
11614
11615 =item CAVEATS
11616
11617 =item TO DO
11618
11619 =item SEE ALSO
11620
11621 =back
11622
11623 =head2 Encode::lib::Encode::JP::H2Z, Encode::JP::H2Z -- internally used by
11624 Encode::JP::2022_JP*
11625
11626 =head2 Encode::lib::Encode::JP::JIS7, Encode::JP::JIS7 -- internally used
11627 by Encode::JP
11628
11629 =head2 Encode::lib::Encode::KR::2022_KR, Encode::KR::2022_KR -- internally
11630 used by Encode::KR
11631
11632 =head2 Encode::lib::Encode::MIME::Header, Encode::MIME::Header -- MIME 'B'
11633 and 'Q' header encoding
11634
11635 =over 4
11636
11637 =item SYNOPSIS
11638
11639 =item ABSTRACT
11640
11641 =item DESCRIPTION
11642
11643 =item BUGS
11644
11645 =item SEE ALSO
11646
11647 =back
11648
11649 =head2 Encode::lib::Encode::PerlIO, Encode::PerlIO -- a detailed document
11650 on Encode and PerlIO
11651
11652 =over 4
11653
11654 =item Overview
11655
11656 =item How does it work?
11657
11658 =item BUGS
11659
11660 =over 4
11661
11662 =item Workaround
11663
11664 =item How can I tell whether my encoding fully supports PerlIO ?
11665
11666 =back
11667
11668 =item SEE ALSO
11669
11670 =back
11671
11672 =head2 Encode::lib::Encode::Supported, Encode::Supported -- Encodings
11673 supported by Encode
11674
11675 =over 4
11676
11677 =item DESCRIPTION
11678
11679 =over 4
11680
11681 =item Encoding Names
11682
11683 =back
11684
11685 =item Supported Encodings
11686
11687 =over 4
11688
11689 =item Built-in Encodings
11690
11691 =item Encode::Unicode -- other Unicode encodings
11692
11693 =item Encode::Byte -- Extended ASCII
11694
11695 ISO-8859 and corresponding vendor mappings, KOI8 - De Facto Standard for
11696 the Cyrillic world, gsm0338 - Hentai Latin 1
11697
11698 =item CJK: Chinese, Japanese, Korean (Multibyte)
11699
11700 Encode::CN -- Continental China, Encode::JP -- Japan, Encode::KR -- Korea,
11701 Encode::TW -- Taiwan, Encode::HanExtra -- More Chinese via CPAN,
11702 Encode::JIS2K -- JIS X 0213 encodings via CPAN
11703
11704 =item Miscellaneous encodings
11705
11706 Encode::EBCDIC, Encode::Symbols, Encode::MIME::Header, Encode::Guess
11707
11708 =back
11709
11710 =item Unsupported encodings
11711
11712   ISO-2022-JP-2 [RFC1554], ISO-2022-CN [RFC1922], Various HP-UX encodings,
11713 Cyrillic encoding ISO-IR-111, ISO-8859-8-1 [Hebrew], ISIRI 3342, Iran
11714 System, ISIRI 2900 [Farsi], Thai encoding TCVN, Vietnamese encodings VPS,
11715 Various Mac encodings, (Mac) Indic encodings
11716
11717 =item Encoding vs. Charset -- terminology
11718
11719 =item Encoding Classification (by Anton Tagunov and Dan Kogai)
11720
11721 =over 4
11722
11723 =item Microsoft-related naming mess
11724
11725 KS_C_5601-1987, GB2312, Big5, Shift_JIS
11726
11727 =back
11728
11729 =item Glossary
11730
11731 character repertoire, coded character set (CCS), character encoding scheme
11732 (CES), charset (in MIME context), EUC, ISO-2022, UCS, UCS-2, Unicode, UTF,
11733 UTF-16
11734
11735 =item See Also
11736
11737 =item References
11738
11739 ECMA, ECMA-035 (eq C<ISO-2022>), IANA, Assigned Charset Names by IANA, ISO,
11740 RFC, UC, Unicode Glossary
11741
11742 =over 4
11743
11744 =item Other Notable Sites
11745
11746 czyborra.com, CJK.inf, Jungshik Shin's Hangul FAQ, debian.org:
11747 "Introduction to i18n"
11748
11749 =item Offline sources
11750
11751 C<CJKV Information Processing> by Ken Lunde
11752
11753 =back
11754
11755 =back
11756
11757 =head2 Encode::lib::Encoder, Encode::Encoder -- Object Oriented Encoder
11758
11759 =over 4
11760
11761 =item SYNOPSIS
11762
11763   use Encode::Encoder;
11764   # Encode::encode("ISO-8859-1", $data);
11765   Encode::Encoder->new($data)->iso_8859_1; # OOP way
11766   # shortcut
11767   use Encode::Encoder qw(encoder);
11768   encoder($data)->iso_8859_1;
11769   # you can stack them!
11770   encoder($data)->iso_8859_1->base64;  # provided base64() is defined
11771   # you can use it as a decoder as well
11772   encoder($base64)->bytes('base64')->latin1;
11773   # stringified
11774   print encoder($data)->utf8->latin1;  # prints the string in latin1
11775   # numified
11776   encoder("\x{abcd}\x{ef}g")->utf8 == 6; # true. bytes::length($data)
11777
11778 =item ABSTRACT
11779
11780 =item Description
11781
11782 =over 4
11783
11784 =item Predefined Methods
11785
11786 $e = Encode::Encoder-E<gt>new([$data, $encoding]);, encoder(),
11787 $e-E<gt>data([$data]), $e-E<gt>encoding([$encoding]),
11788 $e-E<gt>bytes([$encoding])
11789
11790 =item Example: base64 transcoder
11791
11792 =item Operator Overloading
11793
11794 =back
11795
11796 =item SEE ALSO
11797
11798 =back
11799
11800 =head2 Encodencoding, encoding - allows you to write your script in
11801 non-ascii or non-utf8
11802
11803 =over 4
11804
11805 =item SYNOPSIS
11806
11807 =item ABSTRACT
11808
11809 =item USAGE
11810
11811 use encoding [I<ENCNAME>] ;, use encoding I<ENCNAME> [ STDIN =E<gt>
11812 I<ENCNAME_IN> ...] ;, no encoding;
11813
11814 =item CAVEATS
11815
11816 =over 4
11817
11818 =item NOT SCOPED
11819
11820 =item DO NOT MIX MULTIPLE ENCODINGS
11821
11822 =back
11823
11824 =item Non-ASCII Identifiers and Filter option
11825
11826 use encoding I<ENCNAME> Filter=E<gt>1;
11827
11828 =item EXAMPLE - Greekperl
11829
11830 =item KNOWN PROBLEMS
11831
11832 =item SEE ALSO
11833
11834 =back
11835
11836 =head2 Encoder, Encode::Encoder -- Object Oriented Encoder
11837
11838 =over 4
11839
11840 =item SYNOPSIS
11841
11842   use Encode::Encoder;
11843   # Encode::encode("ISO-8859-1", $data);
11844   Encode::Encoder->new($data)->iso_8859_1; # OOP way
11845   # shortcut
11846   use Encode::Encoder qw(encoder);
11847   encoder($data)->iso_8859_1;
11848   # you can stack them!
11849   encoder($data)->iso_8859_1->base64;  # provided base64() is defined
11850   # you can use it as a decoder as well
11851   encoder($base64)->bytes('base64')->latin1;
11852   # stringified
11853   print encoder($data)->utf8->latin1;  # prints the string in latin1
11854   # numified
11855   encoder("\x{abcd}\x{ef}g")->utf8 == 6; # true. bytes::length($data)
11856
11857 =item ABSTRACT
11858
11859 =item Description
11860
11861 =over 4
11862
11863 =item Predefined Methods
11864
11865 $e = Encode::Encoder-E<gt>new([$data, $encoding]);, encoder(),
11866 $e-E<gt>data([$data]), $e-E<gt>encoding([$encoding]),
11867 $e-E<gt>bytes([$encoding])
11868
11869 =item Example: base64 transcoder
11870
11871 =item Operator Overloading
11872
11873 =back
11874
11875 =item SEE ALSO
11876
11877 =back
11878
11879 =head2 English - use nice English (or awk) names for ugly punctuation
11880 variables
11881
11882 =over 4
11883
11884 =item SYNOPSIS
11885
11886 =item DESCRIPTION
11887
11888 =item PERFORMANCE
11889
11890 =back
11891
11892 =head2 Env - perl module that imports environment variables as scalars or
11893 arrays
11894
11895 =over 4
11896
11897 =item SYNOPSIS
11898
11899 =item DESCRIPTION
11900
11901 =item LIMITATIONS
11902
11903 =item AUTHOR
11904
11905 =back
11906
11907 =head2 Errno - System errno constants
11908
11909 =over 4
11910
11911 =item SYNOPSIS
11912
11913 =item DESCRIPTION
11914
11915 =item CAVEATS
11916
11917 =item AUTHOR
11918
11919 =item COPYRIGHT
11920
11921 =back
11922
11923 =head2 Exporter - Implements default import method for modules
11924
11925 =over 4
11926
11927 =item SYNOPSIS
11928
11929 =item DESCRIPTION
11930
11931 =over 4
11932
11933 =item How to Export
11934
11935 =item Selecting What To Export
11936
11937 =item How to Import
11938
11939 C<use ModuleName;>, C<use ModuleName ();>, C<use ModuleName qw(...);>
11940
11941 =back
11942
11943 =item Advanced features
11944
11945 =over 4
11946
11947 =item Specialised Import Lists
11948
11949 =item Exporting without using Exporter's import method
11950
11951 =item Module Version Checking
11952
11953 =item Managing Unknown Symbols
11954
11955 =item Tag Handling Utility Functions
11956
11957 =item Generating combined tags
11958
11959 =item C<AUTOLOAD>ed Constants
11960
11961 =back
11962
11963 =back
11964
11965 =head2 Exporter::Heavy - Exporter guts
11966
11967 =over 4
11968
11969 =item SYNOPSIS
11970
11971 =item DESCRIPTION
11972
11973 =back
11974
11975 =head2 ExtUtils::Command - utilities to replace common UNIX commands in
11976 Makefiles etc.
11977
11978 =over 4
11979
11980 =item SYNOPSIS
11981
11982 =item DESCRIPTION
11983
11984 =back
11985
11986 cat
11987
11988 eqtime src dst
11989
11990 rm_rf files...
11991
11992 rm_f files...
11993
11994 touch files ..
11995
11996 mv source... destination
11997
11998 cp source... destination
11999
12000 chmod mode files..
12001
12002 mkpath directory..
12003
12004 test_f file
12005
12006 =over 4
12007
12008 =item BUGS
12009
12010 =item SEE ALSO
12011
12012 =item AUTHOR
12013
12014 =back
12015
12016 =head2 ExtUtils::Command::MM - Commands for the MM's to use in Makefiles
12017
12018 =over 4
12019
12020 =item SYNOPSIS
12021
12022 =item DESCRIPTION
12023
12024 B<test_harness>
12025
12026 =back
12027
12028 =head2 ExtUtils::Constant - generate XS code to import C header constants
12029
12030 =over 4
12031
12032 =item SYNOPSIS
12033
12034 =item DESCRIPTION
12035
12036 =item USAGE
12037
12038 IV, UV, NV, PV, PVN, SV, YES, NO, UNDEF
12039
12040 =item FUNCTIONS
12041
12042 =back
12043
12044 C_stringify NAME
12045
12046 perl_stringify NAME
12047
12048 constant_types
12049
12050 memEQ_clause NAME, CHECKED_AT, INDENT
12051
12052 assign INDENT, TYPE, PRE, POST, VALUE..
12053
12054 return_clause
12055
12056 switch_clause INDENT, NAMELEN, ITEMHASH, ITEM..
12057
12058 params WHAT
12059
12060 dump_names
12061
12062 dogfood
12063
12064 C_constant, name, type, value, macro, default, pre, post, def_pre =item
12065 def_post, utf8
12066
12067 XS_constant PACKAGE, TYPES, SUBNAME, C_SUBNAME
12068
12069 autoload PACKAGE, VERSION, AUTOLOADER
12070
12071 WriteMakefileSnippet
12072
12073 WriteConstants ATTRIBUTE =E<gt> VALUE [, ...], NAME, DEFAULT_TYPE,
12074 BREAKOUT_AT, NAMES, C_FILE, XS_FILE, SUBNAME, C_SUBNAME
12075
12076 =over 4
12077
12078 =item AUTHOR
12079
12080 =back
12081
12082 =head2 ExtUtils::Embed - Utilities for embedding Perl in C/C++ applications
12083
12084 =over 4
12085
12086 =item SYNOPSIS
12087
12088 =item DESCRIPTION
12089
12090 =item @EXPORT
12091
12092 =item FUNCTIONS
12093
12094 xsinit(), Examples, ldopts(), Examples, perl_inc(), ccflags(), ccdlflags(),
12095 ccopts(), xsi_header(), xsi_protos(@modules), xsi_body(@modules)
12096
12097 =item EXAMPLES
12098
12099 =item SEE ALSO
12100
12101 =item AUTHOR
12102
12103 =back
12104
12105 =head2 ExtUtils::Install - install files from here to there
12106
12107 =over 4
12108
12109 =item SYNOPSIS
12110
12111 =item DESCRIPTION
12112
12113 =back
12114
12115 =head2 ExtUtils::Installed - Inventory management of installed modules
12116
12117 =over 4
12118
12119 =item SYNOPSIS
12120
12121 =item DESCRIPTION
12122
12123 =item USAGE
12124
12125 =item FUNCTIONS
12126
12127 new(), modules(), files(), directories(), directory_tree(), validate(),
12128 packlist(), version()
12129
12130 =item EXAMPLE
12131
12132 =item AUTHOR
12133
12134 =back
12135
12136 =head2 ExtUtils::Liblist - determine libraries to use and how to use them
12137
12138 =over 4
12139
12140 =item SYNOPSIS
12141
12142 =item DESCRIPTION
12143
12144 For static extensions, For dynamic extensions at build/link time, For
12145 dynamic extensions at load time
12146
12147 =over 4
12148
12149 =item EXTRALIBS
12150
12151 =item LDLOADLIBS and LD_RUN_PATH
12152
12153 =item BSLOADLIBS
12154
12155 =back
12156
12157 =item PORTABILITY
12158
12159 =over 4
12160
12161 =item VMS implementation
12162
12163 =item Win32 implementation
12164
12165 =back
12166
12167 =item SEE ALSO
12168
12169 =back
12170
12171 =head2 ExtUtils::MM - OS adjusted ExtUtils::MakeMaker subclass
12172
12173 =over 4
12174
12175 =item SYNOPSIS
12176
12177 =item DESCRIPTION
12178
12179 =back
12180
12181 =head2 ExtUtils::MM_Any - Platform agnostic MM methods
12182
12183 =over 4
12184
12185 =item SYNOPSIS
12186
12187 =item DESCRIPTION
12188
12189 =item Inherently Cross-Platform Methods
12190
12191 =over 4
12192
12193 =item File::Spec wrappers  B<DEPRECATED>
12194
12195 canonpath
12196
12197 =back
12198
12199 =back
12200
12201 catdir
12202
12203 catfile
12204
12205 curdir
12206
12207 file_name_is_absolute
12208
12209 path
12210
12211 rootdir
12212
12213 updir
12214
12215 =over 4
12216
12217 =item Thought To Be Cross-Platform Methods
12218
12219 test_via_harness
12220
12221 =back
12222
12223 test_via_script
12224
12225 =over 4
12226
12227 =item AUTHOR
12228
12229 =back
12230
12231 =head2 ExtUtils::MM_BeOS - methods to override UN*X behaviour in
12232 ExtUtils::MakeMaker
12233
12234 =over 4
12235
12236 =item SYNOPSIS
12237
12238 =item DESCRIPTION
12239
12240 =back
12241
12242 perl_archive
12243
12244 =head2 ExtUtils::MM_Cygwin - methods to override UN*X behaviour in
12245 ExtUtils::MakeMaker
12246
12247 =over 4
12248
12249 =item SYNOPSIS
12250
12251 =item DESCRIPTION
12252
12253 canonpath, cflags, manifypods, perl_archive
12254
12255 =back
12256
12257 =head2 ExtUtils::MM_DOS - DOS specific subclass of ExtUtils::MM_Unix
12258
12259 =over 4
12260
12261 =item SYNOPSIS
12262
12263 =item DESCRIPTION
12264
12265 =over 4
12266
12267 =item Overridden methods
12268
12269 B<replace_manpage_separator>
12270
12271 =back
12272
12273 =back
12274
12275 =over 4
12276
12277 =item AUTHOR
12278
12279 =item SEE ALSO
12280
12281 =back
12282
12283 =head2 ExtUtils::MM_MacOS - methods to override UN*X behaviour in
12284 ExtUtils::MakeMaker
12285
12286 =over 4
12287
12288 =item SYNOPSIS
12289
12290 =item DESCRIPTION
12291
12292 =back
12293
12294 maybe_command
12295
12296 guess_name
12297
12298 macify
12299
12300 patternify
12301
12302 init_main
12303
12304 init_others
12305
12306 init_dirscan
12307
12308 libscan (o)
12309
12310 constants (o)
12311
12312 static (o)
12313
12314 dlsyms (o)
12315
12316 dynamic (o)
12317
12318 clean (o)
12319
12320 realclean (o)
12321
12322 rulez (o)
12323
12324 processPL (o)
12325
12326 =head2 ExtUtils::MM_NW5 - methods to override UN*X behaviour in
12327 ExtUtils::MakeMaker
12328
12329 =over 4
12330
12331 =item SYNOPSIS
12332
12333 =item DESCRIPTION
12334
12335 =back
12336
12337 constants (o)
12338
12339 static_lib (o)
12340
12341 dynamic_lib (o)
12342
12343 =head2 ExtUtils::MM_OS2 - methods to override UN*X behaviour in
12344 ExtUtils::MakeMaker
12345
12346 =over 4
12347
12348 =item SYNOPSIS
12349
12350 =item DESCRIPTION
12351
12352 =item METHODS
12353
12354 =back
12355
12356 perl_archive_after
12357
12358 =head2 ExtUtils::MM_UWIN - U/WIN specific subclass of ExtUtils::MM_Unix
12359
12360 =over 4
12361
12362 =item SYNOPSIS
12363
12364 =item DESCRIPTION
12365
12366 =over 4
12367
12368 =item Overridden methods
12369
12370 B<replace_manpage_separator>
12371
12372 =back
12373
12374 =back
12375
12376 =over 4
12377
12378 =item AUTHOR
12379
12380 =item SEE ALSO
12381
12382 =back
12383
12384 =head2 ExtUtils::MM_Unix - methods used by ExtUtils::MakeMaker
12385
12386 =over 4
12387
12388 =item SYNOPSIS
12389
12390 =item DESCRIPTION
12391
12392 =item METHODS
12393
12394 =back
12395
12396 =over 4
12397
12398 =item SelfLoaded methods
12399
12400 c_o (o)
12401
12402 =back
12403
12404 cflags (o)
12405
12406 clean (o)
12407
12408 const_cccmd (o)
12409
12410 const_config (o)
12411
12412 const_loadlibs (o)
12413
12414 constants (o)
12415
12416 depend (o)
12417
12418 dir_target (o)
12419
12420 dist (o)
12421
12422 dist_basics (o)
12423
12424 dist_ci (o)
12425
12426 dist_core (o)
12427
12428 dist_dir
12429
12430 dist_test
12431
12432 dlsyms (o)
12433
12434 dynamic (o)
12435
12436 dynamic_bs (o)
12437
12438 dynamic_lib (o)
12439
12440 exescan
12441
12442 extliblist
12443
12444 find_perl
12445
12446 find_tests
12447
12448 =over 4
12449
12450 =item Methods to actually produce chunks of text for the Makefile
12451
12452 fixin
12453
12454 =back
12455
12456 force (o)
12457
12458 guess_name
12459
12460 has_link_code
12461
12462 init_dirscan
12463
12464 init_main
12465
12466 init_others
12467
12468 init_INST
12469
12470 init_INSTALL
12471
12472 init_lib2arch
12473
12474 init_PERL
12475
12476 init_PERM
12477
12478 install (o)
12479
12480 installbin (o)
12481
12482 libscan (o)
12483
12484 linkext (o)
12485
12486 lsdir
12487
12488 macro (o)
12489
12490 makeaperl (o)
12491
12492 makefile (o)
12493
12494 manifypods (o)
12495
12496 maybe_command
12497
12498 maybe_command_in_dirs
12499
12500 needs_linking (o)
12501
12502 nicetext
12503
12504 parse_abstract
12505
12506 parse_version
12507
12508 pasthru (o)
12509
12510 perl_script
12511
12512 perldepend (o)
12513
12514 perm_rw (o)
12515
12516 perm_rwx (o)
12517
12518 pm_to_blib
12519
12520 post_constants (o)
12521
12522 post_initialize (o)
12523
12524 postamble (o)
12525
12526 ppd
12527
12528 prefixify
12529
12530 processPL (o)
12531
12532 quote_paren
12533
12534 realclean (o)
12535
12536 replace_manpage_separator
12537
12538 static (o)
12539
12540 static_lib (o)
12541
12542 staticmake (o)
12543
12544 subdir_x (o)
12545
12546 subdirs (o)
12547
12548 test (o)
12549
12550 test_via_harness (override)
12551
12552 test_via_script (override)
12553
12554 tool_autosplit (o)
12555
12556 tools_other (o)
12557
12558 tool_xsubpp (o)
12559
12560 top_targets (o)
12561
12562 writedoc
12563
12564 xs_c (o)
12565
12566 xs_cpp (o)
12567
12568 xs_o (o)
12569
12570 perl_archive
12571
12572 perl_archive_after
12573
12574 export_list
12575
12576 =over 4
12577
12578 =item SEE ALSO
12579
12580 =back
12581
12582 =head2 ExtUtils::MM_VMS - methods to override UN*X behaviour in
12583 ExtUtils::MakeMaker
12584
12585 =over 4
12586
12587 =item SYNOPSIS
12588
12589 =item DESCRIPTION
12590
12591 =over 4
12592
12593 =item Methods always loaded
12594
12595 wraplist
12596
12597 =back
12598
12599 =back
12600
12601 =over 4
12602
12603 =item Methods
12604
12605 guess_name (override)
12606
12607 =back
12608
12609 find_perl (override)
12610
12611 maybe_command (override)
12612
12613 maybe_command_in_dirs (override)
12614
12615 perl_script (override)
12616
12617 replace_manpage_separator
12618
12619 init_main (override)
12620
12621 init_others (override)
12622
12623 constants (override)
12624
12625 cflags (override)
12626
12627 const_cccmd (override)
12628
12629 pm_to_blib (override)
12630
12631 tool_autosplit (override)
12632
12633 tool_sxubpp (override)
12634
12635 xsubpp_version (override)
12636
12637 tools_other (override)
12638
12639 dist (override)
12640
12641 c_o (override)
12642
12643 xs_c (override)
12644
12645 xs_o (override)
12646
12647 top_targets (override)
12648
12649 dlsyms (override)
12650
12651 dynamic_lib (override)
12652
12653 dynamic_bs (override)
12654
12655 static_lib (override)
12656
12657 manifypods (override)
12658
12659 processPL (override)
12660
12661 installbin (override)
12662
12663 subdir_x (override)
12664
12665 clean (override)
12666
12667 realclean (override)
12668
12669 dist_core (override)
12670
12671 dist_test (override)
12672
12673 install (override)
12674
12675 perldepend (override)
12676
12677 makefile (override)
12678
12679 find_tests (override)
12680
12681 test (override)
12682
12683 makeaperl (override)
12684
12685 nicetext (override)
12686
12687 prefixify (override)
12688
12689 =head2 ExtUtils::MM_Win32 - methods to override UN*X behaviour in
12690 ExtUtils::MakeMaker
12691
12692 =over 4
12693
12694 =item SYNOPSIS
12695
12696 =item DESCRIPTION
12697
12698 =back
12699
12700 constants (o)
12701
12702 static_lib (o)
12703
12704 dynamic_bs (o)
12705
12706 dynamic_lib (o)
12707
12708 perl_script
12709
12710 pm_to_blib
12711
12712 tool_autosplit (override)
12713
12714 tools_other (o)
12715
12716 xs_o (o)
12717
12718 top_targets (o)
12719
12720 manifypods (o)
12721
12722 dist_ci (o)
12723
12724 dist_core (o)
12725
12726 pasthru (o)
12727
12728 =head2 ExtUtils::MM_Win95 - method to customize MakeMaker for Win9X
12729
12730 =over 4
12731
12732 =item SYNOPSIS
12733
12734 =item DESCRIPTION
12735
12736 =back
12737
12738 =head2 ExtUtils::MY - ExtUtils::MakeMaker subclass for customization
12739
12740 =over 4
12741
12742 =item SYNOPSIS
12743
12744 =item DESCRIPTION
12745
12746 =back
12747
12748 =head2 ExtUtils::MakeMaker - create an extension Makefile
12749
12750 =over 4
12751
12752 =item SYNOPSIS
12753
12754 =item DESCRIPTION
12755
12756 =over 4
12757
12758 =item How To Write A Makefile.PL
12759
12760 =item Default Makefile Behaviour
12761
12762 =item make test
12763
12764 =item make testdb
12765
12766 =item make install
12767
12768 =item PREFIX and LIB attribute
12769
12770 =item AFS users
12771
12772 =item Static Linking of a new Perl Binary
12773
12774 =item Determination of Perl Library and Installation Locations
12775
12776 =item Which architecture dependent directory?
12777
12778 =item Using Attributes and Parameters
12779
12780 ABSTRACT, ABSTRACT_FROM, AUTHOR, BINARY_LOCATION, C, CCFLAGS, CONFIG,
12781 CONFIGURE, DEFINE, DIR, DISTNAME, DL_FUNCS, DL_VARS, EXCLUDE_EXT,
12782 EXE_FILES, FIRST_MAKEFILE, FULLPERL, FULLPERLRUN, FULLPERLRUNINST,
12783 FUNCLIST, H, IMPORTS, INC, INCLUDE_EXT, INSTALLARCHLIB, INSTALLBIN,
12784 INSTALLDIRS, INSTALLMAN1DIR, INSTALLMAN3DIR, INSTALLPRIVLIB, INSTALLSCRIPT,
12785 INSTALLSITEARCH, INSTALLSITEBIN, INSTALLSITELIB, INSTALLSITEMAN1DIR,
12786 INSTALLSITEMAN3DIR, INSTALLVENDORARCH, INSTALLVENDORBIN, INSTALLVENDORLIB,
12787 INSTALLVENDORMAN1DIR, INSTALLVENDORMAN3DIR, INST_ARCHLIB, INST_BIN,
12788 INST_LIB, INST_MAN1DIR, INST_MAN3DIR, INST_SCRIPT, LDFROM, LIB, LIBPERL_A,
12789 LIBS, LINKTYPE, MAKEAPERL, MAKEFILE, MAN1PODS, MAN3PODS, MAP_TARGET,
12790 MYEXTLIB, NAME, NEEDS_LINKING, NOECHO, NORECURS, NO_VC, OBJECT, OPTIMIZE,
12791 PERL, PERL_CORE, PERLMAINCC, PERL_ARCHLIB, PERL_LIB, PERL_MALLOC_OK,
12792 PERLRUN, PERLRUNINST, PERL_SRC, PERM_RW, PERM_RWX, PL_FILES, PM, PMLIBDIRS,
12793 PM_FILTER, POLLUTE, PPM_INSTALL_EXEC, PPM_INSTALL_SCRIPT, PREFIX,
12794 PREREQ_PM, PREREQ_FATAL, PREREQ_PRINT, PRINT_PREREQ, SITEPREFIX, SKIP,
12795 TYPEMAPS, VENDORPREFIX, VERBINST, VERSION, VERSION_FROM, XS, XSOPT,
12796 XSPROTOARG, XS_VERSION
12797
12798 =item Additional lowercase attributes
12799
12800 clean, depend, dist, dynamic_lib, linkext, macro, realclean, test,
12801 tool_autosplit
12802
12803 =item Overriding MakeMaker Methods
12804
12805 =item Hintsfile support
12806
12807 =item Distribution Support
12808
12809    make distcheck,    make skipcheck,    make distclean,    make manifest,
12810   make distdir,   make disttest,    make tardist,    make dist,    make
12811 uutardist,    make shdist,    make zipdist,    make ci
12812
12813 =item Disabling an extension
12814
12815 =back
12816
12817 =item ENVIRONMENT
12818
12819 PERL_MM_OPT, PERL_MM_USE_DEFAULT
12820
12821 =item SEE ALSO
12822
12823 =item AUTHORS
12824
12825 =back
12826
12827 =head2 ExtUtils::Manifest - utilities to write and check a MANIFEST file
12828
12829 =over 4
12830
12831 =item SYNOPSIS
12832
12833 =item DESCRIPTION
12834
12835 =item MANIFEST.SKIP
12836
12837 =item EXPORT_OK
12838
12839 =item GLOBAL VARIABLES
12840
12841 =item DIAGNOSTICS
12842
12843 C<Not in MANIFEST:> I<file>, C<Skipping> I<file>, C<No such file:> I<file>,
12844 C<MANIFEST:> I<$!>, C<Added to MANIFEST:> I<file>
12845
12846 =item ENVIRONMENT
12847
12848 B<PERL_MM_MANIFEST_DEBUG>
12849
12850 =item SEE ALSO
12851
12852 =item AUTHOR
12853
12854 =back
12855
12856 =head2 ExtUtils::Miniperl, writemain - write the C code for perlmain.c
12857
12858 =over 4
12859
12860 =item SYNOPSIS
12861
12862 =item DESCRIPTION
12863
12864 =item SEE ALSO
12865
12866 =back
12867
12868 =head2 ExtUtils::Mkbootstrap - make a bootstrap file for use by DynaLoader
12869
12870 =over 4
12871
12872 =item SYNOPSIS
12873
12874 =item DESCRIPTION
12875
12876 =back
12877
12878 =head2 ExtUtils::Mksymlists - write linker options files for dynamic
12879 extension
12880
12881 =over 4
12882
12883 =item SYNOPSIS
12884
12885 =item DESCRIPTION
12886
12887 DLBASE, DL_FUNCS, DL_VARS, FILE, FUNCLIST, IMPORTS, NAME
12888
12889 =item AUTHOR
12890
12891 =item REVISION
12892
12893 =back
12894
12895 =head2 ExtUtils::Packlist - manage .packlist files
12896
12897 =over 4
12898
12899 =item SYNOPSIS
12900
12901 =item DESCRIPTION
12902
12903 =item USAGE
12904
12905 =item FUNCTIONS
12906
12907 new(), read(), write(), validate(), packlist_file()
12908
12909 =item EXAMPLE
12910
12911 =item AUTHOR
12912
12913 =back
12914
12915 =head2 ExtUtils::testlib - add blib/* directories to @INC
12916
12917 =over 4
12918
12919 =item SYNOPSIS
12920
12921 =item DESCRIPTION
12922
12923 =back
12924
12925 =head2 Fatal - replace functions with equivalents which succeed or die
12926
12927 =over 4
12928
12929 =item SYNOPSIS
12930
12931 =item DESCRIPTION
12932
12933 =item AUTHOR
12934
12935 =back
12936
12937 =head2 Fcntl - load the C Fcntl.h defines
12938
12939 =over 4
12940
12941 =item SYNOPSIS
12942
12943 =item DESCRIPTION
12944
12945 =item NOTE
12946
12947 =item EXPORTED SYMBOLS
12948
12949 =back
12950
12951 =head2 File::Basename, fileparse - split a pathname into pieces
12952
12953 =over 4
12954
12955 =item SYNOPSIS
12956
12957 =item DESCRIPTION
12958
12959 fileparse_set_fstype, fileparse
12960
12961 =item EXAMPLES
12962
12963 C<basename>, C<dirname>
12964
12965 =back
12966
12967 =head2 File::CheckTree, validate - run many filetest checks on a tree
12968
12969 =over 4
12970
12971 =item SYNOPSIS
12972
12973 =item DESCRIPTION
12974
12975 =item AUTHOR
12976
12977 =item HISTORY
12978
12979 =back
12980
12981 =head2 File::Compare - Compare files or filehandles
12982
12983 =over 4
12984
12985 =item SYNOPSIS
12986
12987 =item DESCRIPTION
12988
12989 =item RETURN
12990
12991 =item AUTHOR
12992
12993 =back
12994
12995 =head2 File::Copy - Copy files or filehandles
12996
12997 =over 4
12998
12999 =item SYNOPSIS
13000
13001 =item DESCRIPTION
13002
13003 =over 4
13004
13005 =item Special behaviour if C<syscopy> is defined (OS/2, VMS and Win32)
13006
13007 rmscopy($from,$to[,$date_flag])
13008
13009 =back
13010
13011 =item RETURN
13012
13013 =item NOTES
13014
13015 =item AUTHOR
13016
13017 =back
13018
13019 =head2 File::DosGlob - DOS like globbing and then some
13020
13021 =over 4
13022
13023 =item SYNOPSIS
13024
13025 =item DESCRIPTION
13026
13027 =item NOTES
13028
13029 =item EXPORTS (by request only)
13030
13031 =item BUGS
13032
13033 =item AUTHOR
13034
13035 =item HISTORY
13036
13037 =item SEE ALSO
13038
13039 =back
13040
13041 =head2 File::Find - Traverse a directory tree.
13042
13043 =over 4
13044
13045 =item SYNOPSIS
13046
13047 =item DESCRIPTION
13048
13049 B<find>, B<finddepth>
13050
13051 =over 4
13052
13053 =item %options
13054
13055 C<wanted>, C<bydepth>, C<preprocess>, C<postprocess>, C<follow>,
13056 C<follow_fast>, C<follow_skip>, C<dangling_symlinks>, C<no_chdir>,
13057 C<untaint>, C<untaint_pattern>, C<untaint_skip>
13058
13059 =item The wanted function
13060
13061 C<$File::Find::dir> is the current directory name,, C<$_> is the current
13062 filename within that directory, C<$File::Find::name> is the complete
13063 pathname to the file
13064
13065 =back
13066
13067 =item WARNINGS
13068
13069 =item CAVEAT
13070
13071 $dont_use_nlink, symlinks
13072
13073 =item NOTES
13074
13075 =item HISTORY
13076
13077 =back
13078
13079 =head2 File::Glob - Perl extension for BSD glob routine
13080
13081 =over 4
13082
13083 =item SYNOPSIS
13084
13085 =item DESCRIPTION
13086
13087 C<GLOB_ERR>, C<GLOB_LIMIT>, C<GLOB_MARK>, C<GLOB_NOCASE>, C<GLOB_NOCHECK>,
13088 C<GLOB_NOSORT>, C<GLOB_BRACE>, C<GLOB_NOMAGIC>, C<GLOB_QUOTE>,
13089 C<GLOB_TILDE>, C<GLOB_CSH>, C<GLOB_ALPHASORT>
13090
13091 =item DIAGNOSTICS
13092
13093 C<GLOB_NOSPACE>, C<GLOB_ABEND>
13094
13095 =item NOTES
13096
13097 =item AUTHOR
13098
13099 =back
13100
13101 =head2 File::Path - create or remove directory trees
13102
13103 =over 4
13104
13105 =item SYNOPSIS
13106
13107 =item DESCRIPTION
13108
13109 =item AUTHORS
13110
13111 =back
13112
13113 =head2 File::Spec - portably perform operations on file names
13114
13115 =over 4
13116
13117 =item SYNOPSIS
13118
13119 =item DESCRIPTION
13120
13121 =item METHODS
13122
13123 canonpath, catdir, catfile, curdir, devnull, rootdir, tmpdir, updir,
13124 no_upwards, case_tolerant, file_name_is_absolute, path, join, splitpath,
13125 splitdir, catpath(), abs2rel, rel2abs()
13126
13127 =item SEE ALSO
13128
13129 =item AUTHORS
13130
13131 =back
13132
13133 =head2 File::Spec::Cygwin - methods for Cygwin file specs
13134
13135 =over 4
13136
13137 =item SYNOPSIS
13138
13139 =item DESCRIPTION
13140
13141 =back
13142
13143 =head2 File::Spec::Epoc - methods for Epoc file specs
13144
13145 =over 4
13146
13147 =item SYNOPSIS
13148
13149 =item DESCRIPTION
13150
13151 canonpath()
13152
13153 =back
13154
13155 =over 4
13156
13157 =item SEE ALSO
13158
13159 =back
13160
13161 =head2 File::Spec::Functions - portably perform operations on file names
13162
13163 =over 4
13164
13165 =item SYNOPSIS
13166
13167 =item DESCRIPTION
13168
13169 =over 4
13170
13171 =item Exports
13172
13173 =back
13174
13175 =item SEE ALSO
13176
13177 =back
13178
13179 =head2 File::Spec::Mac - File::Spec for Mac OS (Classic)
13180
13181 =over 4
13182
13183 =item SYNOPSIS
13184
13185 =item DESCRIPTION
13186
13187 =item METHODS
13188
13189 canonpath
13190
13191 =back
13192
13193 catdir()
13194
13195 catfile
13196
13197 curdir
13198
13199 devnull
13200
13201 rootdir
13202
13203 tmpdir
13204
13205 updir
13206
13207 file_name_is_absolute
13208
13209 path
13210
13211 splitpath
13212
13213 splitdir
13214
13215 catpath
13216
13217 abs2rel
13218
13219 rel2abs
13220
13221 =over 4
13222
13223 =item AUTHORS
13224
13225 =item SEE ALSO
13226
13227 =back
13228
13229 canonpath
13230
13231 splitpath
13232
13233 splitdir
13234
13235 catpath
13236
13237 =head2 File::Spec::OS2 - methods for OS/2 file specs
13238
13239 =over 4
13240
13241 =item SYNOPSIS
13242
13243 =item DESCRIPTION
13244
13245 =back
13246
13247 =head2 File::Spec::Unix - File::Spec for Unix, base for other File::Spec
13248 modules
13249
13250 =over 4
13251
13252 =item SYNOPSIS
13253
13254 =item DESCRIPTION
13255
13256 =item METHODS
13257
13258 canonpath()
13259
13260 =back
13261
13262 catdir()
13263
13264 catfile
13265
13266 curdir
13267
13268 devnull
13269
13270 rootdir
13271
13272 tmpdir
13273
13274 updir
13275
13276 no_upwards
13277
13278 case_tolerant
13279
13280 file_name_is_absolute
13281
13282 path
13283
13284 join
13285
13286 splitpath
13287
13288 splitdir
13289
13290 catpath()
13291
13292 abs2rel
13293
13294 rel2abs()
13295
13296 =over 4
13297
13298 =item SEE ALSO
13299
13300 =back
13301
13302 =head2 File::Spec::VMS - methods for VMS file specs
13303
13304 =over 4
13305
13306 =item SYNOPSIS
13307
13308 =item DESCRIPTION
13309
13310 eliminate_macros
13311
13312 =back
13313
13314 fixpath
13315
13316 =over 4
13317
13318 =item Methods always loaded
13319
13320 canonpath (override)
13321
13322 =back
13323
13324 catdir
13325
13326 catfile
13327
13328 curdir (override)
13329
13330 devnull (override)
13331
13332 rootdir (override)
13333
13334 tmpdir (override)
13335
13336 updir (override)
13337
13338 case_tolerant (override)
13339
13340 path (override)
13341
13342 file_name_is_absolute (override)
13343
13344 splitpath (override)
13345
13346 splitdir (override)
13347
13348 catpath (override)
13349
13350 abs2rel (override)
13351
13352 rel2abs (override)
13353
13354 =over 4
13355
13356 =item SEE ALSO
13357
13358 =back
13359
13360 =head2 File::Spec::Win32 - methods for Win32 file specs
13361
13362 =over 4
13363
13364 =item SYNOPSIS
13365
13366 =item DESCRIPTION
13367
13368 devnull
13369
13370 =back
13371
13372 tmpdir
13373
13374 catfile
13375
13376 canonpath
13377
13378 splitpath
13379
13380 splitdir
13381
13382 catpath
13383
13384 =over 4
13385
13386 =item SEE ALSO
13387
13388 =back
13389
13390 =head2 File::Temp - return name and handle of a temporary file safely
13391
13392 =over 4
13393
13394 =item PORTABILITY
13395
13396 =item SYNOPSIS
13397
13398 =item DESCRIPTION
13399
13400 =back
13401
13402 =over 4
13403
13404 =item FUNCTIONS
13405
13406 B<tempfile>
13407
13408 =back
13409
13410 B<tempdir>
13411
13412 =over 4
13413
13414 =item MKTEMP FUNCTIONS
13415
13416 B<mkstemp>
13417
13418 =back
13419
13420 B<mkstemps>
13421
13422 B<mkdtemp>
13423
13424 B<mktemp>
13425
13426 =over 4
13427
13428 =item POSIX FUNCTIONS
13429
13430 B<tmpnam>
13431
13432 =back
13433
13434 B<tmpfile>
13435
13436 =over 4
13437
13438 =item ADDITIONAL FUNCTIONS
13439
13440 B<tempnam>
13441
13442 =back
13443
13444 =over 4
13445
13446 =item UTILITY FUNCTIONS
13447
13448 B<unlink0>
13449
13450 =back
13451
13452 =over 4
13453
13454 =item PACKAGE VARIABLES
13455
13456 B<safe_level>, STANDARD, MEDIUM, HIGH
13457
13458 =back
13459
13460 TopSystemUID
13461
13462 =over 4
13463
13464 =item WARNING
13465
13466 =over 4
13467
13468 =item Temporary files and NFS
13469
13470 =back
13471
13472 =item HISTORY
13473
13474 =item SEE ALSO
13475
13476 =item AUTHOR
13477
13478 =back
13479
13480 =head2 File::stat - by-name interface to Perl's built-in stat() functions
13481
13482 =over 4
13483
13484 =item SYNOPSIS
13485
13486 =item DESCRIPTION
13487
13488 =item NOTE
13489
13490 =item AUTHOR
13491
13492 =back
13493
13494 =head2 FileCache - keep more files open than the system permits
13495
13496 =over 4
13497
13498 =item SYNOPSIS
13499
13500 =item DESCRIPTION
13501
13502 cacheout EXPR, cacheout MODE, EXPR
13503
13504 =item CAVEATS
13505
13506 =item BUGS
13507
13508 =back
13509
13510 =head2 FileHandle - supply object methods for filehandles
13511
13512 =over 4
13513
13514 =item SYNOPSIS
13515
13516 =item DESCRIPTION
13517
13518 $fh->print, $fh->printf, $fh->getline, $fh->getlines
13519
13520 =item SEE ALSO
13521
13522 =back
13523
13524 =head2 Filter::Simple - Simplified source filtering
13525
13526 =over 4
13527
13528 =item SYNOPSIS
13529
13530 =item DESCRIPTION
13531
13532 =over 4
13533
13534 =item The Problem
13535
13536 =item A Solution
13537
13538 =item Disabling or changing <no> behaviour
13539
13540 =item All-in-one interface
13541
13542 =item Filtering only specific components of source code
13543
13544 C<"code">, C<"executable">, C<"quotelike">, C<"string">, C<"regex">,
13545 C<"all">
13546
13547 =item Filtering only the code parts of source code
13548
13549 Most source code ceases to be grammatically correct when it is broken up
13550 into the pieces between string literals and regexes. So the C<'code'>
13551 component filter behaves slightly differently from the other partial
13552 filters
13553 described in the previous section.
13554
13555 =item Using Filter::Simple with an explicit C<import> subroutine
13556
13557 =item Using Filter::Simple and Exporter together
13558
13559 =item How it works
13560
13561 =back
13562
13563 =item AUTHOR
13564
13565 =item COPYRIGHT
13566
13567 =back
13568
13569 =head2 Filter::Util::Call - Perl Source Filter Utility Module
13570
13571 =over 4
13572
13573 =item SYNOPSIS
13574
13575 =item DESCRIPTION
13576
13577 =over 4
13578
13579 =item B<use Filter::Util::Call>
13580
13581 =item B<import()>
13582
13583 =item B<filter() and anonymous sub>
13584
13585 B<$_>, B<$status>, B<filter_read> and B<filter_read_exact>, B<filter_del>
13586
13587 =back
13588
13589 =item EXAMPLES
13590
13591 =over 4
13592
13593 =item Example 1: A simple filter.
13594
13595 =item Example 2: Using the context
13596
13597 =item Example 3: Using the context within the filter
13598
13599 =item Example 4: Using filter_del
13600
13601 =back
13602
13603 =item Filter::Simple
13604
13605 =item AUTHOR
13606
13607 =item DATE
13608
13609 =back
13610
13611 =head2 FindBin - Locate directory of original perl script
13612
13613 =over 4
13614
13615 =item SYNOPSIS
13616
13617 =item DESCRIPTION
13618
13619 =item EXPORTABLE VARIABLES
13620
13621 =item KNOWN ISSUES
13622
13623 =item KNOWN BUGS
13624
13625 =item AUTHORS
13626
13627 =item COPYRIGHT
13628
13629 =back
13630
13631 =head2 GDBM_File - Perl5 access to the gdbm library.
13632
13633 =over 4
13634
13635 =item SYNOPSIS
13636
13637 =item DESCRIPTION
13638
13639 =item AVAILABILITY
13640
13641 =item BUGS
13642
13643 =item SEE ALSO
13644
13645 =back
13646
13647 =head2 Getopt::Long - Extended processing of command line options
13648
13649 =over 4
13650
13651 =item SYNOPSIS
13652
13653 =item DESCRIPTION
13654
13655 =item Command Line Options, an Introduction
13656
13657 =item Getting Started with Getopt::Long
13658
13659 =over 4
13660
13661 =item Simple options
13662
13663 =item A little bit less simple options
13664
13665 =item Mixing command line option with other arguments
13666
13667 =item Options with values
13668
13669 =item Options with multiple values
13670
13671 =item Options with hash values
13672
13673 =item User-defined subroutines to handle options
13674
13675 =item Options with multiple names
13676
13677 =item Case and abbreviations
13678
13679 =item Summary of Option Specifications
13680
13681 !, +, s, i, o, f, : I<type> [ I<desttype> ], : I<number> [ I<desttype> ], :
13682 + [ I<desttype> ]
13683
13684 =back
13685
13686 =item Advanced Possibilities
13687
13688 =over 4
13689
13690 =item Object oriented interface
13691
13692 =item Documentation and help texts
13693
13694 =item Storing options in a hash
13695
13696 =item Bundling
13697
13698 =item The lonesome dash
13699
13700 =item Argument callback
13701
13702 =back
13703
13704 =item Configuring Getopt::Long
13705
13706 default, posix_default, auto_abbrev, getopt_compat, gnu_compat, gnu_getopt,
13707 require_order, permute, bundling (default: disabled), bundling_override
13708 (default: disabled), ignore_case  (default: enabled), ignore_case_always
13709 (default: disabled), pass_through (default: disabled), prefix,
13710 prefix_pattern, debug (default: disabled)
13711
13712 =item Return values and Errors
13713
13714 =item Legacy
13715
13716 =over 4
13717
13718 =item Default destinations
13719
13720 =item Alternative option starters
13721
13722 =item Configuration variables
13723
13724 =back
13725
13726 =item Trouble Shooting
13727
13728 =over 4
13729
13730 =item Warning: Ignoring '!' modifier for short option
13731
13732 =item GetOptions does not return a false result when an option is not
13733 supplied
13734
13735 =item GetOptions does not split the command line correctly
13736
13737 =item How do I put a "-?" option into a Getopt::Long?
13738
13739 =back
13740
13741 =item AUTHOR
13742
13743 =item COPYRIGHT AND DISCLAIMER
13744
13745 =back
13746
13747 =head2 Getopt::Std, getopt - Process single-character switches with switch
13748 clustering
13749
13750 =over 4
13751
13752 =item SYNOPSIS
13753
13754 =item DESCRIPTION
13755
13756 =back
13757
13758 =head2 Hash::Util - A selection of general-utility hash subroutines
13759
13760 =over 4
13761
13762 =item SYNOPSIS
13763
13764 =item DESCRIPTION
13765
13766 =over 4
13767
13768 =item Restricted hashes
13769
13770 lock_keys, unlock_keys
13771
13772 =back
13773
13774 =back
13775
13776 lock_value, unlock_value
13777
13778 B<lock_hash>, B<unlock_hash>
13779
13780 =over 4
13781
13782 =item AUTHOR
13783
13784 =item SEE ALSO
13785
13786 =back
13787
13788 =head2 I18N::Collate - compare 8-bit scalar data according to the current
13789 locale
13790
13791 =over 4
13792
13793 =item SYNOPSIS
13794
13795 =item DESCRIPTION
13796
13797 =back
13798
13799 =head2 I18N::LangTags - functions for dealing with RFC3066-style language
13800 tags
13801
13802 =over 4
13803
13804 =item SYNOPSIS
13805
13806 =item DESCRIPTION
13807
13808 =back
13809
13810 the function is_language_tag($lang1)
13811
13812 the function extract_language_tags($whatever)
13813
13814 the function same_language_tag($lang1, $lang2)
13815
13816 the function similarity_language_tag($lang1, $lang2)
13817
13818 the function is_dialect_of($lang1, $lang2)
13819
13820 the function super_languages($lang1)
13821
13822 the function locale2language_tag($locale_identifier)
13823
13824 the function encode_language_tag($lang1)
13825
13826 the function alternate_language_tags($lang1)
13827
13828 the function @langs = panic_languages(@accept_languages)
13829
13830 =over 4
13831
13832 =item ABOUT LOWERCASING
13833
13834 =item ABOUT UNICODE PLAINTEXT LANGUAGE TAGS
13835
13836 =item SEE ALSO
13837
13838 =item COPYRIGHT
13839
13840 =item AUTHOR
13841
13842 =back
13843
13844 =head2 I18N::LangTags::List -- tags and names for human languages
13845
13846 =over 4
13847
13848 =item SYNOPSIS
13849
13850 =item DESCRIPTION
13851
13852 =item ABOUT LANGUAGE TAGS
13853
13854 =item LIST OF LANGUAGES
13855
13856 {ab} : Abkhazian, {ace} : Achinese, {ach} : Acoli, {ada} : Adangme, {aa} :
13857 Afar, {afh} : Afrihili, {af} : Afrikaans, [{afa} : Afro-Asiatic (Other)],
13858 {aka} : Akan, {akk} : Akkadian, {sq} : Albanian, {ale} : Aleut, [{alg} :
13859 Algonquian languages], [{tut} : Altaic (Other)], {am} : Amharic, {i-ami} :
13860 Ami, [{apa} : Apache languages], {ar} : Arabic, {arc} : Aramaic, {arp} :
13861 Arapaho, {arn} : Araucanian, {arw} : Arawak, {hy} : Armenian, [{art} :
13862 Artificial (Other)], {as} : Assamese, [{ath} : Athapascan languages],
13863 [{aus} : Australian languages], [{map} : Austronesian (Other)], {ava} :
13864 Avaric, {ae} : Avestan, {awa} : Awadhi, {ay} : Aymara, {az} : Azerbaijani,
13865 {ban} : Balinese, [{bat} : Baltic (Other)], {bal} : Baluchi, {bam} :
13866 Bambara, [{bai} : Bamileke languages], {bad} : Banda, [{bnt} : Bantu
13867 (Other)], {bas} : Basa, {ba} : Bashkir, {eu} : Basque, {btk} : Batak
13868 (Indonesia), {bej} : Beja, {be} : Belarusian, {bem} : Bemba, {bn} :
13869 Bengali, [{ber} : Berber (Other)], {bho} : Bhojpuri, {bh} : Bihari, {bik} :
13870 Bikol, {bin} : Bini, {bi} : Bislama, {bs} : Bosnian, {bra} : Braj, {br} :
13871 Breton, {bug} : Buginese, {bg} : Bulgarian, {i-bnn} : Bunun, {bua} :
13872 Buriat, {my} : Burmese, {cad} : Caddo, {car} : Carib, {ca} : Catalan,
13873 [{cau} : Caucasian (Other)], {ceb} : Cebuano, [{cel} : Celtic (Other)],
13874 [{cai} : Central American Indian (Other)], {chg} : Chagatai, [{cmc} :
13875 Chamic languages], {ch} : Chamorro, {ce} : Chechen, {chr} : Cherokee, {chy}
13876 : Cheyenne, {chb} : Chibcha, {ny} : Chichewa, {zh} : Chinese, {chn} :
13877 Chinook Jargon, {chp} : Chipewyan, {cho} : Choctaw, {cu} : Church Slavic,
13878 {chk} : Chuukese, {cv} : Chuvash, {cop} : Coptic, {kw} : Cornish, {co} :
13879 Corsican, {cre} : Cree, {mus} : Creek, [{cpe} : English-based Creoles and
13880 pidgins (Other)], [{cpf} : French-based Creoles and pidgins (Other)],
13881 [{cpp} : Portuguese-based Creoles and pidgins (Other)], [{crp} : Creoles
13882 and pidgins (Other)], {hr} : Croatian, [{cus} : Cushitic (Other)], {cs} :
13883 Czech, {dak} : Dakota, {da} : Danish, {day} : Dayak, {i-default} : Default
13884 (Fallthru) Language, {del} : Delaware, {din} : Dinka, {div} : Divehi, {doi}
13885 : Dogri, {dgr} : Dogrib, [{dra} : Dravidian (Other)], {dua} : Duala, {nl} :
13886 Dutch, {dum} : Middle Dutch (ca.1050-1350), {dyu} : Dyula, {dz} : Dzongkha,
13887 {efi} : Efik, {egy} : Ancient Egyptian, {eka} : Ekajuk, {elx} : Elamite,
13888 {en} : English, {enm} : Old English (1100-1500), {ang} : Old English
13889 (ca.450-1100), {eo} : Esperanto, {et} : Estonian, {ewe} : Ewe, {ewo} :
13890 Ewondo, {fan} : Fang, {fat} : Fanti, {fo} : Faroese, {fj} : Fijian, {fi} :
13891 Finnish, [{fiu} : Finno-Ugrian (Other)], {fon} : Fon, {fr} : French, {frm}
13892 : Middle French (ca.1400-1600), {fro} : Old French (842-ca.1400), {fy} :
13893 Frisian, {fur} : Friulian, {ful} : Fulah, {gaa} : Ga, {gd} : Scots Gaelic,
13894 {gl} : Gallegan, {lug} : Ganda, {gay} : Gayo, {gba} : Gbaya, {gez} : Geez,
13895 {ka} : Georgian, {de} : German, {gmh} : Middle High German (ca.1050-1500),
13896 {goh} : Old High German (ca.750-1050), [{gem} : Germanic (Other)], {gil} :
13897 Gilbertese, {gon} : Gondi, {gor} : Gorontalo, {got} : Gothic, {grb} :
13898 Grebo, {grc} : Ancient Greek, {el} : Modern Greek, {gn} : Guarani, {gu} :
13899 Gujarati, {gwi} : Gwich'in, {hai} : Haida, {ha} : Hausa, {haw} : Hawaiian,
13900 {he} : Hebrew, {hz} : Herero, {hil} : Hiligaynon, {him} : Himachali, {hi} :
13901 Hindi, {ho} : Hiri Motu, {hit} : Hittite, {hmn} : Hmong, {hu} : Hungarian,
13902 {hup} : Hupa, {iba} : Iban, {is} : Icelandic, {ibo} : Igbo, {ijo} : Ijo,
13903 {ilo} : Iloko, [{inc} : Indic (Other)], [{ine} : Indo-European (Other)],
13904 {id} : Indonesian, {ia} : Interlingua (International Auxiliary Language
13905 Association), {ie} : Interlingue, {iu} : Inuktitut, {ik} : Inupiaq, [{ira}
13906 : Iranian (Other)], {ga} : Irish, {mga} : Middle Irish (900-1200), {sga} :
13907 Old Irish (to 900), [{iro} : Iroquoian languages], {it} : Italian, {ja} :
13908 Japanese, {jw} : Javanese, {jrb} : Judeo-Arabic, {jpr} : Judeo-Persian,
13909 {kab} : Kabyle, {kac} : Kachin, {kl} : Kalaallisut, {kam} : Kamba, {kn} :
13910 Kannada, {kau} : Kanuri, {kaa} : Kara-Kalpak, {kar} : Karen, {ks} :
13911 Kashmiri, {kaw} : Kawi, {kk} : Kazakh, {kha} : Khasi, {km} : Khmer, [{khi}
13912 : Khoisan (Other)], {kho} : Khotanese, {ki} : Kikuyu, {kmb} : Kimbundu,
13913 {rw} : Kinyarwanda, {ky} : Kirghiz, {i-klingon} : Klingon, {kv} : Komi,
13914 {kon} : Kongo, {kok} : Konkani, {ko} : Korean, {kos} : Kosraean, {kpe} :
13915 Kpelle, {kro} : Kru, {kj} : Kuanyama, {kum} : Kumyk, {ku} : Kurdish, {kru}
13916 : Kurukh, {kut} : Kutenai, {lad} : Ladino, {lah} : Lahnda, {lam} : Lamba,
13917 {lo} : Lao, {la} : Latin, {lv} : Latvian, {lb} : Letzeburgesch, {lez} :
13918 Lezghian, {ln} : Lingala, {lt} : Lithuanian, {nds} : Low German, {loz} :
13919 Lozi, {lub} : Luba-Katanga, {lua} : Luba-Lulua, {lui} : Luiseno, {lun} :
13920 Lunda, {luo} : Luo (Kenya and Tanzania), {lus} : Lushai, {mk} : Macedonian,
13921 {mad} : Madurese, {mag} : Magahi, {mai} : Maithili, {mak} : Makasar, {mg} :
13922 Malagasy, {ms} : Malay, {ml} : Malayalam, {mt} : Maltese, {mnc} : Manchu,
13923 {mdr} : Mandar, {man} : Mandingo, {mni} : Manipuri, [{mno} : Manobo
13924 languages], {gv} : Manx, {mi} : Maori, {mr} : Marathi, {chm} : Mari, {mh} :
13925 Marshall, {mwr} : Marwari, {mas} : Masai, [{myn} : Mayan languages], {men}
13926 : Mende, {mic} : Micmac, {min} : Minangkabau, {i-mingo} : Mingo, [{mis} :
13927 Miscellaneous languages], {moh} : Mohawk, {mo} : Moldavian, [{mkh} :
13928 Mon-Khmer (Other)], {lol} : Mongo, {mn} : Mongolian, {mos} : Mossi, [{mul}
13929 : Multiple languages], [{mun} : Munda languages], {nah} : Nahuatl, {na} :
13930 Nauru, {nv} : Navajo, {nd} : North Ndebele, {nr} : South Ndebele, {ng} :
13931 Ndonga, {ne} : Nepali, {new} : Newari, {nia} : Nias, [{nic} :
13932 Niger-Kordofanian (Other)], [{ssa} : Nilo-Saharan (Other)], {niu} : Niuean,
13933 {non} : Old Norse, [{nai} : North American Indian], {se} : Northern Sami,
13934 {no} : Norwegian, {nb} : Norwegian Bokmal, {nn} : Norwegian Nynorsk, [{nub}
13935 : Nubian languages], {nym} : Nyamwezi, {nyn} : Nyankole, {nyo} : Nyoro,
13936 {nzi} : Nzima, {oc} : Occitan (post 1500), {oji} : Ojibwa, {or} : Oriya,
13937 {om} : Oromo, {osa} : Osage, {os} : Ossetian; Ossetic, [{oto} : Otomian
13938 languages], {pal} : Pahlavi, {i-pwn} : Paiwan, {pau} : Palauan, {pi} :
13939 Pali, {pam} : Pampanga, {pag} : Pangasinan, {pa} : Panjabi, {pap} :
13940 Papiamento, [{paa} : Papuan (Other)], {fa} : Persian, {peo} : Old Persian
13941 (ca.600-400 B.C.), [{phi} : Philippine (Other)], {phn} : Phoenician, {pon}
13942 : Pohnpeian, {pl} : Polish, {pt} : Portuguese, [{pra} : Prakrit languages],
13943 {pro} : Old Provencal (to 1500), {ps} : Pushto, {qu} : Quechua, {rm} :
13944 Raeto-Romance, {raj} : Rajasthani, {rap} : Rapanui, {rar} : Rarotongan,
13945 [{qaa - qtz} : Reserved for local use.], [{roa} : Romance (Other)], {ro} :
13946 Romanian, {rom} : Romany, {rn} : Rundi, {ru} : Russian, [{sal} : Salishan
13947 languages], {sam} : Samaritan Aramaic, [{smi} : Sami languages (Other)],
13948 {sm} : Samoan, {sad} : Sandawe, {sg} : Sango, {sa} : Sanskrit, {sat} :
13949 Santali, {sc} : Sardinian, {sas} : Sasak, {sco} : Scots, {sel} : Selkup,
13950 [{sem} : Semitic (Other)], {sr} : Serbian, {srr} : Serer, {shn} : Shan,
13951 {sn} : Shona, {sid} : Sidamo, {sgn-...} : Sign Languages, {bla} : Siksika,
13952 {sd} : Sindhi, {si} : Sinhalese, [{sit} : Sino-Tibetan (Other)], [{sio} :
13953 Siouan languages], {den} : Slave (Athapascan), [{sla} : Slavic (Other)],
13954 {sk} : Slovak, {sl} : Slovenian, {sog} : Sogdian, {so} : Somali, {son} :
13955 Songhai, {snk} : Soninke, {wen} : Sorbian languages, {nso} : Northern
13956 Sotho, {st} : Southern Sotho, [{sai} : South American Indian (Other)], {es}
13957 : Spanish, {suk} : Sukuma, {sux} : Sumerian, {su} : Sundanese, {sus} :
13958 Susu, {sw} : Swahili, {ss} : Swati, {sv} : Swedish, {syr} : Syriac, {tl} :
13959 Tagalog, {ty} : Tahitian, [{tai} : Tai (Other)], {tg} : Tajik, {tmh} :
13960 Tamashek, {ta} : Tamil, {i-tao} : Tao, {tt} : Tatar, {i-tay} : Tayal, {te}
13961 : Telugu, {ter} : Tereno, {tet} : Tetum, {th} : Thai, {bo} : Tibetan, {tig}
13962 : Tigre, {ti} : Tigrinya, {tem} : Timne, {tiv} : Tiv, {tli} : Tlingit,
13963 {tpi} : Tok Pisin, {tkl} : Tokelau, {tog} : Tonga (Nyasa), {to} : Tonga
13964 (Tonga Islands), {tsi} : Tsimshian, {ts} : Tsonga, {i-tsu} : Tsou, {tn} :
13965 Tswana, {tum} : Tumbuka, {tr} : Turkish, {ota} : Ottoman Turkish
13966 (1500-1928), {tk} : Turkmen, {tvl} : Tuvalu, {tyv} : Tuvinian, {tw} : Twi,
13967 {uga} : Ugaritic, {ug} : Uighur, {uk} : Ukrainian, {umb} : Umbundu, {und} :
13968 Undetermined, {ur} : Urdu, {uz} : Uzbek, {vai} : Vai, {ven} : Venda, {vi} :
13969 Vietnamese, {vo} : Volapuk, {vot} : Votic, [{wak} : Wakashan languages],
13970 {wal} : Walamo, {war} : Waray, {was} : Washo, {cy} : Welsh, {wo} : Wolof,
13971 {x-...} : Unregistered (Semi-Private Use), {xh} : Xhosa, {sah} : Yakut,
13972 {yao} : Yao, {yap} : Yapese, {yi} : Yiddish, {yo} : Yoruba, [{ypk} : Yupik
13973 languages], {znd} : Zande, [{zap} : Zapotec], {zen} : Zenaga, {za} :
13974 Zhuang, {zu} : Zulu, {zun} : Zuni
13975
13976 =item SEE ALSO
13977
13978 =item COPYRIGHT AND DISCLAIMER
13979
13980 =item AUTHOR
13981
13982 =back
13983
13984 =head2 I18N::Langinfo - query locale information
13985
13986 =over 4
13987
13988 =item SYNOPSIS
13989
13990 =item DESCRIPTION
13991
13992 =over 4
13993
13994 =item EXPORT
13995
13996 =back
13997
13998 =item SEE ALSO
13999
14000 =item AUTHOR
14001
14002 =item COPYRIGHT AND LICENSE
14003
14004 =back
14005
14006 =head2 IO - load various IO modules
14007
14008 =over 4
14009
14010 =item SYNOPSIS
14011
14012 =item DESCRIPTION
14013
14014 =back
14015
14016 =head2 IO::Dir - supply object methods for directory handles
14017
14018 =over 4
14019
14020 =item SYNOPSIS
14021
14022 =item DESCRIPTION
14023
14024 new ( [ DIRNAME ] ), open ( DIRNAME ), read (), seek ( POS ), tell (),
14025 rewind (), close (), tie %hash, IO::Dir, DIRNAME [, OPTIONS ]
14026
14027 =item SEE ALSO
14028
14029 =item AUTHOR
14030
14031 =item COPYRIGHT
14032
14033 =back
14034
14035 =head2 IO::File - supply object methods for filehandles
14036
14037 =over 4
14038
14039 =item SYNOPSIS
14040
14041 =item DESCRIPTION
14042
14043 =item CONSTRUCTOR
14044
14045 new ( FILENAME [,MODE [,PERMS]] ), new_tmpfile
14046
14047 =item METHODS
14048
14049 open( FILENAME [,MODE [,PERMS]] )
14050
14051 =item SEE ALSO
14052
14053 =item HISTORY
14054
14055 =back
14056
14057 =head2 IO::Handle - supply object methods for I/O handles
14058
14059 =over 4
14060
14061 =item SYNOPSIS
14062
14063 =item DESCRIPTION
14064
14065 =item CONSTRUCTOR
14066
14067 new (), new_from_fd ( FD, MODE )
14068
14069 =item METHODS
14070
14071 $io->fdopen ( FD, MODE ), $io->opened, $io->getline, $io->getlines,
14072 $io->ungetc ( ORD ), $io->write ( BUF, LEN [, OFFSET ] ), $io->error,
14073 $io->clearerr, $io->sync, $io->flush, $io->printflush ( ARGS ),
14074 $io->blocking ( [ BOOL ] ), $io->untaint
14075
14076 =item NOTE
14077
14078 =item SEE ALSO
14079
14080 =item BUGS
14081
14082 =item HISTORY
14083
14084 =back
14085
14086 =head2 IO::Pipe - supply object methods for pipes
14087
14088 =over 4
14089
14090 =item SYNOPSIS
14091
14092 =item DESCRIPTION
14093
14094 =item CONSTRUCTOR
14095
14096 new ( [READER, WRITER] )
14097
14098 =item METHODS
14099
14100 reader ([ARGS]), writer ([ARGS]), handles ()
14101
14102 =item SEE ALSO
14103
14104 =item AUTHOR
14105
14106 =item COPYRIGHT
14107
14108 =back
14109
14110 =head2 IO::Poll - Object interface to system poll call
14111
14112 =over 4
14113
14114 =item SYNOPSIS
14115
14116 =item DESCRIPTION
14117
14118 =item METHODS
14119
14120 mask ( IO [, EVENT_MASK ] ), poll ( [ TIMEOUT ] ), events ( IO ), remove (
14121 IO ), handles( [ EVENT_MASK ] )
14122
14123 =item SEE ALSO
14124
14125 =item AUTHOR
14126
14127 =item COPYRIGHT
14128
14129 =back
14130
14131 =head2 IO::Seekable - supply seek based methods for I/O objects
14132
14133 =over 4
14134
14135 =item SYNOPSIS
14136
14137 =item DESCRIPTION
14138
14139 $io->getpos, $io->setpos, $io->seek ( POS, WHENCE ), WHENCE=0 (SEEK_SET),
14140 WHENCE=1 (SEEK_CUR), WHENCE=2 (SEEK_END), $io->sysseek( POS, WHENCE ),
14141 $io->tell
14142
14143 =item SEE ALSO
14144
14145 =item HISTORY
14146
14147 =back
14148
14149 =head2 IO::Select - OO interface to the select system call
14150
14151 =over 4
14152
14153 =item SYNOPSIS
14154
14155 =item DESCRIPTION
14156
14157 =item CONSTRUCTOR
14158
14159 new ( [ HANDLES ] )
14160
14161 =item METHODS
14162
14163 add ( HANDLES ), remove ( HANDLES ), exists ( HANDLE ), handles, can_read (
14164 [ TIMEOUT ] ), can_write ( [ TIMEOUT ] ), has_exception ( [ TIMEOUT ] ),
14165 count (), bits(), select ( READ, WRITE, ERROR [, TIMEOUT ] )
14166
14167 =item EXAMPLE
14168
14169 =item AUTHOR
14170
14171 =item COPYRIGHT
14172
14173 =back
14174
14175 =head2 IO::Socket - Object interface to socket communications
14176
14177 =over 4
14178
14179 =item SYNOPSIS
14180
14181 =item DESCRIPTION
14182
14183 =item CONSTRUCTOR
14184
14185 new ( [ARGS] )
14186
14187 =item METHODS
14188
14189 accept([PKG]), socketpair(DOMAIN, TYPE, PROTOCOL), atmark, connected,
14190 protocol, sockdomain, sockopt(OPT [, VAL]), socktype, timeout([VAL])
14191
14192 =item SEE ALSO
14193
14194 =item AUTHOR
14195
14196 =item COPYRIGHT
14197
14198 =back
14199
14200 =head2 IO::Socket::INET - Object interface for AF_INET domain sockets
14201
14202 =over 4
14203
14204 =item SYNOPSIS
14205
14206 =item DESCRIPTION
14207
14208 =item CONSTRUCTOR
14209
14210 new ( [ARGS] )
14211
14212 =over 4
14213
14214 =item METHODS
14215
14216 sockaddr (), sockport (), sockhost (), peeraddr (), peerport (), peerhost
14217 ()
14218
14219 =back
14220
14221 =item SEE ALSO
14222
14223 =item AUTHOR
14224
14225 =item COPYRIGHT
14226
14227 =back
14228
14229 =head2 IO::Socket::UNIX - Object interface for AF_UNIX domain sockets
14230
14231 =over 4
14232
14233 =item SYNOPSIS
14234
14235 =item DESCRIPTION
14236
14237 =item CONSTRUCTOR
14238
14239 new ( [ARGS] )
14240
14241 =item METHODS
14242
14243 hostpath(), peerpath()
14244
14245 =item SEE ALSO
14246
14247 =item AUTHOR
14248
14249 =item COPYRIGHT
14250
14251 =back
14252
14253 =head2 IO::lib::IO::Dir, IO::Dir - supply object methods for directory
14254 handles
14255
14256 =over 4
14257
14258 =item SYNOPSIS
14259
14260 =item DESCRIPTION
14261
14262 new ( [ DIRNAME ] ), open ( DIRNAME ), read (), seek ( POS ), tell (),
14263 rewind (), close (), tie %hash, IO::Dir, DIRNAME [, OPTIONS ]
14264
14265 =item SEE ALSO
14266
14267 =item AUTHOR
14268
14269 =item COPYRIGHT
14270
14271 =back
14272
14273 =head2 IO::lib::IO::File, IO::File - supply object methods for filehandles
14274
14275 =over 4
14276
14277 =item SYNOPSIS
14278
14279 =item DESCRIPTION
14280
14281 =item CONSTRUCTOR
14282
14283 new ( FILENAME [,MODE [,PERMS]] ), new_tmpfile
14284
14285 =item METHODS
14286
14287 open( FILENAME [,MODE [,PERMS]] )
14288
14289 =item SEE ALSO
14290
14291 =item HISTORY
14292
14293 =back
14294
14295 =head2 IO::lib::IO::Handle, IO::Handle - supply object methods for I/O
14296 handles
14297
14298 =over 4
14299
14300 =item SYNOPSIS
14301
14302 =item DESCRIPTION
14303
14304 =item CONSTRUCTOR
14305
14306 new (), new_from_fd ( FD, MODE )
14307
14308 =item METHODS
14309
14310 $io->fdopen ( FD, MODE ), $io->opened, $io->getline, $io->getlines,
14311 $io->ungetc ( ORD ), $io->write ( BUF, LEN [, OFFSET ] ), $io->error,
14312 $io->clearerr, $io->sync, $io->flush, $io->printflush ( ARGS ),
14313 $io->blocking ( [ BOOL ] ), $io->untaint
14314
14315 =item NOTE
14316
14317 =item SEE ALSO
14318
14319 =item BUGS
14320
14321 =item HISTORY
14322
14323 =back
14324
14325 =head2 IO::lib::IO::Pipe, IO::Pipe - supply object methods for pipes
14326
14327 =over 4
14328
14329 =item SYNOPSIS
14330
14331 =item DESCRIPTION
14332
14333 =item CONSTRUCTOR
14334
14335 new ( [READER, WRITER] )
14336
14337 =item METHODS
14338
14339 reader ([ARGS]), writer ([ARGS]), handles ()
14340
14341 =item SEE ALSO
14342
14343 =item AUTHOR
14344
14345 =item COPYRIGHT
14346
14347 =back
14348
14349 =head2 IO::lib::IO::Poll, IO::Poll - Object interface to system poll call
14350
14351 =over 4
14352
14353 =item SYNOPSIS
14354
14355 =item DESCRIPTION
14356
14357 =item METHODS
14358
14359 mask ( IO [, EVENT_MASK ] ), poll ( [ TIMEOUT ] ), events ( IO ), remove (
14360 IO ), handles( [ EVENT_MASK ] )
14361
14362 =item SEE ALSO
14363
14364 =item AUTHOR
14365
14366 =item COPYRIGHT
14367
14368 =back
14369
14370 =head2 IO::lib::IO::Seekable, IO::Seekable - supply seek based methods for
14371 I/O objects
14372
14373 =over 4
14374
14375 =item SYNOPSIS
14376
14377 =item DESCRIPTION
14378
14379 $io->getpos, $io->setpos, $io->seek ( POS, WHENCE ), WHENCE=0 (SEEK_SET),
14380 WHENCE=1 (SEEK_CUR), WHENCE=2 (SEEK_END), $io->sysseek( POS, WHENCE ),
14381 $io->tell
14382
14383 =item SEE ALSO
14384
14385 =item HISTORY
14386
14387 =back
14388
14389 =head2 IO::lib::IO::Select, IO::Select - OO interface to the select system
14390 call
14391
14392 =over 4
14393
14394 =item SYNOPSIS
14395
14396 =item DESCRIPTION
14397
14398 =item CONSTRUCTOR
14399
14400 new ( [ HANDLES ] )
14401
14402 =item METHODS
14403
14404 add ( HANDLES ), remove ( HANDLES ), exists ( HANDLE ), handles, can_read (
14405 [ TIMEOUT ] ), can_write ( [ TIMEOUT ] ), has_exception ( [ TIMEOUT ] ),
14406 count (), bits(), select ( READ, WRITE, ERROR [, TIMEOUT ] )
14407
14408 =item EXAMPLE
14409
14410 =item AUTHOR
14411
14412 =item COPYRIGHT
14413
14414 =back
14415
14416 =head2 IO::lib::IO::Socket, IO::Socket - Object interface to socket
14417 communications
14418
14419 =over 4
14420
14421 =item SYNOPSIS
14422
14423 =item DESCRIPTION
14424
14425 =item CONSTRUCTOR
14426
14427 new ( [ARGS] )
14428
14429 =item METHODS
14430
14431 accept([PKG]), socketpair(DOMAIN, TYPE, PROTOCOL), atmark, connected,
14432 protocol, sockdomain, sockopt(OPT [, VAL]), socktype, timeout([VAL])
14433
14434 =item SEE ALSO
14435
14436 =item AUTHOR
14437
14438 =item COPYRIGHT
14439
14440 =back
14441
14442 =head2 IO::lib::IO::Socket::INET, IO::Socket::INET - Object interface for
14443 AF_INET domain sockets
14444
14445 =over 4
14446
14447 =item SYNOPSIS
14448
14449 =item DESCRIPTION
14450
14451 =item CONSTRUCTOR
14452
14453 new ( [ARGS] )
14454
14455 =over 4
14456
14457 =item METHODS
14458
14459 sockaddr (), sockport (), sockhost (), peeraddr (), peerport (), peerhost
14460 ()
14461
14462 =back
14463
14464 =item SEE ALSO
14465
14466 =item AUTHOR
14467
14468 =item COPYRIGHT
14469
14470 =back
14471
14472 =head2 IO::lib::IO::Socket::UNIX, IO::Socket::UNIX - Object interface for
14473 AF_UNIX domain sockets
14474
14475 =over 4
14476
14477 =item SYNOPSIS
14478
14479 =item DESCRIPTION
14480
14481 =item CONSTRUCTOR
14482
14483 new ( [ARGS] )
14484
14485 =item METHODS
14486
14487 hostpath(), peerpath()
14488
14489 =item SEE ALSO
14490
14491 =item AUTHOR
14492
14493 =item COPYRIGHT
14494
14495 =back
14496
14497 =head2 IPC::Msg - SysV Msg IPC object class
14498
14499 =over 4
14500
14501 =item SYNOPSIS
14502
14503 =item DESCRIPTION
14504
14505 =item METHODS
14506
14507 new ( KEY , FLAGS ), id, rcv ( BUF, LEN [, TYPE [, FLAGS ]] ), remove, set
14508 ( STAT ), set ( NAME => VALUE [, NAME => VALUE ...] ), snd ( TYPE, MSG [,
14509 FLAGS ] ), stat
14510
14511 =item SEE ALSO
14512
14513 =item AUTHOR
14514
14515 =item COPYRIGHT
14516
14517 =back
14518
14519 =head2 IPC::Open2, open2 - open a process for both reading and writing
14520
14521 =over 4
14522
14523 =item SYNOPSIS
14524
14525 =item DESCRIPTION
14526
14527 =item WARNING
14528
14529 =item SEE ALSO
14530
14531 =back
14532
14533 =head2 IPC::Open3, open3 - open a process for reading, writing, and error
14534 handling
14535
14536 =over 4
14537
14538 =item SYNOPSIS
14539
14540 =item DESCRIPTION
14541
14542 =item WARNING
14543
14544 =back
14545
14546 =head2 IPC::Semaphore - SysV Semaphore IPC object class
14547
14548 =over 4
14549
14550 =item SYNOPSIS
14551
14552 =item DESCRIPTION
14553
14554 =item METHODS
14555
14556 new ( KEY , NSEMS , FLAGS ), getall, getncnt ( SEM ), getpid ( SEM ),
14557 getval ( SEM ), getzcnt ( SEM ), id, op ( OPLIST ), remove, set ( STAT ),
14558 set ( NAME => VALUE [, NAME => VALUE ...] ), setall ( VALUES ), setval ( N
14559 , VALUE ), stat
14560
14561 =item SEE ALSO
14562
14563 =item AUTHOR
14564
14565 =item COPYRIGHT
14566
14567 =back
14568
14569 =head2 IPC::SysV - SysV IPC constants
14570
14571 =over 4
14572
14573 =item SYNOPSIS
14574
14575 =item DESCRIPTION
14576
14577 ftok( PATH, ID )
14578
14579 =item SEE ALSO
14580
14581 =item AUTHORS
14582
14583 =item COPYRIGHT
14584
14585 =back
14586
14587 =head2 IPC::SysV::Msg, IPC::Msg - SysV Msg IPC object class
14588
14589 =over 4
14590
14591 =item SYNOPSIS
14592
14593 =item DESCRIPTION
14594
14595 =item METHODS
14596
14597 new ( KEY , FLAGS ), id, rcv ( BUF, LEN [, TYPE [, FLAGS ]] ), remove, set
14598 ( STAT ), set ( NAME => VALUE [, NAME => VALUE ...] ), snd ( TYPE, MSG [,
14599 FLAGS ] ), stat
14600
14601 =item SEE ALSO
14602
14603 =item AUTHOR
14604
14605 =item COPYRIGHT
14606
14607 =back
14608
14609 =head2 IPC::SysV::Semaphore, IPC::Semaphore - SysV Semaphore IPC object
14610 class
14611
14612 =over 4
14613
14614 =item SYNOPSIS
14615
14616 =item DESCRIPTION
14617
14618 =item METHODS
14619
14620 new ( KEY , NSEMS , FLAGS ), getall, getncnt ( SEM ), getpid ( SEM ),
14621 getval ( SEM ), getzcnt ( SEM ), id, op ( OPLIST ), remove, set ( STAT ),
14622 set ( NAME => VALUE [, NAME => VALUE ...] ), setall ( VALUES ), setval ( N
14623 , VALUE ), stat
14624
14625 =item SEE ALSO
14626
14627 =item AUTHOR
14628
14629 =item COPYRIGHT
14630
14631 =back
14632
14633 =head2 List::Util - A selection of general-utility list subroutines
14634
14635 =over 4
14636
14637 =item SYNOPSIS
14638
14639 =item DESCRIPTION
14640
14641 first BLOCK LIST, max LIST, maxstr LIST, min LIST, minstr LIST, reduce
14642 BLOCK LIST, shuffle LIST, sum LIST
14643
14644 =item KNOWN BUGS
14645
14646 =item SUGGESTED ADDITIONS
14647
14648 =item COPYRIGHT
14649
14650 =back
14651
14652 =head2 List::Utilib::List::Util, List::Util - A selection of
14653 general-utility list subroutines
14654
14655 =over 4
14656
14657 =item SYNOPSIS
14658
14659 =item DESCRIPTION
14660
14661 first BLOCK LIST, max LIST, maxstr LIST, min LIST, minstr LIST, reduce
14662 BLOCK LIST, shuffle LIST, sum LIST
14663
14664 =item KNOWN BUGS
14665
14666 =item SUGGESTED ADDITIONS
14667
14668 =item COPYRIGHT
14669
14670 =back
14671
14672 =head2 List::Utilib::Scalar::Util, Scalar::Util - A selection of
14673 general-utility scalar subroutines
14674
14675 =over 4
14676
14677 =item SYNOPSIS
14678
14679 =item DESCRIPTION
14680
14681 blessed EXPR, dualvar NUM, STRING, isweak EXPR, openhandle FH, reftype
14682 EXPR, tainted EXPR, weaken REF
14683
14684 =item KNOWN BUGS
14685
14686 =item COPYRIGHT
14687
14688 =item BLATANT PLUG
14689
14690 =back
14691
14692 =head2 Locale::Constants - constants for Locale codes
14693
14694 =over 4
14695
14696 =item SYNOPSIS
14697
14698 =item DESCRIPTION
14699
14700 =item KNOWN BUGS AND LIMITATIONS
14701
14702 =item SEE ALSO
14703
14704 Locale::Language, Locale::Country, Locale::Script, Locale::Currency
14705
14706 =item AUTHOR
14707
14708 =item COPYRIGHT
14709
14710 =back
14711
14712 =head2 Locale::Country - ISO codes for country identification (ISO 3166)
14713
14714 =over 4
14715
14716 =item SYNOPSIS
14717
14718 =item DESCRIPTION
14719
14720 B<alpha-2>, B<alpha-3>, B<numeric>
14721
14722 =item CONVERSION ROUTINES
14723
14724 code2country( CODE, [ CODESET ] ), country2code( STRING, [ CODESET ] ),
14725 country_code2code( CODE, CODESET, CODESET )
14726
14727 =item QUERY ROUTINES
14728
14729 C<all_country_codes( [ CODESET ] )>, C<all_country_names( [ CODESET ] )>
14730
14731 =item SEMI-PRIVATE ROUTINES
14732
14733 =over 4
14734
14735 =item alias_code
14736
14737 =item rename_country
14738
14739 =back
14740
14741 =item EXAMPLES
14742
14743 =item DOMAIN NAMES
14744
14745 =item KNOWN BUGS AND LIMITATIONS
14746
14747 =item SEE ALSO
14748
14749 Locale::Language, Locale::Script, Locale::Currency, Locale::SubCountry, ISO
14750 3166-1, http://www.iso.org/iso/en/prods-services/iso3166ma/index.html,
14751 http://www.egt.ie/standards/iso3166/iso3166-1-en.html,
14752 http://www.cia.gov/cia/publications/factbook/docs/app-f.html
14753
14754 =item AUTHOR
14755
14756 =item COPYRIGHT
14757
14758 =back
14759
14760 =head2 Locale::Currency - ISO three letter codes for currency
14761 identification (ISO 4217)
14762
14763 =over 4
14764
14765 =item SYNOPSIS
14766
14767 =item DESCRIPTION
14768
14769 XTS, XXX
14770
14771 =item CONVERSION ROUTINES
14772
14773 code2currency(), currency2code()
14774
14775 =item QUERY ROUTINES
14776
14777 C<all_currency_codes()>, C<all_currency_names()>
14778
14779 =item EXAMPLES
14780
14781 =item KNOWN BUGS AND LIMITATIONS
14782
14783 =item SEE ALSO
14784
14785 Locale::Country, Locale::Script, ISO 4217:1995,
14786 http://www.bsi-global.com/iso4217currency
14787
14788 =item AUTHOR
14789
14790 =item COPYRIGHT
14791
14792 =back
14793
14794 =head2 Locale::Language - ISO two letter codes for language identification
14795 (ISO 639)
14796
14797 =over 4
14798
14799 =item SYNOPSIS
14800
14801 =item DESCRIPTION
14802
14803 =item CONVERSION ROUTINES
14804
14805 code2language(), language2code()
14806
14807 =item QUERY ROUTINES
14808
14809 C<all_language_codes()>, C<all_language_names()>
14810
14811 =item EXAMPLES
14812
14813 =item KNOWN BUGS AND LIMITATIONS
14814
14815 =item SEE ALSO
14816
14817 Locale::Country, Locale::Script, Locale::Currency, ISO 639:1988 (E/F),
14818 http://lcweb.loc.gov/standards/iso639-2/langhome.html
14819
14820 =item AUTHOR
14821
14822 =item COPYRIGHT
14823
14824 =back
14825
14826 =head2 Locale::Maketext -- framework for localization
14827
14828 =over 4
14829
14830 =item SYNOPSIS
14831
14832 =item DESCRIPTION
14833
14834 =item QUICK OVERVIEW
14835
14836 =item METHODS
14837
14838 =over 4
14839
14840 =item Construction Methods
14841
14842 =item The "maketext" Method
14843
14844 $lh->fail_with I<or> $lh->fail_with(I<PARAM>), $lh->failure_handler_auto
14845
14846 =item Utility Methods
14847
14848 $language->quant($number, $singular), $language->quant($number, $singular,
14849 $plural), $language->quant($number, $singular, $plural, $negative),
14850 $language->numf($number), $language->sprintf($format, @items),
14851 $language->language_tag(), $language->encoding()
14852
14853 =item Language Handle Attributes and Internals
14854
14855 =back
14856
14857 =item LANGUAGE CLASS HIERARCHIES
14858
14859 =item ENTRIES IN EACH LEXICON
14860
14861 =item BRACKET NOTATION
14862
14863 =item AUTO LEXICONS
14864
14865 =item CONTROLLING LOOKUP FAILURE
14866
14867 =item HOW TO USE MAKETEXT
14868
14869 =item SEE ALSO
14870
14871 =item COPYRIGHT AND DISCLAIMER
14872
14873 =item AUTHOR
14874
14875 =back
14876
14877 =head2 Locale::Maketext::TPJ13 -- article about software localization
14878
14879 =over 4
14880
14881 =item SYNOPSIS
14882
14883 =item DESCRIPTION
14884
14885 =item Localization and Perl: gettext breaks, Maketext fixes
14886
14887 =over 4
14888
14889 =item A Localization Horror Story: It Could Happen To You
14890
14891 =item The Linguistic View
14892
14893 =item Breaking gettext
14894
14895 =item Replacing gettext
14896
14897 =item Buzzwords: Abstraction and Encapsulation
14898
14899 =item Buzzword: Isomorphism
14900
14901 =item Buzzword: Inheritance
14902
14903 =item Buzzword: Concision
14904
14905 =item The Devil in the Details
14906
14907 =item The Proof in the Pudding: Localizing Web Sites
14908
14909 =item References
14910
14911 =back
14912
14913 =back
14914
14915 =head2 Locale::Script - ISO codes for script identification (ISO 15924)
14916
14917 =over 4
14918
14919 =item SYNOPSIS
14920
14921 =item DESCRIPTION
14922
14923 B<alpha-2>, B<alpha-3>, B<numeric>
14924
14925 =over 4
14926
14927 =item SPECIAL CODES
14928
14929 =back
14930
14931 =item CONVERSION ROUTINES
14932
14933 code2script( CODE, [ CODESET ] ), script2code( STRING, [ CODESET ] ),
14934 script_code2code( CODE, CODESET, CODESET )
14935
14936 =item QUERY ROUTINES
14937
14938 C<all_script_codes ( [ CODESET ] )>, C<all_script_names ( [ CODESET ] )>
14939
14940 =item EXAMPLES
14941
14942 =item KNOWN BUGS AND LIMITATIONS
14943
14944 =item SEE ALSO
14945
14946 Locale::Language, Locale::Currency, Locale::Country, ISO 15924,
14947 http://www.evertype.com/standards/iso15924/
14948
14949 =item AUTHOR
14950
14951 =item COPYRIGHT
14952
14953 =back
14954
14955 =head2 MIME::Base64 - Encoding and decoding of base64 strings
14956
14957 =over 4
14958
14959 =item SYNOPSIS
14960
14961 =item DESCRIPTION
14962
14963 encode_base64($str, [$eol]), decode_base64($str)
14964
14965 =item DIAGNOSTICS
14966
14967 Premature end of base64 data, Premature padding of base64 data
14968
14969 =item EXAMPLES
14970
14971 =item COPYRIGHT
14972
14973 =back
14974
14975 =head2 MIME::Base64::QuotedPrint, MIME::QuotedPrint - Encoding and decoding
14976 of quoted-printable strings
14977
14978 =over 4
14979
14980 =item SYNOPSIS
14981
14982 =item DESCRIPTION
14983
14984 encode_qp($str), decode_qp($str);
14985
14986 =item COPYRIGHT
14987
14988 =back
14989
14990 =head2 MIME::QuotedPrint - Encoding and decoding of quoted-printable
14991 strings
14992
14993 =over 4
14994
14995 =item SYNOPSIS
14996
14997 =item DESCRIPTION
14998
14999 encode_qp($str), decode_qp($str);
15000
15001 =item COPYRIGHT
15002
15003 =back
15004
15005 =head2 Math::BigFloat - Arbitrary size floating point math package
15006
15007 =over 4
15008
15009 =item SYNOPSIS
15010
15011 =item DESCRIPTION
15012
15013 =over 4
15014
15015 =item Canonical notation
15016
15017 =item Output
15018
15019 =item C<mantissa()>, C<exponent()> and C<parts()>
15020
15021 =item Accuracy vs. Precision
15022
15023 =item Rounding
15024
15025 ffround ( +$scale ), ffround ( -$scale ), ffround ( 0 ), fround  ( +$scale
15026 ), fround  ( -$scale ) and fround ( 0 )
15027
15028 =back
15029
15030 =item EXAMPLES
15031
15032   # not ready yet
15033
15034 =item Autocreating constants
15035
15036 =over 4
15037
15038 =item Math library
15039
15040 =item Using Math::BigInt::Lite
15041
15042 =back
15043
15044 =item BUGS
15045
15046 =item CAVEAT
15047
15048 stringify, bstr(), bdiv, Modifying and =, bpow
15049
15050 =item LICENSE
15051
15052 =item AUTHORS
15053
15054 =back
15055
15056 =head2 Math::BigInt - Arbitrary size integer math package
15057
15058 =over 4
15059
15060 =item SYNOPSIS
15061
15062 =item DESCRIPTION
15063
15064 Canonical notation, Input, Output
15065
15066 =item METHODS
15067
15068 =over 4
15069
15070 =item config
15071
15072 =item accuracy
15073
15074 =item brsft
15075
15076 =item new
15077
15078 =item bnan
15079
15080 =item bzero
15081
15082 =item binf
15083
15084 =item bone
15085
15086 =item is_one()/is_zero()/is_nan()/is_inf()
15087
15088 =item is_positive()/is_negative()
15089
15090         $x->is_positive();              # true if >= 0
15091         $x->is_negative();              # true if <  0
15092
15093 =item is_odd()/is_even()/is_int()
15094
15095 =item bcmp
15096
15097 =item bacmp
15098
15099 =item sign
15100
15101 =item bcmp
15102
15103 =item bneg
15104
15105 =item babs
15106
15107 =item bnorm
15108
15109 =item bnot
15110
15111 =item binc
15112
15113 =item bdec
15114
15115 =item badd
15116
15117 =item bsub
15118
15119 =item bmul
15120
15121 =item bdiv
15122
15123 =item bmod
15124
15125 =item bpow
15126
15127 =item blsft
15128
15129 =item brsft
15130
15131 =item band
15132
15133 =item bior
15134
15135 =item bxor
15136
15137 =item bnot
15138
15139 =item bsqrt
15140
15141 =item bfac
15142
15143 =item round
15144
15145 =item bround
15146
15147 =item bfround
15148
15149 =item bfloor
15150
15151 =item bceil
15152
15153 =item bgcd
15154
15155 =item blcm
15156
15157 =item exponent
15158
15159 =item mantissa
15160
15161 =item parts
15162
15163 =item copy
15164
15165 =item as_number
15166
15167 =item bsstr
15168
15169 =item as_hex
15170
15171 =item as_bin
15172
15173 =back
15174
15175 =item ACCURACY and PRECISION
15176
15177 =over 4
15178
15179 =item Precision P
15180
15181 =item Accuracy A
15182
15183 =item Fallback F
15184
15185 =item Rounding mode R
15186
15187 'trunc', 'even', 'odd', '+inf', '-inf', 'zero', Precision, Accuracy
15188 (significant digits), Setting/Accessing, Creating numbers, Usage,
15189 Precedence, Overriding globals, Local settings, Rounding, Default values,
15190 Remarks
15191
15192 =back
15193
15194 =item INTERNALS
15195
15196 =over 4
15197
15198 =item MATH LIBRARY
15199
15200 =item SIGN
15201
15202 =item mantissa(), exponent() and parts()
15203
15204 =back
15205
15206 =item EXAMPLES
15207
15208   use Math::BigInt;
15209
15210 =item Autocreating constants
15211
15212 =item PERFORMANCE
15213
15214 =over 4
15215
15216 =item Alternative math libraries
15217
15218 =item SUBCLASSING
15219
15220 =back
15221
15222 =item Subclassing Math::BigInt
15223
15224 =item UPGRADING
15225
15226 =over 4
15227
15228 =item Auto-upgrade
15229
15230 bsqrt(), div(), blog()
15231
15232 =back
15233
15234 =item BUGS
15235
15236 Out of Memory!, Fails to load Calc on Perl prior 5.6.0
15237
15238 =item CAVEATS
15239
15240 stringify, bstr(), bsstr() and 'cmp', int(), length, bdiv, infinity
15241 handling, Modifying and =, bpow, Overloading -$x, Mixing different object
15242 types, bsqrt(), brsft()
15243
15244 =item LICENSE
15245
15246 =item SEE ALSO
15247
15248 =item AUTHORS
15249
15250 =back
15251
15252 =head2 Math::BigInt::Calc - Pure Perl module to support Math::BigInt
15253
15254 =over 4
15255
15256 =item SYNOPSIS
15257
15258 =item DESCRIPTION
15259
15260 =item EXPORT
15261
15262 =item WRAP YOUR OWN
15263
15264 =item LICENSE
15265
15266 This program is free software; you may redistribute it and/or modify it
15267 under
15268 the same terms as Perl itself.
15269
15270 =item AUTHORS
15271
15272 =item SEE ALSO
15273
15274 =back
15275
15276 =head2 Math::BigRat - arbitrarily big rationals
15277
15278 =over 4
15279
15280 =item SYNOPSIS
15281
15282 =item DESCRIPTION
15283
15284 =over 4
15285
15286 =item MATH LIBRARY
15287
15288 =back
15289
15290 =item METHODS
15291
15292 =over 4
15293
15294 =item new
15295
15296 =item numerator
15297
15298 =item denominator
15299
15300         $d = $x->denominator();
15301
15302 =item parts
15303
15304 =back
15305
15306 =item BUGS
15307
15308 =item LICENSE
15309
15310 =item SEE ALSO
15311
15312 =item AUTHORS
15313
15314 =back
15315
15316 =head2 Math::Complex - complex numbers and associated mathematical
15317 functions
15318
15319 =over 4
15320
15321 =item SYNOPSIS
15322
15323 =item DESCRIPTION
15324
15325 =item OPERATIONS
15326
15327 =item CREATION
15328
15329 =item STRINGIFICATION
15330
15331 =over 4
15332
15333 =item CHANGED IN PERL 5.6
15334
15335 =back
15336
15337 =item USAGE
15338
15339 =item ERRORS DUE TO DIVISION BY ZERO OR LOGARITHM OF ZERO
15340
15341 =item ERRORS DUE TO INDIGESTIBLE ARGUMENTS
15342
15343 =item BUGS
15344
15345 =item AUTHORS
15346
15347 =back
15348
15349 =head2 Math::Trig - trigonometric functions
15350
15351 =over 4
15352
15353 =item SYNOPSIS
15354
15355 =item DESCRIPTION
15356
15357 =item TRIGONOMETRIC FUNCTIONS
15358
15359 B<tan>
15360
15361 =over 4
15362
15363 =item ERRORS DUE TO DIVISION BY ZERO
15364
15365 =item SIMPLE (REAL) ARGUMENTS, COMPLEX RESULTS
15366
15367 =back
15368
15369 =item PLANE ANGLE CONVERSIONS
15370
15371 =item RADIAL COORDINATE CONVERSIONS
15372
15373 =over 4
15374
15375 =item COORDINATE SYSTEMS
15376
15377 =item 3-D ANGLE CONVERSIONS
15378
15379 cartesian_to_cylindrical, cartesian_to_spherical, cylindrical_to_cartesian,
15380 cylindrical_to_spherical, spherical_to_cartesian, spherical_to_cylindrical
15381
15382 =back
15383
15384 =item GREAT CIRCLE DISTANCES AND DIRECTIONS
15385
15386 =item EXAMPLES
15387
15388 =over 4
15389
15390 =item CAVEAT FOR GREAT CIRCLE FORMULAS
15391
15392 =back
15393
15394 =item BUGS
15395
15396 =item AUTHORS
15397
15398 =back
15399
15400 =head2 Memoize - Make functions faster by trading space for time
15401
15402 =over 4
15403
15404 =item SYNOPSIS
15405
15406 =item DESCRIPTION
15407
15408 =item DETAILS
15409
15410 =item OPTIONS
15411
15412 =over 4
15413
15414 =item INSTALL
15415
15416 =item NORMALIZER
15417
15418 =item C<SCALAR_CACHE>, C<LIST_CACHE>
15419
15420 C<MEMORY>, C<HASH>, C<TIE>, C<FAULT>, C<MERGE>
15421
15422 =back
15423
15424 =item OTHER FACILITIES
15425
15426 =over 4
15427
15428 =item C<unmemoize>
15429
15430 =item C<flush_cache>
15431
15432 =back
15433
15434 =item CAVEATS
15435
15436 =item PERSISTENT CACHE SUPPORT
15437
15438 =item EXPIRATION SUPPORT
15439
15440 =item BUGS
15441
15442 =item MAILING LIST
15443
15444 =item AUTHOR
15445
15446 =item COPYRIGHT AND LICENSE
15447
15448 =item THANK YOU
15449
15450 =back
15451
15452 =head2 Memoize::AnyDBM_File - glue to provide EXISTS for AnyDBM_File for
15453 Storable use
15454
15455 =over 4
15456
15457 =item DESCRIPTION
15458
15459 =back
15460
15461 =head2 Memoize::Expire - Plug-in module for automatic expiration of
15462 memoized values
15463
15464 =over 4
15465
15466 =item SYNOPSIS
15467
15468 =item DESCRIPTION
15469
15470 =item INTERFACE
15471
15472  TIEHASH,  EXISTS,  STORE
15473
15474 =item ALTERNATIVES
15475
15476 =item CAVEATS
15477
15478 =item AUTHOR
15479
15480 =item SEE ALSO
15481
15482 =back
15483
15484 =head2 Memoize::ExpireFile - test for Memoize expiration semantics
15485
15486 =over 4
15487
15488 =item DESCRIPTION
15489
15490 =back
15491
15492 =head2 Memoize::ExpireTest - test for Memoize expiration semantics
15493
15494 =over 4
15495
15496 =item DESCRIPTION
15497
15498 =back
15499
15500 =head2 Memoize::NDBM_File - glue to provide EXISTS for NDBM_File for
15501 Storable use
15502
15503 =over 4
15504
15505 =item DESCRIPTION
15506
15507 =back
15508
15509 =head2 Memoize::SDBM_File - glue to provide EXISTS for SDBM_File for
15510 Storable use
15511
15512 =over 4
15513
15514 =item DESCRIPTION
15515
15516 =back
15517
15518 =head2 Memoize::Storable - store Memoized data in Storable database
15519
15520 =over 4
15521
15522 =item DESCRIPTION
15523
15524 =back
15525
15526 =head2 NDBM_File - Tied access to ndbm files
15527
15528 =over 4
15529
15530 =item SYNOPSIS
15531
15532 =item DESCRIPTION
15533
15534 C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR>
15535
15536 =item DIAGNOSTICS
15537
15538 =over 4
15539
15540 =item C<ndbm store returned -1, errno 22, key "..." at ...>
15541
15542 =back
15543
15544 =item BUGS AND WARNINGS
15545
15546 =back
15547
15548 =head2 NEXT - Provide a pseudo-class NEXT that allows method redispatch
15549
15550 =over 4
15551
15552 =item SYNOPSIS
15553
15554 =item DESCRIPTION
15555
15556 =over 4
15557
15558 =item Enforcing redispatch
15559
15560 =item Avoiding repetitions
15561
15562 =back
15563
15564 =item AUTHOR
15565
15566 =item BUGS AND IRRITATIONS
15567
15568 =item COPYRIGHT
15569
15570 =back
15571
15572 =head2 Net::Cmd - Network Command class (as used by FTP, SMTP etc)
15573
15574 =over 4
15575
15576 =item SYNOPSIS
15577
15578 =item DESCRIPTION
15579
15580 =item USER METHODS
15581
15582 debug ( VALUE ), message (), code (), ok (), status (), datasend ( DATA ),
15583 dataend ()
15584
15585 =item CLASS METHODS
15586
15587 debug_print ( DIR, TEXT ), debug_text ( TEXT ), command ( CMD [, ARGS, ...
15588 ]), unsupported (), response (), parse_response ( TEXT ), getline (),
15589 ungetline ( TEXT ), read_until_dot (), tied_fh ()
15590
15591 =item EXPORTS
15592
15593 =item AUTHOR
15594
15595 =item COPYRIGHT
15596
15597 =back
15598
15599 =head2 Net::Config - Local configuration data for libnet
15600
15601 =over 4
15602
15603 =item SYNOPSYS
15604
15605 =item DESCRIPTION
15606
15607 =item METHODS
15608
15609 requires_firewall HOST
15610
15611 =item NetConfig VALUES
15612
15613 nntp_hosts, snpp_hosts, pop3_hosts, smtp_hosts, ph_hosts, daytime_hosts,
15614 time_hosts, inet_domain, ftp_firewall, ftp_firewall_type, ftp_ext_passive,
15615 ftp_int_pasive, local_netmask, test_hosts, test_exists
15616
15617 =back
15618
15619 =head2 Net::Domain - Attempt to evaluate the current host's internet name
15620 and domain
15621
15622 =over 4
15623
15624 =item SYNOPSIS
15625
15626 =item DESCRIPTION
15627
15628 hostfqdn (), hostname (), hostdomain ()
15629
15630 =item AUTHOR
15631
15632 =item COPYRIGHT
15633
15634 =back
15635
15636 =head2 Net::FTP - FTP Client class
15637
15638 =over 4
15639
15640 =item SYNOPSIS
15641
15642 =item DESCRIPTION
15643
15644 =item OVERVIEW
15645
15646 =item CONSTRUCTOR
15647
15648 new (HOST [,OPTIONS])
15649
15650 =item METHODS
15651
15652 login ([LOGIN [,PASSWORD [, ACCOUNT] ] ]), authorize ( [AUTH [, RESP]]),
15653 site (ARGS), type (TYPE [, ARGS]), ascii ([ARGS]) binary([ARGS])
15654 ebcdic([ARGS]) byte([ARGS]), rename ( OLDNAME, NEWNAME ), delete ( FILENAME
15655 ), cwd ( [ DIR ] ), cdup (), pwd (), restart ( WHERE ), rmdir ( DIR ),
15656 mkdir ( DIR [, RECURSE ]), ls ( [ DIR ] ), dir ( [ DIR ] ), get (
15657 REMOTE_FILE [, LOCAL_FILE [, WHERE]] ), put ( LOCAL_FILE [, REMOTE_FILE ]
15658 ), put_unique ( LOCAL_FILE [, REMOTE_FILE ] ), append ( LOCAL_FILE [,
15659 REMOTE_FILE ] ), unique_name (), mdtm ( FILE ), size ( FILE ), supported (
15660 CMD ), hash ( [FILEHANDLE_GLOB_REF],[ BYTES_PER_HASH_MARK] ), nlst ( [ DIR
15661 ] ), list ( [ DIR ] ), retr ( FILE ), stor ( FILE ), stou ( FILE ), appe (
15662 FILE ), port ( [ PORT ] ), pasv (), pasv_xfer ( SRC_FILE, DEST_SERVER [,
15663 DEST_FILE ] ), pasv_xfer_unique ( SRC_FILE, DEST_SERVER [, DEST_FILE ] ),
15664 pasv_wait ( NON_PASV_SERVER ), abort (), quit ()
15665
15666 =over 4
15667
15668 =item Methods for the adventurous
15669
15670 quot (CMD [,ARGS])
15671
15672 =back
15673
15674 =item THE dataconn CLASS
15675
15676 read ( BUFFER, SIZE [, TIMEOUT ] ), write ( BUFFER, SIZE [, TIMEOUT ] ),
15677 bytes_read (), abort (), close ()
15678
15679 =item UNIMPLEMENTED
15680
15681 B<ALLO>, B<SMNT>, B<HELP>, B<MODE>, B<SYST>, B<STAT>, B<STRU>, B<REIN>
15682
15683 =item REPORTING BUGS
15684
15685 =item AUTHOR
15686
15687 =item SEE ALSO
15688
15689 =item USE EXAMPLES
15690
15691 http://www.csh.rit.edu/~adam/Progs/autoftp-2.0.tar.gz
15692
15693 =item CREDITS
15694
15695 =item COPYRIGHT
15696
15697 =back
15698
15699 =head2 Net::NNTP - NNTP Client class
15700
15701 =over 4
15702
15703 =item SYNOPSIS
15704
15705 =item DESCRIPTION
15706
15707 =item CONSTRUCTOR
15708
15709 new ( [ HOST ] [, OPTIONS ])
15710
15711 =item METHODS
15712
15713 article ( [ MSGID|MSGNUM ], [FH] ), body ( [ MSGID|MSGNUM ], [FH] ), head (
15714 [ MSGID|MSGNUM ], [FH] ), articlefh ( [ MSGID|MSGNUM ] ), bodyfh ( [
15715 MSGID|MSGNUM ] ), headfh ( [ MSGID|MSGNUM ] ), nntpstat ( [ MSGID|MSGNUM ]
15716 ), group ( [ GROUP ] ), ihave ( MSGID [, MESSAGE ]), last (), date (),
15717 postok (), authinfo ( USER, PASS ), list (), newgroups ( SINCE [,
15718 DISTRIBUTIONS ]), newnews ( SINCE [, GROUPS [, DISTRIBUTIONS ]]), next (),
15719 post ( [ MESSAGE ] ), postfh (), slave (), quit ()
15720
15721 =over 4
15722
15723 =item Extension methods
15724
15725 newsgroups ( [ PATTERN ] ), distributions (), subscriptions (),
15726 overview_fmt (), active_times (), active ( [ PATTERN ] ), xgtitle ( PATTERN
15727 ), xhdr ( HEADER, MESSAGE-SPEC ), xover ( MESSAGE-SPEC ), xpath (
15728 MESSAGE-ID ), xpat ( HEADER, PATTERN, MESSAGE-SPEC), xrover, listgroup ( [
15729 GROUP ] ), reader
15730
15731 =back
15732
15733 =item UNSUPPORTED
15734
15735 =item DEFINITIONS
15736
15737 MESSAGE-SPEC, PATTERN, Examples, C<[^]-]>, C<*bdc>, C<[0-9a-zA-Z]>, C<a??d>
15738
15739 =item SEE ALSO
15740
15741 =item AUTHOR
15742
15743 =item COPYRIGHT
15744
15745 =back
15746
15747 =head2 Net::POP3 - Post Office Protocol 3 Client class (RFC1939)
15748
15749 =over 4
15750
15751 =item SYNOPSIS
15752
15753 =item DESCRIPTION
15754
15755 =item EXAMPLES
15756
15757 =item CONSTRUCTOR
15758
15759 new ( [ HOST, ] [ OPTIONS ] )
15760
15761 =item METHODS
15762
15763 user ( USER ), pass ( PASS ), login ( [ USER [, PASS ]] ), apop ( [ USER [,
15764 PASS ]] ), top ( MSGNUM [, NUMLINES ] ), list ( [ MSGNUM ] ), get ( MSGNUM
15765 [, FH ] ), getfh ( MSGNUM ), last (), popstat (), ping ( USER ), uidl ( [
15766 MSGNUM ] ), delete ( MSGNUM ), reset (), quit ()
15767
15768 =item NOTES
15769
15770 =item SEE ALSO
15771
15772 =item AUTHOR
15773
15774 =item COPYRIGHT
15775
15776 =back
15777
15778 =head2 Net::Ping - check a remote host for reachability
15779
15780 =over 4
15781
15782 =item SYNOPSIS
15783
15784 =item DESCRIPTION
15785
15786 =over 4
15787
15788 =item Functions
15789
15790 Net::Ping->new([$proto [, $def_timeout [, $bytes]]]);, $p->hires( { 0 | 1 }
15791 );, $p->bind($local_addr);, $p->ping($host [, $timeout]);,
15792 $p->open($host);, $p->close();, pingecho($host [, $timeout]);
15793
15794 =back
15795
15796 =item WARNING
15797
15798 =item NOTES
15799
15800 =item AUTHORS
15801
15802 =item COPYRIGHT
15803
15804 =back
15805
15806 =head2 Net::SMTP - Simple Mail Transfer Protocol Client
15807
15808 =over 4
15809
15810 =item SYNOPSIS
15811
15812 =item DESCRIPTION
15813
15814 =item EXAMPLES
15815
15816 =item CONSTRUCTOR
15817
15818 new Net::SMTP [ HOST, ] [ OPTIONS ]
15819
15820 =item METHODS
15821
15822 banner (), domain (), hello ( DOMAIN ), etrn ( DOMAIN ), auth ( USERNAME,
15823 PASSWORD ), mail ( ADDRESS [, OPTIONS] ), send ( ADDRESS ), send_or_mail (
15824 ADDRESS ), send_and_mail ( ADDRESS ), reset (), recipient ( ADDRESS [,
15825 ADDRESS [ ...]] [, OPTIONS ] ), to ( ADDRESS [, ADDRESS [...]] ), cc (
15826 ADDRESS [, ADDRESS [...]] ), bcc ( ADDRESS [, ADDRESS [...]] ), data ( [
15827 DATA ] ), expand ( ADDRESS ), verify ( ADDRESS ), help ( [ $subject ] ),
15828 quit ()
15829
15830 =item SEE ALSO
15831
15832 =item AUTHOR
15833
15834 =item COPYRIGHT
15835
15836 =back
15837
15838 =head2 Net::Time - time and daytime network client interface
15839
15840 =over 4
15841
15842 =item SYNOPSIS
15843
15844 =item DESCRIPTION
15845
15846 inet_time ( [HOST [, PROTOCOL [, TIMEOUT]]]), inet_daytime ( [HOST [,
15847 PROTOCOL [, TIMEOUT]]])
15848
15849 =item AUTHOR
15850
15851 =item COPYRIGHT
15852
15853 =back
15854
15855 =head2 Net::hostent - by-name interface to Perl's built-in gethost*()
15856 functions
15857
15858 =over 4
15859
15860 =item SYNOPSIS
15861
15862 =item DESCRIPTION
15863
15864 =item EXAMPLES
15865
15866 =item NOTE
15867
15868 =item AUTHOR
15869
15870 =back
15871
15872 =head2 Net::libnetFAQ, libnetFAQ - libnet Frequently Asked Questions
15873
15874 =over 4
15875
15876 =item DESCRIPTION
15877
15878 =over 4
15879
15880 =item Where to get this document
15881
15882 =item How to contribute to this document
15883
15884 =back
15885
15886 =item Author and Copyright Information
15887
15888 =over 4
15889
15890 =item Disclaimer
15891
15892 =back
15893
15894 =item Obtaining and installing libnet
15895
15896 =over 4
15897
15898 =item What is libnet ?
15899
15900 =item Which version of perl do I need ?
15901
15902 =item What other modules do I need ?
15903
15904 =item What machines support libnet ?
15905
15906 =item Where can I get the latest libnet release
15907
15908 =back
15909
15910 =item Using Net::FTP
15911
15912 =over 4
15913
15914 =item How do I download files from an FTP server ?
15915
15916 =item How do I transfer files in binary mode ?
15917
15918 =item How can I get the size of a file on a remote FTP server ?
15919
15920 =item How can I get the modification time of a file on a remote FTP server
15921 ?
15922
15923 =item How can I change the permissions of a file on a remote server ?
15924
15925 =item Can I do a reget operation like the ftp command ?
15926
15927 =item How do I get a directory listing from an FTP server ?
15928
15929 =item Changing directory to "" does not fail ?
15930
15931 =item I am behind a SOCKS firewall, but the Firewall option does not work ?
15932
15933 =item I am behind an FTP proxy firewall, but cannot access machines outside
15934 ?
15935
15936 =item My ftp proxy firewall does not listen on port 21
15937
15938 =item Is it possible to change the file permissions of a file on an FTP
15939 server ?
15940
15941 =item I have seen scripts call a method message, but cannot find it
15942 documented ?
15943
15944 =item Why does Net::FTP not implement mput and mget methods
15945
15946 =back
15947
15948 =item Using Net::SMTP
15949
15950 =over 4
15951
15952 =item Why can't the part of an Email address after the @ be used as the
15953 hostname ?
15954
15955 =item Why does Net::SMTP not do DNS MX lookups ?
15956
15957 =item The verify method always returns true ?
15958
15959 =back
15960
15961 =item Debugging scripts
15962
15963 =over 4
15964
15965 =item How can I debug my scripts that use Net::* modules ?
15966
15967 =back
15968
15969 =item AUTHOR AND COPYRIGHT
15970
15971 =back
15972
15973 =head2 Net::netent - by-name interface to Perl's built-in getnet*()
15974 functions
15975
15976 =over 4
15977
15978 =item SYNOPSIS
15979
15980 =item DESCRIPTION
15981
15982 =item EXAMPLES
15983
15984 =item NOTE
15985
15986 =item AUTHOR
15987
15988 =back
15989
15990 =head2 Net::protoent - by-name interface to Perl's built-in getproto*()
15991 functions
15992
15993 =over 4
15994
15995 =item SYNOPSIS
15996
15997 =item DESCRIPTION
15998
15999 =item NOTE
16000
16001 =item AUTHOR
16002
16003 =back
16004
16005 =head2 Net::servent - by-name interface to Perl's built-in getserv*()
16006 functions
16007
16008 =over 4
16009
16010 =item SYNOPSIS
16011
16012 =item DESCRIPTION
16013
16014 =item EXAMPLES
16015
16016 =item NOTE
16017
16018 =item AUTHOR
16019
16020 =back
16021
16022 =head2 Netrc, Net::Netrc - OO interface to users netrc file
16023
16024 =over 4
16025
16026 =item SYNOPSIS
16027
16028 =item DESCRIPTION
16029
16030 =item THE .netrc FILE
16031
16032 machine name, default, login name, password string, account string, macdef
16033 name
16034
16035 =item CONSTRUCTOR
16036
16037 lookup ( MACHINE [, LOGIN ])
16038
16039 =item METHODS
16040
16041 login (), password (), account (), lpa ()
16042
16043 =item AUTHOR
16044
16045 =item SEE ALSO
16046
16047 =item COPYRIGHT
16048
16049 =back
16050
16051 =head2 O - Generic interface to Perl Compiler backends
16052
16053 =over 4
16054
16055 =item SYNOPSIS
16056
16057 =item DESCRIPTION
16058
16059 =item CONVENTIONS
16060
16061 =item IMPLEMENTATION
16062
16063 =item BUGS
16064
16065 =item AUTHOR
16066
16067 =back
16068
16069 =head2 ODBM_File - Tied access to odbm files
16070
16071 =over 4
16072
16073 =item SYNOPSIS
16074
16075 =item DESCRIPTION
16076
16077 C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR>
16078
16079 =item DIAGNOSTICS
16080
16081 =over 4
16082
16083 =item C<odbm store returned -1, errno 22, key "..." at ...>
16084
16085 =back
16086
16087 =item BUGS AND WARNINGS
16088
16089 =back
16090
16091 =head2 Opcode - Disable named opcodes when compiling perl code
16092
16093 =over 4
16094
16095 =item SYNOPSIS
16096
16097 =item DESCRIPTION
16098
16099 =item NOTE
16100
16101 =item WARNING
16102
16103 =item Operator Names and Operator Lists
16104
16105 an operator name (opname), an operator tag name (optag), a negated opname
16106 or optag, an operator set (opset)
16107
16108 =item Opcode Functions
16109
16110 opcodes, opset (OP, ...), opset_to_ops (OPSET), opset_to_hex (OPSET),
16111 full_opset, empty_opset, invert_opset (OPSET), verify_opset (OPSET, ...),
16112 define_optag (OPTAG, OPSET), opmask_add (OPSET), opmask, opdesc (OP, ...),
16113 opdump (PAT)
16114
16115 =item Manipulating Opsets
16116
16117 =item TO DO (maybe)
16118
16119 =back
16120
16121 =over 4
16122
16123 =item Predefined Opcode Tags
16124
16125 :base_core, :base_mem, :base_loop, :base_io, :base_orig, :base_math,
16126 :base_thread, :default, :filesys_read, :sys_db, :browse, :filesys_open,
16127 :filesys_write, :subprocess, :ownprocess, :others, :still_to_be_decided,
16128 :dangerous
16129
16130 =item SEE ALSO
16131
16132 =item AUTHORS
16133
16134 =back
16135
16136 =head2 Opcode::Safe, Safe - Compile and execute code in restricted
16137 compartments
16138
16139 =over 4
16140
16141 =item SYNOPSIS
16142
16143 =item DESCRIPTION
16144
16145 a new namespace, an operator mask
16146
16147 =item WARNING
16148
16149 =over 4
16150
16151 =item RECENT CHANGES
16152
16153 =item Methods in class Safe
16154
16155 permit (OP, ...), permit_only (OP, ...), deny (OP, ...), deny_only (OP,
16156 ...), trap (OP, ...), untrap (OP, ...), share (NAME, ...), share_from
16157 (PACKAGE, ARRAYREF), varglob (VARNAME), reval (STRING), rdo (FILENAME),
16158 root (NAMESPACE), mask (MASK)
16159
16160 =item Some Safety Issues
16161
16162 Memory, CPU, Snooping, Signals, State Changes
16163
16164 =item AUTHOR
16165
16166 =back
16167
16168 =back
16169
16170 =head2 Opcode::ops, ops - Perl pragma to restrict unsafe operations when
16171 compiling
16172
16173 =over 4
16174
16175 =item SYNOPSIS
16176
16177 =item DESCRIPTION
16178
16179 =item SEE ALSO
16180
16181 =back
16182
16183 =head2 POSIX - Perl interface to IEEE Std 1003.1
16184
16185 =over 4
16186
16187 =item SYNOPSIS
16188
16189 =item DESCRIPTION
16190
16191 =item NOTE
16192
16193 =item CAVEATS
16194
16195 =item FUNCTIONS
16196
16197 _exit, abort, abs, access, acos, alarm, asctime, asin, assert, atan, atan2,
16198 atexit, atof, atoi, atol, bsearch, calloc, ceil, chdir, chmod, chown,
16199 clearerr, clock, close, closedir, cos, cosh, creat, ctermid, ctime,
16200 cuserid, difftime, div, dup, dup2, errno, execl, execle, execlp, execv,
16201 execve, execvp, exit, exp, fabs, fclose, fcntl, fdopen, feof, ferror,
16202 fflush, fgetc, fgetpos, fgets, fileno, floor, fmod, fopen, fork, fpathconf,
16203 fprintf, fputc, fputs, fread, free, freopen, frexp, fscanf, fseek, fsetpos,
16204 fstat, ftell, fwrite, getc, getchar, getcwd, getegid, getenv, geteuid,
16205 getgid, getgrgid, getgrnam, getgroups, getlogin, getpgrp, getpid, getppid,
16206 getpwnam, getpwuid, gets, getuid, gmtime, isalnum, isalpha, isatty,
16207 iscntrl, isdigit, isgraph, islower, isprint, ispunct, isspace, isupper,
16208 isxdigit, kill, labs, ldexp, ldiv, link, localeconv, localtime, log, log10,
16209 longjmp, lseek, malloc, mblen, mbstowcs, mbtowc, memchr, memcmp, memcpy,
16210 memmove, memset, mkdir, mkfifo, mktime, modf, nice, offsetof, open,
16211 opendir, pathconf, pause, perror, pipe, pow, printf, putc, putchar, puts,
16212 qsort, raise, rand, read, readdir, realloc, remove, rename, rewind,
16213 rewinddir, rmdir, scanf, setgid, setjmp, setlocale, setpgid, setsid,
16214 setuid, sigaction, siglongjmp, sigpending, sigprocmask, sigsetjmp,
16215 sigsuspend, sin, sinh, sleep, sprintf, sqrt, srand, sscanf, stat, strcat,
16216 strchr, strcmp, strcoll, strcpy, strcspn, strerror, strftime, strlen,
16217 strncat, strncmp, strncpy, strpbrk, strrchr, strspn, strstr, strtod,
16218 strtok, strtol, strtoul, strxfrm, sysconf, system, tan, tanh, tcdrain,
16219 tcflow, tcflush, tcgetpgrp, tcsendbreak, tcsetpgrp, time, times, tmpfile,
16220 tmpnam, tolower, toupper, ttyname, tzname, tzset, umask, uname, ungetc,
16221 unlink, utime, vfprintf, vprintf, vsprintf, wait, waitpid, wcstombs,
16222 wctomb, write
16223
16224 =item CLASSES
16225
16226 =over 4
16227
16228 =item POSIX::SigAction
16229
16230 new
16231
16232 =item POSIX::SigSet
16233
16234 new, addset, delset, emptyset, fillset, ismember
16235
16236 =item POSIX::Termios
16237
16238 new, getattr, getcc, getcflag, getiflag, getispeed, getlflag, getoflag,
16239 getospeed, setattr, setcc, setcflag, setiflag, setispeed, setlflag,
16240 setoflag, setospeed, Baud rate values, Terminal interface values, c_cc
16241 field values, c_cflag field values, c_iflag field values, c_lflag field
16242 values, c_oflag field values
16243
16244 =back
16245
16246 =item PATHNAME CONSTANTS
16247
16248 Constants
16249
16250 =item POSIX CONSTANTS
16251
16252 Constants
16253
16254 =item SYSTEM CONFIGURATION
16255
16256 Constants
16257
16258 =item ERRNO
16259
16260 Constants
16261
16262 =item FCNTL
16263
16264 Constants
16265
16266 =item FLOAT
16267
16268 Constants
16269
16270 =item LIMITS
16271
16272 Constants
16273
16274 =item LOCALE
16275
16276 Constants
16277
16278 =item MATH
16279
16280 Constants
16281
16282 =item SIGNAL
16283
16284 Constants
16285
16286 =item STAT
16287
16288 Constants, Macros
16289
16290 =item STDLIB
16291
16292 Constants
16293
16294 =item STDIO
16295
16296 Constants
16297
16298 =item TIME
16299
16300 Constants
16301
16302 =item UNISTD
16303
16304 Constants
16305
16306 =item WAIT
16307
16308 Constants, WNOHANG, WUNTRACED, Macros, WIFEXITED, WEXITSTATUS, WIFSIGNALED,
16309 WTERMSIG, WIFSTOPPED, WSTOPSIG
16310
16311 =back
16312
16313 =head2 PerlIO - On demand loader for PerlIO layers and root of PerlIO::*
16314 name space
16315
16316 =over 4
16317
16318 =item SYNOPSIS
16319
16320 =item DESCRIPTION
16321
16322 unix, stdio, perlio, crlf, utf8, bytes, raw
16323
16324 =over 4
16325
16326 =item Defaults and how to override them
16327
16328 =back
16329
16330 =item AUTHOR
16331
16332 =item SEE ALSO
16333
16334 =back
16335
16336 =head2 PerlIO::Scalar - support module for in-memory IO.
16337
16338 =over 4
16339
16340 =item SYNOPSIS
16341
16342 =item DESCRIPTION
16343
16344 =back
16345
16346 =head2 PerlIO::Via - Helper class for PerlIO layers implemented in perl
16347
16348 =over 4
16349
16350 =item SYNOPSIS
16351
16352 =item DESCRIPTION
16353
16354 $class->PUSHED([$mode[,$fh]]), $obj->POPPED([$fh]),
16355 $class->OPEN($path,$mode[,$fh]), $class->FDOPEN($fd),
16356 $class->SYSOPEN($path,$imode,$perm,$fh), $obj->FILENO($fh),
16357 $obj->READ($buffer,$len,$fh), $obj->WRITE($buffer,$fh), $obj->FILL($fh),
16358 $obj->CLOSE($fh), $obj->SEEK($posn,$whence,$fh), $obj->TELL($fh),
16359 $obj->UNREAD($buffer,$fh), $obj->FLUSH($fh), $obj->SETLINEBUF($fh),
16360 $obj->CLEARERR($fh), $obj->ERROR($fh), $obj->EOF($fh)
16361
16362 =over 4
16363
16364 =item Example - a Hexadecimal Handle
16365
16366 =back
16367
16368 =back
16369
16370 =head2 PerlIO::encoding - encoding layer
16371
16372 =over 4
16373
16374 =item SYNOPSIS
16375
16376 =item DESCRIPTION
16377
16378 =item SEE ALSO
16379
16380 =back
16381
16382 =head2 Pod::Checker, podchecker() - check pod documents for syntax errors
16383
16384 =over 4
16385
16386 =item SYNOPSIS
16387
16388 =item OPTIONS/ARGUMENTS
16389
16390 =over 4
16391
16392 =item podchecker()
16393
16394 B<-warnings> =E<gt> I<val>
16395
16396 =back
16397
16398 =item DESCRIPTION
16399
16400 =item DIAGNOSTICS
16401
16402 =over 4
16403
16404 =item Errors
16405
16406 empty =headn, =over on line I<N> without closing =back, =item without
16407 previous =over, =back without previous =over, No argument for =begin, =end
16408 without =begin, Nested =begin's, =for without formatter specification,
16409 unresolved internal link I<NAME>, Unknown command "I<CMD>", Unknown
16410 interior-sequence "I<SEQ>", nested commands
16411 I<CMD>E<lt>...I<CMD>E<lt>...E<gt>...E<gt>, garbled entity I<STRING>, Entity
16412 number out of range, malformed link LE<lt>E<gt>, nonempty ZE<lt>E<gt>,
16413 empty XE<lt>E<gt>, Spurious text after =pod / =cut, Spurious character(s)
16414 after =back
16415
16416 =item Warnings
16417
16418 multiple occurence of link target I<name>, line containing nothing but
16419 whitespace in paragraph, file does not start with =head, previous =item has
16420 no contents, preceding non-item paragraph(s), =item type mismatch (I<one>
16421 vs. I<two>), I<N> unescaped C<E<lt>E<gt>> in paragraph, Unknown entity, No
16422 items in =over, No argument for =item, empty section in previous paragraph,
16423 Verbatim paragraph in NAME section
16424
16425 =item Hyperlinks
16426
16427 ignoring leading/trailing whitespace in link, (section) in '$page'
16428 deprecated, alternative text/node '%s' contains non-escaped | or /
16429
16430 =back
16431
16432 =item RETURN VALUE
16433
16434 =item EXAMPLES
16435
16436 =item INTERFACE
16437
16438 =back
16439
16440 C<Pod::Checker-E<gt>new( %options )>
16441
16442 C<$checker-E<gt>poderror( @args )>, C<$checker-E<gt>poderror( {%opts},
16443 @args )>
16444
16445 C<$checker-E<gt>num_errors()>
16446
16447 C<$checker-E<gt>name()>
16448
16449 C<$checker-E<gt>node()>
16450
16451 C<$checker-E<gt>idx()>
16452
16453 C<$checker-E<gt>hyperlink()>
16454
16455 =over 4
16456
16457 =item AUTHOR
16458
16459 =back
16460
16461 =head2 Pod::Find - find POD documents in directory trees
16462
16463 =over 4
16464
16465 =item SYNOPSIS
16466
16467 =item DESCRIPTION
16468
16469 =back
16470
16471 =over 4
16472
16473 =item C<pod_find( { %opts } , @directories )>
16474
16475 C<-verbose =E<gt> 1>, C<-perl =E<gt> 1>, C<-script =E<gt> 1>, C<-inc =E<gt>
16476 1>
16477
16478 =back
16479
16480 =over 4
16481
16482 =item C<simplify_name( $str )>
16483
16484 =back
16485
16486 =over 4
16487
16488 =item C<pod_where( { %opts }, $pod )>
16489
16490 C<-inc =E<gt> 1>, C<-dirs =E<gt> [ $dir1, $dir2, ... ]>, C<-verbose =E<gt>
16491 1>
16492
16493 =back
16494
16495 =over 4
16496
16497 =item C<contains_pod( $file , $verbose )>
16498
16499 =back
16500
16501 =over 4
16502
16503 =item AUTHOR
16504
16505 =item SEE ALSO
16506
16507 =back
16508
16509 =head2 Pod::Html - module to convert pod files to HTML
16510
16511 =over 4
16512
16513 =item SYNOPSIS
16514
16515 =item DESCRIPTION
16516
16517 =item ARGUMENTS
16518
16519 backlink, cachedir, css, flush, header, help, htmldir, htmlroot, index,
16520 infile, libpods, netscape, outfile, podpath, podroot, quiet, recurse,
16521 title, verbose
16522
16523 =item EXAMPLE
16524
16525 =item ENVIRONMENT
16526
16527 =item AUTHOR
16528
16529 =item SEE ALSO
16530
16531 =item COPYRIGHT
16532
16533 =back
16534
16535 =head2 Pod::InputObjects - objects representing POD input paragraphs,
16536 commands, etc.
16537
16538 =over 4
16539
16540 =item SYNOPSIS
16541
16542 =item REQUIRES
16543
16544 =item EXPORTS
16545
16546 =item DESCRIPTION
16547
16548 package B<Pod::InputSource>, package B<Pod::Paragraph>, package
16549 B<Pod::InteriorSequence>, package B<Pod::ParseTree>
16550
16551 =back
16552
16553 =over 4
16554
16555 =item B<Pod::InputSource>
16556
16557 =back
16558
16559 =over 4
16560
16561 =item B<new()>
16562
16563 =back
16564
16565 =over 4
16566
16567 =item B<name()>
16568
16569 =back
16570
16571 =over 4
16572
16573 =item B<handle()>
16574
16575 =back
16576
16577 =over 4
16578
16579 =item B<was_cutting()>
16580
16581 =back
16582
16583 =over 4
16584
16585 =item B<Pod::Paragraph>
16586
16587 =back
16588
16589 =over 4
16590
16591 =item Pod::Paragraph-E<gt>B<new()>
16592
16593 =back
16594
16595 =over 4
16596
16597 =item $pod_para-E<gt>B<cmd_name()>
16598
16599 =back
16600
16601 =over 4
16602
16603 =item $pod_para-E<gt>B<text()>
16604
16605 =back
16606
16607 =over 4
16608
16609 =item $pod_para-E<gt>B<raw_text()>
16610
16611 =back
16612
16613 =over 4
16614
16615 =item $pod_para-E<gt>B<cmd_prefix()>
16616
16617 =back
16618
16619 =over 4
16620
16621 =item $pod_para-E<gt>B<cmd_separator()>
16622
16623 =back
16624
16625 =over 4
16626
16627 =item $pod_para-E<gt>B<parse_tree()>
16628
16629 =back
16630
16631 =over 4
16632
16633 =item $pod_para-E<gt>B<file_line()>
16634
16635 =back
16636
16637 =over 4
16638
16639 =item B<Pod::InteriorSequence>
16640
16641 =back
16642
16643 =over 4
16644
16645 =item Pod::InteriorSequence-E<gt>B<new()>
16646
16647 =back
16648
16649 =over 4
16650
16651 =item $pod_seq-E<gt>B<cmd_name()>
16652
16653 =back
16654
16655 =over 4
16656
16657 =item $pod_seq-E<gt>B<prepend()>
16658
16659 =back
16660
16661 =over 4
16662
16663 =item $pod_seq-E<gt>B<append()>
16664
16665 =back
16666
16667 =over 4
16668
16669 =item $pod_seq-E<gt>B<nested()>
16670
16671 =back
16672
16673 =over 4
16674
16675 =item $pod_seq-E<gt>B<raw_text()>
16676
16677 =back
16678
16679 =over 4
16680
16681 =item $pod_seq-E<gt>B<left_delimiter()>
16682
16683 =back
16684
16685 =over 4
16686
16687 =item $pod_seq-E<gt>B<right_delimiter()>
16688
16689 =back
16690
16691 =over 4
16692
16693 =item $pod_seq-E<gt>B<parse_tree()>
16694
16695 =back
16696
16697 =over 4
16698
16699 =item $pod_seq-E<gt>B<file_line()>
16700
16701 =back
16702
16703 =over 4
16704
16705 =item Pod::InteriorSequence::B<DESTROY()>
16706
16707 =back
16708
16709 =over 4
16710
16711 =item B<Pod::ParseTree>
16712
16713 =back
16714
16715 =over 4
16716
16717 =item Pod::ParseTree-E<gt>B<new()>
16718
16719 =back
16720
16721 =over 4
16722
16723 =item $ptree-E<gt>B<top()>
16724
16725 =back
16726
16727 =over 4
16728
16729 =item $ptree-E<gt>B<children()>
16730
16731 =back
16732
16733 =over 4
16734
16735 =item $ptree-E<gt>B<prepend()>
16736
16737 =back
16738
16739 =over 4
16740
16741 =item $ptree-E<gt>B<append()>
16742
16743 =back
16744
16745 =over 4
16746
16747 =item $ptree-E<gt>B<raw_text()>
16748
16749 =back
16750
16751 =over 4
16752
16753 =item Pod::ParseTree::B<DESTROY()>
16754
16755 =back
16756
16757 =over 4
16758
16759 =item SEE ALSO
16760
16761 =item AUTHOR
16762
16763 =back
16764
16765 =head2 Pod::LaTeX - Convert Pod data to formatted Latex
16766
16767 =over 4
16768
16769 =item SYNOPSIS
16770
16771 =item DESCRIPTION
16772
16773 =back
16774
16775 =over 4
16776
16777 =item OBJECT METHODS
16778
16779 C<initialize>
16780
16781 =back
16782
16783 =over 4
16784
16785 =item Data Accessors
16786
16787 B<AddPreamble>
16788
16789 =back
16790
16791 B<AddPostamble>
16792
16793 B<Head1Level>
16794
16795 B<Label>
16796
16797 B<LevelNoNum>
16798
16799 B<MakeIndex>
16800
16801 B<ReplaceNAMEwithSection>
16802
16803 B<StartWithNewPage>
16804
16805 B<TableOfContents>
16806
16807 B<UniqueLabels>
16808
16809 B<UserPreamble>
16810
16811 B<UserPostamble>
16812
16813 B<Lists>
16814
16815 =over 4
16816
16817 =item Subclassed methods
16818
16819 =back
16820
16821 B<begin_pod>
16822
16823 B<end_pod>
16824
16825 B<command>
16826
16827 B<verbatim>
16828
16829 B<textblock>
16830
16831 B<interior_sequence>
16832
16833 =over 4
16834
16835 =item List Methods
16836
16837 B<begin_list>
16838
16839 =back
16840
16841 B<end_list>
16842
16843 B<add_item>
16844
16845 =over 4
16846
16847 =item Methods for headings
16848
16849 B<head>
16850
16851 =back
16852
16853 =over 4
16854
16855 =item Internal methods
16856
16857 B<_output>
16858
16859 =back
16860
16861 B<_replace_special_chars>
16862
16863 B<_replace_special_chars_late>
16864
16865 B<_create_label>
16866
16867 B<_create_index>
16868
16869 B<_clean_latex_commands>
16870
16871 B<_split_delimited>
16872
16873 =over 4
16874
16875 =item NOTES
16876
16877 =item SEE ALSO
16878
16879 =item AUTHORS
16880
16881 =item COPYRIGHT
16882
16883 =item REVISION
16884
16885 =back
16886
16887 =head2 Pod::Man - Convert POD data to formatted *roff input
16888
16889 =over 4
16890
16891 =item SYNOPSIS
16892
16893 =item DESCRIPTION
16894
16895 center, date, fixed, fixedbold, fixeditalic, fixedbolditalic, name, quotes,
16896 release, section
16897
16898 =item DIAGNOSTICS
16899
16900 roff font should be 1 or 2 chars, not "%s", Invalid link %s, Invalid quote
16901 specification "%s", %s:%d: Unknown command paragraph "%s", %s:%d: Unknown
16902 escape EE<lt>%sE<gt>, %s:%d: Unknown formatting code %s, %s:%d: Unmatched
16903 =back
16904
16905 =item BUGS
16906
16907 =item CAVEATS
16908
16909 =item SEE ALSO
16910
16911 =item AUTHOR
16912
16913 =item COPYRIGHT AND LICENSE
16914
16915 =back
16916
16917 =head2 Pod::ParseLink -- Parse an LE<lt>E<gt> formatting code in POD text
16918
16919 =over 4
16920
16921 =item SYNOPSIS
16922
16923 =item DESCRIPTION
16924
16925 =item AUTHOR
16926
16927 =item COPYRIGHT AND LICENSE
16928
16929 =back
16930
16931 =head2 Pod::ParseUtils - helpers for POD parsing and conversion
16932
16933 =over 4
16934
16935 =item SYNOPSIS
16936
16937 =item DESCRIPTION
16938
16939 =back
16940
16941 =over 4
16942
16943 =item Pod::List
16944
16945 Pod::List-E<gt>new()
16946
16947 =back
16948
16949 $list-E<gt>file()
16950
16951 $list-E<gt>start()
16952
16953 $list-E<gt>indent()
16954
16955 $list-E<gt>type()
16956
16957 $list-E<gt>rx()
16958
16959 $list-E<gt>item()
16960
16961 $list-E<gt>parent()
16962
16963 $list-E<gt>tag()
16964
16965 =over 4
16966
16967 =item Pod::Hyperlink
16968
16969 Pod::Hyperlink-E<gt>new()
16970
16971 =back
16972
16973 $link-E<gt>parse($string)
16974
16975 $link-E<gt>markup($string)
16976
16977 $link-E<gt>text()
16978
16979 $link-E<gt>warning()
16980
16981 $link-E<gt>file(), $link-E<gt>line()
16982
16983 $link-E<gt>page()
16984
16985 $link-E<gt>node()
16986
16987 $link-E<gt>alttext()
16988
16989 $link-E<gt>type()
16990
16991 $link-E<gt>link()
16992
16993 =over 4
16994
16995 =item Pod::Cache
16996
16997 Pod::Cache-E<gt>new()
16998
16999 =back
17000
17001 $cache-E<gt>item()
17002
17003 $cache-E<gt>find_page($name)
17004
17005 =over 4
17006
17007 =item Pod::Cache::Item
17008
17009 Pod::Cache::Item-E<gt>new()
17010
17011 =back
17012
17013 $cacheitem-E<gt>page()
17014
17015 $cacheitem-E<gt>description()
17016
17017 $cacheitem-E<gt>path()
17018
17019 $cacheitem-E<gt>file()
17020
17021 $cacheitem-E<gt>nodes()
17022
17023 $cacheitem-E<gt>find_node($name)
17024
17025 $cacheitem-E<gt>idx()
17026
17027 =over 4
17028
17029 =item AUTHOR
17030
17031 =item SEE ALSO
17032
17033 =back
17034
17035 =head2 Pod::Parser - base class for creating POD filters and translators
17036
17037 =over 4
17038
17039 =item SYNOPSIS
17040
17041 =item REQUIRES
17042
17043 =item EXPORTS
17044
17045 =item DESCRIPTION
17046
17047 =item QUICK OVERVIEW
17048
17049 =item PARSING OPTIONS
17050
17051 B<-want_nonPODs> (default: unset), B<-process_cut_cmd> (default: unset),
17052 B<-warnings> (default: unset)
17053
17054 =back
17055
17056 =over 4
17057
17058 =item RECOMMENDED SUBROUTINE/METHOD OVERRIDES
17059
17060 =back
17061
17062 =over 4
17063
17064 =item B<command()>
17065
17066 C<$cmd>, C<$text>, C<$line_num>, C<$pod_para>
17067
17068 =back
17069
17070 =over 4
17071
17072 =item B<verbatim()>
17073
17074 C<$text>, C<$line_num>, C<$pod_para>
17075
17076 =back
17077
17078 =over 4
17079
17080 =item B<textblock()>
17081
17082 C<$text>, C<$line_num>, C<$pod_para>
17083
17084 =back
17085
17086 =over 4
17087
17088 =item B<interior_sequence()>
17089
17090 =back
17091
17092 =over 4
17093
17094 =item OPTIONAL SUBROUTINE/METHOD OVERRIDES
17095
17096 =back
17097
17098 =over 4
17099
17100 =item B<new()>
17101
17102 =back
17103
17104 =over 4
17105
17106 =item B<initialize()>
17107
17108 =back
17109
17110 =over 4
17111
17112 =item B<begin_pod()>
17113
17114 =back
17115
17116 =over 4
17117
17118 =item B<begin_input()>
17119
17120 =back
17121
17122 =over 4
17123
17124 =item B<end_input()>
17125
17126 =back
17127
17128 =over 4
17129
17130 =item B<end_pod()>
17131
17132 =back
17133
17134 =over 4
17135
17136 =item B<preprocess_line()>
17137
17138 =back
17139
17140 =over 4
17141
17142 =item B<preprocess_paragraph()>
17143
17144 =back
17145
17146 =over 4
17147
17148 =item METHODS FOR PARSING AND PROCESSING
17149
17150 =back
17151
17152 =over 4
17153
17154 =item B<parse_text()>
17155
17156 B<-expand_seq> =E<gt> I<code-ref>|I<method-name>, B<-expand_text> =E<gt>
17157 I<code-ref>|I<method-name>, B<-expand_ptree> =E<gt>
17158 I<code-ref>|I<method-name>
17159
17160 =back
17161
17162 =over 4
17163
17164 =item B<interpolate()>
17165
17166 =back
17167
17168 =over 4
17169
17170 =item B<parse_paragraph()>
17171
17172 =back
17173
17174 =over 4
17175
17176 =item B<parse_from_filehandle()>
17177
17178 =back
17179
17180 =over 4
17181
17182 =item B<parse_from_file()>
17183
17184 =back
17185
17186 =over 4
17187
17188 =item ACCESSOR METHODS
17189
17190 =back
17191
17192 =over 4
17193
17194 =item B<errorsub()>
17195
17196 =back
17197
17198 =over 4
17199
17200 =item B<cutting()>
17201
17202 =back
17203
17204 =over 4
17205
17206 =item B<parseopts()>
17207
17208 =back
17209
17210 =over 4
17211
17212 =item B<output_file()>
17213
17214 =back
17215
17216 =over 4
17217
17218 =item B<output_handle()>
17219
17220 =back
17221
17222 =over 4
17223
17224 =item B<input_file()>
17225
17226 =back
17227
17228 =over 4
17229
17230 =item B<input_handle()>
17231
17232 =back
17233
17234 =over 4
17235
17236 =item B<input_streams()>
17237
17238 =back
17239
17240 =over 4
17241
17242 =item B<top_stream()>
17243
17244 =back
17245
17246 =over 4
17247
17248 =item PRIVATE METHODS AND DATA
17249
17250 =back
17251
17252 =over 4
17253
17254 =item B<_push_input_stream()>
17255
17256 =back
17257
17258 =over 4
17259
17260 =item B<_pop_input_stream()>
17261
17262 =back
17263
17264 =over 4
17265
17266 =item TREE-BASED PARSING
17267
17268 =item SEE ALSO
17269
17270 =item AUTHOR
17271
17272 =back
17273
17274 =head2 Pod::Plainer - Perl extension for converting Pod to old style Pod.
17275
17276 =over 4
17277
17278 =item SYNOPSIS
17279
17280 =item DESCRIPTION
17281
17282 =over 4
17283
17284 =item EXPORT
17285
17286 =back
17287
17288 =item AUTHOR
17289
17290 =item SEE ALSO
17291
17292 =back
17293
17294 =head2 Pod::Select, podselect() - extract selected sections of POD from
17295 input
17296
17297 =over 4
17298
17299 =item SYNOPSIS
17300
17301 =item REQUIRES
17302
17303 =item EXPORTS
17304
17305 =item DESCRIPTION
17306
17307 =item SECTION SPECIFICATIONS
17308
17309 =item RANGE SPECIFICATIONS
17310
17311 =back
17312
17313 =over 4
17314
17315 =item OBJECT METHODS
17316
17317 =back
17318
17319 =over 4
17320
17321 =item B<curr_headings()>
17322
17323 =back
17324
17325 =over 4
17326
17327 =item B<select()>
17328
17329 =back
17330
17331 =over 4
17332
17333 =item B<add_selection()>
17334
17335 =back
17336
17337 =over 4
17338
17339 =item B<clear_selections()>
17340
17341 =back
17342
17343 =over 4
17344
17345 =item B<match_section()>
17346
17347 =back
17348
17349 =over 4
17350
17351 =item B<is_selected()>
17352
17353 =back
17354
17355 =over 4
17356
17357 =item EXPORTED FUNCTIONS
17358
17359 =back
17360
17361 =over 4
17362
17363 =item B<podselect()>
17364
17365 B<-output>, B<-sections>, B<-ranges>
17366
17367 =back
17368
17369 =over 4
17370
17371 =item PRIVATE METHODS AND DATA
17372
17373 =back
17374
17375 =over 4
17376
17377 =item B<_compile_section_spec()>
17378
17379 =back
17380
17381 =over 4
17382
17383 =item $self->{_SECTION_HEADINGS}
17384
17385 =back
17386
17387 =over 4
17388
17389 =item $self->{_SELECTED_SECTIONS}
17390
17391 =back
17392
17393 =over 4
17394
17395 =item SEE ALSO
17396
17397 =item AUTHOR
17398
17399 =back
17400
17401 =head2 Pod::Text - Convert POD data to formatted ASCII text
17402
17403 =over 4
17404
17405 =item SYNOPSIS
17406
17407 =item DESCRIPTION
17408
17409 alt, code, indent, loose, quotes, sentence, width
17410
17411 =item DIAGNOSTICS
17412
17413 Bizarre space in item, Item called without tag, Can't open %s for reading:
17414 %s, Invalid quote specification "%s", %s:%d: Unknown command paragraph: %s,
17415 %s:%d: Unknown escape: %s, %s:%d: Unknown formatting code: %s, %s:%d:
17416 Unmatched =back
17417
17418 =item RESTRICTIONS
17419
17420 =item NOTES
17421
17422 =item SEE ALSO
17423
17424 =item AUTHOR
17425
17426 =item COPYRIGHT AND LICENSE
17427
17428 =back
17429
17430 =head2 Pod::Text::Color - Convert POD data to formatted color ASCII text
17431
17432 =over 4
17433
17434 =item SYNOPSIS
17435
17436 =item DESCRIPTION
17437
17438 =item BUGS
17439
17440 =item SEE ALSO
17441
17442 =item AUTHOR
17443
17444 =item COPYRIGHT AND LICENSE
17445
17446 =back
17447
17448 =head2 Pod::Text::Overstrike - Convert POD data to formatted overstrike
17449 text
17450
17451 =over 4
17452
17453 =item SYNOPSIS
17454
17455 =item DESCRIPTION
17456
17457 =item BUGS
17458
17459 =item SEE ALSO
17460
17461 =item AUTHOR
17462
17463 =item COPYRIGHT AND LICENSE
17464
17465 =back
17466
17467 =head2 Pod::Text::Termcap, Pod::Text::Color - Convert POD data to ASCII
17468 text with format escapes
17469
17470 =over 4
17471
17472 =item SYNOPSIS
17473
17474 =item DESCRIPTION
17475
17476 =item NOTES
17477
17478 =item SEE ALSO
17479
17480 =item AUTHOR
17481
17482 =item COPYRIGHT AND LICENSE
17483
17484 =back
17485
17486 =head2 Pod::Usage, pod2usage() - print a usage message from embedded pod
17487 documentation
17488
17489 =over 4
17490
17491 =item SYNOPSIS
17492
17493 =item ARGUMENTS
17494
17495 C<-message>, C<-msg>, C<-exitval>, C<-verbose>, C<-output>, C<-input>,
17496 C<-pathlist>
17497
17498 =item DESCRIPTION
17499
17500 =item EXAMPLES
17501
17502 =over 4
17503
17504 =item Recommended Use
17505
17506 =back
17507
17508 =item CAVEATS
17509
17510 =item AUTHOR
17511
17512 =item ACKNOWLEDGEMENTS
17513
17514 =back
17515
17516 =head2 Pod::t::basic, basic.pod - Test of various basic POD features in
17517 translators.
17518
17519 =over 4
17520
17521 =item HEADINGS
17522
17523 =item This C<is> a "level 1" heading
17524
17525 =over 4
17526
17527 =item ``Level'' "2 I<heading>
17528
17529 =back
17530
17531 =item This C<is> a "level 1" heading
17532
17533 =over 4
17534
17535 =item ``Level'' 2 I<heading>
17536
17537 =back
17538
17539 =item LINKS
17540
17541 =item OVER AND ITEMS
17542
17543 This  is a test, a, b, a, b, c, d, "foo", B<bar>, C<baz>, Some longer item
17544 text
17545
17546 =item FORMATTING CODES
17547
17548 E<amp>, E<apos>, E<lt>, E<gt>, E<quot>, E<sol>
17549
17550 =item VERBATIM
17551
17552 =item CONCLUSION
17553
17554 =back
17555
17556 =head2 Pod::t::htmlescp, Escape Sequences Test
17557
17558 =over 4
17559
17560 =item DESCRIPTION
17561
17562 =back
17563
17564 =head2 Pod::t::htmlview, Test HTML Rendering
17565
17566 =over 4
17567
17568 =item SYNOPSIS
17569
17570 =item DESCRIPTION
17571
17572 =item METHODS =E<gt> OTHER STUFF
17573
17574 =over 4
17575
17576 =item new()
17577
17578 foo, bar, baz, C<Black> Cat, Sat S<I<on> the>, MatE<lt>!E<gt>, 1 Cat, 2
17579 Sat, 3 Mat
17580
17581 =item old()
17582
17583 =back
17584
17585 =item TESTING FOR AND BEGIN
17586
17587 =item TESTING URLs hyperlinking
17588
17589 =item SEE ALSO
17590
17591 =back
17592
17593 =head2 SDBM_File - Tied access to sdbm files
17594
17595 =over 4
17596
17597 =item SYNOPSIS
17598
17599 =item DESCRIPTION
17600
17601 C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR>
17602
17603 =item DIAGNOSTICS
17604
17605 =over 4
17606
17607 =item C<sdbm store returned -1, errno 22, key "..." at ...>
17608
17609 =back
17610
17611 =item BUGS AND WARNINGS
17612
17613 =back
17614
17615 =head2 Safe - Compile and execute code in restricted compartments
17616
17617 =over 4
17618
17619 =item SYNOPSIS
17620
17621 =item DESCRIPTION
17622
17623 a new namespace, an operator mask
17624
17625 =item WARNING
17626
17627 =over 4
17628
17629 =item RECENT CHANGES
17630
17631 =item Methods in class Safe
17632
17633 permit (OP, ...), permit_only (OP, ...), deny (OP, ...), deny_only (OP,
17634 ...), trap (OP, ...), untrap (OP, ...), share (NAME, ...), share_from
17635 (PACKAGE, ARRAYREF), varglob (VARNAME), reval (STRING), rdo (FILENAME),
17636 root (NAMESPACE), mask (MASK)
17637
17638 =item Some Safety Issues
17639
17640 Memory, CPU, Snooping, Signals, State Changes
17641
17642 =item AUTHOR
17643
17644 =back
17645
17646 =back
17647
17648 =head2 Scalar::Util - A selection of general-utility scalar subroutines
17649
17650 =over 4
17651
17652 =item SYNOPSIS
17653
17654 =item DESCRIPTION
17655
17656 blessed EXPR, dualvar NUM, STRING, isweak EXPR, openhandle FH, reftype
17657 EXPR, tainted EXPR, weaken REF
17658
17659 =item KNOWN BUGS
17660
17661 =item COPYRIGHT
17662
17663 =item BLATANT PLUG
17664
17665 =back
17666
17667 =head2 Search::Dict, look - search for key in dictionary file
17668
17669 =over 4
17670
17671 =item SYNOPSIS
17672
17673 =item DESCRIPTION
17674
17675 =back
17676
17677 =head2 SelectSaver - save and restore selected file handle
17678
17679 =over 4
17680
17681 =item SYNOPSIS
17682
17683 =item DESCRIPTION
17684
17685 =back
17686
17687 =head2 SelfLoader - load functions only on demand
17688
17689 =over 4
17690
17691 =item SYNOPSIS
17692
17693 =item DESCRIPTION
17694
17695 =over 4
17696
17697 =item The __DATA__ token
17698
17699 =item SelfLoader autoloading
17700
17701 =item Autoloading and package lexicals
17702
17703 =item SelfLoader and AutoLoader
17704
17705 =item __DATA__, __END__, and the FOOBAR::DATA filehandle.
17706
17707 =item Classes and inherited methods.
17708
17709 =back
17710
17711 =item Multiple packages and fully qualified subroutine names
17712
17713 =back
17714
17715 =head2 Shell - run shell commands transparently within perl
17716
17717 =over 4
17718
17719 =item SYNOPSIS
17720
17721 =item DESCRIPTION
17722
17723 =over 4
17724
17725 =item OBJECT ORIENTED SYNTAX
17726
17727 =back
17728
17729 =item AUTHOR
17730
17731 =back
17732
17733 =head2 Socket, sockaddr_in, sockaddr_un, inet_aton, inet_ntoa - load the C
17734 socket.h defines and structure manipulators
17735
17736 =over 4
17737
17738 =item SYNOPSIS
17739
17740 =item DESCRIPTION
17741
17742 inet_aton HOSTNAME, inet_ntoa IP_ADDRESS, INADDR_ANY, INADDR_BROADCAST,
17743 INADDR_LOOPBACK, INADDR_NONE, sockaddr_family SOCKADDR, sockaddr_in PORT,
17744 ADDRESS, sockaddr_in SOCKADDR_IN, pack_sockaddr_in PORT, IP_ADDRESS,
17745 unpack_sockaddr_in SOCKADDR_IN, sockaddr_un PATHNAME, sockaddr_un
17746 SOCKADDR_UN, pack_sockaddr_un PATH, unpack_sockaddr_un SOCKADDR_UN
17747
17748 =back
17749
17750 =head2 Storable - persistence for Perl data structures
17751
17752 =over 4
17753
17754 =item SYNOPSIS
17755
17756 =item DESCRIPTION
17757
17758 =item MEMORY STORE
17759
17760 =item ADVISORY LOCKING
17761
17762 =item SPEED
17763
17764 =item CANONICAL REPRESENTATION
17765
17766 =item FORWARD COMPATIBILITY
17767
17768 utf8 data, restricted hashes, files from future versions of Storable
17769
17770 =item ERROR REPORTING
17771
17772 =item WIZARDS ONLY
17773
17774 =over 4
17775
17776 =item Hooks
17777
17778 C<STORABLE_freeze> I<obj>, I<cloning>, C<STORABLE_thaw> I<obj>, I<cloning>,
17779 I<serialized>, ..
17780
17781 =item Predicates
17782
17783 C<Storable::last_op_in_netorder>, C<Storable::is_storing>,
17784 C<Storable::is_retrieving>
17785
17786 =item Recursion
17787
17788 =item Deep Cloning
17789
17790 =back
17791
17792 =item Storable magic
17793
17794 =item EXAMPLES
17795
17796 =item WARNING
17797
17798 =item BUGS
17799
17800 =item CREDITS
17801
17802 =item AUTHOR
17803
17804 =item SEE ALSO
17805
17806 =back
17807
17808 =head2 Switch - A switch statement for Perl
17809
17810 =over 4
17811
17812 =item VERSION
17813
17814 =item SYNOPSIS
17815
17816 =item BACKGROUND
17817
17818 =item DESCRIPTION
17819
17820 =over 4
17821
17822 =item Allowing fall-through
17823
17824 =item Automating fall-through
17825
17826 =item Alternative syntax
17827
17828 =item Higher-order Operations
17829
17830 =back
17831
17832 =item DEPENDENCIES
17833
17834 =item AUTHOR
17835
17836 =item BUGS
17837
17838 =item LIMITATION
17839
17840 =item COPYRIGHT
17841
17842 =back
17843
17844 =head2 Symbol - manipulate Perl symbols and their names
17845
17846 =over 4
17847
17848 =item SYNOPSIS
17849
17850 =item DESCRIPTION
17851
17852 =back
17853
17854 =head2 Sys::Hostname - Try every conceivable way to get hostname
17855
17856 =over 4
17857
17858 =item SYNOPSIS
17859
17860 =item DESCRIPTION
17861
17862 =item AUTHOR
17863
17864 =back
17865
17866 =head2 Syslog, Sys::Syslog, openlog, closelog, setlogmask, syslog - Perl
17867 interface to the UNIX syslog(3) calls
17868
17869 =over 4
17870
17871 =item SYNOPSIS
17872
17873 =item DESCRIPTION
17874
17875 openlog $ident, $logopt, $facility, syslog $priority, $format, @args,
17876 setlogmask $mask_priority, setlogsock $sock_type [$stream_location] (added
17877 in 5.004_02), closelog
17878
17879 =item EXAMPLES
17880
17881 =item SEE ALSO
17882
17883 =item AUTHOR
17884
17885 =back
17886
17887 =head2 Syslog::Syslog, Sys::Syslog, openlog, closelog, setlogmask, syslog -
17888 Perl interface to the UNIX syslog(3) calls
17889
17890 =over 4
17891
17892 =item SYNOPSIS
17893
17894 =item DESCRIPTION
17895
17896 openlog $ident, $logopt, $facility, syslog $priority, $format, @args,
17897 setlogmask $mask_priority, setlogsock $sock_type [$stream_location] (added
17898 in 5.004_02), closelog
17899
17900 =item EXAMPLES
17901
17902 =item SEE ALSO
17903
17904 =item AUTHOR
17905
17906 =back
17907
17908 =head2 Term::ANSIColor - Color screen output using ANSI escape sequences
17909
17910 =over 4
17911
17912 =item SYNOPSIS
17913
17914 =item DESCRIPTION
17915
17916 =item DIAGNOSTICS
17917
17918 Bad escape sequence %s, Bareword "%s" not allowed while "strict subs" in
17919 use, Invalid attribute name %s, Name "%s" used only once: possible typo, No
17920 comma allowed after filehandle, No name for escape sequence %s
17921
17922 =item ENVIRONMENT
17923
17924 ANSI_COLORS_DISABLED
17925
17926 =item RESTRICTIONS
17927
17928 =item NOTES
17929
17930 =item SEE ALSO
17931
17932 =item AUTHORS
17933
17934 =item LICENSE
17935
17936 =back
17937
17938 =head2 Term::Cap - Perl termcap interface
17939
17940 =over 4
17941
17942 =item SYNOPSIS
17943
17944 =item DESCRIPTION
17945
17946 =over 4
17947
17948 =item METHODS
17949
17950 =back
17951
17952 =back
17953
17954 B<Tgetent>, OSPEED, TERM
17955
17956 B<Tpad>, B<$string>, B<$cnt>, B<$FH>
17957
17958 B<Tputs>, B<$cap>, B<$cnt>, B<$FH>
17959
17960 B<Tgoto>, B<$cap>, B<$col>, B<$row>, B<$FH>
17961
17962 B<Trequire>
17963
17964 =over 4
17965
17966 =item EXAMPLES
17967
17968 =item COPYRIGHT AND LICENSE
17969
17970 =item AUTHOR
17971
17972 =item SEE ALSO
17973
17974 =back
17975
17976 =head2 Term::Complete - Perl word completion module
17977
17978 =over 4
17979
17980 =item SYNOPSIS
17981
17982 =item DESCRIPTION
17983
17984 E<lt>tabE<gt>, ^D, ^U, E<lt>delE<gt>, E<lt>bsE<gt>
17985
17986 =item DIAGNOSTICS
17987
17988 =item BUGS
17989
17990 =item AUTHOR
17991
17992 =back
17993
17994 =head2 Term::ReadLine - Perl interface to various C<readline> packages. If
17995 no real package is found, substitutes stubs instead of basic functions.
17996
17997 =over 4
17998
17999 =item SYNOPSIS
18000
18001 =item DESCRIPTION
18002
18003 =item Minimal set of supported functions
18004
18005 C<ReadLine>, C<new>, C<readline>, C<addhistory>, C<IN>, $C<OUT>,
18006 C<MinLine>, C<findConsole>, Attribs, C<Features>
18007
18008 =item Additional supported functions
18009
18010 C<tkRunning>, C<ornaments>, C<newTTY>
18011
18012 =item EXPORTS
18013
18014 =item ENVIRONMENT
18015
18016 =item CAVEATS
18017
18018 =back
18019
18020 =head2 Test - provides a simple framework for writing test scripts
18021
18022 =over 4
18023
18024 =item SYNOPSIS
18025
18026 =item DESCRIPTION
18027
18028 =over 4
18029
18030 =item Functions
18031
18032 B<plan>
18033
18034 =back
18035
18036 =back
18037
18038 B<_to_value>
18039
18040 B<ok>
18041
18042 =over 4
18043
18044 =item TEST TYPES
18045
18046 NORMAL TESTS, SKIPPED TESTS, TODO TESTS
18047
18048 =item ONFAIL
18049
18050 =item BUGS and CAVEATS
18051
18052 =item NOTE
18053
18054 =item SEE ALSO
18055
18056 =item AUTHOR
18057
18058 =back
18059
18060 =head2 Test::Builder - Backend for building test libraries
18061
18062 =over 4
18063
18064 =item SYNOPSIS
18065
18066 =item DESCRIPTION
18067
18068 =over 4
18069
18070 =item Construction
18071
18072 B<new>
18073
18074 =back
18075
18076 =back
18077
18078 =over 4
18079
18080 =item Setting up tests
18081
18082 B<exported_to>
18083
18084 =back
18085
18086 B<plan>
18087
18088 B<expected_tests>
18089
18090 B<no_plan>
18091
18092 B<skip_all>
18093
18094 =over 4
18095
18096 =item Running tests
18097
18098 B<ok>
18099
18100 =back
18101
18102 B<is_eq>, B<is_num>
18103
18104 B<isnt_eq>, B<isnt_num>
18105
18106 B<like>, B<unlike>
18107
18108 B<maybe_regex>
18109
18110 B<cmp_ok>
18111
18112 B<BAILOUT>
18113
18114 B<skip>
18115
18116 B<todo_skip>
18117
18118 B<skip_rest>
18119
18120 =over 4
18121
18122 =item Test style
18123
18124 B<level>
18125
18126 =back
18127
18128 B<use_numbers>
18129
18130 B<no_header>, B<no_ending>
18131
18132 =over 4
18133
18134 =item Output
18135
18136 B<diag>
18137
18138 =back
18139
18140 B<_print>
18141
18142 B<output>, B<failure_output>, B<todo_output>
18143
18144 =over 4
18145
18146 =item Test Status and Info
18147
18148 B<current_test>
18149
18150 =back
18151
18152 B<summary>
18153
18154 B<details>  I<UNIMPLEMENTED>, B<todo>
18155
18156 B<caller>
18157
18158 B<_sanity_check>
18159
18160 B<_whoa>
18161
18162 B<_my_exit>
18163
18164 =over 4
18165
18166 =item EXAMPLES
18167
18168 =item SEE ALSO
18169
18170 =item AUTHORS
18171
18172 =item COPYRIGHT
18173
18174 =back
18175
18176 =head2 Test::Harness - run perl standard test scripts with statistics
18177
18178 =over 4
18179
18180 =item SYNOPSIS
18181
18182 =item DESCRIPTION
18183
18184 =over 4
18185
18186 =item The test script output
18187
18188 B<'1..M'>, B<'ok', 'not ok'.  Ok?>, B<test numbers>, B<test names>,
18189 B<Skipping tests>, B<Todo tests>, B<Bail out!>, B<Comments>, B<Anything
18190 else>
18191
18192 =item Taint mode
18193
18194 =item Configuration variables.
18195
18196 B<$Test::Harness::verbose>, B<$Test::Harness::switches>
18197
18198 =item Failure
18199
18200 B<Failed Test>, B<Stat>, B<Wstat>, B<Total>, B<Fail>, B<Failed>, B<List of
18201 Failed>
18202
18203 =item Functions
18204
18205 B<runtests>
18206
18207 =back
18208
18209 =back
18210
18211 B<_all_ok>
18212
18213 B<_globdir>
18214
18215 B<_run_all_tests>
18216
18217 B<_mk_leader>
18218
18219 B<_leader_width>
18220
18221 =over 4
18222
18223 =item EXPORT
18224
18225 =item DIAGNOSTICS
18226
18227 C<All tests successful.\nFiles=%d,  Tests=%d, %s>, C<FAILED tests
18228 %s\n\tFailed %d/%d tests, %.2f%% okay.>, C<Test returned status %d (wstat
18229 %d)>, C<Failed 1 test, %.2f%% okay. %s>, C<Failed %d/%d tests, %.2f%% okay.
18230 %s>, C<FAILED--Further testing stopped: %s>
18231
18232 =item ENVIRONMENT
18233
18234 C<HARNESS_ACTIVE>, C<HARNESS_COLUMNS>, C<HARNESS_COMPILE_TEST>,
18235 C<HARNESS_FILELEAK_IN_DIR>, C<HARNESS_IGNORE_EXITCODE>, C<HARNESS_NOTTY>,
18236 C<HARNESS_PERL_SWITCHES>, C<HARNESS_VERBOSE>
18237
18238 =item EXAMPLE
18239
18240 =item SEE ALSO
18241
18242 =item AUTHORS
18243
18244 =item TODO
18245
18246 =item BUGS
18247
18248 =back
18249
18250 =head2 Test::Harness::Assert - simple assert
18251
18252 =over 4
18253
18254 =item SYNOPSIS
18255
18256 =item DESCRIPTION
18257
18258 =over 4
18259
18260 =item Functions
18261
18262 B<assert>
18263
18264 =back
18265
18266 =back
18267
18268 =over 4
18269
18270 =item AUTHOR
18271
18272 =item SEE ALSO
18273
18274 =back
18275
18276 =head2 Test::Harness::Iterator - Internal Test::Harness Iterator
18277
18278 =over 4
18279
18280 =item SYNOPSIS
18281
18282 =item DESCRIPTION
18283
18284 =back
18285
18286 =head2 Test::Harness::Straps - detailed analysis of test results
18287
18288 =over 4
18289
18290 =item SYNOPSIS
18291
18292 =item DESCRIPTION
18293
18294 =over 4
18295
18296 =item Construction
18297
18298 B<new>
18299
18300 =back
18301
18302 =back
18303
18304 B<_init>
18305
18306 =over 4
18307
18308 =item Analysis
18309
18310 B<analyze>
18311
18312 =back
18313
18314 B<analyze_fh>
18315
18316 B<analyze_file>
18317
18318 B<_switches>
18319
18320 B<_INC2PERL5LIB>
18321
18322 B<_filtered_INC>
18323
18324 B<_restore_PERL5LIB>
18325
18326 =over 4
18327
18328 =item Parsing
18329
18330 B<_is_comment>
18331
18332 =back
18333
18334 B<_is_header>
18335
18336 B<_is_test>
18337
18338 B<_is_bail_out>
18339
18340 B<_reset_file_state>
18341
18342 =over 4
18343
18344 =item Results
18345
18346 B<_detailize>
18347
18348 =back
18349
18350 =over 4
18351
18352 =item EXAMPLES
18353
18354 =item AUTHOR
18355
18356 =item SEE ALSO
18357
18358 =back
18359
18360 =head2 Test::More - yet another framework for writing test scripts
18361
18362 =over 4
18363
18364 =item SYNOPSIS
18365
18366 =item DESCRIPTION
18367
18368 =over 4
18369
18370 =item I love it when a plan comes together
18371
18372 =back
18373
18374 =back
18375
18376 =over 4
18377
18378 =item Test names
18379
18380 =item I'm ok, you're not ok.
18381
18382 B<ok>
18383
18384 =back
18385
18386 B<is>, B<isnt>
18387
18388 B<like>
18389
18390 B<unlike>
18391
18392 B<cmp_ok>
18393
18394 B<can_ok>
18395
18396 B<isa_ok>
18397
18398 B<pass>, B<fail>
18399
18400 =over 4
18401
18402 =item Diagnostics
18403
18404 B<diag>
18405
18406 =back
18407
18408 =over 4
18409
18410 =item Module tests
18411
18412 B<use_ok>
18413
18414 =back
18415
18416 B<require_ok>
18417
18418 =over 4
18419
18420 =item Conditional tests
18421
18422 B<SKIP: BLOCK>
18423
18424 =back
18425
18426 B<TODO: BLOCK>, B<todo_skip>
18427
18428 =over 4
18429
18430 =item Comparison functions
18431
18432 B<is_deeply>
18433
18434 =back
18435
18436 B<eq_array>
18437
18438 B<eq_hash>
18439
18440 B<eq_set>
18441
18442 =over 4
18443
18444 =item Extending and Embedding Test::More
18445
18446 B<builder>
18447
18448 =back
18449
18450 =over 4
18451
18452 =item NOTES
18453
18454 =item BUGS and CAVEATS
18455
18456 Making your own ok(), The eq_* family has some caveats, Test::Harness
18457 upgrades
18458
18459 =item HISTORY
18460
18461 =item SEE ALSO
18462
18463 =item AUTHORS
18464
18465 =item COPYRIGHT
18466
18467 =back
18468
18469 =head2 Test::Simple - Basic utilities for writing tests.
18470
18471 =over 4
18472
18473 =item SYNOPSIS
18474
18475 =item DESCRIPTION
18476
18477 B<ok>
18478
18479 =back
18480
18481 =over 4
18482
18483 =item EXAMPLE
18484
18485 =item CAVEATS
18486
18487 =item NOTES
18488
18489 =item HISTORY
18490
18491 =item SEE ALSO
18492
18493 L<Test::More>, L<Test>, L<Test::Unit>, L<Test::Inline>, L<SelfTest>,
18494 L<Test::Harness>
18495
18496 =item AUTHORS
18497
18498 =item COPYRIGHT
18499
18500 =back
18501
18502 =head2 Test::Tutorial - A tutorial about writing really basic tests
18503
18504 =over 4
18505
18506 =item DESCRIPTION
18507
18508 =over 4
18509
18510 =item Nuts and bolts of testing.
18511
18512 =item Where to start?
18513
18514 =item Names
18515
18516 =item Test the manual
18517
18518 =item Sometimes the tests are wrong
18519
18520 =item Testing lots of values
18521
18522 =item Informative names
18523
18524 =item Skipping tests
18525
18526 =item Todo tests
18527
18528 =item Testing with taint mode.
18529
18530 =back
18531
18532 =item FOOTNOTES
18533
18534 =item AUTHORS
18535
18536 =item COPYRIGHT
18537
18538 =back
18539
18540 =head2 Text::Abbrev, abbrev - create an abbreviation table from a list
18541
18542 =over 4
18543
18544 =item SYNOPSIS
18545
18546 =item DESCRIPTION
18547
18548 =item EXAMPLE
18549
18550 =back
18551
18552 =head2 Text::Balanced - Extract delimited text sequences from strings.
18553
18554 =over 4
18555
18556 =item SYNOPSIS
18557
18558 =item DESCRIPTION
18559
18560 =over 4
18561
18562 =item General behaviour in list contexts
18563
18564 [0], [1], [2]
18565
18566 =item General behaviour in scalar and void contexts
18567
18568 =item A note about prefixes
18569
18570 =item C<extract_delimited>
18571
18572 =item C<extract_bracketed>
18573
18574 =item C<extract_tagged>
18575
18576 C<reject =E<gt> $listref>, C<ignore =E<gt> $listref>, C<fail =E<gt> $str>,
18577 [0], [1], [2], [3], [4], [5]
18578
18579 =item C<gen_extract_tagged>
18580
18581 =item C<extract_quotelike>
18582
18583 [0], [1], [2], [3], [4], [5], [6], [7], [8], [9], [10]
18584
18585 =item C<extract_quotelike> and "here documents"
18586
18587 [0], [1], [2], [3], [4], [5], [6], [7..10]
18588
18589 =item C<extract_codeblock>
18590
18591 =item C<extract_multiple>
18592
18593 =item C<gen_delimited_pat>
18594
18595 =back
18596
18597 =item DIAGNOSTICS
18598
18599  C<Did not find a suitable bracket: "%s">,  C<Did not find prefix: /%s/>,
18600 C<Did not find opening bracket after prefix: "%s">,  C<No quotelike
18601 operator found after prefix: "%s">,  C<Unmatched closing bracket: "%c">,
18602 C<Unmatched opening bracket(s): "%s">, C<Unmatched embedded quote (%s)>,
18603 C<Did not find closing delimiter to match '%s'>,  C<Mismatched closing
18604 bracket: expected "%c" but found "%s">,  C<No block delimiter found after
18605 quotelike "%s">, C<Did not find leading dereferencer>, C<Bad identifier
18606 after dereferencer>, C<Did not find expected opening bracket at %s>,
18607 C<Improperly nested codeblock at %s>,  C<Missing second block for quotelike
18608 "%s">, C<No match found for opening bracket>, C<Did not find opening tag:
18609 /%s/>, C<Unable to construct closing tag to match: /%s/>, C<Found invalid
18610 nested tag: %s>, C<Found unbalanced nested tag: %s>, C<Did not find closing
18611 tag>
18612
18613 =item AUTHOR
18614
18615 =item BUGS AND IRRITATIONS
18616
18617 =item COPYRIGHT
18618
18619 =back
18620
18621 =head2 Text::ParseWords - parse text into an array of tokens or array of
18622 arrays
18623
18624 =over 4
18625
18626 =item SYNOPSIS
18627
18628 =item DESCRIPTION
18629
18630 =item EXAMPLES
18631
18632 =item AUTHORS
18633
18634 =back
18635
18636 =head2 Text::Soundex - Implementation of the Soundex Algorithm as Described
18637 by Knuth
18638
18639 =over 4
18640
18641 =item SYNOPSIS
18642
18643 =item DESCRIPTION
18644
18645 =item EXAMPLES
18646
18647 =item LIMITATIONS
18648
18649 =item AUTHOR
18650
18651 =back
18652
18653 =head2 Text::Tabs -- expand and unexpand tabs per the unix expand(1) and
18654 unexpand(1)
18655
18656 =over 4
18657
18658 =item SYNOPSIS
18659
18660 =item DESCRIPTION
18661
18662 =item BUGS
18663
18664 =item AUTHOR
18665
18666 =back
18667
18668 =head2 Text::Wrap - line wrapping to form simple paragraphs
18669
18670 =over 4
18671
18672 =item SYNOPSIS
18673
18674 =item DESCRIPTION
18675
18676 =item OVERRIDES
18677
18678 =item EXAMPLE
18679
18680 =item AUTHOR
18681
18682 =back
18683
18684 =head2 Thread - manipulate threads in Perl
18685
18686 =over 4
18687
18688 =item CAVEAT
18689
18690 =item SYNOPSIS
18691
18692 =item DESCRIPTION
18693
18694 =item FUNCTIONS
18695
18696 $thread = Thread->new(\&start_sub), $thread = Thread->new(\&start_sub,
18697 LIST), lock VARIABLE, async BLOCK;, Thread->self, cond_wait VARIABLE,
18698 cond_signal VARIABLE, cond_broadcast VARIABLE, yield
18699
18700 =item METHODS
18701
18702 join, eval, detach, equal, tid, flags, done
18703
18704 =item LIMITATIONS
18705
18706 =item SEE ALSO
18707
18708 =back
18709
18710 =head2 Thread::Queue - thread-safe queues
18711
18712 =over 4
18713
18714 =item SYNOPSIS
18715
18716 =item DESCRIPTION
18717
18718 =item FUNCTIONS AND METHODS
18719
18720 new, enqueue LIST, dequeue, dequeue_nb, pending
18721
18722 =item SEE ALSO
18723
18724 =back
18725
18726 =head2 Thread::Semaphore - thread-safe semaphores
18727
18728 =over 4
18729
18730 =item SYNOPSIS
18731
18732 =item DESCRIPTION
18733
18734 =item FUNCTIONS AND METHODS
18735
18736 new, new NUMBER, down, down NUMBER, up, up NUMBER
18737
18738 =back
18739
18740 =head2 Thread::Signal - Start a thread which runs signal handlers reliably
18741
18742 =over 4
18743
18744 =item SYNOPSIS
18745
18746 =item DESCRIPTION
18747
18748 =item BUGS
18749
18750 =back
18751
18752 =head2 Thread::Specific - thread-specific keys
18753
18754 =over 4
18755
18756 =item SYNOPSIS
18757
18758 =item DESCRIPTION
18759
18760 =back
18761
18762 =head2 Tie::Array - base class for tied arrays
18763
18764 =over 4
18765
18766 =item SYNOPSIS
18767
18768 =item DESCRIPTION
18769
18770 TIEARRAY classname, LIST, STORE this, index, value, FETCH this, index,
18771 FETCHSIZE this, STORESIZE this, count, EXTEND this, count, EXISTS this,
18772 key, DELETE this, key, CLEAR this, DESTROY this, PUSH this, LIST, POP this,
18773 SHIFT this, UNSHIFT this, LIST, SPLICE this, offset, length, LIST
18774
18775 =item CAVEATS
18776
18777 =item AUTHOR
18778
18779 =back
18780
18781 =head2 Tie::File - Access the lines of a disk file via a Perl array
18782
18783 =over 4
18784
18785 =item SYNOPSIS
18786
18787 =item DESCRIPTION
18788
18789 =over 4
18790
18791 =item C<recsep>
18792
18793 =item C<autochomp>
18794
18795 =item C<mode>
18796
18797 =item C<memory>
18798
18799 =item C<dw_size>
18800
18801 =item Option Format
18802
18803 =back
18804
18805 =item Public Methods
18806
18807 =over 4
18808
18809 =item C<flock>
18810
18811 =item C<autochomp>
18812
18813 =item C<defer>, C<flush>, C<discard>, and C<autodefer>
18814
18815 =back
18816
18817 =item Tying to an already-opened filehandle
18818
18819 =item Deferred Writing
18820
18821 =over 4
18822
18823 =item Autodeferring
18824
18825 =back
18826
18827 =item CAVEATS
18828
18829 =item SUBCLASSING
18830
18831 =item WHAT ABOUT C<DB_File>?
18832
18833 =item AUTHOR
18834
18835 =item LICENSE
18836
18837 =item WARRANTY
18838
18839 =item THANKS
18840
18841 =item TODO
18842
18843 =back
18844
18845 =head2 Tie::Handle, Tie::StdHandle  - base class definitions for tied
18846 handles
18847
18848 =over 4
18849
18850 =item SYNOPSIS
18851
18852 =item DESCRIPTION
18853
18854 TIEHANDLE classname, LIST, WRITE this, scalar, length, offset, PRINT this,
18855 LIST, PRINTF this, format, LIST, READ this, scalar, length, offset,
18856 READLINE this, GETC this, CLOSE this, OPEN this, filename, BINMODE this,
18857 EOF this, TELL this, SEEK this, offset, whence, DESTROY this
18858
18859 =item MORE INFORMATION
18860
18861 =item COMPATIBILITY
18862
18863 =back
18864
18865 =head2 Tie::Hash, Tie::StdHash, Tie::ExtraHash - base class definitions for
18866 tied hashes
18867
18868 =over 4
18869
18870 =item SYNOPSIS
18871
18872 =item DESCRIPTION
18873
18874 TIEHASH classname, LIST, STORE this, key, value, FETCH this, key, FIRSTKEY
18875 this, NEXTKEY this, lastkey, EXISTS this, key, DELETE this, key, CLEAR this
18876
18877 =item Inheriting from B<Tie::StdHash>
18878
18879 =item Inheriting from B<Tie::ExtraHash>
18880
18881 =item C<UNTIE> and C<DESTROY>
18882
18883 =item MORE INFORMATION
18884
18885 =back
18886
18887 =head2 Tie::Memoize - add data to hash when needed
18888
18889 =over 4
18890
18891 =item SYNOPSIS
18892
18893 =item DESCRIPTION
18894
18895 =item Inheriting from B<Tie::Memoize>
18896
18897 =item EXAMPLE
18898
18899 =item BUGS
18900
18901 =item AUTHOR
18902
18903 =back
18904
18905 =head2 Tie::RefHash - use references as hash keys
18906
18907 =over 4
18908
18909 =item SYNOPSIS
18910
18911 =item DESCRIPTION
18912
18913 =item EXAMPLE
18914
18915 =item AUTHOR
18916
18917 =item VERSION
18918
18919 =item SEE ALSO
18920
18921 =back
18922
18923 =head2 Tie::Scalar, Tie::StdScalar - base class definitions for tied
18924 scalars
18925
18926 =over 4
18927
18928 =item SYNOPSIS
18929
18930 =item DESCRIPTION
18931
18932 TIESCALAR classname, LIST, FETCH this, STORE this, value, DESTROY this
18933
18934 =item MORE INFORMATION
18935
18936 =back
18937
18938 =head2 Tie::SubstrHash - Fixed-table-size, fixed-key-length hashing
18939
18940 =over 4
18941
18942 =item SYNOPSIS
18943
18944 =item DESCRIPTION
18945
18946 =item CAVEATS
18947
18948 =back
18949
18950 =head2 Time::HiRes - High resolution alarm, sleep, gettimeofday, interval
18951 timers
18952
18953 =over 4
18954
18955 =item SYNOPSIS
18956
18957 =item DESCRIPTION
18958
18959 gettimeofday (), usleep ( $useconds ), ualarm ( $useconds [,
18960 $interval_useconds ] ), tv_interval, time (), sleep ( $floating_seconds ),
18961 alarm ( $floating_seconds [, $interval_floating_seconds ] ), setitimer,
18962 getitimer ( $which )
18963
18964 =item EXAMPLES
18965
18966 =item C API
18967
18968 =item CAVEATS
18969
18970 =item AUTHORS
18971
18972 =item REVISION
18973
18974 =item COPYRIGHT
18975
18976 =back
18977
18978 =head2 Time::Local - efficiently compute time from local and GMT time
18979
18980 =over 4
18981
18982 =item SYNOPSIS
18983
18984 =item DESCRIPTION
18985
18986 =item IMPLEMENTATION
18987
18988 =item BUGS
18989
18990 =back
18991
18992 =head2 Time::gmtime - by-name interface to Perl's built-in gmtime()
18993 function
18994
18995 =over 4
18996
18997 =item SYNOPSIS
18998
18999 =item DESCRIPTION
19000
19001 =item NOTE
19002
19003 =item AUTHOR
19004
19005 =back
19006
19007 =head2 Time::localtime - by-name interface to Perl's built-in localtime()
19008 function
19009
19010 =over 4
19011
19012 =item SYNOPSIS
19013
19014 =item DESCRIPTION
19015
19016 =item NOTE
19017
19018 =item AUTHOR
19019
19020 =back
19021
19022 =head2 Time::tm - internal object used by Time::gmtime and Time::localtime
19023
19024 =over 4
19025
19026 =item SYNOPSIS
19027
19028 =item DESCRIPTION
19029
19030 =item AUTHOR
19031
19032 =back
19033
19034 =head2 UNIVERSAL - base class for ALL classes (blessed references)
19035
19036 =over 4
19037
19038 =item SYNOPSIS
19039
19040 =item DESCRIPTION
19041
19042 $obj->isa( TYPE ), CLASS->isa( TYPE ), isa( VAL, TYPE ), $obj->can( METHOD
19043 ), CLASS->can( METHOD ), can( VAL, METHOD ), VERSION ( [ REQUIRE ] )
19044
19045 =back
19046
19047 =head2 Unicode::Collate - Unicode Collation Algorithm
19048
19049 =over 4
19050
19051 =item SYNOPSIS
19052
19053 =item DESCRIPTION
19054
19055 =over 4
19056
19057 =item Constructor and Tailoring
19058
19059 alternate, backwards, entry, ignoreName, ignoreChar, level, normalization,
19060 overrideCJK, overrideHangul, preprocess, rearrange, table, undefName,
19061 undefChar, katakana_before_hiragana, upper_before_lower
19062
19063 =item Methods for Collation
19064
19065 C<@sorted = $Collator-E<gt>sort(@not_sorted)>, C<$result =
19066 $Collator-E<gt>cmp($a, $b)>, C<$result = $Collator-E<gt>eq($a, $b)>,
19067 C<$result = $Collator-E<gt>ne($a, $b)>, C<$result = $Collator-E<gt>lt($a,
19068 $b)>, C<$result = $Collator-E<gt>le($a, $b)>, C<$result =
19069 $Collator-E<gt>gt($a, $b)>, C<$result = $Collator-E<gt>ge($a, $b)>,
19070 C<$sortKey = $Collator-E<gt>getSortKey($string)>, C<$sortKeyForm =
19071 $Collator-E<gt>viewSortKey($string)>, C<$position =
19072 $Collator-E<gt>index($string, $substring)>, C<($position, $length) =
19073 $Collator-E<gt>index($string, $substring)>
19074
19075 =item Other Methods
19076
19077 UCA_Version, Base_Unicode_Version
19078
19079 =item EXPORT
19080
19081 =item TODO
19082
19083 =item CAVEAT
19084
19085 =item BUGS
19086
19087 =back
19088
19089 =item AUTHOR
19090
19091 =item SEE ALSO
19092
19093 http://www.unicode.org/unicode/reports/tr10/,
19094 http://www.unicode.org/unicode/reports/tr10/allkeys.txt,
19095 http://www.unicode.org/unicode/reports/tr15/,
19096 http://www.unicode.org/unicode/reports/tr18, L<Unicode::Normalize>
19097
19098 =back
19099
19100 =head2 Unicode::Normalize - Unicode Normalization Forms
19101
19102 =over 4
19103
19104 =item SYNOPSIS
19105
19106 =item DESCRIPTION
19107
19108 =over 4
19109
19110 =item Normalization Forms
19111
19112 C<$NFD_string = NFD($string)>, C<$NFC_string = NFC($string)>,
19113 C<$NFKD_string = NFKD($string)>, C<$NFKC_string = NFKC($string)>,
19114 C<$normalized_string = normalize($form_name, $string)>
19115
19116 =item Decomposition and Composition
19117
19118 C<$decomposed_string = decompose($string)>, C<$decomposed_string =
19119 decompose($string, $useCompatMapping)>, C<$reordered_string  =
19120 reorder($string)>, C<$composed_string   = compose($string)>
19121
19122 =item Quick Check
19123
19124 C<$result = checkNFD($string)>, C<$result = checkNFC($string)>, C<$result =
19125 checkNFKD($string)>, C<$result = checkNFKC($string)>, C<$result =
19126 check($form_name, $string)>
19127
19128 =item Character Data
19129
19130 C<$canonical_decomposed = getCanon($codepoint)>,
19131 C<$compatibility_decomposed = getCompat($codepoint)>,
19132 C<$codepoint_composite = getComposite($codepoint_here, $codepoint_next)>,
19133 C<$combining_class = getCombinClass($codepoint)>, C<$is_exclusion =
19134 isExclusion($codepoint)>, C<$is_singleton = isSingleton($codepoint)>,
19135 C<$is_non_startar_decomposition = isNonStDecomp($codepoint)>,
19136 C<$may_be_composed_with_prev_char = isComp2nd($codepoint)>
19137
19138 =item EXPORT
19139
19140 =back
19141
19142 =item AUTHOR
19143
19144 =item SEE ALSO
19145
19146 http://www.unicode.org/unicode/reports/tr15/,
19147 http://www.unicode.org/Public/UNIDATA/DerivedNormalizationProps.txt
19148
19149 =back
19150
19151 =head2 Unicode::UCD - Unicode character database
19152
19153 =over 4
19154
19155 =item SYNOPSIS
19156
19157 =item DESCRIPTION
19158
19159 =back
19160
19161 =over 4
19162
19163 =item charinfo
19164
19165 =back
19166
19167 =over 4
19168
19169 =item charblock
19170
19171 =back
19172
19173 =over 4
19174
19175 =item charscript
19176
19177 =back
19178
19179 =over 4
19180
19181 =item charblocks
19182
19183 =back
19184
19185 =over 4
19186
19187 =item charscripts
19188
19189 =back
19190
19191 =over 4
19192
19193 =item Blocks versus Scripts
19194
19195 =item Matching Scripts and Blocks
19196
19197 =item Code Point Arguments
19198
19199 =item charinrange
19200
19201 =back
19202
19203 =over 4
19204
19205 =item compexcl
19206
19207 =back
19208
19209 =over 4
19210
19211 =item casefold
19212
19213 =back
19214
19215 =over 4
19216
19217 =item casespec
19218
19219 =back
19220
19221 =over 4
19222
19223 =item Unicode::UCD::UnicodeVersion
19224
19225 =back
19226
19227 =over 4
19228
19229 =item Implementation Note
19230
19231 =back
19232
19233 =over 4
19234
19235 =item BUGS
19236
19237 =item AUTHOR
19238
19239 =back
19240
19241 =head2 User::grent - by-name interface to Perl's built-in getgr*()
19242 functions
19243
19244 =over 4
19245
19246 =item SYNOPSIS
19247
19248 =item DESCRIPTION
19249
19250 =item NOTE
19251
19252 =item AUTHOR
19253
19254 =back
19255
19256 =head2 User::pwent - by-name interface to Perl's built-in getpw*()
19257 functions
19258
19259 =over 4
19260
19261 =item SYNOPSIS
19262
19263 =item DESCRIPTION
19264
19265 =over 4
19266
19267 =item System Specifics
19268
19269 =back
19270
19271 =item NOTE
19272
19273 =item AUTHOR
19274
19275 =item HISTORY
19276
19277 March 18th, 2000
19278
19279 =back
19280
19281 =head2 Win32 - Interfaces to some Win32 API Functions
19282
19283 =over 4
19284
19285 =item DESCRIPTION
19286
19287 =over 4
19288
19289 =item Alphabetical Listing of Win32 Functions
19290
19291 Win32::AbortSystemShutdown(MACHINE), Win32::BuildNumber(),
19292 Win32::CopyFile(FROM, TO, OVERWRITE), Win32::DomainName(),
19293 Win32::ExpandEnvironmentStrings(STRING), Win32::FormatMessage(ERRORCODE),
19294 Win32::FsType(), Win32::FreeLibrary(HANDLE), Win32::GetArchName(),
19295 Win32::GetChipName(), Win32::GetCwd(), Win32::GetFullPathName(FILENAME),
19296 Win32::GetLastError(), Win32::GetLongPathName(PATHNAME),
19297 Win32::GetNextAvailDrive(), Win32::GetOSVersion(),
19298 Win32::GetShortPathName(PATHNAME), Win32::GetProcAddress(INSTANCE,
19299 PROCNAME), Win32::GetTickCount(), Win32::InitiateSystemShutdown,
19300 Win32::IsWinNT(), Win32::IsWin95(), Win32::LoadLibrary(LIBNAME),
19301 Win32::LoginName(), Win32::LookupAccountName(SYSTEM, ACCOUNT, DOMAIN, SID,
19302 SIDTYPE), Win32::LookupAccountSID(SYSTEM, SID, ACCOUNT, DOMAIN, SIDTYPE),
19303 Win32::MsgBox(MESSAGE [, FLAGS [, TITLE]]), Win32::NodeName(),
19304 Win32::RegisterServer(LIBRARYNAME), Win32::SetChildShowWindow(SHOWWINDOW),
19305 Win32::SetCwd(NEWDIRECTORY), Win32::SetLastError(ERROR),
19306 Win32::Sleep(TIME), Win32::Spawn(COMMAND, ARGS, PID),
19307 Win32::UnregisterServer(LIBRARYNAME)
19308
19309 =back
19310
19311 =back
19312
19313 =head2 XS::Typemap - module to test the XS typemaps distributed with perl
19314
19315 =over 4
19316
19317 =item SYNOPSIS
19318
19319 =item DESCRIPTION
19320
19321 =back
19322
19323 =over 4
19324
19325 =item NOTES
19326
19327 =item AUTHOR
19328
19329 =back
19330
19331 =head2 XSLoader - Dynamically load C libraries into Perl code
19332
19333 =over 4
19334
19335 =item SYNOPSIS
19336
19337 =item DESCRIPTION
19338
19339 =item AUTHOR
19340
19341 =back
19342
19343 =head1 AUXILIARY DOCUMENTATION
19344
19345 Here should be listed all the extra programs' documentation, but they
19346 don't all have manual pages yet:
19347
19348 =over 4
19349
19350 =item a2p
19351
19352 =item s2p
19353
19354 =item find2perl
19355
19356 =item h2ph
19357
19358 =item c2ph
19359
19360 =item h2xs
19361
19362 =item xsubpp
19363
19364 =item pod2man
19365
19366 =item wrapsuid
19367
19368 =back
19369
19370 =head1 AUTHOR
19371
19372 Larry Wall <F<larry@wall.org>>, with the help of oodles
19373 of other folks.
19374