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