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