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 =item DESCRIPTION
  21
  22 =item AVAILABILITY
  23
  24 =item ENVIRONMENT
  25
  26 =item AUTHOR
  27
  28 =item FILES
  29
  30 =item SEE ALSO
  31
  32 =item DIAGNOSTICS
  33
  34 =item BUGS
  35
  36 =item NOTES
  37
  38 =back
  39
  40 =head2 perlfaq - frequently asked questions about Perl ($Date: 2001/09/20
  41 03:03:00 $)
  42
  43 =over 4
  44
  45 =item DESCRIPTION
  46
  47 =over 4
  48
  49 =item perlfaq: Structural overview of the FAQ.
  50
  51 =item L<perlfaq1>: General Questions About Perl
  52
  53 =item L<perlfaq2>: Obtaining and Learning about Perl
  54
  55 =item L<perlfaq3>: Programming Tools
  56
  57 =item L<perlfaq4>: Data Manipulation
  58
  59 =item L<perlfaq5>: Files and Formats
  60
  61 =item L<perlfaq6>: Regexps
  62
  63 =item L<perlfaq7>: General Perl Language Issues
  64
  65 =item L<perlfaq8>: System Interaction
  66
  67 =item L<perlfaq9>: Networking
  68
  69 =back
  70
  71 =item About the perlfaq documents
  72
  73 =over 4
  74
  75 =item Where to get the perlfaq
  76
  77 =item How to contribute to the perlfaq
  78
  79 =item What will happen if you mail your Perl programming problems to the
  80 authors
  81
  82 =back
  83
  84 =item Credits
  85
  86 =item Author and Copyright Information
  87
  88 =over 4
  89
  90 =item Bundled Distributions
  91
  92 =item Disclaimer
  93
  94 =back
  95
  96 =item Changes
  97
  98 1/November/2000, 23/May/99, 13/April/99, 7/January/99, 22/June/98,
  99 24/April/97, 23/April/97, 25/March/97, 18/March/97, 17/March/97 Version,
 100 Initial Release: 11/March/97
 101
 102 =back
 103
 104 =head2 perlbook - Perl book information
 105
 106 =over 4
 107
 108 =item DESCRIPTION
 109
 110 =back
 111
 112 =head2 perlsyn - Perl syntax
 113
 114 =over 4
 115
 116 =item DESCRIPTION
 117
 118 =over 4
 119
 120 =item Declarations
 121
 122 =item Simple statements
 123
 124 =item Compound statements
 125
 126 =item Loop Control
 127
 128 =item For Loops
 129
 130 =item Foreach Loops
 131
 132 =item Basic BLOCKs and Switch Statements
 133
 134 =item Goto
 135
 136 =item PODs: Embedded Documentation
 137
 138 =item Plain Old Comments (Not!)
 139
 140 =back
 141
 142 =back
 143
 144 =head2 perldata - Perl data types
 145
 146 =over 4
 147
 148 =item DESCRIPTION
 149
 150 =over 4
 151
 152 =item Variable names
 153
 154 =item Context
 155
 156 =item Scalar values
 157
 158 =item Scalar value constructors
 159
 160 =item List value constructors
 161
 162 =item Slices
 163
 164 =item Typeglobs and Filehandles
 165
 166 =back
 167
 168 =item SEE ALSO
 169
 170 =back
 171
 172 =head2 perlop - Perl operators and precedence
 173
 174 =over 4
 175
 176 =item SYNOPSIS
 177
 178 =item DESCRIPTION
 179
 180 =over 4
 181
 182 =item Terms and List Operators (Leftward)
 183
 184 =item The Arrow Operator
 185
 186 =item Auto-increment and Auto-decrement
 187
 188 =item Exponentiation
 189
 190 =item Symbolic Unary Operators
 191
 192 =item Binding Operators
 193
 194 =item Multiplicative Operators
 195
 196 =item Additive Operators
 197
 198 =item Shift Operators
 199
 200 =item Named Unary Operators
 201
 202 =item Relational Operators
 203
 204 =item Equality Operators
 205
 206 =item Bitwise And
 207
 208 =item Bitwise Or and Exclusive Or
 209
 210 =item C-style Logical And
 211
 212 =item C-style Logical Or
 213
 214 =item Range Operators
 215
 216 =item Conditional Operator
 217
 218 =item Assignment Operators
 219
 220 =item Comma Operator
 221
 222 =item List Operators (Rightward)
 223
 224 =item Logical Not
 225
 226 =item Logical And
 227
 228 =item Logical or and Exclusive Or
 229
 230 =item C Operators Missing From Perl
 231
 232 unary &, unary *, (TYPE)
 233
 234 =item Quote and Quote-like Operators
 235
 236 =item Regexp Quote-Like Operators
 237
 238 ?PATTERN?, m/PATTERN/cgimosx, /PATTERN/cgimosx, q/STRING/, C<'STRING'>,
 239 qq/STRING/, "STRING", qr/STRING/imosx, qx/STRING/, `STRING`, qw/STRING/,
 240 s/PATTERN/REPLACEMENT/egimosx, tr/SEARCHLIST/REPLACEMENTLIST/cds,
 241 y/SEARCHLIST/REPLACEMENTLIST/cds
 242
 243 =item Gory details of parsing quoted constructs
 244
 245 Finding the end, Removal of backslashes before delimiters, Interpolation,
 246 C<<<'EOF'>, C<m''>, C<s'''>, C<tr///>, C<y///>, C<''>, C<q//>, C<"">,
 247 C<``>, C<qq//>, C<qx//>, C<< <file*glob> >>, C<?RE?>, C</RE/>, C<m/RE/>,
 248 C<s/RE/foo/>,, Interpolation of regular expressions, Optimization of
 249 regular expressions
 250
 251 =item I/O Operators
 252
 253 =item Constant Folding
 254
 255 =item Bitwise String Operators
 256
 257 =item Integer Arithmetic
 258
 259 =item Floating-point Arithmetic
 260
 261 =item Bigger Numbers
 262
 263 =back
 264
 265 =back
 266
 267 =head2 perlsub - Perl subroutines
 268
 269 =over 4
 270
 271 =item SYNOPSIS
 272
 273 =item DESCRIPTION
 274
 275 =over 4
 276
 277 =item Private Variables via my()
 278
 279 =item Persistent Private Variables
 280
 281 =item Temporary Values via local()
 282
 283 =item Lvalue subroutines
 284
 285 =item Passing Symbol Table Entries (typeglobs)
 286
 287 =item When to Still Use local()
 288
 289 =item Pass by Reference
 290
 291 =item Prototypes
 292
 293 =item Constant Functions
 294
 295 =item Overriding Built-in Functions
 296
 297 =item Autoloading
 298
 299 =item Subroutine Attributes
 300
 301 =back
 302
 303 =item SEE ALSO
 304
 305 =back
 306
 307 =head2 perlfunc - Perl builtin functions
 308
 309 =over 4
 310
 311 =item DESCRIPTION
 312
 313 =over 4
 314
 315 =item Perl Functions by Category
 316
 317 Functions for SCALARs or strings, Regular expressions and pattern matching,
 318 Numeric functions, Functions for real @ARRAYs, Functions for list data,
 319 Functions for real %HASHes, Input and output functions, Functions for fixed
 320 length data or records, Functions for filehandles, files, or directories,
 321 Keywords related to the control flow of your perl program, Keywords related
 322 to scoping, Miscellaneous functions, Functions for processes and process
 323 groups, Keywords related to perl modules, Keywords related to classes and
 324 object-orientedness, Low-level socket functions, System V interprocess
 325 communication functions, Fetching user and group info, Fetching network
 326 info, Time-related functions, Functions new in perl5, Functions obsoleted
 327 in perl5
 328
 329 =item Portability
 330
 331 =item Alphabetical Listing of Perl Functions
 332
 333 I<-X> FILEHANDLE, I<-X> EXPR, I<-X>, abs VALUE, abs, accept
 334 NEWSOCKET,GENERICSOCKET, alarm SECONDS, alarm, atan2 Y,X, bind SOCKET,NAME,
 335 binmode FILEHANDLE, DISCIPLINE, binmode FILEHANDLE, bless REF,CLASSNAME,
 336 bless REF, caller EXPR, caller, chdir EXPR, chmod LIST, chomp VARIABLE,
 337 chomp LIST, chomp, chop VARIABLE, chop LIST, chop, chown LIST, chr NUMBER,
 338 chr, chroot FILENAME, chroot, close FILEHANDLE, close, closedir DIRHANDLE,
 339 connect SOCKET,NAME, continue BLOCK, cos EXPR, cos, crypt PLAINTEXT,SALT,
 340 dbmclose HASH, dbmopen HASH,DBNAME,MASK, defined EXPR, defined, delete
 341 EXPR, die LIST, do BLOCK, do SUBROUTINE(LIST), do EXPR, dump LABEL, dump,
 342 each HASH, eof FILEHANDLE, eof (), eof, eval EXPR, eval BLOCK, exec LIST,
 343 exec PROGRAM LIST, exists EXPR, exit EXPR, exp EXPR, exp, fcntl
 344 FILEHANDLE,FUNCTION,SCALAR, fileno FILEHANDLE, flock FILEHANDLE,OPERATION,
 345 fork, format, formline PICTURE,LIST, getc FILEHANDLE, getc, getlogin,
 346 getpeername SOCKET, getpgrp PID, getppid, getpriority WHICH,WHO, getpwnam
 347 NAME, getgrnam NAME, gethostbyname NAME, getnetbyname NAME, getprotobyname
 348 NAME, getpwuid UID, getgrgid GID, getservbyname NAME,PROTO, gethostbyaddr
 349 ADDR,ADDRTYPE, getnetbyaddr ADDR,ADDRTYPE, getprotobynumber NUMBER,
 350 getservbyport PORT,PROTO, getpwent, getgrent, gethostent, getnetent,
 351 getprotoent, getservent, setpwent, setgrent, sethostent STAYOPEN, setnetent
 352 STAYOPEN, setprotoent STAYOPEN, setservent STAYOPEN, endpwent, endgrent,
 353 endhostent, endnetent, endprotoent, endservent, getsockname SOCKET,
 354 getsockopt SOCKET,LEVEL,OPTNAME, glob EXPR, glob, gmtime EXPR, goto LABEL,
 355 goto EXPR, goto &NAME, grep BLOCK LIST, grep EXPR,LIST, hex EXPR, hex,
 356 import, index STR,SUBSTR,POSITION, index STR,SUBSTR, int EXPR, int, ioctl
 357 FILEHANDLE,FUNCTION,SCALAR, join EXPR,LIST, keys HASH, kill SIGNAL, LIST,
 358 last LABEL, last, lc EXPR, lc, lcfirst EXPR, lcfirst, length EXPR, length,
 359 link OLDFILE,NEWFILE, listen SOCKET,QUEUESIZE, local EXPR, localtime EXPR,
 360 lock, log EXPR, log, lstat EXPR, lstat, m//, map BLOCK LIST, map EXPR,LIST,
 361 mkdir FILENAME,MASK, mkdir FILENAME, msgctl ID,CMD,ARG, msgget KEY,FLAGS,
 362 msgrcv ID,VAR,SIZE,TYPE,FLAGS, msgsnd ID,MSG,FLAGS, my EXPR, my EXPR :
 363 ATTRIBUTES, next LABEL, next, no Module LIST, oct EXPR, oct, open
 364 FILEHANDLE,EXPR, open FILEHANDLE,MODE,EXPR, open FILEHANDLE,MODE,EXPR,LIST,
 365 open FILEHANDLE, opendir DIRHANDLE,EXPR, ord EXPR, ord, our EXPR, our EXPR
 366 : ATTRIBUTES, pack TEMPLATE,LIST, package NAMESPACE, package, pipe
 367 READHANDLE,WRITEHANDLE, pop ARRAY, pop, pos SCALAR, pos, print FILEHANDLE
 368 LIST, print LIST, print, printf FILEHANDLE FORMAT, LIST, printf FORMAT,
 369 LIST, prototype FUNCTION, push ARRAY,LIST, q/STRING/, qq/STRING/,
 370 qr/STRING/, qx/STRING/, qw/STRING/, quotemeta EXPR, quotemeta, rand EXPR,
 371 rand, read FILEHANDLE,SCALAR,LENGTH,OFFSET, read FILEHANDLE,SCALAR,LENGTH,
 372 readdir DIRHANDLE, readline EXPR, readlink EXPR, readlink, readpipe EXPR,
 373 recv SOCKET,SCALAR,LENGTH,FLAGS, redo LABEL, redo, ref EXPR, ref, rename
 374 OLDNAME,NEWNAME, require VERSION, require EXPR, require, reset EXPR, reset,
 375 return EXPR, return, reverse LIST, rewinddir DIRHANDLE, rindex
 376 STR,SUBSTR,POSITION, rindex STR,SUBSTR, rmdir FILENAME, rmdir, s///, scalar
 377 EXPR, seek FILEHANDLE,POSITION,WHENCE, seekdir DIRHANDLE,POS, select
 378 FILEHANDLE, select, select RBITS,WBITS,EBITS,TIMEOUT, semctl
 379 ID,SEMNUM,CMD,ARG, semget KEY,NSEMS,FLAGS, semop KEY,OPSTRING, send
 380 SOCKET,MSG,FLAGS,TO, send SOCKET,MSG,FLAGS, setpgrp PID,PGRP, setpriority
 381 WHICH,WHO,PRIORITY, setsockopt SOCKET,LEVEL,OPTNAME,OPTVAL, shift ARRAY,
 382 shift, shmctl ID,CMD,ARG, shmget KEY,SIZE,FLAGS, shmread ID,VAR,POS,SIZE,
 383 shmwrite ID,STRING,POS,SIZE, shutdown SOCKET,HOW, sin EXPR, sin, sleep
 384 EXPR, sleep, sockatmark SOCKET, socket SOCKET,DOMAIN,TYPE,PROTOCOL,
 385 socketpair SOCKET1,SOCKET2,DOMAIN,TYPE,PROTOCOL, sort SUBNAME LIST, sort
 386 BLOCK LIST, sort LIST, splice ARRAY,OFFSET,LENGTH,LIST, splice
 387 ARRAY,OFFSET,LENGTH, splice ARRAY,OFFSET, splice ARRAY, split
 388 /PATTERN/,EXPR,LIMIT, split /PATTERN/,EXPR, split /PATTERN/, split, sprintf
 389 FORMAT, LIST, sqrt EXPR, sqrt, srand EXPR, srand, stat FILEHANDLE, stat
 390 EXPR, stat, study SCALAR, study, sub BLOCK, sub NAME, sub NAME BLOCK,
 391 substr EXPR,OFFSET,LENGTH,REPLACEMENT, substr EXPR,OFFSET,LENGTH, substr
 392 EXPR,OFFSET, symlink OLDFILE,NEWFILE, syscall LIST, sysopen
 393 FILEHANDLE,FILENAME,MODE, sysopen FILEHANDLE,FILENAME,MODE,PERMS, sysread
 394 FILEHANDLE,SCALAR,LENGTH,OFFSET, sysread FILEHANDLE,SCALAR,LENGTH, sysseek
 395 FILEHANDLE,POSITION,WHENCE, system LIST, system PROGRAM LIST, syswrite
 396 FILEHANDLE,SCALAR,LENGTH,OFFSET, syswrite FILEHANDLE,SCALAR,LENGTH,
 397 syswrite FILEHANDLE,SCALAR, tell FILEHANDLE, tell, telldir DIRHANDLE, tie
 398 VARIABLE,CLASSNAME,LIST, tied VARIABLE, time, times, tr///, truncate
 399 FILEHANDLE,LENGTH, truncate EXPR,LENGTH, uc EXPR, uc, ucfirst EXPR,
 400 ucfirst, umask EXPR, umask, undef EXPR, undef, unlink LIST, unlink, unpack
 401 TEMPLATE,EXPR, untie VARIABLE, unshift ARRAY,LIST, use Module VERSION LIST,
 402 use Module VERSION, use Module LIST, use Module, use VERSION, utime LIST,
 403 values HASH, vec EXPR,OFFSET,BITS, wait, waitpid PID,FLAGS, wantarray, warn
 404 LIST, write FILEHANDLE, write EXPR, write, y///
 405
 406 =back
 407
 408 =back
 409
 410 =head2 perlreftut - Mark's very short tutorial about references
 411
 412 =over 4
 413
 414 =item DESCRIPTION
 415
 416 =item Who Needs Complicated Data Structures?
 417
 418 =item The Solution
 419
 420 =item Syntax
 421
 422 =over 4
 423
 424 =item Making References
 425
 426 =item Using References
 427
 428 =back
 429
 430 =item An Example
 431
 432 =item Arrow Rule
 433
 434 =item Solution
 435
 436 =item The Rest
 437
 438 =item Summary
 439
 440 =item Credits
 441
 442 =over 4
 443
 444 =item Distribution Conditions
 445
 446 =back
 447
 448 =back
 449
 450 =head2 perldsc - Perl Data Structures Cookbook
 451
 452 =over 4
 453
 454 =item DESCRIPTION
 455
 456 arrays of arrays, hashes of arrays, arrays of hashes, hashes of hashes,
 457 more elaborate constructs
 458
 459 =item REFERENCES
 460
 461 =item COMMON MISTAKES
 462
 463 =item CAVEAT ON PRECEDENCE
 464
 465 =item WHY YOU SHOULD ALWAYS C<use strict>
 466
 467 =item DEBUGGING
 468
 469 =item CODE EXAMPLES
 470
 471 =item ARRAYS OF ARRAYS
 472
 473 =over 4
 474
 475 =item Declaration of a ARRAY OF ARRAYS
 476
 477 =item Generation of a ARRAY OF ARRAYS
 478
 479 =item Access and Printing of a ARRAY OF ARRAYS
 480
 481 =back
 482
 483 =item HASHES OF ARRAYS
 484
 485 =over 4
 486
 487 =item Declaration of a HASH OF ARRAYS
 488
 489 =item Generation of a HASH OF ARRAYS
 490
 491 =item Access and Printing of a HASH OF ARRAYS
 492
 493 =back
 494
 495 =item ARRAYS OF HASHES
 496
 497 =over 4
 498
 499 =item Declaration of a ARRAY OF HASHES
 500
 501 =item Generation of a ARRAY OF HASHES
 502
 503 =item Access and Printing of a ARRAY OF HASHES
 504
 505 =back
 506
 507 =item HASHES OF HASHES
 508
 509 =over 4
 510
 511 =item Declaration of a HASH OF HASHES
 512
 513 =item Generation of a HASH OF HASHES
 514
 515 =item Access and Printing of a HASH OF HASHES
 516
 517 =back
 518
 519 =item MORE ELABORATE RECORDS
 520
 521 =over 4
 522
 523 =item Declaration of MORE ELABORATE RECORDS
 524
 525 =item Declaration of a HASH OF COMPLEX RECORDS
 526
 527 =item Generation of a HASH OF COMPLEX RECORDS
 528
 529 =back
 530
 531 =item Database Ties
 532
 533 =item SEE ALSO
 534
 535 =item AUTHOR
 536
 537 =back
 538
 539 =head2 perlrequick - Perl regular expressions quick start
 540
 541 =over 4
 542
 543 =item DESCRIPTION
 544
 545 =item The Guide
 546
 547 =over 4
 548
 549 =item Simple word matching
 550
 551 =item Using character classes
 552
 553 =item Matching this or that
 554
 555 =item Grouping things and hierarchical matching
 556
 557 =item Extracting matches
 558
 559 =item Matching repetitions
 560
 561 =item More matching
 562
 563 =item Search and replace
 564
 565 =item The split operator
 566
 567 =back
 568
 569 =item BUGS
 570
 571 =item SEE ALSO
 572
 573 =item AUTHOR AND COPYRIGHT
 574
 575 =over 4
 576
 577 =item Acknowledgments
 578
 579 =back
 580
 581 =back
 582
 583 =head2 perlpod - plain old documentation
 584
 585 =over 4
 586
 587 =item DESCRIPTION
 588
 589 =over 4
 590
 591 =item Verbatim Paragraph
 592
 593 =item Command Paragraph
 594
 595 =item Ordinary Block of Text
 596
 597 =item The Intent
 598
 599 =item Embedding Pods in Perl Modules
 600
 601 =item Common Pod Pitfalls
 602
 603 =back
 604
 605 =item SEE ALSO
 606
 607 =item AUTHOR
 608
 609 =back
 610
 611 =head2 perlstyle - Perl style guide
 612
 613 =over 4
 614
 615 =item DESCRIPTION
 616
 617 =back
 618
 619 =head2 perltrap - Perl traps for the unwary
 620
 621 =over 4
 622
 623 =item DESCRIPTION
 624
 625 =over 4
 626
 627 =item Awk Traps
 628
 629 =item C Traps
 630
 631 =item Sed Traps
 632
 633 =item Shell Traps
 634
 635 =item Perl Traps
 636
 637 =item Perl4 to Perl5 Traps
 638
 639 Discontinuance, Deprecation, and BugFix traps, Parsing Traps, Numerical
 640 Traps, General data type traps, Context Traps - scalar, list contexts,
 641 Precedence Traps, General Regular Expression Traps using s///, etc,
 642 Subroutine, Signal, Sorting Traps, OS Traps, DBM Traps, Unclassified Traps
 643
 644 =item Discontinuance, Deprecation, and BugFix traps
 645
 646 Discontinuance, Deprecation, BugFix, Discontinuance, Discontinuance,
 647 Discontinuance, BugFix, Discontinuance, Discontinuance, BugFix,
 648 Discontinuance, Deprecation, Discontinuance, Discontinuance
 649
 650 =item Parsing Traps
 651
 652 Parsing, Parsing, Parsing, Parsing
 653
 654 =item Numerical Traps
 655
 656 Numerical, Numerical, Numerical, Bitwise string ops
 657
 658 =item General data type traps
 659
 660 (Arrays), (Arrays), (Hashes), (Globs), (Globs), (Scalar String),
 661 (Constants), (Scalars), (Variable Suicide)
 662
 663 =item Context Traps - scalar, list contexts
 664
 665 (list context), (scalar context), (scalar context), (list, builtin)
 666
 667 =item Precedence Traps
 668
 669 Precedence, Precedence, Precedence, Precedence, Precedence, Precedence,
 670 Precedence
 671
 672 =item General Regular Expression Traps using s///, etc.
 673
 674 Regular Expression, Regular Expression, Regular Expression, Regular
 675 Expression, Regular Expression, Regular Expression, Regular Expression,
 676 Regular Expression
 677
 678 =item Subroutine, Signal, Sorting Traps
 679
 680 (Signals), (Sort Subroutine), warn() won't let you specify a filehandle
 681
 682 =item OS Traps
 683
 684 (SysV), (SysV)
 685
 686 =item Interpolation Traps
 687
 688 Interpolation, Interpolation, Interpolation, Interpolation, Interpolation,
 689 Interpolation, Interpolation, Interpolation, Interpolation
 690
 691 =item DBM Traps
 692
 693 DBM, DBM
 694
 695 =item Unclassified Traps
 696
 697 C<require>/C<do> trap using returned value, C<split> on empty string with
 698 LIMIT specified
 699
 700 =back
 701
 702 =back
 703
 704 =head2 perlrun - how to execute the Perl interpreter
 705
 706 =over 4
 707
 708 =item SYNOPSIS
 709
 710 =item DESCRIPTION
 711
 712 =over 4
 713
 714 =item #! and quoting on non-Unix systems
 715
 716 OS/2, MS-DOS, Win95/NT, Macintosh, VMS
 717
 718 =item Location of Perl
 719
 720 =item Command Switches
 721
 722 B<-0>[I<digits>], B<-a>, B<-C>, B<-c>, B<-d>, B<-d:>I<foo[=bar,baz]>,
 723 B<-D>I<letters>, B<-D>I<number>, B<-e> I<commandline>, B<-F>I<pattern>,
 724 B<-h>, B<-i>[I<extension>], B<-I>I<directory>, B<-l>[I<octnum>],
 725 B<-m>[B<->]I<module>, B<-M>[B<->]I<module>, B<-M>[B<->]I<'module ...'>,
 726 B<-[mM]>[B<->]I<module=arg[,arg]...>, B<-n>, B<-p>, B<-P>, B<-s>, B<-S>,
 727 B<-T>, B<-u>, B<-U>, B<-v>, B<-V>, B<-V:>I<name>, B<-w>, B<-W>, B<-X>,
 728 B<-x> I<directory>
 729
 730 =back
 731
 732 =item ENVIRONMENT
 733
 734 HOME, LOGDIR, PATH, PERL5LIB, PERL5OPT, PERLLIB, PERL5DB, PERL5SHELL
 735 (specific to the Win32 port), PERL_DEBUG_MSTATS, PERL_DESTRUCT_LEVEL,
 736 PERL_ROOT (specific to the VMS port), SYS$LOGIN (specific to the VMS port)
 737
 738 =back
 739
 740 =head2 perldiag - various Perl diagnostics
 741
 742 =over 4
 743
 744 =item DESCRIPTION
 745
 746 =back
 747
 748 =head2 perllexwarn - Perl Lexical Warnings
 749
 750 =over 4
 751
 752 =item DESCRIPTION
 753
 754 =over 4
 755
 756 =item Default Warnings and Optional Warnings
 757
 758 =item What's wrong with B<-w> and C<$^W>
 759
 760 =item Controlling Warnings from the Command Line
 761
 762 B<-w>, B<-W>, B<-X>
 763
 764 =item Backward Compatibility
 765
 766 =item Category Hierarchy
 767
 768 =item Fatal Warnings
 769
 770 =item Reporting Warnings from a Module
 771
 772 =back
 773
 774 =item TODO
 775
 776 =item SEE ALSO
 777
 778 =item AUTHOR
 779
 780 =back
 781
 782 =head2 perldebtut - Perl debugging tutorial
 783
 784 =over 4
 785
 786 =item DESCRIPTION
 787
 788 =item use strict
 789
 790 =item Looking at data and -w and w
 791
 792 =item help
 793
 794 =item Stepping through code
 795
 796 =item Placeholder for a, w, t, T
 797
 798 =item REGULAR EXPRESSIONS
 799
 800 =item OUTPUT TIPS
 801
 802 =item CGI
 803
 804 =item GUIs
 805
 806 =item SUMMARY
 807
 808 =item SEE ALSO
 809
 810 =item AUTHOR
 811
 812 =item CONTRIBUTORS
 813
 814 =back
 815
 816 =head2 perldebug - Perl debugging
 817
 818 =over 4
 819
 820 =item DESCRIPTION
 821
 822 =item The Perl Debugger
 823
 824 =over 4
 825
 826 =item Debugger Commands
 827
 828 h [command], p expr, x expr, V [pkg [vars]], X [vars], T, s [expr], n
 829 [expr], r, <CR>, c [line|sub], l, l min+incr, l min-max, l line, l subname,
 830 -, w [line], f filename, /pattern/, ?pattern?, L, S [[!]regex], t, t expr,
 831 b [line] [condition], b subname [condition], b postpone subname
 832 [condition], b load filename, b compile subname, d [line], D, a [line]
 833 command, a [line], A, W expr, W, O booloption .., O anyoption? .., O
 834 option=value .., < ?, < [ command ], << command, > ?, > command, >>
 835 command, { ?, { [ command ], {{ command, ! number, ! -number, ! pattern, !!
 836 cmd, @ file, H -number, q or ^D, R, |dbcmd, ||dbcmd, command, m expr, man
 837 [manpage]
 838
 839 =item Configurable Options
 840
 841 C<recallCommand>, C<ShellBang>, C<pager>, C<tkRunning>, C<signalLevel>,
 842 C<warnLevel>, C<dieLevel>, C<AutoTrace>, C<LineInfo>, C<inhibit_exit>,
 843 C<PrintRet>, C<ornaments>, C<frame>, C<maxTraceLen>, C<windowSize>,
 844 C<arrayDepth>, C<hashDepth>, C<compactDump>, C<veryCompact>, C<globPrint>,
 845 C<DumpDBFiles>, C<DumpPackages>, C<DumpReused>, C<quote>, C<HighBit>,
 846 C<undefPrint>, C<UsageOnly>, C<TTY>, C<noTTY>, C<ReadLine>, C<NonStop>
 847
 848 =item Debugger input/output
 849
 850 Prompt, Multiline commands, Stack backtrace, Line Listing Format, Frame
 851 listing
 852
 853 =item Debugging compile-time statements
 854
 855 =item Debugger Customization
 856
 857 =item Readline Support
 858
 859 =item Editor Support for Debugging
 860
 861 =item The Perl Profiler
 862
 863 =back
 864
 865 =item Debugging regular expressions
 866
 867 =item Debugging memory usage
 868
 869 =item SEE ALSO
 870
 871 =item BUGS
 872
 873 =back
 874
 875 =head2 perlvar - Perl predefined variables
 876
 877 =over 4
 878
 879 =item DESCRIPTION
 880
 881 =over 4
 882
 883 =item Predefined Names
 884
 885 $ARG, $_, $a, $b, $<I<digits>>, $MATCH, $&, $PREMATCH, $`, $POSTMATCH, $',
 886 $LAST_PAREN_MATCH, $+, $^N, @LAST_MATCH_END, @+, $MULTILINE_MATCHING, $*,
 887 HANDLE->input_line_number(EXPR), $INPUT_LINE_NUMBER, $NR, $,
 888 IO::Handle->input_record_separator(EXPR), $INPUT_RECORD_SEPARATOR, $RS, $/,
 889 HANDLE->autoflush(EXPR), $OUTPUT_AUTOFLUSH, $|,
 890 IO::Handle->output_field_separator EXPR, $OUTPUT_FIELD_SEPARATOR, $OFS, $,,
 891 IO::Handle->output_record_separator EXPR, $OUTPUT_RECORD_SEPARATOR, $ORS,
 892 $\, $LIST_SEPARATOR, $", $SUBSCRIPT_SEPARATOR, $SUBSEP, $;, $OFMT, $#,
 893 HANDLE->format_page_number(EXPR), $FORMAT_PAGE_NUMBER, $%,
 894 HANDLE->format_lines_per_page(EXPR), $FORMAT_LINES_PER_PAGE, $=,
 895 HANDLE->format_lines_left(EXPR), $FORMAT_LINES_LEFT, $-, @LAST_MATCH_START,
 896 @-, C<$`> is the same as C<substr($var, 0, $-[0])>, C<$&> is the same as
 897 C<substr($var, $-[0], $+[0] - $-[0])>, C<$'> is the same as C<substr($var,
 898 $+[0])>, C<$1> is the same as C<substr($var, $-[1], $+[1] - $-[1])>, C<$2>
 899 is the same as C<substr($var, $-[2], $+[2] - $-[2])>, C<$3> is the same as
 900 C<substr $var, $-[3], $+[3] - $-[3])>, HANDLE->format_name(EXPR),
 901 $FORMAT_NAME, $~, HANDLE->format_top_name(EXPR), $FORMAT_TOP_NAME, $^,
 902 IO::Handle->format_line_break_characters EXPR,
 903 $FORMAT_LINE_BREAK_CHARACTERS, $:, IO::Handle->format_formfeed EXPR,
 904 $FORMAT_FORMFEED, $^L, $ACCUMULATOR, $^A, $CHILD_ERROR, $?, $OS_ERROR,
 905 $ERRNO, $!, $EXTENDED_OS_ERROR, $^E, $EVAL_ERROR, $@, $PROCESS_ID, $PID,
 906 $$, $REAL_USER_ID, $UID, $<, $EFFECTIVE_USER_ID, $EUID, $>, $REAL_GROUP_ID,
 907 $GID, $(, $EFFECTIVE_GROUP_ID, $EGID, $), $PROGRAM_NAME, $0, $[, $],
 908 $COMPILING, $^C, $DEBUGGING, $^D, $SYSTEM_FD_MAX, $^F, $^H, %^H,
 909 $INPLACE_EDIT, $^I, $^M, $OSNAME, $^O, $PERLDB, $^P, 0x01, 0x02, 0x04,
 910 0x08, 0x10, 0x20, 0x40, 0x80, 0x100, 0x200, $LAST_REGEXP_CODE_RESULT, $^R,
 911 $EXCEPTIONS_BEING_CAUGHT, $^S, $BASETIME, $^T, $PERL_VERSION, $^V,
 912 $WARNING, $^W, ${^WARNING_BITS}, ${^WIDE_SYSTEM_CALLS}, $EXECUTABLE_NAME,
 913 $^X, ARGV, $ARGV, @ARGV, @F, @INC, @_, %INC, %ENV, $ENV{expr}, %SIG,
 914 $SIG{expr}
 915
 916 =item Error Indicators
 917
 918 =item Technical Note on the Syntax of Variable Names
 919
 920 =back
 921
 922 =item BUGS
 923
 924 =back
 925
 926 =head2 perllol - Manipulating Arrays of Arrays in Perl
 927
 928 =over 4
 929
 930 =item DESCRIPTION
 931
 932 =over 4
 933
 934 =item Declaration and Access of Arrays of Arrays
 935
 936 =item Growing Your Own
 937
 938 =item Access and Printing
 939
 940 =item Slices
 941
 942 =back
 943
 944 =item SEE ALSO
 945
 946 =item AUTHOR
 947
 948 =back
 949
 950 =head2 perlopentut - tutorial on opening things in Perl
 951
 952 =over 4
 953
 954 =item DESCRIPTION
 955
 956 =item Open E<agrave> la shell
 957
 958 =over 4
 959
 960 =item Simple Opens
 961
 962 =item Pipe Opens
 963
 964 =item The Minus File
 965
 966 =item Mixing Reads and Writes
 967
 968 =item Filters
 969
 970 =back
 971
 972 =item Open E<agrave> la C
 973
 974 =over 4
 975
 976 =item Permissions E<agrave> la mode
 977
 978 =back
 979
 980 =item Obscure Open Tricks
 981
 982 =over 4
 983
 984 =item Re-Opening Files (dups)
 985
 986 =item Dispelling the Dweomer
 987
 988 =item Paths as Opens
 989
 990 =item Single Argument Open
 991
 992 =item Playing with STDIN and STDOUT
 993
 994 =back
 995
 996 =item Other I/O Issues
 997
 998 =over 4
 999
1000 =item Opening Non-File Files
1001
1002 =item Binary Files
1003
1004 =item File Locking
1005
1006 =back
1007
1008 =item SEE ALSO
1009
1010 =item AUTHOR and COPYRIGHT
1011
1012 =item HISTORY
1013
1014 =back
1015
1016 =head2 perlretut - Perl regular expressions tutorial
1017
1018 =over 4
1019
1020 =item DESCRIPTION
1021
1022 =item Part 1: The basics
1023
1024 =over 4
1025
1026 =item Simple word matching
1027
1028 =item Using character classes
1029
1030 =item Matching this or that
1031
1032 =item Grouping things and hierarchical matching
1033
1034 =item Extracting matches
1035
1036 =item Matching repetitions
1037
1038 =item Building a regexp
1039
1040 =item Using regular expressions in Perl
1041
1042 =back
1043
1044 =item Part 2: Power tools
1045
1046 =over 4
1047
1048 =item More on characters, strings, and character classes
1049
1050 =item Compiling and saving regular expressions
1051
1052 =item Embedding comments and modifiers in a regular expression
1053
1054 =item Non-capturing groupings
1055
1056 =item Looking ahead and looking behind
1057
1058 =item Using independent subexpressions to prevent backtracking
1059
1060 =item Conditional expressions
1061
1062 =item A bit of magic: executing Perl code in a regular expression
1063
1064 =item Pragmas and debugging
1065
1066 =back
1067
1068 =item BUGS
1069
1070 =item SEE ALSO
1071
1072 =item AUTHOR AND COPYRIGHT
1073
1074 =over 4
1075
1076 =item Acknowledgments
1077
1078 =back
1079
1080 =back
1081
1082 =head2 perlre - Perl regular expressions
1083
1084 =over 4
1085
1086 =item DESCRIPTION
1087
1088 i, m, s, x
1089
1090 =over 4
1091
1092 =item Regular Expressions
1093
1094 cntrl, graph, print, punct, xdigit
1095
1096 =item Extended Patterns
1097
1098 C<(?#text)>, C<(?imsx-imsx)>, C<(?:pattern)>, C<(?imsx-imsx:pattern)>,
1099 C<(?=pattern)>, C<(?!pattern)>, C<(?<=pattern)>, C<(?<!pattern)>, C<(?{
1100 code })>, C<(??{ code })>, C<< (?>pattern) >>,
1101 C<(?(condition)yes-pattern|no-pattern)>, C<(?(condition)yes-pattern)>
1102
1103 =item Backtracking
1104
1105 =item Version 8 Regular Expressions
1106
1107 =item Warning on \1 vs $1
1108
1109 =item Repeated patterns matching zero-length substring
1110
1111 =item Combining pieces together
1112
1113 C<ST>, C<S|T>, C<S{REPEAT_COUNT}>, C<S{min,max}>, C<S{min,max}?>, C<S?>,
1114 C<S*>, C<S+>, C<S??>, C<S*?>, C<S+?>, C<< (?>S) >>, C<(?=S)>, C<(?<=S)>,
1115 C<(?!S)>, C<(?<!S)>, C<(??{ EXPR })>,
1116 C<(?(condition)yes-pattern|no-pattern)>
1117
1118 =item Creating custom RE engines
1119
1120 =back
1121
1122 =item BUGS
1123
1124 =item SEE ALSO
1125
1126 =back
1127
1128 =head2 perlref - Perl references and nested data structures
1129
1130 =over 4
1131
1132 =item NOTE
1133
1134 =item DESCRIPTION
1135
1136 =over 4
1137
1138 =item Making References
1139
1140 =item Using References
1141
1142 =item Symbolic references
1143
1144 =item Not-so-symbolic references
1145
1146 =item Pseudo-hashes: Using an array as a hash
1147
1148 =item Function Templates
1149
1150 =back
1151
1152 =item WARNING
1153
1154 =item SEE ALSO
1155
1156 =back
1157
1158 =head2 perlform - Perl formats
1159
1160 =over 4
1161
1162 =item DESCRIPTION
1163
1164 =over 4
1165
1166 =item Format Variables
1167
1168 =back
1169
1170 =item NOTES
1171
1172 =over 4
1173
1174 =item Footers
1175
1176 =item Accessing Formatting Internals
1177
1178 =back
1179
1180 =item WARNINGS
1181
1182 =back
1183
1184 =head2 perlboot - Beginner's Object-Oriented Tutorial
1185
1186 =over 4
1187
1188 =item DESCRIPTION
1189
1190 =over 4
1191
1192 =item If we could talk to the animals...
1193
1194 =item Introducing the method invocation arrow
1195
1196 =item Invoking a barnyard
1197
1198 =item The extra parameter of method invocation
1199
1200 =item Calling a second method to simplify things
1201
1202 =item Inheriting the windpipes
1203
1204 =item A few notes about @ISA
1205
1206 =item Overriding the methods
1207
1208 =item Starting the search from a different place
1209
1210 =item The SUPER way of doing things
1211
1212 =item Where we're at so far...
1213
1214 =item A horse is a horse, of course of course -- or is it?
1215
1216 =item Invoking an instance method
1217
1218 =item Accessing the instance data
1219
1220 =item How to build a horse
1221
1222 =item Inheriting the constructor
1223
1224 =item Making a method work with either classes or instances
1225
1226 =item Adding parameters to a method
1227
1228 =item More interesting instances
1229
1230 =item A horse of a different color
1231
1232 =item Summary
1233
1234 =back
1235
1236 =item SEE ALSO
1237
1238 =item COPYRIGHT
1239
1240 =back
1241
1242 =head2 perltoot - Tom's object-oriented tutorial for perl
1243
1244 =over 4
1245
1246 =item DESCRIPTION
1247
1248 =item Creating a Class
1249
1250 =over 4
1251
1252 =item Object Representation
1253
1254 =item Class Interface
1255
1256 =item Constructors and Instance Methods
1257
1258 =item Planning for the Future: Better Constructors
1259
1260 =item Destructors
1261
1262 =item Other Object Methods
1263
1264 =back
1265
1266 =item Class Data
1267
1268 =over 4
1269
1270 =item Accessing Class Data
1271
1272 =item Debugging Methods
1273
1274 =item Class Destructors
1275
1276 =item Documenting the Interface
1277
1278 =back
1279
1280 =item Aggregation
1281
1282 =item Inheritance
1283
1284 =over 4
1285
1286 =item Overridden Methods
1287
1288 =item Multiple Inheritance
1289
1290 =item UNIVERSAL: The Root of All Objects
1291
1292 =back
1293
1294 =item Alternate Object Representations
1295
1296 =over 4
1297
1298 =item Arrays as Objects
1299
1300 =item Closures as Objects
1301
1302 =back
1303
1304 =item AUTOLOAD: Proxy Methods
1305
1306 =over 4
1307
1308 =item Autoloaded Data Methods
1309
1310 =item Inherited Autoloaded Data Methods
1311
1312 =back
1313
1314 =item Metaclassical Tools
1315
1316 =over 4
1317
1318 =item Class::Struct
1319
1320 =item Data Members as Variables
1321
1322 =back
1323
1324 =item NOTES
1325
1326 =over 4
1327
1328 =item Object Terminology
1329
1330 =back
1331
1332 =item SEE ALSO
1333
1334 =item AUTHOR AND COPYRIGHT
1335
1336 =item COPYRIGHT
1337
1338 =over 4
1339
1340 =item Acknowledgments
1341
1342 =back
1343
1344 =back
1345
1346 =head2 perltootc - Tom's OO Tutorial for Class Data in Perl
1347
1348 =over 4
1349
1350 =item DESCRIPTION
1351
1352 =item Class Data in a Can
1353
1354 =item Class Data as Package Variables
1355
1356 =over 4
1357
1358 =item Putting All Your Eggs in One Basket
1359
1360 =item Inheritance Concerns
1361
1362 =item The Eponymous Meta-Object
1363
1364 =item Indirect References to Class Data
1365
1366 =item Monadic Classes
1367
1368 =item Translucent Attributes
1369
1370 =back
1371
1372 =item Class Data as Lexical Variables
1373
1374 =over 4
1375
1376 =item Privacy and Responsibility
1377
1378 =item File-Scoped Lexicals
1379
1380 =item More Inheritance Concerns
1381
1382 =item Locking the Door and Throwing Away the Key
1383
1384 =item Translucency Revisited
1385
1386 =back
1387
1388 =item NOTES
1389
1390 =item SEE ALSO
1391
1392 =item AUTHOR AND COPYRIGHT
1393
1394 =item ACKNOWLEDGEMENTS
1395
1396 =item HISTORY
1397
1398 =back
1399
1400 =head2 perlobj - Perl objects
1401
1402 =over 4
1403
1404 =item DESCRIPTION
1405
1406 =over 4
1407
1408 =item An Object is Simply a Reference
1409
1410 =item A Class is Simply a Package
1411
1412 =item A Method is Simply a Subroutine
1413
1414 =item Method Invocation
1415
1416 =item Indirect Object Syntax
1417
1418 =item Default UNIVERSAL methods
1419
1420 isa(CLASS), can(METHOD), VERSION( [NEED] )
1421
1422 =item Destructors
1423
1424 =item Summary
1425
1426 =item Two-Phased Garbage Collection
1427
1428 =back
1429
1430 =item SEE ALSO
1431
1432 =back
1433
1434 =head2 perlbot - Bag'o Object Tricks (the BOT)
1435
1436 =over 4
1437
1438 =item DESCRIPTION
1439
1440 =item OO SCALING TIPS
1441
1442 =item INSTANCE VARIABLES
1443
1444 =item SCALAR INSTANCE VARIABLES
1445
1446 =item INSTANCE VARIABLE INHERITANCE
1447
1448 =item OBJECT RELATIONSHIPS
1449
1450 =item OVERRIDING SUPERCLASS METHODS
1451
1452 =item USING RELATIONSHIP WITH SDBM
1453
1454 =item THINKING OF CODE REUSE
1455
1456 =item CLASS CONTEXT AND THE OBJECT
1457
1458 =item INHERITING A CONSTRUCTOR
1459
1460 =item DELEGATION
1461
1462 =back
1463
1464 =head2 perltie - how to hide an object class in a simple variable
1465
1466 =over 4
1467
1468 =item SYNOPSIS
1469
1470 =item DESCRIPTION
1471
1472 =over 4
1473
1474 =item Tying Scalars
1475
1476 TIESCALAR classname, LIST, FETCH this, STORE this, value, UNTIE this,
1477 DESTROY this
1478
1479 =item Tying Arrays
1480
1481 TIEARRAY classname, LIST, FETCH this, index, STORE this, index, value,
1482 FETCHSIZE this, STORESIZE this, count, EXTEND this, count, EXISTS this,
1483 key, DELETE this, key, CLEAR this, PUSH this, LIST, POP this, SHIFT this,
1484 UNSHIFT this, LIST, SPLICE this, offset, length, LIST, UNTIE this, DESTROY
1485 this
1486
1487 =item Tying Hashes
1488
1489 USER, HOME, CLOBBER, LIST, TIEHASH classname, LIST, FETCH this, key, STORE
1490 this, key, value, DELETE this, key, CLEAR this, EXISTS this, key, FIRSTKEY
1491 this, NEXTKEY this, lastkey, UNTIE this, DESTROY this
1492
1493 =item Tying FileHandles
1494
1495 TIEHANDLE classname, LIST, WRITE this, LIST, PRINT this, LIST, PRINTF this,
1496 LIST, READ this, LIST, READLINE this, GETC this, CLOSE this, UNTIE this,
1497 DESTROY this
1498
1499 =item UNTIE this
1500
1501 =item The C<untie> Gotcha
1502
1503 =back
1504
1505 =item SEE ALSO
1506
1507 =item BUGS
1508
1509 =item AUTHOR
1510
1511 =back
1512
1513 =head2 perlipc - Perl interprocess communication (signals, fifos, pipes,
1514 safe subprocesses, sockets, and semaphores)
1515
1516 =over 4
1517
1518 =item DESCRIPTION
1519
1520 =item Signals
1521
1522 =item Named Pipes
1523
1524 =over 4
1525
1526 =item WARNING
1527
1528 =back
1529
1530 =item Using open() for IPC
1531
1532 =over 4
1533
1534 =item Filehandles
1535
1536 =item Background Processes
1537
1538 =item Complete Dissociation of Child from Parent
1539
1540 =item Safe Pipe Opens
1541
1542 =item Bidirectional Communication with Another Process
1543
1544 =item Bidirectional Communication with Yourself
1545
1546 =back
1547
1548 =item Sockets: Client/Server Communication
1549
1550 =over 4
1551
1552 =item Internet Line Terminators
1553
1554 =item Internet TCP Clients and Servers
1555
1556 =item Unix-Domain TCP Clients and Servers
1557
1558 =back
1559
1560 =item TCP Clients with IO::Socket
1561
1562 =over 4
1563
1564 =item A Simple Client
1565
1566 C<Proto>, C<PeerAddr>, C<PeerPort>
1567
1568 =item A Webget Client
1569
1570 =item Interactive Client with IO::Socket
1571
1572 =back
1573
1574 =item TCP Servers with IO::Socket
1575
1576 Proto, LocalPort, Listen, Reuse
1577
1578 =item UDP: Message Passing
1579
1580 =item SysV IPC
1581
1582 =item NOTES
1583
1584 =item BUGS
1585
1586 =item AUTHOR
1587
1588 =item SEE ALSO
1589
1590 =back
1591
1592 =head2 perlfork - Perl's fork() emulation (EXPERIMENTAL, subject to change)
1593
1594 =over 4
1595
1596 =item SYNOPSIS
1597
1598 =item DESCRIPTION
1599
1600 =over 4
1601
1602 =item Behavior of other Perl features in forked pseudo-processes
1603
1604 $$ or $PROCESS_ID, %ENV, chdir() and all other builtins that accept
1605 filenames, wait() and waitpid(), kill(), exec(), exit(), Open handles to
1606 files, directories and network sockets
1607
1608 =item Resource limits
1609
1610 =item Killing the parent process
1611
1612 =item Lifetime of the parent process and pseudo-processes
1613
1614 =item CAVEATS AND LIMITATIONS
1615
1616 BEGIN blocks, Open filehandles, Forking pipe open() not yet implemented,
1617 Global state maintained by XSUBs, Interpreter embedded in larger
1618 application, Thread-safety of extensions
1619
1620 =back
1621
1622 =item BUGS
1623
1624 =item AUTHOR
1625
1626 =item SEE ALSO
1627
1628 =back
1629
1630 =head2 perlnumber - semantics of numbers and numeric operations in Perl
1631
1632 =over 4
1633
1634 =item SYNOPSIS
1635
1636 =item DESCRIPTION
1637
1638 =item Storing numbers
1639
1640 =item Numeric operators and numeric conversions
1641
1642 =item Flavors of Perl numeric operations
1643
1644 Arithmetic operators except, C<no integer>, Arithmetic operators except,
1645 C<use integer>, Bitwise operators, C<no integer>, Bitwise operators, C<use
1646 integer>, Operators which expect an integer, Operators which expect a
1647 string
1648
1649 =item AUTHOR
1650
1651 =item SEE ALSO
1652
1653 =back
1654
1655 =head2 perlthrtut - tutorial on threads in Perl
1656
1657 =over 4
1658
1659 =item DESCRIPTION
1660
1661 =back
1662
1663 =head2 perlothrtut - old tutorial on threads in Perl
1664
1665 =over 4
1666
1667 =item DESCRIPTION
1668
1669 =item What Is A Thread Anyway?
1670
1671 =item Threaded Program Models
1672
1673 =over 4
1674
1675 =item Boss/Worker
1676
1677 =item Work Crew
1678
1679 =item Pipeline
1680
1681 =back
1682
1683 =item Native threads
1684
1685 =item What kind of threads are perl threads?
1686
1687 =item Threadsafe Modules
1688
1689 =item Thread Basics
1690
1691 =over 4
1692
1693 =item Basic Thread Support
1694
1695 =item Creating Threads
1696
1697 =item Giving up control
1698
1699 =item Waiting For A Thread To Exit
1700
1701 =item Errors In Threads
1702
1703 =item Ignoring A Thread
1704
1705 =back
1706
1707 =item Threads And Data
1708
1709 =over 4
1710
1711 =item Shared And Unshared Data
1712
1713 =item Thread Pitfall: Races
1714
1715 =item Controlling access: lock()
1716
1717 =item Thread Pitfall: Deadlocks
1718
1719 =item Queues: Passing Data Around
1720
1721 =back
1722
1723 =item Threads And Code
1724
1725 =over 4
1726
1727 =item Semaphores: Synchronizing Data Access
1728
1729 Basic semaphores, Advanced Semaphores
1730
1731 =item Attributes: Restricting Access To Subroutines
1732
1733 =item Subroutine Locks
1734
1735 =item Methods
1736
1737 =item Locking A Subroutine
1738
1739 =back
1740
1741 =item General Thread Utility Routines
1742
1743 =over 4
1744
1745 =item What Thread Am I In?
1746
1747 =item Thread IDs
1748
1749 =item Are These Threads The Same?
1750
1751 =item What Threads Are Running?
1752
1753 =back
1754
1755 =item A Complete Example
1756
1757 =item Conclusion
1758
1759 =item Bibliography
1760
1761 =over 4
1762
1763 =item Introductory Texts
1764
1765 =item OS-Related References
1766
1767 =item Other References
1768
1769 =back
1770
1771 =item Acknowledgements
1772
1773 =item AUTHOR
1774
1775 =item Copyrights
1776
1777 =back
1778
1779 =head2 perlport - Writing portable Perl
1780
1781 =over 4
1782
1783 =item DESCRIPTION
1784
1785 Not all Perl programs have to be portable, Nearly all of Perl already I<is>
1786 portable
1787
1788 =item ISSUES
1789
1790 =over 4
1791
1792 =item Newlines
1793
1794 =item Numbers endianness and Width
1795
1796 =item Files and Filesystems
1797
1798 =item System Interaction
1799
1800 =item Interprocess Communication (IPC)
1801
1802 =item External Subroutines (XS)
1803
1804 =item Standard Modules
1805
1806 =item Time and Date
1807
1808 =item Character sets and character encoding
1809
1810 =item Internationalisation
1811
1812 =item System Resources
1813
1814 =item Security
1815
1816 =item Style
1817
1818 =back
1819
1820 =item CPAN Testers
1821
1822 Mailing list: cpan-testers@perl.org, Testing results:
1823 http://testers.cpan.org/
1824
1825 =item PLATFORMS
1826
1827 =over 4
1828
1829 =item Unix
1830
1831 =item DOS and Derivatives
1832
1833 =item S<Mac OS>
1834
1835 =item VMS
1836
1837 =item VOS
1838
1839 =item EBCDIC Platforms
1840
1841 =item Acorn RISC OS
1842
1843 =item Other perls
1844
1845 =back
1846
1847 =item FUNCTION IMPLEMENTATIONS
1848
1849 =over 4
1850
1851 =item Alphabetical Listing of Perl Functions
1852
1853 -I<X> FILEHANDLE, -I<X> EXPR, -I<X>, alarm SECONDS, alarm, binmode
1854 FILEHANDLE, chmod LIST, chown LIST, chroot FILENAME, chroot, crypt
1855 PLAINTEXT,SALT, dbmclose HASH, dbmopen HASH,DBNAME,MODE, dump LABEL, exec
1856 LIST, fcntl FILEHANDLE,FUNCTION,SCALAR, flock FILEHANDLE,OPERATION, fork,
1857 getlogin, getpgrp PID, getppid, getpriority WHICH,WHO, getpwnam NAME,
1858 getgrnam NAME, getnetbyname NAME, getpwuid UID, getgrgid GID, getnetbyaddr
1859 ADDR,ADDRTYPE, getprotobynumber NUMBER, getservbyport PORT,PROTO, getpwent,
1860 getgrent, gethostent, getnetent, getprotoent, getservent, setpwent,
1861 setgrent, sethostent STAYOPEN, setnetent STAYOPEN, setprotoent STAYOPEN,
1862 setservent STAYOPEN, endpwent, endgrent, endhostent, endnetent,
1863 endprotoent, endservent, exit EXPR, exit, getsockopt SOCKET,LEVEL,OPTNAME,
1864 glob EXPR, glob, ioctl FILEHANDLE,FUNCTION,SCALAR, kill SIGNAL, LIST, link
1865 OLDFILE,NEWFILE, lstat FILEHANDLE, lstat EXPR, lstat, msgctl ID,CMD,ARG,
1866 msgget KEY,FLAGS, msgsnd ID,MSG,FLAGS, msgrcv ID,VAR,SIZE,TYPE,FLAGS, open
1867 FILEHANDLE,EXPR, open FILEHANDLE, pipe READHANDLE,WRITEHANDLE, readlink
1868 EXPR, readlink, select RBITS,WBITS,EBITS,TIMEOUT, semctl ID,SEMNUM,CMD,ARG,
1869 semget KEY,NSEMS,FLAGS, semop KEY,OPSTRING, setgrent, setpgrp PID,PGRP,
1870 setpriority WHICH,WHO,PRIORITY, setpwent, setsockopt
1871 SOCKET,LEVEL,OPTNAME,OPTVAL, shmctl ID,CMD,ARG, shmget KEY,SIZE,FLAGS,
1872 shmread ID,VAR,POS,SIZE, shmwrite ID,STRING,POS,SIZE, sockatmark SOCKET,
1873 socketpair SOCKET1,SOCKET2,DOMAIN,TYPE,PROTOCOL, stat FILEHANDLE, stat
1874 EXPR, stat, symlink OLDFILE,NEWFILE, syscall LIST, sysopen
1875 FILEHANDLE,FILENAME,MODE,PERMS, system LIST, times, truncate
1876 FILEHANDLE,LENGTH, truncate EXPR,LENGTH, umask EXPR, umask, utime LIST,
1877 wait, waitpid PID,FLAGS
1878
1879 =back
1880
1881 =item CHANGES
1882
1883 v1.48, 02 February 2001, v1.47, 22 March 2000, v1.46, 12 February 2000,
1884 v1.45, 20 December 1999, v1.44, 19 July 1999, v1.43, 24 May 1999, v1.42, 22
1885 May 1999, v1.41, 19 May 1999, v1.40, 11 April 1999, v1.39, 11 February
1886 1999, v1.38, 31 December 1998, v1.37, 19 December 1998, v1.36, 9 September
1887 1998, v1.35, 13 August 1998, v1.33, 06 August 1998, v1.32, 05 August 1998,
1888 v1.30, 03 August 1998, v1.23, 10 July 1998
1889
1890 =item Supported Platforms
1891
1892 =item SEE ALSO
1893
1894 =item AUTHORS / CONTRIBUTORS
1895
1896 =item VERSION
1897
1898 =back
1899
1900 =head2 perllocale - Perl locale handling (internationalization and
1901 localization)
1902
1903 =over 4
1904
1905 =item DESCRIPTION
1906
1907 =item PREPARING TO USE LOCALES
1908
1909 =item USING LOCALES
1910
1911 =over 4
1912
1913 =item The use locale pragma
1914
1915 =item The setlocale function
1916
1917 =item Finding locales
1918
1919 =item LOCALE PROBLEMS
1920
1921 =item Temporarily fixing locale problems
1922
1923 =item Permanently fixing locale problems
1924
1925 =item Permanently fixing your system's locale configuration
1926
1927 =item Fixing system locale configuration
1928
1929 =item The localeconv function
1930
1931 =item I18N::Langinfo
1932
1933 =back
1934
1935 =item LOCALE CATEGORIES
1936
1937 =over 4
1938
1939 =item Category LC_COLLATE: Collation
1940
1941 =item Category LC_CTYPE: Character Types
1942
1943 =item Category LC_NUMERIC: Numeric Formatting
1944
1945 =item Category LC_MONETARY: Formatting of monetary amounts
1946
1947 =item LC_TIME
1948
1949 =item Other categories
1950
1951 =back
1952
1953 =item SECURITY
1954
1955 =item ENVIRONMENT
1956
1957 PERL_BADLANG, LC_ALL, LANGUAGE, LC_CTYPE, LC_COLLATE, LC_MONETARY,
1958 LC_NUMERIC, LC_TIME, LANG
1959
1960 =item NOTES
1961
1962 =over 4
1963
1964 =item Backward compatibility
1965
1966 =item I18N:Collate obsolete
1967
1968 =item Sort speed and memory use impacts
1969
1970 =item write() and LC_NUMERIC
1971
1972 =item Freely available locale definitions
1973
1974 =item I18n and l10n
1975
1976 =item An imperfect standard
1977
1978 =back
1979
1980 =item BUGS
1981
1982 =over 4
1983
1984 =item Broken systems
1985
1986 =back
1987
1988 =item SEE ALSO
1989
1990 =item HISTORY
1991
1992 =back
1993
1994 =head2 perlunicode - Unicode support in Perl
1995
1996 =over 4
1997
1998 =item DESCRIPTION
1999
2000 =over 4
2001
2002 =item Important Caveats
2003
2004 Input and Output Disciplines, Regular Expressions, C<use utf8> still needed
2005 to enable UTF-8/UTF-EBCDIC in scripts
2006
2007 =item Byte and Character semantics
2008
2009 =item Effects of character semantics
2010
2011 =item Scripts
2012
2013 =item Blocks
2014
2015 =item Character encodings for input and output
2016
2017 =back
2018
2019 =item CAVEATS
2020
2021 =item UNICODE REGULAR EXPRESSION SUPPORT LEVEL
2022
2023 =item SEE ALSO
2024
2025 =back
2026
2027 =head2 perlebcdic - Considerations for running Perl on EBCDIC platforms
2028
2029 =over 4
2030
2031 =item DESCRIPTION
2032
2033 =item COMMON CHARACTER CODE SETS
2034
2035 =over 4
2036
2037 =item ASCII
2038
2039 =item ISO 8859
2040
2041 =item Latin 1 (ISO 8859-1)
2042
2043 =item EBCDIC
2044
2045 =item 13 variant characters
2046
2047 =item 0037
2048
2049 =item 1047
2050
2051 =item POSIX-BC
2052
2053 =item Unicode and UTF
2054
2055 =back
2056
2057 =item SINGLE OCTET TABLES
2058
2059 recipe 0, recipe 1, recipe 2, recipe 3, recipe 4, recipe 5, recipe 6
2060
2061 =item IDENTIFYING CHARACTER CODE SETS
2062
2063 =item CONVERSIONS
2064
2065 =over 4
2066
2067 =item tr///
2068
2069 =item iconv
2070
2071 =item C RTL
2072
2073 =back
2074
2075 =item OPERATOR DIFFERENCES
2076
2077 =item FUNCTION DIFFERENCES
2078
2079 chr(), ord(), pack(), print(), printf(), sort(), sprintf(), unpack()
2080
2081 =item REGULAR EXPRESSION DIFFERENCES
2082
2083 =item SOCKETS
2084
2085 =item SORTING
2086
2087 =over 4
2088
2089 =item Ignore ASCII vs. EBCDIC sort differences.
2090
2091 =item MONO CASE then sort data.
2092
2093 =item Convert, sort data, then re convert.
2094
2095 =item Perform sorting on one type of machine only.
2096
2097 =back
2098
2099 =item TRANSFORMATION FORMATS
2100
2101 =over 4
2102
2103 =item URL decoding and encoding
2104
2105 =item uu encoding and decoding
2106
2107 =item Quoted-Printable encoding and decoding
2108
2109 =item Caesarian ciphers
2110
2111 =back
2112
2113 =item Hashing order and checksums
2114
2115 =item I18N AND L10N
2116
2117 =item MULTI OCTET CHARACTER SETS
2118
2119 =item OS ISSUES
2120
2121 =over 4
2122
2123 =item OS/400
2124
2125 IFS access
2126
2127 =item OS/390, z/OS
2128
2129 chcp, dataset access, OS/390, z/OS iconv, locales
2130
2131 =item VM/ESA?
2132
2133 =item POSIX-BC?
2134
2135 =back
2136
2137 =item BUGS
2138
2139 =item SEE ALSO
2140
2141 =item REFERENCES
2142
2143 =item HISTORY
2144
2145 =item AUTHOR
2146
2147 =back
2148
2149 =head2 perlsec - Perl security
2150
2151 =over 4
2152
2153 =item DESCRIPTION
2154
2155 =over 4
2156
2157 =item Laundering and Detecting Tainted Data
2158
2159 =item Switches On the "#!" Line
2160
2161 =item Cleaning Up Your Path
2162
2163 =item Security Bugs
2164
2165 =item Protecting Your Programs
2166
2167 =back
2168
2169 =item SEE ALSO
2170
2171 =back
2172
2173 =head2 perlmod - Perl modules (packages and symbol tables)
2174
2175 =over 4
2176
2177 =item DESCRIPTION
2178
2179 =over 4
2180
2181 =item Packages
2182
2183 =item Symbol Tables
2184
2185 =item Package Constructors and Destructors
2186
2187 =item Perl Classes
2188
2189 =item Perl Modules
2190
2191 =item Making your module threadsafe
2192
2193 =back
2194
2195 =item SEE ALSO
2196
2197 =back
2198
2199 =head2 perlmodlib - constructing new Perl modules and finding existing ones
2200
2201 =over 4
2202
2203 =item DESCRIPTION
2204
2205 =item THE PERL MODULE LIBRARY
2206
2207 =over 4
2208
2209 =item Pragmatic Modules
2210
2211 attributes, attrs, autouse, base, blib, bytes, charnames, constant,
2212 diagnostics, fields, filetest, integer, less, locale, open, ops, overload,
2213 re, sigtrap, strict, subs, threads, utf8, vars, warnings,
2214 warnings::register
2215
2216 =item Standard Modules
2217
2218 AnyDBM_File, Attribute::Handlers, AutoLoader, AutoSplit, B, B::Asmdata,
2219 B::Assembler, B::Bblock, B::Bytecode, B::C, B::CC, B::Concise, B::Debug,
2220 B::Deparse, B::Disassembler, B::Lint, B::Showlex, B::Stackobj, B::Stash,
2221 B::Terse, B::Xref, Benchmark, ByteLoader, CGI, CGI::Apache, CGI::Carp,
2222 CGI::Cookie, CGI::Fast, CGI::Pretty, CGI::Push, CGI::Switch, CGI::Util,
2223 CPAN, CPAN::FirstTime, CPAN::Nox, Carp, Carp::Heavy, Class::ISA,
2224 Class::Struct, Cwd, DB, DB_File, Devel::SelfStubber, Digest, DirHandle,
2225 Dumpvalue, Encode, Encode::EncodeFormat, Encode::Tcl, English, Env,
2226 Exporter, Exporter::Heavy, ExtUtils::Command, ExtUtils::Constant,
2227 ExtUtils::Embed, ExtUtils::Install, ExtUtils::Installed, ExtUtils::Liblist,
2228 ExtUtils::MM_Cygwin, ExtUtils::MM_NW5, ExtUtils::MM_OS2, ExtUtils::MM_Unix,
2229 ExtUtils::MM_VMS, ExtUtils::MM_Win32, ExtUtils::MakeMaker,
2230 ExtUtils::Manifest, ExtUtils::Mkbootstrap, ExtUtils::Mksymlists,
2231 ExtUtils::Packlist, ExtUtils::testlib, Fatal, Fcntl, File::Basename,
2232 File::CheckTree, File::Compare, File::Copy, File::DosGlob, File::Find,
2233 File::Path, File::Spec, File::Spec::Epoc, File::Spec::Functions,
2234 File::Spec::Mac, File::Spec::OS2, File::Spec::Unix, File::Spec::VMS,
2235 File::Spec::Win32, File::Temp, File::stat, FileCache, FileHandle,
2236 Filter::Simple, FindBin, Getopt::Long, Getopt::Std, I18N::Collate,
2237 I18N::LangTags, I18N::LangTags::List, IO, IPC::Open2, IPC::Open3,
2238 Lingua::KO::Hangul::Util, Locale::Constants, Locale::Country,
2239 Locale::Currency, Locale::Language, Locale::Maketext,
2240 Locale::Maketext::TPJ13, Math::BigFloat, Math::BigInt, Math::BigInt::Calc,
2241 Math::Complex, Math::Trig, Memoize, Memoize::AnyDBM_File, Memoize::Expire,
2242 Memoize::ExpireFile, Memoize::ExpireTest, Memoize::NDBM_File,
2243 Memoize::SDBM_File, Memoize::Saves, Memoize::Storable, NDBM_File, NEXT,
2244 Net::Cmd, Net::Config, Net::Domain, Net::FTP, Net::NNTP, Net::Netrc,
2245 Net::POP3, Net::Ping, Net::SMTP, Net::Time, Net::hostent, Net::libnetFAQ,
2246 Net::netent, Net::protoent, Net::servent, O, ODBM_File, Opcode, POSIX,
2247 PerlIO, Pod::Checker, Pod::Find, Pod::Html, Pod::InputObjects, Pod::LaTeX,
2248 Pod::Man, Pod::ParseUtils, Pod::Parser, Pod::Plainer, Pod::Select,
2249 Pod::Text, Pod::Text::Color, Pod::Text::Overstrike, Pod::Text::Termcap,
2250 Pod::Usage, SDBM_File, Safe, Search::Dict, SelectSaver, SelfLoader, Shell,
2251 Socket, Storable, Switch, Symbol, Term::ANSIColor, Term::Cap,
2252 Term::Complete, Term::ReadLine, Test, Test::Harness, Test::More,
2253 Test::Simple, Test::Tutorial, Text::Abbrev, Text::Balanced,
2254 Text::ParseWords, Text::Soundex, Text::Tabs, Text::Wrap, Tie::Array,
2255 Tie::Handle, Tie::Hash, Tie::RefHash, Tie::Scalar, Tie::SubstrHash,
2256 Time::Local, Time::gmtime, Time::localtime, Time::tm, UNIVERSAL,
2257 Unicode::Collate, Unicode::Normalize, Unicode::UCD, User::grent,
2258 User::pwent, Win32
2259
2260 =item Extension Modules
2261
2262 =back
2263
2264 =item CPAN
2265
2266 =over 4
2267
2268 =item Africa
2269
2270 =item Asia
2271
2272 =item Central America
2273
2274 =item Europe
2275
2276 =item North America
2277
2278 =item Oceania
2279
2280 =item South America
2281
2282 =back
2283
2284 =item Modules: Creation, Use, and Abuse
2285
2286 =over 4
2287
2288 =item Guidelines for Module Creation
2289
2290 Adding a Copyright Notice
2291
2292 =item Guidelines for Converting Perl 4 Library Scripts into Modules
2293
2294 =item Guidelines for Reusing Application Code
2295
2296 =back
2297
2298 =item NOTE
2299
2300 =back
2301
2302 =head2 perlmodinstall - Installing CPAN Modules
2303
2304 =over 4
2305
2306 =item DESCRIPTION
2307
2308 =over 4
2309
2310 =item PREAMBLE
2311
2312 B<DECOMPRESS> the file, B<UNPACK> the file into a directory, B<BUILD> the
2313 module (sometimes unnecessary), B<INSTALL> the module
2314
2315 =back
2316
2317 =item PORTABILITY
2318
2319 =item HEY
2320
2321 =item AUTHOR
2322
2323 =item COPYRIGHT
2324
2325 =back
2326
2327 =head2 perlnewmod - preparing a new module for distribution
2328
2329 =over 4
2330
2331 =item DESCRIPTION
2332
2333 =over 4
2334
2335 =item Warning
2336
2337 =item What should I make into a module?
2338
2339 =item Step-by-step: Preparing the ground
2340
2341 Look around, Check it's new, Discuss the need, Choose a name, Check again
2342
2343 =item Step-by-step: Making the module
2344
2345 Start with F<h2xs>, Use L<strict|strict> and L<warnings|warnings>, Use
2346 L<Carp|Carp>, Use L<Exporter|Exporter> - wisely!, Use L<plain old
2347 documentation|perlpod>, Write tests, Write the README
2348
2349 =item Step-by-step: Distributing your module
2350
2351 Get a CPAN user ID, C<perl Makefile.PL; make test; make dist>, Upload the
2352 tarball, Announce to the modules list, Announce to clpa, Fix bugs!
2353
2354 =back
2355
2356 =item AUTHOR
2357
2358 =item SEE ALSO
2359
2360 =back
2361
2362 =head2 perlfaq1 - General Questions About Perl ($Revision: 1.1 $, $Date:
2363 2001/09/20 03:03:00 $)
2364
2365 =over 4
2366
2367 =item DESCRIPTION
2368
2369 =over 4
2370
2371 =item What is Perl?
2372
2373 =item Who supports Perl?  Who develops it?  Why is it free?
2374
2375 =item Which version of Perl should I use?
2376
2377 =item What are perl4 and perl5?
2378
2379 =item What is perl6?
2380
2381 =item How stable is Perl?
2382
2383 =item Is Perl difficult to learn?
2384
2385 =item How does Perl compare with other languages like Java, Python, REXX,
2386 Scheme, or Tcl?
2387
2388 =item Can I do [task] in Perl?
2389
2390 =item When shouldn't I program in Perl?
2391
2392 =item What's the difference between "perl" and "Perl"?
2393
2394 =item Is it a Perl program or a Perl script?
2395
2396 =item What is a JAPH?
2397
2398 =item Where can I get a list of Larry Wall witticisms?
2399
2400 =item How can I convince my sysadmin/supervisor/employees to use version
2401 5/5.005/Perl instead of some other language?
2402
2403 =back
2404
2405 =item AUTHOR AND COPYRIGHT
2406
2407 =back
2408
2409 =head2 perlfaq2 - Obtaining and Learning about Perl ($Revision: 1.1 $,
2410 $Date: 2001/09/20 03:03:00 $)
2411
2412 =over 4
2413
2414 =item DESCRIPTION
2415
2416 =over 4
2417
2418 =item What machines support Perl?  Where do I get it?
2419
2420 =item How can I get a binary version of Perl?
2421
2422 =item I don't have a C compiler on my system.  How can I compile perl?
2423
2424 =item I copied the Perl binary from one machine to another, but scripts
2425 don't work.
2426
2427 =item I grabbed the sources and tried to compile but gdbm/dynamic
2428 loading/malloc/linking/... failed.  How do I make it work?
2429
2430 =item What modules and extensions are available for Perl?  What is CPAN?
2431 What does CPAN/src/... mean?
2432
2433 =item Is there an ISO or ANSI certified version of Perl?
2434
2435 =item Where can I get information on Perl?
2436
2437 =item What are the Perl newsgroups on Usenet?  Where do I post questions?
2438
2439 =item Where should I post source code?
2440
2441 =item Perl Books
2442
2443 References, Tutorials, Task-Oriented, Special Topics
2444
2445 =item Perl in Magazines
2446
2447 =item Perl on the Net: FTP and WWW Access
2448
2449 =item What mailing lists are there for Perl?
2450
2451 =item Archives of comp.lang.perl.misc
2452
2453 =item Where can I buy a commercial version of Perl?
2454
2455 =item Where do I send bug reports?
2456
2457 =item What is perl.com? Perl Mongers? pm.org? perl.org?
2458
2459 =back
2460
2461 =item AUTHOR AND COPYRIGHT
2462
2463 =back
2464
2465 =head2 perlfaq3 - Programming Tools ($Revision: 1.1 $, $Date: 2001/09/20
2466 03:03:00 $)
2467
2468 =over 4
2469
2470 =item DESCRIPTION
2471
2472 =over 4
2473
2474 =item How do I do (anything)?
2475
2476 =item How can I use Perl interactively?
2477
2478 =item Is there a Perl shell?
2479
2480 =item How do I debug my Perl programs?
2481
2482 =item How do I profile my Perl programs?
2483
2484 =item How do I cross-reference my Perl programs?
2485
2486 =item Is there a pretty-printer (formatter) for Perl?
2487
2488 =item Is there a ctags for Perl?
2489
2490 =item Is there an IDE or Windows Perl Editor?
2491
2492 Komodo, The Object System, Open Perl IDE, PerlBuilder, visiPerl+,
2493 CodeMagicCD, GNU Emacs, MicroEMACS, XEmacs, Elvis, Vile, Vim, Codewright,
2494 MultiEdit, SlickEdit, Bash, Ksh, Tcsh, Zsh, BBEdit and BBEdit Lite, Alpha
2495
2496 =item Where can I get Perl macros for vi?
2497
2498 =item Where can I get perl-mode for emacs?
2499
2500 =item How can I use curses with Perl?
2501
2502 =item How can I use X or Tk with Perl?
2503
2504 =item How can I generate simple menus without using CGI or Tk?
2505
2506 =item What is undump?
2507
2508 =item How can I make my Perl program run faster?
2509
2510 =item How can I make my Perl program take less memory?
2511
2512 =item Is it unsafe to return a pointer to local data?
2513
2514 =item How can I free an array or hash so my program shrinks?
2515
2516 =item How can I make my CGI script more efficient?
2517
2518 =item How can I hide the source for my Perl program?
2519
2520 =item How can I compile my Perl program into byte code or C?
2521
2522 =item How can I compile Perl into Java?
2523
2524 =item How can I get C<#!perl> to work on [MS-DOS,NT,...]?
2525
2526 =item Can I write useful Perl programs on the command line?
2527
2528 =item Why don't Perl one-liners work on my DOS/Mac/VMS system?
2529
2530 =item Where can I learn about CGI or Web programming in Perl?
2531
2532 =item Where can I learn about object-oriented Perl programming?
2533
2534 =item Where can I learn about linking C with Perl? [h2xs, xsubpp]
2535
2536 =item I've read perlembed, perlguts, etc., but I can't embed perl in
2537 my C program; what am I doing wrong?
2538
2539 =item When I tried to run my script, I got this message. What does it
2540 mean?
2541
2542 =item What's MakeMaker?
2543
2544 =back
2545
2546 =item AUTHOR AND COPYRIGHT
2547
2548 =back
2549
2550 =head2 perlfaq4 - Data Manipulation ($Revision: 1.1 $, $Date: 2001/09/20
2551 03:03:00 $)
2552
2553 =over 4
2554
2555 =item DESCRIPTION
2556
2557 =item Data: Numbers
2558
2559 =over 4
2560
2561 =item Why am I getting long decimals (eg, 19.9499999999999) instead of the
2562 numbers I should be getting (eg, 19.95)?
2563
2564 =item Why isn't my octal data interpreted correctly?
2565
2566 =item Does Perl have a round() function?  What about ceil() and floor()?
2567 Trig functions?
2568
2569 =item How do I convert bits into ints?
2570
2571 =item Why doesn't & work the way I want it to?
2572
2573 =item How do I multiply matrices?
2574
2575 =item How do I perform an operation on a series of integers?
2576
2577 =item How can I output Roman numerals?
2578
2579 =item Why aren't my random numbers random?
2580
2581 =back
2582
2583 =item Data: Dates
2584
2585 =over 4
2586
2587 =item How do I find the week-of-the-year/day-of-the-year?
2588
2589 =item How do I find the current century or millennium?
2590
2591 =item How can I compare two dates and find the difference?
2592
2593 =item How can I take a string and turn it into epoch seconds?
2594
2595 =item How can I find the Julian Day?
2596
2597 =item How do I find yesterday's date?
2598
2599 =item Does Perl have a Year 2000 problem?  Is Perl Y2K compliant?
2600
2601 =back
2602
2603 =item Data: Strings
2604
2605 =over 4
2606
2607 =item How do I validate input?
2608
2609 =item How do I unescape a string?
2610
2611 =item How do I remove consecutive pairs of characters?
2612
2613 =item How do I expand function calls in a string?
2614
2615 =item How do I find matching/nesting anything?
2616
2617 =item How do I reverse a string?
2618
2619 =item How do I expand tabs in a string?
2620
2621 =item How do I reformat a paragraph?
2622
2623 =item How can I access/change the first N letters of a string?
2624
2625 =item How do I change the Nth occurrence of something?
2626
2627 =item How can I count the number of occurrences of a substring within a
2628 string?
2629
2630 =item How do I capitalize all the words on one line?
2631
2632 =item How can I split a [character] delimited string except when inside
2633 [character]? (Comma-separated files)
2634
2635 =item How do I strip blank space from the beginning/end of a string?
2636
2637 =item How do I pad a string with blanks or pad a number with zeroes?
2638
2639 =item How do I extract selected columns from a string?
2640
2641 =item How do I find the soundex value of a string?
2642
2643 =item How can I expand variables in text strings?
2644
2645 =item What's wrong with always quoting "$vars"?
2646
2647 =item Why don't my <<HERE documents work?
2648
2649 1. There must be no space after the << part, 2. There (probably) should be
2650 a semicolon at the end, 3. You can't (easily) have any space in front of
2651 the tag
2652
2653 =back
2654
2655 =item Data: Arrays
2656
2657 =over 4
2658
2659 =item What is the difference between a list and an array?
2660
2661 =item What is the difference between $array[1] and @array[1]?
2662
2663 =item How can I remove duplicate elements from a list or array?
2664
2665 a), b), c), d), e)
2666
2667 =item How can I tell whether a certain element is contained in a list or
2668 array?
2669
2670 =item How do I compute the difference of two arrays?  How do I compute the
2671 intersection of two arrays?
2672
2673 =item How do I test whether two arrays or hashes are equal?
2674
2675 =item How do I find the first array element for which a condition is true?
2676
2677 =item How do I handle linked lists?
2678
2679 =item How do I handle circular lists?
2680
2681 =item How do I shuffle an array randomly?
2682
2683 =item How do I process/modify each element of an array?
2684
2685 =item How do I select a random element from an array?
2686
2687 =item How do I permute N elements of a list?
2688
2689 =item How do I sort an array by (anything)?
2690
2691 =item How do I manipulate arrays of bits?
2692
2693 =item Why does defined() return true on empty arrays and hashes?
2694
2695 =back
2696
2697 =item Data: Hashes (Associative Arrays)
2698
2699 =over 4
2700
2701 =item How do I process an entire hash?
2702
2703 =item What happens if I add or remove keys from a hash while iterating over
2704 it?
2705
2706 =item How do I look up a hash element by value?
2707
2708 =item How can I know how many entries are in a hash?
2709
2710 =item How do I sort a hash (optionally by value instead of key)?
2711
2712 =item How can I always keep my hash sorted?
2713
2714 =item What's the difference between "delete" and "undef" with hashes?
2715
2716 =item Why don't my tied hashes make the defined/exists distinction?
2717
2718 =item How do I reset an each() operation part-way through?
2719
2720 =item How can I get the unique keys from two hashes?
2721
2722 =item How can I store a multidimensional array in a DBM file?
2723
2724 =item How can I make my hash remember the order I put elements into it?
2725
2726 =item Why does passing a subroutine an undefined element in a hash create
2727 it?
2728
2729 =item How can I make the Perl equivalent of a C structure/C++ class/hash or
2730 array of hashes or arrays?
2731
2732 =item How can I use a reference as a hash key?
2733
2734 =back
2735
2736 =item Data: Misc
2737
2738 =over 4
2739
2740 =item How do I handle binary data correctly?
2741
2742 =item How do I determine whether a scalar is a number/whole/integer/float?
2743
2744 =item How do I keep persistent data across program calls?
2745
2746 =item How do I print out or copy a recursive data structure?
2747
2748 =item How do I define methods for every class/object?
2749
2750 =item How do I verify a credit card checksum?
2751
2752 =item How do I pack arrays of doubles or floats for XS code?
2753
2754 =back
2755
2756 =item AUTHOR AND COPYRIGHT
2757
2758 =back
2759
2760 =head2 perlfaq5 - Files and Formats ($Revision: 1.1 $, $Date: 2001/09/20
2761 03:03:00 $)
2762
2763 =over 4
2764
2765 =item DESCRIPTION
2766
2767 =over 4
2768
2769 =item How do I flush/unbuffer an output filehandle?  Why must I do this?
2770
2771 =item How do I change one line in a file/delete a line in a file/insert a
2772 line in the middle of a file/append to the beginning of a file?
2773
2774 =item How do I count the number of lines in a file?
2775
2776 =item How do I make a temporary file name?
2777
2778 =item How can I manipulate fixed-record-length files?
2779
2780 =item How can I make a filehandle local to a subroutine?  How do I pass
2781 filehandles between subroutines?  How do I make an array of filehandles?
2782
2783 =item How can I use a filehandle indirectly?
2784
2785 =item How can I set up a footer format to be used with write()?
2786
2787 =item How can I write() into a string?
2788
2789 =item How can I output my numbers with commas added?
2790
2791 =item How can I translate tildes (~) in a filename?
2792
2793 =item How come when I open a file read-write it wipes it out?
2794
2795 =item Why do I sometimes get an "Argument list too long" when I use <*>?
2796
2797 =item Is there a leak/bug in glob()?
2798
2799 =item How can I open a file with a leading ">" or trailing blanks?
2800
2801 =item How can I reliably rename a file?
2802
2803 =item How can I lock a file?
2804
2805 =item Why can't I just open(FH, ">file.lock")?
2806
2807 =item I still don't get locking.  I just want to increment the number in
2808 the file.  How can I do this?
2809
2810 =item All I want to do is append a small amount of text to the end of a
2811 file.  Do I still have to use locking?
2812
2813 =item How do I randomly update a binary file?
2814
2815 =item How do I get a file's timestamp in perl?
2816
2817 =item How do I set a file's timestamp in perl?
2818
2819 =item How do I print to more than one file at once?
2820
2821 =item How can I read in an entire file all at once?
2822
2823 =item How can I read in a file by paragraphs?
2824
2825 =item How can I read a single character from a file?  From the keyboard?
2826
2827 =item How can I tell whether there's a character waiting on a filehandle?
2828
2829 =item How do I do a C<tail -f> in perl?
2830
2831 =item How do I dup() a filehandle in Perl?
2832
2833 =item How do I close a file descriptor by number?
2834
2835 =item Why can't I use "C:\temp\foo" in DOS paths?  What doesn't
2836 `C:\temp\foo.exe` work?
2837
2838 =item Why doesn't glob("*.*") get all the files?
2839
2840 =item Why does Perl let me delete read-only files?  Why does C<-i> clobber
2841 protected files?  Isn't this a bug in Perl?
2842
2843 =item How do I select a random line from a file?
2844
2845 =item Why do I get weird spaces when I print an array of lines?
2846
2847 =back
2848
2849 =item AUTHOR AND COPYRIGHT
2850
2851 =back
2852
2853 =head2 perlfaq6 - Regexes ($Revision: 1.1 $, $Date: 2001/09/20 03:03:00 $)
2854
2855 =over 4
2856
2857 =item DESCRIPTION
2858
2859 =over 4
2860
2861 =item How can I hope to use regular expressions without creating illegible
2862 and unmaintainable code?
2863
2864 Comments Outside the Regex, Comments Inside the Regex, Different Delimiters
2865
2866 =item I'm having trouble matching over more than one line.  What's wrong?
2867
2868 =item How can I pull out lines between two patterns that are themselves on
2869 different lines?
2870
2871 =item I put a regular expression into $/ but it didn't work. What's wrong?
2872
2873 =item How do I substitute case insensitively on the LHS while preserving
2874 case on the RHS?
2875
2876 =item How can I make C<\w> match national character sets?
2877
2878 =item How can I match a locale-smart version of C</[a-zA-Z]/>?
2879
2880 =item How can I quote a variable to use in a regex?
2881
2882 =item What is C</o> really for?
2883
2884 =item How do I use a regular expression to strip C style comments from a
2885 file?
2886
2887 =item Can I use Perl regular expressions to match balanced text?
2888
2889 =item What does it mean that regexes are greedy?  How can I get around it?
2890
2891 =item How do I process each word on each line?
2892
2893 =item How can I print out a word-frequency or line-frequency summary?
2894
2895 =item How can I do approximate matching?
2896
2897 =item How do I efficiently match many regular expressions at once?
2898
2899 =item Why don't word-boundary searches with C<\b> work for me?
2900
2901 =item Why does using $&, $`, or $' slow my program down?
2902
2903 =item What good is C<\G> in a regular expression?
2904
2905 =item Are Perl regexes DFAs or NFAs?  Are they POSIX compliant?
2906
2907 =item What's wrong with using grep or map in a void context?
2908
2909 =item How can I match strings with multibyte characters?
2910
2911 =item How do I match a pattern that is supplied by the user?
2912
2913 =back
2914
2915 =item AUTHOR AND COPYRIGHT
2916
2917 =back
2918
2919 =head2 perlfaq7 - Perl Language Issues ($Revision: 1.1 $, $Date: 2001/09/20
2920 03:03:00 $)
2921
2922 =over 4
2923
2924 =item DESCRIPTION
2925
2926 =over 4
2927
2928 =item Can I get a BNF/yacc/RE for the Perl language?
2929
2930 =item What are all these $@%&* punctuation signs, and how do I know when to
2931 use them?
2932
2933 =item Do I always/never have to quote my strings or use semicolons and
2934 commas?
2935
2936 =item How do I skip some return values?
2937
2938 =item How do I temporarily block warnings?
2939
2940 =item What's an extension?
2941
2942 =item Why do Perl operators have different precedence than C operators?
2943
2944 =item How do I declare/create a structure?
2945
2946 =item How do I create a module?
2947
2948 =item How do I create a class?
2949
2950 =item How can I tell if a variable is tainted?
2951
2952 =item What's a closure?
2953
2954 =item What is variable suicide and how can I prevent it?
2955
2956 =item How can I pass/return a {Function, FileHandle, Array, Hash, Method,
2957 Regex}?
2958
2959 Passing Variables and Functions, Passing Filehandles, Passing Regexes,
2960 Passing Methods
2961
2962 =item How do I create a static variable?
2963
2964 =item What's the difference between dynamic and lexical (static) scoping?
2965 Between local() and my()?
2966
2967 =item How can I access a dynamic variable while a similarly named lexical
2968 is in scope?
2969
2970 =item What's the difference between deep and shallow binding?
2971
2972 =item Why doesn't "my($foo) = <FILE>;" work right?
2973
2974 =item How do I redefine a builtin function, operator, or method?
2975
2976 =item What's the difference between calling a function as &foo and foo()?
2977
2978 =item How do I create a switch or case statement?
2979
2980 =item How can I catch accesses to undefined variables/functions/methods?
2981
2982 =item Why can't a method included in this same file be found?
2983
2984 =item How can I find out my current package?
2985
2986 =item How can I comment out a large block of perl code?
2987
2988 =item How do I clear a package?
2989
2990 =item How can I use a variable as a variable name?
2991
2992 =back
2993
2994 =item AUTHOR AND COPYRIGHT
2995
2996 =back
2997
2998 =head2 perlfaq8 - System Interaction ($Revision: 1.1 $, $Date: 2001/09/20
2999 03:03:00 $)
3000
3001 =over 4
3002
3003 =item DESCRIPTION
3004
3005 =over 4
3006
3007 =item How do I find out which operating system I'm running under?
3008
3009 =item How come exec() doesn't return?
3010
3011 =item How do I do fancy stuff with the keyboard/screen/mouse?
3012
3013 Keyboard, Screen, Mouse
3014
3015 =item How do I print something out in color?
3016
3017 =item How do I read just one key without waiting for a return key?
3018
3019 =item How do I check whether input is ready on the keyboard?
3020
3021 =item How do I clear the screen?
3022
3023 =item How do I get the screen size?
3024
3025 =item How do I ask the user for a password?
3026
3027 =item How do I read and write the serial port?
3028
3029 lockfiles, open mode, end of line, flushing output, non-blocking input
3030
3031 =item How do I decode encrypted password files?
3032
3033 =item How do I start a process in the background?
3034
3035 STDIN, STDOUT, and STDERR are shared, Signals, Zombies
3036
3037 =item How do I trap control characters/signals?
3038
3039 =item How do I modify the shadow password file on a Unix system?
3040
3041 =item How do I set the time and date?
3042
3043 =item How can I sleep() or alarm() for under a second?
3044
3045 =item How can I measure time under a second?
3046
3047 =item How can I do an atexit() or setjmp()/longjmp()? (Exception handling)
3048
3049 =item Why doesn't my sockets program work under System V (Solaris)?  What
3050 does the error message "Protocol not supported" mean?
3051
3052 =item How can I call my system's unique C functions from Perl?
3053
3054 =item Where do I get the include files to do ioctl() or syscall()?
3055
3056 =item Why do setuid perl scripts complain about kernel problems?
3057
3058 =item How can I open a pipe both to and from a command?
3059
3060 =item Why can't I get the output of a command with system()?
3061
3062 =item How can I capture STDERR from an external command?
3063
3064 =item Why doesn't open() return an error when a pipe open fails?
3065
3066 =item What's wrong with using backticks in a void context?
3067
3068 =item How can I call backticks without shell processing?
3069
3070 =item Why can't my script read from STDIN after I gave it EOF (^D on Unix,
3071 ^Z on MS-DOS)?
3072
3073 =item How can I convert my shell script to perl?
3074
3075 =item Can I use perl to run a telnet or ftp session?
3076
3077 =item How can I write expect in Perl?
3078
3079 =item Is there a way to hide perl's command line from programs such as
3080 "ps"?
3081
3082 =item I {changed directory, modified my environment} in a perl script.  How
3083 come the change disappeared when I exited the script?  How do I get my
3084 changes to be visible?
3085
3086 Unix
3087
3088 =item How do I close a process's filehandle without waiting for it to
3089 complete?
3090
3091 =item How do I fork a daemon process?
3092
3093 =item How do I find out if I'm running interactively or not?
3094
3095 =item How do I timeout a slow event?
3096
3097 =item How do I set CPU limits?
3098
3099 =item How do I avoid zombies on a Unix system?
3100
3101 =item How do I use an SQL database?
3102
3103 =item How do I make a system() exit on control-C?
3104
3105 =item How do I open a file without blocking?
3106
3107 =item How do I install a module from CPAN?
3108
3109 =item What's the difference between require and use?
3110
3111 =item How do I keep my own module/library directory?
3112
3113 =item How do I add the directory my program lives in to the module/library
3114 search path?
3115
3116 =item How do I add a directory to my include path at runtime?
3117
3118 =item What is socket.ph and where do I get it?
3119
3120 =back
3121
3122 =item AUTHOR AND COPYRIGHT
3123
3124 =back
3125
3126 =head2 perlfaq9 - Networking ($Revision: 1.1 $, $Date: 2001/09/20 03:03:00
3127 $)
3128
3129 =over 4
3130
3131 =item DESCRIPTION
3132
3133 =over 4
3134
3135 =item My CGI script runs from the command line but not the browser.  (500
3136 Server Error)
3137
3138 =item How can I get better error messages from a CGI program?
3139
3140 =item How do I remove HTML from a string?
3141
3142 =item How do I extract URLs?
3143
3144 =item How do I download a file from the user's machine?  How do I open a
3145 file on another machine?
3146
3147 =item How do I make a pop-up menu in HTML?
3148
3149 =item How do I fetch an HTML file?
3150
3151 =item How do I automate an HTML form submission?
3152
3153 =item How do I decode or create those %-encodings on the web?
3154
3155 =item How do I redirect to another page?
3156
3157 =item How do I put a password on my web pages?
3158
3159 =item How do I edit my .htpasswd and .htgroup files with Perl?
3160
3161 =item How do I make sure users can't enter values into a form that cause my
3162 CGI script to do bad things?
3163
3164 =item How do I parse a mail header?
3165
3166 =item How do I decode a CGI form?
3167
3168 =item How do I check a valid mail address?
3169
3170 =item How do I decode a MIME/BASE64 string?
3171
3172 =item How do I return the user's mail address?
3173
3174 =item How do I send mail?
3175
3176 =item How do I use MIME to make an attachment to a mail message?
3177
3178 =item How do I read mail?
3179
3180 =item How do I find out my hostname/domainname/IP address?
3181
3182 =item How do I fetch a news article or the active newsgroups?
3183
3184 =item How do I fetch/put an FTP file?
3185
3186 =item How can I do RPC in Perl?
3187
3188 =back
3189
3190 =item AUTHOR AND COPYRIGHT
3191
3192 =back
3193
3194 =head2 perlcompile - Introduction to the Perl Compiler-Translator
3195
3196 =over 4
3197
3198 =item DESCRIPTION
3199
3200 =over 4
3201
3202 =item Layout
3203
3204 B::Bytecode, B::C, B::CC, B::Lint, B::Deparse, B::Xref
3205
3206 =back
3207
3208 =item Using The Back Ends
3209
3210 =over 4
3211
3212 =item The Cross Referencing Back End
3213
3214 i, &, s, r
3215
3216 =item The Decompiling Back End
3217
3218 =item The Lint Back End
3219
3220 =item The Simple C Back End
3221
3222 =item The Bytecode Back End
3223
3224 =item The Optimized C Back End
3225
3226 B, O, B::Asmdata, B::Assembler, B::Bblock, B::Bytecode, B::C, B::CC,
3227 B::Debug, B::Deparse, B::Disassembler, B::Lint, B::Showlex, B::Stackobj,
3228 B::Stash, B::Terse, B::Xref
3229
3230 =back
3231
3232 =item KNOWN PROBLEMS
3233
3234 =item AUTHOR
3235
3236 =back
3237
3238 =head2 perlembed - how to embed perl in your C program
3239
3240 =over 4
3241
3242 =item DESCRIPTION
3243
3244 =over 4
3245
3246 =item PREAMBLE
3247
3248 B<Use C from Perl?>, B<Use a Unix program from Perl?>, B<Use Perl from
3249 Perl?>, B<Use C from C?>, B<Use Perl from C?>
3250
3251 =item ROADMAP
3252
3253 =item Compiling your C program
3254
3255 =item Adding a Perl interpreter to your C program
3256
3257 =item Calling a Perl subroutine from your C program
3258
3259 =item Evaluating a Perl statement from your C program
3260
3261 =item Performing Perl pattern matches and substitutions from your C program
3262
3263 =item Fiddling with the Perl stack from your C program
3264
3265 =item Maintaining a persistent interpreter
3266
3267 =item Execution of END blocks
3268
3269 =item Maintaining multiple interpreter instances
3270
3271 =item Using Perl modules, which themselves use C libraries, from your C
3272 program
3273
3274 =back
3275
3276 =item Embedding Perl under Win32
3277
3278 =item MORAL
3279
3280 =item AUTHOR
3281
3282 =item COPYRIGHT
3283
3284 =back
3285
3286 =head2 perldebguts - Guts of Perl debugging
3287
3288 =over 4
3289
3290 =item DESCRIPTION
3291
3292 =item Debugger Internals
3293
3294 =over 4
3295
3296 =item Writing Your Own Debugger
3297
3298 =back
3299
3300 =item Frame Listing Output Examples
3301
3302 =item Debugging regular expressions
3303
3304 =over 4
3305
3306 =item Compile-time output
3307
3308 C<anchored> I<STRING> C<at> I<POS>, C<floating> I<STRING> C<at>
3309 I<POS1..POS2>, C<matching floating/anchored>, C<minlen>, C<stclass>
3310 I<TYPE>, C<noscan>, C<isall>, C<GPOS>, C<plus>, C<implicit>, C<with eval>,
3311 C<anchored(TYPE)>
3312
3313 =item Types of nodes
3314
3315 =item Run-time output
3316
3317 =back
3318
3319 =item Debugging Perl memory usage
3320
3321 =over 4
3322
3323 =item Using C<$ENV{PERL_DEBUG_MSTATS}>
3324
3325 C<buckets SMALLEST(APPROX)..GREATEST(APPROX)>, Free/Used, C<Total sbrk():
3326 SBRKed/SBRKs:CONTINUOUS>, C<pad: 0>, C<heads: 2192>, C<chain: 0>, C<tail:
3327 6144>
3328
3329 =item Example of using B<-DL> switch
3330
3331 C<717>, C<002>, C<054>, C<602>, C<702>, C<704>
3332
3333 =item B<-DL> details
3334
3335 C<!!!>, C<!!>, C<!>
3336
3337 =item Limitations of B<-DL> statistics
3338
3339 =back
3340
3341 =item SEE ALSO
3342
3343 =back
3344
3345 =head2 perlxstut, perlXStut - Tutorial for writing XSUBs
3346
3347 =over 4
3348
3349 =item DESCRIPTION
3350
3351 =item SPECIAL NOTES
3352
3353 =over 4
3354
3355 =item make
3356
3357 =item Version caveat
3358
3359 =item Dynamic Loading versus Static Loading
3360
3361 =back
3362
3363 =item TUTORIAL
3364
3365 =over 4
3366
3367 =item EXAMPLE 1
3368
3369 =item EXAMPLE 2
3370
3371 =item What has gone on?
3372
3373 =item Writing good test scripts
3374
3375 =item EXAMPLE 3
3376
3377 =item What's new here?
3378
3379 =item Input and Output Parameters
3380
3381 =item The XSUBPP Program
3382
3383 =item The TYPEMAP file
3384
3385 =item Warning about Output Arguments
3386
3387 =item EXAMPLE 4
3388
3389 =item What has happened here?
3390
3391 =item Anatomy of .xs file
3392
3393 =item Getting the fat out of XSUBs
3394
3395 =item More about XSUB arguments
3396
3397 =item The Argument Stack
3398
3399 =item Extending your Extension
3400
3401 =item Documenting your Extension
3402
3403 =item Installing your Extension
3404
3405 =item EXAMPLE 5
3406
3407 =item New Things in this Example
3408
3409 =item EXAMPLE 6
3410
3411 =item New Things in this Example
3412
3413 =item EXAMPLE 7 (Coming Soon)
3414
3415 =item EXAMPLE 8 (Coming Soon)
3416
3417 =item EXAMPLE 9 (Coming Soon)
3418
3419 =item Troubleshooting these Examples
3420
3421 =back
3422
3423 =item See also
3424
3425 =item Author
3426
3427 =over 4
3428
3429 =item Last Changed
3430
3431 =back
3432
3433 =back
3434
3435 =head2 perlxs - XS language reference manual
3436
3437 =over 4
3438
3439 =item DESCRIPTION
3440
3441 =over 4
3442
3443 =item Introduction
3444
3445 =item On The Road
3446
3447 =item The Anatomy of an XSUB
3448
3449 =item The Argument Stack
3450
3451 =item The RETVAL Variable
3452
3453 =item The MODULE Keyword
3454
3455 =item The PACKAGE Keyword
3456
3457 =item The PREFIX Keyword
3458
3459 =item The OUTPUT: Keyword
3460
3461 =item The NO_OUTPUT Keyword
3462
3463 =item The CODE: Keyword
3464
3465 =item The INIT: Keyword
3466
3467 =item The NO_INIT Keyword
3468
3469 =item Initializing Function Parameters
3470
3471 =item Default Parameter Values
3472
3473 =item The PREINIT: Keyword
3474
3475 =item The SCOPE: Keyword
3476
3477 =item The INPUT: Keyword
3478
3479 =item The IN/OUTLIST/IN_OUTLIST/OUT/IN_OUT Keywords
3480
3481 =item Variable-length Parameter Lists
3482
3483 =item The C_ARGS: Keyword
3484
3485 =item The PPCODE: Keyword
3486
3487 =item Returning Undef And Empty Lists
3488
3489 =item The REQUIRE: Keyword
3490
3491 =item The CLEANUP: Keyword
3492
3493 =item The POSTCALL: Keyword
3494
3495 =item The BOOT: Keyword
3496
3497 =item The VERSIONCHECK: Keyword
3498
3499 =item The PROTOTYPES: Keyword
3500
3501 =item The PROTOTYPE: Keyword
3502
3503 =item The ALIAS: Keyword
3504
3505 =item The INTERFACE: Keyword
3506
3507 =item The INTERFACE_MACRO: Keyword
3508
3509 =item The INCLUDE: Keyword
3510
3511 =item The CASE: Keyword
3512
3513 =item The & Unary Operator
3514
3515 =item Inserting POD, Comments and C Preprocessor Directives
3516
3517 =item Using XS With C++
3518
3519 =item Interface Strategy
3520
3521 =item Perl Objects And C Structures
3522
3523 =item The Typemap
3524
3525 =back
3526
3527 =item EXAMPLES
3528
3529 =item XS VERSION
3530
3531 =item AUTHOR
3532
3533 =back
3534
3535 =head2 perlclib - Internal replacements for standard C library functions
3536
3537 =over 4
3538
3539 =item DESCRIPTION
3540
3541 =over 4
3542
3543 =item Conventions
3544
3545 C<t>, C<p>, C<n>, C<s>
3546
3547 =item File Operations
3548
3549 =item File Input and Output
3550
3551 =item File Positioning
3552
3553 =item Memory Management and String Handling
3554
3555 =item Character Class Tests
3556
3557 =item F<stdlib.h> functions
3558
3559 =item Miscellaneous functions
3560
3561 =back
3562
3563 =item SEE ALSO
3564
3565 =back
3566
3567 =head2 perlguts - Introduction to the Perl API
3568
3569 =over 4
3570
3571 =item DESCRIPTION
3572
3573 =item Variables
3574
3575 =over 4
3576
3577 =item Datatypes
3578
3579 =item What is an "IV"?
3580
3581 =item Working with SVs
3582
3583 =item Offsets
3584
3585 =item What's Really Stored in an SV?
3586
3587 =item Working with AVs
3588
3589 =item Working with HVs
3590
3591 =item Hash API Extensions
3592
3593 =item References
3594
3595 =item Blessed References and Class Objects
3596
3597 =item Creating New Variables
3598
3599 =item Reference Counts and Mortality
3600
3601 =item Stashes and Globs
3602
3603 =item Double-Typed SVs
3604
3605 =item Magic Variables
3606
3607 =item Assigning Magic
3608
3609 =item Magic Virtual Tables
3610
3611 =item Finding Magic
3612
3613 =item Understanding the Magic of Tied Hashes and Arrays
3614
3615 =item Localizing changes
3616
3617 C<SAVEINT(int i)>, C<SAVEIV(IV i)>, C<SAVEI32(I32 i)>, C<SAVELONG(long i)>,
3618 C<SAVESPTR(s)>, C<SAVEPPTR(p)>, C<SAVEFREESV(SV *sv)>, C<SAVEMORTALIZESV(SV
3619 *sv)>, C<SAVEFREEOP(OP *op)>, C<SAVEFREEPV(p)>, C<SAVECLEARSV(SV *sv)>,
3620 C<SAVEDELETE(HV *hv, char *key, I32 length)>,
3621 C<SAVEDESTRUCTOR(DESTRUCTORFUNC_NOCONTEXT_t f, void *p)>,
3622 C<SAVEDESTRUCTOR_X(DESTRUCTORFUNC_t f, void *p)>, C<SAVESTACK_POS()>, C<SV*
3623 save_scalar(GV *gv)>, C<AV* save_ary(GV *gv)>, C<HV* save_hash(GV *gv)>,
3624 C<void save_item(SV *item)>, C<void save_list(SV **sarg, I32 maxsarg)>,
3625 C<SV* save_svref(SV **sptr)>, C<void save_aptr(AV **aptr)>, C<void
3626 save_hptr(HV **hptr)>
3627
3628 =back
3629
3630 =item Subroutines
3631
3632 =over 4
3633
3634 =item XSUBs and the Argument Stack
3635
3636 =item Calling Perl Routines from within C Programs
3637
3638 =item Memory Allocation
3639
3640 =item PerlIO
3641
3642 =item Putting a C value on Perl stack
3643
3644 =item Scratchpads
3645
3646 =item Scratchpads and recursion
3647
3648 =back
3649
3650 =item Compiled code
3651
3652 =over 4
3653
3654 =item Code tree
3655
3656 =item Examining the tree
3657
3658 =item Compile pass 1: check routines
3659
3660 =item Compile pass 1a: constant folding
3661
3662 =item Compile pass 2: context propagation
3663
3664 =item Compile pass 3: peephole optimization
3665
3666 =item Pluggable runops
3667
3668 =back
3669
3670 =item Examining internal data structures with the C<dump> functions
3671
3672 =item How multiple interpreters and concurrency are supported
3673
3674 =over 4
3675
3676 =item Background and PERL_IMPLICIT_CONTEXT
3677
3678 =item So what happened to dTHR?
3679
3680 =item How do I use all this in extensions?
3681
3682 =item Should I do anything special if I call perl from multiple threads?
3683
3684 =item Future Plans and PERL_IMPLICIT_SYS
3685
3686 =back
3687
3688 =item Internal Functions
3689
3690 A, p, d, s, n, r, f, M, o, j, x
3691
3692 =over 4
3693
3694 =item Formatted Printing of IVs, UVs, and NVs
3695
3696 =item Pointer-To-Integer and Integer-To-Pointer
3697
3698 =item Source Documentation
3699
3700 =back
3701
3702 =item Unicode Support
3703
3704 =over 4
3705
3706 =item What B<is> Unicode, anyway?
3707
3708 =item How can I recognise a UTF8 string?
3709
3710 =item How does UTF8 represent Unicode characters?
3711
3712 =item How does Perl store UTF8 strings?
3713
3714 =item How do I convert a string to UTF8?
3715
3716 =item Is there anything else I need to know?
3717
3718 =back
3719
3720 =item Custom Operators
3721
3722 =item AUTHORS
3723
3724 =item SEE ALSO
3725
3726 =back
3727
3728 =head2 perlcall - Perl calling conventions from C
3729
3730 =over 4
3731
3732 =item DESCRIPTION
3733
3734 An Error Handler, An Event Driven Program
3735
3736 =item THE CALL_ FUNCTIONS
3737
3738 call_sv, call_pv, call_method, call_argv
3739
3740 =item FLAG VALUES
3741
3742 =over 4
3743
3744 =item  G_VOID
3745
3746 =item  G_SCALAR
3747
3748 =item G_ARRAY
3749
3750 =item G_DISCARD
3751
3752 =item G_NOARGS
3753
3754 =item G_EVAL
3755
3756 =item G_KEEPERR
3757
3758 =item Determining the Context
3759
3760 =back
3761
3762 =item KNOWN PROBLEMS
3763
3764 =item EXAMPLES
3765
3766 =over 4
3767
3768 =item No Parameters, Nothing returned
3769
3770 =item Passing Parameters
3771
3772 =item Returning a Scalar
3773
3774 =item Returning a list of values
3775
3776 =item Returning a list in a scalar context
3777
3778 =item Returning Data from Perl via the parameter list
3779
3780 =item Using G_EVAL
3781
3782 =item Using G_KEEPERR
3783
3784 =item Using call_sv
3785
3786 =item Using call_argv
3787
3788 =item Using call_method
3789
3790 =item Using GIMME_V
3791
3792 =item Using Perl to dispose of temporaries
3793
3794 =item Strategies for storing Callback Context Information
3795
3796 1. Ignore the problem - Allow only 1 callback, 2. Create a sequence of
3797 callbacks - hard wired limit, 3. Use a parameter to map to the Perl
3798 callback
3799
3800 =item Alternate Stack Manipulation
3801
3802 =item Creating and calling an anonymous subroutine in C
3803
3804 =back
3805
3806 =item SEE ALSO
3807
3808 =item AUTHOR
3809
3810 =item DATE
3811
3812 =back
3813
3814 =head2 perlutil - utilities packaged with the Perl distribution
3815
3816 =over 4
3817
3818 =item DESCRIPTION
3819
3820 =over 4
3821
3822 =item DOCUMENTATION
3823
3824 L<perldoc|perldoc>, L<pod2man|pod2man> and L<pod2text|pod2text>,
3825 L<pod2html|pod2html> and L<pod2latex|pod2latex>, L<pod2usage|pod2usage>,
3826 L<podselect|podselect>, L<podchecker|podchecker>, L<splain|splain>,
3827 L<roffitall|roffitall>
3828
3829 =item CONVERTORS
3830
3831 L<a2p|a2p>, L<s2p|s2p>, L<find2perl|find2perl>
3832
3833 =item Administration
3834
3835 L<libnetcfg|libnetcfg>
3836
3837 =item Development
3838
3839 L<perlbug|perlbug>, L<h2ph|h2ph>, L<c2ph|c2ph> and L<pstruct|pstruct>,
3840 L<h2xs|h2xs>, L<dprofpp|dprofpp>, L<perlcc|perlcc>
3841
3842 =item SEE ALSO
3843
3844 =back
3845
3846 =back
3847
3848 =head2 perlfilter - Source Filters
3849
3850 =over 4
3851
3852 =item DESCRIPTION
3853
3854 =item CONCEPTS
3855
3856 =item USING FILTERS
3857
3858 =item WRITING A SOURCE FILTER
3859
3860 =item WRITING A SOURCE FILTER IN C
3861
3862 B<Decryption Filters>
3863
3864 =item CREATING A SOURCE FILTER AS A SEPARATE EXECUTABLE
3865
3866 =item WRITING A SOURCE FILTER IN PERL
3867
3868 =item USING CONTEXT: THE DEBUG FILTER
3869
3870 =item CONCLUSION
3871
3872 =item REQUIREMENTS
3873
3874 =item AUTHOR
3875
3876 =item Copyrights
3877
3878 =back
3879
3880 =head2 perldbmfilter - Perl DBM Filters
3881
3882 =over 4
3883
3884 =item SYNOPSIS
3885
3886 =item DESCRIPTION
3887
3888 B<filter_store_key>, B<filter_store_value>, B<filter_fetch_key>,
3889 B<filter_fetch_value>
3890
3891 =over 4
3892
3893 =item The Filter
3894
3895 =item An Example -- the NULL termination problem.
3896
3897 =item Another Example -- Key is a C int.
3898
3899 =back
3900
3901 =item SEE ALSO
3902
3903 =item AUTHOR
3904
3905 =back
3906
3907 =head2 perlapi - autogenerated documentation for the perl public API
3908
3909 =over 4
3910
3911 =item DESCRIPTION
3912
3913 AvFILL, av_clear, av_delete, av_exists, av_extend, av_fetch, av_fill,
3914 av_len, av_make, av_pop, av_push, av_shift, av_store, av_undef, av_unshift,
3915 ax, bytes_from_utf8, bytes_to_utf8, call_argv, call_method, call_pv,
3916 call_sv, CLASS, Copy, croak, CvSTASH, cv_const_sv, dAX, dITEMS, dMARK,
3917 dORIGMARK, dSP, dXSARGS, dXSI32, ENTER, eval_pv, eval_sv, EXTEND,
3918 fbm_compile, fbm_instr, FREETMPS, getcwd_sv, get_av, get_cv, get_hv,
3919 get_sv, GIMME, GIMME_V, grok_bin, grok_hex, grok_number,
3920 grok_numeric_radix, grok_oct, GvSV, gv_fetchmeth, gv_fetchmethod,
3921 gv_fetchmethod_autoload, gv_stashpv, gv_stashsv, G_ARRAY, G_DISCARD,
3922 G_EVAL, G_NOARGS, G_SCALAR, G_VOID, HEf_SVKEY, HeHASH, HeKEY, HeKLEN, HePV,
3923 HeSVKEY, HeSVKEY_force, HeSVKEY_set, HeVAL, HvNAME, hv_clear, hv_delete,
3924 hv_delete_ent, hv_exists, hv_exists_ent, hv_fetch, hv_fetch_ent,
3925 hv_iterinit, hv_iterkey, hv_iterkeysv, hv_iternext, hv_iternextsv,
3926 hv_iterval, hv_magic, hv_store, hv_store_ent, hv_undef, isALNUM, isALPHA,
3927 isDIGIT, isLOWER, isSPACE, isUPPER, is_utf8_char, is_utf8_string, items,
3928 ix, LEAVE, load_module, looks_like_number, MARK, mg_clear, mg_copy,
3929 mg_find, mg_free, mg_get, mg_length, mg_magical, mg_set, Move, New, newAV,
3930 Newc, newCONSTSUB, newHV, newRV_inc, newRV_noinc, newSV, NEWSV, newSViv,
3931 newSVnv, newSVpv, newSVpvf, newSVpvn, newSVpvn_share, newSVrv, newSVsv,
3932 newSVuv, newXS, newXSproto, Newz, Nullav, Nullch, Nullcv, Nullhv, Nullsv,
3933 ORIGMARK, perl_alloc, perl_clone, perl_construct, perl_destruct, perl_free,
3934 perl_parse, perl_run, PL_modglobal, PL_na, PL_sv_no, PL_sv_undef,
3935 PL_sv_yes, POPi, POPl, POPn, POPp, POPpbytex, POPpx, POPs, PUSHi, PUSHMARK,
3936 PUSHn, PUSHp, PUSHs, PUSHu, PUTBACK, Renew, Renewc, require_pv, RETVAL,
3937 Safefree, savepv, savepvn, SAVETMPS, scan_bin, scan_hex, scan_oct,
3938 sharedsv_find, sharedsv_init, sharedsv_lock, sharedsv_new,
3939 sharedsv_thrcnt_dec, sharedsv_thrcnt_inc, sharedsv_unlock, SP, SPAGAIN, ST,
3940 strEQ, strGE, strGT, strLE, strLT, strNE, strnEQ, strnNE, StructCopy,
3941 SvCUR, SvCUR_set, SvEND, SvGETMAGIC, SvGROW, SvIOK, SvIOKp, SvIOK_notUV,
3942 SvIOK_off, SvIOK_on, SvIOK_only, SvIOK_only_UV, SvIOK_UV, SvIV, SvIVX,
3943 SvIVx, SvLEN, SvNIOK, SvNIOKp, SvNIOK_off, SvNOK, SvNOKp, SvNOK_off,
3944 SvNOK_on, SvNOK_only, SvNV, SvNVx, SvNVX, SvOK, SvOOK, SvPOK, SvPOKp,
3945 SvPOK_off, SvPOK_on, SvPOK_only, SvPOK_only_UTF8, SvPV, SvPVbyte,
3946 SvPVbytex, SvPVbytex_force, SvPVbyte_force, SvPVbyte_nolen, SvPVutf8,
3947 SvPVutf8x, SvPVutf8x_force, SvPVutf8_force, SvPVutf8_nolen, SvPVX, SvPVx,
3948 SvPV_force, SvPV_force_nomg, SvPV_nolen, SvREFCNT, SvREFCNT_dec,
3949 SvREFCNT_inc, SvROK, SvROK_off, SvROK_on, SvRV, SvSETMAGIC, SvSetMagicSV,
3950 SvSetMagicSV_nosteal, SvSetSV, SvSetSV_nosteal, SvSTASH, SvTAINT,
3951 SvTAINTED, SvTAINTED_off, SvTAINTED_on, SvTRUE, svtype, SvTYPE, SVt_IV,
3952 SVt_NV, SVt_PV, SVt_PVAV, SVt_PVCV, SVt_PVHV, SVt_PVMG, SvUOK, SvUPGRADE,
3953 SvUTF8, SvUTF8_off, SvUTF8_on, SvUV, SvUVX, SvUVx, sv_2bool, sv_2cv,
3954 sv_2io, sv_2iv, sv_2mortal, sv_2nv, sv_2pvbyte, sv_2pvbyte_nolen,
3955 sv_2pvutf8, sv_2pvutf8_nolen, sv_2pv_flags, sv_2pv_nolen, sv_2uv,
3956 sv_backoff, sv_bless, sv_catpv, sv_catpvf, sv_catpvf_mg, sv_catpvn,
3957 sv_catpvn_flags, sv_catpvn_mg, sv_catpv_mg, sv_catsv, sv_catsv_flags,
3958 sv_catsv_mg, sv_chop, sv_clear, sv_cmp, sv_cmp_locale, sv_collxfrm, sv_dec,
3959 sv_derived_from, sv_eq, sv_force_normal, sv_force_normal_flags, sv_free,
3960 sv_gets, sv_grow, sv_inc, sv_insert, sv_isa, sv_isobject, sv_iv, sv_len,
3961 sv_len_utf8, sv_magic, sv_mortalcopy, sv_newmortal, sv_newref, sv_nv,
3962 sv_pos_b2u, sv_pos_u2b, sv_pv, sv_pvbyte, sv_pvbyten, sv_pvbyten_force,
3963 sv_pvn, sv_pvn_force, sv_pvn_force_flags, sv_pvutf8, sv_pvutf8n,
3964 sv_pvutf8n_force, sv_reftype, sv_replace, sv_report_used, sv_reset,
3965 sv_rvweaken, sv_setiv, sv_setiv_mg, sv_setnv, sv_setnv_mg, sv_setpv,
3966 sv_setpvf, sv_setpvf_mg, sv_setpviv, sv_setpviv_mg, sv_setpvn,
3967 sv_setpvn_mg, sv_setpv_mg, sv_setref_iv, sv_setref_nv, sv_setref_pv,
3968 sv_setref_pvn, sv_setref_uv, sv_setsv, sv_setsv_flags, sv_setsv_mg,
3969 sv_setuv, sv_setuv_mg, sv_taint, sv_tainted, sv_true, sv_unmagic, sv_unref,
3970 sv_unref_flags, sv_untaint, sv_upgrade, sv_usepvn, sv_usepvn_mg,
3971 sv_utf8_decode, sv_utf8_downgrade, sv_utf8_encode, sv_utf8_upgrade,
3972 sv_utf8_upgrade_flags, sv_uv, sv_vcatpvfn, sv_vsetpvfn, THIS, toLOWER,
3973 toUPPER, utf8n_to_uvchr, utf8n_to_uvuni, utf8_distance, utf8_hop,
3974 utf8_length, utf8_to_bytes, utf8_to_uvchr, utf8_to_uvuni, uvchr_to_utf8,
3975 uvuni_to_utf8, warn, XPUSHi, XPUSHn, XPUSHp, XPUSHs, XPUSHu, XS, XSRETURN,
3976 XSRETURN_EMPTY, XSRETURN_IV, XSRETURN_NO, XSRETURN_NV, XSRETURN_PV,
3977 XSRETURN_UNDEF, XSRETURN_YES, XST_mIV, XST_mNO, XST_mNV, XST_mPV,
3978 XST_mUNDEF, XST_mYES, XS_VERSION, XS_VERSION_BOOTCHECK, Zero
3979
3980 =item AUTHORS
3981
3982 =item SEE ALSO
3983
3984 =back
3985
3986 =head2 perlintern - autogenerated documentation of purely B<internal>
3987                  Perl functions
3988
3989 =over 4
3990
3991 =item DESCRIPTION
3992
3993 djSP, is_gv_magical, LVRET, PL_DBsingle, PL_DBsub, PL_DBtrace, PL_dowarn,
3994 PL_last_in_gv, PL_ofs_sv, PL_rs, report_uninit, start_glob, sv_add_arena,
3995 sv_clean_all, sv_clean_objs, sv_free_arenas
3996
3997 =item AUTHORS
3998
3999 =item SEE ALSO
4000
4001 =back
4002
4003 =head2 perliol - C API for Perl's implementation of IO in Layers.
4004
4005 =over 4
4006
4007 =item SYNOPSIS
4008
4009 =item DESCRIPTION
4010
4011 =over 4
4012
4013 =item History and Background
4014
4015 =item Layers vs Disciplines
4016
4017 =item Data Structures
4018
4019 1. The functions and attributes of the "layer class", 2. The per-instance
4020 data for a particular handle
4021
4022 =item Functions and Attributes
4023
4024 =item Per-instance Data
4025
4026 =item Layers in action.
4027
4028 =item Per-instance flag bits
4029
4030 PERLIO_F_EOF, PERLIO_F_CANWRITE,  PERLIO_F_CANREAD, PERLIO_F_ERROR,
4031 PERLIO_F_TRUNCATE, PERLIO_F_APPEND, PERLIO_F_CRLF, PERLIO_F_UTF8,
4032 PERLIO_F_UNBUF, PERLIO_F_WRBUF, PERLIO_F_RDBUF, PERLIO_F_LINEBUF,
4033 PERLIO_F_TEMP, PERLIO_F_OPEN, PERLIO_F_FASTGETS
4034
4035 =item Methods in Detail
4036
4037  IV             (*Pushed)(PerlIO *f,const char *mode, SV *arg);,  IV
4038     (*Popped)(PerlIO *f);,  PerlIO *        (*Open)(...);, SV *
4039 (*Getarg)(PerlIO *f);, IV       (*Fileno)(PerlIO *f);,  SSize_t
4040 (*Read)(PerlIO *f, void *vbuf, Size_t count);,  SSize_t (*Unread)(PerlIO
4041 *f, const void *vbuf, Size_t count);,  SSize_t (*Write)(PerlIO *f, const
4042 void *vbuf, Size_t count);,  IV               (*Seek)(PerlIO *f, Off_t
4043 offset, int whence);,  Off_t           (*Tell)(PerlIO *f);,  IV
4044    (*Close)(PerlIO *f);,  IV               (*Flush)(PerlIO *f);,  IV
4045        (*Fill)(PerlIO *f);,  IV                (*Eof)(PerlIO *f);,  IV
4046    (*Error)(PerlIO *f);,  void             (*Clearerr)(PerlIO *f);,  void
4047        (*Setlinebuf)(PerlIO *f);,  STDCHAR *   (*Get_base)(PerlIO *f);,
4048 Size_t                (*Get_bufsiz)(PerlIO *f);,  STDCHAR *
4049 (*Get_ptr)(PerlIO *f);,  SSize_t        (*Get_cnt)(PerlIO *f);,  void
4050     (*Set_ptrcnt)(PerlIO *f,STDCHAR *ptr,SSize_t cnt);
4051
4052 =item Core Layers
4053
4054 "unix", "perlio", "stdio", "crlf", "mmap", "pending", "raw", "utf8"
4055
4056 =item Extension Layers
4057
4058 ":encoding", ":Scalar", ":Object" or ":Perl"
4059
4060 =back
4061
4062 =back
4063
4064 =head2 perlapio - perl's IO abstraction interface.
4065
4066 =over 4
4067
4068 =item SYNOPSIS
4069
4070 =item DESCRIPTION
4071
4072 1. USE_STDIO, 2. USE_SFIO, 3. USE_PERLIO, B<PerlIO_stdin()>,
4073 B<PerlIO_stdout()>, B<PerlIO_stderr()>, B<PerlIO_open(path, mode)>,
4074 B<PerlIO_fdopen(fd,mode)>, B<PerlIO_reopen(path,mode,f)>,
4075 B<PerlIO_printf(f,fmt,...)>, B<PerlIO_vprintf(f,fmt,a)>,
4076 B<PerlIO_stdoutf(fmt,...)>, B<PerlIO_read(f,buf,count)>,
4077 B<PerlIO_write(f,buf,count)>, B<PerlIO_close(f)>, B<PerlIO_puts(f,s)>,
4078 B<PerlIO_putc(f,c)>, B<PerlIO_ungetc(f,c)>, B<PerlIO_getc(f)>,
4079 B<PerlIO_eof(f)>, B<PerlIO_error(f)>, B<PerlIO_fileno(f)>,
4080 B<PerlIO_clearerr(f)>, B<PerlIO_flush(f)>, B<PerlIO_seek(f,offset,whence)>,
4081 B<PerlIO_tell(f)>, B<PerlIO_getpos(f,p)>, B<PerlIO_setpos(f,p)>,
4082 B<PerlIO_rewind(f)>, B<PerlIO_tmpfile()>, B<PerlIO_setlinebuf(f)>
4083
4084 =over 4
4085
4086 =item Co-existence with stdio
4087
4088 B<PerlIO_importFILE(f,flags)>, B<PerlIO_exportFILE(f,flags)>,
4089 B<PerlIO_findFILE(f)>, B<PerlIO_releaseFILE(p,f)>
4090
4091 =item "Fast gets" Functions
4092
4093 B<PerlIO_fast_gets(f)>, B<PerlIO_has_cntptr(f)>, B<PerlIO_get_cnt(f)>,
4094 B<PerlIO_get_ptr(f)>, B<PerlIO_set_ptrcnt(f,p,c)>, B<PerlIO_canset_cnt(f)>,
4095 B<PerlIO_set_cnt(f,c)>, B<PerlIO_has_base(f)>, B<PerlIO_get_base(f)>,
4096 B<PerlIO_get_bufsiz(f)>
4097
4098 =item Other Functions
4099
4100 PerlIO_apply_layers(f,mode,layers), PerlIO_binmode(f,ptype,imode,layers),
4101 'E<lt>' read, 'E<gt>' write, '+' read/write, PerlIO_debug(fmt,...)
4102
4103 =back
4104
4105 =back
4106
4107 =head2 perltodo - Perl TO-DO List
4108
4109 =over 4
4110
4111 =item DESCRIPTION
4112
4113 =item To do during 5.6.x
4114
4115 =over 4
4116
4117 =item Support for I/O disciplines
4118
4119 =item Autoload bytes.pm
4120
4121 =item Make "\u{XXXX}" et al work
4122
4123 =item Create a char *sv_pvprintify(sv, STRLEN *lenp, UV flags)
4124
4125 =item Overloadable regex assertions
4126
4127 =item Unicode
4128
4129 =item use Thread for iThreads
4130
4131 =item make perl_clone optionally clone ops
4132
4133 =item Work out exit/die semantics for threads
4134
4135 =item Typed lexicals for compiler
4136
4137 =item Compiler workarounds for Win32
4138
4139 =item AUTOLOADing in the compiler
4140
4141 =item Fixing comppadlist when compiling
4142
4143 =item Cleaning up exported namespace
4144
4145 =item Complete signal handling
4146
4147 =item Out-of-source builds
4148
4149 =item POSIX realtime support
4150
4151 =item UNIX98 support
4152
4153 =item IPv6 Support
4154
4155 =item Long double conversion
4156
4157 =item Locales
4158
4159 =item Thread-safe regexes
4160
4161 =item Arithmetic on non-Arabic numerals
4162
4163 =item POSIX Unicode character classes
4164
4165 =item Factoring out common suffices/prefices in regexps (trie optimization)
4166
4167 =item Security audit shipped utilities
4168
4169 =item Custom opcodes
4170
4171 =item spawnvp() on Win32
4172
4173 =item DLL Versioning
4174
4175 =item Introduce @( and @)
4176
4177 =item Floating point handling
4178
4179 =item IV/UV preservation
4180
4181 =item Replace pod2html with something using Pod::Parser
4182
4183 =item Automate module testing on CPAN
4184
4185 =item sendmsg and recvmsg
4186
4187 =item Rewrite perlre documentation
4188
4189 =item Convert example code to IO::Handle filehandles
4190
4191 =item Document Win32 choices
4192
4193 =item Check new modules
4194
4195 =item Make roffitall find pods and libs itself
4196
4197 =back
4198
4199 =item To do at some point
4200
4201 =over 4
4202
4203 =item Remove regular expression recursion
4204
4205 =item Memory leaks after failed eval
4206
4207 =item pack "(stuff)*"
4208
4209 =item bitfields in pack
4210
4211 =item Cross compilation
4212
4213 =item Perl preprocessor / macros
4214
4215 =item Perl lexer in Perl
4216
4217 =item Using POSIX calls internally
4218
4219 =item -i rename file when changed
4220
4221 =item All ARGV input should act like E<lt>E<gt>
4222
4223 =item Support for rerunning debugger
4224
4225 =item Test Suite for the Debugger
4226
4227 =item my sub foo { }
4228
4229 =item One-pass global destruction
4230
4231 =item Rewrite regexp parser
4232
4233 =item Cache recently used regexps
4234
4235 =item Re-entrant functions
4236
4237 =item Cross-compilation support
4238
4239 =item Bit-shifting bitvectors
4240
4241 =item debugger pragma
4242
4243 =item use less pragma
4244
4245 =item switch structures
4246
4247 =item Cache eval tree
4248
4249 =item rcatmaybe
4250
4251 =item Shrink opcode tables
4252
4253 =item Optimize away @_
4254
4255 =item Prototypes versus indirect objects
4256
4257 =item Install HMTL
4258
4259 =item Prototype method calls
4260
4261 =item Return context prototype declarations
4262
4263 =item magic_setisa
4264
4265 =item Garbage collection
4266
4267 =item IO tutorial
4268
4269 =item pack/unpack tutorial
4270
4271 =item Rewrite perldoc
4272
4273 =item Install .3p manpages
4274
4275 =item Unicode tutorial
4276
4277 =item Update POSIX.pm for 1003.1-2
4278
4279 =item Retargetable installation
4280
4281 =item POSIX emulation on non-POSIX systems
4282
4283 =item Rename Win32 headers
4284
4285 =item Finish off lvalue functions
4286
4287 =item Update sprintf documentation
4288
4289 =item Use fchown/fchmod internally
4290
4291 =back
4292
4293 =item Vague ideas
4294
4295 =over 4
4296
4297 =item ref() in list context
4298
4299 =item Make tr/// return histogram of characters in list context
4300
4301 =item Compile to real threaded code
4302
4303 =item Structured types
4304
4305 =item Modifiable $1 et al.
4306
4307 =item Procedural interfaces for IO::*, etc.
4308
4309 =item RPC modules
4310
4311 =item Attach/detach debugger from running program
4312
4313 =item Alternative RE syntax module
4314
4315 =item GUI::Native
4316
4317 =item foreach(reverse ...)
4318
4319 =item Constant function cache
4320
4321 =item Approximate regular expression matching
4322
4323 =back
4324
4325 =item Ongoing
4326
4327 =over 4
4328
4329 =item Update guts documentation
4330
4331 =item Add more tests
4332
4333 =item Update auxiliary tools
4334
4335 =back
4336
4337 =item Recently done things
4338
4339 =over 4
4340
4341 =item Safe signal handling
4342
4343 =item Tie Modules
4344
4345 =item gettimeofday
4346
4347 =item setitimer and getimiter
4348
4349 =item Testing __DIE__ hook
4350
4351 =item CPP equivalent in Perl
4352
4353 =item Explicit switch statements
4354
4355 =item autocroak
4356
4357 =item UTF/EBCDIC
4358
4359 =item UTF Regexes
4360
4361 =item perlcc to produce executable
4362
4363 =item END blocks saved in compiled output
4364
4365 =item Secure temporary file module
4366
4367 =item Integrate Time::HiRes
4368
4369 =item Turn Cwd into XS
4370
4371 =item Mmap for input
4372
4373 =item Byte to/from UTF8 and UTF8 to/from local conversion
4374
4375 =item Add sockatmark support
4376
4377 =item Mailing list archives
4378
4379 =item Bug tracking
4380
4381 =item Integrate MacPerl
4382
4383 =item Web "nerve center" for Perl
4384
4385 =item Regular expression tutorial
4386
4387 =item Debugging Tutorial
4388
4389 =item Integrate new modules
4390
4391 =item Integrate profiler
4392
4393 =item Y2K error detection
4394
4395 =item Regular expression debugger
4396
4397 =item POD checker
4398
4399 =item "Dynamic" lexicals
4400
4401 =item Cache precompiled modules
4402
4403 =back
4404
4405 =item Deprecated Wishes
4406
4407 =over 4
4408
4409 =item Loop control on do{}
4410
4411 =item Lexically scoped typeglobs
4412
4413 =item format BOTTOM
4414
4415 =item report HANDLE
4416
4417 =item Generalised want()/caller())
4418
4419 =item Named prototypes
4420
4421 =item Built-in globbing
4422
4423 =item Regression tests for suidperl
4424
4425 =item Cached hash values
4426
4427 =item Add compression modules
4428
4429 =item Reorganise documentation into tutorials/references
4430
4431 =item Remove distinction between functions and operators
4432
4433 =item Make XS easier to use
4434
4435 =item Make embedding easier to use
4436
4437 =item man for perl
4438
4439 =item my $Package::variable
4440
4441 =item "or" tests defined, not truth
4442
4443 =item "class"-based lexicals
4444
4445 =item byteperl
4446
4447 =item Lazy evaluation / tail recursion removal
4448
4449 =item Make "use utf8" the default
4450
4451 =item Unicode collation and normalization
4452
4453 =back
4454
4455 =back
4456
4457 =head2 perlhack - How to hack at the Perl internals
4458
4459 =over 4
4460
4461 =item DESCRIPTION
4462
4463 Does concept match the general goals of Perl?, Where is the
4464 implementation?, Backwards compatibility, Could it be a module instead?, Is
4465 the feature generic enough?, Does it potentially introduce new bugs?, Does
4466 it preclude other desirable features?, Is the implementation robust?, Is
4467 the implementation generic enough to be portable?, Is there enough
4468 documentation?, Is there another way to do it?, Does it create too much
4469 work?, Patches speak louder than words
4470
4471 =over 4
4472
4473 =item Keeping in sync
4474
4475 rsync'ing the source tree, Using rsync over the LAN, Using pushing over the
4476 NFS, rsync'ing the patches
4477
4478 =item Why rsync the source tree
4479
4480 It's easier to rsync the source tree, It's more recent, It's more reliable
4481
4482 =item Why rsync the patches
4483
4484 It's easier to rsync the patches, It's a good reference, Finding a start
4485 point, Finding how to fix a bug, Finding the source of misbehaviour
4486
4487 =item Submitting patches
4488
4489 L<perlguts>, L<perlxstut> and L<perlxs>, L<perlapi>,
4490 F<Porting/pumpkin.pod>, The perl5-porters FAQ
4491
4492 =item Finding Your Way Around
4493
4494 Core modules, Tests, Documentation, Configure, Interpreter
4495
4496 =item Elements of the interpreter
4497
4498 Startup, Parsing, Optimization, Running
4499
4500 =item Internal Variable Types
4501
4502 =item Op Trees
4503
4504 =item Stacks
4505
4506 Argument stack, Mark stack, Save stack
4507
4508 =item Millions of Macros
4509
4510 =item Poking at Perl
4511
4512 =item Using a source-level debugger
4513
4514 run [args], break function_name, break source.c:xxx, step, next, continue,
4515 finish, 'enter', print
4516
4517 =item Dumping Perl Data Structures
4518
4519 =item Patching
4520
4521 =item Patching a core module
4522
4523 =item Adding a new function to the core
4524
4525 =item Writing a test
4526
4527 F<t/base/>, F<t/cmd/>, F<t/comp/>, F<t/io/>, F<t/lib/>, F<t/op/>,
4528 F<t/pod/>, F<t/run/>
4529
4530 =back
4531
4532 =item EXTERNAL TOOLS FOR DEBUGGING PERL
4533
4534 =over 4
4535
4536 =item Rational Software's Purify
4537
4538 =item Purify on Unix
4539
4540 -Accflags=-DPURIFY, -Doptimize='-g', -Uusemymalloc, -Dusemultiplicity
4541
4542 =item Purify on NT
4543
4544 DEFINES, USE_MULTI = define, #PERL_MALLOC = define, CFG = Debug
4545
4546 =item Compaq's/Digital's Third Degree
4547
4548 =item PERL_DESTRUCT_LEVEL
4549
4550 =item Profiling
4551
4552 =item Gprof Profiling
4553
4554 -a, -b, -e routine, -f routine, -s, -z
4555
4556 =item GCC gcov Profiling
4557
4558 =item Pixie Profiling
4559
4560 -h, -l, -p[rocedures], -h[eavy], -i[nvocations], -l[ines], -testcoverage,
4561 -z[ero]
4562
4563 =item CONCLUSION
4564
4565 I<The Road goes ever on and on, down from the door where it began.>
4566
4567 =back
4568
4569 =item AUTHOR
4570
4571 =back
4572
4573 =head2 perlhist - the Perl history records
4574
4575 =over 4
4576
4577 =item DESCRIPTION
4578
4579 =item INTRODUCTION
4580
4581 =item THE KEEPERS OF THE PUMPKIN
4582
4583 =over 4
4584
4585 =item PUMPKIN?
4586
4587 =back
4588
4589 =item THE RECORDS
4590
4591 =over 4
4592
4593 =item SELECTED RELEASE SIZES
4594
4595 =item SELECTED PATCH SIZES
4596
4597 =back
4598
4599 =item THE KEEPERS OF THE RECORDS
4600
4601 =back
4602
4603 =head2 perldelta - what will be new for perl v5.8.0
4604
4605 =over 4
4606
4607 =item DESCRIPTION
4608
4609 =item Reporting Bugs
4610
4611 =item SEE ALSO
4612
4613 =item HISTORY
4614
4615 =back
4616
4617 =head2 perl572delta - what's new for perl v5.7.2
4618
4619 =over 4
4620
4621 =item DESCRIPTION
4622
4623 =item Security Vulnerability Closed
4624
4625 =item Incompatible Changes
4626
4627 =over 4
4628
4629 =item 64-bit platforms and malloc
4630
4631 =item AIX Dynaloading
4632
4633 =item Socket Extension Dynamic in VMS
4634
4635 =item Different Definition of the Unicode Character Classes \p{In...}
4636
4637 =item Deprecations
4638
4639 =back
4640
4641 =item Core Enhancements
4642
4643 =item Modules and Pragmata
4644
4645 =over 4
4646
4647 =item New Modules and Distributions
4648
4649 =item Updated And Improved Modules and Pragmata
4650
4651 =back
4652
4653 =item Utility Changes
4654
4655 =item New Documentation
4656
4657 =item Installation and Configuration Improvements
4658
4659 =over 4
4660
4661 =item New Or Improved Platforms
4662
4663 =item Generic Improvements
4664
4665 =back
4666
4667 =item Selected Bug Fixes
4668
4669 =over 4
4670
4671 =item Platform Specific Changes and Fixes
4672
4673 =back
4674
4675 =item New or Changed Diagnostics
4676
4677 =item Source Code Enhancements
4678
4679 =over 4
4680
4681 =item MAGIC constants
4682
4683 =item Better commented code
4684
4685 =item Regex pre-/post-compilation items matched up
4686
4687 =item gcc -Wall
4688
4689 =back
4690
4691 =item New Tests
4692
4693 =item Known Problems
4694
4695 =over 4
4696
4697 =item AIX
4698
4699 =item Amiga Perl Invoking Mystery
4700
4701 =item lib/ftmp-security tests warn 'system possibly insecure'
4702
4703 =item Cygwin intermittent failures of lib/Memoize/t/expire_file 11 and 12
4704
4705 =item HP-UX lib/io_multihomed Fails When LP64-Configur
4706
4707 =item  HP-UX lib/posix Subtest 9 Fails When LP64-Configured
4708
4709 =item Linux With Sfio Fails op/misc Test 48
4710
4711 =item OS/390
4712
4713 =item op/sprintf tests 129 and 130
4714
4715 =item  Failure of Thread tests
4716
4717 =item UNICOS
4718
4719 =item UTS
4720
4721 =item VMS
4722
4723 =item Win32
4724
4725 =item Localising a Tied Variable Leaks Memory
4726
4727 =item Self-tying of Arrays and Hashes Is Forbidden
4728
4729 =item Variable Attributes are not Currently Usable for Tieing
4730
4731 =item Building Extensions Can Fail Because Of Largefiles
4732
4733 =item The Compiler Suite Is Still Experimental
4734
4735 =item The Long Double Support is Still Experimental
4736
4737 =back
4738
4739 =item Reporting Bugs
4740
4741 =item SEE ALSO
4742
4743 =item HISTORY
4744
4745 =back
4746
4747 =head2 perl571delta - what's new for perl v5.7.1
4748
4749 =over 4
4750
4751 =item DESCRIPTION
4752
4753 =item Security Vulnerability Closed
4754
4755 =item Incompatible Changes
4756
4757 =item Core Enhancements
4758
4759 =over 4
4760
4761 =item AUTOLOAD Is Now Lvaluable
4762
4763 =item PerlIO is Now The Default
4764
4765 =item Signals Are Now Safe
4766
4767 =back
4768
4769 =item Modules and Pragmata
4770
4771 =over 4
4772
4773 =item New Modules
4774
4775 =item Updated And Improved Modules and Pragmata
4776
4777 =back
4778
4779 =item Performance Enhancements
4780
4781 =item Utility Changes
4782
4783 =item New Documentation
4784
4785 =over 4
4786
4787 =item perlclib
4788
4789 =item perliol
4790
4791 =item README.aix
4792
4793 =item README.bs2000
4794
4795 =item README.macos
4796
4797 =item README.mpeix
4798
4799 =item README.solaris
4800
4801 =item README.vos
4802
4803 =item Porting/repository.pod
4804
4805 =back
4806
4807 =item Installation and Configuration Improvements
4808
4809 =over 4
4810
4811 =item New Or Improved Platforms
4812
4813 =item Generic Improvements
4814
4815 d_cmsghdr, d_fcntl_can_lock, d_fsync, d_getitimer, d_getpagsz, d_msghdr_s,
4816 need_va_copy, d_readv, d_recvmsg, d_sendmsg, sig_size, d_sockatmark,
4817 d_strtoq, d_u32align, d_ualarm, d_usleep
4818
4819 =back
4820
4821 =item Selected Bug Fixes
4822
4823 =over 4
4824
4825 =item Platform Specific Changes and Fixes
4826
4827 =back
4828
4829 =item New or Changed Diagnostics
4830
4831 =item Changed Internals
4832
4833 =item New Tests
4834
4835 =item Known Problems
4836
4837 =over 4
4838
4839 =item AIX vac 5.0.0.0 May Produce Buggy Code For Perl
4840
4841 =item lib/ftmp-security tests warn 'system possibly insecure'
4842
4843 =item lib/io_multihomed Fails In LP64-Configured HP-UX
4844
4845 =item Test lib/posix Subtest 9 Fails In LP64-Configured HP-UX
4846
4847 =item lib/b test 19
4848
4849 =item Linux With Sfio Fails op/misc Test 48
4850
4851 =item sigaction test 13 in VMS
4852
4853 =item sprintf tests 129 and 130
4854
4855 =item  Failure of Thread tests
4856
4857 =item Localising a Tied Variable Leaks Memory
4858
4859 =item Self-tying of Arrays and Hashes Is Forbidden
4860
4861 =item Building Extensions Can Fail Because Of Largefiles
4862
4863 =item The Compiler Suite Is Still Experimental
4864
4865 =back
4866
4867 =item Reporting Bugs
4868
4869 =item SEE ALSO
4870
4871 =item HISTORY
4872
4873 =back
4874
4875 =head2 perl570delta - what's new for perl v5.7.0
4876
4877 =over 4
4878
4879 =item DESCRIPTION
4880
4881 =item Security Vulnerability Closed
4882
4883 =item Incompatible Changes
4884
4885 =item Core Enhancements
4886
4887 =item Modules and Pragmata
4888
4889 =over 4
4890
4891 =item New Modules
4892
4893 =item Updated And Improved Modules and Pragmata
4894
4895 =back
4896
4897 =item Utility Changes
4898
4899 =item New Documentation
4900
4901 =item Performance Enhancements
4902
4903 =item Installation and Configuration Improvements
4904
4905 =over 4
4906
4907 =item Generic Improvements
4908
4909 =back
4910
4911 =item Selected Bug Fixes
4912
4913 =over 4
4914
4915 =item Platform Specific Changes and Fixes
4916
4917 =back
4918
4919 =item New or Changed Diagnostics
4920
4921 =item Changed Internals
4922
4923 =item Known Problems
4924
4925 =over 4
4926
4927 =item Unicode Support Still Far From Perfect
4928
4929 =item EBCDIC Still A Lost Platform
4930
4931 =item Building Extensions Can Fail Because Of Largefiles
4932
4933 =item ftmp-security tests warn 'system possibly insecure'
4934
4935 =item Test lib/posix Subtest 9 Fails In LP64-Configured HP-UX
4936
4937 =item Long Doubles Still Don't Work In Solaris
4938
4939 =item Linux With Sfio Fails op/misc Test 48
4940
4941 =item Storable tests fail in some platforms
4942
4943 =item Threads Are Still Experimental
4944
4945 =item The Compiler Suite Is Still Experimental
4946
4947 =back
4948
4949 =item Reporting Bugs
4950
4951 =item SEE ALSO
4952
4953 =item HISTORY
4954
4955 =back
4956
4957 =head2 perl56delta, perldelta - what's new for perl v5.6.0
4958
4959 =over 4
4960
4961 =item DESCRIPTION
4962
4963 =item Core Enhancements
4964
4965 =over 4
4966
4967 =item Interpreter cloning, threads, and concurrency
4968
4969 =item Lexically scoped warning categories
4970
4971 =item Unicode and UTF-8 support
4972
4973 =item Support for interpolating named characters
4974
4975 =item "our" declarations
4976
4977 =item Support for strings represented as a vector of ordinals
4978
4979 =item Improved Perl version numbering system
4980
4981 =item New syntax for declaring subroutine attributes
4982
4983 =item File and directory handles can be autovivified
4984
4985 =item open() with more than two arguments
4986
4987 =item 64-bit support
4988
4989 =item Large file support
4990
4991 =item Long doubles
4992
4993 =item "more bits"
4994
4995 =item Enhanced support for sort() subroutines
4996
4997 =item C<sort $coderef @foo> allowed
4998
4999 =item File globbing implemented internally
5000
5001 =item Support for CHECK blocks
5002
5003 =item POSIX character class syntax [: :] supported
5004
5005 =item Better pseudo-random number generator
5006
5007 =item Improved C<qw//> operator
5008
5009 =item Better worst-case behavior of hashes
5010
5011 =item pack() format 'Z' supported
5012
5013 =item pack() format modifier '!' supported
5014
5015 =item pack() and unpack() support counted strings
5016
5017 =item Comments in pack() templates
5018
5019 =item Weak references
5020
5021 =item Binary numbers supported
5022
5023 =item Lvalue subroutines
5024
5025 =item Some arrows may be omitted in calls through references
5026
5027 =item Boolean assignment operators are legal lvalues
5028
5029 =item exists() is supported on subroutine names
5030
5031 =item exists() and delete() are supported on array elements
5032
5033 =item Pseudo-hashes work better
5034
5035 =item Automatic flushing of output buffers
5036
5037 =item Better diagnostics on meaningless filehandle operations
5038
5039 =item Where possible, buffered data discarded from duped input filehandle
5040
5041 =item eof() has the same old magic as <>
5042
5043 =item binmode() can be used to set :crlf and :raw modes
5044
5045 =item C<-T> filetest recognizes UTF-8 encoded files as "text"
5046
5047 =item system(), backticks and pipe open now reflect exec() failure
5048
5049 =item Improved diagnostics
5050
5051 =item Diagnostics follow STDERR
5052
5053 =item More consistent close-on-exec behavior
5054
5055 =item syswrite() ease-of-use
5056
5057 =item Better syntax checks on parenthesized unary operators
5058
5059 =item Bit operators support full native integer width
5060
5061 =item Improved security features
5062
5063 =item More functional bareword prototype (*)
5064
5065 =item C<require> and C<do> may be overridden
5066
5067 =item $^X variables may now have names longer than one character
5068
5069 =item New variable $^C reflects C<-c> switch
5070
5071 =item New variable $^V contains Perl version as a string
5072
5073 =item Optional Y2K warnings
5074
5075 =item Arrays now always interpolate into double-quoted strings
5076
5077 =back
5078
5079 =item Modules and Pragmata
5080
5081 =over 4
5082
5083 =item Modules
5084
5085 attributes, B, Benchmark, ByteLoader, constant, charnames, Data::Dumper,
5086 DB, DB_File, Devel::DProf, Devel::Peek, Dumpvalue, DynaLoader, English,
5087 Env, Fcntl, File::Compare, File::Find, File::Glob, File::Spec,
5088 File::Spec::Functions, Getopt::Long, IO, JPL, lib, Math::BigInt,
5089 Math::Complex, Math::Trig, Pod::Parser, Pod::InputObjects, Pod::Checker,
5090 podchecker, Pod::ParseUtils, Pod::Find, Pod::Select, podselect, Pod::Usage,
5091 pod2usage, Pod::Text and Pod::Man, SDBM_File, Sys::Syslog, Sys::Hostname,
5092 Term::ANSIColor, Time::Local, Win32, XSLoader, DBM Filters
5093
5094 =item Pragmata
5095
5096 =back
5097
5098 =item Utility Changes
5099
5100 =over 4
5101
5102 =item dprofpp
5103
5104 =item find2perl
5105
5106 =item h2xs
5107
5108 =item perlcc
5109
5110 =item perldoc
5111
5112 =item The Perl Debugger
5113
5114 =back
5115
5116 =item Improved Documentation
5117
5118 perlapi.pod, perlboot.pod, perlcompile.pod, perldbmfilter.pod,
5119 perldebug.pod, perldebguts.pod, perlfork.pod, perlfilter.pod, perlhack.pod,
5120 perlintern.pod, perllexwarn.pod, perlnumber.pod, perlopentut.pod,
5121 perlreftut.pod, perltootc.pod, perltodo.pod, perlunicode.pod
5122
5123 =item Performance enhancements
5124
5125 =over 4
5126
5127 =item Simple sort() using { $a <=> $b } and the like are optimized
5128
5129 =item Optimized assignments to lexical variables
5130
5131 =item Faster subroutine calls
5132
5133 =item delete(), each(), values() and hash iteration are faster
5134
5135 =back
5136
5137 =item Installation and Configuration Improvements
5138
5139 =over 4
5140
5141 =item -Dusethreads means something different
5142
5143 =item New Configure flags
5144
5145 =item Threadedness and 64-bitness now more daring
5146
5147 =item Long Doubles
5148
5149 =item -Dusemorebits
5150
5151 =item -Duselargefiles
5152
5153 =item installusrbinperl
5154
5155 =item SOCKS support
5156
5157 =item C<-A> flag
5158
5159 =item Enhanced Installation Directories
5160
5161 =back
5162
5163 =item Platform specific changes
5164
5165 =over 4
5166
5167 =item Supported platforms
5168
5169 =item DOS
5170
5171 =item OS390 (OpenEdition MVS)
5172
5173 =item VMS
5174
5175 =item Win32
5176
5177 =back
5178
5179 =item Significant bug fixes
5180
5181 =over 4
5182
5183 =item <HANDLE> on empty files
5184
5185 =item C<eval '...'> improvements
5186
5187 =item All compilation errors are true errors
5188
5189 =item Implicitly closed filehandles are safer
5190
5191 =item Behavior of list slices is more consistent
5192
5193 =item C<(\$)> prototype and C<$foo{a}>
5194
5195 =item C<goto &sub> and AUTOLOAD
5196
5197 =item C<-bareword> allowed under C<use integer>
5198
5199 =item Failures in DESTROY()
5200
5201 =item Locale bugs fixed
5202
5203 =item Memory leaks
5204
5205 =item Spurious subroutine stubs after failed subroutine calls
5206
5207 =item Taint failures under C<-U>
5208
5209 =item END blocks and the C<-c> switch
5210
5211 =item Potential to leak DATA filehandles
5212
5213 =back
5214
5215 =item New or Changed Diagnostics
5216
5217 "%s" variable %s masks earlier declaration in same %s, "my sub" not yet
5218 implemented, "our" variable %s redeclared, '!' allowed only after types %s,
5219 / cannot take a count, / must be followed by a, A or Z, / must be followed
5220 by a*, A* or Z*, / must follow a numeric type, /%s/: Unrecognized escape
5221 \\%c passed through, /%s/: Unrecognized escape \\%c in character class
5222 passed through, /%s/ should probably be written as "%s", %s() called too
5223 early to check prototype, %s argument is not a HASH or ARRAY element, %s
5224 argument is not a HASH or ARRAY element or slice, %s argument is not a
5225 subroutine name, %s package attribute may clash with future reserved word:
5226 %s, (in cleanup) %s, <> should be quotes, Attempt to join self, Bad evalled
5227 substitution pattern, Bad realloc() ignored, Bareword found in conditional,
5228 Binary number > 0b11111111111111111111111111111111 non-portable, Bit vector
5229 size > 32 non-portable, Buffer overflow in prime_env_iter: %s, Can't check
5230 filesystem of script "%s", Can't declare class for non-scalar %s in "%s",
5231 Can't declare %s in "%s", Can't ignore signal CHLD, forcing to default,
5232 Can't modify non-lvalue subroutine call, Can't read CRTL environ, Can't
5233 remove %s: %s, skipping file, Can't return %s from lvalue subroutine, Can't
5234 weaken a nonreference, Character class [:%s:] unknown, Character class
5235 syntax [%s] belongs inside character classes, Constant is not %s reference,
5236 constant(%s): %s, CORE::%s is not a keyword, defined(@array) is deprecated,
5237 defined(%hash) is deprecated, Did not produce a valid header, (Did you mean
5238 "local" instead of "our"?), Document contains no data, entering effective
5239 %s failed, false [] range "%s" in regexp, Filehandle %s opened only for
5240 output, flock() on closed filehandle %s, Global symbol "%s" requires
5241 explicit package name, Hexadecimal number > 0xffffffff non-portable,
5242 Ill-formed CRTL environ value "%s", Ill-formed message in prime_env_iter:
5243 |%s|, Illegal binary digit %s, Illegal binary digit %s ignored, Illegal
5244 number of bits in vec, Integer overflow in %s number, Invalid %s attribute:
5245 %s, Invalid %s attributes: %s, invalid [] range "%s" in regexp, Invalid
5246 separator character %s in attribute list, Invalid separator character %s in
5247 subroutine attribute list, leaving effective %s failed, Lvalue subs
5248 returning %s not implemented yet, Method %s not permitted, Missing
5249 %sbrace%s on \N{}, Missing command in piped open, Missing name in "my sub",
5250 No %s specified for -%c, No package name allowed for variable %s in "our",
5251 No space allowed after -%c, no UTC offset information; assuming local time
5252 is UTC, Octal number > 037777777777 non-portable, panic: del_backref,
5253 panic: kid popen errno read, panic: magic_killbackrefs, Parentheses missing
5254 around "%s" list, Possible unintended interpolation of %s in string,
5255 Possible Y2K bug: %s, pragma "attrs" is deprecated, use "sub NAME : ATTRS"
5256 instead, Premature end of script headers, Repeat count in pack overflows,
5257 Repeat count in unpack overflows, realloc() of freed memory ignored,
5258 Reference is already weak, setpgrp can't take arguments, Strange *+?{} on
5259 zero-length expression, switching effective %s is not implemented, This
5260 Perl can't reset CRTL environ elements (%s), This Perl can't set CRTL
5261 environ elements (%s=%s), Too late to run %s block, Unknown open() mode
5262 '%s', Unknown process %x sent message to prime_env_iter: %s, Unrecognized
5263 escape \\%c passed through, Unterminated attribute parameter in attribute
5264 list, Unterminated attribute list, Unterminated attribute parameter in
5265 subroutine attribute list, Unterminated subroutine attribute list, Value of
5266 CLI symbol "%s" too long, Version number must be a constant number
5267
5268 =item New tests
5269
5270 =item Incompatible Changes
5271
5272 =over 4
5273
5274 =item Perl Source Incompatibilities
5275
5276 CHECK is a new keyword, Treatment of list slices of undef has changed,
5277 Format of $English::PERL_VERSION is different, Literals of the form
5278 C<1.2.3> parse differently, Possibly changed pseudo-random number
5279 generator, Hashing function for hash keys has changed, C<undef> fails on
5280 read only values, Close-on-exec bit may be set on pipe and socket handles,
5281 Writing C<"$$1"> to mean C<"${$}1"> is unsupported, delete(), each(),
5282 values() and C<\(%h)>, vec(EXPR,OFFSET,BITS) enforces powers-of-two BITS,
5283 Text of some diagnostic output has changed, C<%@> has been removed,
5284 Parenthesized not() behaves like a list operator, Semantics of bareword
5285 prototype C<(*)> have changed, Semantics of bit operators may have changed
5286 on 64-bit platforms, More builtins taint their results
5287
5288 =item C Source Incompatibilities
5289
5290 C<PERL_POLLUTE>, C<PERL_IMPLICIT_CONTEXT>, C<PERL_POLLUTE_MALLOC>
5291
5292 =item Compatible C Source API Changes
5293
5294 C<PATCHLEVEL> is now C<PERL_VERSION>
5295
5296 =item Binary Incompatibilities
5297
5298 =back
5299
5300 =item Known Problems
5301
5302 =over 4
5303
5304 =item Thread test failures
5305
5306 =item EBCDIC platforms not supported
5307
5308 =item In 64-bit HP-UX the lib/io_multihomed test may hang
5309
5310 =item NEXTSTEP 3.3 POSIX test failure
5311
5312 =item Tru64 (aka Digital UNIX, aka DEC OSF/1) lib/sdbm test failure with
5313 gcc
5314
5315 =item UNICOS/mk CC failures during Configure run
5316
5317 =item Arrow operator and arrays
5318
5319 =item Experimental features
5320
5321 Threads, Unicode, 64-bit support, Lvalue subroutines, Weak references, The
5322 pseudo-hash data type, The Compiler suite, Internal implementation of file
5323 globbing, The DB module, The regular expression code constructs:
5324
5325 =back
5326
5327 =item Obsolete Diagnostics
5328
5329 Character class syntax [: :] is reserved for future extensions, Ill-formed
5330 logical name |%s| in prime_env_iter, In string, @%s now must be written as
5331 \@%s, Probable precedence problem on %s, regexp too big, Use of "$$<digit>"
5332 to mean "${$}<digit>" is deprecated
5333
5334 =item Reporting Bugs
5335
5336 =item SEE ALSO
5337
5338 =item HISTORY
5339
5340 =back
5341
5342 =head2 perl5005delta, perldelta - what's new for perl5.005
5343
5344 =over 4
5345
5346 =item DESCRIPTION
5347
5348 =item About the new versioning system
5349
5350 =item Incompatible Changes
5351
5352 =over 4
5353
5354 =item WARNING:  This version is not binary compatible with Perl 5.004.
5355
5356 =item Default installation structure has changed
5357
5358 =item Perl Source Compatibility
5359
5360 =item C Source Compatibility
5361
5362 =item Binary Compatibility
5363
5364 =item Security fixes may affect compatibility
5365
5366 =item Relaxed new mandatory warnings introduced in 5.004
5367
5368 =item Licensing
5369
5370 =back
5371
5372 =item Core Changes
5373
5374 =over 4
5375
5376 =item Threads
5377
5378 =item Compiler
5379
5380 =item Regular Expressions
5381
5382 Many new and improved optimizations, Many bug fixes, New regular expression
5383 constructs, New operator for precompiled regular expressions, Other
5384 improvements, Incompatible changes
5385
5386 =item   Improved malloc()
5387
5388 =item Quicksort is internally implemented
5389
5390 =item Reliable signals
5391
5392 =item Reliable stack pointers
5393
5394 =item More generous treatment of carriage returns
5395
5396 =item Memory leaks
5397
5398 =item Better support for multiple interpreters
5399
5400 =item Behavior of local() on array and hash elements is now well-defined
5401
5402 =item C<%!> is transparently tied to the L<Errno> module
5403
5404 =item Pseudo-hashes are supported
5405
5406 =item C<EXPR foreach EXPR> is supported
5407
5408 =item Keywords can be globally overridden
5409
5410 =item C<$^E> is meaningful on Win32
5411
5412 =item C<foreach (1..1000000)> optimized
5413
5414 =item C<Foo::> can be used as implicitly quoted package name
5415
5416 =item C<exists $Foo::{Bar::}> tests existence of a package
5417
5418 =item Better locale support
5419
5420 =item Experimental support for 64-bit platforms
5421
5422 =item prototype() returns useful results on builtins
5423
5424 =item Extended support for exception handling
5425
5426 =item Re-blessing in DESTROY() supported for chaining DESTROY() methods
5427
5428 =item All C<printf> format conversions are handled internally
5429
5430 =item New C<INIT> keyword
5431
5432 =item New C<lock> keyword
5433
5434 =item New C<qr//> operator
5435
5436 =item C<our> is now a reserved word
5437
5438 =item Tied arrays are now fully supported
5439
5440 =item Tied handles support is better
5441
5442 =item 4th argument to substr
5443
5444 =item Negative LENGTH argument to splice
5445
5446 =item Magic lvalues are now more magical
5447
5448 =item <> now reads in records
5449
5450 =back
5451
5452 =item Supported Platforms
5453
5454 =over 4
5455
5456 =item New Platforms
5457
5458 =item Changes in existing support
5459
5460 =back
5461
5462 =item Modules and Pragmata
5463
5464 =over 4
5465
5466 =item New Modules
5467
5468 B, Data::Dumper, Dumpvalue, Errno, File::Spec, ExtUtils::Installed,
5469 ExtUtils::Packlist, Fatal, IPC::SysV, Test, Tie::Array, Tie::Handle,
5470 Thread, attrs, fields, re
5471
5472 =item Changes in existing modules
5473
5474 Benchmark, Carp, CGI, Fcntl, Math::Complex, Math::Trig, POSIX, DB_File,
5475 MakeMaker, CPAN, Cwd
5476
5477 =back
5478
5479 =item Utility Changes
5480
5481 =item Documentation Changes
5482
5483 =item New Diagnostics
5484
5485 Ambiguous call resolved as CORE::%s(), qualify as such or use &, Bad index
5486 while coercing array into hash, Bareword "%s" refers to nonexistent
5487 package, Can't call method "%s" on an undefined value, Can't check
5488 filesystem of script "%s" for nosuid, Can't coerce array into hash, Can't
5489 goto subroutine from an eval-string, Can't localize pseudo-hash element,
5490 Can't use %%! because Errno.pm is not available, Cannot find an opnumber
5491 for "%s", Character class syntax [. .] is reserved for future extensions,
5492 Character class syntax [: :] is reserved for future extensions, Character
5493 class syntax [= =] is reserved for future extensions, %s: Eval-group in
5494 insecure regular expression, %s: Eval-group not allowed, use re 'eval', %s:
5495 Eval-group not allowed at run time, Explicit blessing to '' (assuming
5496 package main), Illegal hex digit ignored, No such array field, No such
5497 field "%s" in variable %s of type %s, Out of memory during ridiculously
5498 large request, Range iterator outside integer range, Recursive inheritance
5499 detected while looking for method '%s' %s, Reference found where even-sized
5500 list expected, Undefined value assigned to typeglob, Use of reserved word
5501 "%s" is deprecated, perl: warning: Setting locale failed
5502
5503 =item Obsolete Diagnostics
5504
5505 Can't mktemp(), Can't write to temp file for B<-e>: %s, Cannot open
5506 temporary file, regexp too big
5507
5508 =item Configuration Changes
5509
5510 =item BUGS
5511
5512 =item SEE ALSO
5513
5514 =item HISTORY
5515
5516 =back
5517
5518 =head2 perl5004delta, perldelta - what's new for perl5.004
5519
5520 =over 4
5521
5522 =item DESCRIPTION
5523
5524 =item Supported Environments
5525
5526 =item Core Changes
5527
5528 =over 4
5529
5530 =item List assignment to %ENV works
5531
5532 =item Change to "Can't locate Foo.pm in @INC" error
5533
5534 =item Compilation option: Binary compatibility with 5.003
5535
5536 =item $PERL5OPT environment variable
5537
5538 =item Limitations on B<-M>, B<-m>, and B<-T> options
5539
5540 =item More precise warnings
5541
5542 =item Deprecated: Inherited C<AUTOLOAD> for non-methods
5543
5544 =item Previously deprecated %OVERLOAD is no longer usable
5545
5546 =item Subroutine arguments created only when they're modified
5547
5548 =item Group vector changeable with C<$)>
5549
5550 =item Fixed parsing of $$<digit>, &$<digit>, etc.
5551
5552 =item Fixed localization of $<digit>, $&, etc.
5553
5554 =item No resetting of $. on implicit close
5555
5556 =item C<wantarray> may return undef
5557
5558 =item C<eval EXPR> determines value of EXPR in scalar context
5559
5560 =item Changes to tainting checks
5561
5562 No glob() or <*>, No spawning if tainted $CDPATH, $ENV, $BASH_ENV, No
5563 spawning if tainted $TERM doesn't look like a terminal name
5564
5565 =item New Opcode module and revised Safe module
5566
5567 =item Embedding improvements
5568
5569 =item Internal change: FileHandle class based on IO::* classes
5570
5571 =item Internal change: PerlIO abstraction interface
5572
5573 =item New and changed syntax
5574
5575 $coderef->(PARAMS)
5576
5577 =item New and changed builtin constants
5578
5579 __PACKAGE__
5580
5581 =item New and changed builtin variables
5582
5583 $^E, $^H, $^M
5584
5585 =item New and changed builtin functions
5586
5587 delete on slices, flock, printf and sprintf, keys as an lvalue, my() in
5588 Control Structures, pack() and unpack(), sysseek(), use VERSION, use Module
5589 VERSION LIST, prototype(FUNCTION), srand, $_ as Default, C<m//gc> does not
5590 reset search position on failure, C<m//x> ignores whitespace before ?*+{},
5591 nested C<sub{}> closures work now, formats work right on changing lexicals
5592
5593 =item New builtin methods
5594
5595 isa(CLASS), can(METHOD), VERSION( [NEED] )
5596
5597 =item TIEHANDLE now supported
5598
5599 TIEHANDLE classname, LIST, PRINT this, LIST, PRINTF this, LIST, READ this
5600 LIST, READLINE this, GETC this, DESTROY this
5601
5602 =item Malloc enhancements
5603
5604 -DPERL_EMERGENCY_SBRK, -DPACK_MALLOC, -DTWO_POT_OPTIMIZE
5605
5606 =item Miscellaneous efficiency enhancements
5607
5608 =back
5609
5610 =item Support for More Operating Systems
5611
5612 =over 4
5613
5614 =item Win32
5615
5616 =item Plan 9
5617
5618 =item QNX
5619
5620 =item AmigaOS
5621
5622 =back
5623
5624 =item Pragmata
5625
5626 use autouse MODULE => qw(sub1 sub2 sub3), use blib, use blib 'dir', use
5627 constant NAME => VALUE, use locale, use ops, use vmsish
5628
5629 =item Modules
5630
5631 =over 4
5632
5633 =item Required Updates
5634
5635 =item Installation directories
5636
5637 =item Module information summary
5638
5639 =item Fcntl
5640
5641 =item IO
5642
5643 =item Math::Complex
5644
5645 =item Math::Trig
5646
5647 =item DB_File
5648
5649 =item Net::Ping
5650
5651 =item Object-oriented overrides for builtin operators
5652
5653 =back
5654
5655 =item Utility Changes
5656
5657 =over 4
5658
5659 =item pod2html
5660
5661 Sends converted HTML to standard output
5662
5663 =item xsubpp
5664
5665 C<void> XSUBs now default to returning nothing
5666
5667 =back
5668
5669 =item C Language API Changes
5670
5671 C<gv_fetchmethod> and C<perl_call_sv>, C<perl_eval_pv>, Extended API for
5672 manipulating hashes
5673
5674 =item Documentation Changes
5675
5676 L<perldelta>, L<perlfaq>, L<perllocale>, L<perltoot>, L<perlapio>,
5677 L<perlmodlib>, L<perldebug>, L<perlsec>
5678
5679 =item New Diagnostics
5680
5681 "my" variable %s masks earlier declaration in same scope, %s argument is
5682 not a HASH element or slice, Allocation too large: %lx, Allocation too
5683 large, Applying %s to %s will act on scalar(%s), Attempt to free
5684 nonexistent shared string, Attempt to use reference as lvalue in substr,
5685 Bareword "%s" refers to nonexistent package, Can't redefine active sort
5686 subroutine %s, Can't use bareword ("%s") as %s ref while "strict refs" in
5687 use, Cannot resolve method `%s' overloading `%s' in package `%s', Constant
5688 subroutine %s redefined, Constant subroutine %s undefined, Copy method did
5689 not return a reference, Died, Exiting pseudo-block via %s, Identifier too
5690 long, Illegal character %s (carriage return), Illegal switch in PERL5OPT:
5691 %s, Integer overflow in hex number, Integer overflow in octal number,
5692 internal error: glob failed, Invalid conversion in %s: "%s", Invalid type
5693 in pack: '%s', Invalid type in unpack: '%s', Name "%s::%s" used only once:
5694 possible typo, Null picture in formline, Offset outside string, Out of
5695 memory!, Out of memory during request for %s, panic: frexp, Possible
5696 attempt to put comments in qw() list, Possible attempt to separate words
5697 with commas, Scalar value @%s{%s} better written as $%s{%s}, Stub found
5698 while resolving method `%s' overloading `%s' in %s, Too late for "B<-T>"
5699 option, untie attempted while %d inner references still exist, Unrecognized
5700 character %s, Unsupported function fork, Use of "$$<digit>" to mean
5701 "${$}<digit>" is deprecated, Value of %s can be "0"; test with defined(),
5702 Variable "%s" may be unavailable, Variable "%s" will not stay shared,
5703 Warning: something's wrong, Ill-formed logical name |%s| in prime_env_iter,
5704 Got an error from DosAllocMem, Malformed PERLLIB_PREFIX, PERL_SH_DIR too
5705 long, Process terminated by SIG%s
5706
5707 =item BUGS
5708
5709 =item SEE ALSO
5710
5711 =item HISTORY
5712
5713 =back
5714
5715 =head2 perlaix, README.aix - Perl version 5 on IBM Unix (AIX) systems
5716
5717 =over 4
5718
5719 =item DESCRIPTION
5720
5721 =over 4
5722
5723 =item Compiling Perl 5 on AIX
5724
5725 =item OS level
5726
5727 =item Building Dynamic Extensions on AIX
5728
5729 =item The IBM ANSI C Compiler
5730
5731 =item Using GNU's gcc for building perl
5732
5733 =item Using Large Files with Perl
5734
5735 =item Threaded Perl
5736
5737 =item 64-bit Perl
5738
5739 =item AIX 4.2 and extensions using C++ with statics
5740
5741 =back
5742
5743 =item AUTHOR
5744
5745 =item DATE
5746
5747 =back
5748
5749 =head2 perlapollo, README.apollo - Perl version 5 on Apollo DomainOS
5750
5751 =over 4
5752
5753 =item DESCRIPTION
5754
5755 =item AUTHOR
5756
5757 =back
5758
5759 =head2 perlamiga - Perl under Amiga OS
5760
5761 =over 4
5762
5763 =item SYNOPSIS
5764
5765 =back
5766
5767 =over 4
5768
5769 =item DESCRIPTION
5770
5771 =over 4
5772
5773 =item Prerequisites for Compiling Perl on AmigaOS
5774
5775 B<Unix emulation for AmigaOS: ixemul.library>, B<Version of Amiga OS>
5776
5777 =item Starting Perl programs under AmigaOS
5778
5779 =item Shortcomings of Perl under AmigaOS
5780
5781 =back
5782
5783 =item INSTALLATION
5784
5785 =item Accessing documentation
5786
5787 =over 4
5788
5789 =item Manpages for Perl on AmigaOS
5790
5791 =item Perl HTML Documentation on AmigaOS
5792
5793 =item Perl GNU Info Files on AmigaOS
5794
5795 =item Perl LaTeX Documentation on AmigaOS
5796
5797 =back
5798
5799 =item BUILDING PERL ON AMIGAOS
5800
5801 =over 4
5802
5803 =item Build Prerequisites for Perl on AmigaOS
5804
5805 =item Getting the Perl Source for AmigaOS
5806
5807 =item Making Perl on AmigaOS
5808
5809 =item Testing Perl on AmigaOS
5810
5811 =item Installing the built Perl on AmigaOS
5812
5813 =back
5814
5815 =item AUTHORS
5816
5817 =item SEE ALSO
5818
5819 =back
5820
5821 =head2 perlbeos, README.beos - Perl version 5 on BeOS
5822
5823 =over 4
5824
5825 =item DESCRIPTION
5826
5827 =over 4
5828
5829 =item General Issues with Perl on BeOS
5830
5831 =item BeOS Release-specific Notes
5832
5833 R4 x86, R4 PPC
5834
5835 =item Contact Information
5836
5837 =back
5838
5839 =back
5840
5841 =head2 perlbs2000, README.BS2000 - building and installing Perl for BS2000.
5842
5843 =over 4
5844
5845 =item SYNOPSIS
5846
5847 =item DESCRIPTION
5848
5849 =over 4
5850
5851 =item gzip on BS2000
5852
5853 =item bison on BS2000
5854
5855 =item Unpacking Perl Distribution on BS2000
5856
5857 =item Compiling Perl on BS2000
5858
5859 =item Testing Perl on BS2000
5860
5861 =item Installing Perl on BS2000
5862
5863 =item Using Perl in the Posix-Shell of BS2000
5864
5865 =item Using Perl in "native" BS2000
5866
5867 =item Floating point anomalies on BS2000
5868
5869 =back
5870
5871 =item AUTHORS
5872
5873 =item SEE ALSO
5874
5875 =over 4
5876
5877 =item Mailing list
5878
5879 =back
5880
5881 =item HISTORY
5882
5883 =back
5884
5885 =over 4
5886
5887 =item Name
5888
5889 =item Description
5890
5891 =item Build
5892
5893 =over 4
5894
5895 =item Tools & SDK
5896
5897 =item Make
5898
5899 =back
5900
5901 =item Acknowledgements
5902
5903 =item Author
5904
5905 =back
5906
5907 =head2 perlcygwin, README.cygwin - Perl for Cygwin
5908
5909 =over 4
5910
5911 =item SYNOPSIS
5912
5913 =item PREREQUISITES FOR COMPILING PERL ON CYGWIN
5914
5915 =over 4
5916
5917 =item Cygwin = GNU+Cygnus+Windows (Don't leave UNIX without it)
5918
5919 =item Cygwin Configuration
5920
5921 C<PATH>, I<nroff>, Permissions
5922
5923 =back
5924
5925 =item CONFIGURE PERL ON CYGWIN
5926
5927 =over 4
5928
5929 =item Stripping Perl Binaries on Cygwin
5930
5931 =item Optional Libraries for Perl on Cygwin
5932
5933 C<-lcrypt>, C<-lgdbm> (C<use GDBM_File>), C<-ldb> (C<use DB_File>),
5934 C<-lcygipc> (C<use IPC::SysV>)
5935
5936 =item Configure-time Options for Perl on Cygwin
5937
5938 C<-Uusedl>, C<-Uusemymalloc>, C<-Dusemultiplicity>, C<-Duseperlio>,
5939 C<-Duse64bitint>, C<-Duselongdouble>, C<-Dusethreads>, C<-Duselargefiles>
5940
5941 =item Suspicious Warnings on Cygwin
5942
5943 I<dlsym()>, Win9x and C<d_eofnblk>, Compiler/Preprocessor defines
5944
5945 =back
5946
5947 =item MAKE ON CYGWIN
5948
5949 =over 4
5950
5951 =item Warnings on Cygwin
5952
5953 =item ld2 on Cygwin
5954
5955 =back
5956
5957 =item TEST ON CYGWIN
5958
5959 =over 4
5960
5961 =item File Permissions on Cygwin
5962
5963 =item Hard Links on Cygwin
5964
5965 =item Filetime Granularity on Cygwin
5966
5967 =item Tainting Checks on Cygwin
5968
5969 =item /etc/group on Cygwin
5970
5971 =item Script Portability on Cygwin
5972
5973 Pathnames, Text/Binary, F<.exe>, chown(), Miscellaneous
5974
5975 =back
5976
5977 =item INSTALL PERL ON CYGWIN
5978
5979 =item MANIFEST ON CYGWIN
5980
5981 Documentation, Build, Configure, Make, Install, Tests, Compiled Perl
5982 Source, Compiled Module Source, Perl Modules/Scripts
5983
5984 =item BUGS ON CYGWIN
5985
5986 =item AUTHORS
5987
5988 =item HISTORY
5989
5990 =back
5991
5992 =head2 perldgux - Perl under DG/UX.
5993
5994 =over 4
5995
5996 =item SYNOPSIS
5997
5998 =back
5999
6000 =over 4
6001
6002 =item DESCRIPTION
6003
6004 =item BUILDING PERL ON DG/UX
6005
6006 =over 4
6007
6008 =item Non-threaded Perl on DG/UX
6009
6010 =item Threaded Perl on DG/UX
6011
6012 =item Testing Perl on DG/UX
6013
6014 =item Installing the built perl on DG/UX
6015
6016 =back
6017
6018 =item AUTHOR
6019
6020 =item SEE ALSO
6021
6022 =back
6023
6024 =head2 perlepoc, README.epoc - Perl for EPOC
6025
6026 =over 4
6027
6028 =item SYNOPSIS
6029
6030 =item INTRODUCTION
6031
6032 =item INSTALLING PERL ON EPOC
6033
6034 =item STARTING PERL ON EPOC
6035
6036 =item STOPPING PERL ON EPOC
6037
6038 =item USING PERL ON EPOC
6039
6040 =over 4
6041
6042 =item I/O Redirection on Epoc
6043
6044 =item PATH Names on Epoc
6045
6046 =item Editors on Epoc
6047
6048 =item Features of Perl on Epoc
6049
6050 =item Restrictions of Perl on Epoc
6051
6052 =item Compiling Perl 5 on the EPOC cross compiling environment
6053
6054 =back
6055
6056 =item SUPPORT STATUS OF PERL ON EPOC
6057
6058 =item AUTHOR
6059
6060 =item LAST UPDATE
6061
6062 =back
6063
6064 =head2 perlhpux, README.hpux - Perl version 5 on Hewlett-Packard Unix
6065 (HP-UX) systems
6066
6067 =over 4
6068
6069 =item DESCRIPTION
6070
6071 =over 4
6072
6073 =item Compiling Perl 5 on HP-UX
6074
6075 =item PA-RISC
6076
6077 =item PA-RISC 1.0
6078
6079 =item PA-RISC 1.1
6080
6081 =item PA-RISC 2.0
6082
6083 =item Portability Between PA-RISC Versions
6084
6085 =item Itanium Processor Family and HP-UX
6086
6087 =item Building Dynamic Extensions on HP-UX
6088
6089 =item The HP ANSI C Compiler
6090
6091 =item Using Large Files with Perl on HP-UX
6092
6093 =item Threaded Perl on HP-UX
6094
6095 =item 64-bit Perl on HP-UX
6096
6097 =item GDBM and Threads on HP-UX
6098
6099 =item NFS filesystems and utime(2) on HP-UX
6100
6101 =item perl -P and // and HP-UX
6102
6103 =item HP-UX Kernel Parameters (maxdsiz) for Compiling Perl
6104
6105 =back
6106
6107 =item AUTHOR
6108
6109 =item DATE
6110
6111 =back
6112
6113 =head2 perlhurd, README.hurd - Perl version 5 on Hurd
6114
6115 =over 4
6116
6117 =item DESCRIPTION
6118
6119 =over 4
6120
6121 =item Known Problems with Perl on Hurd
6122
6123 =back
6124
6125 =item AUTHOR
6126
6127 =back
6128
6129 =head2 perlmachten, README.machten - Perl version 5 on Power MachTen
6130 systems
6131
6132 =over 4
6133
6134 =item DESCRIPTION
6135
6136 =over 4
6137
6138 =item Compiling Perl 5 on MachTen
6139
6140 =item Failures during C<make test> on MachTen
6141
6142 op/lexassign.t, pragma/warnings.t
6143
6144 =item Building external modules on MachTen
6145
6146 =back
6147
6148 =item AUTHOR
6149
6150 =item DATE
6151
6152 =back
6153
6154 =head2 perlmacos, README.macos - Perl under Mac OS (Classic)
6155
6156 =over 4
6157
6158 =item SYNOPSIS
6159
6160 =item DESCRIPTION
6161
6162 =item AUTHOR
6163
6164 =item DATE
6165
6166 =back
6167
6168 =head2 perlmint, README.mint - Perl version 5 on Atari MiNT
6169
6170 =over 4
6171
6172 =item DESCRIPTION
6173
6174 =item Known problems with Perl on MiNT
6175
6176 =item AUTHOR
6177
6178 =back
6179
6180 =head2 perlmpeix, README.mpeix - Perl/iX for HP e3000 MPE
6181
6182 =over 4
6183
6184 =item SYNOPSIS
6185
6186 =item NOTE
6187
6188 =item What's New in Perl ffor MPE/iX
6189
6190 =item Welcome to Perl/iX
6191
6192 =item System Requirements for Perl/iX
6193
6194 =item How to Obtain Perl/iX
6195
6196 =item Perl/iX Distribution Contents Highlights
6197
6198 README, INSTALL, LIBSHP3K, PERL, .cpan/, lib/, man/,
6199 public_html/feedback.cgi, src/perl-5.6.0-mpe
6200
6201 =item How to Compile Perl/iX
6202
6203  4,  6
6204
6205 =item Getting Started with Perl/iX
6206
6207 =item MPE/iX Implementation Considerations
6208
6209 =item Known Perl/iX Bugs Under Investigation
6210
6211 =item Perl/iX To-Do List
6212
6213 =item Perl/iX Change History
6214
6215 =item AUTHOR
6216
6217 =item Name
6218
6219 =item Description
6220
6221 =item Build
6222
6223 =over 4
6224
6225 =item Tools & SDK
6226
6227 =item Setup
6228
6229 Buildtype.bat, SetNWBld.bat, MPKBuild.bat
6230
6231 =item Make
6232
6233 =item Interpreter
6234
6235 =item Extensions
6236
6237 =back
6238
6239 =item Install
6240
6241 =item Build new extensions
6242
6243 =item Known Issues
6244
6245 =item Acknowledgements
6246
6247 =item Authors
6248
6249 =item Date
6250
6251 =back
6252
6253 =head2 perlos2 - Perl under OS/2, DOS, Win0.3*, Win0.95 and WinNT.
6254
6255 =over 4
6256
6257 =item SYNOPSIS
6258
6259 =back
6260
6261 =over 4
6262
6263 =item DESCRIPTION
6264
6265 =over 4
6266
6267 =item Target
6268
6269 =item Other OSes
6270
6271 =item Prerequisites
6272
6273 EMX, RSX, HPFS, pdksh
6274
6275 =item Starting Perl programs under OS/2 (and DOS and...)
6276
6277 =item Starting OS/2 (and DOS) programs under Perl
6278
6279 =back
6280
6281 =item Frequently asked questions
6282
6283 =over 4
6284
6285 =item "It does not work"
6286
6287 =item I cannot run external programs
6288
6289 =item I cannot embed perl into my program, or use F<perl.dll> from my
6290 program.
6291
6292 Is your program EMX-compiled with C<-Zmt -Zcrtdll>?, Did you use
6293 L<ExtUtils::Embed>?
6294
6295 =item C<``> and pipe-C<open> do not work under DOS.
6296
6297 =item Cannot start C<find.exe "pattern" file>
6298
6299 =back
6300
6301 =item INSTALLATION
6302
6303 =over 4
6304
6305 =item Automatic binary installation
6306
6307 C<PERL_BADLANG>, C<PERL_BADFREE>, F<Config.pm>
6308
6309 =item Manual binary installation
6310
6311 Perl VIO and PM executables (dynamically linked), Perl_ VIO executable
6312 (statically linked), Executables for Perl utilities, Main Perl library,
6313 Additional Perl modules, Tools to compile Perl modules, Manpages for Perl
6314 and utilities, Manpages for Perl modules, Source for Perl documentation,
6315 Perl manual in F<.INF> format, Pdksh
6316
6317 =item B<Warning>
6318
6319 =back
6320
6321 =item Accessing documentation
6322
6323 =over 4
6324
6325 =item OS/2 F<.INF> file
6326
6327 =item Plain text
6328
6329 =item Manpages
6330
6331 =item HTML
6332
6333 =item GNU C<info> files
6334
6335 =item F<.PDF> files
6336
6337 =item C<LaTeX> docs
6338
6339 =back
6340
6341 =item BUILD
6342
6343 =over 4
6344
6345 =item The short story
6346
6347 =item Prerequisites
6348
6349 =item Getting perl source
6350
6351 =item Application of the patches
6352
6353 =item Hand-editing
6354
6355 =item Making
6356
6357 =item Testing
6358
6359 A lot of C<bad free>, Process terminated by SIGTERM/SIGINT, F<op/fs.t>,
6360 F<op/stat.t>
6361
6362 =item Installing the built perl
6363
6364 =item C<a.out>-style build
6365
6366 =back
6367
6368 =item Build FAQ
6369
6370 =over 4
6371
6372 =item Some C</> became C<\> in pdksh.
6373
6374 =item C<'errno'> - unresolved external
6375
6376 =item Problems with tr or sed
6377
6378 =item Some problem (forget which ;-)
6379
6380 =item Library ... not found
6381
6382 =item Segfault in make
6383
6384 =item op/sprintf test failure
6385
6386 =back
6387
6388 =item Specific (mis)features of OS/2 port
6389
6390 =over 4
6391
6392 =item C<setpriority>, C<getpriority>
6393
6394 =item C<system()>
6395
6396 =item C<extproc> on the first line
6397
6398 =item Additional modules:
6399
6400 =item Prebuilt methods:
6401
6402 C<File::Copy::syscopy>, C<DynaLoader::mod2fname>,  C<Cwd::current_drive()>,
6403  C<Cwd::sys_chdir(name)>,  C<Cwd::change_drive(name)>,
6404 C<Cwd::sys_is_absolute(name)>,  C<Cwd::sys_is_rooted(name)>,
6405 C<Cwd::sys_is_relative(name)>,  C<Cwd::sys_cwd(name)>,
6406 C<Cwd::sys_abspath(name, dir)>,  C<Cwd::extLibpath([type])>,
6407 C<Cwd::extLibpath_set( path [, type ] )>,
6408 C<OS2::Error(do_harderror,do_exception)>, C<OS2::Errors2Drive(drive)>,
6409 OS2::SysInfo(), OS2::BootDrive(), C<OS2::MorphPM(serve)>,
6410 C<OS2::UnMorphPM(serve)>, C<OS2::Serve_Messages(force)>,
6411 C<OS2::Process_Messages(force [, cnt])>, C<OS2::_control87(new,mask)>,
6412 OS2::get_control87(), C<OS2::set_control87_em(new=MCW_EM,mask=MCW_EM)>
6413
6414 =item Prebuilt variables:
6415
6416 $OS2::emx_rev, $OS2::emx_env, $OS2::os_ver
6417
6418 =item Misfeatures
6419
6420 =item Modifications
6421
6422 C<popen>, C<tmpnam>, C<tmpfile>, C<ctermid>, C<stat>, C<mkdir>, C<rmdir>,
6423 C<flock>
6424
6425 =item Identifying DLLs
6426
6427 =item Centralized management of resources
6428
6429 C<HAB>, C<HMQ>
6430
6431 =back
6432
6433 =item Perl flavors
6434
6435 =over 4
6436
6437 =item F<perl.exe>
6438
6439 =item F<perl_.exe>
6440
6441 =item F<perl__.exe>
6442
6443 =item F<perl___.exe>
6444
6445 =item Why strange names?
6446
6447 =item Why dynamic linking?
6448
6449 =item Why chimera build?
6450
6451 =back
6452
6453 =item ENVIRONMENT
6454
6455 =over 4
6456
6457 =item C<PERLLIB_PREFIX>
6458
6459 =item C<PERL_BADLANG>
6460
6461 =item C<PERL_BADFREE>
6462
6463 =item C<PERL_SH_DIR>
6464
6465 =item C<USE_PERL_FLOCK>
6466
6467 =item C<TMP> or C<TEMP>
6468
6469 =back
6470
6471 =item Evolution
6472
6473 =over 4
6474
6475 =item Priorities
6476
6477 =item DLL name mangling: pre 5.6.2
6478
6479 =item DLL name mangling: 5.6.2 and beyond
6480
6481 Global DLLs, specific DLLs, C<BEGINLIBPATH> and C<ENDLIBPATH>, F<.> from
6482 C<LIBPATH>
6483
6484 =item DLL forwarder generation
6485
6486 =item Threading
6487
6488 =item Calls to external programs
6489
6490 =item Memory allocation
6491
6492 =item Threads
6493
6494 C<COND_WAIT>, F<os2.c>
6495
6496 =back
6497
6498 =item BUGS
6499
6500 =back
6501
6502 =over 4
6503
6504 =item AUTHOR
6505
6506 =item SEE ALSO
6507
6508 =back
6509
6510 =head2 perlos390, README.os390 - building and installing Perl for OS/390.
6511
6512 =over 4
6513
6514 =item SYNOPSIS
6515
6516 =item DESCRIPTION
6517
6518 =over 4
6519
6520 =item Unpacking Perl distribution on OS/390
6521
6522 =item Setup and utilities for Perl on OS/390
6523
6524 =item Configure Perl on OS/390
6525
6526 =item Build, Test, Install Perl on OS/390
6527
6528 =item Build Anomalies with Perl on OS/390
6529
6530 =item Testing Anomalies with Perl on OS/390
6531
6532 =item Installation Anomalies with Perl on OS/390
6533
6534 =item Usage Hints for Perl on OS/390
6535
6536 =item Floating Point Anomalies with Perl on OS/390
6537
6538 =item Modules and Extensions for Perl on OS/390
6539
6540 =back
6541
6542 =item AUTHORS
6543
6544 =item SEE ALSO
6545
6546 =over 4
6547
6548 =item Mailing list for Perl on OS/390
6549
6550 =back
6551
6552 =item HISTORY
6553
6554 =back
6555
6556 =head2 perlqnx, README.qnx - Perl version 5 on QNX
6557
6558 =over 4
6559
6560 =item DESCRIPTION
6561
6562 =over 4
6563
6564 =item Required Software for Compiling Perl on QNX4
6565
6566 /bin/sh, ar, nm, cpp, make
6567
6568 =item Outstanding Issues with Perl on QNX4
6569
6570 =item QNX auxiliary files
6571
6572 qnx/ar, qnx/cpp
6573
6574 =item Outstanding issues with perl under QNX6
6575
6576 =back
6577
6578 =item AUTHOR
6579
6580 =back
6581
6582 =head2 perlplan9 - Plan 9-specific documentation for Perl
6583
6584 =over 4
6585
6586 =item DESCRIPTION
6587
6588 =over 4
6589
6590 =item Invoking Perl
6591
6592 =item What's in Plan 9 Perl
6593
6594 =item What's not in Plan 9 Perl
6595
6596 =item Perl5 Functions not currently supported in Plan 9 Perl
6597
6598 =item Signals in Plan 9 Perl
6599
6600 =back
6601
6602 =item COMPILING AND INSTALLING PERL ON PLAN 9
6603
6604 =over 4
6605
6606 =item Installing Perl Documentation on Plan 9
6607
6608 =back
6609
6610 =item BUGS
6611
6612 =item Revision date
6613
6614 =item AUTHOR
6615
6616 =back
6617
6618 =head2 perlsolaris, README.solaris - Perl version 5 on Solaris systems
6619
6620 =over 4
6621
6622 =item DESCRIPTION
6623
6624 =over 4
6625
6626 =item Solaris Version Numbers.
6627
6628 =back
6629
6630 =item RESOURCES
6631
6632 Solaris FAQ, Precompiled Binaries, Solaris Documentation
6633
6634 =item SETTING UP
6635
6636 =over 4
6637
6638 =item File Extraction Problems on Solaris.
6639
6640 =item Compiler and Related Tools on Solaris.
6641
6642 =item Environment for Compiling Perl on Solaris
6643
6644 =back
6645
6646 =item RUN CONFIGURE.
6647
6648 =over 4
6649
6650 =item 64-bit Issues with Perl on Solaris.
6651
6652 =item Threads in Perl on Solaris.
6653
6654 =item Malloc Issues with Perl on Solaris.
6655
6656 =back
6657
6658 =item MAKE PROBLEMS.
6659
6660 Dynamic Loading Problems With GNU as and GNU ld, ld.so.1: ./perl: fatal:
6661 relocation error:, dlopen: stub interception failed, #error "No
6662 DATAMODEL_NATIVE specified", sh: ar: not found
6663
6664 =item MAKE TEST
6665
6666 =over 4
6667
6668 =item op/stat.t test 4 in Solaris
6669
6670 =back
6671
6672 =item PREBUILT BINARIES OF PERL FOR SOLARIS.
6673
6674 =item RUNTIME ISSUES FOR PERL ON SOLARIS.
6675
6676 =over 4
6677
6678 =item Limits on Numbers of Open Files on Solaris.
6679
6680 =back
6681
6682 =item SOLARIS-SPECIFIC MODULES.
6683
6684 =item SOLARIS-SPECIFIC PROBLEMS WITH MODULES.
6685
6686 =over 4
6687
6688 =item Proc::ProcessTable on Solaris
6689
6690 =item BSD::Resource on Solaris
6691
6692 =item Net::SSLeay on Solaris
6693
6694 =back
6695
6696 =item AUTHOR
6697
6698 =item LAST MODIFIED
6699
6700 =back
6701
6702 =head2 perltru64, README.tru64 - Perl version 5 on Tru64 (formerly known as
6703 Digital UNIX formerly known as DEC OSF/1) systems
6704
6705 =over 4
6706
6707 =item DESCRIPTION
6708
6709 =over 4
6710
6711 =item Compiling Perl 5 on Tru64
6712
6713 =item Using Large Files with Perl on Tru64
6714
6715 =item Threaded Perl on Tru64
6716
6717 =item Long Doubles on Tru64
6718
6719 =item 64-bit Perl on Tru64
6720
6721 =item Warnings about floating-point overflow when compiling Perl on Tru64
6722
6723 =back
6724
6725 =item Testing Perl on Tru64
6726
6727 =item AUTHOR
6728
6729 =back
6730
6731 =head2 perluts - Perl under UTS
6732
6733 =over 4
6734
6735 =item SYNOPSIS
6736
6737 =item DESCRIPTION
6738
6739 =item BUILDING PERL ON UTS
6740
6741 =item Installing the built perl on UTS
6742
6743 =item AUTHOR
6744
6745 =back
6746
6747 =head2 perlvmesa, README.vmesa - building and installing Perl for VM/ESA.
6748
6749 =over 4
6750
6751 =item SYNOPSIS
6752
6753 =item DESCRIPTION
6754
6755 =over 4
6756
6757 =item Unpacking Perl Distribution on VM/ESA
6758
6759 =item Setup Perl and utilities on VM/ESA
6760
6761 =item Configure Perl on VM/ESA
6762
6763 =item Testing Anomalies of Perl on VM/ESA
6764
6765 =item Usage Hints for Perl on VM/ESA
6766
6767 =back
6768
6769 =item AUTHORS
6770
6771 =item SEE ALSO
6772
6773 =over 4
6774
6775 =item Mailing list for Perl on VM/ESA
6776
6777 =back
6778
6779 =back
6780
6781 =head2 perlvms - VMS-specific documentation for Perl
6782
6783 =over 4
6784
6785 =item DESCRIPTION
6786
6787 =item Installation
6788
6789 =item Organization of Perl Images
6790
6791 =over 4
6792
6793 =item Core Images
6794
6795 =item Perl Extensions
6796
6797 =item Installing static extensions
6798
6799 =item Installing dynamic extensions
6800
6801 =back
6802
6803 =item File specifications
6804
6805 =over 4
6806
6807 =item Syntax
6808
6809 =item Wildcard expansion
6810
6811 =item Pipes
6812
6813 =back
6814
6815 =item PERL5LIB and PERLLIB
6816
6817 =item Command line
6818
6819 =over 4
6820
6821 =item I/O redirection and backgrounding
6822
6823 =item Command line switches
6824
6825 -i, -S, -u
6826
6827 =back
6828
6829 =item Perl functions
6830
6831 File tests, backticks, binmode FILEHANDLE, crypt PLAINTEXT, USER, dump,
6832 exec LIST, fork, getpwent, getpwnam, getpwuid, gmtime, kill, qx//, select
6833 (system call), stat EXPR, system LIST, time, times, unlink LIST, utime
6834 LIST, waitpid PID,FLAGS
6835
6836 =item Perl variables
6837
6838 %ENV, CRTL_ENV, CLISYM_[LOCAL], Any other string, $!, $^E, $?, $|
6839
6840 =item Standard modules with VMS-specific differences
6841
6842 =over 4
6843
6844 =item SDBM_File
6845
6846 =back
6847
6848 =item Revision date
6849
6850 =item AUTHOR
6851
6852 =back
6853
6854 =head2 perlvos, README.vos - Perl for Stratus VOS
6855
6856 =over 4
6857
6858 =item SYNOPSIS
6859
6860 =over 4
6861
6862 =item Stratus POSIX Support
6863
6864 =back
6865
6866 =item INSTALLING PERL IN VOS
6867
6868 =over 4
6869
6870 =item Compiling Perl 5 on VOS
6871
6872 =item Installing Perl 5 on VOS
6873
6874 =back
6875
6876 =item USING PERL IN VOS
6877
6878 =over 4
6879
6880 =item Unimplemented Features of Perl on VOS
6881
6882 =item Restrictions of Perl on VOS
6883
6884 =back
6885
6886 =item SUPPORT STATUS
6887
6888 =item AUTHOR
6889
6890 =item LAST UPDATE
6891
6892 =back
6893
6894 =head1 PRAGMA DOCUMENTATION
6895
6896 =head2 attrs - set/get attributes of a subroutine (deprecated)
6897
6898 =over 4
6899
6900 =item SYNOPSIS
6901
6902 =item DESCRIPTION
6903
6904 method, locked
6905
6906 =back
6907
6908 =head2 re - Perl pragma to alter regular expression behaviour
6909
6910 =over 4
6911
6912 =item SYNOPSIS
6913
6914 =item DESCRIPTION
6915
6916 =back
6917
6918 =head2 threads - Perl extension allowing use of interpreter based threads
6919 from perl
6920
6921 =over 4
6922
6923 =item SYNOPSIS
6924
6925 =item DESCRIPTION
6926
6927 new, function, LIST, $threads->join, $threads->detach, threads->self,
6928 $threads->tid
6929
6930 =item TODO
6931
6932 Fix so the return value is returned when you join, Add join_all, Fix memory
6933 leaks!
6934
6935 =item AUTHOR and COPYRIGHT
6936
6937 =item BUGS
6938
6939 creating a thread from within a thread is unsafe under win32
6940
6941 =item SEE ALSO
6942
6943 =back
6944
6945 =head2 attributes - get/set subroutine or variable attributes
6946
6947 =over 4
6948
6949 =item SYNOPSIS
6950
6951 =item DESCRIPTION
6952
6953 =over 4
6954
6955 =item Built-in Attributes
6956
6957 locked, method, lvalue
6958
6959 =item Available Subroutines
6960
6961 get, reftype
6962
6963 =item Package-specific Attribute Handling
6964
6965 FETCH_I<type>_ATTRIBUTES, MODIFY_I<type>_ATTRIBUTES
6966
6967 =item Syntax of Attribute Lists
6968
6969 =back
6970
6971 =item EXPORTS
6972
6973 =over 4
6974
6975 =item Default exports
6976
6977 =item Available exports
6978
6979 =item Export tags defined
6980
6981 =back
6982
6983 =item EXAMPLES
6984
6985 =item SEE ALSO
6986
6987 =back
6988
6989 =head2 attrs - set/get attributes of a subroutine (deprecated)
6990
6991 =over 4
6992
6993 =item SYNOPSIS
6994
6995 =item DESCRIPTION
6996
6997 method, locked
6998
6999 =back
7000
7001 =head2 autouse - postpone load of modules until a function is used
7002
7003 =over 4
7004
7005 =item SYNOPSIS
7006
7007 =item DESCRIPTION
7008
7009 =item WARNING
7010
7011 =item AUTHOR
7012
7013 =item SEE ALSO
7014
7015 =back
7016
7017 =head2 base - Establish IS-A relationship with base class at compile time
7018
7019 =over 4
7020
7021 =item SYNOPSIS
7022
7023 =item DESCRIPTION
7024
7025 =item HISTORY
7026
7027 =item SEE ALSO
7028
7029 =back
7030
7031 =head2 blib - Use MakeMaker's uninstalled version of a package
7032
7033 =over 4
7034
7035 =item SYNOPSIS
7036
7037 =item DESCRIPTION
7038
7039 =item BUGS
7040
7041 =item AUTHOR
7042
7043 =back
7044
7045 =head2 bytes - Perl pragma to force byte semantics rather than character
7046 semantics
7047
7048 =over 4
7049
7050 =item SYNOPSIS
7051
7052 =item DESCRIPTION
7053
7054 =item SEE ALSO
7055
7056 =back
7057
7058 =head2 charnames - define character names for C<\N{named}> string literal
7059 escape.
7060
7061 =over 4
7062
7063 =item SYNOPSIS
7064
7065 =item DESCRIPTION
7066
7067 =item CUSTOM TRANSLATORS
7068
7069 =item BUGS
7070
7071 =back
7072
7073 =head2 constant - Perl pragma to declare constants
7074
7075 =over 4
7076
7077 =item SYNOPSIS
7078
7079 =item DESCRIPTION
7080
7081 =item NOTES
7082
7083 =item TECHNICAL NOTE
7084
7085 =item BUGS
7086
7087 =item AUTHOR
7088
7089 =item COPYRIGHT
7090
7091 =back
7092
7093 =head2 diagnostics - Perl compiler pragma to force verbose warning
7094 diagnostics
7095
7096 =over 4
7097
7098 =item SYNOPSIS
7099
7100 =item DESCRIPTION
7101
7102 =over 4
7103
7104 =item The C<diagnostics> Pragma
7105
7106 =item The I<splain> Program
7107
7108 =back
7109
7110 =item EXAMPLES
7111
7112 =item INTERNALS
7113
7114 =item BUGS
7115
7116 =item AUTHOR
7117
7118 =back
7119
7120 =head2 fields - compile-time class fields
7121
7122 =over 4
7123
7124 =item SYNOPSIS
7125
7126 =item DESCRIPTION
7127
7128 new, phash
7129
7130 =item SEE ALSO
7131
7132 =back
7133
7134 =head2 filetest - Perl pragma to control the filetest permission operators
7135
7136 =over 4
7137
7138 =item SYNOPSIS
7139
7140 =item DESCRIPTION
7141
7142 =over 4
7143
7144 =item subpragma access
7145
7146 =back
7147
7148 =back
7149
7150 =head2 integer - Perl pragma to use integer arithmetic instead of floating
7151 point
7152
7153 =over 4
7154
7155 =item SYNOPSIS
7156
7157 =item DESCRIPTION
7158
7159 =back
7160
7161 =head2 less - perl pragma to request less of something from the compiler
7162
7163 =over 4
7164
7165 =item SYNOPSIS
7166
7167 =item DESCRIPTION
7168
7169 =back
7170
7171 =head2 lib - manipulate @INC at compile time
7172
7173 =over 4
7174
7175 =item SYNOPSIS
7176
7177 =item DESCRIPTION
7178
7179 =over 4
7180
7181 =item Adding directories to @INC
7182
7183 =item Deleting directories from @INC
7184
7185 =item Restoring original @INC
7186
7187 =back
7188
7189 =item SEE ALSO
7190
7191 =item AUTHOR
7192
7193 =back
7194
7195 =head2 locale - Perl pragma to use and avoid POSIX locales for built-in
7196 operations
7197
7198 =over 4
7199
7200 =item SYNOPSIS
7201
7202 =item DESCRIPTION
7203
7204 =back
7205
7206 =head2 open - perl pragma to set default disciplines for input and output
7207
7208 =over 4
7209
7210 =item SYNOPSIS
7211
7212 =item DESCRIPTION
7213
7214 =item NONPERLIO FUNCTIONALITY
7215
7216 =item IMPLEMENTATION DETAILS
7217
7218 =item SEE ALSO
7219
7220 =back
7221
7222 =head2 ops - Perl pragma to restrict unsafe operations when compiling
7223
7224 =over 4
7225
7226 =item SYNOPSIS
7227
7228 =item DESCRIPTION
7229
7230 =item SEE ALSO
7231
7232 =back
7233
7234 =head2 overload - Package for overloading perl operations
7235
7236 =over 4
7237
7238 =item SYNOPSIS
7239
7240 =item DESCRIPTION
7241
7242 =over 4
7243
7244 =item Declaration of overloaded functions
7245
7246 =item Calling Conventions for Binary Operations
7247
7248 FALSE, TRUE, C<undef>
7249
7250 =item Calling Conventions for Unary Operations
7251
7252 =item Calling Conventions for Mutators
7253
7254 C<++> and C<-->, C<x=> and other assignment versions
7255
7256 =item Overloadable Operations
7257
7258 I<Arithmetic operations>, I<Comparison operations>, I<Bit operations>,
7259 I<Increment and decrement>, I<Transcendental functions>, I<Boolean, string
7260 and numeric conversion>, I<Iteration>, I<Dereferencing>, I<Special>
7261
7262 =item Inheritance and overloading
7263
7264 Strings as values of C<use overload> directive, Overloading of an operation
7265 is inherited by derived classes
7266
7267 =back
7268
7269 =item SPECIAL SYMBOLS FOR C<use overload>
7270
7271 =over 4
7272
7273 =item Last Resort
7274
7275 =item Fallback
7276
7277 C<undef>, TRUE, defined, but FALSE
7278
7279 =item Copy Constructor
7280
7281 B<Example>
7282
7283 =back
7284
7285 =item MAGIC AUTOGENERATION
7286
7287 I<Assignment forms of arithmetic operations>, I<Conversion operations>,
7288 I<Increment and decrement>, C<abs($a)>, I<Unary minus>, I<Negation>,
7289 I<Concatenation>, I<Comparison operations>, I<Iterator>, I<Dereferencing>,
7290 I<Copy operator>
7291
7292 =item Losing overloading
7293
7294 =item Run-time Overloading
7295
7296 =item Public functions
7297
7298 overload::StrVal(arg), overload::Overloaded(arg), overload::Method(obj,op)
7299
7300 =item Overloading constants
7301
7302 integer, float, binary, q, qr
7303
7304 =item IMPLEMENTATION
7305
7306 =item Metaphor clash
7307
7308 =item Cookbook
7309
7310 =over 4
7311
7312 =item Two-face scalars
7313
7314 =item Two-face references
7315
7316 =item Symbolic calculator
7317
7318 =item I<Really> symbolic calculator
7319
7320 =back
7321
7322 =item AUTHOR
7323
7324 =item DIAGNOSTICS
7325
7326 Odd number of arguments for overload::constant, `%s' is not an overloadable
7327 type, `%s' is not a code reference
7328
7329 =item BUGS
7330
7331 =back
7332
7333 =head2 re - Perl pragma to alter regular expression behaviour
7334
7335 =over 4
7336
7337 =item SYNOPSIS
7338
7339 =item DESCRIPTION
7340
7341 =back
7342
7343 =head2 sigtrap - Perl pragma to enable simple signal handling
7344
7345 =over 4
7346
7347 =item SYNOPSIS
7348
7349 =item DESCRIPTION
7350
7351 =item OPTIONS
7352
7353 =over 4
7354
7355 =item SIGNAL HANDLERS
7356
7357 B<stack-trace>, B<die>, B<handler> I<your-handler>
7358
7359 =item SIGNAL LISTS
7360
7361 B<normal-signals>, B<error-signals>, B<old-interface-signals>
7362
7363 =item OTHER
7364
7365 B<untrapped>, B<any>, I<signal>, I<number>
7366
7367 =back
7368
7369 =item EXAMPLES
7370
7371 =back
7372
7373 =head2 strict - Perl pragma to restrict unsafe constructs
7374
7375 =over 4
7376
7377 =item SYNOPSIS
7378
7379 =item DESCRIPTION
7380
7381 C<strict refs>, C<strict vars>, C<strict subs>
7382
7383 =back
7384
7385 =head2 subs - Perl pragma to predeclare sub names
7386
7387 =over 4
7388
7389 =item SYNOPSIS
7390
7391 =item DESCRIPTION
7392
7393 =back
7394
7395 =head2 threads - Perl extension allowing use of interpreter based threads
7396 from perl
7397
7398 =over 4
7399
7400 =item SYNOPSIS
7401
7402 =item DESCRIPTION
7403
7404 new, function, LIST, $threads->join, $threads->detach, threads->self,
7405 $threads->tid
7406
7407 =item TODO
7408
7409 Fix so the return value is returned when you join, Add join_all, Fix memory
7410 leaks!
7411
7412 =item AUTHOR and COPYRIGHT
7413
7414 =item BUGS
7415
7416 creating a thread from within a thread is unsafe under win32
7417
7418 =item SEE ALSO
7419
7420 =back
7421
7422 =head2 utf8 - Perl pragma to enable/disable UTF-8 (or UTF-EBCDIC) in source
7423 code
7424
7425 =over 4
7426
7427 =item SYNOPSIS
7428
7429 =item DESCRIPTION
7430
7431 =over 4
7432
7433 =item Utility functions
7434
7435 $num_octets = utf8::upgrade($string);, utf8::downgrade($string[, CHECK]),
7436 utf8::encode($string), $flag = utf8::decode($string)
7437
7438 =back
7439
7440 =item SEE ALSO
7441
7442 =back
7443
7444 =head2 vars - Perl pragma to predeclare global variable names (obsolete)
7445
7446 =over 4
7447
7448 =item SYNOPSIS
7449
7450 =item DESCRIPTION
7451
7452 =back
7453
7454 =head2 warnings - Perl pragma to control optional warnings
7455
7456 =over 4
7457
7458 =item SYNOPSIS
7459
7460 =item DESCRIPTION
7461
7462 use warnings::register, warnings::enabled(), warnings::enabled($category),
7463 warnings::enabled($object), warnings::warn($message),
7464 warnings::warn($category, $message), warnings::warn($object, $message),
7465 warnings::warnif($message), warnings::warnif($category, $message),
7466 warnings::warnif($object, $message)
7467
7468 =back
7469
7470 =head2 warnings::register - warnings import function
7471
7472 =head1 MODULE DOCUMENTATION
7473
7474 =head2 AnyDBM_File - provide framework for multiple DBMs
7475
7476 =over 4
7477
7478 =item SYNOPSIS
7479
7480 =item DESCRIPTION
7481
7482 =over 4
7483
7484 =item DBM Comparisons
7485
7486 [0], [1], [2], [3]
7487
7488 =back
7489
7490 =item SEE ALSO
7491
7492 =back
7493
7494 =head2 Attribute::Handlers - Simpler definition of attribute handlers
7495
7496 =over 4
7497
7498 =item VERSION
7499
7500 =item SYNOPSIS
7501
7502 =item DESCRIPTION
7503
7504 [0], [1], [2], [3], [4], [5]
7505
7506 =over 4
7507
7508 =item Typed lexicals
7509
7510 =item Type-specific attribute handlers
7511
7512 =item Non-interpretive attribute handlers
7513
7514 =item Phase-specific attribute handlers
7515
7516 =item Attributes as C<tie> interfaces
7517
7518 =back
7519
7520 =item EXAMPLES
7521
7522 =item DIAGNOSTICS
7523
7524 C<Bad attribute type: ATTR(%s)>, C<Attribute handler %s doesn't handle %s
7525 attributes>, C<Declaration of %s attribute in package %s may clash with
7526 future reserved word>, C<Can't have two ATTR specifiers on one subroutine>,
7527 C<Can't autotie a %s>, C<Internal error: %s symbol went missing>
7528
7529 =item AUTHOR
7530
7531 =item BUGS
7532
7533 =item COPYRIGHT
7534
7535 =back
7536
7537 =head2 AutoLoader - load subroutines only on demand
7538
7539 =over 4
7540
7541 =item SYNOPSIS
7542
7543 =item DESCRIPTION
7544
7545 =over 4
7546
7547 =item Subroutine Stubs
7548
7549 =item Using B<AutoLoader>'s AUTOLOAD Subroutine
7550
7551 =item Overriding B<AutoLoader>'s AUTOLOAD Subroutine
7552
7553 =item Package Lexicals
7554
7555 =item Not Using AutoLoader
7556
7557 =item B<AutoLoader> vs. B<SelfLoader>
7558
7559 =back
7560
7561 =item CAVEATS
7562
7563 =item SEE ALSO
7564
7565 =back
7566
7567 =head2 AutoSplit - split a package for autoloading
7568
7569 =over 4
7570
7571 =item SYNOPSIS
7572
7573 =item DESCRIPTION
7574
7575 $keep, $check, $modtime
7576
7577 =over 4
7578
7579 =item Multiple packages
7580
7581 =back
7582
7583 =item DIAGNOSTICS
7584
7585 =back
7586
7587 =head2 B - The Perl Compiler
7588
7589 =over 4
7590
7591 =item SYNOPSIS
7592
7593 =item DESCRIPTION
7594
7595 =item OVERVIEW OF CLASSES
7596
7597 =over 4
7598
7599 =item SV-RELATED CLASSES
7600
7601 =item B::SV METHODS
7602
7603 REFCNT, FLAGS
7604
7605 =item B::IV METHODS
7606
7607 IV, IVX, UVX, int_value, needs64bits, packiv
7608
7609 =item B::NV METHODS
7610
7611 NV, NVX
7612
7613 =item B::RV METHODS
7614
7615 RV
7616
7617 =item B::PV METHODS
7618
7619 PV, PVX
7620
7621 =item B::PVMG METHODS
7622
7623 MAGIC, SvSTASH
7624
7625 =item B::MAGIC METHODS
7626
7627 MOREMAGIC, PRIVATE, TYPE, FLAGS, OBJ, PTR
7628
7629 =item B::PVLV METHODS
7630
7631 TARGOFF, TARGLEN, TYPE, TARG
7632
7633 =item B::BM METHODS
7634
7635 USEFUL, PREVIOUS, RARE, TABLE
7636
7637 =item B::GV METHODS
7638
7639 is_empty, NAME, SAFENAME, STASH, SV, IO, FORM, AV, HV, EGV, CV, CVGEN,
7640 LINE, FILE, FILEGV, GvREFCNT, FLAGS
7641
7642 =item B::IO METHODS
7643
7644 LINES, PAGE, PAGE_LEN, LINES_LEFT, TOP_NAME, TOP_GV, FMT_NAME, FMT_GV,
7645 BOTTOM_NAME, BOTTOM_GV, SUBPROCESS, IoTYPE, IoFLAGS
7646
7647 =item B::AV METHODS
7648
7649 FILL, MAX, OFF, ARRAY, AvFLAGS
7650
7651 =item B::CV METHODS
7652
7653 STASH, START, ROOT, GV, FILE, DEPTH, PADLIST, OUTSIDE, XSUB, XSUBANY,
7654 CvFLAGS, const_sv
7655
7656 =item B::HV METHODS
7657
7658 FILL, MAX, KEYS, RITER, NAME, PMROOT, ARRAY
7659
7660 =item OP-RELATED CLASSES
7661
7662 =item B::OP METHODS
7663
7664 next, sibling, name, ppaddr, desc, targ, type, seq, flags, private
7665
7666 =item B::UNOP METHOD
7667
7668 first
7669
7670 =item B::BINOP METHOD
7671
7672 last
7673
7674 =item B::LOGOP METHOD
7675
7676 other
7677
7678 =item B::LISTOP METHOD
7679
7680 children
7681
7682 =item B::PMOP METHODS
7683
7684 pmreplroot, pmreplstart, pmnext, pmregexp, pmflags, pmpermflags, precomp
7685
7686 =item B::SVOP METHOD
7687
7688 sv, gv
7689
7690 =item B::PADOP METHOD
7691
7692 padix
7693
7694 =item B::PVOP METHOD
7695
7696 pv
7697
7698 =item B::LOOP METHODS
7699
7700 redoop, nextop, lastop
7701
7702 =item B::COP METHODS
7703
7704 label, stash, file, cop_seq, arybase, line
7705
7706 =back
7707
7708 =item FUNCTIONS EXPORTED BY C<B>
7709
7710 main_cv, init_av, main_root, main_start, comppadlist, sv_undef, sv_yes,
7711 sv_no, amagic_generation, walkoptree(OP, METHOD), walkoptree_debug(DEBUG),
7712 walksymtable(SYMREF, METHOD, RECURSE, PREFIX), svref_2object(SV),
7713 ppname(OPNUM), hash(STR), cast_I32(I), minus_c, cstring(STR), class(OBJ),
7714 threadsv_names
7715
7716 =item AUTHOR
7717
7718 =back
7719
7720 =head2 B::Asmdata - Autogenerated data about Perl ops, used to generate
7721 bytecode
7722
7723 =over 4
7724
7725 =item SYNOPSIS
7726
7727 =item DESCRIPTION
7728
7729 =item AUTHOR
7730
7731 =back
7732
7733 =head2 B::Assembler - Assemble Perl bytecode
7734
7735 =over 4
7736
7737 =item SYNOPSIS
7738
7739 =item DESCRIPTION
7740
7741 =item AUTHORS
7742
7743 =back
7744
7745 =head2 B::Bblock - Walk basic blocks
7746
7747 =over 4
7748
7749 =item SYNOPSIS
7750
7751 =item DESCRIPTION
7752
7753 =item AUTHOR
7754
7755 =back
7756
7757 =head2 B::Bytecode - Perl compiler's bytecode backend
7758
7759 =over 4
7760
7761 =item SYNOPSIS
7762
7763 =item DESCRIPTION
7764
7765 =item OPTIONS
7766
7767 B<-ofilename>, B<-afilename>, B<-->, B<-f>, B<-fcompress-nullops>,
7768 B<-fomit-sequence-numbers>, B<-fbypass-nullops>, B<-On>, B<-D>, B<-Do>,
7769 B<-Db>, B<-Da>, B<-DC>, B<-S>, B<-upackage>
7770
7771 =item EXAMPLES
7772
7773 =item BUGS
7774
7775 =item AUTHORS
7776
7777 =back
7778
7779 =head2 B::C - Perl compiler's C backend
7780
7781 =over 4
7782
7783 =item SYNOPSIS
7784
7785 =item DESCRIPTION
7786
7787 =item OPTIONS
7788
7789 B<-ofilename>, B<-v>, B<-->, B<-uPackname>, B<-D>, B<-Do>, B<-Dc>, B<-DA>,
7790 B<-DC>, B<-DM>, B<-f>, B<-fcog>, B<-fno-cog>, B<-On>, B<-llimit>
7791
7792 =item EXAMPLES
7793
7794 =item BUGS
7795
7796 =item AUTHOR
7797
7798 =back
7799
7800 =head2 B::CC - Perl compiler's optimized C translation backend
7801
7802 =over 4
7803
7804 =item SYNOPSIS
7805
7806 =item DESCRIPTION
7807
7808 =item OPTIONS
7809
7810 B<-ofilename>, B<-v>, B<-->, B<-uPackname>, B<-mModulename>, B<-D>, B<-Dr>,
7811 B<-DO>, B<-Ds>, B<-Dp>, B<-Dq>, B<-Dl>, B<-Dt>, B<-f>,
7812 B<-ffreetmps-each-bblock>, B<-ffreetmps-each-loop>, B<-fomit-taint>, B<-On>
7813
7814 =item EXAMPLES
7815
7816 =item BUGS
7817
7818 =item DIFFERENCES
7819
7820 =over 4
7821
7822 =item Loops
7823
7824 =item Context of ".."
7825
7826 =item Arithmetic
7827
7828 =item Deprecated features
7829
7830 =back
7831
7832 =item AUTHOR
7833
7834 =back
7835
7836 =head2 B::Concise - Walk Perl syntax tree, printing concise info about ops
7837
7838 =over 4
7839
7840 =item SYNOPSIS
7841
7842 =item DESCRIPTION
7843
7844 =item OPTIONS
7845
7846 B<-basic>, B<-exec>, B<-tree>, B<-compact>, B<-loose>, B<-vt>, B<-ascii>,
7847 B<-main>, B<-base>I<n>, B<-bigendian>, B<-littleendian>, B<-concise>,
7848 B<-terse>, B<-linenoise>, B<-debug>, B<-env>
7849
7850 =item FORMATTING SPECIFICATIONS
7851
7852 B<(x(>I<exec_text>B<;>I<basic_text>B<)x)>, B<(*(>I<text>B<)*)>,
7853 B<(*(>I<text1>B<;>I<text2>B<)*)>, B<(?(>I<text1>B<#>I<var>I<Text2>B<)?)>,
7854 B<#>I<var>, B<#>I<var>I<N>, B<~>, B<#addr>, B<#arg>, B<#class>,
7855 B<#classym>, B<#coplabel>, B<#exname>, B<#extarg>, B<#firstaddr>,
7856 B<#flags>, B<#flagval>, B<#hyphenseq>, B<#label>, B<#lastaddr>, B<#name>,
7857 B<#NAME>, B<#next>, B<#nextaddr>, B<#noise>, B<#private>, B<#privval>,
7858 B<#seq>, B<#seqnum>, B<#sibaddr>, B<#svaddr>, B<#svclass>, B<#svval>,
7859 B<#targ>, B<#targarg>, B<#targarglife>, B<#typenum>
7860
7861 =item ABBREVIATIONS
7862
7863 =over 4
7864
7865 =item OP flags abbreviations
7866
7867 =item OP class abbreviations
7868
7869 =back
7870
7871 =item Using B::Concise outside of the O framework
7872
7873 =item AUTHOR
7874
7875 =back
7876
7877 =head2 B::Debug - Walk Perl syntax tree, printing debug info about ops
7878
7879 =over 4
7880
7881 =item SYNOPSIS
7882
7883 =item DESCRIPTION
7884
7885 =item AUTHOR
7886
7887 =back
7888
7889 =head2 B::Deparse - Perl compiler backend to produce perl code
7890
7891 =over 4
7892
7893 =item SYNOPSIS
7894
7895 =item DESCRIPTION
7896
7897 =item OPTIONS
7898
7899 B<-l>, B<-p>, B<-q>, B<-f>I<FILE>, B<-s>I<LETTERS>, B<C>, B<i>I<NUMBER>,
7900 B<T>, B<v>I<STRING>B<.>, B<-x>I<LEVEL>
7901
7902 =item USING B::Deparse AS A MODULE
7903
7904 =over 4
7905
7906 =item Synopsis
7907
7908 =item Description
7909
7910 =item new
7911
7912 =item ambient_pragmas
7913
7914 strict, $[, bytes, utf8, integer, re, warnings, hint_bits, warning_bits
7915
7916 =item coderef2text
7917
7918 =back
7919
7920 =item BUGS
7921
7922 =item AUTHOR
7923
7924 =back
7925
7926 =head2 B::Disassembler - Disassemble Perl bytecode
7927
7928 =over 4
7929
7930 =item SYNOPSIS
7931
7932 =item DESCRIPTION
7933
7934 =item AUTHOR
7935
7936 =back
7937
7938 =head2 B::Lint - Perl lint
7939
7940 =over 4
7941
7942 =item SYNOPSIS
7943
7944 =item DESCRIPTION
7945
7946 =item OPTIONS AND LINT CHECKS
7947
7948 B<context>, B<implicit-read> and B<implicit-write>, B<dollar-underscore>,
7949 B<private-names>, B<undefined-subs>, B<regexp-variables>, B<all>, B<none>
7950
7951 =item NON LINT-CHECK OPTIONS
7952
7953 B<-u Package>
7954
7955 =item BUGS
7956
7957 =item AUTHOR
7958
7959 =back
7960
7961 =head2 B::O, O - Generic interface to Perl Compiler backends
7962
7963 =over 4
7964
7965 =item SYNOPSIS
7966
7967 =item DESCRIPTION
7968
7969 =item CONVENTIONS
7970
7971 =item IMPLEMENTATION
7972
7973 =item AUTHOR
7974
7975 =back
7976
7977 =head2 B::Showlex - Show lexical variables used in functions or files
7978
7979 =over 4
7980
7981 =item SYNOPSIS
7982
7983 =item DESCRIPTION
7984
7985 =item AUTHOR
7986
7987 =back
7988
7989 =head2 B::Stackobj - Helper module for CC backend
7990
7991 =over 4
7992
7993 =item SYNOPSIS
7994
7995 =item DESCRIPTION
7996
7997 =item AUTHOR
7998
7999 =back
8000
8001 =head2 B::Stash - show what stashes are loaded
8002
8003 =head2 B::Terse - Walk Perl syntax tree, printing terse info about ops
8004
8005 =over 4
8006
8007 =item SYNOPSIS
8008
8009 =item DESCRIPTION
8010
8011 =item AUTHOR
8012
8013 =back
8014
8015 =head2 B::Xref - Generates cross reference reports for Perl programs
8016
8017 =over 4
8018
8019 =item SYNOPSIS
8020
8021 =item DESCRIPTION
8022
8023 =item OPTIONS
8024
8025 C<-oFILENAME>, C<-r>, C<-D[tO]>
8026
8027 =item BUGS
8028
8029 =item AUTHOR
8030
8031 =back
8032
8033 =head2 Bblock, B::Bblock - Walk basic blocks
8034
8035 =over 4
8036
8037 =item SYNOPSIS
8038
8039 =item DESCRIPTION
8040
8041 =item AUTHOR
8042
8043 =back
8044
8045 =head2 Benchmark - benchmark running times of Perl code
8046
8047 =over 4
8048
8049 =item SYNOPSIS
8050
8051 =item DESCRIPTION
8052
8053 =over 4
8054
8055 =item Methods
8056
8057 new, debug, iters
8058
8059 =item Standard Exports
8060
8061 timeit(COUNT, CODE), timethis ( COUNT, CODE, [ TITLE, [ STYLE ]] ),
8062 timethese ( COUNT, CODEHASHREF, [ STYLE ] ), timediff ( T1, T2 ), timestr (
8063 TIMEDIFF, [ STYLE, [ FORMAT ] ] )
8064
8065 =item Optional Exports
8066
8067 clearcache ( COUNT ), clearallcache ( ), cmpthese ( COUT, CODEHASHREF, [
8068 STYLE ] ), cmpthese ( RESULTSHASHREF ), countit(TIME, CODE), disablecache (
8069 ), enablecache ( ), timesum ( T1, T2 )
8070
8071 =back
8072
8073 =item NOTES
8074
8075 =item EXAMPLES
8076
8077 =item INHERITANCE
8078
8079 =item CAVEATS
8080
8081 =item SEE ALSO
8082
8083 =item AUTHORS
8084
8085 =item MODIFICATION HISTORY
8086
8087 =back
8088
8089 =head2 ByteLoader - load byte compiled perl code
8090
8091 =over 4
8092
8093 =item SYNOPSIS
8094
8095 =item DESCRIPTION
8096
8097 =item AUTHOR
8098
8099 =item SEE ALSO
8100
8101 =back
8102
8103 =head2 Bytecode, B::Bytecode - Perl compiler's bytecode backend
8104
8105 =over 4
8106
8107 =item SYNOPSIS
8108
8109 =item DESCRIPTION
8110
8111 =item OPTIONS
8112
8113 B<-ofilename>, B<-afilename>, B<-->, B<-f>, B<-fcompress-nullops>,
8114 B<-fomit-sequence-numbers>, B<-fbypass-nullops>, B<-On>, B<-D>, B<-Do>,
8115 B<-Db>, B<-Da>, B<-DC>, B<-S>, B<-upackage>
8116
8117 =item EXAMPLES
8118
8119 =item BUGS
8120
8121 =item AUTHORS
8122
8123 =back
8124
8125 =head2 CGI - Simple Common Gateway Interface Class
8126
8127 =over 4
8128
8129 =item SYNOPSIS
8130
8131 =item ABSTRACT
8132
8133 =item DESCRIPTION
8134
8135 =over 4
8136
8137 =item PROGRAMMING STYLE
8138
8139 =item CALLING CGI.PM ROUTINES
8140
8141 =item CREATING A NEW QUERY OBJECT (OBJECT-ORIENTED STYLE):
8142
8143 =item CREATING A NEW QUERY OBJECT FROM AN INPUT FILE
8144
8145 =item FETCHING A LIST OF KEYWORDS FROM THE QUERY:
8146
8147 =item FETCHING THE NAMES OF ALL THE PARAMETERS PASSED TO YOUR SCRIPT:
8148
8149 =item FETCHING THE VALUE OR VALUES OF A SINGLE NAMED PARAMETER:
8150
8151 =item SETTING THE VALUE(S) OF A NAMED PARAMETER:
8152
8153 =item APPENDING ADDITIONAL VALUES TO A NAMED PARAMETER:
8154
8155 =item IMPORTING ALL PARAMETERS INTO A NAMESPACE:
8156
8157 =item DELETING A PARAMETER COMPLETELY:
8158
8159 =item DELETING ALL PARAMETERS:
8160
8161 =item DIRECT ACCESS TO THE PARAMETER LIST:
8162
8163 =item FETCHING THE PARAMETER LIST AS A HASH:
8164
8165 =item SAVING THE STATE OF THE SCRIPT TO A FILE:
8166
8167 =item RETRIEVING CGI ERRORS
8168
8169 =item USING THE FUNCTION-ORIENTED INTERFACE
8170
8171 B<:cgi>, B<:form>, B<:html2>, B<:html3>, B<:netscape>, B<:html>,
8172 B<:standard>, B<:all>
8173
8174 =item PRAGMAS
8175
8176 -any, -compile, -nosticky, -no_undef_params, -no_xhtml, -nph,
8177 -newstyle_urls, -oldstyle_urls, -autoload, -no_debug, -debug,
8178 -private_tempfiles
8179
8180 =item SPECIAL FORMS FOR IMPORTING HTML-TAG FUNCTIONS
8181
8182 1. start_table() (generates a <TABLE> tag), 2. end_table() (generates a
8183 </TABLE> tag), 3. start_ul() (generates a <UL> tag), 4. end_ul() (generates
8184 a </UL> tag)
8185
8186 =back
8187
8188 =item GENERATING DYNAMIC DOCUMENTS
8189
8190 =over 4
8191
8192 =item CREATING A STANDARD HTTP HEADER:
8193
8194 =item GENERATING A REDIRECTION HEADER
8195
8196 =item CREATING THE HTML DOCUMENT HEADER
8197
8198 B<Parameters:>, 4, 5, 6..
8199
8200 =item ENDING THE HTML DOCUMENT:
8201
8202 =item CREATING A SELF-REFERENCING URL THAT PRESERVES STATE INFORMATION:
8203
8204 =item OBTAINING THE SCRIPT'S URL
8205
8206 B<-absolute>, B<-relative>, B<-full>, B<-path> (B<-path_info>), B<-query>
8207 (B<-query_string>), B<-base>
8208
8209 =item MIXING POST AND URL PARAMETERS
8210
8211 =back
8212
8213 =item CREATING STANDARD HTML ELEMENTS:
8214
8215 =over 4
8216
8217 =item PROVIDING ARGUMENTS TO HTML SHORTCUTS
8218
8219 =item THE DISTRIBUTIVE PROPERTY OF HTML SHORTCUTS
8220
8221 =item HTML SHORTCUTS AND LIST INTERPOLATION
8222
8223 =item NON-STANDARD HTML SHORTCUTS
8224
8225 =item AUTOESCAPING HTML
8226
8227 $escaped_string = escapeHTML("unescaped string");, $charset =
8228 charset([$charset]);, $flag = autoEscape([$flag]);
8229
8230 =item PRETTY-PRINTING HTML
8231
8232 =back
8233
8234 =item CREATING FILL-OUT FORMS:
8235
8236 =over 4
8237
8238 =item CREATING AN ISINDEX TAG
8239
8240 =item STARTING AND ENDING A FORM
8241
8242 B<application/x-www-form-urlencoded>, B<multipart/form-data>
8243
8244 =item CREATING A TEXT FIELD
8245
8246 B<Parameters>
8247
8248 =item CREATING A BIG TEXT FIELD
8249
8250 =item CREATING A PASSWORD FIELD
8251
8252 =item CREATING A FILE UPLOAD FIELD
8253
8254 B<Parameters>
8255
8256 =item CREATING A POPUP MENU
8257
8258 =item CREATING A SCROLLING LIST
8259
8260 B<Parameters:>
8261
8262 =item CREATING A GROUP OF RELATED CHECKBOXES
8263
8264 B<Parameters:>
8265
8266 =item CREATING A STANDALONE CHECKBOX
8267
8268 B<Parameters:>
8269
8270 =item CREATING A RADIO BUTTON GROUP
8271
8272 B<Parameters:>
8273
8274 =item CREATING A SUBMIT BUTTON
8275
8276 B<Parameters:>
8277
8278 =item CREATING A RESET BUTTON
8279
8280 =item CREATING A DEFAULT BUTTON
8281
8282 =item CREATING A HIDDEN FIELD
8283
8284 B<Parameters:>
8285
8286 =item CREATING A CLICKABLE IMAGE BUTTON
8287
8288 B<Parameters:>
8289
8290 =item CREATING A JAVASCRIPT ACTION BUTTON
8291
8292 =back
8293
8294 =item HTTP COOKIES
8295
8296 1. an expiration time, 2. a domain, 3. a path, 4. a "secure" flag,
8297 B<-name>, B<-value>, B<-path>, B<-domain>, B<-expires>, B<-secure>
8298
8299 =item WORKING WITH FRAMES
8300
8301 1. Create a <Frameset> document, 2. Specify the destination for the
8302 document in the HTTP header, 3. Specify the destination for the document in
8303 the <FORM> tag
8304
8305 =item LIMITED SUPPORT FOR CASCADING STYLE SHEETS
8306
8307 =item DEBUGGING
8308
8309 =over 4
8310
8311 =item DUMPING OUT ALL THE NAME/VALUE PAIRS
8312
8313 =back
8314
8315 =item FETCHING ENVIRONMENT VARIABLES
8316
8317 B<Accept()>, B<raw_cookie()>, B<user_agent()>, B<path_info()>,
8318 B<path_translated()>, B<remote_host()>, B<script_name()>, B<referer()>,
8319 B<auth_type ()>, B<server_name ()>, B<virtual_host ()>, B<server_port ()>,
8320 B<server_software ()>, B<remote_user ()>, B<user_name ()>,
8321 B<request_method()>, B<content_type()>, B<http()>, B<https()>
8322
8323 =item USING NPH SCRIPTS
8324
8325 In the B<use> statement, By calling the B<nph()> method:, By using B<-nph>
8326 parameters
8327
8328 =item Server Push
8329
8330 multipart_init(), multipart_start(), multipart_end(), multipart_final()
8331
8332 =item Avoiding Denial of Service Attacks
8333
8334 B<$CGI::POST_MAX>, B<$CGI::DISABLE_UPLOADS>, B<1. On a script-by-script
8335 basis>, B<2. Globally for all scripts>
8336
8337 =item COMPATIBILITY WITH CGI-LIB.PL
8338
8339 =item AUTHOR INFORMATION
8340
8341 =item CREDITS
8342
8343 Matt Heffron (heffron@falstaff.css.beckman.com), James Taylor
8344 (james.taylor@srs.gov), Scott Anguish <sanguish@digifix.com>, Mike Jewell
8345 (mlj3u@virginia.edu), Timothy Shimmin (tes@kbs.citri.edu.au), Joergen Haegg
8346 (jh@axis.se), Laurent Delfosse (delfosse@delfosse.com), Richard Resnick
8347 (applepi1@aol.com), Craig Bishop (csb@barwonwater.vic.gov.au), Tony Curtis
8348 (tc@vcpc.univie.ac.at), Tim Bunce (Tim.Bunce@ig.co.uk), Tom Christiansen
8349 (tchrist@convex.com), Andreas Koenig (k@franz.ww.TU-Berlin.DE), Tim
8350 MacKenzie (Tim.MacKenzie@fulcrum.com.au), Kevin B. Hendricks
8351 (kbhend@dogwood.tyler.wm.edu), Stephen Dahmen (joyfire@inxpress.net), Ed
8352 Jordan (ed@fidalgo.net), David Alan Pisoni (david@cnation.com), Doug
8353 MacEachern (dougm@opengroup.org), Robin Houston (robin@oneworld.org),
8354 ...and many many more..
8355
8356 =item A COMPLETE EXAMPLE OF A SIMPLE FORM-BASED SCRIPT
8357
8358 =item BUGS
8359
8360 =item SEE ALSO
8361
8362 =back
8363
8364 =head2 CGI::Apache - Backward compatibility module for CGI.pm
8365
8366 =over 4
8367
8368 =item SYNOPSIS
8369
8370 =item ABSTRACT
8371
8372 =item DESCRIPTION
8373
8374 =item AUTHOR INFORMATION
8375
8376 =item BUGS
8377
8378 =item SEE ALSO
8379
8380 =back
8381
8382 =head2 CGI::Carp, B<CGI::Carp> - CGI routines for writing to the HTTPD (or
8383 other) error log
8384
8385 =over 4
8386
8387 =item SYNOPSIS
8388
8389 =item DESCRIPTION
8390
8391 =item REDIRECTING ERROR MESSAGES
8392
8393 =item MAKING PERL ERRORS APPEAR IN THE BROWSER WINDOW
8394
8395 =over 4
8396
8397 =item Changing the default message
8398
8399 =back
8400
8401 =item MAKING WARNINGS APPEAR AS HTML COMMENTS
8402
8403 =item CHANGE LOG
8404
8405 =item AUTHORS
8406
8407 =item SEE ALSO
8408
8409 =back
8410
8411 =head2 CGI::Cookie - Interface to Netscape Cookies
8412
8413 =over 4
8414
8415 =item SYNOPSIS
8416
8417 =item DESCRIPTION
8418
8419 =item USING CGI::Cookie
8420
8421 B<1. expiration date>, B<2. domain>, B<3. path>, B<4. secure flag>
8422
8423 =over 4
8424
8425 =item Creating New Cookies
8426
8427 =item Sending the Cookie to the Browser
8428
8429 =item Recovering Previous Cookies
8430
8431 =item Manipulating Cookies
8432
8433 B<name()>, B<value()>, B<domain()>, B<path()>, B<expires()>
8434
8435 =back
8436
8437 =item AUTHOR INFORMATION
8438
8439 =item BUGS
8440
8441 =item SEE ALSO
8442
8443 =back
8444
8445 =head2 CGI::Fast - CGI Interface for Fast CGI
8446
8447 =over 4
8448
8449 =item SYNOPSIS
8450
8451 =item DESCRIPTION
8452
8453 =item OTHER PIECES OF THE PUZZLE
8454
8455 =item WRITING FASTCGI PERL SCRIPTS
8456
8457 =item INSTALLING FASTCGI SCRIPTS
8458
8459 =item USING FASTCGI SCRIPTS AS CGI SCRIPTS
8460
8461 =item EXTERNAL FASTCGI SERVER INVOCATION
8462
8463 FCGI_SOCKET_PATH, FCGI_LISTEN_QUEUE
8464
8465 =item CAVEATS
8466
8467 =item AUTHOR INFORMATION
8468
8469 =item BUGS
8470
8471 =item SEE ALSO
8472
8473 =back
8474
8475 =head2 CGI::Pretty - module to produce nicely formatted HTML code
8476
8477 =over 4
8478
8479 =item SYNOPSIS
8480
8481 =item DESCRIPTION
8482
8483 =over 4
8484
8485 =item Tags that won't be formatted
8486
8487 =item Customizing the Indenting
8488
8489 =back
8490
8491 =item BUGS
8492
8493 =item AUTHOR
8494
8495 =item SEE ALSO
8496
8497 =back
8498
8499 =head2 CGI::Push - Simple Interface to Server Push
8500
8501 =over 4
8502
8503 =item SYNOPSIS
8504
8505 =item DESCRIPTION
8506
8507 =item USING CGI::Push
8508
8509 -next_page, -last_page, -type, -delay, -cookie, -target, -expires, -nph
8510
8511 =over 4
8512
8513 =item Heterogeneous Pages
8514
8515 =item Changing the Page Delay on the Fly
8516
8517 =back
8518
8519 =item INSTALLING CGI::Push SCRIPTS
8520
8521 =item AUTHOR INFORMATION
8522
8523 =item BUGS
8524
8525 =item SEE ALSO
8526
8527 =back
8528
8529 =head2 CGI::Switch - Backward compatibility module for defunct CGI::Switch
8530
8531 =over 4
8532
8533 =item SYNOPSIS
8534
8535 =item ABSTRACT
8536
8537 =item DESCRIPTION
8538
8539 =item AUTHOR INFORMATION
8540
8541 =item BUGS
8542
8543 =item SEE ALSO
8544
8545 =back
8546
8547 =head2 CGI::Util - Internal utilities used by CGI module
8548
8549 =over 4
8550
8551 =item SYNOPSIS
8552
8553 =item DESCRIPTION
8554
8555 =item AUTHOR INFORMATION
8556
8557 =item SEE ALSO
8558
8559 =back
8560
8561 =head2 CPAN - query, download and build perl modules from CPAN sites
8562
8563 =over 4
8564
8565 =item SYNOPSIS
8566
8567 =item DESCRIPTION
8568
8569 =over 4
8570
8571 =item Interactive Mode
8572
8573 Searching for authors, bundles, distribution files and modules, make, test,
8574 install, clean  modules or distributions, get, readme, look module or
8575 distribution, ls author, Signals
8576
8577 =item CPAN::Shell
8578
8579 =item autobundle
8580
8581 =item recompile
8582
8583 =item The four C<CPAN::*> Classes: Author, Bundle, Module, Distribution
8584
8585 =item Programmer's interface
8586
8587 expand($type,@things), expandany(@things), Programming Examples
8588
8589 =item Methods in the other Classes
8590
8591 CPAN::Author::as_glimpse(), CPAN::Author::as_string(),
8592 CPAN::Author::email(), CPAN::Author::fullname(), CPAN::Author::name(),
8593 CPAN::Bundle::as_glimpse(), CPAN::Bundle::as_string(),
8594 CPAN::Bundle::clean(), CPAN::Bundle::contains(),
8595 CPAN::Bundle::force($method,@args), CPAN::Bundle::get(),
8596 CPAN::Bundle::inst_file(), CPAN::Bundle::inst_version(),
8597 CPAN::Bundle::uptodate(), CPAN::Bundle::install(), CPAN::Bundle::make(),
8598 CPAN::Bundle::readme(), CPAN::Bundle::test(),
8599 CPAN::Distribution::as_glimpse(), CPAN::Distribution::as_string(),
8600 CPAN::Distribution::clean(), CPAN::Distribution::containsmods(),
8601 CPAN::Distribution::cvs_import(), CPAN::Distribution::dir(),
8602 CPAN::Distribution::force($method,@args), CPAN::Distribution::get(),
8603 CPAN::Distribution::install(), CPAN::Distribution::isa_perl(),
8604 CPAN::Distribution::look(), CPAN::Distribution::make(),
8605 CPAN::Distribution::prereq_pm(), CPAN::Distribution::readme(),
8606 CPAN::Distribution::test(), CPAN::Distribution::uptodate(),
8607 CPAN::Index::force_reload(), CPAN::Index::reload(), CPAN::InfoObj::dump(),
8608 CPAN::Module::as_glimpse(), CPAN::Module::as_string(),
8609 CPAN::Module::clean(), CPAN::Module::cpan_file(),
8610 CPAN::Module::cpan_version(), CPAN::Module::cvs_import(),
8611 CPAN::Module::description(), CPAN::Module::force($method,@args),
8612 CPAN::Module::get(), CPAN::Module::inst_file(),
8613 CPAN::Module::inst_version(), CPAN::Module::install(),
8614 CPAN::Module::look(), CPAN::Module::make(),
8615 CPAN::Module::manpage_headline(), CPAN::Module::readme(),
8616 CPAN::Module::test(), CPAN::Module::uptodate(), CPAN::Module::userid()
8617
8618 =item Cache Manager
8619
8620 =item Bundles
8621
8622 =item Prerequisites
8623
8624 =item Finding packages and VERSION
8625
8626 =item Debugging
8627
8628 =item Floppy, Zip, Offline Mode
8629
8630 =back
8631
8632 =item CONFIGURATION
8633
8634 C<o conf E<lt>scalar optionE<gt>>, C<o conf E<lt>scalar optionE<gt>
8635 E<lt>valueE<gt>>, C<o conf E<lt>list optionE<gt>>, C<o conf E<lt>list
8636 optionE<gt> [shift|pop]>, C<o conf E<lt>list optionE<gt>
8637 [unshift|push|splice] E<lt>listE<gt>>
8638
8639 =over 4
8640
8641 =item Note on urllist parameter's format
8642
8643 =item urllist parameter has CD-ROM support
8644
8645 =back
8646
8647 =item SECURITY
8648
8649 =item EXPORT
8650
8651 =item POPULATE AN INSTALLATION WITH LOTS OF MODULES
8652
8653 =item WORKING WITH CPAN.pm BEHIND FIREWALLS
8654
8655 =over 4
8656
8657 =item Three basic types of firewalls
8658
8659 http firewall, ftp firewall, One way visibility, SOCKS, IP Masquerade
8660
8661 =item Configuring lynx or ncftp for going through a firewall
8662
8663 =back
8664
8665 =item FAQ
8666
8667 1), 2), 3), 4), 5), 6), 7), 8), 9), 10)
8668
8669 =item BUGS
8670
8671 =item AUTHOR
8672
8673 =item TRANSLATIONS
8674
8675 =item SEE ALSO
8676
8677 =back
8678
8679 =head2 CPAN::FirstTime - Utility for CPAN::Config file Initialization
8680
8681 =over 4
8682
8683 =item SYNOPSIS
8684
8685 =item DESCRIPTION
8686
8687 =back
8688
8689 =head2 CPANox, CPAN::Nox - Wrapper around CPAN.pm without using any XS
8690 module
8691
8692 =over 4
8693
8694 =item SYNOPSIS
8695
8696 =item DESCRIPTION
8697
8698 =item  SEE ALSO
8699
8700 =back
8701
8702 =head2 Carp, carp    - warn of errors (from perspective of caller)
8703
8704 =over 4
8705
8706 =item SYNOPSIS
8707
8708 =item DESCRIPTION
8709
8710 =over 4
8711
8712 =item Forcing a Stack Trace
8713
8714 =back
8715
8716 =item BUGS
8717
8718 =back
8719
8720 =head2 Carp::Heavy, Carp heavy machinery - no user serviceable parts inside
8721
8722 =head2 Class::ISA -- report the search path for a class's ISA tree
8723
8724 =over 4
8725
8726 =item SYNOPSIS
8727
8728 =item DESCRIPTION
8729
8730 =item FUNCTIONS
8731
8732 the function Class::ISA::super_path($CLASS), the function
8733 Class::ISA::self_and_super_path($CLASS), the function
8734 Class::ISA::self_and_super_versions($CLASS)
8735
8736 =item CAUTIONARY NOTES
8737
8738 =item COPYRIGHT
8739
8740 =item AUTHOR
8741
8742 =back
8743
8744 =head2 Class::Struct - declare struct-like datatypes as Perl classes
8745
8746 =over 4
8747
8748 =item SYNOPSIS
8749
8750 =item DESCRIPTION
8751
8752 =over 4
8753
8754 =item The C<struct()> function
8755
8756 =item Class Creation at Compile Time
8757
8758 =item Element Types and Accessor Methods
8759
8760 Scalar (C<'$'> or C<'*$'>), Array (C<'@'> or C<'*@'>), Hash (C<'%'> or
8761 C<'*%'>), Class (C<'Class_Name'> or C<'*Class_Name'>)
8762
8763 =item Initializing with C<new>
8764
8765 =back
8766
8767 =item EXAMPLES
8768
8769 Example 1, Example 2, Example 3
8770
8771 =item Author and Modification History
8772
8773 =back
8774
8775 =head2 Config - access Perl configuration information
8776
8777 =over 4
8778
8779 =item SYNOPSIS
8780
8781 =item DESCRIPTION
8782
8783 myconfig(), config_sh(), config_vars(@names)
8784
8785 =item EXAMPLE
8786
8787 =item WARNING
8788
8789 =item GLOSSARY
8790
8791 =over 4
8792
8793 =item _
8794
8795 C<_a>, C<_exe>, C<_o>
8796
8797 =item a
8798
8799 C<afs>, C<afsroot>, C<alignbytes>, C<ansi2knr>, C<aphostname>,
8800 C<api_revision>, C<api_subversion>, C<api_version>, C<api_versionstring>,
8801 C<ar>, C<archlib>, C<archlibexp>, C<archname64>, C<archname>, C<archobjs>,
8802 C<awk>
8803
8804 =item b
8805
8806 C<baserev>, C<bash>, C<bin>, C<bincompat5005>, C<binexp>, C<bison>,
8807 C<byacc>, C<byteorder>
8808
8809 =item c
8810
8811 C<c>, C<castflags>, C<cat>, C<cc>, C<cccdlflags>, C<ccdlflags>, C<ccflags>,
8812 C<ccflags_uselargefiles>, C<ccname>, C<ccsymbols>, C<ccversion>, C<cf_by>,
8813 C<cf_email>, C<cf_time>, C<charsize>, C<chgrp>, C<chmod>, C<chown>,
8814 C<clocktype>, C<comm>, C<compress>, C<contains>, C<cp>, C<cpio>, C<cpp>,
8815 C<cpp_stuff>, C<cppccsymbols>, C<cppflags>, C<cpplast>, C<cppminus>,
8816 C<cpprun>, C<cppstdin>, C<cppsymbols>, C<cryptlib>, C<csh>
8817
8818 =item d
8819
8820 C<d__fwalk>, C<d_access>, C<d_accessx>, C<d_alarm>, C<d_archlib>,
8821 C<d_atolf>, C<d_atoll>, C<d_attribut>, C<d_bcmp>, C<d_bcopy>,
8822 C<d_bincompat5005>, C<d_bsd>, C<d_bsdgetpgrp>, C<d_bsdsetpgrp>, C<d_bzero>,
8823 C<d_casti32>, C<d_castneg>, C<d_charvspr>, C<d_chown>, C<d_chroot>,
8824 C<d_chsize>, C<d_class>, C<d_closedir>, C<d_cmsghdr_s>, C<d_const>,
8825 C<d_crypt>, C<d_csh>, C<d_cuserid>, C<d_dbl_dig>, C<d_dbminitproto>,
8826 C<d_difftime>, C<d_dirnamlen>, C<d_dlerror>, C<d_dlopen>, C<d_dlsymun>,
8827 C<d_dosuid>, C<d_drand48proto>, C<d_dup2>, C<d_eaccess>, C<d_endgrent>,
8828 C<d_endhent>, C<d_endnent>, C<d_endpent>, C<d_endpwent>, C<d_endsent>,
8829 C<d_eofnblk>, C<d_eunice>, C<d_fchdir>, C<d_fchmod>, C<d_fchown>,
8830 C<d_fcntl>, C<d_fcntl_can_lock>, C<d_fd_macros>, C<d_fd_set>,
8831 C<d_fds_bits>, C<d_fgetpos>, C<d_finite>, C<d_finitel>, C<d_flexfnam>,
8832 C<d_flock>, C<d_flockproto>, C<d_fork>, C<d_fp_class>, C<d_fpathconf>,
8833 C<d_fpclass>, C<d_fpclassify>, C<d_fpclassl>, C<d_fpos64_t>, C<d_frexpl>,
8834 C<d_fs_data_s>, C<d_fseeko>, C<d_fsetpos>, C<d_fstatfs>, C<d_fstatvfs>,
8835 C<d_fsync>, C<d_ftello>, C<d_ftime>, C<d_Gconvert>, C<d_getcwd>,
8836 C<d_getespwnam>, C<d_getfsstat>, C<d_getgrent>, C<d_getgrps>,
8837 C<d_gethbyaddr>, C<d_gethbyname>, C<d_gethent>, C<d_gethname>,
8838 C<d_gethostprotos>, C<d_getitimer>, C<d_getlogin>, C<d_getmnt>,
8839 C<d_getmntent>, C<d_getnbyaddr>, C<d_getnbyname>, C<d_getnent>,
8840 C<d_getnetprotos>, C<d_getpagsz>, C<d_getpbyname>, C<d_getpbynumber>,
8841 C<d_getpent>, C<d_getpgid>, C<d_getpgrp2>, C<d_getpgrp>, C<d_getppid>,
8842 C<d_getprior>, C<d_getprotoprotos>, C<d_getprpwnam>, C<d_getpwent>,
8843 C<d_getsbyname>, C<d_getsbyport>, C<d_getsent>, C<d_getservprotos>,
8844 C<d_getspnam>, C<d_gettimeod>, C<d_gnulibc>, C<d_grpasswd>, C<d_hasmntopt>,
8845 C<d_htonl>, C<d_iconv>, C<d_index>, C<d_inetaton>, C<d_int64_t>,
8846 C<d_isascii>, C<d_isfinite>, C<d_isinf>, C<d_isnan>, C<d_isnanl>,
8847 C<d_killpg>, C<d_lchown>, C<d_ldbl_dig>, C<d_link>, C<d_locconv>,
8848 C<d_lockf>, C<d_longdbl>, C<d_longlong>, C<d_lseekproto>, C<d_lstat>,
8849 C<d_madvise>, C<d_mblen>, C<d_mbstowcs>, C<d_mbtowc>, C<d_memchr>,
8850 C<d_memcmp>, C<d_memcpy>, C<d_memmove>, C<d_memset>, C<d_mkdir>,
8851 C<d_mkdtemp>, C<d_mkfifo>, C<d_mkstemp>, C<d_mkstemps>, C<d_mktime>,
8852 C<d_mmap>, C<d_modfl>, C<d_modfl_pow32_bug>, C<d_mprotect>, C<d_msg>,
8853 C<d_msg_ctrunc>, C<d_msg_dontroute>, C<d_msg_oob>, C<d_msg_peek>,
8854 C<d_msg_proxy>, C<d_msgctl>, C<d_msgget>, C<d_msghdr_s>, C<d_msgrcv>,
8855 C<d_msgsnd>, C<d_msync>, C<d_munmap>, C<d_mymalloc>, C<d_nice>,
8856 C<d_nl_langinfo>, C<d_nv_preserves_uv>, C<d_nv_preserves_uv_bits>,
8857 C<d_off64_t>, C<d_old_pthread_create_joinable>, C<d_oldpthreads>,
8858 C<d_oldsock>, C<d_open3>, C<d_pathconf>, C<d_pause>,
8859 C<d_perl_otherlibdirs>, C<d_phostname>, C<d_pipe>, C<d_poll>,
8860 C<d_portable>, C<d_PRId64>, C<d_PRIeldbl>, C<d_PRIEUldbl>, C<d_PRIfldbl>,
8861 C<d_PRIFUldbl>, C<d_PRIgldbl>, C<d_PRIGUldbl>, C<d_PRIi64>, C<d_PRIo64>,
8862 C<d_PRIu64>, C<d_PRIx64>, C<d_PRIXU64>, C<d_pthread_atfork>,
8863 C<d_pthread_yield>, C<d_pwage>, C<d_pwchange>, C<d_pwclass>,
8864 C<d_pwcomment>, C<d_pwexpire>, C<d_pwgecos>, C<d_pwpasswd>, C<d_pwquota>,
8865 C<d_qgcvt>, C<d_quad>, C<d_readdir>, C<d_readlink>, C<d_readv>,
8866 C<d_recvmsg>, C<d_rename>, C<d_rewinddir>, C<d_rmdir>, C<d_safebcpy>,
8867 C<d_safemcpy>, C<d_sanemcmp>, C<d_sbrkproto>, C<d_sched_yield>,
8868 C<d_scm_rights>, C<d_SCNfldbl>, C<d_seekdir>, C<d_select>, C<d_sem>,
8869 C<d_semctl>, C<d_semctl_semid_ds>, C<d_semctl_semun>, C<d_semget>,
8870 C<d_semop>, C<d_sendmsg>, C<d_setegid>, C<d_seteuid>, C<d_setgrent>,
8871 C<d_setgrps>, C<d_sethent>, C<d_setitimer>, C<d_setlinebuf>,
8872 C<d_setlocale>, C<d_setnent>, C<d_setpent>, C<d_setpgid>, C<d_setpgrp2>,
8873 C<d_setpgrp>, C<d_setprior>, C<d_setproctitle>, C<d_setpwent>,
8874 C<d_setregid>, C<d_setresgid>, C<d_setresuid>, C<d_setreuid>, C<d_setrgid>,
8875 C<d_setruid>, C<d_setsent>, C<d_setsid>, C<d_setvbuf>, C<d_sfio>, C<d_shm>,
8876 C<d_shmat>, C<d_shmatprototype>, C<d_shmctl>, C<d_shmdt>, C<d_shmget>,
8877 C<d_sigaction>, C<d_sigprocmask>, C<d_sigsetjmp>, C<d_sockatmark>,
8878 C<d_sockatmarkproto>, C<d_socket>, C<d_socklen_t>, C<d_sockpair>,
8879 C<d_socks5_init>, C<d_sqrtl>, C<d_sresgproto>, C<d_sresuproto>,
8880 C<d_statblks>, C<d_statfs_f_flags>, C<d_statfs_s>, C<d_statvfs>,
8881 C<d_stdio_cnt_lval>, C<d_stdio_ptr_lval>, C<d_stdio_ptr_lval_nochange_cnt>,
8882 C<d_stdio_ptr_lval_sets_cnt>, C<d_stdio_stream_array>, C<d_stdiobase>,
8883 C<d_stdstdio>, C<d_strchr>, C<d_strcoll>, C<d_strctcpy>, C<d_strerrm>,
8884 C<d_strerror>, C<d_strftime>, C<d_strtod>, C<d_strtol>, C<d_strtold>,
8885 C<d_strtoll>, C<d_strtoq>, C<d_strtoul>, C<d_strtoull>, C<d_strtouq>,
8886 C<d_strxfrm>, C<d_suidsafe>, C<d_symlink>, C<d_syscall>, C<d_syscallproto>,
8887 C<d_sysconf>, C<d_sysernlst>, C<d_syserrlst>, C<d_system>, C<d_tcgetpgrp>,
8888 C<d_tcsetpgrp>, C<d_telldir>, C<d_telldirproto>, C<d_time>, C<d_times>,
8889 C<d_truncate>, C<d_tzname>, C<d_u32align>, C<d_ualarm>, C<d_umask>,
8890 C<d_uname>, C<d_union_semun>, C<d_unordered>, C<d_usleep>,
8891 C<d_usleepproto>, C<d_ustat>, C<d_vendorarch>, C<d_vendorbin>,
8892 C<d_vendorlib>, C<d_vfork>, C<d_void_closedir>, C<d_voidsig>, C<d_voidtty>,
8893 C<d_volatile>, C<d_vprintf>, C<d_wait4>, C<d_waitpid>, C<d_wcstombs>,
8894 C<d_wctomb>, C<d_writev>, C<d_xenix>, C<date>, C<db_hashtype>,
8895 C<db_prefixtype>, C<db_version_major>, C<db_version_minor>,
8896 C<db_version_patch>, C<defvoidused>, C<direntrytype>, C<dlext>, C<dlsrc>,
8897 C<doublesize>, C<drand01>, C<dynamic_ext>
8898
8899 =item e
8900
8901 C<eagain>, C<ebcdic>, C<echo>, C<egrep>, C<emacs>, C<eunicefix>,
8902 C<exe_ext>, C<expr>, C<extensions>, C<extras>
8903
8904 =item f
8905
8906 C<fflushall>, C<fflushNULL>, C<find>, C<firstmakefile>, C<flex>,
8907 C<fpossize>, C<fpostype>, C<freetype>, C<from>, C<full_ar>, C<full_csh>,
8908 C<full_sed>
8909
8910 =item g
8911
8912 C<gccosandvers>, C<gccversion>, C<gidformat>, C<gidsign>, C<gidsize>,
8913 C<gidtype>, C<glibpth>, C<grep>, C<groupcat>, C<groupstype>, C<gzip>
8914
8915 =item h
8916
8917 C<h_fcntl>, C<h_sysfile>, C<hint>, C<hostcat>
8918
8919 =item i
8920
8921 C<i16size>, C<i16type>, C<i32size>, C<i32type>, C<i64size>, C<i64type>,
8922 C<i8size>, C<i8type>, C<i_arpainet>, C<i_bsdioctl>, C<i_db>, C<i_dbm>,
8923 C<i_dirent>, C<i_dld>, C<i_dlfcn>, C<i_fcntl>, C<i_float>, C<i_fp>,
8924 C<i_fp_class>, C<i_gdbm>, C<i_grp>, C<i_iconv>, C<i_ieeefp>, C<i_inttypes>,
8925 C<i_langinfo>, C<i_libutil>, C<i_limits>, C<i_locale>, C<i_machcthr>,
8926 C<i_malloc>, C<i_math>, C<i_memory>, C<i_mntent>, C<i_ndbm>, C<i_netdb>,
8927 C<i_neterrno>, C<i_netinettcp>, C<i_niin>, C<i_poll>, C<i_prot>,
8928 C<i_pthread>, C<i_pwd>, C<i_rpcsvcdbm>, C<i_sfio>, C<i_sgtty>, C<i_shadow>,
8929 C<i_socks>, C<i_stdarg>, C<i_stddef>, C<i_stdlib>, C<i_string>,
8930 C<i_sunmath>, C<i_sysaccess>, C<i_sysdir>, C<i_sysfile>, C<i_sysfilio>,
8931 C<i_sysin>, C<i_sysioctl>, C<i_syslog>, C<i_sysmman>, C<i_sysmode>,
8932 C<i_sysmount>, C<i_sysndir>, C<i_sysparam>, C<i_sysresrc>, C<i_syssecrt>,
8933 C<i_sysselct>, C<i_syssockio>, C<i_sysstat>, C<i_sysstatfs>,
8934 C<i_sysstatvfs>, C<i_systime>, C<i_systimek>, C<i_systimes>, C<i_systypes>,
8935 C<i_sysuio>, C<i_sysun>, C<i_sysutsname>, C<i_sysvfs>, C<i_syswait>,
8936 C<i_termio>, C<i_termios>, C<i_time>, C<i_unistd>, C<i_ustat>, C<i_utime>,
8937 C<i_values>, C<i_varargs>, C<i_varhdr>, C<i_vfork>,
8938 C<ignore_versioned_solibs>, C<inc_version_list>, C<inc_version_list_init>,
8939 C<incpath>, C<inews>, C<installarchlib>, C<installbin>, C<installman1dir>,
8940 C<installman3dir>, C<installprefix>, C<installprefixexp>,
8941 C<installprivlib>, C<installscript>, C<installsitearch>, C<installsitebin>,
8942 C<installsitelib>, C<installstyle>, C<installusrbinperl>,
8943 C<installvendorarch>, C<installvendorbin>, C<installvendorlib>, C<intsize>,
8944 C<issymlink>, C<ivdformat>, C<ivsize>, C<ivtype>
8945
8946 =item k
8947
8948 C<known_extensions>, C<ksh>
8949
8950 =item l
8951
8952 C<ld>, C<lddlflags>, C<ldflags>, C<ldflags_uselargefiles>, C<ldlibpthname>,
8953 C<less>, C<lib_ext>, C<libc>, C<libperl>, C<libpth>, C<libs>, C<libsdirs>,
8954 C<libsfiles>, C<libsfound>, C<libspath>, C<libswanted>,
8955 C<libswanted_uselargefiles>, C<line>, C<lint>, C<lkflags>, C<ln>, C<lns>,
8956 C<locincpth>, C<loclibpth>, C<longdblsize>, C<longlongsize>, C<longsize>,
8957 C<lp>, C<lpr>, C<ls>, C<lseeksize>, C<lseektype>
8958
8959 =item m
8960
8961 C<mail>, C<mailx>, C<make>, C<make_set_make>, C<mallocobj>, C<mallocsrc>,
8962 C<malloctype>, C<man1dir>, C<man1direxp>, C<man1ext>, C<man3dir>,
8963 C<man3direxp>, C<man3ext>
8964
8965 =item M
8966
8967 C<Mcc>, C<mips_type>, C<mkdir>, C<mmaptype>, C<modetype>, C<more>,
8968 C<multiarch>, C<mv>, C<myarchname>, C<mydomain>, C<myhostname>, C<myuname>
8969
8970 =item n
8971
8972 C<n>, C<need_va_copy>, C<netdb_hlen_type>, C<netdb_host_type>,
8973 C<netdb_name_type>, C<netdb_net_type>, C<nm>, C<nm_opt>, C<nm_so_opt>,
8974 C<nonxs_ext>, C<nroff>, C<nveformat>, C<nvEUformat>, C<nvfformat>,
8975 C<nvFUformat>, C<nvgformat>, C<nvGUformat>, C<nvsize>, C<nvtype>
8976
8977 =item o
8978
8979 C<o_nonblock>, C<obj_ext>, C<old_pthread_create_joinable>, C<optimize>,
8980 C<orderlib>, C<osname>, C<osvers>, C<otherlibdirs>
8981
8982 =item p
8983
8984 C<package>, C<pager>, C<passcat>, C<patchlevel>, C<path_sep>, C<perl5>,
8985 C<perl>, C<perl_patchlevel>
8986
8987 =item P
8988
8989 C<PERL_REVISION>, C<PERL_SUBVERSION>, C<PERL_VERSION>, C<perladmin>,
8990 C<perllibs>, C<perlpath>, C<pg>, C<phostname>, C<pidtype>, C<plibpth>,
8991 C<pm_apiversion>, C<pmake>, C<pr>, C<prefix>, C<prefixexp>, C<privlib>,
8992 C<privlibexp>, C<prototype>, C<ptrsize>
8993
8994 =item q
8995
8996 C<quadkind>, C<quadtype>
8997
8998 =item r
8999
9000 C<randbits>, C<randfunc>, C<randseedtype>, C<ranlib>, C<rd_nodata>,
9001 C<revision>, C<rm>, C<rmail>, C<run>, C<runnm>
9002
9003 =item s
9004
9005 C<sched_yield>, C<scriptdir>, C<scriptdirexp>, C<sed>, C<seedfunc>,
9006 C<selectminbits>, C<selecttype>, C<sendmail>, C<sh>, C<shar>, C<sharpbang>,
9007 C<shmattype>, C<shortsize>, C<shrpenv>, C<shsharp>, C<sig_count>,
9008 C<sig_name>, C<sig_name_init>, C<sig_num>, C<sig_num_init>, C<sig_size>,
9009 C<signal_t>, C<sitearch>, C<sitearchexp>, C<sitebin>, C<sitebinexp>,
9010 C<sitelib>, C<sitelib_stem>, C<sitelibexp>, C<siteprefix>,
9011 C<siteprefixexp>, C<sizesize>, C<sizetype>, C<sleep>, C<smail>, C<so>,
9012 C<sockethdr>, C<socketlib>, C<socksizetype>, C<sort>, C<spackage>,
9013 C<spitshell>, C<sPRId64>, C<sPRIeldbl>, C<sPRIEUldbl>, C<sPRIfldbl>,
9014 C<sPRIFUldbl>, C<sPRIgldbl>, C<sPRIGUldbl>, C<sPRIi64>, C<sPRIo64>,
9015 C<sPRIu64>, C<sPRIx64>, C<sPRIXU64>, C<src>, C<sSCNfldbl>, C<ssizetype>,
9016 C<startperl>, C<startsh>, C<static_ext>, C<stdchar>, C<stdio_base>,
9017 C<stdio_bufsiz>, C<stdio_cnt>, C<stdio_filbuf>, C<stdio_ptr>,
9018 C<stdio_stream_array>, C<strings>, C<submit>, C<subversion>, C<sysman>
9019
9020 =item t
9021
9022 C<tail>, C<tar>, C<targetarch>, C<tbl>, C<tee>, C<test>, C<timeincl>,
9023 C<timetype>, C<to>, C<touch>, C<tr>, C<trnl>, C<troff>
9024
9025 =item u
9026
9027 C<u16size>, C<u16type>, C<u32size>, C<u32type>, C<u64size>, C<u64type>,
9028 C<u8size>, C<u8type>, C<uidformat>, C<uidsign>, C<uidsize>, C<uidtype>,
9029 C<uname>, C<uniq>, C<uquadtype>, C<use5005threads>, C<use64bitall>,
9030 C<use64bitint>, C<usecrosscompile>, C<usedl>, C<useithreads>,
9031 C<uselargefiles>, C<uselongdouble>, C<usemorebits>, C<usemultiplicity>,
9032 C<usemymalloc>, C<usenm>, C<useopcode>, C<useperlio>, C<useposix>,
9033 C<usereentrant>, C<usesfio>, C<useshrplib>, C<usesocks>, C<usethreads>,
9034 C<usevendorprefix>, C<usevfork>, C<usrinc>, C<uuname>, C<uvoformat>,
9035 C<uvsize>, C<uvtype>, C<uvuformat>, C<uvxformat>, C<uvXUformat>
9036
9037 =item v
9038
9039 C<vendorarch>, C<vendorarchexp>, C<vendorbin>, C<vendorbinexp>,
9040 C<vendorlib>, C<vendorlib_stem>, C<vendorlibexp>, C<vendorprefix>,
9041 C<vendorprefixexp>, C<version>, C<version_patchlevel_string>,
9042 C<versiononly>, C<vi>, C<voidflags>
9043
9044 =item x
9045
9046 C<xlibpth>, C<xs_apiversion>
9047
9048 =item y
9049
9050 C<yacc>, C<yaccflags>
9051
9052 =item z
9053
9054 C<zcat>, C<zip>
9055
9056 =back
9057
9058 =item NOTE
9059
9060 =back
9061
9062 =head2 Cwd - get pathname of current working directory
9063
9064 =over 4
9065
9066 =item SYNOPSIS
9067
9068 =item DESCRIPTION
9069
9070 =over 4
9071
9072 =item getcwd and friends
9073
9074 getcwd, cwd, fastcwd, fastgetcwd
9075
9076 =item abs_path and friends
9077
9078 abs_path, realpath, fast_abs_path
9079
9080 =item $ENV{PWD}
9081
9082 =back
9083
9084 =item NOTES
9085
9086 =item SEE ALSO
9087
9088 =back
9089
9090 =head2 DB - programmatic interface to the Perl debugging API (draft,
9091 subject to
9092 change)
9093
9094 =over 4
9095
9096 =item SYNOPSIS
9097
9098 =item DESCRIPTION
9099
9100 =over 4
9101
9102 =item Global Variables
9103
9104  $DB::sub,  %DB::sub,  $DB::single,  $DB::signal,  $DB::trace,  @DB::args,
9105 @DB::dbline,  %DB::dbline,  $DB::package,  $DB::filename,  $DB::subname,
9106 $DB::lineno
9107
9108 =item API Methods
9109
9110 CLIENT->register(), CLIENT->evalcode(STRING), CLIENT->skippkg('D::hide'),
9111 CLIENT->run(), CLIENT->step(), CLIENT->next(), CLIENT->done()
9112
9113 =item Client Callback Methods
9114
9115 CLIENT->init(), CLIENT->prestop([STRING]), CLIENT->stop(), CLIENT->idle(),
9116 CLIENT->poststop([STRING]), CLIENT->evalcode(STRING), CLIENT->cleanup(),
9117 CLIENT->output(LIST)
9118
9119 =back
9120
9121 =item BUGS
9122
9123 =item AUTHOR
9124
9125 =back
9126
9127 =head2 DB_File - Perl5 access to Berkeley DB version 1.x
9128
9129 =over 4
9130
9131 =item SYNOPSIS
9132
9133 =item DESCRIPTION
9134
9135 B<DB_HASH>, B<DB_BTREE>, B<DB_RECNO>
9136
9137 =over 4
9138
9139 =item Using DB_File with Berkeley DB version 2 or 3
9140
9141 =item Interface to Berkeley DB
9142
9143 =item Opening a Berkeley DB Database File
9144
9145 =item Default Parameters
9146
9147 =item In Memory Databases
9148
9149 =back
9150
9151 =item DB_HASH
9152
9153 =over 4
9154
9155 =item A Simple Example
9156
9157 =back
9158
9159 =item DB_BTREE
9160
9161 =over 4
9162
9163 =item Changing the BTREE sort order
9164
9165 =item Handling Duplicate Keys
9166
9167 =item The get_dup() Method
9168
9169 =item The find_dup() Method
9170
9171 =item The del_dup() Method
9172
9173 =item Matching Partial Keys
9174
9175 =back
9176
9177 =item DB_RECNO
9178
9179 =over 4
9180
9181 =item The 'bval' Option
9182
9183 =item A Simple Example
9184
9185 =item Extra RECNO Methods
9186
9187 B<$X-E<gt>push(list) ;>, B<$value = $X-E<gt>pop ;>, B<$X-E<gt>shift>,
9188 B<$X-E<gt>unshift(list) ;>, B<$X-E<gt>length>, B<$X-E<gt>splice(offset,
9189 length, elements);>
9190
9191 =item Another Example
9192
9193 =back
9194
9195 =item THE API INTERFACE
9196
9197 B<$status = $X-E<gt>get($key, $value [, $flags]) ;>, B<$status =
9198 $X-E<gt>put($key, $value [, $flags]) ;>, B<$status = $X-E<gt>del($key [,
9199 $flags]) ;>, B<$status = $X-E<gt>fd ;>, B<$status = $X-E<gt>seq($key,
9200 $value, $flags) ;>, B<$status = $X-E<gt>sync([$flags]) ;>
9201
9202 =item DBM FILTERS
9203
9204 B<filter_store_key>, B<filter_store_value>, B<filter_fetch_key>,
9205 B<filter_fetch_value>
9206
9207 =over 4
9208
9209 =item The Filter
9210
9211 =item An Example -- the NULL termination problem.
9212
9213 =item Another Example -- Key is a C int.
9214
9215 =back
9216
9217 =item HINTS AND TIPS
9218
9219 =over 4
9220
9221 =item Locking: The Trouble with fd
9222
9223 =item Safe ways to lock a database
9224
9225 B<Tie::DB_Lock>, B<Tie::DB_LockFile>, B<DB_File::Lock>
9226
9227 =item Sharing Databases With C Applications
9228
9229 =item The untie() Gotcha
9230
9231 =back
9232
9233 =item COMMON QUESTIONS
9234
9235 =over 4
9236
9237 =item Why is there Perl source in my database?
9238
9239 =item How do I store complex data structures with DB_File?
9240
9241 =item What does "Invalid Argument" mean?
9242
9243 =item What does "Bareword 'DB_File' not allowed" mean?
9244
9245 =back
9246
9247 =item REFERENCES
9248
9249 =item HISTORY
9250
9251 =item BUGS
9252
9253 =item AVAILABILITY
9254
9255 =item COPYRIGHT
9256
9257 =item SEE ALSO
9258
9259 =item AUTHOR
9260
9261 =back
9262
9263 =head2 Data::Dumper - stringified perl data structures, suitable for both
9264 printing and C<eval>
9265
9266 =over 4
9267
9268 =item SYNOPSIS
9269
9270 =item DESCRIPTION
9271
9272 =over 4
9273
9274 =item Methods
9275
9276 I<PACKAGE>->new(I<ARRAYREF [>, I<ARRAYREF]>), I<$OBJ>->Dump  I<or>
9277 I<PACKAGE>->Dump(I<ARRAYREF [>, I<ARRAYREF]>), I<$OBJ>->Seen(I<[HASHREF]>),
9278 I<$OBJ>->Values(I<[ARRAYREF]>), I<$OBJ>->Names(I<[ARRAYREF]>),
9279 I<$OBJ>->Reset
9280
9281 =item Functions
9282
9283 Dumper(I<LIST>)
9284
9285 =item Configuration Variables or Methods
9286
9287 $Data::Dumper::Indent  I<or>  I<$OBJ>->Indent(I<[NEWVAL]>),
9288 $Data::Dumper::Purity  I<or>  I<$OBJ>->Purity(I<[NEWVAL]>),
9289 $Data::Dumper::Pad  I<or>  I<$OBJ>->Pad(I<[NEWVAL]>),
9290 $Data::Dumper::Varname  I<or>  I<$OBJ>->Varname(I<[NEWVAL]>),
9291 $Data::Dumper::Useqq  I<or>  I<$OBJ>->Useqq(I<[NEWVAL]>),
9292 $Data::Dumper::Terse  I<or>  I<$OBJ>->Terse(I<[NEWVAL]>),
9293 $Data::Dumper::Freezer  I<or>  $I<OBJ>->Freezer(I<[NEWVAL]>),
9294 $Data::Dumper::Toaster  I<or>  $I<OBJ>->Toaster(I<[NEWVAL]>),
9295 $Data::Dumper::Deepcopy  I<or>  $I<OBJ>->Deepcopy(I<[NEWVAL]>),
9296 $Data::Dumper::Quotekeys  I<or>  $I<OBJ>->Quotekeys(I<[NEWVAL]>),
9297 $Data::Dumper::Bless  I<or>  $I<OBJ>->Bless(I<[NEWVAL]>),
9298 $Data::Dumper::Maxdepth  I<or>  $I<OBJ>->Maxdepth(I<[NEWVAL]>)
9299
9300 =item Exports
9301
9302 Dumper
9303
9304 =back
9305
9306 =item EXAMPLES
9307
9308 =item BUGS
9309
9310 =item AUTHOR
9311
9312 =item VERSION
9313
9314 =item SEE ALSO
9315
9316 =back
9317
9318 =head2 Devel::DProf - a Perl code profiler
9319
9320 =over 4
9321
9322 =item SYNOPSIS
9323
9324 =item DESCRIPTION
9325
9326 =item PROFILE FORMAT
9327
9328 =item AUTOLOAD
9329
9330 =item ENVIRONMENT
9331
9332 =item BUGS
9333
9334 =item SEE ALSO
9335
9336 =back
9337
9338 =head2 Devel::Peek - A data debugging tool for the XS programmer
9339
9340 =over 4
9341
9342 =item SYNOPSIS
9343
9344 =item DESCRIPTION
9345
9346 =over 4
9347
9348 =item Memory footprint debugging
9349
9350 =back
9351
9352 =item EXAMPLES
9353
9354 =over 4
9355
9356 =item A simple scalar string
9357
9358 =item A simple scalar number
9359
9360 =item A simple scalar with an extra reference
9361
9362 =item A reference to a simple scalar
9363
9364 =item A reference to an array
9365
9366 =item A reference to a hash
9367
9368 =item Dumping a large array or hash
9369
9370 =item A reference to an SV which holds a C pointer
9371
9372 =item A reference to a subroutine
9373
9374 =back
9375
9376 =item EXPORTS
9377
9378 =item BUGS
9379
9380 =item AUTHOR
9381
9382 =item SEE ALSO
9383
9384 =back
9385
9386 =head2 Devel::SelfStubber - generate stubs for a SelfLoading module
9387
9388 =over 4
9389
9390 =item SYNOPSIS
9391
9392 =item DESCRIPTION
9393
9394 =back
9395
9396 =head2 Digest:: - Modules that calculate message digests
9397
9398 =over 4
9399
9400 =item SYNOPSIS
9401
9402 =item DESCRIPTION
9403
9404 I<binary>, I<hex>, I<base64>
9405
9406 =item OO INTERFACE
9407
9408 $ctx = Digest->XXX($arg,...), $ctx = Digest->new(XXX => $arg,...), $ctx =
9409 Digest::XXX->new($arg,...), $ctx->reset, $ctx->add($data,...),
9410 $ctx->addfile($io_handle), $ctx->digest, $ctx->hexdigest, $ctx->b64digest
9411
9412 =item SEE ALSO
9413
9414 =item AUTHOR
9415
9416 =back
9417
9418 =head2 Digest::MD5 - Perl interface to the MD5 Algorithm
9419
9420 =over 4
9421
9422 =item SYNOPSIS
9423
9424 =item DESCRIPTION
9425
9426 =item FUNCTIONS
9427
9428 md5($data,...), md5_hex($data,...), md5_base64($data,...)
9429
9430 =item METHODS
9431
9432 $md5 = Digest::MD5->new, $md5->reset, $md5->add($data,...),
9433 $md5->addfile($io_handle), $md5->digest, $md5->hexdigest, $md5->b64digest
9434
9435 =item EXAMPLES
9436
9437 =item SEE ALSO
9438
9439 =item COPYRIGHT
9440
9441 =item AUTHORS
9442
9443 =back
9444
9445 =head2 DirHandle - supply object methods for directory handles
9446
9447 =over 4
9448
9449 =item SYNOPSIS
9450
9451 =item DESCRIPTION
9452
9453 =item NOTES
9454
9455 =back
9456
9457 =head2 Dumpvalue - provides screen dump of Perl data.
9458
9459 =over 4
9460
9461 =item SYNOPSIS
9462
9463 =item DESCRIPTION
9464
9465 =over 4
9466
9467 =item Creation
9468
9469 C<arrayDepth>, C<hashDepth>, C<compactDump>, C<veryCompact>, C<globPrint>,
9470 C<DumpDBFiles>, C<DumpPackages>, C<DumpReused>, C<tick>, C<HighBit>,
9471 C<printUndef>, C<UsageOnly>, unctrl, subdump, bareStringify, quoteHighBit,
9472 stopDbSignal
9473
9474 =item Methods
9475
9476 dumpValue, dumpValues, dumpvars, set_quote, set_unctrl, compactDump,
9477 veryCompact, set, get
9478
9479 =back
9480
9481 =back
9482
9483 =head2 DynaLoader - Dynamically load C libraries into Perl code
9484
9485 =over 4
9486
9487 =item SYNOPSIS
9488
9489 =item DESCRIPTION
9490
9491 @dl_library_path, @dl_resolve_using, @dl_require_symbols, @dl_librefs,
9492 @dl_modules, dl_error(), $dl_debug, dl_findfile(), dl_expandspec(),
9493 dl_load_file(), dl_unload_file(), dl_loadflags(), dl_find_symbol(),
9494 dl_find_symbol_anywhere(), dl_undef_symbols(), dl_install_xsub(),
9495 bootstrap()
9496
9497 =item AUTHOR
9498
9499 =back
9500
9501 =head2 DynaLoader::XSLoader, XSLoader - Dynamically load C libraries into
9502 Perl code
9503
9504 =over 4
9505
9506 =item SYNOPSIS
9507
9508 =item DESCRIPTION
9509
9510 =item AUTHOR
9511
9512 =back
9513
9514 =head2 Encode - character encodings
9515
9516 =over 4
9517
9518 =item SYNOPSIS
9519
9520 =item DESCRIPTION
9521
9522 =over 4
9523
9524 =item TERMINOLOGY
9525
9526 =back
9527
9528 =item ENCODINGS
9529
9530 =over 4
9531
9532 =item Characteristics of an Encoding
9533
9534 =item Types of Encodings
9535
9536 Fixed length 8-bit (or less) encodings, Fixed length 16-bit encodings,
9537 Fixed length 32-bit encodings, Multi-byte encodings, "Escape" encodings
9538
9539 =item Specifying Encodings
9540
9541 1. By name, 2. As an object
9542
9543 =item Encoding Names
9544
9545 The MIME name as defined in IETF RFC-XXXX, The name in the IANA registry,
9546 The name used by the the organization that defined it
9547
9548 =back
9549
9550 =item PERL ENCODING API
9551
9552 =over 4
9553
9554 =item Generic Encoding Interface
9555
9556 =item Handling Malformed Data
9557
9558 Scheme 1, Scheme 2, Other Schemes
9559
9560 =item UTF-8 / utf8
9561
9562 =item Other Encodings of Unicode
9563
9564 =item Listing available encodings
9565
9566 =item Defining Aliases
9567
9568 As a simple string, As a qr// compiled regular expression, e.g.:, As a code
9569 reference, e.g.:
9570
9571 =item Defining Encodings
9572
9573 =back
9574
9575 =item Encoding and IO
9576
9577 =item Encoding How to ...
9578
9579 IO with mixed content (faking iso-2020-*), MIME's Content-Length:, UTF-8
9580 strings in binary data, Perl/Encode wrappers on non-Unicode XS modules
9581
9582 =item Messing with Perl's Internals
9583
9584 is_utf8(STRING [, CHECK]), valid_utf8(STRING)
9585
9586 =item IMPLEMENTATION CLASSES
9587
9588 -E<gt>name, -E<gt>new_sequence, -E<gt>encode($string,$check),
9589 -E<gt>decode($octets,$check)
9590
9591 =over 4
9592
9593 =item Compiled Encodings
9594
9595 .enc, .ucm, .ucm, .c, .xs, ascii and iso-8859-*, IBM-1047 and two other
9596 variants of EBCDIC, symbol and dingbats as used by Tk on X11
9597
9598 =back
9599
9600 =item SEE ALSO
9601
9602 =back
9603
9604 =head2 Encode::EncodeFormat, EncodeFormat - the format of encoding tables
9605 of the Encode extension
9606
9607 =over 4
9608
9609 =item DESCRIPTION
9610
9611 [1]   B<S>, [2]   B<D>, [3]   B<M>, [4]   B<E>
9612
9613 =item KEYWORDS
9614
9615 =item COPYRIGHT
9616
9617 =back
9618
9619 =head2 Encode::Tcl - Tcl encodings
9620
9621 =head2 EncodeFormat - the format of encoding tables of the Encode extension
9622
9623 =over 4
9624
9625 =item DESCRIPTION
9626
9627 [1]   B<S>, [2]   B<D>, [3]   B<M>, [4]   B<E>
9628
9629 =item KEYWORDS
9630
9631 =item COPYRIGHT
9632
9633 =back
9634
9635 =head2 English - use nice English (or awk) names for ugly punctuation
9636 variables
9637
9638 =over 4
9639
9640 =item SYNOPSIS
9641
9642 =item DESCRIPTION
9643
9644 =item PERFORMANCE
9645
9646 =back
9647
9648 =head2 Env - perl module that imports environment variables as scalars or
9649 arrays
9650
9651 =over 4
9652
9653 =item SYNOPSIS
9654
9655 =item DESCRIPTION
9656
9657 =item LIMITATIONS
9658
9659 =item AUTHOR
9660
9661 =back
9662
9663 =head2 Errno - System errno constants
9664
9665 =over 4
9666
9667 =item SYNOPSIS
9668
9669 =item DESCRIPTION
9670
9671 =item CAVEATS
9672
9673 =item AUTHOR
9674
9675 =item COPYRIGHT
9676
9677 =back
9678
9679 =head2 Exporter - Implements default import method for modules
9680
9681 =over 4
9682
9683 =item SYNOPSIS
9684
9685 =item DESCRIPTION
9686
9687 =over 4
9688
9689 =item How to Export
9690
9691 =item Selecting What To Export
9692
9693 =item Specialised Import Lists
9694
9695 =item Exporting without using Export's import method
9696
9697 =item Module Version Checking
9698
9699 =item Managing Unknown Symbols
9700
9701 =item Tag Handling Utility Functions
9702
9703 =back
9704
9705 =back
9706
9707 =head2 Exporter::Heavy - Exporter guts
9708
9709 =over 4
9710
9711 =item SYNOPIS
9712
9713 =item DESCRIPTION
9714
9715 =back
9716
9717 =head2 ExtUtils::Command - utilities to replace common UNIX commands in
9718 Makefiles etc.
9719
9720 =over 4
9721
9722 =item SYNOPSIS
9723
9724 =item DESCRIPTION
9725
9726 =back
9727
9728 cat
9729
9730 eqtime src dst
9731
9732 rm_rf files...
9733
9734 rm_f files...
9735
9736 touch files ..
9737
9738 mv source... destination
9739
9740 cp source... destination
9741
9742 chmod mode files..
9743
9744 mkpath directory..
9745
9746 test_f file
9747
9748 =over 4
9749
9750 =item BUGS
9751
9752 =item SEE ALSO
9753
9754 =item AUTHOR
9755
9756 =back
9757
9758 =head2 ExtUtils::Constant - generate XS code to import C header constants
9759
9760 =over 4
9761
9762 =item SYNOPSIS
9763
9764 =item DESCRIPTION
9765
9766 =item USAGE
9767
9768 IV, UV, NV, PV, PVN, PVN, YES, NO, UNDEF
9769
9770 =item FUNCTIONS
9771
9772 =back
9773
9774 C_stringify NAME
9775
9776 constant_types
9777
9778 memEQ_clause NAME, CHECKED_AT, INDENT
9779
9780 assign INDENT, TYPE, PRE, POST, VALUE..
9781
9782 return_clause
9783
9784 switch_clause INDENT, NAMELEN, ITEMHASH, ITEM..
9785
9786 params WHAT
9787
9788 dump_names
9789
9790 C_constant, name, type, value, macro, default, pre, post, def_pre =item
9791 def_post
9792
9793 XS_constant PACKAGE, TYPES, SUBNAME, C_SUBNAME
9794
9795 autoload PACKAGE, VERSION, AUTOLOADER
9796
9797 WriteConstants ATTRIBUTE =E<gt> VALUE [, ...], NAME, DEFAULT_TYPE,
9798 BREAKOUT_AT, NAMES, C_FILE, XS_FILE, SUBNAME, C_SUBNAME
9799
9800 =over 4
9801
9802 =item AUTHOR
9803
9804 =back
9805
9806 =head2 ExtUtils::Embed - Utilities for embedding Perl in C/C++ applications
9807
9808 =over 4
9809
9810 =item SYNOPSIS
9811
9812 =item DESCRIPTION
9813
9814 =item @EXPORT
9815
9816 =item FUNCTIONS
9817
9818 xsinit(), Examples, ldopts(), Examples, perl_inc(), ccflags(), ccdlflags(),
9819 ccopts(), xsi_header(), xsi_protos(@modules), xsi_body(@modules)
9820
9821 =item EXAMPLES
9822
9823 =item SEE ALSO
9824
9825 =item AUTHOR
9826
9827 =back
9828
9829 =head2 ExtUtils::Install - install files from here to there
9830
9831 =over 4
9832
9833 =item SYNOPSIS
9834
9835 =item DESCRIPTION
9836
9837 =back
9838
9839 =head2 ExtUtils::Installed - Inventory management of installed modules
9840
9841 =over 4
9842
9843 =item SYNOPSIS
9844
9845 =item DESCRIPTION
9846
9847 =item USAGE
9848
9849 =item FUNCTIONS
9850
9851 new(), modules(), files(), directories(), directory_tree(), validate(),
9852 packlist(), version()
9853
9854 =item EXAMPLE
9855
9856 =item AUTHOR
9857
9858 =back
9859
9860 =head2 ExtUtils::Liblist - determine libraries to use and how to use them
9861
9862 =over 4
9863
9864 =item SYNOPSIS
9865
9866 =item DESCRIPTION
9867
9868 For static extensions, For dynamic extensions, For dynamic extensions
9869
9870 =over 4
9871
9872 =item EXTRALIBS
9873
9874 =item LDLOADLIBS and LD_RUN_PATH
9875
9876 =item BSLOADLIBS
9877
9878 =back
9879
9880 =item PORTABILITY
9881
9882 =over 4
9883
9884 =item VMS implementation
9885
9886 =item Win32 implementation
9887
9888 =back
9889
9890 =item SEE ALSO
9891
9892 =back
9893
9894 =head2 ExtUtils::MM_Cygwin - methods to override UN*X behaviour in
9895 ExtUtils::MakeMaker
9896
9897 =over 4
9898
9899 =item SYNOPSIS
9900
9901 =item DESCRIPTION
9902
9903 canonpath, cflags, manifypods, perl_archive
9904
9905 =back
9906
9907 =head2 ExtUtils::MM_NW5 - methods to override UN*X behaviour in
9908 ExtUtils::MakeMaker
9909
9910 =over 4
9911
9912 =item SYNOPSIS
9913
9914 =item DESCRIPTION
9915
9916 =back
9917
9918 catfile
9919
9920 constants (o)
9921
9922 static_lib (o)
9923
9924 dynamic_bs (o)
9925
9926 dynamic_lib (o)
9927
9928 canonpath
9929
9930 perl_script
9931
9932 pm_to_blib
9933
9934 test_via_harness (o)
9935
9936 tool_autosplit (override)
9937
9938 tools_other (o)
9939
9940 xs_o (o)
9941
9942 top_targets (o)
9943
9944 htmlifypods (o)
9945
9946 manifypods (o)
9947
9948 dist_ci (o)
9949
9950 dist_core (o)
9951
9952 pasthru (o)
9953
9954 =head2 ExtUtils::MM_OS2 - methods to override UN*X behaviour in
9955 ExtUtils::MakeMaker
9956
9957 =over 4
9958
9959 =item SYNOPSIS
9960
9961 =item DESCRIPTION
9962
9963 =item METHODS
9964
9965 =back
9966
9967 perl_archive_after
9968
9969 =head2 ExtUtils::MM_Unix - methods used by ExtUtils::MakeMaker
9970
9971 =over 4
9972
9973 =item SYNOPSIS
9974
9975 =item DESCRIPTION
9976
9977 =item METHODS
9978
9979 =over 4
9980
9981 =item Preloaded methods
9982
9983 canonpath
9984
9985 =back
9986
9987 =back
9988
9989 catdir
9990
9991 catfile
9992
9993 curdir
9994
9995 rootdir
9996
9997 updir
9998
9999 =over 4
10000
10001 =item SelfLoaded methods
10002
10003 c_o (o)
10004
10005 =back
10006
10007 cflags (o)
10008
10009 clean (o)
10010
10011 const_cccmd (o)
10012
10013 const_config (o)
10014
10015 const_loadlibs (o)
10016
10017 constants (o)
10018
10019 depend (o)
10020
10021 dir_target (o)
10022
10023 dist (o)
10024
10025 dist_basics (o)
10026
10027 dist_ci (o)
10028
10029 dist_core (o)
10030
10031 dist_dir (o)
10032
10033 dist_test (o)
10034
10035 dlsyms (o)
10036
10037 dynamic (o)
10038
10039 dynamic_bs (o)
10040
10041 dynamic_lib (o)
10042
10043 exescan
10044
10045 extliblist
10046
10047 file_name_is_absolute
10048
10049 find_perl
10050
10051 =over 4
10052
10053 =item Methods to actually produce chunks of text for the Makefile
10054
10055 fixin
10056
10057 =back
10058
10059 force (o)
10060
10061 guess_name
10062
10063 has_link_code
10064
10065 htmlifypods (o)
10066
10067 init_dirscan
10068
10069 init_main
10070
10071 init_others
10072
10073 install (o)
10074
10075 installbin (o)
10076
10077 libscan (o)
10078
10079 linkext (o)
10080
10081 lsdir
10082
10083 macro (o)
10084
10085 makeaperl (o)
10086
10087 makefile (o)
10088
10089 manifypods (o)
10090
10091 maybe_command
10092
10093 maybe_command_in_dirs
10094
10095 needs_linking (o)
10096
10097 nicetext
10098
10099 parse_version
10100
10101 parse_abstract
10102
10103 pasthru (o)
10104
10105 path
10106
10107 perl_script
10108
10109 perldepend (o)
10110
10111 ppd
10112
10113 perm_rw (o)
10114
10115 perm_rwx (o)
10116
10117 pm_to_blib
10118
10119 post_constants (o)
10120
10121 post_initialize (o)
10122
10123 postamble (o)
10124
10125 prefixify
10126
10127 processPL (o)
10128
10129 realclean (o)
10130
10131 replace_manpage_separator
10132
10133 static (o)
10134
10135 static_lib (o)
10136
10137 staticmake (o)
10138
10139 subdir_x (o)
10140
10141 subdirs (o)
10142
10143 test (o)
10144
10145 test_via_harness (o)
10146
10147 test_via_script (o)
10148
10149 tool_autosplit (o)
10150
10151 tools_other (o)
10152
10153 tool_xsubpp (o)
10154
10155 top_targets (o)
10156
10157 writedoc
10158
10159 xs_c (o)
10160
10161 xs_cpp (o)
10162
10163 xs_o (o)
10164
10165 perl_archive
10166
10167 perl_archive_after
10168
10169 export_list
10170
10171 =over 4
10172
10173 =item SEE ALSO
10174
10175 =back
10176
10177 =head2 ExtUtils::MM_VMS - methods to override UN*X behaviour in
10178 ExtUtils::MakeMaker
10179
10180 =over 4
10181
10182 =item SYNOPSIS
10183
10184 =item DESCRIPTION
10185
10186 =over 4
10187
10188 =item Methods always loaded
10189
10190 wraplist
10191
10192 =back
10193
10194 =back
10195
10196 rootdir (override)
10197
10198 =over 4
10199
10200 =item SelfLoaded methods
10201
10202 guess_name (override)
10203
10204 =back
10205
10206 find_perl (override)
10207
10208 path (override)
10209
10210 maybe_command (override)
10211
10212 maybe_command_in_dirs (override)
10213
10214 perl_script (override)
10215
10216 file_name_is_absolute (override)
10217
10218 replace_manpage_separator
10219
10220 init_others (override)
10221
10222 constants (override)
10223
10224 cflags (override)
10225
10226 const_cccmd (override)
10227
10228 pm_to_blib (override)
10229
10230 tool_autosplit (override)
10231
10232 tool_sxubpp (override)
10233
10234 xsubpp_version (override)
10235
10236 tools_other (override)
10237
10238 dist (override)
10239
10240 c_o (override)
10241
10242 xs_c (override)
10243
10244 xs_o (override)
10245
10246 top_targets (override)
10247
10248 dlsyms (override)
10249
10250 dynamic_lib (override)
10251
10252 dynamic_bs (override)
10253
10254 static_lib (override)
10255
10256 manifypods (override)
10257
10258 processPL (override)
10259
10260 installbin (override)
10261
10262 subdir_x (override)
10263
10264 clean (override)
10265
10266 realclean (override)
10267
10268 dist_basics (override)
10269
10270 dist_core (override)
10271
10272 dist_dir (override)
10273
10274 dist_test (override)
10275
10276 install (override)
10277
10278 perldepend (override)
10279
10280 makefile (override)
10281
10282 test (override)
10283
10284 test_via_harness (override)
10285
10286 test_via_script (override)
10287
10288 makeaperl (override)
10289
10290 nicetext (override)
10291
10292 =head2 ExtUtils::MM_Win32 - methods to override UN*X behaviour in
10293 ExtUtils::MakeMaker
10294
10295 =over 4
10296
10297 =item SYNOPSIS
10298
10299 =item DESCRIPTION
10300
10301 =back
10302
10303 catfile
10304
10305 constants (o)
10306
10307 static_lib (o)
10308
10309 dynamic_bs (o)
10310
10311 dynamic_lib (o)
10312
10313 canonpath
10314
10315 perl_script
10316
10317 pm_to_blib
10318
10319 test_via_harness (o)
10320
10321 tool_autosplit (override)
10322
10323 tools_other (o)
10324
10325 xs_o (o)
10326
10327 top_targets (o)
10328
10329 htmlifypods (o)
10330
10331 manifypods (o)
10332
10333 dist_ci (o)
10334
10335 dist_core (o)
10336
10337 pasthru (o)
10338
10339 =head2 ExtUtils::MakeMaker - create an extension Makefile
10340
10341 =over 4
10342
10343 =item SYNOPSIS
10344
10345 =item DESCRIPTION
10346
10347 =over 4
10348
10349 =item How To Write A Makefile.PL
10350
10351 =item Default Makefile Behaviour
10352
10353 =item make test
10354
10355 =item make testdb
10356
10357 =item make install
10358
10359 =item PREFIX and LIB attribute
10360
10361 =item AFS users
10362
10363 =item Static Linking of a new Perl Binary
10364
10365 =item Determination of Perl Library and Installation Locations
10366
10367 =item Which architecture dependent directory?
10368
10369 =item Using Attributes and Parameters
10370
10371 ABSTRACT, ABSTRACT_FROM, AUTHOR, BINARY_LOCATION, C, CCFLAGS, CONFIG,
10372 CONFIGURE, DEFINE, DIR, DISTNAME, DL_FUNCS, DL_VARS, EXCLUDE_EXT,
10373 EXE_FILES, FIRST_MAKEFILE, FULLPERL, FUNCLIST, H, HTMLLIBPODS,
10374 HTMLSCRIPTPODS, IMPORTS, INC, INCLUDE_EXT, INSTALLARCHLIB, INSTALLBIN,
10375 INSTALLDIRS, INSTALLHTMLPRIVLIBDIR, INSTALLHTMLSCRIPTDIR,
10376 INSTALLHTMLSITELIBDIR, INSTALLMAN1DIR, INSTALLMAN3DIR, INSTALLPRIVLIB,
10377 INSTALLSCRIPT, INSTALLSITEARCH, INSTALLSITELIB, INST_ARCHLIB, INST_BIN,
10378 INST_EXE, INST_HTMLLIBDIR, INST_HTMLSCRIPTDIR, INST_LIB, INST_MAN1DIR,
10379 INST_MAN3DIR, INST_SCRIPT, LDFROM, LIB, LIBPERL_A, LIBS, LINKTYPE,
10380 MAKEAPERL, MAKEFILE, MAN1PODS, MAN3PODS, MAP_TARGET, MYEXTLIB, NAME,
10381 NEEDS_LINKING, NOECHO, NORECURS, NO_VC, OBJECT, OPTIMIZE, PERL, PERL_CORE,
10382 PERLMAINCC, PERL_ARCHLIB, PERL_LIB, PERL_MALLOC_OK, PERLRUN, PERM_RW,
10383 PERM_RWX, PL_FILES, PM, PMLIBDIRS, PM_FILTER, POLLUTE, PPM_INSTALL_EXEC,
10384 PPM_INSTALL_SCRIPT, PREFIX, PREREQ_PM, SKIP, TEST_LIBS, VERSION,
10385 VERSION_FROM, XS, XSOPT, XSPROTOARG, XS_VERSION
10386
10387 =item Additional lowercase attributes
10388
10389 clean, depend, dist, dynamic_lib, linkext, macro, realclean, test,
10390 tool_autosplit
10391
10392 =item Overriding MakeMaker Methods
10393
10394 =item Hintsfile support
10395
10396 =item Distribution Support
10397
10398    make distcheck,    make skipcheck,    make distclean,    make manifest,
10399   make distdir,    make tardist,    make dist,    make uutardist,    make
10400 shdist,    make zipdist,    make ci
10401
10402 =item Disabling an extension
10403
10404 =back
10405
10406 =item ENVIRONMENT
10407
10408 PERL_MM_OPT
10409
10410 =item SEE ALSO
10411
10412 =item AUTHORS
10413
10414 =back
10415
10416 =head2 ExtUtils::Manifest - utilities to write and check a MANIFEST file
10417
10418 =over 4
10419
10420 =item SYNOPSIS
10421
10422 =item DESCRIPTION
10423
10424 =item MANIFEST.SKIP
10425
10426 =item EXPORT_OK
10427
10428 =item GLOBAL VARIABLES
10429
10430 =item DIAGNOSTICS
10431
10432 C<Not in MANIFEST:> I<file>, C<No such file:> I<file>, C<MANIFEST:> I<$!>,
10433 C<Added to MANIFEST:> I<file>
10434
10435 =item ENVIRONMENT
10436
10437 B<PERL_MM_MANIFEST_DEBUG>
10438
10439 =item SEE ALSO
10440
10441 =item AUTHOR
10442
10443 =back
10444
10445 =head2 ExtUtils::Miniperl, writemain - write the C code for perlmain.c
10446
10447 =over 4
10448
10449 =item SYNOPSIS
10450
10451 =item DESCRIPTION
10452
10453 =item SEE ALSO
10454
10455 =back
10456
10457 =head2 ExtUtils::Mkbootstrap - make a bootstrap file for use by DynaLoader
10458
10459 =over 4
10460
10461 =item SYNOPSIS
10462
10463 =item DESCRIPTION
10464
10465 =back
10466
10467 =head2 ExtUtils::Mksymlists - write linker options files for dynamic
10468 extension
10469
10470 =over 4
10471
10472 =item SYNOPSIS
10473
10474 =item DESCRIPTION
10475
10476 DLBASE, DL_FUNCS, DL_VARS, FILE, FUNCLIST, IMPORTS, NAME
10477
10478 =item AUTHOR
10479
10480 =item REVISION
10481
10482 =back
10483
10484 =head2 ExtUtils::Packlist - manage .packlist files
10485
10486 =over 4
10487
10488 =item SYNOPSIS
10489
10490 =item DESCRIPTION
10491
10492 =item USAGE
10493
10494 =item FUNCTIONS
10495
10496 new(), read(), write(), validate(), packlist_file()
10497
10498 =item EXAMPLE
10499
10500 =item AUTHOR
10501
10502 =back
10503
10504 =head2 ExtUtils::testlib - add blib/* directories to @INC
10505
10506 =over 4
10507
10508 =item SYNOPSIS
10509
10510 =item DESCRIPTION
10511
10512 =back
10513
10514 =head2 Fatal - replace functions with equivalents which succeed or die
10515
10516 =over 4
10517
10518 =item SYNOPSIS
10519
10520 =item DESCRIPTION
10521
10522 =item AUTHOR
10523
10524 =back
10525
10526 =head2 Fcntl - load the C Fcntl.h defines
10527
10528 =over 4
10529
10530 =item SYNOPSIS
10531
10532 =item DESCRIPTION
10533
10534 =item NOTE
10535
10536 =item EXPORTED SYMBOLS
10537
10538 =back
10539
10540 =head2 File::Basename, fileparse - split a pathname into pieces
10541
10542 =over 4
10543
10544 =item SYNOPSIS
10545
10546 =item DESCRIPTION
10547
10548 fileparse_set_fstype, fileparse
10549
10550 =item EXAMPLES
10551
10552 C<basename>, C<dirname>
10553
10554 =back
10555
10556 =head2 File::CheckTree, validate - run many filetest checks on a tree
10557
10558 =over 4
10559
10560 =item SYNOPSIS
10561
10562 =item DESCRIPTION
10563
10564 =back
10565
10566 =head2 File::Compare - Compare files or filehandles
10567
10568 =over 4
10569
10570 =item SYNOPSIS
10571
10572 =item DESCRIPTION
10573
10574 =item RETURN
10575
10576 =item AUTHOR
10577
10578 =back
10579
10580 =head2 File::Copy - Copy files or filehandles
10581
10582 =over 4
10583
10584 =item SYNOPSIS
10585
10586 =item DESCRIPTION
10587
10588 =over 4
10589
10590 =item Special behaviour if C<syscopy> is defined (OS/2, VMS and Win32)
10591
10592 rmscopy($from,$to[,$date_flag])
10593
10594 =back
10595
10596 =item RETURN
10597
10598 =item NOTES
10599
10600 =item AUTHOR
10601
10602 =back
10603
10604 =head2 File::DosGlob - DOS like globbing and then some
10605
10606 =over 4
10607
10608 =item SYNOPSIS
10609
10610 =item DESCRIPTION
10611
10612 =item EXPORTS (by request only)
10613
10614 =item BUGS
10615
10616 =item AUTHOR
10617
10618 =item HISTORY
10619
10620 =item SEE ALSO
10621
10622 =back
10623
10624 =head2 File::Find, find - traverse a file tree
10625
10626 =over 4
10627
10628 =item SYNOPSIS
10629
10630 =item DESCRIPTION
10631
10632 C<wanted>, C<bydepth>, C<preprocess>, C<postprocess>, C<follow>,
10633 C<follow_fast>, C<follow_skip>, C<dangling_symlinks>, C<no_chdir>,
10634 C<untaint>, C<untaint_pattern>, C<untaint_skip>
10635
10636 =item CAVEAT
10637
10638 =item NOTES
10639
10640 =item HISTORY
10641
10642 =back
10643
10644 =head2 File::Glob - Perl extension for BSD glob routine
10645
10646 =over 4
10647
10648 =item SYNOPSIS
10649
10650 =item DESCRIPTION
10651
10652 C<GLOB_ERR>, C<GLOB_LIMIT>, C<GLOB_MARK>, C<GLOB_NOCASE>, C<GLOB_NOCHECK>,
10653 C<GLOB_NOSORT>, C<GLOB_BRACE>, C<GLOB_NOMAGIC>, C<GLOB_QUOTE>,
10654 C<GLOB_TILDE>, C<GLOB_CSH>, C<GLOB_ALPHASORT>
10655
10656 =item DIAGNOSTICS
10657
10658 C<GLOB_NOSPACE>, C<GLOB_ABEND>
10659
10660 =item NOTES
10661
10662 =item AUTHOR
10663
10664 =back
10665
10666 =head2 File::Path - create or remove directory trees
10667
10668 =over 4
10669
10670 =item SYNOPSIS
10671
10672 =item DESCRIPTION
10673
10674 =item AUTHORS
10675
10676 =back
10677
10678 =head2 File::Spec - portably perform operations on file names
10679
10680 =over 4
10681
10682 =item SYNOPSIS
10683
10684 =item DESCRIPTION
10685
10686 =item METHODS
10687
10688 canonpath, catdir, catfile, curdir, devnull, rootdir, tmpdir, updir,
10689 no_upwards, case_tolerant, file_name_is_absolute, path, join, splitpath,
10690 splitdir, catpath, abs2rel, rel2abs
10691
10692 =item SEE ALSO
10693
10694 =item AUTHORS
10695
10696 =back
10697
10698 =head2 File::Spec::Epoc - methods for Epoc file specs
10699
10700 =over 4
10701
10702 =item SYNOPSIS
10703
10704 =item DESCRIPTION
10705
10706 devnull
10707
10708 =back
10709
10710 tmpdir
10711
10712 path
10713
10714 canonpath
10715
10716 splitpath
10717
10718 splitdir
10719
10720 catpath
10721
10722 abs2rel
10723
10724 rel2abs
10725
10726 =over 4
10727
10728 =item SEE ALSO
10729
10730 =back
10731
10732 =head2 File::Spec::Functions - portably perform operations on file names
10733
10734 =over 4
10735
10736 =item SYNOPSIS
10737
10738 =item DESCRIPTION
10739
10740 =over 4
10741
10742 =item Exports
10743
10744 =back
10745
10746 =item SEE ALSO
10747
10748 =back
10749
10750 =head2 File::Spec::Mac - File::Spec for MacOS
10751
10752 =over 4
10753
10754 =item SYNOPSIS
10755
10756 =item DESCRIPTION
10757
10758 =item METHODS
10759
10760 canonpath
10761
10762 =back
10763
10764 catdir
10765
10766 catfile
10767
10768 curdir
10769
10770 devnull
10771
10772 rootdir
10773
10774 tmpdir
10775
10776 updir
10777
10778 file_name_is_absolute
10779
10780 path
10781
10782 splitpath
10783
10784 splitdir
10785
10786 catpath
10787
10788 abs2rel
10789
10790 rel2abs
10791
10792 =over 4
10793
10794 =item SEE ALSO
10795
10796 =back
10797
10798 =head2 File::Spec::OS2 - methods for OS/2 file specs
10799
10800 =over 4
10801
10802 =item SYNOPSIS
10803
10804 =item DESCRIPTION
10805
10806 =back
10807
10808 =head2 File::Spec::Unix - File::Spec for Unix, base for other File::Spec
10809 modules
10810
10811 =over 4
10812
10813 =item SYNOPSIS
10814
10815 =item DESCRIPTION
10816
10817 =item METHODS
10818
10819 canonpath
10820
10821 =back
10822
10823 catdir
10824
10825 catfile
10826
10827 curdir
10828
10829 devnull
10830
10831 rootdir
10832
10833 tmpdir
10834
10835 updir
10836
10837 no_upwards
10838
10839 case_tolerant
10840
10841 file_name_is_absolute
10842
10843 path
10844
10845 join
10846
10847 splitpath
10848
10849 splitdir
10850
10851 catpath
10852
10853 abs2rel
10854
10855 rel2abs
10856
10857 =over 4
10858
10859 =item SEE ALSO
10860
10861 =back
10862
10863 =head2 File::Spec::VMS - methods for VMS file specs
10864
10865 =over 4
10866
10867 =item SYNOPSIS
10868
10869 =item DESCRIPTION
10870
10871 eliminate_macros
10872
10873 =back
10874
10875 fixpath
10876
10877 =over 4
10878
10879 =item Methods always loaded
10880
10881 canonpath (override)
10882
10883 =back
10884
10885 catdir
10886
10887 catfile
10888
10889 curdir (override)
10890
10891 devnull (override)
10892
10893 rootdir (override)
10894
10895 tmpdir (override)
10896
10897 updir (override)
10898
10899 case_tolerant (override)
10900
10901 path (override)
10902
10903 file_name_is_absolute (override)
10904
10905 splitpath (override)
10906
10907 splitdir (override)
10908
10909 catpath (override)
10910
10911 abs2rel (override)
10912
10913 rel2abs (override)
10914
10915 =over 4
10916
10917 =item SEE ALSO
10918
10919 =back
10920
10921 =head2 File::Spec::Win32 - methods for Win32 file specs
10922
10923 =over 4
10924
10925 =item SYNOPSIS
10926
10927 =item DESCRIPTION
10928
10929 devnull
10930
10931 =back
10932
10933 tmpdir
10934
10935 catfile
10936
10937 canonpath
10938
10939 splitpath
10940
10941 splitdir
10942
10943 catpath
10944
10945 =over 4
10946
10947 =item SEE ALSO
10948
10949 =back
10950
10951 =head2 File::Temp - return name and handle of a temporary file safely
10952
10953 =over 4
10954
10955 =item PORTABILITY
10956
10957 =item SYNOPSIS
10958
10959 =item DESCRIPTION
10960
10961 =back
10962
10963 =over 4
10964
10965 =item FUNCTIONS
10966
10967 B<tempfile>
10968
10969 =back
10970
10971 B<tempdir>
10972
10973 =over 4
10974
10975 =item MKTEMP FUNCTIONS
10976
10977 B<mkstemp>
10978
10979 =back
10980
10981 B<mkstemps>
10982
10983 B<mkdtemp>
10984
10985 B<mktemp>
10986
10987 =over 4
10988
10989 =item POSIX FUNCTIONS
10990
10991 B<tmpnam>
10992
10993 =back
10994
10995 B<tmpfile>
10996
10997 =over 4
10998
10999 =item ADDITIONAL FUNCTIONS
11000
11001 B<tempnam>
11002
11003 =back
11004
11005 =over 4
11006
11007 =item UTILITY FUNCTIONS
11008
11009 B<unlink0>
11010
11011 =back
11012
11013 =over 4
11014
11015 =item PACKAGE VARIABLES
11016
11017 B<safe_level>, STANDARD, MEDIUM, HIGH
11018
11019 =back
11020
11021 TopSystemUID
11022
11023 =over 4
11024
11025 =item WARNING
11026
11027 =over 4
11028
11029 =item Temporary files and NFS
11030
11031 =back
11032
11033 =item HISTORY
11034
11035 =item SEE ALSO
11036
11037 =item AUTHOR
11038
11039 =back
11040
11041 =head2 File::stat - by-name interface to Perl's built-in stat() functions
11042
11043 =over 4
11044
11045 =item SYNOPSIS
11046
11047 =item DESCRIPTION
11048
11049 =item NOTE
11050
11051 =item AUTHOR
11052
11053 =back
11054
11055 =head2 FileCache - keep more files open than the system permits
11056
11057 =over 4
11058
11059 =item SYNOPSIS
11060
11061 =item DESCRIPTION
11062
11063 =item BUGS
11064
11065 =back
11066
11067 =head2 FileHandle - supply object methods for filehandles
11068
11069 =over 4
11070
11071 =item SYNOPSIS
11072
11073 =item DESCRIPTION
11074
11075 $fh->print, $fh->printf, $fh->getline, $fh->getlines
11076
11077 =item SEE ALSO
11078
11079 =back
11080
11081 =head2 Filter::Simple - Simplified source filtering
11082
11083 =over 4
11084
11085 =item SYNOPSIS
11086
11087 =item DESCRIPTION
11088
11089 =over 4
11090
11091 =item The Problem
11092
11093 =item A Solution
11094
11095 =item Disabling or changing <no> behaviour
11096
11097 =item All-in-one interface
11098
11099 =item Using Filter::Simple and Exporter together
11100
11101 =item How it works
11102
11103 =back
11104
11105 =item AUTHOR
11106
11107 =item COPYRIGHT
11108
11109 =back
11110
11111 =head2 Filter::Util::Call - Perl Source Filter Utility Module
11112
11113 =over 4
11114
11115 =item SYNOPSIS
11116
11117 =item DESCRIPTION
11118
11119 =over 4
11120
11121 =item B<use Filter::Util::Call>
11122
11123 =item B<import()>
11124
11125 =item B<filter() and anonymous sub>
11126
11127 B<$_>, B<$status>, B<filter_read> and B<filter_read_exact>, B<filter_del>
11128
11129 =back
11130
11131 =item EXAMPLES
11132
11133 =over 4
11134
11135 =item Example 1: A simple filter.
11136
11137 =item Example 2: Using the context
11138
11139 =item Example 3: Using the context within the filter
11140
11141 =item Example 4: Using filter_del
11142
11143 =back
11144
11145 =item Filter::Simple
11146
11147 =item AUTHOR
11148
11149 =item DATE
11150
11151 =back
11152
11153 =head2 FindBin - Locate directory of original perl script
11154
11155 =over 4
11156
11157 =item SYNOPSIS
11158
11159 =item DESCRIPTION
11160
11161 =item EXPORTABLE VARIABLES
11162
11163 =item KNOWN BUGS
11164
11165 =item AUTHORS
11166
11167 =item COPYRIGHT
11168
11169 =back
11170
11171 =head2 GDBM_File - Perl5 access to the gdbm library.
11172
11173 =over 4
11174
11175 =item SYNOPSIS
11176
11177 =item DESCRIPTION
11178
11179 =item AVAILABILITY
11180
11181 =item BUGS
11182
11183 =item SEE ALSO
11184
11185 =back
11186
11187 =head2 Getopt::Long - Extended processing of command line options
11188
11189 =over 4
11190
11191 =item SYNOPSIS
11192
11193 =item DESCRIPTION
11194
11195 =item Command Line Options, an Introduction
11196
11197 =item Getting Started with Getopt::Long
11198
11199 =over 4
11200
11201 =item Simple options
11202
11203 =item A little bit less simple options
11204
11205 =item Mixing command line option with other arguments
11206
11207 =item Options with values
11208
11209 =item Options with multiple values
11210
11211 =item Options with hash values
11212
11213 =item User-defined subroutines to handle options
11214
11215 =item Options with multiple names
11216
11217 =item Case and abbreviations
11218
11219 =item Summary of Option Specifications
11220
11221 !, +, s, i, o, f, : I<type> [ I<desttype> ]
11222
11223 =back
11224
11225 =item Advanced Possibilities
11226
11227 =over 4
11228
11229 =item Object oriented interface
11230
11231 =item Documentation and help texts
11232
11233 =item Storing options in a hash
11234
11235 =item Bundling
11236
11237 =item The lonesome dash
11238
11239 =item Argument call-back
11240
11241 =back
11242
11243 =item Configuring Getopt::Long
11244
11245 default, posix_default, auto_abbrev, getopt_compat, gnu_compat, gnu_getopt,
11246 require_order, permute, bundling (default: disabled), bundling_override
11247 (default: disabled), ignore_case  (default: enabled), ignore_case_always
11248 (default: disabled), pass_through (default: disabled), prefix,
11249 prefix_pattern, debug (default: disabled)
11250
11251 =item Return values and Errors
11252
11253 =item Legacy
11254
11255 =over 4
11256
11257 =item Default destinations
11258
11259 =item Alternative option starters
11260
11261 =item Configuration variables
11262
11263 =back
11264
11265 =item Trouble Shooting
11266
11267 =over 4
11268
11269 =item Warning: Ignoring '!' modifier for short option
11270
11271 =item GetOptions does not return a false result when an option is not
11272 supplied
11273
11274 =back
11275
11276 =item AUTHOR
11277
11278 =item COPYRIGHT AND DISCLAIMER
11279
11280 =back
11281
11282 =head2 Getopt::Std, getopt - Process single-character switches with switch
11283 clustering
11284
11285 =over 4
11286
11287 =item SYNOPSIS
11288
11289 =item DESCRIPTION
11290
11291 =back
11292
11293 =head2 I18N::Collate - compare 8-bit scalar data according to the current
11294 locale
11295
11296 =over 4
11297
11298 =item SYNOPSIS
11299
11300 =item DESCRIPTION
11301
11302 =back
11303
11304 =head2 I18N::LangTags - functions for dealing with RFC3066-style language
11305 tags
11306
11307 =over 4
11308
11309 =item SYNOPSIS
11310
11311 =item DESCRIPTION
11312
11313 =back
11314
11315 the function is_language_tag($lang1)
11316
11317 the function extract_language_tags($whatever)
11318
11319 the function same_language_tag($lang1, $lang2)
11320
11321 the function similarity_language_tag($lang1, $lang2)
11322
11323 the function is_dialect_of($lang1, $lang2)
11324
11325 the function super_languages($lang1)
11326
11327 the function locale2language_tag($locale_identifier)
11328
11329 the function encode_language_tag($lang1)
11330
11331 the function alternate_language_tags($lang1)
11332
11333 the function @langs = panic_languages(@accept_languages)
11334
11335 =over 4
11336
11337 =item ABOUT LOWERCASING
11338
11339 =item ABOUT UNICODE PLAINTEXT LANGUAGE TAGS
11340
11341 =item SEE ALSO
11342
11343 =item COPYRIGHT
11344
11345 =item AUTHOR
11346
11347 =back
11348
11349 =head2 I18N::LangTags::List -- tags and names for human languages
11350
11351 =over 4
11352
11353 =item SYNOPSIS
11354
11355 =item DESCRIPTION
11356
11357 =item ABOUT LANGUAGE TAGS
11358
11359 =item LIST OF LANGUAGES
11360
11361 {ab} : Abkhazian, {ace} : Achinese, {ach} : Acoli, {ada} : Adangme, {aa} :
11362 Afar, {afh} : Afrihili, {af} : Afrikaans, [{afa} : Afro-Asiatic (Other)],
11363 {aka} : Akan, {akk} : Akkadian, {sq} : Albanian, {ale} : Aleut, [{alg} :
11364 Algonquian languages], [{tut} : Altaic (Other)], {am} : Amharic, {i-ami} :
11365 Ami, [{apa} : Apache languages], {ar} : Arabic, {arc} : Aramaic, {arp} :
11366 Arapaho, {arn} : Araucanian, {arw} : Arawak, {hy} : Armenian, [{art} :
11367 Artificial (Other)], {as} : Assamese, [{ath} : Athapascan languages],
11368 [{aus} : Australian languages], [{map} : Austronesian (Other)], {ava} :
11369 Avaric, {ae} : Avestan, {awa} : Awadhi, {ay} : Aymara, {az} : Azerbaijani,
11370 {ban} : Balinese, [{bat} : Baltic (Other)], {bal} : Baluchi, {bam} :
11371 Bambara, [{bai} : Bamileke languages], {bad} : Banda, [{bnt} : Bantu
11372 (Other)], {bas} : Basa, {ba} : Bashkir, {eu} : Basque, {btk} : Batak
11373 (Indonesia), {bej} : Beja, {be} : Belarusian, {bem} : Bemba, {bn} :
11374 Bengali, [{ber} : Berber (Other)], {bho} : Bhojpuri, {bh} : Bihari, {bik} :
11375 Bikol, {bin} : Bini, {bi} : Bislama, {bs} : Bosnian, {bra} : Braj, {br} :
11376 Breton, {bug} : Buginese, {bg} : Bulgarian, {i-bnn} : Bunun, {bua} :
11377 Buriat, {my} : Burmese, {cad} : Caddo, {car} : Carib, {ca} : Catalan,
11378 [{cau} : Caucasian (Other)], {ceb} : Cebuano, [{cel} : Celtic (Other)],
11379 [{cai} : Central American Indian (Other)], {chg} : Chagatai, [{cmc} :
11380 Chamic languages], {ch} : Chamorro, {ce} : Chechen, {chr} : Cherokee, {chy}
11381 : Cheyenne, {chb} : Chibcha, {ny} : Chichewa, {zh} : Chinese, {chn} :
11382 Chinook Jargon, {chp} : Chipewyan, {cho} : Choctaw, {cu} : Church Slavic,
11383 {chk} : Chuukese, {cv} : Chuvash, {cop} : Coptic, {kw} : Cornish, {co} :
11384 Corsican, {cre} : Cree, {mus} : Creek, [{cpe} : English-based Creoles and
11385 pidgins (Other)], [{cpf} : French-based Creoles and pidgins (Other)],
11386 [{cpp} : Portuguese-based Creoles and pidgins (Other)], [{crp} : Creoles
11387 and pidgins (Other)], {hr} : Croatian, [{cus} : Cushitic (Other)], {cs} :
11388 Czech, {dak} : Dakota, {da} : Danish, {day} : Dayak, {i-default} : Default
11389 (Fallthru) Language, {del} : Delaware, {din} : Dinka, {div} : Divehi, {doi}
11390 : Dogri, {dgr} : Dogrib, [{dra} : Dravidian (Other)], {dua} : Duala, {nl} :
11391 Dutch, {dum} : Middle Dutch (ca.1050-1350), {dyu} : Dyula, {dz} : Dzongkha,
11392 {efi} : Efik, {egy} : Ancient Egyptian, {eka} : Ekajuk, {elx} : Elamite,
11393 {en} : English, {enm} : Old English (1100-1500), {ang} : Old English
11394 (ca.450-1100), {eo} : Esperanto, {et} : Estonian, {ewe} : Ewe, {ewo} :
11395 Ewondo, {fan} : Fang, {fat} : Fanti, {fo} : Faroese, {fj} : Fijian, {fi} :
11396 Finnish, [{fiu} : Finno-Ugrian (Other)], {fon} : Fon, {fr} : French, {frm}
11397 : Middle French (ca.1400-1600), {fro} : Old French (842-ca.1400), {fy} :
11398 Frisian, {fur} : Friulian, {ful} : Fulah, {gaa} : Ga, {gd} : Scots Gaelic,
11399 {gl} : Gallegan, {lug} : Ganda, {gay} : Gayo, {gba} : Gbaya, {gez} : Geez,
11400 {ka} : Georgian, {de} : German, {gmh} : Middle High German (ca.1050-1500),
11401 {goh} : Old High German (ca.750-1050), [{gem} : Germanic (Other)], {gil} :
11402 Gilbertese, {gon} : Gondi, {gor} : Gorontalo, {got} : Gothic, {grb} :
11403 Grebo, {grc} : Ancient Greek, {el} : Modern Greek, {gn} : Guarani, {gu} :
11404 Gujarati, {gwi} : Gwich'in, {hai} : Haida, {ha} : Hausa, {haw} : Hawaiian,
11405 {he} : Hebrew, {hz} : Herero, {hil} : Hiligaynon, {him} : Himachali, {hi} :
11406 Hindi, {ho} : Hiri Motu, {hit} : Hittite, {hmn} : Hmong, {hu} : Hungarian,
11407 {hup} : Hupa, {iba} : Iban, {is} : Icelandic, {ibo} : Igbo, {ijo} : Ijo,
11408 {ilo} : Iloko, [{inc} : Indic (Other)], [{ine} : Indo-European (Other)],
11409 {id} : Indonesian, {ia} : Interlingua (International Auxiliary Language
11410 Association), {ie} : Interlingue, {iu} : Inuktitut, {ik} : Inupiaq, [{ira}
11411 : Iranian (Other)], {ga} : Irish, {mga} : Middle Irish (900-1200), {sga} :
11412 Old Irish (to 900), [{iro} : Iroquoian languages], {it} : Italian, {ja} :
11413 Japanese, {jw} : Javanese, {jrb} : Judeo-Arabic, {jpr} : Judeo-Persian,
11414 {kab} : Kabyle, {kac} : Kachin, {kl} : Kalaallisut, {kam} : Kamba, {kn} :
11415 Kannada, {kau} : Kanuri, {kaa} : Kara-Kalpak, {kar} : Karen, {ks} :
11416 Kashmiri, {kaw} : Kawi, {kk} : Kazakh, {kha} : Khasi, {km} : Khmer, [{khi}
11417 : Khoisan (Other)], {kho} : Khotanese, {ki} : Kikuyu, {kmb} : Kimbundu,
11418 {rw} : Kinyarwanda, {ky} : Kirghiz, {i-klingon} : Klingon, {kv} : Komi,
11419 {kon} : Kongo, {kok} : Konkani, {ko} : Korean, {kos} : Kosraean, {kpe} :
11420 Kpelle, {kro} : Kru, {kj} : Kuanyama, {kum} : Kumyk, {ku} : Kurdish, {kru}
11421 : Kurukh, {kut} : Kutenai, {lad} : Ladino, {lah} : Lahnda, {lam} : Lamba,
11422 {lo} : Lao, {la} : Latin, {lv} : Latvian, {lb} : Letzeburgesch, {lez} :
11423 Lezghian, {ln} : Lingala, {lt} : Lithuanian, {nds} : Low German, {loz} :
11424 Lozi, {lub} : Luba-Katanga, {lua} : Luba-Lulua, {lui} : Luiseno, {lun} :
11425 Lunda, {luo} : Luo (Kenya and Tanzania), {lus} : Lushai, {mk} : Macedonian,
11426 {mad} : Madurese, {mag} : Magahi, {mai} : Maithili, {mak} : Makasar, {mg} :
11427 Malagasy, {ms} : Malay, {ml} : Malayalam, {mt} : Maltese, {mnc} : Manchu,
11428 {mdr} : Mandar, {man} : Mandingo, {mni} : Manipuri, [{mno} : Manobo
11429 languages], {gv} : Manx, {mi} : Maori, {mr} : Marathi, {chm} : Mari, {mh} :
11430 Marshall, {mwr} : Marwari, {mas} : Masai, [{myn} : Mayan languages], {men}
11431 : Mende, {mic} : Micmac, {min} : Minangkabau, {i-mingo} : Mingo, [{mis} :
11432 Miscellaneous languages], {moh} : Mohawk, {mo} : Moldavian, [{mkh} :
11433 Mon-Khmer (Other)], {lol} : Mongo, {mn} : Mongolian, {mos} : Mossi, [{mul}
11434 : Multiple languages], [{mun} : Munda languages], {nah} : Nahuatl, {na} :
11435 Nauru, {nv} : Navajo, {nd} : North Ndebele, {nr} : South Ndebele, {ng} :
11436 Ndonga, {ne} : Nepali, {new} : Newari, {nia} : Nias, [{nic} :
11437 Niger-Kordofanian (Other)], [{ssa} : Nilo-Saharan (Other)], {niu} : Niuean,
11438 {non} : Old Norse, [{nai} : North American Indian], {se} : Northern Sami,
11439 {no} : Norwegian, {nb} : Norwegian Bokmal, {nn} : Norwegian Nynorsk, [{nub}
11440 : Nubian languages], {nym} : Nyamwezi, {nyn} : Nyankole, {nyo} : Nyoro,
11441 {nzi} : Nzima, {oc} : Occitan (post 1500), {oji} : Ojibwa, {or} : Oriya,
11442 {om} : Oromo, {osa} : Osage, {os} : Ossetian; Ossetic, [{oto} : Otomian
11443 languages], {pal} : Pahlavi, {i-pwn} : Paiwan, {pau} : Palauan, {pi} :
11444 Pali, {pam} : Pampanga, {pag} : Pangasinan, {pa} : Panjabi, {pap} :
11445 Papiamento, [{paa} : Papuan (Other)], {fa} : Persian, {peo} : Old Persian
11446 (ca.600-400 B.C.), [{phi} : Philippine (Other)], {phn} : Phoenician, {pon}
11447 : Pohnpeian, {pl} : Polish, {pt} : Portuguese, [{pra} : Prakrit languages],
11448 {pro} : Old Provencal (to 1500), {ps} : Pushto, {qu} : Quechua, {rm} :
11449 Raeto-Romance, {raj} : Rajasthani, {rap} : Rapanui, {rar} : Rarotongan,
11450 [{qaa - qtz} : Reserved for local use.], [{roa} : Romance (Other)], {ro} :
11451 Romanian, {rom} : Romany, {rn} : Rundi, {ru} : Russian, [{sal} : Salishan
11452 languages], {sam} : Samaritan Aramaic, [{smi} : Sami languages (Other)],
11453 {sm} : Samoan, {sad} : Sandawe, {sg} : Sango, {sa} : Sanskrit, {sat} :
11454 Santali, {sc} : Sardinian, {sas} : Sasak, {sco} : Scots, {sel} : Selkup,
11455 [{sem} : Semitic (Other)], {sr} : Serbian, {srr} : Serer, {shn} : Shan,
11456 {sn} : Shona, {sid} : Sidamo, {sgn-...} : Sign Languages, {bla} : Siksika,
11457 {sd} : Sindhi, {si} : Sinhalese, [{sit} : Sino-Tibetan (Other)], [{sio} :
11458 Siouan languages], {den} : Slave (Athapascan), [{sla} : Slavic (Other)],
11459 {sk} : Slovak, {sl} : Slovenian, {sog} : Sogdian, {so} : Somali, {son} :
11460 Songhai, {snk} : Soninke, {wen} : Sorbian languages, {nso} : Northern
11461 Sotho, {st} : Southern Sotho, [{sai} : South American Indian (Other)], {es}
11462 : Spanish, {suk} : Sukuma, {sux} : Sumerian, {su} : Sundanese, {sus} :
11463 Susu, {sw} : Swahili, {ss} : Swati, {sv} : Swedish, {syr} : Syriac, {tl} :
11464 Tagalog, {ty} : Tahitian, [{tai} : Tai (Other)], {tg} : Tajik, {tmh} :
11465 Tamashek, {ta} : Tamil, {i-tao} : Tao, {tt} : Tatar, {i-tay} : Tayal, {te}
11466 : Telugu, {ter} : Tereno, {tet} : Tetum, {th} : Thai, {bo} : Tibetan, {tig}
11467 : Tigre, {ti} : Tigrinya, {tem} : Timne, {tiv} : Tiv, {tli} : Tlingit,
11468 {tpi} : Tok Pisin, {tkl} : Tokelau, {tog} : Tonga (Nyasa), {to} : Tonga
11469 (Tonga Islands), {tsi} : Tsimshian, {ts} : Tsonga, {i-tsu} : Tsou, {tn} :
11470 Tswana, {tum} : Tumbuka, {tr} : Turkish, {ota} : Ottoman Turkish
11471 (1500-1928), {tk} : Turkmen, {tvl} : Tuvalu, {tyv} : Tuvinian, {tw} : Twi,
11472 {uga} : Ugaritic, {ug} : Uighur, {uk} : Ukrainian, {umb} : Umbundu, {und} :
11473 Undetermined, {ur} : Urdu, {uz} : Uzbek, {vai} : Vai, {ven} : Venda, {vi} :
11474 Vietnamese, {vo} : Volapuk, {vot} : Votic, [{wak} : Wakashan languages],
11475 {wal} : Walamo, {war} : Waray, {was} : Washo, {cy} : Welsh, {wo} : Wolof,
11476 {x-...} : Unregistered (Semi-Private Use), {xh} : Xhosa, {sah} : Yakut,
11477 {yao} : Yao, {yap} : Yapese, {yi} : Yiddish, {yo} : Yoruba, [{ypk} : Yupik
11478 languages], {znd} : Zande, [{zap} : Zapotec], {zen} : Zenaga, {za} :
11479 Zhuang, {zu} : Zulu, {zun} : Zuni
11480
11481 =item SEE ALSO
11482
11483 =item COPYRIGHT AND DISCLAIMER
11484
11485 =item AUTHOR
11486
11487 =back
11488
11489 =head2 I18N::Langinfo - query locale information
11490
11491 =over 4
11492
11493 =item SYNOPSIS
11494
11495 =item DESCRIPTION
11496
11497 =over 4
11498
11499 =item EXPORT
11500
11501 =back
11502
11503 =item SEE ALSO
11504
11505 =item AUTHOR
11506
11507 =item COPYRIGHT AND LICENSE
11508
11509 =back
11510
11511 =head2 IO - load various IO modules
11512
11513 =over 4
11514
11515 =item SYNOPSIS
11516
11517 =item DESCRIPTION
11518
11519 =back
11520
11521 =head2 IO::Dir - supply object methods for directory handles
11522
11523 =over 4
11524
11525 =item SYNOPSIS
11526
11527 =item DESCRIPTION
11528
11529 new ( [ DIRNAME ] ), open ( DIRNAME ), read (), seek ( POS ), tell (),
11530 rewind (), close (), tie %hash, IO::Dir, DIRNAME [, OPTIONS ]
11531
11532 =item SEE ALSO
11533
11534 =item AUTHOR
11535
11536 =item COPYRIGHT
11537
11538 =back
11539
11540 =head2 IO::File - supply object methods for filehandles
11541
11542 =over 4
11543
11544 =item SYNOPSIS
11545
11546 =item DESCRIPTION
11547
11548 =item CONSTRUCTOR
11549
11550 new ( FILENAME [,MODE [,PERMS]] ), new_tmpfile
11551
11552 =item METHODS
11553
11554 open( FILENAME [,MODE [,PERMS]] )
11555
11556 =item SEE ALSO
11557
11558 =item HISTORY
11559
11560 =back
11561
11562 =head2 IO::Handle - supply object methods for I/O handles
11563
11564 =over 4
11565
11566 =item SYNOPSIS
11567
11568 =item DESCRIPTION
11569
11570 =item CONSTRUCTOR
11571
11572 new (), new_from_fd ( FD, MODE )
11573
11574 =item METHODS
11575
11576 $io->fdopen ( FD, MODE ), $io->opened, $io->getline, $io->getlines,
11577 $io->ungetc ( ORD ), $io->write ( BUF, LEN [, OFFSET ] ), $io->error,
11578 $io->clearerr, $io->sync, $io->flush, $io->printflush ( ARGS ),
11579 $io->blocking ( [ BOOL ] ), $io->untaint
11580
11581 =item NOTE
11582
11583 =item SEE ALSO
11584
11585 =item BUGS
11586
11587 =item HISTORY
11588
11589 =back
11590
11591 =head2 IO::Pipe - supply object methods for pipes
11592
11593 =over 4
11594
11595 =item SYNOPSIS
11596
11597 =item DESCRIPTION
11598
11599 =item CONSTRUCTOR
11600
11601 new ( [READER, WRITER] )
11602
11603 =item METHODS
11604
11605 reader ([ARGS]), writer ([ARGS]), handles ()
11606
11607 =item SEE ALSO
11608
11609 =item AUTHOR
11610
11611 =item COPYRIGHT
11612
11613 =back
11614
11615 =head2 IO::Poll - Object interface to system poll call
11616
11617 =over 4
11618
11619 =item SYNOPSIS
11620
11621 =item DESCRIPTION
11622
11623 =item METHODS
11624
11625 mask ( IO [, EVENT_MASK ] ), poll ( [ TIMEOUT ] ), events ( IO ), remove (
11626 IO ), handles( [ EVENT_MASK ] )
11627
11628 =item SEE ALSO
11629
11630 =item AUTHOR
11631
11632 =item COPYRIGHT
11633
11634 =back
11635
11636 =head2 IO::Seekable - supply seek based methods for I/O objects
11637
11638 =over 4
11639
11640 =item SYNOPSIS
11641
11642 =item DESCRIPTION
11643
11644 $io->getpos, $io->setpos, $io->seek ( POS, WHENCE ), WHENCE=0 (SEEK_SET),
11645 WHENCE=1 (SEEK_CUR), WHENCE=2 (SEEK_END), $io->sysseek( POS, WHENCE ),
11646 $io->tell
11647
11648 =item SEE ALSO
11649
11650 =item HISTORY
11651
11652 =back
11653
11654 =head2 IO::Select - OO interface to the select system call
11655
11656 =over 4
11657
11658 =item SYNOPSIS
11659
11660 =item DESCRIPTION
11661
11662 =item CONSTRUCTOR
11663
11664 new ( [ HANDLES ] )
11665
11666 =item METHODS
11667
11668 add ( HANDLES ), remove ( HANDLES ), exists ( HANDLE ), handles, can_read (
11669 [ TIMEOUT ] ), can_write ( [ TIMEOUT ] ), has_exception ( [ TIMEOUT ] ),
11670 count (), bits(), select ( READ, WRITE, ERROR [, TIMEOUT ] )
11671
11672 =item EXAMPLE
11673
11674 =item AUTHOR
11675
11676 =item COPYRIGHT
11677
11678 =back
11679
11680 =head2 IO::Socket - Object interface to socket communications
11681
11682 =over 4
11683
11684 =item SYNOPSIS
11685
11686 =item DESCRIPTION
11687
11688 =item CONSTRUCTOR
11689
11690 new ( [ARGS] )
11691
11692 =item METHODS
11693
11694 accept([PKG]), socketpair(DOMAIN, TYPE, PROTOCOL), atmark, connected,
11695 protocol, sockdomain, sockopt(OPT [, VAL]), socktype, timeout([VAL])
11696
11697 =item SEE ALSO
11698
11699 =item AUTHOR
11700
11701 =item COPYRIGHT
11702
11703 =back
11704
11705 =head2 IO::Socket::INET - Object interface for AF_INET domain sockets
11706
11707 =over 4
11708
11709 =item SYNOPSIS
11710
11711 =item DESCRIPTION
11712
11713 =item CONSTRUCTOR
11714
11715 new ( [ARGS] )
11716
11717 =over 4
11718
11719 =item METHODS
11720
11721 sockaddr (), sockport (), sockhost (), peeraddr (), peerport (), peerhost
11722 ()
11723
11724 =back
11725
11726 =item SEE ALSO
11727
11728 =item AUTHOR
11729
11730 =item COPYRIGHT
11731
11732 =back
11733
11734 =head2 IO::Socket::UNIX - Object interface for AF_UNIX domain sockets
11735
11736 =over 4
11737
11738 =item SYNOPSIS
11739
11740 =item DESCRIPTION
11741
11742 =item CONSTRUCTOR
11743
11744 new ( [ARGS] )
11745
11746 =item METHODS
11747
11748 hostpath(), peerpath()
11749
11750 =item SEE ALSO
11751
11752 =item AUTHOR
11753
11754 =item COPYRIGHT
11755
11756 =back
11757
11758 =head2 IO::lib::IO::Dir, IO::Dir - supply object methods for directory
11759 handles
11760
11761 =over 4
11762
11763 =item SYNOPSIS
11764
11765 =item DESCRIPTION
11766
11767 new ( [ DIRNAME ] ), open ( DIRNAME ), read (), seek ( POS ), tell (),
11768 rewind (), close (), tie %hash, IO::Dir, DIRNAME [, OPTIONS ]
11769
11770 =item SEE ALSO
11771
11772 =item AUTHOR
11773
11774 =item COPYRIGHT
11775
11776 =back
11777
11778 =head2 IO::lib::IO::File, IO::File - supply object methods for filehandles
11779
11780 =over 4
11781
11782 =item SYNOPSIS
11783
11784 =item DESCRIPTION
11785
11786 =item CONSTRUCTOR
11787
11788 new ( FILENAME [,MODE [,PERMS]] ), new_tmpfile
11789
11790 =item METHODS
11791
11792 open( FILENAME [,MODE [,PERMS]] )
11793
11794 =item SEE ALSO
11795
11796 =item HISTORY
11797
11798 =back
11799
11800 =head2 IO::lib::IO::Handle, IO::Handle - supply object methods for I/O
11801 handles
11802
11803 =over 4
11804
11805 =item SYNOPSIS
11806
11807 =item DESCRIPTION
11808
11809 =item CONSTRUCTOR
11810
11811 new (), new_from_fd ( FD, MODE )
11812
11813 =item METHODS
11814
11815 $io->fdopen ( FD, MODE ), $io->opened, $io->getline, $io->getlines,
11816 $io->ungetc ( ORD ), $io->write ( BUF, LEN [, OFFSET ] ), $io->error,
11817 $io->clearerr, $io->sync, $io->flush, $io->printflush ( ARGS ),
11818 $io->blocking ( [ BOOL ] ), $io->untaint
11819
11820 =item NOTE
11821
11822 =item SEE ALSO
11823
11824 =item BUGS
11825
11826 =item HISTORY
11827
11828 =back
11829
11830 =head2 IO::lib::IO::Pipe, IO::Pipe - supply object methods for pipes
11831
11832 =over 4
11833
11834 =item SYNOPSIS
11835
11836 =item DESCRIPTION
11837
11838 =item CONSTRUCTOR
11839
11840 new ( [READER, WRITER] )
11841
11842 =item METHODS
11843
11844 reader ([ARGS]), writer ([ARGS]), handles ()
11845
11846 =item SEE ALSO
11847
11848 =item AUTHOR
11849
11850 =item COPYRIGHT
11851
11852 =back
11853
11854 =head2 IO::lib::IO::Poll, IO::Poll - Object interface to system poll call
11855
11856 =over 4
11857
11858 =item SYNOPSIS
11859
11860 =item DESCRIPTION
11861
11862 =item METHODS
11863
11864 mask ( IO [, EVENT_MASK ] ), poll ( [ TIMEOUT ] ), events ( IO ), remove (
11865 IO ), handles( [ EVENT_MASK ] )
11866
11867 =item SEE ALSO
11868
11869 =item AUTHOR
11870
11871 =item COPYRIGHT
11872
11873 =back
11874
11875 =head2 IO::lib::IO::Seekable, IO::Seekable - supply seek based methods for
11876 I/O objects
11877
11878 =over 4
11879
11880 =item SYNOPSIS
11881
11882 =item DESCRIPTION
11883
11884 $io->getpos, $io->setpos, $io->seek ( POS, WHENCE ), WHENCE=0 (SEEK_SET),
11885 WHENCE=1 (SEEK_CUR), WHENCE=2 (SEEK_END), $io->sysseek( POS, WHENCE ),
11886 $io->tell
11887
11888 =item SEE ALSO
11889
11890 =item HISTORY
11891
11892 =back
11893
11894 =head2 IO::lib::IO::Select, IO::Select - OO interface to the select system
11895 call
11896
11897 =over 4
11898
11899 =item SYNOPSIS
11900
11901 =item DESCRIPTION
11902
11903 =item CONSTRUCTOR
11904
11905 new ( [ HANDLES ] )
11906
11907 =item METHODS
11908
11909 add ( HANDLES ), remove ( HANDLES ), exists ( HANDLE ), handles, can_read (
11910 [ TIMEOUT ] ), can_write ( [ TIMEOUT ] ), has_exception ( [ TIMEOUT ] ),
11911 count (), bits(), select ( READ, WRITE, ERROR [, TIMEOUT ] )
11912
11913 =item EXAMPLE
11914
11915 =item AUTHOR
11916
11917 =item COPYRIGHT
11918
11919 =back
11920
11921 =head2 IO::lib::IO::Socket, IO::Socket - Object interface to socket
11922 communications
11923
11924 =over 4
11925
11926 =item SYNOPSIS
11927
11928 =item DESCRIPTION
11929
11930 =item CONSTRUCTOR
11931
11932 new ( [ARGS] )
11933
11934 =item METHODS
11935
11936 accept([PKG]), socketpair(DOMAIN, TYPE, PROTOCOL), atmark, connected,
11937 protocol, sockdomain, sockopt(OPT [, VAL]), socktype, timeout([VAL])
11938
11939 =item SEE ALSO
11940
11941 =item AUTHOR
11942
11943 =item COPYRIGHT
11944
11945 =back
11946
11947 =head2 IO::lib::IO::Socket::INET, IO::Socket::INET - Object interface for
11948 AF_INET domain sockets
11949
11950 =over 4
11951
11952 =item SYNOPSIS
11953
11954 =item DESCRIPTION
11955
11956 =item CONSTRUCTOR
11957
11958 new ( [ARGS] )
11959
11960 =over 4
11961
11962 =item METHODS
11963
11964 sockaddr (), sockport (), sockhost (), peeraddr (), peerport (), peerhost
11965 ()
11966
11967 =back
11968
11969 =item SEE ALSO
11970
11971 =item AUTHOR
11972
11973 =item COPYRIGHT
11974
11975 =back
11976
11977 =head2 IO::lib::IO::Socket::UNIX, IO::Socket::UNIX - Object interface for
11978 AF_UNIX domain sockets
11979
11980 =over 4
11981
11982 =item SYNOPSIS
11983
11984 =item DESCRIPTION
11985
11986 =item CONSTRUCTOR
11987
11988 new ( [ARGS] )
11989
11990 =item METHODS
11991
11992 hostpath(), peerpath()
11993
11994 =item SEE ALSO
11995
11996 =item AUTHOR
11997
11998 =item COPYRIGHT
11999
12000 =back
12001
12002 =head2 IPC::Msg - SysV Msg IPC object class
12003
12004 =over 4
12005
12006 =item SYNOPSIS
12007
12008 =item DESCRIPTION
12009
12010 =item METHODS
12011
12012 new ( KEY , FLAGS ), id, rcv ( BUF, LEN [, TYPE [, FLAGS ]] ), remove, set
12013 ( STAT ), set ( NAME => VALUE [, NAME => VALUE ...] ), snd ( TYPE, MSG [,
12014 FLAGS ] ), stat
12015
12016 =item SEE ALSO
12017
12018 =item AUTHOR
12019
12020 =item COPYRIGHT
12021
12022 =back
12023
12024 =head2 IPC::Open2, open2 - open a process for both reading and writing
12025
12026 =over 4
12027
12028 =item SYNOPSIS
12029
12030 =item DESCRIPTION
12031
12032 =item WARNING
12033
12034 =item SEE ALSO
12035
12036 =back
12037
12038 =head2 IPC::Open3, open3 - open a process for reading, writing, and error
12039 handling
12040
12041 =over 4
12042
12043 =item SYNOPSIS
12044
12045 =item DESCRIPTION
12046
12047 =item WARNING
12048
12049 =back
12050
12051 =head2 IPC::Semaphore - SysV Semaphore IPC object class
12052
12053 =over 4
12054
12055 =item SYNOPSIS
12056
12057 =item DESCRIPTION
12058
12059 =item METHODS
12060
12061 new ( KEY , NSEMS , FLAGS ), getall, getncnt ( SEM ), getpid ( SEM ),
12062 getval ( SEM ), getzcnt ( SEM ), id, op ( OPLIST ), remove, set ( STAT ),
12063 set ( NAME => VALUE [, NAME => VALUE ...] ), setall ( VALUES ), setval ( N
12064 , VALUE ), stat
12065
12066 =item SEE ALSO
12067
12068 =item AUTHOR
12069
12070 =item COPYRIGHT
12071
12072 =back
12073
12074 =head2 IPC::SysV - SysV IPC constants
12075
12076 =over 4
12077
12078 =item SYNOPSIS
12079
12080 =item DESCRIPTION
12081
12082 ftok( PATH, ID )
12083
12084 =item SEE ALSO
12085
12086 =item AUTHORS
12087
12088 =item COPYRIGHT
12089
12090 =back
12091
12092 =head2 IPC::SysV::Msg, IPC::Msg - SysV Msg IPC object class
12093
12094 =over 4
12095
12096 =item SYNOPSIS
12097
12098 =item DESCRIPTION
12099
12100 =item METHODS
12101
12102 new ( KEY , FLAGS ), id, rcv ( BUF, LEN [, TYPE [, FLAGS ]] ), remove, set
12103 ( STAT ), set ( NAME => VALUE [, NAME => VALUE ...] ), snd ( TYPE, MSG [,
12104 FLAGS ] ), stat
12105
12106 =item SEE ALSO
12107
12108 =item AUTHOR
12109
12110 =item COPYRIGHT
12111
12112 =back
12113
12114 =head2 IPC::SysV::Semaphore, IPC::Semaphore - SysV Semaphore IPC object
12115 class
12116
12117 =over 4
12118
12119 =item SYNOPSIS
12120
12121 =item DESCRIPTION
12122
12123 =item METHODS
12124
12125 new ( KEY , NSEMS , FLAGS ), getall, getncnt ( SEM ), getpid ( SEM ),
12126 getval ( SEM ), getzcnt ( SEM ), id, op ( OPLIST ), remove, set ( STAT ),
12127 set ( NAME => VALUE [, NAME => VALUE ...] ), setall ( VALUES ), setval ( N
12128 , VALUE ), stat
12129
12130 =item SEE ALSO
12131
12132 =item AUTHOR
12133
12134 =item COPYRIGHT
12135
12136 =back
12137
12138 =head2 Lingua::KO::Hangul::Util - utility functions for Hangul Syllables
12139
12140 =over 4
12141
12142 =item SYNOPSIS
12143
12144 =item DESCRIPTION
12145
12146 =over 4
12147
12148 =item Composition and Decomposition
12149
12150 C<$string_decomposed = decomposeHangul($codepoint)>, C<@codepoints =
12151 decomposeHangul($codepoint)>, C<$string_composed =
12152 composeHangul($src_string)>, C<@codepoints_composed =
12153 composeHangul($src_string)>
12154
12155 =item Hangul Syllable Name
12156
12157 C<$name = getHangulName($codepoint)>, C<$codepoint =
12158 parseHangulName($name)>
12159
12160 =item EXPORT
12161
12162 =back
12163
12164 =item AUTHOR
12165
12166 =item SEE ALSO
12167
12168 http://www.unicode.org/unicode/reports/tr15
12169
12170 =back
12171
12172 =head2 List::Util - A selection of general-utility list subroutines
12173
12174 =over 4
12175
12176 =item SYNOPSIS
12177
12178 =item DESCRIPTION
12179
12180 first BLOCK LIST, max LIST, maxstr LIST, min LIST, minstr LIST, reduce
12181 BLOCK LIST, shuffle LIST, sum LIST
12182
12183 =item SUGGESTED ADDITIONS
12184
12185 =item COPYRIGHT
12186
12187 =back
12188
12189 =head2 List::Utilib::List::Util, List::Util - A selection of
12190 general-utility list subroutines
12191
12192 =over 4
12193
12194 =item SYNOPSIS
12195
12196 =item DESCRIPTION
12197
12198 first BLOCK LIST, max LIST, maxstr LIST, min LIST, minstr LIST, reduce
12199 BLOCK LIST, shuffle LIST, sum LIST
12200
12201 =item SUGGESTED ADDITIONS
12202
12203 =item COPYRIGHT
12204
12205 =back
12206
12207 =head2 List::Utilib::Scalar::Util, Scalar::Util - A selection of
12208 general-utility scalar subroutines
12209
12210 =over 4
12211
12212 =item SYNOPSIS
12213
12214 =item DESCRIPTION
12215
12216 blessed EXPR, dualvar NUM, STRING, isweak EXPR, readonly SCALAR, reftype
12217 EXPR, tainted EXPR, weaken REF
12218
12219 =item COPYRIGHT
12220
12221 =item BLATANT PLUG
12222
12223 =back
12224
12225 =head2 Locale::Constants - constants for Locale codes
12226
12227 =over 4
12228
12229 =item SYNOPSIS
12230
12231 =item DESCRIPTION
12232
12233 =item KNOWN BUGS AND LIMITATIONS
12234
12235 =item SEE ALSO
12236
12237 Locale::Language, Locale::Country, Locale::Currency
12238
12239 =item AUTHOR
12240
12241 =item COPYRIGHT
12242
12243 =back
12244
12245 =head2 Locale::Country - ISO codes for country identification (ISO 3166)
12246
12247 =over 4
12248
12249 =item SYNOPSIS
12250
12251 =back
12252
12253 =over 4
12254
12255 =item DESCRIPTION
12256
12257 B<alpha-2>, B<alpha-3>, B<numeric>
12258
12259 =back
12260
12261 =over 4
12262
12263 =item CONVERSION ROUTINES
12264
12265 code2country( CODE, [ CODESET ] ), country2code( STRING, [ CODESET ] ),
12266 country_code2code( CODE, CODESET, CODESET )
12267
12268 =back
12269
12270 =over 4
12271
12272 =item QUERY ROUTINES
12273
12274 C<all_country_codes( [ CODESET ] )>, C<all_country_names( [ CODESET ] )>
12275
12276 =back
12277
12278 =over 4
12279
12280 =item CODE ALIASING
12281
12282 =back
12283
12284 =over 4
12285
12286 =item EXAMPLES
12287
12288 =item DOMAIN NAMES
12289
12290 =item KNOWN BUGS AND LIMITATIONS
12291
12292 =item SEE ALSO
12293
12294 Locale::Language, Locale::Currency, ISO 3166,
12295 http://www.din.de/gremien/nas/nabd/iso3166ma/,
12296 http://www.egt.ie/standards/iso3166/iso3166-1-en.html,
12297 http://www.cia.gov/cia/publications/factbook/docs/app-f.html
12298
12299 =item AUTHOR
12300
12301 =item COPYRIGHT
12302
12303 =back
12304
12305 =head2 Locale::Currency - ISO three letter codes for currency
12306 identification (ISO 4217)
12307
12308 =over 4
12309
12310 =item SYNOPSIS
12311
12312 =back
12313
12314 =over 4
12315
12316 =item DESCRIPTION
12317
12318 XTS, XXX
12319
12320 =back
12321
12322 =over 4
12323
12324 =item CONVERSION ROUTINES
12325
12326 code2currency(), currency2code()
12327
12328 =back
12329
12330 =over 4
12331
12332 =item QUERY ROUTINES
12333
12334 C<all_currency_codes()>, C<all_currency_names()>
12335
12336 =back
12337
12338 =over 4
12339
12340 =item EXAMPLES
12341
12342 =item KNOWN BUGS AND LIMITATIONS
12343
12344 =item SEE ALSO
12345
12346 Locale::Country, ISO 4217:1995, http://www.bsi-global.com/iso4217currency
12347
12348 =item AUTHOR
12349
12350 =item COPYRIGHT
12351
12352 =back
12353
12354 =head2 Locale::Language - ISO two letter codes for language identification
12355 (ISO 639)
12356
12357 =over 4
12358
12359 =item SYNOPSIS
12360
12361 =back
12362
12363 =over 4
12364
12365 =item DESCRIPTION
12366
12367 =back
12368
12369 =over 4
12370
12371 =item CONVERSION ROUTINES
12372
12373 code2language(), language2code()
12374
12375 =back
12376
12377 =over 4
12378
12379 =item QUERY ROUTINES
12380
12381 C<all_language_codes()>, C<all_language_names()>
12382
12383 =back
12384
12385 =over 4
12386
12387 =item EXAMPLES
12388
12389 =item KNOWN BUGS AND LIMITATIONS
12390
12391 =item SEE ALSO
12392
12393 Locale::Country, Locale::Currency, ISO 639:1988 (E/F),
12394 http://lcweb.loc.gov/standards/iso639-2/langhome.html
12395
12396 =item AUTHOR
12397
12398 =item COPYRIGHT
12399
12400 =back
12401
12402 =head2 Locale::Maketext -- framework for localization
12403
12404 =over 4
12405
12406 =item SYNOPSIS
12407
12408 =item DESCRIPTION
12409
12410 =item QUICK OVERVIEW
12411
12412 =item METHODS
12413
12414 =over 4
12415
12416 =item Construction Methods
12417
12418 =item The "maketext" Method
12419
12420 $lh->fail_with I<or> $lh->fail_with(I<PARAM>), $lh->failure_handler_auto
12421
12422 =item Utility Methods
12423
12424 $language->quant($number, $singular), $language->quant($number, $singular,
12425 $plural), $language->quant($number, $singular, $plural, $negative),
12426 $language->numf($number), $language->sprintf($format, @items),
12427 $language->language_tag(), $language->encoding()
12428
12429 =item Language Handle Attributes and Internals
12430
12431 =back
12432
12433 =item LANGUAGE CLASS HIERARCHIES
12434
12435 =item ENTRIES IN EACH LEXICON
12436
12437 =item BRACKET NOTATION
12438
12439 =item AUTO LEXICONS
12440
12441 =item CONTROLLING LOOKUP FAILURE
12442
12443 =item HOW TO USE MAKETEXT
12444
12445 =item SEE ALSO
12446
12447 =item COPYRIGHT AND DISCLAIMER
12448
12449 =item AUTHOR
12450
12451 =back
12452
12453 =head2 Locale::Maketext::TPJ13 -- article about software localization
12454
12455 =over 4
12456
12457 =item SYNOPSIS
12458
12459 =item DESCRIPTION
12460
12461 =item Localization and Perl: gettext breaks, Maketext fixes
12462
12463 =over 4
12464
12465 =item A Localization Horror Story: It Could Happen To You
12466
12467 =item The Linguistic View
12468
12469 =item Breaking gettext
12470
12471 =item Replacing gettext
12472
12473 =item Buzzwords: Abstraction and Encapsulation
12474
12475 =item Buzzword: Isomorphism
12476
12477 =item Buzzword: Inheritance
12478
12479 =item Buzzword: Concision
12480
12481 =item The Devil in the Details
12482
12483 =item The Proof in the Pudding: Localizing Web Sites
12484
12485 =item References
12486
12487 =back
12488
12489 =back
12490
12491 =head2 MIME::Base64 - Encoding and decoding of base64 strings
12492
12493 =over 4
12494
12495 =item SYNOPSIS
12496
12497 =item DESCRIPTION
12498
12499 encode_base64($str, [$eol]), decode_base64($str)
12500
12501 =item DIAGNOSTICS
12502
12503 Premature end of base64 data, Premature padding of base64 data
12504
12505 =item EXAMPLES
12506
12507 =item COPYRIGHT
12508
12509 =back
12510
12511 =head2 MIME::Base64::QuotedPrint, MIME::QuotedPrint - Encoding and decoding
12512 of quoted-printable strings
12513
12514 =over 4
12515
12516 =item SYNOPSIS
12517
12518 =item DESCRIPTION
12519
12520 encode_qp($str), decode_qp($str);
12521
12522 =item COPYRIGHT
12523
12524 =back
12525
12526 =head2 MIME::QuotedPrint - Encoding and decoding of quoted-printable
12527 strings
12528
12529 =over 4
12530
12531 =item SYNOPSIS
12532
12533 =item DESCRIPTION
12534
12535 encode_qp($str), decode_qp($str);
12536
12537 =item COPYRIGHT
12538
12539 =back
12540
12541 =head2 Math::BigFloat - Arbitrary size floating point math package
12542
12543 =over 4
12544
12545 =item SYNOPSIS
12546
12547 =item DESCRIPTION
12548
12549 =over 4
12550
12551 =item Canonical notation
12552
12553 =item Output
12554
12555 =item C<mantissa()>, C<exponent()> and C<parts()>
12556
12557 =item Accuracy vs. Precision
12558
12559 =item Rounding
12560
12561 ffround ( +$scale ), ffround ( -$scale ), ffround ( 0 ), fround  ( +$scale
12562 ), fround  ( -$scale ) and fround ( 0 )
12563
12564 =back
12565
12566 =item EXAMPLES
12567
12568   # not ready yet
12569
12570 =item Autocreating constants
12571
12572 =item BUGS
12573
12574 =item CAVEAT
12575
12576 stringify, bstr(), bdiv, Modifying and =, bpow
12577
12578 =item LICENSE
12579
12580 =item AUTHORS
12581
12582 =back
12583
12584 =head2 Math::BigInt - Arbitrary size integer math package
12585
12586 =over 4
12587
12588 =item SYNOPSIS
12589
12590 =item DESCRIPTION
12591
12592 Canonical notation, Input, Output
12593
12594 =item ACCURACY and PRECISION
12595
12596 =over 4
12597
12598 =item Precision P
12599
12600 =item Accuracy A
12601
12602 =item Fallback F
12603
12604 =item Rounding mode R
12605
12606 'trunc', 'even', 'odd', '+inf', '-inf', 'zero', Precision, Accuracy
12607 (significant digits), Setting/Accessing, Creating numbers, Usage,
12608 Precedence, Overriding globals, Local settings, Rounding, Default values,
12609 Remarks
12610
12611 =back
12612
12613 =item INTERNALS
12614
12615 =over 4
12616
12617 =item MATH LIBRARY
12618
12619 =item SIGN
12620
12621 =item mantissa(), exponent() and parts()
12622
12623 =back
12624
12625 =item EXAMPLES
12626
12627   use Math::BigInt qw(bstr);
12628
12629 =item Autocreating constants
12630
12631 =item PERFORMANCE
12632
12633 =over 4
12634
12635 =item Alternative math libraries
12636
12637 =back
12638
12639 =item BUGS
12640
12641 Out of Memory!, Fails to load Calc on Perl prior 5.6.0
12642
12643 =item CAVEATS
12644
12645 stringify, bstr(), bsstr() and 'cmp', int(), bdiv, bdiv, Modifying and =,
12646 bpow, Overloading -$x, Mixing different object types, bsqrt()
12647
12648 =item LICENSE
12649
12650 =item SEE ALSO
12651
12652 =item AUTHORS
12653
12654 =back
12655
12656 =head2 Math::BigInt::Calc - Pure Perl module to support Math::BigInt
12657
12658 =over 4
12659
12660 =item SYNOPSIS
12661
12662 =item DESCRIPTION
12663
12664 =item EXPORT
12665
12666 =item WRAP YOUR OWN
12667
12668 =item LICENSE
12669
12670 This program is free software; you may redistribute it and/or modify it
12671 under
12672 the same terms as Perl itself.
12673
12674 =item AUTHORS
12675
12676 =item SEE ALSO
12677
12678 =back
12679
12680 =head2 Math::Complex - complex numbers and associated mathematical
12681 functions
12682
12683 =over 4
12684
12685 =item SYNOPSIS
12686
12687 =item DESCRIPTION
12688
12689 =item OPERATIONS
12690
12691 =item CREATION
12692
12693 =item STRINGIFICATION
12694
12695 =over 4
12696
12697 =item CHANGED IN PERL 5.6
12698
12699 =back
12700
12701 =item USAGE
12702
12703 =item ERRORS DUE TO DIVISION BY ZERO OR LOGARITHM OF ZERO
12704
12705 =item ERRORS DUE TO INDIGESTIBLE ARGUMENTS
12706
12707 =item BUGS
12708
12709 =item AUTHORS
12710
12711 =back
12712
12713 =head2 Math::Trig - trigonometric functions
12714
12715 =over 4
12716
12717 =item SYNOPSIS
12718
12719 =item DESCRIPTION
12720
12721 =item TRIGONOMETRIC FUNCTIONS
12722
12723 B<tan>
12724
12725 =over 4
12726
12727 =item ERRORS DUE TO DIVISION BY ZERO
12728
12729 =item SIMPLE (REAL) ARGUMENTS, COMPLEX RESULTS
12730
12731 =back
12732
12733 =item PLANE ANGLE CONVERSIONS
12734
12735 =item RADIAL COORDINATE CONVERSIONS
12736
12737 =over 4
12738
12739 =item COORDINATE SYSTEMS
12740
12741 =item 3-D ANGLE CONVERSIONS
12742
12743 cartesian_to_cylindrical, cartesian_to_spherical, cylindrical_to_cartesian,
12744 cylindrical_to_spherical, spherical_to_cartesian, spherical_to_cylindrical
12745
12746 =back
12747
12748 =item GREAT CIRCLE DISTANCES AND DIRECTIONS
12749
12750 =item EXAMPLES
12751
12752 =over 4
12753
12754 =item CAVEAT FOR GREAT CIRCLE FORMULAS
12755
12756 =back
12757
12758 =item BUGS
12759
12760 =item AUTHORS
12761
12762 =back
12763
12764 =head2 Memoize - Make your functions faster by trading space for time
12765
12766 =over 4
12767
12768 =item SYNOPSIS
12769
12770 =item DESCRIPTION
12771
12772 =item DETAILS
12773
12774 =item OPTIONS
12775
12776 =over 4
12777
12778 =item INSTALL
12779
12780 =item NORMALIZER
12781
12782 =item C<SCALAR_CACHE>, C<LIST_CACHE>
12783
12784 C<MEMORY>, C<HASH>, C<TIE>, C<FAULT>, C<MERGE>
12785
12786 =back
12787
12788 =item OTHER FACILITIES
12789
12790 =over 4
12791
12792 =item C<unmemoize>
12793
12794 =item C<flush_cache>
12795
12796 =back
12797
12798 =item CAVEATS
12799
12800 =item PERSISTENT CACHE SUPPORT
12801
12802 =item EXPIRATION SUPPORT
12803
12804 =item BUGS
12805
12806 =item MAILING LIST
12807
12808 =item AUTHOR
12809
12810 =item COPYRIGHT AND LICENSE
12811
12812 =item THANK YOU
12813
12814 =back
12815
12816 =head2 Memoize::AnyDBM_File - glue to provide EXISTS for AnyDBM_File for
12817 Storable use
12818
12819 =over 4
12820
12821 =item DESCRIPTION
12822
12823 =back
12824
12825 =head2 Memoize::Expire - Plug-in module for automatic expiration of
12826 memoized values
12827
12828 =over 4
12829
12830 =item SYNOPSIS
12831
12832 =item DESCRIPTION
12833
12834 =item INTERFACE
12835
12836  TIEHASH,  EXISTS,  STORE
12837
12838 =item ALTERNATIVES
12839
12840 =item CAVEATS
12841
12842 =item AUTHOR
12843
12844 =item SEE ALSO
12845
12846 =back
12847
12848 =head2 Memoize::ExpireFile - test for Memoize expiration semantics
12849
12850 =over 4
12851
12852 =item DESCRIPTION
12853
12854 =back
12855
12856 =head2 Memoize::ExpireTest - test for Memoize expiration semantics
12857
12858 =over 4
12859
12860 =item DESCRIPTION
12861
12862 =back
12863
12864 =head2 Memoize::NDBM_File - glue to provide EXISTS for NDBM_File for
12865 Storable use
12866
12867 =over 4
12868
12869 =item DESCRIPTION
12870
12871 =back
12872
12873 =head2 Memoize::SDBM_File - glue to provide EXISTS for SDBM_File for
12874 Storable use
12875
12876 =over 4
12877
12878 =item DESCRIPTION
12879
12880 =back
12881
12882 =head2 Memoize::Saves - Plug-in module to specify which return values
12883 should be memoized
12884
12885 =over 4
12886
12887 =item SYNOPSIS
12888
12889 =item DESCRIPTION
12890
12891 =item CAVEATS
12892
12893 =item AUTHOR
12894
12895 =item SEE ALSO
12896
12897 =back
12898
12899 =head2 Memoize::Storable - store Memoized data in Storable database
12900
12901 =over 4
12902
12903 =item DESCRIPTION
12904
12905 =back
12906
12907 =head2 NDBM_File - Tied access to ndbm files
12908
12909 =over 4
12910
12911 =item SYNOPSIS
12912
12913 =item DESCRIPTION
12914
12915 C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR>
12916
12917 =item DIAGNOSTICS
12918
12919 =over 4
12920
12921 =item C<ndbm store returned -1, errno 22, key "..." at ...>
12922
12923 =back
12924
12925 =item BUGS AND WARNINGS
12926
12927 =back
12928
12929 =head2 NEXT - Provide a pseudo-class NEXT that allows method redispatch
12930
12931 =over 4
12932
12933 =item SYNOPSIS
12934
12935 =item DESCRIPTION
12936
12937 =item AUTHOR
12938
12939 =item BUGS AND IRRITATIONS
12940
12941 =item COPYRIGHT
12942
12943 =back
12944
12945 =head2 Net::Cmd - Network Command class (as used by FTP, SMTP etc)
12946
12947 =over 4
12948
12949 =item SYNOPSIS
12950
12951 =item DESCRIPTION
12952
12953 =item USER METHODS
12954
12955 debug ( VALUE ), message (), code (), ok (), status (), datasend ( DATA ),
12956 dataend ()
12957
12958 =item CLASS METHODS
12959
12960 debug_print ( DIR, TEXT ), debug_text ( TEXT ), command ( CMD [, ARGS, ...
12961 ]), unsupported (), response (), parse_response ( TEXT ), getline (),
12962 ungetline ( TEXT ), read_until_dot ()
12963
12964 =item EXPORTS
12965
12966 =item AUTHOR
12967
12968 =item COPYRIGHT
12969
12970 =back
12971
12972 =head2 Net::Config - Local configuration data for libnet
12973
12974 =over 4
12975
12976 =item SYNOPSYS
12977
12978 =item DESCRIPTION
12979
12980 =item METHODS
12981
12982 requires_firewall HOST
12983
12984 =item NetConfig VALUES
12985
12986 nntp_hosts, snpp_hosts, pop3_hosts, smtp_hosts, ph_hosts, daytime_hosts,
12987 time_hosts, inet_domain, ftp_firewall, ftp_firewall_type, ftp_ext_passive,
12988 ftp_int_pasive, local_netmask, test_hosts, test_exists
12989
12990 =back
12991
12992 =head2 Net::Domain - Attempt to evaluate the current host's internet name
12993 and domain
12994
12995 =over 4
12996
12997 =item SYNOPSIS
12998
12999 =item DESCRIPTION
13000
13001 hostfqdn (), hostname (), hostdomain ()
13002
13003 =item AUTHOR
13004
13005 =item COPYRIGHT
13006
13007 =back
13008
13009 =head2 Net::FTP - FTP Client class
13010
13011 =over 4
13012
13013 =item SYNOPSIS
13014
13015 =item DESCRIPTION
13016
13017 =item OVERVIEW
13018
13019 =item CONSTRUCTOR
13020
13021 new (HOST [,OPTIONS])
13022
13023 =item METHODS
13024
13025 login ([LOGIN [,PASSWORD [, ACCOUNT] ] ]), authorize ( [AUTH [, RESP]]),
13026 site (ARGS), type (TYPE [, ARGS]), ascii ([ARGS]) binary([ARGS])
13027 ebcdic([ARGS]) byte([ARGS]), rename ( OLDNAME, NEWNAME ), delete ( FILENAME
13028 ), cwd ( [ DIR ] ), cdup (), pwd (), restart ( WHERE ), rmdir ( DIR ),
13029 mkdir ( DIR [, RECURSE ]), ls ( [ DIR ] ), dir ( [ DIR ] ), get (
13030 REMOTE_FILE [, LOCAL_FILE [, WHERE]] ), put ( LOCAL_FILE [, REMOTE_FILE ]
13031 ), put_unique ( LOCAL_FILE [, REMOTE_FILE ] ), append ( LOCAL_FILE [,
13032 REMOTE_FILE ] ), unique_name (), mdtm ( FILE ), size ( FILE ), supported (
13033 CMD ), hash ( [FILEHANDLE_GLOB_REF],[ BYTES_PER_HASH_MARK] ), nlst ( [ DIR
13034 ] ), list ( [ DIR ] ), retr ( FILE ), stor ( FILE ), stou ( FILE ), appe (
13035 FILE ), port ( [ PORT ] ), pasv (), pasv_xfer ( SRC_FILE, DEST_SERVER [,
13036 DEST_FILE ] ), pasv_xfer_unique ( SRC_FILE, DEST_SERVER [, DEST_FILE ] ),
13037 pasv_wait ( NON_PASV_SERVER ), abort (), quit ()
13038
13039 =over 4
13040
13041 =item Methods for the adventurous
13042
13043 quot (CMD [,ARGS])
13044
13045 =back
13046
13047 =item THE dataconn CLASS
13048
13049 read ( BUFFER, SIZE [, TIMEOUT ] ), write ( BUFFER, SIZE [, TIMEOUT ] ),
13050 bytes_read (), abort (), close ()
13051
13052 =item UNIMPLEMENTED
13053
13054 B<ALLO>, B<SMNT>, B<HELP>, B<MODE>, B<SYST>, B<STAT>, B<STRU>, B<REIN>
13055
13056 =item REPORTING BUGS
13057
13058 =item AUTHOR
13059
13060 =item SEE ALSO
13061
13062 =item USE EXAMPLES
13063
13064 http://www.csh.rit.edu/~adam/Progs/autoftp-2.0.tar.gz
13065
13066 =item CREDITS
13067
13068 =item COPYRIGHT
13069
13070 =back
13071
13072 =head2 Net::NNTP - NNTP Client class
13073
13074 =over 4
13075
13076 =item SYNOPSIS
13077
13078 =item DESCRIPTION
13079
13080 =item CONSTRUCTOR
13081
13082 new ( [ HOST ] [, OPTIONS ])
13083
13084 =item METHODS
13085
13086 article ( [ MSGID|MSGNUM ], [FH] ), body ( [ MSGID|MSGNUM ], [FH] ), head (
13087 [ MSGID|MSGNUM ], [FH] ), nntpstat ( [ MSGID|MSGNUM ] ), group ( [ GROUP ]
13088 ), ihave ( MSGID [, MESSAGE ]), last (), date (), postok (), authinfo (
13089 USER, PASS ), list (), newgroups ( SINCE [, DISTRIBUTIONS ]), newnews (
13090 SINCE [, GROUPS [, DISTRIBUTIONS ]]), next (), post ( [ MESSAGE ] ), slave
13091 (), quit ()
13092
13093 =over 4
13094
13095 =item Extension methods
13096
13097 newsgroups ( [ PATTERN ] ), distributions (), subscriptions (),
13098 overview_fmt (), active_times (), active ( [ PATTERN ] ), xgtitle ( PATTERN
13099 ), xhdr ( HEADER, MESSAGE-SPEC ), xover ( MESSAGE-SPEC ), xpath (
13100 MESSAGE-ID ), xpat ( HEADER, PATTERN, MESSAGE-SPEC), xrover, listgroup ( [
13101 GROUP ] ), reader
13102
13103 =back
13104
13105 =item UNSUPPORTED
13106
13107 =item DEFINITIONS
13108
13109 MESSAGE-SPEC, PATTERN, Examples, C<[^]-]>, C<*bdc>, C<[0-9a-zA-Z]>, C<a??d>
13110
13111 =item SEE ALSO
13112
13113 =item AUTHOR
13114
13115 =item COPYRIGHT
13116
13117 =back
13118
13119 =head2 Net::POP3 - Post Office Protocol 3 Client class (RFC1081)
13120
13121 =over 4
13122
13123 =item SYNOPSIS
13124
13125 =item DESCRIPTION
13126
13127 =item EXAMPLES
13128
13129 =item CONSTRUCTOR
13130
13131 new ( [ HOST, ] [ OPTIONS ] )
13132
13133 =item METHODS
13134
13135 user ( USER ), pass ( PASS ), login ( [ USER [, PASS ]] ), apop ( USER,
13136 PASS ), top ( MSGNUM [, NUMLINES ] ), list ( [ MSGNUM ] ), get ( MSGNUM [,
13137 FH ] ), last (), popstat (), ping ( USER ), uidl ( [ MSGNUM ] ), delete (
13138 MSGNUM ), reset (), quit ()
13139
13140 =item NOTES
13141
13142 =item SEE ALSO
13143
13144 =item AUTHOR
13145
13146 =item COPYRIGHT
13147
13148 =back
13149
13150 =head2 Net::Ping - check a remote host for reachability
13151
13152 =over 4
13153
13154 =item SYNOPSIS
13155
13156 =item DESCRIPTION
13157
13158 icmp, udp, tcp, stream, external
13159
13160 =over 4
13161
13162 =item Functions
13163
13164 Net::Ping->new([$proto [, $def_timeout [, $bytes]]]);, $p->ping($host [,
13165 $timeout]);, $p->open($host);, $p->close();, pingecho($host [, $timeout]);
13166
13167 =back
13168
13169 =item NOTES
13170
13171 =back
13172
13173 =head2 Net::SMTP - Simple Mail Transfer Protocol Client
13174
13175 =over 4
13176
13177 =item SYNOPSIS
13178
13179 =item DESCRIPTION
13180
13181 =item EXAMPLES
13182
13183 =item CONSTRUCTOR
13184
13185 new Net::SMTP [ HOST, ] [ OPTIONS ]
13186
13187 =item METHODS
13188
13189 banner (), domain (), hello ( DOMAIN ), etrn ( DOMAIN ), mail ( ADDRESS [,
13190 OPTIONS] ), send ( ADDRESS ), send_or_mail ( ADDRESS ), send_and_mail (
13191 ADDRESS ), reset (), recipient ( ADDRESS [, ADDRESS [ ...]] [, OPTIONS ] ),
13192 to ( ADDRESS [, ADDRESS [...]] ), cc ( ADDRESS [, ADDRESS [...]] ), bcc (
13193 ADDRESS [, ADDRESS [...]] ), data ( [ DATA ] ), expand ( ADDRESS ), verify
13194 ( ADDRESS ), help ( [ $subject ] ), quit ()
13195
13196 =item SEE ALSO
13197
13198 =item AUTHOR
13199
13200 =item COPYRIGHT
13201
13202 =back
13203
13204 =head2 Net::Time - time and daytime network client interface
13205
13206 =over 4
13207
13208 =item SYNOPSIS
13209
13210 =item DESCRIPTION
13211
13212 inet_time ( [HOST [, PROTOCOL [, TIMEOUT]]]), inet_daytime ( [HOST [,
13213 PROTOCOL [, TIMEOUT]]])
13214
13215 =item AUTHOR
13216
13217 =item COPYRIGHT
13218
13219 =back
13220
13221 =head2 Net::hostent - by-name interface to Perl's built-in gethost*()
13222 functions
13223
13224 =over 4
13225
13226 =item SYNOPSIS
13227
13228 =item DESCRIPTION
13229
13230 =item EXAMPLES
13231
13232 =item NOTE
13233
13234 =item AUTHOR
13235
13236 =back
13237
13238 =head2 Net::libnetFAQ, libnetFAQ - libnet Frequently Asked Questions
13239
13240 =over 4
13241
13242 =item DESCRIPTION
13243
13244 =over 4
13245
13246 =item Where to get this document
13247
13248 =item How to contribute to this document
13249
13250 =back
13251
13252 =item Author and Copyright Information
13253
13254 =over 4
13255
13256 =item Disclaimer
13257
13258 =back
13259
13260 =item Obtaining and installing libnet
13261
13262 =over 4
13263
13264 =item What is libnet ?
13265
13266 =item Which version of perl do I need ?
13267
13268 =item What other modules do I need ?
13269
13270 =item What machines support libnet ?
13271
13272 =item Where can I get the latest libnet release
13273
13274 =back
13275
13276 =item Using Net::FTP
13277
13278 =over 4
13279
13280 =item How do I download files from a FTP server ?
13281
13282 =item How do I transfer files in binary mode ?
13283
13284 =item How can I get the size of a file on a remote FTP server ?
13285
13286 =item How can I get the modification time of a file on a remote FTP server
13287 ?
13288
13289 =item How can I change the permissions of a file on a remote server ?
13290
13291 =item Can I do a reget operation like the ftp command ?
13292
13293 =item How do I get a directory listing from a FTP server ?
13294
13295 =item Changeing directory to "" does not fail ?
13296
13297 =item I am behind a SOCKS firewall, but the Firewall option does not work ?
13298
13299 =item I am behind a FTP proxy firewall, but cannot access machines outside
13300 ?
13301
13302 =item My ftp proxy firewall does not listen on port 21
13303
13304 =item Is it possible to change the file permissions of a file on an FTP
13305 server ?
13306
13307 =item I have seen scripts call a method message, but cannot find it
13308 documented ?
13309
13310 =item Why does Net::FTP not implement mput and mget methods
13311
13312 =back
13313
13314 =item Using Net::SMTP
13315
13316 =over 4
13317
13318 =item Why can't the part of an Email address after the @ be used as the
13319 hostname ?
13320
13321 =item Why does Net::SMTP not do DNS MX lookups ?
13322
13323 =item The verify method always returns true ?
13324
13325 =back
13326
13327 =item Debugging scripts
13328
13329 =over 4
13330
13331 =item How can I debug my scripts that use Net::* modules ?
13332
13333 =back
13334
13335 =item AUTHOR AND COPYRIGHT
13336
13337 =back
13338
13339 =head2 Net::netent - by-name interface to Perl's built-in getnet*()
13340 functions
13341
13342 =over 4
13343
13344 =item SYNOPSIS
13345
13346 =item DESCRIPTION
13347
13348 =item EXAMPLES
13349
13350 =item NOTE
13351
13352 =item AUTHOR
13353
13354 =back
13355
13356 =head2 Net::protoent - by-name interface to Perl's built-in getproto*()
13357 functions
13358
13359 =over 4
13360
13361 =item SYNOPSIS
13362
13363 =item DESCRIPTION
13364
13365 =item NOTE
13366
13367 =item AUTHOR
13368
13369 =back
13370
13371 =head2 Net::servent - by-name interface to Perl's built-in getserv*()
13372 functions
13373
13374 =over 4
13375
13376 =item SYNOPSIS
13377
13378 =item DESCRIPTION
13379
13380 =item EXAMPLES
13381
13382 =item NOTE
13383
13384 =item AUTHOR
13385
13386 =back
13387
13388 =head2 Netrc, Net::Netrc - OO interface to users netrc file
13389
13390 =over 4
13391
13392 =item SYNOPSIS
13393
13394 =item DESCRIPTION
13395
13396 =item THE .netrc FILE
13397
13398 machine name, default, login name, password string, account string, macdef
13399 name
13400
13401 =item CONSTRUCTOR
13402
13403 lookup ( MACHINE [, LOGIN ])
13404
13405 =item METHODS
13406
13407 login (), password (), account (), lpa ()
13408
13409 =item AUTHOR
13410
13411 =item SEE ALSO
13412
13413 =item COPYRIGHT
13414
13415 =back
13416
13417 =head2 O - Generic interface to Perl Compiler backends
13418
13419 =over 4
13420
13421 =item SYNOPSIS
13422
13423 =item DESCRIPTION
13424
13425 =item CONVENTIONS
13426
13427 =item IMPLEMENTATION
13428
13429 =item AUTHOR
13430
13431 =back
13432
13433 =head2 ODBM_File - Tied access to odbm files
13434
13435 =over 4
13436
13437 =item SYNOPSIS
13438
13439 =item DESCRIPTION
13440
13441 C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR>
13442
13443 =item DIAGNOSTICS
13444
13445 =over 4
13446
13447 =item C<odbm store returned -1, errno 22, key "..." at ...>
13448
13449 =back
13450
13451 =item BUGS AND WARNINGS
13452
13453 =back
13454
13455 =head2 Opcode - Disable named opcodes when compiling perl code
13456
13457 =over 4
13458
13459 =item SYNOPSIS
13460
13461 =item DESCRIPTION
13462
13463 =item NOTE
13464
13465 =item WARNING
13466
13467 =item Operator Names and Operator Lists
13468
13469 an operator name (opname), an operator tag name (optag), a negated opname
13470 or optag, an operator set (opset)
13471
13472 =item Opcode Functions
13473
13474 opcodes, opset (OP, ...), opset_to_ops (OPSET), opset_to_hex (OPSET),
13475 full_opset, empty_opset, invert_opset (OPSET), verify_opset (OPSET, ...),
13476 define_optag (OPTAG, OPSET), opmask_add (OPSET), opmask, opdesc (OP, ...),
13477 opdump (PAT)
13478
13479 =item Manipulating Opsets
13480
13481 =item TO DO (maybe)
13482
13483 =back
13484
13485 =over 4
13486
13487 =item Predefined Opcode Tags
13488
13489 :base_core, :base_mem, :base_loop, :base_io, :base_orig, :base_math,
13490 :base_thread, :default, :filesys_read, :sys_db, :browse, :filesys_open,
13491 :filesys_write, :subprocess, :ownprocess, :others, :still_to_be_decided,
13492 :dangerous
13493
13494 =item SEE ALSO
13495
13496 =item AUTHORS
13497
13498 =back
13499
13500 =head2 Opcode::Safe, Safe - Compile and execute code in restricted
13501 compartments
13502
13503 =over 4
13504
13505 =item SYNOPSIS
13506
13507 =item DESCRIPTION
13508
13509 a new namespace, an operator mask
13510
13511 =item WARNING
13512
13513 =over 4
13514
13515 =item RECENT CHANGES
13516
13517 =item Methods in class Safe
13518
13519 permit (OP, ...), permit_only (OP, ...), deny (OP, ...), deny_only (OP,
13520 ...), trap (OP, ...), untrap (OP, ...), share (NAME, ...), share_from
13521 (PACKAGE, ARRAYREF), varglob (VARNAME), reval (STRING), rdo (FILENAME),
13522 root (NAMESPACE), mask (MASK)
13523
13524 =item Some Safety Issues
13525
13526 Memory, CPU, Snooping, Signals, State Changes
13527
13528 =item AUTHOR
13529
13530 =back
13531
13532 =back
13533
13534 =head2 Opcode::ops, ops - Perl pragma to restrict unsafe operations when
13535 compiling
13536
13537 =over 4
13538
13539 =item SYNOPSIS
13540
13541 =item DESCRIPTION
13542
13543 =item SEE ALSO
13544
13545 =back
13546
13547 =head2 POSIX - Perl interface to IEEE Std 1003.1
13548
13549 =over 4
13550
13551 =item SYNOPSIS
13552
13553 =item DESCRIPTION
13554
13555 =item NOTE
13556
13557 =item CAVEATS
13558
13559 =item FUNCTIONS
13560
13561 _exit, abort, abs, access, acos, alarm, asctime, asin, assert, atan, atan2,
13562 atexit, atof, atoi, atol, bsearch, calloc, ceil, chdir, chmod, chown,
13563 clearerr, clock, close, closedir, cos, cosh, creat, ctermid, ctime,
13564 cuserid, difftime, div, dup, dup2, errno, execl, execle, execlp, execv,
13565 execve, execvp, exit, exp, fabs, fclose, fcntl, fdopen, feof, ferror,
13566 fflush, fgetc, fgetpos, fgets, fileno, floor, fmod, fopen, fork, fpathconf,
13567 fprintf, fputc, fputs, fread, free, freopen, frexp, fscanf, fseek, fsetpos,
13568 fstat, ftell, fwrite, getc, getchar, getcwd, getegid, getenv, geteuid,
13569 getgid, getgrgid, getgrnam, getgroups, getlogin, getpgrp, getpid, getppid,
13570 getpwnam, getpwuid, gets, getuid, gmtime, isalnum, isalpha, isatty,
13571 iscntrl, isdigit, isgraph, islower, isprint, ispunct, isspace, isupper,
13572 isxdigit, kill, labs, ldexp, ldiv, link, localeconv, localtime, log, log10,
13573 longjmp, lseek, malloc, mblen, mbstowcs, mbtowc, memchr, memcmp, memcpy,
13574 memmove, memset, mkdir, mkfifo, mktime, modf, nice, offsetof, open,
13575 opendir, pathconf, pause, perror, pipe, pow, printf, putc, putchar, puts,
13576 qsort, raise, rand, read, readdir, realloc, remove, rename, rewind,
13577 rewinddir, rmdir, scanf, setgid, setjmp, setlocale, setpgid, setsid,
13578 setuid, sigaction, siglongjmp, sigpending, sigprocmask, sigsetjmp,
13579 sigsuspend, sin, sinh, sleep, sprintf, sqrt, srand, sscanf, stat, strcat,
13580 strchr, strcmp, strcoll, strcpy, strcspn, strerror, strftime, strlen,
13581 strncat, strncmp, strncpy, strpbrk, strrchr, strspn, strstr, strtod,
13582 strtok, strtol, strtoul, strxfrm, sysconf, system, tan, tanh, tcdrain,
13583 tcflow, tcflush, tcgetpgrp, tcsendbreak, tcsetpgrp, time, times, tmpfile,
13584 tmpnam, tolower, toupper, ttyname, tzname, tzset, umask, uname, ungetc,
13585 unlink, utime, vfprintf, vprintf, vsprintf, wait, waitpid, wcstombs,
13586 wctomb, write
13587
13588 =item CLASSES
13589
13590 =over 4
13591
13592 =item POSIX::SigAction
13593
13594 new
13595
13596 =item POSIX::SigSet
13597
13598 new, addset, delset, emptyset, fillset, ismember
13599
13600 =item POSIX::Termios
13601
13602 new, getattr, getcc, getcflag, getiflag, getispeed, getlflag, getoflag,
13603 getospeed, setattr, setcc, setcflag, setiflag, setispeed, setlflag,
13604 setoflag, setospeed, Baud rate values, Terminal interface values, c_cc
13605 field values, c_cflag field values, c_iflag field values, c_lflag field
13606 values, c_oflag field values
13607
13608 =back
13609
13610 =item PATHNAME CONSTANTS
13611
13612 Constants
13613
13614 =item POSIX CONSTANTS
13615
13616 Constants
13617
13618 =item SYSTEM CONFIGURATION
13619
13620 Constants
13621
13622 =item ERRNO
13623
13624 Constants
13625
13626 =item FCNTL
13627
13628 Constants
13629
13630 =item FLOAT
13631
13632 Constants
13633
13634 =item LIMITS
13635
13636 Constants
13637
13638 =item LOCALE
13639
13640 Constants
13641
13642 =item MATH
13643
13644 Constants
13645
13646 =item SIGNAL
13647
13648 Constants
13649
13650 =item STAT
13651
13652 Constants, Macros
13653
13654 =item STDLIB
13655
13656 Constants
13657
13658 =item STDIO
13659
13660 Constants
13661
13662 =item TIME
13663
13664 Constants
13665
13666 =item UNISTD
13667
13668 Constants
13669
13670 =item WAIT
13671
13672 Constants, Macros
13673
13674 =back
13675
13676 =head2 PerlIO - On demand loader for PerlIO layers and root of PerlIO::*
13677 name space
13678
13679 =over 4
13680
13681 =item SYNOPSIS
13682
13683 =item DESCRIPTION
13684
13685 unix, stdio, perlio, crlf, utf8, raw
13686
13687 =over 4
13688
13689 =item Defaults and how to override them
13690
13691 =back
13692
13693 =item AUTHOR
13694
13695 =item SEE ALSO
13696
13697 =back
13698
13699 =head2 PerlIO::Scalar - support module for in-memory IO.
13700
13701 =over 4
13702
13703 =item SYNOPSIS
13704
13705 =item DESCRIPTION
13706
13707 =back
13708
13709 =head2 PerlIO::Via - Helper class for PerlIO layers implemented in perl
13710
13711 =over 4
13712
13713 =item SYNOPSIS
13714
13715 =item DESCRIPTION
13716
13717 $class->PUSHED([$mode][,$fh]), $obj->POPPED([$fh]),
13718 $class->OPEN($path,$mode[,$fh]), $class->FDOPEN($fd),
13719 $class->SYSOPEN($path,$imode,$perm,$fh), $obj->FILENO($fh),
13720 $obj->READ($buffer,$len,$fh), $obj->WRITE($buffer,$fh), $obj->FILL($fh),
13721 $obj->CLOSE($fh), $obj->SEEK($posn,$whence,$fh), $obj->TELL($fh),
13722 $obj->UNREAD($buffer,$fh), $obj->FLUSH($fh), $obj->SETLINEBUF($fh),
13723 $obj->CLEARERR($fh), $obj->ERROR($fh), $obj->EOF($fh)
13724
13725 =back
13726
13727 =head2 Pod::Checker, podchecker() - check pod documents for syntax errors
13728
13729 =over 4
13730
13731 =item SYNOPSIS
13732
13733 =item OPTIONS/ARGUMENTS
13734
13735 =over 4
13736
13737 =item podchecker()
13738
13739 B<-warnings> =E<gt> I<val>
13740
13741 =back
13742
13743 =item DESCRIPTION
13744
13745 =item DIAGNOSTICS
13746
13747 =over 4
13748
13749 =item Errors
13750
13751 empty =headn, =over on line I<N> without closing =back, =item without
13752 previous =over, =back without previous =over, No argument for =begin, =end
13753 without =begin, Nested =begin's, =for without formatter specification,
13754 unresolved internal link I<NAME>, Unknown command "I<CMD>", Unknown
13755 interior-sequence "I<SEQ>", nested commands
13756 I<CMD>E<lt>...I<CMD>E<lt>...E<gt>...E<gt>, garbled entity I<STRING>, Entity
13757 number out of range, malformed link LE<lt>E<gt>, nonempty ZE<lt>E<gt>,
13758 empty XE<lt>E<gt>, Spurious text after =pod / =cut, Spurious character(s)
13759 after =back
13760
13761 =item Warnings
13762
13763 multiple occurence of link target I<name>, line containing nothing but
13764 whitespace in paragraph, file does not start with =head, previous =item has
13765 no contents, preceding non-item paragraph(s), =item type mismatch (I<one>
13766 vs. I<two>), I<N> unescaped C<E<lt>E<gt>> in paragraph, Unknown entity, No
13767 items in =over, No argument for =item, empty section in previous paragraph,
13768 Verbatim paragraph in NAME section
13769
13770 =item Hyperlinks
13771
13772 ignoring leading/trailing whitespace in link, (section) in '$page'
13773 deprecated, alternative text/node '%s' contains non-escaped | or /
13774
13775 =back
13776
13777 =item RETURN VALUE
13778
13779 =item EXAMPLES
13780
13781 =item INTERFACE
13782
13783 =back
13784
13785 C<Pod::Checker-E<gt>new( %options )>
13786
13787 C<$checker-E<gt>poderror( @args )>, C<$checker-E<gt>poderror( {%opts},
13788 @args )>
13789
13790 C<$checker-E<gt>num_errors()>
13791
13792 C<$checker-E<gt>name()>
13793
13794 C<$checker-E<gt>node()>
13795
13796 C<$checker-E<gt>idx()>
13797
13798 C<$checker-E<gt>hyperlink()>
13799
13800 =over 4
13801
13802 =item AUTHOR
13803
13804 =back
13805
13806 =head2 Pod::Find - find POD documents in directory trees
13807
13808 =over 4
13809
13810 =item SYNOPSIS
13811
13812 =item DESCRIPTION
13813
13814 =back
13815
13816 =over 4
13817
13818 =item C<pod_find( { %opts } , @directories )>
13819
13820 C<-verbose =E<gt> 1>, C<-perl =E<gt> 1>, C<-script =E<gt> 1>, C<-inc =E<gt>
13821 1>
13822
13823 =back
13824
13825 =over 4
13826
13827 =item C<simplify_name( $str )>
13828
13829 =back
13830
13831 =over 4
13832
13833 =item C<pod_where( { %opts }, $pod )>
13834
13835 C<-inc =E<gt> 1>, C<-dirs =E<gt> [ $dir1, $dir2, ... ]>, C<-verbose =E<gt>
13836 1>
13837
13838 =back
13839
13840 =over 4
13841
13842 =item C<contains_pod( $file , $verbose )>
13843
13844 =back
13845
13846 =over 4
13847
13848 =item AUTHOR
13849
13850 =item SEE ALSO
13851
13852 =back
13853
13854 =head2 Pod::Html - module to convert pod files to HTML
13855
13856 =over 4
13857
13858 =item SYNOPSIS
13859
13860 =item DESCRIPTION
13861
13862 =item ARGUMENTS
13863
13864 backlink, cachedir, css, flush, header, help, htmldir, htmlroot, index,
13865 infile, libpods, netscape, outfile, podpath, podroot, quiet, recurse,
13866 title, verbose
13867
13868 =item EXAMPLE
13869
13870 =item ENVIRONMENT
13871
13872 =item AUTHOR
13873
13874 =item SEE ALSO
13875
13876 =item COPYRIGHT
13877
13878 =back
13879
13880 =head2 Pod::InputObjects - objects representing POD input paragraphs,
13881 commands, etc.
13882
13883 =over 4
13884
13885 =item SYNOPSIS
13886
13887 =item REQUIRES
13888
13889 =item EXPORTS
13890
13891 =item DESCRIPTION
13892
13893 package B<Pod::InputSource>, package B<Pod::Paragraph>, package
13894 B<Pod::InteriorSequence>, package B<Pod::ParseTree>
13895
13896 =back
13897
13898 =over 4
13899
13900 =item B<Pod::InputSource>
13901
13902 =back
13903
13904 =over 4
13905
13906 =item B<new()>
13907
13908 =back
13909
13910 =over 4
13911
13912 =item B<name()>
13913
13914 =back
13915
13916 =over 4
13917
13918 =item B<handle()>
13919
13920 =back
13921
13922 =over 4
13923
13924 =item B<was_cutting()>
13925
13926 =back
13927
13928 =over 4
13929
13930 =item B<Pod::Paragraph>
13931
13932 =back
13933
13934 =over 4
13935
13936 =item Pod::Paragraph-E<gt>B<new()>
13937
13938 =back
13939
13940 =over 4
13941
13942 =item $pod_para-E<gt>B<cmd_name()>
13943
13944 =back
13945
13946 =over 4
13947
13948 =item $pod_para-E<gt>B<text()>
13949
13950 =back
13951
13952 =over 4
13953
13954 =item $pod_para-E<gt>B<raw_text()>
13955
13956 =back
13957
13958 =over 4
13959
13960 =item $pod_para-E<gt>B<cmd_prefix()>
13961
13962 =back
13963
13964 =over 4
13965
13966 =item $pod_para-E<gt>B<cmd_separator()>
13967
13968 =back
13969
13970 =over 4
13971
13972 =item $pod_para-E<gt>B<parse_tree()>
13973
13974 =back
13975
13976 =over 4
13977
13978 =item $pod_para-E<gt>B<file_line()>
13979
13980 =back
13981
13982 =over 4
13983
13984 =item B<Pod::InteriorSequence>
13985
13986 =back
13987
13988 =over 4
13989
13990 =item Pod::InteriorSequence-E<gt>B<new()>
13991
13992 =back
13993
13994 =over 4
13995
13996 =item $pod_seq-E<gt>B<cmd_name()>
13997
13998 =back
13999
14000 =over 4
14001
14002 =item $pod_seq-E<gt>B<prepend()>
14003
14004 =back
14005
14006 =over 4
14007
14008 =item $pod_seq-E<gt>B<append()>
14009
14010 =back
14011
14012 =over 4
14013
14014 =item $pod_seq-E<gt>B<nested()>
14015
14016 =back
14017
14018 =over 4
14019
14020 =item $pod_seq-E<gt>B<raw_text()>
14021
14022 =back
14023
14024 =over 4
14025
14026 =item $pod_seq-E<gt>B<left_delimiter()>
14027
14028 =back
14029
14030 =over 4
14031
14032 =item $pod_seq-E<gt>B<right_delimiter()>
14033
14034 =back
14035
14036 =over 4
14037
14038 =item $pod_seq-E<gt>B<parse_tree()>
14039
14040 =back
14041
14042 =over 4
14043
14044 =item $pod_seq-E<gt>B<file_line()>
14045
14046 =back
14047
14048 =over 4
14049
14050 =item Pod::InteriorSequence::B<DESTROY()>
14051
14052 =back
14053
14054 =over 4
14055
14056 =item B<Pod::ParseTree>
14057
14058 =back
14059
14060 =over 4
14061
14062 =item Pod::ParseTree-E<gt>B<new()>
14063
14064 =back
14065
14066 =over 4
14067
14068 =item $ptree-E<gt>B<top()>
14069
14070 =back
14071
14072 =over 4
14073
14074 =item $ptree-E<gt>B<children()>
14075
14076 =back
14077
14078 =over 4
14079
14080 =item $ptree-E<gt>B<prepend()>
14081
14082 =back
14083
14084 =over 4
14085
14086 =item $ptree-E<gt>B<append()>
14087
14088 =back
14089
14090 =over 4
14091
14092 =item $ptree-E<gt>B<raw_text()>
14093
14094 =back
14095
14096 =over 4
14097
14098 =item Pod::ParseTree::B<DESTROY()>
14099
14100 =back
14101
14102 =over 4
14103
14104 =item SEE ALSO
14105
14106 =item AUTHOR
14107
14108 =back
14109
14110 =head2 Pod::LaTeX - Convert Pod data to formatted Latex
14111
14112 =over 4
14113
14114 =item SYNOPSIS
14115
14116 =item DESCRIPTION
14117
14118 =back
14119
14120 =over 4
14121
14122 =item OBJECT METHODS
14123
14124 C<initialize>
14125
14126 =back
14127
14128 =over 4
14129
14130 =item Data Accessors
14131
14132 B<AddPreamble>
14133
14134 =back
14135
14136 B<AddPostamble>
14137
14138 B<Head1Level>
14139
14140 B<Label>
14141
14142 B<LevelNoNum>
14143
14144 B<MakeIndex>
14145
14146 B<ReplaceNAMEwithSection>
14147
14148 B<StartWithNewPage>
14149
14150 B<TableOfContents>
14151
14152 B<UniqueLabels>
14153
14154 B<UserPreamble>
14155
14156 B<UserPostamble>
14157
14158 B<Lists>
14159
14160 =over 4
14161
14162 =item Subclassed methods
14163
14164 =back
14165
14166 B<begin_pod>
14167
14168 B<end_pod>
14169
14170 B<command>
14171
14172 B<verbatim>
14173
14174 B<textblock>
14175
14176 B<interior_sequence>
14177
14178 =over 4
14179
14180 =item List Methods
14181
14182 B<begin_list>
14183
14184 =back
14185
14186 B<end_list>
14187
14188 B<add_item>
14189
14190 =over 4
14191
14192 =item Methods for headings
14193
14194 B<head>
14195
14196 =back
14197
14198 =over 4
14199
14200 =item Internal methods
14201
14202 B<_output>
14203
14204 =back
14205
14206 B<_replace_special_chars>
14207
14208 B<_create_label>
14209
14210 B<_create_index>
14211
14212 B<_clean_latex_commands>
14213
14214 =over 4
14215
14216 =item NOTES
14217
14218 =item SEE ALSO
14219
14220 =item AUTHORS
14221
14222 =item COPYRIGHT
14223
14224 =item REVISION
14225
14226 =back
14227
14228 =head2 Pod::Man - Convert POD data to formatted *roff input
14229
14230 =over 4
14231
14232 =item SYNOPSIS
14233
14234 =item DESCRIPTION
14235
14236 center, date, fixed, fixedbold, fixeditalic, fixedbolditalic, quotes,
14237 release, section
14238
14239 =item DIAGNOSTICS
14240
14241 roff font should be 1 or 2 chars, not "%s", Invalid link %s, Invalid quote
14242 specification "%s", %s:%d: Unknown command paragraph "%s", %s:%d: Unknown
14243 escape EE<lt>%sE<gt>, %s:%d: Unknown sequence %s, %s:%d: Unmatched =back
14244
14245 =item BUGS
14246
14247 =item SEE ALSO
14248
14249 =item AUTHOR
14250
14251 =item COPYRIGHT AND LICENSE
14252
14253 =back
14254
14255 =head2 Pod::ParseUtils - helpers for POD parsing and conversion
14256
14257 =over 4
14258
14259 =item SYNOPSIS
14260
14261 =item DESCRIPTION
14262
14263 =back
14264
14265 =over 4
14266
14267 =item Pod::List
14268
14269 Pod::List-E<gt>new()
14270
14271 =back
14272
14273 $list-E<gt>file()
14274
14275 $list-E<gt>start()
14276
14277 $list-E<gt>indent()
14278
14279 $list-E<gt>type()
14280
14281 $list-E<gt>rx()
14282
14283 $list-E<gt>item()
14284
14285 $list-E<gt>parent()
14286
14287 $list-E<gt>tag()
14288
14289 =over 4
14290
14291 =item Pod::Hyperlink
14292
14293 Pod::Hyperlink-E<gt>new()
14294
14295 =back
14296
14297 $link-E<gt>parse($string)
14298
14299 $link-E<gt>markup($string)
14300
14301 $link-E<gt>text()
14302
14303 $link-E<gt>warning()
14304
14305 $link-E<gt>file(), $link-E<gt>line()
14306
14307 $link-E<gt>page()
14308
14309 $link-E<gt>node()
14310
14311 $link-E<gt>alttext()
14312
14313 $link-E<gt>type()
14314
14315 $link-E<gt>link()
14316
14317 =over 4
14318
14319 =item Pod::Cache
14320
14321 Pod::Cache-E<gt>new()
14322
14323 =back
14324
14325 $cache-E<gt>item()
14326
14327 $cache-E<gt>find_page($name)
14328
14329 =over 4
14330
14331 =item Pod::Cache::Item
14332
14333 Pod::Cache::Item-E<gt>new()
14334
14335 =back
14336
14337 $cacheitem-E<gt>page()
14338
14339 $cacheitem-E<gt>description()
14340
14341 $cacheitem-E<gt>path()
14342
14343 $cacheitem-E<gt>file()
14344
14345 $cacheitem-E<gt>nodes()
14346
14347 $cacheitem-E<gt>find_node($name)
14348
14349 $cacheitem-E<gt>idx()
14350
14351 =over 4
14352
14353 =item AUTHOR
14354
14355 =item SEE ALSO
14356
14357 =back
14358
14359 =head2 Pod::Parser - base class for creating POD filters and translators
14360
14361 =over 4
14362
14363 =item SYNOPSIS
14364
14365 =item REQUIRES
14366
14367 =item EXPORTS
14368
14369 =item DESCRIPTION
14370
14371 =item QUICK OVERVIEW
14372
14373 =item PARSING OPTIONS
14374
14375 B<-want_nonPODs> (default: unset), B<-process_cut_cmd> (default: unset),
14376 B<-warnings> (default: unset)
14377
14378 =back
14379
14380 =over 4
14381
14382 =item RECOMMENDED SUBROUTINE/METHOD OVERRIDES
14383
14384 =back
14385
14386 =over 4
14387
14388 =item B<command()>
14389
14390 C<$cmd>, C<$text>, C<$line_num>, C<$pod_para>
14391
14392 =back
14393
14394 =over 4
14395
14396 =item B<verbatim()>
14397
14398 C<$text>, C<$line_num>, C<$pod_para>
14399
14400 =back
14401
14402 =over 4
14403
14404 =item B<textblock()>
14405
14406 C<$text>, C<$line_num>, C<$pod_para>
14407
14408 =back
14409
14410 =over 4
14411
14412 =item B<interior_sequence()>
14413
14414 =back
14415
14416 =over 4
14417
14418 =item OPTIONAL SUBROUTINE/METHOD OVERRIDES
14419
14420 =back
14421
14422 =over 4
14423
14424 =item B<new()>
14425
14426 =back
14427
14428 =over 4
14429
14430 =item B<initialize()>
14431
14432 =back
14433
14434 =over 4
14435
14436 =item B<begin_pod()>
14437
14438 =back
14439
14440 =over 4
14441
14442 =item B<begin_input()>
14443
14444 =back
14445
14446 =over 4
14447
14448 =item B<end_input()>
14449
14450 =back
14451
14452 =over 4
14453
14454 =item B<end_pod()>
14455
14456 =back
14457
14458 =over 4
14459
14460 =item B<preprocess_line()>
14461
14462 =back
14463
14464 =over 4
14465
14466 =item B<preprocess_paragraph()>
14467
14468 =back
14469
14470 =over 4
14471
14472 =item METHODS FOR PARSING AND PROCESSING
14473
14474 =back
14475
14476 =over 4
14477
14478 =item B<parse_text()>
14479
14480 B<-expand_seq> =E<gt> I<code-ref>|I<method-name>, B<-expand_text> =E<gt>
14481 I<code-ref>|I<method-name>, B<-expand_ptree> =E<gt>
14482 I<code-ref>|I<method-name>
14483
14484 =back
14485
14486 =over 4
14487
14488 =item B<interpolate()>
14489
14490 =back
14491
14492 =over 4
14493
14494 =item B<parse_paragraph()>
14495
14496 =back
14497
14498 =over 4
14499
14500 =item B<parse_from_filehandle()>
14501
14502 =back
14503
14504 =over 4
14505
14506 =item B<parse_from_file()>
14507
14508 =back
14509
14510 =over 4
14511
14512 =item ACCESSOR METHODS
14513
14514 =back
14515
14516 =over 4
14517
14518 =item B<errorsub()>
14519
14520 =back
14521
14522 =over 4
14523
14524 =item B<cutting()>
14525
14526 =back
14527
14528 =over 4
14529
14530 =item B<parseopts()>
14531
14532 =back
14533
14534 =over 4
14535
14536 =item B<output_file()>
14537
14538 =back
14539
14540 =over 4
14541
14542 =item B<output_handle()>
14543
14544 =back
14545
14546 =over 4
14547
14548 =item B<input_file()>
14549
14550 =back
14551
14552 =over 4
14553
14554 =item B<input_handle()>
14555
14556 =back
14557
14558 =over 4
14559
14560 =item B<input_streams()>
14561
14562 =back
14563
14564 =over 4
14565
14566 =item B<top_stream()>
14567
14568 =back
14569
14570 =over 4
14571
14572 =item PRIVATE METHODS AND DATA
14573
14574 =back
14575
14576 =over 4
14577
14578 =item B<_push_input_stream()>
14579
14580 =back
14581
14582 =over 4
14583
14584 =item B<_pop_input_stream()>
14585
14586 =back
14587
14588 =over 4
14589
14590 =item TREE-BASED PARSING
14591
14592 =item SEE ALSO
14593
14594 =item AUTHOR
14595
14596 =back
14597
14598 =head2 Pod::Plainer - Perl extension for converting Pod to old style Pod.
14599
14600 =over 4
14601
14602 =item SYNOPSIS
14603
14604 =item DESCRIPTION
14605
14606 =over 4
14607
14608 =item EXPORT
14609
14610 =back
14611
14612 =item AUTHOR
14613
14614 =item SEE ALSO
14615
14616 =back
14617
14618 =head2 Pod::Select, podselect() - extract selected sections of POD from
14619 input
14620
14621 =over 4
14622
14623 =item SYNOPSIS
14624
14625 =item REQUIRES
14626
14627 =item EXPORTS
14628
14629 =item DESCRIPTION
14630
14631 =item SECTION SPECIFICATIONS
14632
14633 =item RANGE SPECIFICATIONS
14634
14635 =back
14636
14637 =over 4
14638
14639 =item OBJECT METHODS
14640
14641 =back
14642
14643 =over 4
14644
14645 =item B<curr_headings()>
14646
14647 =back
14648
14649 =over 4
14650
14651 =item B<select()>
14652
14653 =back
14654
14655 =over 4
14656
14657 =item B<add_selection()>
14658
14659 =back
14660
14661 =over 4
14662
14663 =item B<clear_selections()>
14664
14665 =back
14666
14667 =over 4
14668
14669 =item B<match_section()>
14670
14671 =back
14672
14673 =over 4
14674
14675 =item B<is_selected()>
14676
14677 =back
14678
14679 =over 4
14680
14681 =item EXPORTED FUNCTIONS
14682
14683 =back
14684
14685 =over 4
14686
14687 =item B<podselect()>
14688
14689 B<-output>, B<-sections>, B<-ranges>
14690
14691 =back
14692
14693 =over 4
14694
14695 =item PRIVATE METHODS AND DATA
14696
14697 =back
14698
14699 =over 4
14700
14701 =item B<_compile_section_spec()>
14702
14703 =back
14704
14705 =over 4
14706
14707 =item $self->{_SECTION_HEADINGS}
14708
14709 =back
14710
14711 =over 4
14712
14713 =item $self->{_SELECTED_SECTIONS}
14714
14715 =back
14716
14717 =over 4
14718
14719 =item SEE ALSO
14720
14721 =item AUTHOR
14722
14723 =back
14724
14725 =head2 Pod::Text - Convert POD data to formatted ASCII text
14726
14727 =over 4
14728
14729 =item SYNOPSIS
14730
14731 =item DESCRIPTION
14732
14733 alt, indent, loose, quotes, sentence, width
14734
14735 =item DIAGNOSTICS
14736
14737 Bizarre space in item, Can't open %s for reading: %s, Invalid quote
14738 specification "%s", %s:%d: Unknown command paragraph "%s", Unknown escape:
14739 %s, Unknown sequence: %s, Unmatched =back
14740
14741 =item RESTRICTIONS
14742
14743 =item NOTES
14744
14745 =item SEE ALSO
14746
14747 =item AUTHOR
14748
14749 =item COPYRIGHT AND LICENSE
14750
14751 =back
14752
14753 =head2 Pod::Text::Color - Convert POD data to formatted color ASCII text
14754
14755 =over 4
14756
14757 =item SYNOPSIS
14758
14759 =item DESCRIPTION
14760
14761 =item BUGS
14762
14763 =item SEE ALSO
14764
14765 =item AUTHOR
14766
14767 =item COPYRIGHT AND LICENSE
14768
14769 =back
14770
14771 =head2 Pod::Text::Overstrike - Convert POD data to formatted overstrike
14772 text
14773
14774 =over 4
14775
14776 =item SYNOPSIS
14777
14778 =item DESCRIPTION
14779
14780 =item BUGS
14781
14782 =item SEE ALSO
14783
14784 =item AUTHOR
14785
14786 =item COPYRIGHT AND LICENSE
14787
14788 =back
14789
14790 =head2 Pod::Text::Termcap, Pod::Text::Color - Convert POD data to ASCII
14791 text with format escapes
14792
14793 =over 4
14794
14795 =item SYNOPSIS
14796
14797 =item DESCRIPTION
14798
14799 =item SEE ALSO
14800
14801 =item AUTHOR
14802
14803 =item COPYRIGHT AND LICENSE
14804
14805 =back
14806
14807 =head2 Pod::Usage, pod2usage() - print a usage message from embedded pod
14808 documentation
14809
14810 =over 4
14811
14812 =item SYNOPSIS
14813
14814 =item ARGUMENTS
14815
14816 C<-message>, C<-msg>, C<-exitval>, C<-verbose>, C<-output>, C<-input>,
14817 C<-pathlist>
14818
14819 =item DESCRIPTION
14820
14821 =item EXAMPLES
14822
14823 =over 4
14824
14825 =item Recommended Use
14826
14827 =back
14828
14829 =item CAVEATS
14830
14831 =item AUTHOR
14832
14833 =item ACKNOWLEDGEMENTS
14834
14835 =back
14836
14837 =head2 SDBM_File - Tied access to sdbm files
14838
14839 =over 4
14840
14841 =item SYNOPSIS
14842
14843 =item DESCRIPTION
14844
14845 C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR>
14846
14847 =item DIAGNOSTICS
14848
14849 =over 4
14850
14851 =item C<sdbm store returned -1, errno 22, key "..." at ...>
14852
14853 =back
14854
14855 =item BUGS AND WARNINGS
14856
14857 =back
14858
14859 =head2 Safe - Compile and execute code in restricted compartments
14860
14861 =over 4
14862
14863 =item SYNOPSIS
14864
14865 =item DESCRIPTION
14866
14867 a new namespace, an operator mask
14868
14869 =item WARNING
14870
14871 =over 4
14872
14873 =item RECENT CHANGES
14874
14875 =item Methods in class Safe
14876
14877 permit (OP, ...), permit_only (OP, ...), deny (OP, ...), deny_only (OP,
14878 ...), trap (OP, ...), untrap (OP, ...), share (NAME, ...), share_from
14879 (PACKAGE, ARRAYREF), varglob (VARNAME), reval (STRING), rdo (FILENAME),
14880 root (NAMESPACE), mask (MASK)
14881
14882 =item Some Safety Issues
14883
14884 Memory, CPU, Snooping, Signals, State Changes
14885
14886 =item AUTHOR
14887
14888 =back
14889
14890 =back
14891
14892 =head2 Scalar::Util - A selection of general-utility scalar subroutines
14893
14894 =over 4
14895
14896 =item SYNOPSIS
14897
14898 =item DESCRIPTION
14899
14900 blessed EXPR, dualvar NUM, STRING, isweak EXPR, readonly SCALAR, reftype
14901 EXPR, tainted EXPR, weaken REF
14902
14903 =item COPYRIGHT
14904
14905 =item BLATANT PLUG
14906
14907 =back
14908
14909 =head2 Search::Dict, look - search for key in dictionary file
14910
14911 =over 4
14912
14913 =item SYNOPSIS
14914
14915 =item DESCRIPTION
14916
14917 =back
14918
14919 =head2 SelectSaver - save and restore selected file handle
14920
14921 =over 4
14922
14923 =item SYNOPSIS
14924
14925 =item DESCRIPTION
14926
14927 =back
14928
14929 =head2 SelfLoader - load functions only on demand
14930
14931 =over 4
14932
14933 =item SYNOPSIS
14934
14935 =item DESCRIPTION
14936
14937 =over 4
14938
14939 =item The __DATA__ token
14940
14941 =item SelfLoader autoloading
14942
14943 =item Autoloading and package lexicals
14944
14945 =item SelfLoader and AutoLoader
14946
14947 =item __DATA__, __END__, and the FOOBAR::DATA filehandle.
14948
14949 =item Classes and inherited methods.
14950
14951 =back
14952
14953 =item Multiple packages and fully qualified subroutine names
14954
14955 =back
14956
14957 =head2 Shell - run shell commands transparently within perl
14958
14959 =over 4
14960
14961 =item SYNOPSIS
14962
14963 =item DESCRIPTION
14964
14965 =over 4
14966
14967 =item OBJECT ORIENTED SYNTAX
14968
14969 =back
14970
14971 =item AUTHOR
14972
14973 =back
14974
14975 =head2 Socket, sockaddr_in, sockaddr_un, inet_aton, inet_ntoa - load the C
14976 socket.h defines and structure manipulators
14977
14978 =over 4
14979
14980 =item SYNOPSIS
14981
14982 =item DESCRIPTION
14983
14984 inet_aton HOSTNAME, inet_ntoa IP_ADDRESS, INADDR_ANY, INADDR_BROADCAST,
14985 INADDR_LOOPBACK, INADDR_NONE, sockaddr_in PORT, ADDRESS, sockaddr_in
14986 SOCKADDR_IN, pack_sockaddr_in PORT, IP_ADDRESS, unpack_sockaddr_in
14987 SOCKADDR_IN, sockaddr_un PATHNAME, sockaddr_un SOCKADDR_UN,
14988 pack_sockaddr_un PATH, unpack_sockaddr_un SOCKADDR_UN
14989
14990 =back
14991
14992 =head2 Storable - persistency for perl data structures
14993
14994 =over 4
14995
14996 =item SYNOPSIS
14997
14998 =item DESCRIPTION
14999
15000 =item MEMORY STORE
15001
15002 =item ADVISORY LOCKING
15003
15004 =item SPEED
15005
15006 =item CANONICAL REPRESENTATION
15007
15008 =item ERROR REPORTING
15009
15010 =item WIZARDS ONLY
15011
15012 =over 4
15013
15014 =item Hooks
15015
15016 C<STORABLE_freeze> I<obj>, I<cloning>, C<STORABLE_thaw> I<obj>, I<cloning>,
15017 I<serialized>, ..
15018
15019 =item Predicates
15020
15021 C<Storable::last_op_in_netorder>, C<Storable::is_storing>,
15022 C<Storable::is_retrieving>
15023
15024 =item Recursion
15025
15026 =item Deep Cloning
15027
15028 =back
15029
15030 =item EXAMPLES
15031
15032 =item WARNING
15033
15034 =item BUGS
15035
15036 =item CREDITS
15037
15038 =item TRANSLATIONS
15039
15040 =item AUTHOR
15041
15042 =item SEE ALSO
15043
15044 =back
15045
15046 =head2 Switch - A switch statement for Perl
15047
15048 =over 4
15049
15050 =item VERSION
15051
15052 =item SYNOPSIS
15053
15054 =item BACKGROUND
15055
15056 =item DESCRIPTION
15057
15058 =over 4
15059
15060 =item Allowing fall-through
15061
15062 =item Automating fall-through
15063
15064 =item Alternative syntax
15065
15066 =item Higher-order Operations
15067
15068 =back
15069
15070 =item DEPENDENCIES
15071
15072 =item AUTHOR
15073
15074 =item BUGS
15075
15076 =item COPYRIGHT
15077
15078 =back
15079
15080 =head2 Symbol - manipulate Perl symbols and their names
15081
15082 =over 4
15083
15084 =item SYNOPSIS
15085
15086 =item DESCRIPTION
15087
15088 =back
15089
15090 =head2 Sys::Hostname - Try every conceivable way to get hostname
15091
15092 =over 4
15093
15094 =item SYNOPSIS
15095
15096 =item DESCRIPTION
15097
15098 =item AUTHOR
15099
15100 =back
15101
15102 =head2 Syslog, Sys::Syslog, openlog, closelog, setlogmask, syslog - Perl
15103 interface to the UNIX syslog(3) calls
15104
15105 =over 4
15106
15107 =item SYNOPSIS
15108
15109 =item DESCRIPTION
15110
15111 openlog $ident, $logopt, $facility, syslog $priority, $format, @args,
15112 setlogmask $mask_priority, setlogsock $sock_type (added in 5.004_02),
15113 closelog
15114
15115 =item EXAMPLES
15116
15117 =item SEE ALSO
15118
15119 =item AUTHOR
15120
15121 =back
15122
15123 =head2 Syslog::Syslog, Sys::Syslog, openlog, closelog, setlogmask, syslog -
15124 Perl interface to the UNIX syslog(3) calls
15125
15126 =over 4
15127
15128 =item SYNOPSIS
15129
15130 =item DESCRIPTION
15131
15132 openlog $ident, $logopt, $facility, syslog $priority, $format, @args,
15133 setlogmask $mask_priority, setlogsock $sock_type (added in 5.004_02),
15134 closelog
15135
15136 =item EXAMPLES
15137
15138 =item SEE ALSO
15139
15140 =item AUTHOR
15141
15142 =back
15143
15144 =head2 Term::ANSIColor - Color screen output using ANSI escape sequences
15145
15146 =over 4
15147
15148 =item SYNOPSIS
15149
15150 =item DESCRIPTION
15151
15152 =item DIAGNOSTICS
15153
15154 Bad escape sequence %s, Bareword "%s" not allowed while "strict subs" in
15155 use, Invalid attribute name %s, Name "%s" used only once: possible typo, No
15156 comma allowed after filehandle, No name for escape sequence %s
15157
15158 =item ENVIRONMENT
15159
15160 ANSI_COLORS_DISABLED
15161
15162 =item RESTRICTIONS
15163
15164 =item NOTES
15165
15166 =item SEE ALSO
15167
15168 =item AUTHORS
15169
15170 =item LICENSE
15171
15172 =back
15173
15174 =head2 Term::Cap - Perl termcap interface
15175
15176 =over 4
15177
15178 =item SYNOPSIS
15179
15180 =item DESCRIPTION
15181
15182 =item EXAMPLES
15183
15184 =back
15185
15186 =head2 Term::Complete - Perl word completion module
15187
15188 =over 4
15189
15190 =item SYNOPSIS
15191
15192 =item DESCRIPTION
15193
15194 E<lt>tabE<gt>, ^D, ^U, E<lt>delE<gt>, E<lt>bsE<gt>
15195
15196 =item DIAGNOSTICS
15197
15198 =item BUGS
15199
15200 =item AUTHOR
15201
15202 =back
15203
15204 =head2 Term::ReadLine - Perl interface to various C<readline> packages. If
15205 no real package is found, substitutes stubs instead of basic functions.
15206
15207 =over 4
15208
15209 =item SYNOPSIS
15210
15211 =item DESCRIPTION
15212
15213 =item Minimal set of supported functions
15214
15215 C<ReadLine>, C<new>, C<readline>, C<addhistory>, C<IN>, $C<OUT>,
15216 C<MinLine>, C<findConsole>, Attribs, C<Features>
15217
15218 =item Additional supported functions
15219
15220 C<tkRunning>, C<ornaments>, C<newTTY>
15221
15222 =item EXPORTS
15223
15224 =item ENVIRONMENT
15225
15226 =item CAVEATS
15227
15228 =back
15229
15230 =head2 Test - provides a simple framework for writing test scripts
15231
15232 =over 4
15233
15234 =item SYNOPSIS
15235
15236 =item DESCRIPTION
15237
15238 =over 4
15239
15240 =item Functions
15241
15242 B<plan>
15243
15244 =back
15245
15246 =back
15247
15248 B<_to_value>
15249
15250 B<ok>
15251
15252 =over 4
15253
15254 =item TEST TYPES
15255
15256 NORMAL TESTS, SKIPPED TESTS, TODO TESTS
15257
15258 =item ONFAIL
15259
15260 =item BUGS and CAVEATS
15261
15262 =item TODO
15263
15264 =item SEE ALSO
15265
15266 =item AUTHOR
15267
15268 =back
15269
15270 =head2 Test::Harness - run perl standard test scripts with statistics
15271
15272 =over 4
15273
15274 =item SYNOPSIS
15275
15276 =item DESCRIPTION
15277
15278 =over 4
15279
15280 =item The test script output
15281
15282 B<'1..M'>, B<'ok', 'not ok'.  Ok?>, B<test numbers>,
15283 B<$Test::Harness::verbose>, B<$Test::Harness::switches>, B<Skipping tests>,
15284 B<Todo tests>, B<Bail out!>, B<Comments>, B<Anything else>
15285
15286 =item Failure
15287
15288 B<Failed Test>, B<Stat>, B<Wstat>, B<Total>, B<Fail>, B<Failed>, B<List of
15289 Failed>
15290
15291 =item Functions
15292
15293 B<runtests>
15294
15295 =back
15296
15297 =back
15298
15299 B<_all_ok>
15300
15301 B<_globdir>
15302
15303 B<_run_all_tests>
15304
15305 B<_mk_leader>
15306
15307 =over 4
15308
15309 =item EXPORT
15310
15311 =item DIAGNOSTICS
15312
15313 C<All tests successful.\nFiles=%d,  Tests=%d, %s>, C<FAILED tests
15314 %s\n\tFailed %d/%d tests, %.2f%% okay.>, C<Test returned status %d (wstat
15315 %d)>, C<Failed 1 test, %.2f%% okay. %s>, C<Failed %d/%d tests, %.2f%% okay.
15316 %s>, C<FAILED--Further testing stopped%s>
15317
15318 =item ENVIRONMENT
15319
15320 C<HARNESS_IGNORE_EXITCODE>, C<HARNESS_NOTTY>, C<HARNESS_COMPILE_TEST>,
15321 C<HARNESS_FILELEAK_IN_DIR>, C<HARNESS_PERL_SWITCHES>, C<HARNESS_COLUMNS>,
15322 C<HARNESS_ACTIVE>
15323
15324 =item EXAMPLE
15325
15326 =item SEE ALSO
15327
15328 =item AUTHORS
15329
15330 =item TODO
15331
15332 =item BUGS
15333
15334 =back
15335
15336 =head2 Test::More - yet another framework for writing test scripts
15337
15338 =over 4
15339
15340 =item SYNOPSIS
15341
15342 =item DESCRIPTION
15343
15344 =over 4
15345
15346 =item I love it when a plan comes together
15347
15348 =item Test names
15349
15350 =item I'm ok, you're not ok.
15351
15352 B<ok>
15353
15354 =back
15355
15356 =back
15357
15358 B<is>, B<isnt>
15359
15360 B<like>
15361
15362 B<can_ok>
15363
15364 B<isa_ok>
15365
15366 B<pass>, B<fail>
15367
15368 =over 4
15369
15370 =item Module tests
15371
15372 B<use_ok>
15373
15374 =back
15375
15376 B<require_ok>
15377
15378 =over 4
15379
15380 =item Conditional tests
15381
15382 B<SKIP: BLOCK>
15383
15384 =back
15385
15386 B<TODO: BLOCK>
15387
15388 =over 4
15389
15390 =item Comparision functions
15391
15392 B<eq_array>
15393
15394 =back
15395
15396 B<eq_hash>
15397
15398 B<eq_set>
15399
15400 =over 4
15401
15402 =item NOTES
15403
15404 =item BUGS and CAVEATS
15405
15406 Making your own ok(), The eq_* family have some caveats, Test::Harness
15407 upgrades
15408
15409 =item AUTHOR
15410
15411 =item HISTORY
15412
15413 =item SEE ALSO
15414
15415 =back
15416
15417 =head2 Test::Simple - Basic utilities for writing tests.
15418
15419 =over 4
15420
15421 =item SYNOPSIS
15422
15423 =item DESCRIPTION
15424
15425 B<ok>
15426
15427 =back
15428
15429 B<_sanity_check>
15430
15431 B<_whoa>
15432
15433 B<_my_exit>
15434
15435 =over 4
15436
15437 =item EXAMPLE
15438
15439 =item CAVEATS
15440
15441 =item NOTES
15442
15443 =item HISTORY
15444
15445 =item AUTHOR
15446
15447 =item SEE ALSO
15448
15449 L<Test::More>, L<Test>, L<Test::Unit>, L<Pod::Tests>, L<SelfTest>,
15450 L<Test::Harness>
15451
15452 =back
15453
15454 =head2 Test::Tutorial - A tutorial about writing really basic tests
15455
15456 =over 4
15457
15458 =item DESCRIPTION
15459
15460 =over 4
15461
15462 =item Nuts and bolts of testing.
15463
15464 =item Where to start?
15465
15466 =item Names
15467
15468 =item Test the manual
15469
15470 =item Sometimes the tests are wrong
15471
15472 =item Testing lots of values
15473
15474 =item Informative names
15475
15476 =item Skipping tests
15477
15478 =item Todo tests
15479
15480 =item Testing with taint mode.
15481
15482 =back
15483
15484 =item FOOTNOTES
15485
15486 =back
15487
15488 =head2 Text::Abbrev, abbrev - create an abbreviation table from a list
15489
15490 =over 4
15491
15492 =item SYNOPSIS
15493
15494 =item DESCRIPTION
15495
15496 =item EXAMPLE
15497
15498 =back
15499
15500 =head2 Text::Balanced - Extract delimited text sequences from strings.
15501
15502 =over 4
15503
15504 =item SYNOPSIS
15505
15506 =item DESCRIPTION
15507
15508 =over 4
15509
15510 =item General behaviour in list contexts
15511
15512 [0], [1], [2]
15513
15514 =item General behaviour in scalar and void contexts
15515
15516 =item A note about prefixes
15517
15518 =item C<extract_delimited>
15519
15520 =item C<extract_bracketed>
15521
15522 =item C<extract_tagged>
15523
15524 C<reject =E<gt> $listref>, C<ignore =E<gt> $listref>, C<fail =E<gt> $str>,
15525 [0], [1], [2], [3], [4], [5]
15526
15527 =item C<gen_extract_tagged>
15528
15529 =item C<extract_quotelike>
15530
15531 [0], [1], [2], [3], [4], [5], [6], [7], [8], [9], [10]
15532
15533 =item C<extract_quotelike> and "here documents"
15534
15535 [0], [1], [2], [3], [4], [5], [6], [7..10]
15536
15537 =item C<extract_codeblock>
15538
15539 =item C<extract_multiple>
15540
15541 =item C<gen_delimited_pat>
15542
15543 =back
15544
15545 =item DIAGNOSTICS
15546
15547  C<Did not find a suitable bracket: "%s">,  C<Did not find prefix: /%s/>,
15548 C<Did not find opening bracket after prefix: "%s">,  C<No quotelike
15549 operator found after prefix: "%s">,  C<Unmatched closing bracket: "%c">,
15550 C<Unmatched opening bracket(s): "%s">, C<Unmatched embedded quote (%s)>,
15551 C<Did not find closing delimiter to match '%s'>,  C<Mismatched closing
15552 bracket: expected "%c" but found "%s">,  C<No block delimiter found after
15553 quotelike "%s">, C<Did not find leading dereferencer>, C<Bad identifier
15554 after dereferencer>, C<Did not find expected opening bracket at %s>,
15555 C<Improperly nested codeblock at %s>,  C<Missing second block for quotelike
15556 "%s">, C<No match found for opening bracket>, C<Did not find opening tag:
15557 /%s/>, C<Unable to construct closing tag to match: /%s/>, C<Found invalid
15558 nested tag: %s>, C<Found unbalanced nested tag: %s>, C<Did not find closing
15559 tag>
15560
15561 =item AUTHOR
15562
15563 =item BUGS AND IRRITATIONS
15564
15565 =item COPYRIGHT
15566
15567 =back
15568
15569 =head2 Text::ParseWords - parse text into an array of tokens or array of
15570 arrays
15571
15572 =over 4
15573
15574 =item SYNOPSIS
15575
15576 =item DESCRIPTION
15577
15578 =item EXAMPLES
15579
15580 =item AUTHORS
15581
15582 =back
15583
15584 =head2 Text::Soundex - Implementation of the Soundex Algorithm as Described
15585 by Knuth
15586
15587 =over 4
15588
15589 =item SYNOPSIS
15590
15591 =item DESCRIPTION
15592
15593 =item EXAMPLES
15594
15595 =item LIMITATIONS
15596
15597 =item AUTHOR
15598
15599 =back
15600
15601 =head2 Text::Tabs -- expand and unexpand tabs per the unix expand(1) and
15602 unexpand(1)
15603
15604 =over 4
15605
15606 =item SYNOPSIS
15607
15608 =item DESCRIPTION
15609
15610 =item BUGS
15611
15612 =item AUTHOR
15613
15614 =back
15615
15616 =head2 Text::Wrap - line wrapping to form simple paragraphs
15617
15618 =over 4
15619
15620 =item SYNOPSIS
15621
15622 =item DESCRIPTION
15623
15624 =item EXAMPLE
15625
15626 =item AUTHOR
15627
15628 =back
15629
15630 =head2 Thread - manipulate threads in Perl (EXPERIMENTAL, subject to
15631 change)
15632
15633 =over 4
15634
15635 =item CAVEAT
15636
15637 =item SYNOPSIS
15638
15639 =item DESCRIPTION
15640
15641 =item FUNCTIONS
15642
15643 new \&start_sub, new \&start_sub, LIST, lock VARIABLE, async BLOCK;,
15644 Thread->self, Thread->list, cond_wait VARIABLE, cond_signal VARIABLE,
15645 cond_broadcast VARIABLE, yield
15646
15647 =item METHODS
15648
15649 join, eval, detach, equal, tid, flags, done
15650
15651 =item LIMITATIONS
15652
15653 =item SEE ALSO
15654
15655 =back
15656
15657 =head2 Thread::Queue - thread-safe queues
15658
15659 =over 4
15660
15661 =item SYNOPSIS
15662
15663 =item DESCRIPTION
15664
15665 =item FUNCTIONS AND METHODS
15666
15667 new, enqueue LIST, dequeue, dequeue_nb, pending
15668
15669 =item SEE ALSO
15670
15671 =back
15672
15673 =head2 Thread::Semaphore - thread-safe semaphores
15674
15675 =over 4
15676
15677 =item SYNOPSIS
15678
15679 =item DESCRIPTION
15680
15681 =item FUNCTIONS AND METHODS
15682
15683 new, new NUMBER, down, down NUMBER, up, up NUMBER
15684
15685 =back
15686
15687 =head2 Thread::Signal - Start a thread which runs signal handlers reliably
15688
15689 =over 4
15690
15691 =item SYNOPSIS
15692
15693 =item DESCRIPTION
15694
15695 =item BUGS
15696
15697 =back
15698
15699 =head2 Thread::Specific - thread-specific keys
15700
15701 =over 4
15702
15703 =item SYNOPSIS
15704
15705 =item DESCRIPTION
15706
15707 =back
15708
15709 =head2 Tie::Array - base class for tied arrays
15710
15711 =over 4
15712
15713 =item SYNOPSIS
15714
15715 =item DESCRIPTION
15716
15717 TIEARRAY classname, LIST, STORE this, index, value, FETCH this, index,
15718 FETCHSIZE this, STORESIZE this, count, EXTEND this, count, EXISTS this,
15719 key, DELETE this, key, CLEAR this, DESTROY this, PUSH this, LIST, POP this,
15720 SHIFT this, UNSHIFT this, LIST, SPLICE this, offset, length, LIST
15721
15722 =item CAVEATS
15723
15724 =item AUTHOR
15725
15726 =back
15727
15728 =head2 Tie::Handle, Tie::StdHandle  - base class definitions for tied
15729 handles
15730
15731 =over 4
15732
15733 =item SYNOPSIS
15734
15735 =item DESCRIPTION
15736
15737 TIEHANDLE classname, LIST, WRITE this, scalar, length, offset, PRINT this,
15738 LIST, PRINTF this, format, LIST, READ this, scalar, length, offset,
15739 READLINE this, GETC this, CLOSE this, OPEN this, filename, BINMODE this,
15740 EOF this, TELL this, SEEK this, offset, whence, DESTROY this
15741
15742 =item MORE INFORMATION
15743
15744 =item COMPATIBILITY
15745
15746 =back
15747
15748 =head2 Tie::Hash, Tie::StdHash - base class definitions for tied hashes
15749
15750 =over 4
15751
15752 =item SYNOPSIS
15753
15754 =item DESCRIPTION
15755
15756 TIEHASH classname, LIST, STORE this, key, value, FETCH this, key, FIRSTKEY
15757 this, NEXTKEY this, lastkey, EXISTS this, key, DELETE this, key, CLEAR this
15758
15759 =item CAVEATS
15760
15761 =item MORE INFORMATION
15762
15763 =back
15764
15765 =head2 Tie::RefHash - use references as hash keys
15766
15767 =over 4
15768
15769 =item SYNOPSIS
15770
15771 =item DESCRIPTION
15772
15773 =item EXAMPLE
15774
15775 =item AUTHOR
15776
15777 =item VERSION
15778
15779 =item SEE ALSO
15780
15781 =back
15782
15783 =head2 Tie::Scalar, Tie::StdScalar - base class definitions for tied
15784 scalars
15785
15786 =over 4
15787
15788 =item SYNOPSIS
15789
15790 =item DESCRIPTION
15791
15792 TIESCALAR classname, LIST, FETCH this, STORE this, value, DESTROY this
15793
15794 =item MORE INFORMATION
15795
15796 =back
15797
15798 =head2 Tie::SubstrHash - Fixed-table-size, fixed-key-length hashing
15799
15800 =over 4
15801
15802 =item SYNOPSIS
15803
15804 =item DESCRIPTION
15805
15806 =item CAVEATS
15807
15808 =back
15809
15810 =head2 Time::HiRes - High resolution ualarm, usleep, and gettimeofday
15811
15812 =over 4
15813
15814 =item SYNOPSIS
15815
15816 =item DESCRIPTION
15817
15818 gettimeofday (), usleep ( $useconds ), ualarm ( $useconds [,
15819 $interval_useconds ] ), tv_interval, time (), sleep ( $floating_seconds ),
15820 alarm ( $floating_seconds [, $interval_floating_seconds ] ), setitimer,
15821 getitimer ( $which )
15822
15823 =item EXAMPLES
15824
15825 =item C API
15826
15827 =item CAVEATS
15828
15829 =item AUTHORS
15830
15831 =item REVISION
15832
15833 =item COPYRIGHT
15834
15835 =back
15836
15837 =head2 Time::Local - efficiently compute time from local and GMT time
15838
15839 =over 4
15840
15841 =item SYNOPSIS
15842
15843 =item DESCRIPTION
15844
15845 =item IMPLEMENTATION
15846
15847 =item BUGS
15848
15849 =back
15850
15851 =head2 Time::gmtime - by-name interface to Perl's built-in gmtime()
15852 function
15853
15854 =over 4
15855
15856 =item SYNOPSIS
15857
15858 =item DESCRIPTION
15859
15860 =item NOTE
15861
15862 =item AUTHOR
15863
15864 =back
15865
15866 =head2 Time::localtime - by-name interface to Perl's built-in localtime()
15867 function
15868
15869 =over 4
15870
15871 =item SYNOPSIS
15872
15873 =item DESCRIPTION
15874
15875 =item NOTE
15876
15877 =item AUTHOR
15878
15879 =back
15880
15881 =head2 Time::tm - internal object used by Time::gmtime and Time::localtime
15882
15883 =over 4
15884
15885 =item SYNOPSIS
15886
15887 =item DESCRIPTION
15888
15889 =item AUTHOR
15890
15891 =back
15892
15893 =head2 UNIVERSAL - base class for ALL classes (blessed references)
15894
15895 =over 4
15896
15897 =item SYNOPSIS
15898
15899 =item DESCRIPTION
15900
15901 isa ( TYPE ), can ( METHOD ), VERSION ( [ REQUIRE ] ), UNIVERSAL::isa (
15902 VAL, TYPE ), UNIVERSAL::can ( VAL, METHOD )
15903
15904 =back
15905
15906 =head2 Unicode::Collate - use UCA (Unicode Collation Algorithm)
15907
15908 =over 4
15909
15910 =item SYNOPSIS
15911
15912 =item DESCRIPTION
15913
15914 =over 4
15915
15916 =item Constructor and Tailoring
15917
15918 alternate, backwards, entry, ignoreName, ignoreChar, level, normalization,
15919 overrideCJK, overrideHangul, preprocess, rearrange, table, undefName,
15920 undefChar, katakana_before_hiragana, upper_before_lower
15921
15922 =item Other methods
15923
15924 C<@sorted = $UCA-E<gt>sort(@not_sorted)>, C<$result = $UCA-E<gt>cmp($a,
15925 $b)>, C<$sortKey = $UCA-E<gt>getSortKey($string)>, C<$position =
15926 $UCA-E<gt>index($string, $substring)>, C<($position, $length) =
15927 $UCA-E<gt>index($string, $substring)>
15928
15929 =item EXPORT
15930
15931 =item CAVEAT
15932
15933 =back
15934
15935 =item AUTHOR
15936
15937 =item SEE ALSO
15938
15939 L<Lingua::KO::Hangul::Util>, L<Unicode::Normalize>, Unicode Collation
15940 Algorithm - Unicode TR #10
15941
15942 =back
15943
15944 =head2 Unicode::Normalize - normalized forms of Unicode text
15945
15946 =over 4
15947
15948 =item SYNOPSIS
15949
15950 =item DESCRIPTION
15951
15952 C<$string_NFD = NFD($raw_string)>, C<$string_NFC = NFC($raw_string)>,
15953 C<$string_NFKD = NFKD($raw_string)>, C<$string_NFKC = NFKC($raw_string)>,
15954 C<$normalized_string = normalize($form_name, $raw_string)>
15955
15956 =over 4
15957
15958 =item EXPORT
15959
15960 =back
15961
15962 =item AUTHOR
15963
15964 =item SEE ALSO
15965
15966 L<Lingua::KO::Hangul::Util>, http://www.unicode.org/unicode/reports/tr15/
15967
15968 =back
15969
15970 =head2 Unicode::UCD - Unicode character database
15971
15972 =over 4
15973
15974 =item SYNOPSIS
15975
15976 =item DESCRIPTION
15977
15978 =back
15979
15980 =over 4
15981
15982 =item charinfo
15983
15984 =back
15985
15986 =over 4
15987
15988 =item charblock
15989
15990 =back
15991
15992 =over 4
15993
15994 =item charscript
15995
15996 =back
15997
15998 =over 4
15999
16000 =item charblocks
16001
16002 =back
16003
16004 =over 4
16005
16006 =item charscripts
16007
16008 =back
16009
16010 =over 4
16011
16012 =item Blocks versus Scripts
16013
16014 =item Matching Scripts and Blocks
16015
16016 =item Code Point Arguments
16017
16018 =item charinrange
16019
16020 =back
16021
16022 =over 4
16023
16024 =item compexcl
16025
16026 =back
16027
16028 =over 4
16029
16030 =item casefold
16031
16032 =back
16033
16034 =over 4
16035
16036 =item casespec
16037
16038 =back
16039
16040 =over 4
16041
16042 =item Unicode::UCD::UnicodeVersion
16043
16044 =back
16045
16046 =over 4
16047
16048 =item Implementation Note
16049
16050 =back
16051
16052 =over 4
16053
16054 =item AUTHOR
16055
16056 =back
16057
16058 =head2 User::grent - by-name interface to Perl's built-in getgr*()
16059 functions
16060
16061 =over 4
16062
16063 =item SYNOPSIS
16064
16065 =item DESCRIPTION
16066
16067 =item NOTE
16068
16069 =item AUTHOR
16070
16071 =back
16072
16073 =head2 User::pwent - by-name interface to Perl's built-in getpw*()
16074 functions
16075
16076 =over 4
16077
16078 =item SYNOPSIS
16079
16080 =item DESCRIPTION
16081
16082 =over 4
16083
16084 =item System Specifics
16085
16086 =back
16087
16088 =item NOTE
16089
16090 =item AUTHOR
16091
16092 =item HISTORY
16093
16094 March 18th, 2000
16095
16096 =back
16097
16098 =head2 Win32 - Interfaces to some Win32 API Functions
16099
16100 =over 4
16101
16102 =item DESCRIPTION
16103
16104 =over 4
16105
16106 =item Alphabetical Listing of Win32 Functions
16107
16108 Win32::AbortSystemShutdown(MACHINE), Win32::BuildNumber(),
16109 Win32::CopyFile(FROM, TO, OVERWRITE), Win32::DomainName(),
16110 Win32::ExpandEnvironmentStrings(STRING), Win32::FormatMessage(ERRORCODE),
16111 Win32::FsType(), Win32::FreeLibrary(HANDLE), Win32::GetArchName(),
16112 Win32::GetChipName(), Win32::GetCwd(), Win32::GetFullPathName(FILENAME),
16113 Win32::GetLastError(), Win32::GetLongPathName(PATHNAME),
16114 Win32::GetNextAvailDrive(), Win32::GetOSVersion(),
16115 Win32::GetShortPathName(PATHNAME), Win32::GetProcAddress(INSTANCE,
16116 PROCNAME), Win32::GetTickCount(), Win32::InitiateSystemShutdown,
16117 Win32::IsWinNT(), Win32::IsWin95(), Win32::LoadLibrary(LIBNAME),
16118 Win32::LoginName(), Win32::LookupAccountName(SYSTEM, ACCOUNT, DOMAIN, SID,
16119 SIDTYPE), Win32::LookupAccountSID(SYSTEM, SID, ACCOUNT, DOMAIN, SIDTYPE),
16120 Win32::MsgBox(MESSAGE [, FLAGS [, TITLE]]), Win32::NodeName(),
16121 Win32::RegisterServer(LIBRARYNAME), Win32::SetCwd(NEWDIRECTORY),
16122 Win32::SetLastError(ERROR), Win32::Sleep(TIME), Win32::Spawn(COMMAND, ARGS,
16123 PID), Win32::UnregisterServer(LIBRARYNAME)
16124
16125 =back
16126
16127 =back
16128
16129 =head2 XS::Typemap - module to test the XS typemaps distributed with perl
16130
16131 =over 4
16132
16133 =item SYNOPSIS
16134
16135 =item DESCRIPTION
16136
16137 =back
16138
16139 =over 4
16140
16141 =item NOTES
16142
16143 =item AUTHOR
16144
16145 =back
16146
16147 =head2 XSLoader - Dynamically load C libraries into Perl code
16148
16149 =over 4
16150
16151 =item SYNOPSIS
16152
16153 =item DESCRIPTION
16154
16155 =item AUTHOR
16156
16157 =back
16158
16159 =head1 AUXILIARY DOCUMENTATION
16160
16161 Here should be listed all the extra programs' documentation, but they
16162 don't all have manual pages yet:
16163
16164 =over 4
16165
16166 =item a2p
16167
16168 =item s2p
16169
16170 =item find2perl
16171
16172 =item h2ph
16173
16174 =item c2ph
16175
16176 =item h2xs
16177
16178 =item xsubpp
16179
16180 =item pod2man
16181
16182 =item wrapsuid
16183
16184 =back
16185
16186 =head1 AUTHOR
16187
16188 Larry Wall <F<larry@wall.org>>, with the help of oodles
16189 of other folks.
16190