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