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 =item SYNOPSIS
  17
  18 =item DESCRIPTION
  19
  20 Many usability enhancements, Simplified grammar, Lexical scoping,
  21 Arbitrarily nested data structures, Modularity and reusability,
  22 Object-oriented programming, Embeddable and Extensible, POSIX compliant,
  23 Package constructors and destructors, Multiple simultaneous DBM
  24 implementations, Subroutine definitions may now be autoloaded, Regular
  25 expression enhancements, Innumerable Unbundled Modules, Compilability
  26
  27 =item ENVIRONMENT
  28
  29 =item AUTHOR
  30
  31 =item FILES
  32
  33 =item SEE ALSO
  34
  35 =item DIAGNOSTICS
  36
  37 =item BUGS
  38
  39 =item NOTES
  40
  41 =head2 perlfaq - frequently asked questions about Perl ($Date: 1998/07/20
  42 23:12:17 $)
  43
  44 =item DESCRIPTION
  45
  46 perlfaq: Structural overview of the FAQ, L<perlfaq1>: General Questions
  47 About Perl, L<perlfaq2>: Obtaining and Learning about Perl, L<perlfaq3>:
  48 Programming Tools, L<perlfaq4>: Data Manipulation, L<perlfaq5>: Files and
  49 Formats, L<perlfaq6>: Regexps, L<perlfaq7>: General Perl Language Issues,
  50 L<perlfaq8>: System Interaction, L<perlfaq9>: Networking
  51
  52 =over
  53
  54 =item Where to get this document
  55
  56 =item How to contribute to this document
  57
  58 =item What will happen if you mail your Perl programming problems to the
  59 authors
  60
  61 =back
  62
  63 =item Credits
  64
  65 =item Author and Copyright Information
  66
  67 =over
  68
  69 =item Bundled Distributions
  70
  71 =item Disclaimer
  72
  73 =back
  74
  75 =item Changes
  76
  77 24/April/97, 23/April/97, 25/March/97, 18/March/97, 17/March/97 Version,
  78 Initial Release: 11/March/97
  79
  80 =head2 perlfaq1 - General Questions About Perl ($Revision: 1.14 $, $Date:
  81 1998/06/14 22:15:25 $)
  82
  83 =item DESCRIPTION
  84
  85 =over
  86
  87 =item What is Perl?
  88
  89 =item Who supports Perl?  Who develops it?  Why is it free?
  90
  91 =item Which version of Perl should I use?
  92
  93 =item What are perl4 and perl5?
  94
  95 =item How stable is Perl?
  96
  97 =item Is Perl difficult to learn?
  98
  99 =item How does Perl compare with other languages like Java, Python, REXX,
 100 Scheme, or Tcl?
 101
 102 =item Can I do [task] in Perl?
 103
 104 =item When shouldn't I program in Perl?
 105
 106 =item What's the difference between "perl" and "Perl"?
 107
 108 =item Is it a Perl program or a Perl script?
 109
 110 =item What is a JAPH?
 111
 112 =item Where can I get a list of Larry Wall witticisms?
 113
 114 =item How can I convince my sysadmin/supervisor/employees to use version
 115 (5/5.004/Perl instead of some other language)?
 116
 117 =back
 118
 119 =item AUTHOR AND COPYRIGHT
 120
 121 =head2 perlfaq2 - Obtaining and Learning about Perl ($Revision: 1.24 $,
 122 $Date: 1998/07/20 23:40:28 $)
 123
 124 =item DESCRIPTION
 125
 126 =over
 127
 128 =item What machines support Perl?  Where do I get it?
 129
 130 =item How can I get a binary version of Perl?
 131
 132 =item I don't have a C compiler on my system.  How can I compile perl?
 133
 134 =item I copied the Perl binary from one machine to another, but scripts
 135 don't work.
 136
 137 =item I grabbed the sources and tried to compile but gdbm/dynamic
 138 loading/malloc/linking/... failed.  How do I make it work?
 139
 140 =item What modules and extensions are available for Perl?  What is CPAN?
 141 What does CPAN/src/... mean?
 142
 143 =item Is there an ISO or ANSI certified version of Perl?
 144
 145 =item Where can I get information on Perl?
 146
 147 =item What are the Perl newsgroups on USENET?  Where do I post questions?
 148
 149 =item Where should I post source code?
 150
 151 =item Perl Books
 152
 153 References, Tutorials
 154 *Learning Perl [2nd edition]
 155 by Randal L. Schwartz and Tom Christiansen, Task-Oriented, Special Topics
 156
 157 =item Perl in Magazines
 158
 159 =item Perl on the Net: FTP and WWW Access
 160
 161 =item What mailing lists are there for perl?
 162
 163 MacPerl, Perl5-Porters, NTPerl, Perl-Packrats
 164
 165 =item Archives of comp.lang.perl.misc
 166
 167 =item Where can I buy a commercial version of Perl?
 168
 169 =item Where do I send bug reports?
 170
 171 =item What is perl.com?  perl.org?  The Perl Institute?
 172
 173 =item How do I learn about object-oriented Perl programming?
 174
 175 =back
 176
 177 =item AUTHOR AND COPYRIGHT
 178
 179 =head2 perlfaq3 - Programming Tools ($Revision: 1.28 $, $Date: 1998/07/16
 180 22:08:49 $)
 181
 182 =item DESCRIPTION
 183
 184 =over
 185
 186 =item How do I do (anything)?
 187
 188 =item How can I use Perl interactively?
 189
 190 =item Is there a Perl shell?
 191
 192 =item How do I debug my Perl programs?
 193
 194 =item How do I profile my Perl programs?
 195
 196 =item How do I cross-reference my Perl programs?
 197
 198 =item Is there a pretty-printer (formatter) for Perl?
 199
 200 =item Is there a ctags for Perl?
 201
 202 =item Where can I get Perl macros for vi?
 203
 204 =item Where can I get perl-mode for emacs?
 205
 206 =item How can I use curses with Perl?
 207
 208 =item How can I use X or Tk with Perl?
 209
 210 =item How can I generate simple menus without using CGI or Tk?
 211
 212 =item What is undump?
 213
 214 =item How can I make my Perl program run faster?
 215
 216 =item How can I make my Perl program take less memory?
 217
 218 =item Is it unsafe to return a pointer to local data?
 219
 220 =item How can I free an array or hash so my program shrinks?
 221
 222 =item How can I make my CGI script more efficient?
 223
 224 =item How can I hide the source for my Perl program?
 225
 226 =item How can I compile my Perl program into byte code or C?
 227
 228 =item How can I get C<#!perl> to work on [MS-DOS,NT,...]?
 229
 230 =item Can I write useful perl programs on the command line?
 231
 232 =item Why don't perl one-liners work on my DOS/Mac/VMS system?
 233
 234 =item Where can I learn about CGI or Web programming in Perl?
 235
 236 =item Where can I learn about object-oriented Perl programming?
 237
 238 =item Where can I learn about linking C with Perl? [h2xs, xsubpp]
 239
 240 =item I've read perlembed, perlguts, etc., but I can't embed perl in
 241 my C program, what am I doing wrong?
 242
 243 =item When I tried to run my script, I got this message. What does it
 244 mean?
 245
 246 =item What's MakeMaker?
 247
 248 =back
 249
 250 =item AUTHOR AND COPYRIGHT
 251
 252 =head2 perlfaq4 - Data Manipulation ($Revision: 1.25 $, $Date: 1998/07/16
 253 22:49:55 $)
 254
 255 =item DESCRIPTION
 256
 257 =item Data: Numbers
 258
 259 =over
 260
 261 =item Why am I getting long decimals (eg, 19.9499999999999) instead of the
 262 numbers I should be getting (eg, 19.95)?
 263
 264 =item Why isn't my octal data interpreted correctly?
 265
 266 =item Does perl have a round function?  What about ceil() and floor()?
 267 Trig functions?
 268
 269 =item How do I convert bits into ints?
 270
 271 =item How do I multiply matrices?
 272
 273 =item How do I perform an operation on a series of integers?
 274
 275 =item How can I output Roman numerals?
 276
 277 =item Why aren't my random numbers random?
 278
 279 =back
 280
 281 =item Data: Dates
 282
 283 =over
 284
 285 =item How do I find the week-of-the-year/day-of-the-year?
 286
 287 =item How can I compare two dates and find the difference?
 288
 289 =item How can I take a string and turn it into epoch seconds?
 290
 291 =item How can I find the Julian Day?
 292
 293 =item Does Perl have a year 2000 problem?  Is Perl Y2K compliant?
 294
 295 =back
 296
 297 =item Data: Strings
 298
 299 =over
 300
 301 =item How do I validate input?
 302
 303 =item How do I unescape a string?
 304
 305 =item How do I remove consecutive pairs of characters?
 306
 307 =item How do I expand function calls in a string?
 308
 309 =item How do I find matching/nesting anything?
 310
 311 =item How do I reverse a string?
 312
 313 =item How do I expand tabs in a string?
 314
 315 =item How do I reformat a paragraph?
 316
 317 =item How can I access/change the first N letters of a string?
 318
 319 =item How do I change the Nth occurrence of something?
 320
 321 =item How can I count the number of occurrences of a substring within a
 322 string?
 323
 324 =item How do I capitalize all the words on one line?
 325
 326 =item How can I split a [character] delimited string except when inside
 327 [character]? (Comma-separated files)
 328
 329 =item How do I strip blank space from the beginning/end of a string?
 330
 331 =item How do I extract selected columns from a string?
 332
 333 =item How do I find the soundex value of a string?
 334
 335 =item How can I expand variables in text strings?
 336
 337 =item What's wrong with always quoting "$vars"?
 338
 339 =item Why don't my <<HERE documents work?
 340
 341 1. There must be no space after the << part, 2. There (probably) should be
 342 a semicolon at the end, 3. You can't (easily) have any space in front of
 343 the tag
 344
 345 =back
 346
 347 =item Data: Arrays
 348
 349 =over
 350
 351 =item What is the difference between $array[1] and @array[1]?
 352
 353 =item How can I extract just the unique elements of an array?
 354
 355 a) If @in is sorted, and you want @out to be sorted:(this assumes all true
 356 values in the array), b) If you don't know whether @in is sorted:, c) Like
 357 (b), but @in contains only small integers:, d) A way to do (b) without any
 358 loops or greps:, e) Like (d), but @in contains only small positive
 359 integers:
 360
 361 =item How can I tell whether a list or array contains a certain element?
 362
 363 =item How do I compute the difference of two arrays?  How do I compute the
 364 intersection of two arrays?
 365
 366 =item How do I find the first array element for which a condition is true?
 367
 368 =item How do I handle linked lists?
 369
 370 =item How do I handle circular lists?
 371
 372 =item How do I shuffle an array randomly?
 373
 374 =item How do I process/modify each element of an array?
 375
 376 =item How do I select a random element from an array?
 377
 378 =item How do I permute N elements of a list?
 379
 380 =item How do I sort an array by (anything)?
 381
 382 =item How do I manipulate arrays of bits?
 383
 384 =item Why does defined() return true on empty arrays and hashes?
 385
 386 =back
 387
 388 =item Data: Hashes (Associative Arrays)
 389
 390 =over
 391
 392 =item How do I process an entire hash?
 393
 394 =item What happens if I add or remove keys from a hash while iterating over
 395 it?
 396
 397 =item How do I look up a hash element by value?
 398
 399 =item How can I know how many entries are in a hash?
 400
 401 =item How do I sort a hash (optionally by value instead of key)?
 402
 403 =item How can I always keep my hash sorted?
 404
 405 =item What's the difference between "delete" and "undef" with hashes?
 406
 407 =item Why don't my tied hashes make the defined/exists distinction?
 408
 409 =item How do I reset an each() operation part-way through?
 410
 411 =item How can I get the unique keys from two hashes?
 412
 413 =item How can I store a multidimensional array in a DBM file?
 414
 415 =item How can I make my hash remember the order I put elements into it?
 416
 417 =item Why does passing a subroutine an undefined element in a hash create
 418 it?
 419
 420 =item How can I make the Perl equivalent of a C structure/C++ class/hash or
 421 array of hashes or arrays?
 422
 423 =item How can I use a reference as a hash key?
 424
 425 =back
 426
 427 =item Data: Misc
 428
 429 =over
 430
 431 =item How do I handle binary data correctly?
 432
 433 =item How do I determine whether a scalar is a number/whole/integer/float?
 434
 435 =item How do I keep persistent data across program calls?
 436
 437 =item How do I print out or copy a recursive data structure?
 438
 439 =item How do I define methods for every class/object?
 440
 441 =item How do I verify a credit card checksum?
 442
 443 =back
 444
 445 =item AUTHOR AND COPYRIGHT
 446
 447 =head2 perlfaq5 - Files and Formats ($Revision: 1.24 $, $Date: 1998/07/05
 448 15:07:20 $)
 449
 450 =item DESCRIPTION
 451
 452 =over
 453
 454 =item How do I flush/unbuffer an output filehandle?  Why must I do this?
 455
 456 =item How do I change one line in a file/delete a line in a file/insert a
 457 line in the middle of a file/append to the beginning of a file?
 458
 459 =item How do I count the number of lines in a file?
 460
 461 =item How do I make a temporary file name?
 462
 463 =item How can I manipulate fixed-record-length files?
 464
 465 =item How can I make a filehandle local to a subroutine?  How do I pass
 466 filehandles between subroutines?  How do I make an array of filehandles?
 467
 468 =item How can I use a filehandle indirectly?
 469
 470 =item How can I set up a footer format to be used with write()?
 471
 472 =item How can I write() into a string?
 473
 474 =item How can I output my numbers with commas added?
 475
 476 =item How can I translate tildes (~) in a filename?
 477
 478 =item How come when I open a file read-write it wipes it out?
 479
 480 =item Why do I sometimes get an "Argument list too long" when I use <*>?
 481
 482 =item Is there a leak/bug in glob()?
 483
 484 =item How can I open a file with a leading "E<gt>" or trailing blanks?
 485
 486 =item How can I reliably rename a file?
 487
 488 =item How can I lock a file?
 489
 490 =item What can't I just open(FH, ">file.lock")?
 491
 492 =item I still don't get locking.  I just want to increment the number in
 493 the file.  How can I do this?
 494
 495 =item How do I randomly update a binary file?
 496
 497 =item How do I get a file's timestamp in perl?
 498
 499 =item How do I set a file's timestamp in perl?
 500
 501 =item How do I print to more than one file at once?
 502
 503 =item How can I read in a file by paragraphs?
 504
 505 =item How can I read a single character from a file?  From the keyboard?
 506
 507 =item How can I tell if there's a character waiting on a filehandle?
 508
 509 =item How do I do a C<tail -f> in perl?
 510
 511 =item How do I dup() a filehandle in Perl?
 512
 513 =item How do I close a file descriptor by number?
 514
 515 =item Why can't I use "C:\temp\foo" in DOS paths?  What doesn't
 516 `C:\temp\foo.exe` work?
 517
 518 =item Why doesn't glob("*.*") get all the files?
 519
 520 =item Why does Perl let me delete read-only files?  Why does C<-i> clobber
 521 protected files?  Isn't this a bug in Perl?
 522
 523 =item How do I select a random line from a file?
 524
 525 =back
 526
 527 =item AUTHOR AND COPYRIGHT
 528
 529 =head2 perlfaq6 - Regexps ($Revision: 1.22 $, $Date: 1998/07/16 14:01:07 $)
 530
 531 =item DESCRIPTION
 532
 533 =over
 534
 535 =item How can I hope to use regular expressions without creating illegible
 536 and unmaintainable code?
 537
 538 Comments Outside the Regexp, Comments Inside the Regexp, Different
 539 Delimiters
 540
 541 =item I'm having trouble matching over more than one line.  What's wrong?
 542
 543 =item How can I pull out lines between two patterns that are themselves on
 544 different lines?
 545
 546 =item I put a regular expression into $/ but it didn't work. What's wrong?
 547
 548 =item How do I substitute case insensitively on the LHS, but preserving
 549 case on the RHS?
 550
 551 =item How can I make C<\w> match national character sets?
 552
 553 =item How can I match a locale-smart version of C</[a-zA-Z]/>?
 554
 555 =item How can I quote a variable to use in a regexp?
 556
 557 =item What is C</o> really for?
 558
 559 =item How do I use a regular expression to strip C style comments from a
 560 file?
 561
 562 =item Can I use Perl regular expressions to match balanced text?
 563
 564 =item What does it mean that regexps are greedy?  How can I get around it?
 565
 566 =item  How do I process each word on each line?
 567
 568 =item How can I print out a word-frequency or line-frequency summary?
 569
 570 =item How can I do approximate matching?
 571
 572 =item How do I efficiently match many regular expressions at once?
 573
 574 =item Why don't word-boundary searches with C<\b> work for me?
 575
 576 =item Why does using $&, $`, or $' slow my program down?
 577
 578 =item What good is C<\G> in a regular expression?
 579
 580 =item Are Perl regexps DFAs or NFAs?  Are they POSIX compliant?
 581
 582 =item What's wrong with using grep or map in a void context?
 583
 584 =item How can I match strings with multibyte characters?
 585
 586 =back
 587
 588 =item AUTHOR AND COPYRIGHT
 589
 590 =head2 perlfaq7 - Perl Language Issues ($Revision: 1.21 $, $Date:
 591 1998/06/22 15:20:07 $)
 592
 593 =item DESCRIPTION
 594
 595 =over
 596
 597 =item Can I get a BNF/yacc/RE for the Perl language?
 598
 599 =item What are all these $@%* punctuation signs, and how do I know when to
 600 use them?
 601
 602 =item Do I always/never have to quote my strings or use semicolons and
 603 commas?
 604
 605 =item How do I skip some return values?
 606
 607 =item How do I temporarily block warnings?
 608
 609 =item What's an extension?
 610
 611 =item Why do Perl operators have different precedence than C operators?
 612
 613 =item How do I declare/create a structure?
 614
 615 =item How do I create a module?
 616
 617 =item How do I create a class?
 618
 619 =item How can I tell if a variable is tainted?
 620
 621 =item What's a closure?
 622
 623 =item What is variable suicide and how can I prevent it?
 624
 625 =item How can I pass/return a {Function, FileHandle, Array, Hash, Method,
 626 Regexp}?
 627
 628 Passing Variables and Functions, Passing Filehandles, Passing Regexps,
 629 Passing Methods
 630
 631 =item How do I create a static variable?
 632
 633 =item What's the difference between dynamic and lexical (static) scoping?
 634 Between local() and my()?
 635
 636 =item How can I access a dynamic variable while a similarly named lexical
 637 is in scope?
 638
 639 =item What's the difference between deep and shallow binding?
 640
 641 =item Why doesn't "my($foo) = <FILE>;" work right?
 642
 643 =item How do I redefine a builtin function, operator, or method?
 644
 645 =item What's the difference between calling a function as &foo and foo()?
 646
 647 =item How do I create a switch or case statement?
 648
 649 =item How can I catch accesses to undefined variables/functions/methods?
 650
 651 =item Why can't a method included in this same file be found?
 652
 653 =item How can I find out my current package?
 654
 655 =item How can I comment out a large block of perl code?
 656
 657 =back
 658
 659 =item AUTHOR AND COPYRIGHT
 660
 661 =head2 perlfaq8 - System Interaction ($Revision: 1.25 $, $Date: 1998/07/05
 662 15:07:20 $)
 663
 664 =item DESCRIPTION
 665
 666 =over
 667
 668 =item How do I find out which operating system I'm running under?
 669
 670 =item How come exec() doesn't return?
 671
 672 =item How do I do fancy stuff with the keyboard/screen/mouse?
 673
 674 Keyboard, Screen, Mouse
 675
 676 =item How do I print something out in color?
 677
 678 =item How do I read just one key without waiting for a return key?
 679
 680 =item How do I check whether input is ready on the keyboard?
 681
 682 =item How do I clear the screen?
 683
 684 =item How do I get the screen size?
 685
 686 =item How do I ask the user for a password?
 687
 688 =item How do I read and write the serial port?
 689
 690 lockfiles, open mode, end of line, flushing output, non-blocking input
 691
 692 =item How do I decode encrypted password files?
 693
 694 =item How do I start a process in the background?
 695
 696 STDIN, STDOUT, and STDERR are shared, Signals, Zombies
 697
 698 =item How do I trap control characters/signals?
 699
 700 =item How do I modify the shadow password file on a Unix system?
 701
 702 =item How do I set the time and date?
 703
 704 =item How can I sleep() or alarm() for under a second?
 705
 706 =item How can I measure time under a second?
 707
 708 =item How can I do an atexit() or setjmp()/longjmp()? (Exception handling)
 709
 710 =item Why doesn't my sockets program work under System V (Solaris)? What
 711 does the error message "Protocol not supported" mean?
 712
 713 =item How can I call my system's unique C functions from Perl?
 714
 715 =item Where do I get the include files to do ioctl() or syscall()?
 716
 717 =item Why do setuid perl scripts complain about kernel problems?
 718
 719 =item How can I open a pipe both to and from a command?
 720
 721 =item Why can't I get the output of a command with system()?
 722
 723 =item How can I capture STDERR from an external command?
 724
 725 =item Why doesn't open() return an error when a pipe open fails?
 726
 727 =item What's wrong with using backticks in a void context?
 728
 729 =item How can I call backticks without shell processing?
 730
 731 =item Why can't my script read from STDIN after I gave it EOF (^D on Unix,
 732 ^Z on MS-DOS)?
 733
 734 =item How can I convert my shell script to perl?
 735
 736 =item Can I use perl to run a telnet or ftp session?
 737
 738 =item How can I write expect in Perl?
 739
 740 =item Is there a way to hide perl's command line from programs such as
 741 "ps"?
 742
 743 =item I {changed directory, modified my environment} in a perl script.  How
 744 come the change disappeared when I exited the script?  How do I get my
 745 changes to be visible?
 746
 747 Unix
 748
 749 =item How do I close a process's filehandle without waiting for it to
 750 complete?
 751
 752 =item How do I fork a daemon process?
 753
 754 =item How do I make my program run with sh and csh?
 755
 756 =item How do I find out if I'm running interactively or not?
 757
 758 =item How do I timeout a slow event?
 759
 760 =item How do I set CPU limits?
 761
 762 =item How do I avoid zombies on a Unix system?
 763
 764 =item How do I use an SQL database?
 765
 766 =item How do I make a system() exit on control-C?
 767
 768 =item How do I open a file without blocking?
 769
 770 =item How do I install a CPAN module?
 771
 772 =item What's the difference between require and use?
 773
 774 =item How do I keep my own module/library directory?
 775
 776 =item How do I add the directory my program lives in to the module/library
 777 search path?
 778
 779 =item How do I add a directory to my include path at runtime?
 780
 781 =back
 782
 783 =item AUTHOR AND COPYRIGHT
 784
 785 =head2 perlfaq9 - Networking ($Revision: 1.20 $, $Date: 1998/06/22 18:31:09
 786 $)
 787
 788 =item DESCRIPTION
 789
 790 =over
 791
 792 =item My CGI script runs from the command line but not the browser.   (500
 793 Server Error)
 794
 795 =item How can I get better error messages from a CGI program?
 796
 797 =item How do I remove HTML from a string?
 798
 799 =item How do I extract URLs?
 800
 801 =item How do I download a file from the user's machine?  How do I open a
 802 file on another machine?
 803
 804 =item How do I make a pop-up menu in HTML?
 805
 806 =item How do I fetch an HTML file?
 807
 808 =item How do I automate an HTML form submission?
 809
 810 =item How do I decode or create those %-encodings on the web?
 811
 812 =item How do I redirect to another page?
 813
 814 =item How do I put a password on my web pages?
 815
 816 =item How do I edit my .htpasswd and .htgroup files with Perl?
 817
 818 =item How do I make sure users can't enter values into a form that cause my
 819 CGI script to do bad things?
 820
 821 =item How do I parse a mail header?
 822
 823 =item How do I decode a CGI form?
 824
 825 =item How do I check a valid mail address?
 826
 827 =item How do I decode a MIME/BASE64 string?
 828
 829 =item How do I return the user's mail address?
 830
 831 =item How do I send mail?
 832
 833 =item How do I read mail?
 834
 835 =item How do I find out my hostname/domainname/IP address?
 836
 837 =item How do I fetch a news article or the active newsgroups?
 838
 839 =item How do I fetch/put an FTP file?
 840
 841 =item How can I do RPC in Perl?
 842
 843 =back
 844
 845 =item AUTHOR AND COPYRIGHT
 846
 847 =head2 perldelta - what's new for perl5.005
 848
 849 =item DESCRIPTION
 850
 851 =item About the new versioning system
 852
 853 =item Incompatible Changes
 854
 855 =over
 856
 857 =item WARNING:  This version is not binary compatible with Perl 5.004.
 858
 859 =item Default installation structure has changed
 860
 861 =item Perl Source Compatibility
 862
 863 =item C Source Compatibility
 864
 865 Core sources now require ANSI C compiler, All Perl global variables must
 866 now be referenced with an explicit prefix, Enabling threads has source
 867 compatibility issues
 868
 869 =item Binary Compatibility
 870
 871 =item Security fixes may affect compatibility
 872
 873 =item Relaxed new mandatory warnings introduced in 5.004
 874
 875 =item Licensing
 876
 877 =back
 878
 879 =item Core Changes
 880
 881 =over
 882
 883 =item Threads
 884
 885 =item Compiler
 886
 887 =item Regular Expressions
 888
 889 Many new and improved optimizations, Many bug fixes, New regular expression
 890 constructs, New operator for precompiled regular expressions, Other
 891 improvements, Incompatible changes
 892
 893 =item   Improved malloc()
 894
 895 =item Quicksort is internally implemented
 896
 897 =item Reliable signals
 898
 899 =item Reliable stack pointers
 900
 901 =item Behavior of local() on array and hash elements is now well-defined
 902
 903 =item C<%!> is transparently tied to the L<Errno> module
 904
 905 =item Pseudo-hashes are supported
 906
 907 =item C<EXPR foreach EXPR> is supported
 908
 909 =item Keywords can be globally overridden
 910
 911 =item C<$^E> is meaningful on Win32
 912
 913 =item C<foreach (1..1000000)> optimized
 914
 915 =item C<Foo::> can be used as implicitly quoted package name
 916
 917 =item C<exists $Foo::{Bar::}> tests existence of a package
 918
 919 =item Better locale support
 920
 921 =item Experimental support for 64-bit platforms
 922
 923 =item prototype() returns useful results on builtins
 924
 925 =item Extended support for exception handling
 926
 927 =item Re-blessing in DESTROY() supported for chaining DESTROY() methods
 928
 929 =item All C<printf> format conversions are handled internally
 930
 931 =item New C<INIT> keyword
 932
 933 =item New C<lock> keyword
 934
 935 =item New C<qr//> operator
 936
 937 =item C<our> is now a reserved word
 938
 939 =item Tied arrays are now fully supported
 940
 941 =item Tied handles support is better
 942
 943 =item 4th argument to substr
 944
 945 =item Negative LENGTH argument to splice
 946
 947 =item Magic lvalues are now more magical
 948
 949 =item E<lt>E<gt> now reads in records
 950
 951 =back
 952
 953 =item Supported Platforms
 954
 955 =over
 956
 957 =item New Platforms
 958
 959 =item Changes in existing support
 960
 961 =back
 962
 963 =item Modules and Pragmata
 964
 965 =over
 966
 967 =item New Modules
 968
 969 B, Data::Dumper, Errno, File::Spec, ExtUtils::Installed,
 970 ExtUtils::Packlist, Fatal, IPC::SysV, Test, Tie::Array, Tie::Handle,
 971 Thread, attrs, fields, re
 972
 973 =item Changes in existing modules
 974
 975 CGI, POSIX, DB_File, MakeMaker, CPAN, Cwd, Benchmark
 976
 977 =back
 978
 979 =item Utility Changes
 980
 981 =item Documentation Changes
 982
 983 =item New Diagnostics
 984
 985 Ambiguous call resolved as CORE::%s(), qualify as such or use &, Bad index
 986 while coercing array into hash, Bareword "%s" refers to nonexistent
 987 package, Can't call method "%s" on an undefined value, Can't coerce array
 988 into hash, Can't goto subroutine from an eval-string, Can't localize
 989 pseudo-hash element, Can't use %%! because Errno.pm is not available,
 990 Cannot find an opnumber for "%s", Character class syntax [. .] is reserved
 991 for future extensions, Character class syntax [: :] is reserved for future
 992 extensions, Character class syntax [= =] is reserved for future extensions,
 993 %s: Eval-group in insecure regular expression, %s: Eval-group not allowed,
 994 use re 'eval', %s: Eval-group not allowed at run time, Explicit blessing to
 995 '' (assuming package main), Illegal hex digit ignored, No such array field,
 996 No such field "%s" in variable %s of type %s, Out of memory during
 997 ridiculously large request, Range iterator outside integer range, Recursive
 998 inheritance detected while looking for method '%s' in package '%s',
 999 Reference found where even-sized list expected, Undefined value assigned to
1000 typeglob, Use of reserved word "%s" is deprecated, perl: warning: Setting
1001 locale failed
1002
1003 =item Obsolete Diagnostics
1004
1005 Can't mktemp(), Can't write to temp file for B<-e>: %s, Cannot open
1006 temporary file
1007
1008 =item BUGS
1009
1010 =item SEE ALSO
1011
1012 =item HISTORY
1013
1014 =head2 perldata - Perl data types
1015
1016 =item DESCRIPTION
1017
1018 =over
1019
1020 =item Variable names
1021
1022 =item Context
1023
1024 =item Scalar values
1025
1026 =item Scalar value constructors
1027
1028 =item List value constructors
1029
1030 =item Typeglobs and Filehandles
1031
1032 =back
1033
1034 =head2 perlsyn - Perl syntax
1035
1036 =item DESCRIPTION
1037
1038 =over
1039
1040 =item Declarations
1041
1042 =item Simple statements
1043
1044 =item Compound statements
1045
1046 =item Loop Control
1047
1048 =item For Loops
1049
1050 =item Foreach Loops
1051
1052 =item Basic BLOCKs and Switch Statements
1053
1054 =item Goto
1055
1056 =item PODs: Embedded Documentation
1057
1058 =item Plain Old Comments (Not!)
1059
1060 =back
1061
1062 =head2 perlop - Perl operators and precedence
1063
1064 =item SYNOPSIS
1065
1066 =item DESCRIPTION
1067
1068 =over
1069
1070 =item Terms and List Operators (Leftward)
1071
1072 =item The Arrow Operator
1073
1074 =item Auto-increment and Auto-decrement
1075
1076 =item Exponentiation
1077
1078 =item Symbolic Unary Operators
1079
1080 =item Binding Operators
1081
1082 =item Multiplicative Operators
1083
1084 =item Additive Operators
1085
1086 =item Shift Operators
1087
1088 =item Named Unary Operators
1089
1090 =item Relational Operators
1091
1092 =item Equality Operators
1093
1094 =item Bitwise And
1095
1096 =item Bitwise Or and Exclusive Or
1097
1098 =item C-style Logical And
1099
1100 =item C-style Logical Or
1101
1102 =item Range Operators
1103
1104 =item Conditional Operator
1105
1106 =item Assignment Operators
1107
1108 =item Comma Operator
1109
1110 =item List Operators (Rightward)
1111
1112 =item Logical Not
1113
1114 =item Logical And
1115
1116 =item Logical or and Exclusive Or
1117
1118 =item C Operators Missing From Perl
1119
1120 unary &, unary *, (TYPE)
1121
1122 =item Quote and Quote-like Operators
1123
1124 =item Regexp Quote-Like Operators
1125
1126 ?PATTERN?, m/PATTERN/cgimosx, /PATTERN/cgimosx, q/STRING/, C<'STRING'>,
1127 qq/STRING/, "STRING", qr/STRING/imosx, qx/STRING/, `STRING`, qw/STRING/,
1128 s/PATTERN/REPLACEMENT/egimosx, tr/SEARCHLIST/REPLACEMENTLIST/cds,
1129 y/SEARCHLIST/REPLACEMENTLIST/cds
1130
1131 =item Gory details of parsing quoted constructs
1132
1133 Finding the end, Removal of backslashes before delimiters, Interpolation,
1134 C<<<'EOF'>, C<m''>, C<s'''>, C<tr///>, C<y///>, C<''>, C<q//>, C<"">,
1135 C<``>, C<qq//>, C<qx//>, C<<file*globE<gt>>, C<?RE?>, C</RE/>, C<m/RE/>,
1136 C<s/RE/foo/>,, Interpolation of regular expressions, Optimization of
1137 regular expressions
1138
1139 =item I/O Operators
1140
1141 =item Constant Folding
1142
1143 =item Bitwise String Operators
1144
1145 =item Integer Arithmetic
1146
1147 =item Floating-point Arithmetic
1148
1149 =item Bigger Numbers
1150
1151 =back
1152
1153 =head2 perlre - Perl regular expressions
1154
1155 =item DESCRIPTION
1156
1157 i, m, s, x
1158
1159 =over
1160
1161 =item Regular Expressions
1162
1163 C<(?#text)>, C<(?:pattern)>, C<(?imsx-imsx:pattern)>, C<(?=pattern)>,
1164 C<(?!pattern)>, C<(?E<lt>=pattern)>, C<(?<!pattern)>, C<(?{ code })>,
1165 C<(?E<gt>pattern)>, C<(?(condition)yes-pattern|no-pattern)>,
1166 C<(?(condition)yes-pattern)>, C<(?imsx-imsx)>
1167
1168 =item Backtracking
1169
1170 =item Version 8 Regular Expressions
1171
1172 =item WARNING on \1 vs $1
1173
1174 =item Repeated patterns matching zero-length substring
1175
1176 =item Creating custom RE engines
1177
1178 =item SEE ALSO
1179
1180 =back
1181
1182 =head2 perlrun - how to execute the Perl interpreter
1183
1184 =item SYNOPSIS
1185
1186 =item DESCRIPTION
1187
1188 =over
1189
1190 =item #! and quoting on non-Unix systems
1191
1192 OS/2, MS-DOS, Win95/NT, Macintosh
1193
1194 =item Location of Perl
1195
1196 =item Switches
1197
1198 B<-0>[I<digits>], B<-a>, B<-c>, B<-d>, B<-d:>I<foo>, B<-D>I<letters>,
1199 B<-D>I<number>, B<-e> I<commandline>, B<-F>I<pattern>, B<-h>,
1200 B<-i>[I<extension>], B<-I>I<directory>, B<-l>[I<octnum>],
1201 B<-m>[B<->]I<module>, B<-M>[B<->]I<module>, B<-M>[B<->]I<'module ...'>,
1202 B<-[mM]>[B<->]I<module=arg[,arg]...>, B<-n>, B<-p>, B<-P>, B<-s>, B<-S>,
1203 B<-T>, B<-u>, B<-U>, B<-v>, B<-V>, B<-V:>I<name>, B<-w>, B<-x> I<directory>
1204
1205 =back
1206
1207 =item ENVIRONMENT
1208
1209 HOME, LOGDIR, PATH, PERL5LIB, PERL5OPT, PERLLIB, PERL5DB, PERL5SHELL
1210 (specific to WIN32 port), PERL_DEBUG_MSTATS, PERL_DESTRUCT_LEVEL
1211
1212 =head2 perlfunc - Perl builtin functions
1213
1214 =item DESCRIPTION
1215
1216 =over
1217
1218 =item Perl Functions by Category
1219
1220 Functions for SCALARs or strings, Regular expressions and pattern matching,
1221 Numeric functions, Functions for real @ARRAYs, Functions for list data,
1222 Functions for real %HASHes, Input and output functions, Functions for fixed
1223 length data or records, Functions for filehandles, files, or directories,
1224 Keywords related to the control flow of your perl program, Keywords related
1225 to scoping, Miscellaneous functions, Functions for processes and process
1226 groups, Keywords related to perl modules, Keywords related to classes and
1227 object-orientedness, Low-level socket functions, System V interprocess
1228 communication functions, Fetching user and group info, Fetching network
1229 info, Time-related functions, Functions new in perl5, Functions obsoleted
1230 in perl5
1231
1232 =item Alphabetical Listing of Perl Functions
1233
1234 I<-X> FILEHANDLE, I<-X> EXPR, I<-X>, abs VALUE, abs, accept
1235 NEWSOCKET,GENERICSOCKET, alarm SECONDS, alarm, atan2 Y,X, bind SOCKET,NAME,
1236 binmode FILEHANDLE, bless REF,CLASSNAME, bless REF, caller EXPR, caller,
1237 chdir EXPR, chmod LIST, chomp VARIABLE, chomp LIST, chomp, chop VARIABLE,
1238 chop LIST, chop, chown LIST, chr NUMBER, chr, chroot FILENAME, chroot,
1239 close FILEHANDLE, close, closedir DIRHANDLE, connect SOCKET,NAME, continue
1240 BLOCK, cos EXPR, crypt PLAINTEXT,SALT, dbmclose HASH, dbmopen
1241 HASH,DBNAME,MODE, defined EXPR, defined, delete EXPR, die LIST, do BLOCK,
1242 do SUBROUTINE(LIST), do EXPR, dump LABEL, each HASH, eof FILEHANDLE, eof
1243 (), eof, eval EXPR, eval BLOCK, exec LIST, exec PROGRAM LIST, exists EXPR,
1244 exit EXPR, exp EXPR, exp, fcntl FILEHANDLE,FUNCTION,SCALAR, fileno
1245 FILEHANDLE, flock FILEHANDLE,OPERATION, fork, format, formline
1246 PICTURE,LIST, getc FILEHANDLE, getc, getlogin, getpeername SOCKET, getpgrp
1247 PID, getppid, getpriority WHICH,WHO, getpwnam NAME, getgrnam NAME,
1248 gethostbyname NAME, getnetbyname NAME, getprotobyname NAME, getpwuid UID,
1249 getgrgid GID, getservbyname NAME,PROTO, gethostbyaddr ADDR,ADDRTYPE,
1250 getnetbyaddr ADDR,ADDRTYPE, getprotobynumber NUMBER, getservbyport
1251 PORT,PROTO, getpwent, getgrent, gethostent, getnetent, getprotoent,
1252 getservent, setpwent, setgrent, sethostent STAYOPEN, setnetent STAYOPEN,
1253 setprotoent STAYOPEN, setservent STAYOPEN, endpwent, endgrent, endhostent,
1254 endnetent, endprotoent, endservent, getsockname SOCKET, getsockopt
1255 SOCKET,LEVEL,OPTNAME, glob EXPR, glob, gmtime EXPR, goto LABEL, goto EXPR,
1256 goto &NAME, grep BLOCK LIST, grep EXPR,LIST, hex EXPR, hex, import, index
1257 STR,SUBSTR,POSITION, index STR,SUBSTR, int EXPR, int, ioctl
1258 FILEHANDLE,FUNCTION,SCALAR, join EXPR,LIST, keys HASH, kill LIST, last
1259 LABEL, last, lc EXPR, lc, lcfirst EXPR, lcfirst, length EXPR, length, link
1260 OLDFILE,NEWFILE, listen SOCKET,QUEUESIZE, local EXPR, localtime EXPR, log
1261 EXPR, log, lstat FILEHANDLE, lstat EXPR, lstat, m//, map BLOCK LIST, map
1262 EXPR,LIST, mkdir FILENAME,MODE, msgctl ID,CMD,ARG, msgget KEY,FLAGS, msgsnd
1263 ID,MSG,FLAGS, msgrcv ID,VAR,SIZE,TYPE,FLAGS, my EXPR, next LABEL, next, no
1264 Module LIST, oct EXPR, oct, open FILEHANDLE,EXPR, open FILEHANDLE, opendir
1265 DIRHANDLE,EXPR, ord EXPR, ord, pack TEMPLATE,LIST, package, package
1266 NAMESPACE, pipe READHANDLE,WRITEHANDLE, pop ARRAY, pop, pos SCALAR, pos,
1267 print FILEHANDLE LIST, print LIST, print, printf FILEHANDLE FORMAT, LIST,
1268 printf FORMAT, LIST, prototype FUNCTION, push ARRAY,LIST, q/STRING/,
1269 qq/STRING/, qr/STRING/, qx/STRING/, qw/STRING/, quotemeta EXPR, quotemeta,
1270 rand EXPR, rand, read FILEHANDLE,SCALAR,LENGTH,OFFSET, read
1271 FILEHANDLE,SCALAR,LENGTH, readdir DIRHANDLE, readline EXPR, readlink EXPR,
1272 readlink, readpipe EXPR, recv SOCKET,SCALAR,LEN,FLAGS, redo LABEL, redo,
1273 ref EXPR, ref, rename OLDNAME,NEWNAME, require EXPR, require, reset EXPR,
1274 reset, return EXPR, return, reverse LIST, rewinddir DIRHANDLE, rindex
1275 STR,SUBSTR,POSITION, rindex STR,SUBSTR, rmdir FILENAME, rmdir, s///, scalar
1276 EXPR, seek FILEHANDLE,POSITION,WHENCE, seekdir DIRHANDLE,POS, select
1277 FILEHANDLE, select, select RBITS,WBITS,EBITS,TIMEOUT, semctl
1278 ID,SEMNUM,CMD,ARG, semget KEY,NSEMS,FLAGS, semop KEY,OPSTRING, send
1279 SOCKET,MSG,FLAGS,TO, send SOCKET,MSG,FLAGS, setpgrp PID,PGRP, setpriority
1280 WHICH,WHO,PRIORITY, setsockopt SOCKET,LEVEL,OPTNAME,OPTVAL, shift ARRAY,
1281 shift, shmctl ID,CMD,ARG, shmget KEY,SIZE,FLAGS, shmread ID,VAR,POS,SIZE,
1282 shmwrite ID,STRING,POS,SIZE, shutdown SOCKET,HOW, sin EXPR, sin, sleep
1283 EXPR, sleep, socket SOCKET,DOMAIN,TYPE,PROTOCOL, socketpair
1284 SOCKET1,SOCKET2,DOMAIN,TYPE,PROTOCOL, sort SUBNAME LIST, sort BLOCK LIST,
1285 sort LIST, splice ARRAY,OFFSET,LENGTH,LIST, splice ARRAY,OFFSET,LENGTH,
1286 splice ARRAY,OFFSET, split /PATTERN/,EXPR,LIMIT, split /PATTERN/,EXPR,
1287 split /PATTERN/, split, sprintf FORMAT, LIST, sqrt EXPR, sqrt, srand EXPR,
1288 srand, stat FILEHANDLE, stat EXPR, stat, study SCALAR, study, sub BLOCK,
1289 sub NAME, sub NAME BLOCK, substr EXPR,OFFSET,LEN,REPLACEMENT, substr
1290 EXPR,OFFSET,LEN, substr EXPR,OFFSET, symlink OLDFILE,NEWFILE, syscall LIST,
1291 sysopen FILEHANDLE,FILENAME,MODE, sysopen FILEHANDLE,FILENAME,MODE,PERMS,
1292 sysread FILEHANDLE,SCALAR,LENGTH,OFFSET, sysread FILEHANDLE,SCALAR,LENGTH,
1293 sysseek FILEHANDLE,POSITION,WHENCE, system LIST, system PROGRAM LIST,
1294 syswrite FILEHANDLE,SCALAR,LENGTH,OFFSET, syswrite
1295 FILEHANDLE,SCALAR,LENGTH, tell FILEHANDLE, tell, telldir DIRHANDLE, tie
1296 VARIABLE,CLASSNAME,LIST, tied VARIABLE, time, times, tr///, truncate
1297 FILEHANDLE,LENGTH, truncate EXPR,LENGTH, uc EXPR, uc, ucfirst EXPR,
1298 ucfirst, umask EXPR, umask, undef EXPR, undef, unlink LIST, unlink, unpack
1299 TEMPLATE,EXPR, untie VARIABLE, unshift ARRAY,LIST, use Module LIST, use
1300 Module, use Module VERSION LIST, use VERSION, utime LIST, values HASH, vec
1301 EXPR,OFFSET,BITS, wait, waitpid PID,FLAGS, wantarray, warn LIST, write
1302 FILEHANDLE, write EXPR, write, y///
1303
1304 =back
1305
1306 =head2 perlvar - Perl predefined variables
1307
1308 =item DESCRIPTION
1309
1310 =over
1311
1312 =item Predefined Names
1313
1314 $ARG, $_, $E<lt>I<digits>E<gt>, $MATCH, $&, $PREMATCH, $`, $POSTMATCH, $',
1315 $LAST_PAREN_MATCH, $+, $MULTILINE_MATCHING, $*, input_line_number HANDLE
1316 EXPR, $INPUT_LINE_NUMBER, $NR, $, input_record_separator HANDLE EXPR,
1317 $INPUT_RECORD_SEPARATOR, $RS, $/, autoflush HANDLE EXPR, $OUTPUT_AUTOFLUSH,
1318 $|, output_field_separator HANDLE EXPR, $OUTPUT_FIELD_SEPARATOR, $OFS, $,,
1319 output_record_separator HANDLE EXPR, $OUTPUT_RECORD_SEPARATOR, $ORS, $\,
1320 $LIST_SEPARATOR, $", $SUBSCRIPT_SEPARATOR, $SUBSEP, $;, $OFMT, $#,
1321 format_page_number HANDLE EXPR, $FORMAT_PAGE_NUMBER, $%,
1322 format_lines_per_page HANDLE EXPR, $FORMAT_LINES_PER_PAGE, $=,
1323 format_lines_left HANDLE EXPR, $FORMAT_LINES_LEFT, $-, format_name HANDLE
1324 EXPR, $FORMAT_NAME, $~, format_top_name HANDLE EXPR, $FORMAT_TOP_NAME, $^,
1325 format_line_break_characters HANDLE EXPR, $FORMAT_LINE_BREAK_CHARACTERS,
1326 $:, format_formfeed HANDLE EXPR, $FORMAT_FORMFEED, $^L, $ACCUMULATOR, $^A,
1327 $CHILD_ERROR, $?, $OS_ERROR, $ERRNO, $!, $EXTENDED_OS_ERROR, $^E,
1328 $EVAL_ERROR, $@, $PROCESS_ID, $PID, $$, $REAL_USER_ID, $UID, $<,
1329 $EFFECTIVE_USER_ID, $EUID, $>, $REAL_GROUP_ID, $GID, $(,
1330 $EFFECTIVE_GROUP_ID, $EGID, $), $PROGRAM_NAME, $0, $[, $PERL_VERSION, $],
1331 $DEBUGGING, $^D, $SYSTEM_FD_MAX, $^F, $^H, $INPLACE_EDIT, $^I, $^M,
1332 $OSNAME, $^O, $PERLDB, $^P, 0x01, 0x02, 0x04, 0x08, 0x10, 0x20, $^R, $^S,
1333 $BASETIME, $^T, $WARNING, $^W, $EXECUTABLE_NAME, $^X, $ARGV, @ARGV, @INC,
1334 @_, %INC, %ENV  $ENV{expr}, %SIG  $SIG{expr}
1335
1336 =item Error Indicators
1337
1338 =back
1339
1340 =head2 perlsub - Perl subroutines
1341
1342 =item SYNOPSIS
1343
1344 =item DESCRIPTION
1345
1346 =over
1347
1348 =item Private Variables via C<my()>
1349
1350 =item Peristent Private Variables
1351
1352 =item Temporary Values via local()
1353
1354 =item Passing Symbol Table Entries (typeglobs)
1355
1356 =item When to Still Use local()
1357
1358 1. You need to give a global variable a temporary value, especially C<$_>,
1359 2. You need to create a local file or directory handle or a local function,
1360 3. You want to temporarily change just one element of an array or hash
1361
1362 =item Pass by Reference
1363
1364 =item Prototypes
1365
1366 =item Constant Functions
1367
1368 =item Overriding Builtin Functions
1369
1370 =item Autoloading
1371
1372 =back
1373
1374 =item SEE ALSO
1375
1376 =head2 perlmod - Perl modules (packages and symbol tables)
1377
1378 =item DESCRIPTION
1379
1380 =over
1381
1382 =item Packages
1383
1384 =item Symbol Tables
1385
1386 =item Package Constructors and Destructors
1387
1388 =item Perl Classes
1389
1390 =item Perl Modules
1391
1392 =back
1393
1394 =item SEE ALSO
1395
1396 =head2 perlmodlib - constructing new Perl modules and finding existing ones
1397
1398 =item DESCRIPTION
1399
1400 =item THE PERL MODULE LIBRARY
1401
1402 =over
1403
1404 =item Pragmatic Modules
1405
1406 use autouse MODULE => qw(sub1 sub2 sub3), blib, diagnostics, integer, less,
1407 lib, locale, ops, overload, re, sigtrap, strict, subs, vmsish, vars
1408
1409 =item Standard Modules
1410
1411 AnyDBM_File, AutoLoader, AutoSplit, Benchmark, CPAN, CPAN::FirstTime,
1412 CPAN::Nox, Carp, Class::Struct, Config, Cwd, DB_File, Devel::SelfStubber,
1413 DirHandle, DynaLoader, English, Env, Exporter, ExtUtils::Embed,
1414 ExtUtils::Install, ExtUtils::Liblist, ExtUtils::MM_OS2, ExtUtils::MM_Unix,
1415 ExtUtils::MM_VMS, ExtUtils::MakeMaker, ExtUtils::Manifest,
1416 ExtUtils::Mkbootstrap, ExtUtils::Mksymlists, ExtUtils::testlib, Fatal,
1417 Fcntl, File::Basename, File::CheckTree, File::Compare, File::Copy,
1418 File::Find, File::Path, File::stat, FileCache, FileHandle, FindBin,
1419 GDBM_File, Getopt::Long, Getopt::Std, I18N::Collate, IO, IO::File,
1420 IO::Handle, IO::Pipe, IO::Seekable, IO::Select, IO::Socket, IPC::Open2,
1421 IPC::Open3, Math::BigFloat, Math::BigInt, Math::Complex, Math::Trig,
1422 NDBM_File, Net::Ping, Net::hostent, Net::netent, Net::protoent,
1423 Net::servent, Opcode, Pod::Text, POSIX, SDBM_File, Safe, Search::Dict,
1424 SelectSaver, SelfLoader, Shell, Socket, Symbol, Sys::Hostname, Sys::Syslog,
1425 Term::Cap, Term::Complete, Term::ReadLine, Test::Harness, Text::Abbrev,
1426 Text::ParseWords, Text::Soundex, Text::Tabs, Text::Wrap, Tie::Hash,
1427 Tie::RefHash, Tie::Scalar, Tie::SubstrHash, Time::Local, Time::gmtime,
1428 Time::localtime, Time::tm, UNIVERSAL, User::grent, User::pwent
1429
1430 =item Extension Modules
1431
1432 =back
1433
1434 =item CPAN
1435
1436 Language Extensions and Documentation Tools, Development Support, Operating
1437 System Interfaces, Networking, Device Control (modems) and InterProcess
1438 Communication, Data Types and Data Type Utilities, Database Interfaces,
1439 User Interfaces, Interfaces to / Emulations of Other Programming Languages,
1440 File Names, File Systems and File Locking (see also File Handles), String
1441 Processing, Language Text Processing, Parsing, and Searching, Option,
1442 Argument, Parameter, and Configuration File Processing,
1443 Internationalization and Locale, Authentication, Security, and Encryption,
1444 World Wide Web, HTML, HTTP, CGI, MIME, Server and Daemon Utilities,
1445 Archiving and Compression, Images, Pixmap and Bitmap Manipulation, Drawing,
1446 and Graphing, Mail and Usenet News, Control Flow Utilities (callbacks and
1447 exceptions etc), File Handle and Input/Output Stream Utilities,
1448 Miscellaneous Modules, Africa, Asia, Australasia, Europe, North America,
1449 South America
1450
1451 =item Modules: Creation, Use, and Abuse
1452
1453 =over
1454
1455 =item Guidelines for Module Creation
1456
1457 Do similar modules already exist in some form?, Try to design the new
1458 module to be easy to extend and reuse, Some simple style guidelines, Select
1459 what to export, Select a name for the module, Have you got it right?,
1460 README and other Additional Files, A description of the
1461 module/package/extension etc, A copyright notice - see below, Prerequisites
1462 - what else you may need to have, How to build it - possible changes to
1463 Makefile.PL etc, How to install it, Recent changes in this release,
1464 especially incompatibilities, Changes / enhancements you plan to make in
1465 the future, Adding a Copyright Notice, Give the module a
1466 version/issue/release number, How to release and distribute a module, Take
1467 care when changing a released module
1468
1469 =item Guidelines for Converting Perl 4 Library Scripts into Modules
1470
1471 There is no requirement to convert anything, Consider the implications,
1472 Make the most of the opportunity, The pl2pm utility will get you started,
1473 Adds the standard Module prologue lines, Converts package specifiers from '
1474 to ::, Converts die(...) to croak(...), Several other minor changes
1475
1476 =item Guidelines for Reusing Application Code
1477
1478 Complete applications rarely belong in the Perl Module Library, Many
1479 applications contain some Perl code that could be reused, Break-out the
1480 reusable code into one or more separate module files, Take the opportunity
1481 to reconsider and redesign the interfaces, In some cases the 'application'
1482 can then be reduced to a small
1483
1484 =back
1485
1486 =item NOTE
1487
1488 =head2 perlmodinstall - Installing CPAN Modules
1489
1490 =item DESCRIPTION
1491
1492 =over
1493
1494 =item PREAMBLE
1495
1496 B<DECOMPRESS> the file=item B<UNPACK> the file into a directory
1497 =item B<BUILD> the module (sometimes unnecessary)
1498 =item B<INSTALL> the module
1499
1500 =back
1501
1502 =item HEY
1503
1504 =item AUTHOR
1505
1506 =item COPYRIGHT
1507
1508 =head2 perlform - Perl formats
1509
1510 =item DESCRIPTION
1511
1512 =over
1513
1514 =item Format Variables
1515
1516 =back
1517
1518 =item NOTES
1519
1520 =over
1521
1522 =item Footers
1523
1524 =item Accessing Formatting Internals
1525
1526 =back
1527
1528 =item WARNINGS
1529
1530 =head2 perllocale - Perl locale handling (internationalization and
1531 localization)
1532
1533 =item DESCRIPTION
1534
1535 =item PREPARING TO USE LOCALES
1536
1537 =item USING LOCALES
1538
1539 =over
1540
1541 =item The use locale pragma
1542
1543 =item The setlocale function
1544
1545 =item Finding locales
1546
1547 =item LOCALE PROBLEMS
1548
1549 =item Temporarily fixing locale problems
1550
1551 =item Permanently fixing locale problems
1552
1553 =item Permanently fixing your locale configuration
1554
1555 =item Permanently fixing system locale configuration
1556
1557 =item The localeconv function
1558
1559 =back
1560
1561 =item LOCALE CATEGORIES
1562
1563 =over
1564
1565 =item Category LC_COLLATE: Collation
1566
1567 =item Category LC_CTYPE: Character Types
1568
1569 =item Category LC_NUMERIC: Numeric Formatting
1570
1571 =item Category LC_MONETARY: Formatting of monetary amounts
1572
1573 =item LC_TIME
1574
1575 =item Other categories
1576
1577 =back
1578
1579 =item SECURITY
1580
1581 B<Comparison operators> (C<lt>, C<le>, C<ge>, C<gt> and C<cmp>):,
1582 B<Case-mapping interpolation> (with C<\l>, C<\L>, C<\u> or C<\U>),
1583 B<Matching operator> (C<m//>):, B<Substitution operator> (C<s///>):,
1584 B<In-memory formatting function> (sprintf()):, B<Output formatting
1585 functions> (printf() and write()):, B<Case-mapping functions> (lc(),
1586 lcfirst(), uc(), ucfirst()):, B<POSIX locale-dependent functions>
1587 (localeconv(), strcoll(),strftime(), strxfrm()):, B<POSIX character class
1588 tests> (isalnum(), isalpha(), isdigit(),isgraph(), islower(), isprint(),
1589 ispunct(), isspace(), isupper(),
1590 isxdigit()):
1591
1592 =item ENVIRONMENT
1593
1594 PERL_BADLANG, LC_ALL, LC_CTYPE, LC_COLLATE, LC_MONETARY, LC_NUMERIC,
1595 LC_TIME, LANG
1596
1597 =item NOTES
1598
1599 =over
1600
1601 =item Backward compatibility
1602
1603 =item I18N:Collate obsolete
1604
1605 =item Sort speed and memory use impacts
1606
1607 =item write() and LC_NUMERIC
1608
1609 =item Freely available locale definitions
1610
1611 =item I18n and l10n
1612
1613 =item An imperfect standard
1614
1615 =back
1616
1617 =item BUGS
1618
1619 =over
1620
1621 =item Broken systems
1622
1623 =back
1624
1625 =item SEE ALSO
1626
1627 =item HISTORY
1628
1629 =head2 perlref - Perl references and nested data structures
1630
1631 =item DESCRIPTION
1632
1633 =over
1634
1635 =item Making References
1636
1637 =item Using References
1638
1639 =item Symbolic references
1640
1641 =item Not-so-symbolic references
1642
1643 =item Pseudo-hashes: Using an array as a hash
1644
1645 =item Function Templates
1646
1647 =back
1648
1649 =item WARNING
1650
1651 =item SEE ALSO
1652
1653 =head2 perldsc - Perl Data Structures Cookbook
1654
1655 =item DESCRIPTION
1656
1657 arrays of arrays, hashes of arrays, arrays of hashes, hashes of hashes,
1658 more elaborate constructs
1659
1660 =item REFERENCES
1661
1662 =item COMMON MISTAKES
1663
1664 =item CAVEAT ON PRECEDENCE
1665
1666 =item WHY YOU SHOULD ALWAYS C<use strict>
1667
1668 =item DEBUGGING
1669
1670 =item CODE EXAMPLES
1671
1672 =item LISTS OF LISTS
1673
1674 =over
1675
1676 =item Declaration of a LIST OF LISTS
1677
1678 =item Generation of a LIST OF LISTS
1679
1680 =item Access and Printing of a LIST OF LISTS
1681
1682 =back
1683
1684 =item HASHES OF LISTS
1685
1686 =over
1687
1688 =item Declaration of a HASH OF LISTS
1689
1690 =item Generation of a HASH OF LISTS
1691
1692 =item Access and Printing of a HASH OF LISTS
1693
1694 =back
1695
1696 =item LISTS OF HASHES
1697
1698 =over
1699
1700 =item Declaration of a LIST OF HASHES
1701
1702 =item Generation of a LIST OF HASHES
1703
1704 =item Access and Printing of a LIST OF HASHES
1705
1706 =back
1707
1708 =item HASHES OF HASHES
1709
1710 =over
1711
1712 =item Declaration of a HASH OF HASHES
1713
1714 =item Generation of a HASH OF HASHES
1715
1716 =item Access and Printing of a HASH OF HASHES
1717
1718 =back
1719
1720 =item MORE ELABORATE RECORDS
1721
1722 =over
1723
1724 =item Declaration of MORE ELABORATE RECORDS
1725
1726 =item Declaration of a HASH OF COMPLEX RECORDS
1727
1728 =item Generation of a HASH OF COMPLEX RECORDS
1729
1730 =back
1731
1732 =item Database Ties
1733
1734 =item SEE ALSO
1735
1736 =item AUTHOR
1737
1738 =head2 perllol, perlLoL - Manipulating Lists of Lists in Perl
1739
1740 =item DESCRIPTION
1741
1742 =item Declaration and Access of Lists of Lists
1743
1744 =item Growing Your Own
1745
1746 =item Access and Printing
1747
1748 =item Slices
1749
1750 =item SEE ALSO
1751
1752 =item AUTHOR
1753
1754 =head2 perltoot - Tom's object-oriented tutorial for perl
1755
1756 =item DESCRIPTION
1757
1758 =item Creating a Class
1759
1760 =over
1761
1762 =item Object Representation
1763
1764 =item Class Interface
1765
1766 =item Constructors and Instance Methods
1767
1768 =item Planning for the Future: Better Constructors
1769
1770 =item Destructors
1771
1772 =item Other Object Methods
1773
1774 =back
1775
1776 =item Class Data
1777
1778 =over
1779
1780 =item Accessing Class Data
1781
1782 =item Debugging Methods
1783
1784 =item Class Destructors
1785
1786 =item Documenting the Interface
1787
1788 =back
1789
1790 =item Aggregation
1791
1792 =item Inheritance
1793
1794 =over
1795
1796 =item Overridden Methods
1797
1798 =item Multiple Inheritance
1799
1800 =item UNIVERSAL: The Root of All Objects
1801
1802 =back
1803
1804 =item Alternate Object Representations
1805
1806 =over
1807
1808 =item Arrays as Objects
1809
1810 =item Closures as Objects
1811
1812 =back
1813
1814 =item AUTOLOAD: Proxy Methods
1815
1816 =over
1817
1818 =item Autoloaded Data Methods
1819
1820 =item Inherited Autoloaded Data Methods
1821
1822 =back
1823
1824 =item Metaclassical Tools
1825
1826 =over
1827
1828 =item Class::Struct
1829
1830 =item Data Members as Variables
1831
1832 =item NOTES
1833
1834 =item Object Terminology
1835
1836 =back
1837
1838 =item SEE ALSO
1839
1840 =item AUTHOR AND COPYRIGHT
1841
1842 =item COPYRIGHT
1843
1844 =over
1845
1846 =item Acknowledgments
1847
1848 =back
1849
1850 =head2 perlobj - Perl objects
1851
1852 =item DESCRIPTION
1853
1854 =over
1855
1856 =item An Object is Simply a Reference
1857
1858 =item A Class is Simply a Package
1859
1860 =item A Method is Simply a Subroutine
1861
1862 =item Method Invocation
1863
1864 =item Default UNIVERSAL methods
1865
1866 isa(CLASS), can(METHOD), VERSION( [NEED] )
1867
1868 =item Destructors
1869
1870 =item WARNING
1871
1872 =item Summary
1873
1874 =item Two-Phased Garbage Collection
1875
1876 =back
1877
1878 =item SEE ALSO
1879
1880 =head2 perltie - how to hide an object class in a simple variable
1881
1882 =item SYNOPSIS
1883
1884 =item DESCRIPTION
1885
1886 =over
1887
1888 =item Tying Scalars
1889
1890 TIESCALAR classname, LIST, FETCH this, STORE this, value, DESTROY this
1891
1892 =item Tying Arrays
1893
1894 TIEARRAY classname, LIST, FETCH this, index, STORE this, index, value,
1895 DESTROY this
1896
1897 =item Tying Hashes
1898
1899 USER, HOME, CLOBBER, LIST, TIEHASH classname, LIST, FETCH this, key, STORE
1900 this, key, value, DELETE this, key, CLEAR this, EXISTS this, key, FIRSTKEY
1901 this, NEXTKEY this, lastkey, DESTROY this
1902
1903 =item Tying FileHandles
1904
1905 TIEHANDLE classname, LIST, WRITE this, LIST, PRINT this, LIST, PRINTF this,
1906 LIST, READ this, LIST, READLINE this, GETC this, CLOSE this, DESTROY this
1907
1908 =item The C<untie> Gotcha
1909
1910 =back
1911
1912 =item SEE ALSO
1913
1914 =item BUGS
1915
1916 =item AUTHOR
1917
1918 =head2 perlbot - Bag'o Object Tricks (the BOT)
1919
1920 =item DESCRIPTION
1921
1922 =item OO SCALING TIPS
1923
1924 =item INSTANCE VARIABLES
1925
1926 =item SCALAR INSTANCE VARIABLES
1927
1928 =item INSTANCE VARIABLE INHERITANCE
1929
1930 =item OBJECT RELATIONSHIPS
1931
1932 =item OVERRIDING SUPERCLASS METHODS
1933
1934 =item USING RELATIONSHIP WITH SDBM
1935
1936 =item THINKING OF CODE REUSE
1937
1938 =item CLASS CONTEXT AND THE OBJECT
1939
1940 =item INHERITING A CONSTRUCTOR
1941
1942 =item DELEGATION
1943
1944 =head2 perlipc - Perl interprocess communication (signals, fifos, pipes,
1945 safe subprocesses, sockets, and semaphores)
1946
1947 =item DESCRIPTION
1948
1949 =item Signals
1950
1951 =item Named Pipes
1952
1953 =over
1954
1955 =item WARNING
1956
1957 =back
1958
1959 =item Using open() for IPC
1960
1961 =over
1962
1963 =item Filehandles
1964
1965 =item Background Processes
1966
1967 =item Complete Dissociation of Child from Parent
1968
1969 =item Safe Pipe Opens
1970
1971 =item Bidirectional Communication with Another Process
1972
1973 =item Bidirectional Communication with Yourself
1974
1975 =back
1976
1977 =item Sockets: Client/Server Communication
1978
1979 =over
1980
1981 =item Internet Line Terminators
1982
1983 =item Internet TCP Clients and Servers
1984
1985 =item Unix-Domain TCP Clients and Servers
1986
1987 =back
1988
1989 =item TCP Clients with IO::Socket
1990
1991 =over
1992
1993 =item A Simple Client
1994
1995 C<Proto>, C<PeerAddr>, C<PeerPort>
1996
1997 =item A Webget Client
1998
1999 =item Interactive Client with IO::Socket
2000
2001 =back
2002
2003 =item TCP Servers with IO::Socket
2004
2005 Proto, LocalPort, Listen, Reuse
2006
2007 =item UDP: Message Passing
2008
2009 =item SysV IPC
2010
2011 =item NOTES
2012
2013 =item BUGS
2014
2015 =item AUTHOR
2016
2017 =item SEE ALSO
2018
2019 =head2 perldebug - Perl debugging
2020
2021 =item DESCRIPTION
2022
2023 =item The Perl Debugger
2024
2025 =over
2026
2027 =item Debugger Commands
2028
2029 h [command], p expr, x expr, V [pkg [vars]], X [vars], T, s [expr], n
2030 [expr], E<lt>CRE<gt>, c [line|sub], l, l min+incr, l min-max, l line, l
2031 subname, -, w [line], f filename, /pattern/, ?pattern?, L, S [[!]pattern],
2032 t, t expr, b [line] [condition], b subname [condition], b postpone subname
2033 [condition], b load filename, b compile subname, d [line], D, a [line]
2034 command, A, W [expr], W, O [opt[=val]] [opt"val"] [opt?]..,
2035 C<recallCommand>, C<ShellBang>, C<pager>, C<tkRunning>, C<signalLevel>,
2036 C<warnLevel>, C<dieLevel>, C<AutoTrace>, C<LineInfo>, C<inhibit_exit>,
2037 C<PrintRet>, C<ornaments>, C<frame>, C<maxTraceLen>, C<arrayDepth>,
2038 C<hashDepth>, C<compactDump>, C<veryCompact>, C<globPrint>, C<DumpDBFiles>,
2039 C<DumpPackages>, C<DumpReused>, C<quote>, C<HighBit>, C<undefPrint>,
2040 C<UsageOnly>, C<TTY>, C<noTTY>, C<ReadLine>, C<NonStop>, E<lt> [ command ],
2041 E<lt>E<lt> command, E<gt> command, E<gt>E<gt> command, { [ command ], {{
2042 command, ! number, ! -number, ! pattern, !! cmd, H -number, q or ^D, R,
2043 |dbcmd, ||dbcmd, command, m expr, m package
2044
2045 =item Debugger input/output
2046
2047 Prompt, Multiline commands, Stack backtrace, Listing, Frame listing
2048
2049 =item Debugging compile-time statements
2050
2051 =item Debugger Customization
2052
2053 =item Readline Support
2054
2055 =item Editor Support for Debugging
2056
2057 =item The Perl Profiler
2058
2059 =item Debugger support in perl
2060
2061 =item Debugger Internals
2062
2063 =item Other resources
2064
2065 =item BUGS
2066
2067 =back
2068
2069 =item Debugging Perl memory usage
2070
2071 =over
2072
2073 =item Using C<$ENV{PERL_DEBUG_MSTATS}>
2074
2075 C<buckets SMALLEST(APPROX)..GREATEST(APPROX)>, Free/Used, C<Total sbrk():
2076 SBRKed/SBRKs:CONTINUOUS>, C<pad: 0>, C<heads: 2192>, C<chain: 0>, C<tail:
2077 6144>
2078
2079 =item Example of using B<-DL> switch
2080
2081 C<717>, C<002>, C<054>, C<602>, C<702>, C<704>
2082
2083 =item B<-DL> details
2084
2085 C<!!!>, C<!!>, C<!>
2086
2087 =item Limitations of B<-DL> statistic
2088
2089 =back
2090
2091 =item Debugging regular expressions
2092
2093 =over
2094
2095 =item Compile-time output
2096
2097 C<anchored> I<STRING> C<at> I<POS>, C<floating> I<STRING> C<at>
2098 I<POS1..POS2>, C<matching floating/anchored>, C<minlen>, C<stclass>
2099 I<TYPE>, C<noscan>, C<isall>, C<GPOS>, C<plus>, C<implicit>, C<with eval>,
2100 C<anchored(TYPE)>
2101
2102 =item Types of nodes
2103
2104 =item Run-time output
2105
2106 =back
2107
2108 =head2 perldiag - various Perl diagnostics
2109
2110 =item DESCRIPTION
2111
2112 =head2 perlsec - Perl security
2113
2114 =item DESCRIPTION
2115
2116 =over
2117
2118 =item Laundering and Detecting Tainted Data
2119
2120 =item Switches On the "#!" Line
2121
2122 =item Cleaning Up Your Path
2123
2124 =item Security Bugs
2125
2126 =item Protecting Your Programs
2127
2128 =back
2129
2130 =item SEE ALSO
2131
2132 =head2 perltrap - Perl traps for the unwary
2133
2134 =item DESCRIPTION
2135
2136 =over
2137
2138 =item Awk Traps
2139
2140 =item C Traps
2141
2142 =item Sed Traps
2143
2144 =item Shell Traps
2145
2146 =item Perl Traps
2147
2148 =item Perl4 to Perl5 Traps
2149
2150 Discontinuance, Deprecation, and BugFix traps, Parsing Traps, Numerical
2151 Traps, General data type traps, Context Traps - scalar, list contexts,
2152 Precedence Traps, General Regular Expression Traps using s///, etc,
2153 Subroutine, Signal, Sorting Traps, OS Traps, DBM Traps, Unclassified Traps
2154
2155 =item Discontinuance, Deprecation, and BugFix traps
2156
2157 Discontinuance, Deprecation, BugFix, Discontinuance, Discontinuance,
2158 Discontinuance, BugFix, Discontinuance, Discontinuance, BugFix,
2159 Discontinuance, Discontinuance, Deprecation, Discontinuance
2160
2161 =item Parsing Traps
2162
2163 Parsing, Parsing, Parsing, Parsing
2164
2165 =item Numerical Traps
2166
2167 Numerical, Numerical, Numerical
2168
2169 =item General data type traps
2170
2171 (Arrays), (Arrays), (Hashes), (Globs), (Globs), (Scalar String),
2172 (Constants), (Scalars), (Variable Suicide)
2173
2174 =item Context Traps - scalar, list contexts
2175
2176 (list context), (scalar context), (scalar context), (list, builtin)
2177
2178 =item Precedence Traps
2179
2180 Precedence, Precedence, Precedence, Precedence, Precedence, Precedence,
2181 Precedence
2182
2183 =item General Regular Expression Traps using s///, etc.
2184
2185 Regular Expression, Regular Expression, Regular Expression, Regular
2186 Expression, Regular Expression, Regular Expression, Regular Expression,
2187 Regular Expression
2188
2189 =item Subroutine, Signal, Sorting Traps
2190
2191 (Signals), (Sort Subroutine), warn() won't let you specify a filehandle
2192
2193 =item OS Traps
2194
2195 (SysV), (SysV)
2196
2197 =item Interpolation Traps
2198
2199 Interpolation, Interpolation, Interpolation, Interpolation, Interpolation,
2200 Interpolation, Interpolation, Interpolation, Interpolation
2201
2202 =item DBM Traps
2203
2204 DBM, DBM
2205
2206 =item Unclassified Traps
2207
2208 C<require>/C<do> trap using returned value, C<split> on empty string with
2209 LIMIT specified
2210
2211 =back
2212
2213 =head2 perlport - Writing portable Perl
2214
2215 =item DESCRIPTION
2216
2217 Not all Perl programs have to be portable, The vast majority of Perl B<is>
2218 portable
2219
2220 =item ISSUES
2221
2222 =over
2223
2224 =item Newlines
2225
2226 =item File Paths
2227
2228 =item System Interaction
2229
2230 =item Interprocess Communication (IPC)
2231
2232 =item External Subroutines (XS)
2233
2234 =item Standard Modules
2235
2236 =item Time and Date
2237
2238 =item System Resources
2239
2240 =item Security
2241
2242 =item Style
2243
2244 =back
2245
2246 =item CPAN TESTERS
2247
2248 Mailing list: cpan-testers@perl.org, Testing results:
2249 C<http://www.connect.net/gbarr/cpan-test/>
2250
2251 =item PLATFORMS
2252
2253 =over
2254
2255 =item Unix
2256
2257 =item DOS and Derivatives
2258
2259 The djgpp environment for DOS, C<http://www.delorie.com/djgpp/>, The EMX
2260 environment for DOS, OS/2, etc.
2261 C<emx@iaehv.nl>,C<http://www.juge.com/bbs/Hobb.19.html>, Build instructions
2262 for Win32, L<perlwin32>, The ActiveState Pages,
2263 C<http://www.activestate.com/>
2264
2265 =item MacPerl
2266
2267 The MacPerl Pages, C<http://www.ptf.com/macperl/>, The MacPerl mailing
2268 list, C<mac-perl-request@iis.ee.ethz.ch>
2269
2270 =item VMS
2271
2272 L<perlvms.pod>, vmsperl list, C<vmsperl-request@newman.upenn.edu>, vmsperl
2273 on the web, C<http://www.sidhe.org/vmsperl/index.html>
2274
2275 =item EBCDIC Platforms
2276
2277 perl-mvs list, AS/400 Perl information at C<http://as400.rochester.ibm.com>
2278
2279 =item Other perls
2280
2281 Atari, Guido Flohr's page C<http://stud.uni-sb.de/~gufl0000/>, HP 300
2282 MPE/iX  C<http://www.cccd.edu/~markb/perlix.html>, Novell Netware
2283
2284 =back
2285
2286 =item FUNCTION IMPLEMENTATIONS
2287
2288 =over
2289
2290 =item Alphabetical Listing of Perl Functions
2291
2292 -I<X> FILEHANDLE, -I<X> EXPR, -I<X>, binmode FILEHANDLE, chmod LIST, chown
2293 LIST, chroot FILENAME, chroot, crypt PLAINTEXT,SALT, dbmclose HASH, dbmopen
2294 HASH,DBNAME,MODE, dump LABEL, exec LIST, fcntl FILEHANDLE,FUNCTION,SCALAR,
2295 flock FILEHANDLE,OPERATION, fork, getlogin, getpgrp PID, getppid,
2296 getpriority WHICH,WHO, getpwnam NAME, getgrnam NAME, getnetbyname NAME,
2297 getpwuid UID, getgrgid GID, getnetbyaddr ADDR,ADDRTYPE, getprotobynumber
2298 NUMBER, getservbyport PORT,PROTO, getpwent, getgrent, gethostent,
2299 getnetent, getprotoent, getservent, setpwent, setgrent, sethostent
2300 STAYOPEN, setnetent STAYOPEN, setprotoent STAYOPEN, setservent STAYOPEN,
2301 endpwent, endgrent, endhostent, endnetent, endprotoent, endservent,
2302 getsockopt SOCKET,LEVEL,OPTNAME, glob EXPR, glob, ioctl
2303 FILEHANDLE,FUNCTION,SCALAR, kill LIST, link OLDFILE,NEWFILE, lstat
2304 FILEHANDLE, lstat EXPR, lstat, msgctl ID,CMD,ARG, msgget KEY,FLAGS, msgsnd
2305 ID,MSG,FLAGS, msgrcv ID,VAR,SIZE,TYPE,FLAGS, open FILEHANDLE,EXPR, open
2306 FILEHANDLE, pipe READHANDLE,WRITEHANDLE, readlink EXPR, readlink, select
2307 RBITS,WBITS,EBITS,TIMEOUT, semctl ID,SEMNUM,CMD,ARG, semget
2308 KEY,NSEMS,FLAGS, semop KEY,OPSTRING, setpgrp PID,PGRP, setpriority
2309 WHICH,WHO,PRIORITY, setsockopt SOCKET,LEVEL,OPTNAME,OPTVAL, shmctl
2310 ID,CMD,ARG, shmget KEY,SIZE,FLAGS, shmread ID,VAR,POS,SIZE, shmwrite
2311 ID,STRING,POS,SIZE, socketpair SOCKET1,SOCKET2,DOMAIN,TYPE,PROTOCOL, stat
2312 FILEHANDLE, stat EXPR, stat, symlink OLDFILE,NEWFILE, syscall LIST, system
2313 LIST, times, truncate FILEHANDLE,LENGTH, truncate EXPR,LENGTH, umask EXPR,
2314 umask, utime LIST, wait, waitpid PID,FLAGS
2315
2316 =back
2317
2318 =item AUTHORS / CONTRIBUTORS
2319
2320 =item VERSION
2321
2322 =head2 perlstyle - Perl style guide
2323
2324 =item DESCRIPTION
2325
2326 =head2 perlpod - plain old documentation
2327
2328 =item DESCRIPTION
2329
2330 =over
2331
2332 =item Verbatim Paragraph
2333
2334 =item Command Paragraph
2335
2336 =item Ordinary Block of Text
2337
2338 =item The Intent
2339
2340 =item Embedding Pods in Perl Modules
2341
2342 =item Common Pod Pitfalls
2343
2344 =back
2345
2346 =item SEE ALSO
2347
2348 =item AUTHOR
2349
2350 =head2 perlbook - Perl book information
2351
2352 =item DESCRIPTION
2353
2354 =head2 perlembed - how to embed perl in your C program
2355
2356 =item DESCRIPTION
2357
2358 =over
2359
2360 =item PREAMBLE
2361
2362 B<Use C from Perl?>, B<Use a Unix program from Perl?>, B<Use Perl from
2363 Perl?>, B<Use C from C?>, B<Use Perl from C?>
2364
2365 =item ROADMAP
2366
2367 =item Compiling your C program
2368
2369 =item Adding a Perl interpreter to your C program
2370
2371 =item Calling a Perl subroutine from your C program
2372
2373 =item Evaluating a Perl statement from your C program
2374
2375 =item Performing Perl pattern matches and substitutions from your C program
2376
2377 =item Fiddling with the Perl stack from your C program
2378
2379 =item Maintaining a persistent interpreter
2380
2381 =item Maintaining multiple interpreter instances
2382
2383 =item Using Perl modules, which themselves use C libraries, from your C
2384 program
2385
2386 =back
2387
2388 =item Embedding Perl under Win32
2389
2390 =item MORAL
2391
2392 =item AUTHOR
2393
2394 =item COPYRIGHT
2395
2396 =head2 perlapio - perl's IO abstraction interface.
2397
2398 =item SYNOPSIS
2399
2400 =item DESCRIPTION
2401
2402 B<PerlIO *>, B<PerlIO_stdin()>, B<PerlIO_stdout()>, B<PerlIO_stderr()>,
2403 B<PerlIO_open(path, mode)>, B<PerlIO_fdopen(fd,mode)>,
2404 B<PerlIO_printf(f,fmt,...)>, B<PerlIO_vprintf(f,fmt,a)>,
2405 B<PerlIO_stdoutf(fmt,...)>, B<PerlIO_read(f,buf,count)>,
2406 B<PerlIO_write(f,buf,count)>, B<PerlIO_close(f)>, B<PerlIO_puts(f,s)>,
2407 B<PerlIO_putc(f,c)>, B<PerlIO_ungetc(f,c)>, B<PerlIO_getc(f)>,
2408 B<PerlIO_eof(f)>, B<PerlIO_error(f)>, B<PerlIO_fileno(f)>,
2409 B<PerlIO_clearerr(f)>, B<PerlIO_flush(f)>, B<PerlIO_tell(f)>,
2410 B<PerlIO_seek(f,o,w)>, B<PerlIO_getpos(f,p)>, B<PerlIO_setpos(f,p)>,
2411 B<PerlIO_rewind(f)>, B<PerlIO_tmpfile()>
2412
2413 =over
2414
2415 =item Co-existence with stdio
2416
2417 B<PerlIO_importFILE(f,flags)>, B<PerlIO_exportFILE(f,flags)>,
2418 B<PerlIO_findFILE(f)>, B<PerlIO_releaseFILE(p,f)>, B<PerlIO_setlinebuf(f)>,
2419 B<PerlIO_has_cntptr(f)>, B<PerlIO_get_ptr(f)>, B<PerlIO_get_cnt(f)>,
2420 B<PerlIO_canset_cnt(f)>, B<PerlIO_fast_gets(f)>,
2421 B<PerlIO_set_ptrcnt(f,p,c)>, B<PerlIO_set_cnt(f,c)>, B<PerlIO_has_base(f)>,
2422 B<PerlIO_get_base(f)>, B<PerlIO_get_bufsiz(f)>
2423
2424 =back
2425
2426 =head2 perlxs - XS language reference manual
2427
2428 =item DESCRIPTION
2429
2430 =over
2431
2432 =item Introduction
2433
2434 =item On The Road
2435
2436 =item The Anatomy of an XSUB
2437
2438 =item The Argument Stack
2439
2440 =item The RETVAL Variable
2441
2442 =item The MODULE Keyword
2443
2444 =item The PACKAGE Keyword
2445
2446 =item The PREFIX Keyword
2447
2448 =item The OUTPUT: Keyword
2449
2450 =item The CODE: Keyword
2451
2452 =item The INIT: Keyword
2453
2454 =item The NO_INIT Keyword
2455
2456 =item Initializing Function Parameters
2457
2458 =item Default Parameter Values
2459
2460 =item The PREINIT: Keyword
2461
2462 =item The SCOPE: Keyword
2463
2464 =item The INPUT: Keyword
2465
2466 =item Variable-length Parameter Lists
2467
2468 =item The C_ARGS: Keyword
2469
2470 =item The PPCODE: Keyword
2471
2472 =item Returning Undef And Empty Lists
2473
2474 =item The REQUIRE: Keyword
2475
2476 =item The CLEANUP: Keyword
2477
2478 =item The BOOT: Keyword
2479
2480 =item The VERSIONCHECK: Keyword
2481
2482 =item The PROTOTYPES: Keyword
2483
2484 =item The PROTOTYPE: Keyword
2485
2486 =item The ALIAS: Keyword
2487
2488 =item The INTERFACE: Keyword
2489
2490 =item The INTERFACE_MACRO: Keyword
2491
2492 =item The INCLUDE: Keyword
2493
2494 =item The CASE: Keyword
2495
2496 =item The & Unary Operator
2497
2498 =item Inserting Comments and C Preprocessor Directives
2499
2500 =item Using XS With C++
2501
2502 =item Interface Strategy
2503
2504 =item Perl Objects And C Structures
2505
2506 =item The Typemap
2507
2508 =back
2509
2510 =item EXAMPLES
2511
2512 =item XS VERSION
2513
2514 =item AUTHOR
2515
2516 =head2 perlxstut, perlXStut - Tutorial for XSUBs
2517
2518 =item DESCRIPTION
2519
2520 =over
2521
2522 =item VERSION CAVEAT
2523
2524 =item DYNAMIC VERSUS STATIC
2525
2526 =item EXAMPLE 1
2527
2528 =item EXAMPLE 2
2529
2530 =item WHAT HAS GONE ON?
2531
2532 =item WRITING GOOD TEST SCRIPTS
2533
2534 =item EXAMPLE 3
2535
2536 =item WHAT'S NEW HERE?
2537
2538 =item INPUT AND OUTPUT PARAMETERS
2539
2540 =item THE XSUBPP COMPILER
2541
2542 =item THE TYPEMAP FILE
2543
2544 =item WARNING
2545
2546 =item EXAMPLE 4
2547
2548 =item WHAT HAS HAPPENED HERE?
2549
2550 =item SPECIFYING ARGUMENTS TO XSUBPP
2551
2552 =item THE ARGUMENT STACK
2553
2554 =item EXTENDING YOUR EXTENSION
2555
2556 =item DOCUMENTING YOUR EXTENSION
2557
2558 =item INSTALLING YOUR EXTENSION
2559
2560 =item SEE ALSO
2561
2562 =item Author
2563
2564 =item Last Changed
2565
2566 =back
2567
2568 =head2 perlguts - Perl's Internal Functions
2569
2570 =item DESCRIPTION
2571
2572 =item Variables
2573
2574 =over
2575
2576 =item Datatypes
2577
2578 =item What is an "IV"?
2579
2580 =item Working with SVs
2581
2582 =item What's Really Stored in an SV?
2583
2584 =item Working with AVs
2585
2586 =item Working with HVs
2587
2588 =item Hash API Extensions
2589
2590 =item References
2591
2592 =item Blessed References and Class Objects
2593
2594 =item Creating New Variables
2595
2596 =item Reference Counts and Mortality
2597
2598 =item Stashes and Globs
2599
2600 =item Double-Typed SVs
2601
2602 =item Magic Variables
2603
2604 =item Assigning Magic
2605
2606 =item Magic Virtual Tables
2607
2608 =item Finding Magic
2609
2610 =item Understanding the Magic of Tied Hashes and Arrays
2611
2612 =item Localizing changes
2613
2614 C<SAVEINT(int i)>, C<SAVEIV(IV i)>, C<SAVEI32(I32 i)>, C<SAVELONG(long i)>,
2615 C<SAVESPTR(s)>, C<SAVEPPTR(p)>, C<SAVEFREESV(SV *sv)>, C<SAVEFREEOP(OP
2616 *op)>, C<SAVEFREEPV(p)>, C<SAVECLEARSV(SV *sv)>, C<SAVEDELETE(HV *hv, char
2617 *key, I32 length)>, C<SAVEDESTRUCTOR(f,p)>, C<SAVESTACK_POS()>, C<SV*
2618 save_scalar(GV *gv)>, C<AV* save_ary(GV *gv)>, C<HV* save_hash(GV *gv)>,
2619 C<void save_item(SV *item)>, C<void save_list(SV **sarg, I32 maxsarg)>,
2620 C<SV* save_svref(SV **sptr)>, C<void save_aptr(AV **aptr)>, C<void
2621 save_hptr(HV **hptr)>
2622
2623 =back
2624
2625 =item Subroutines
2626
2627 =over
2628
2629 =item XSUBs and the Argument Stack
2630
2631 =item Calling Perl Routines from within C Programs
2632
2633 =item Memory Allocation
2634
2635 =item PerlIO
2636
2637 =item Putting a C value on Perl stack
2638
2639 =item Scratchpads
2640
2641 =item Scratchpads and recursion
2642
2643 =back
2644
2645 =item Compiled code
2646
2647 =over
2648
2649 =item Code tree
2650
2651 =item Examining the tree
2652
2653 =item Compile pass 1: check routines
2654
2655 =item Compile pass 1a: constant folding
2656
2657 =item Compile pass 2: context propagation
2658
2659 =item Compile pass 3: peephole optimization
2660
2661 =back
2662
2663 =item API LISTING
2664
2665 av_clear, av_extend, av_fetch, AvFILL, av_len, av_make, av_pop, av_push,
2666 av_shift, av_store, av_undef, av_unshift, CLASS, Copy, croak, CvSTASH,
2667 PL_DBsingle, PL_DBsub, PL_DBtrace, dMARK, dORIGMARK, PL_dowarn, dSP,
2668 dXSARGS, dXSI32, do_binmode, ENTER, EXTEND, fbm_compile, fbm_instr,
2669 FREETMPS, G_ARRAY, G_DISCARD, G_EVAL, GIMME, GIMME_V, G_NOARGS, G_SCALAR,
2670 gv_fetchmeth, gv_fetchmethod, gv_fetchmethod_autoload, G_VOID, gv_stashpv,
2671 gv_stashsv, GvSV, HEf_SVKEY, HeHASH, HeKEY, HeKLEN, HePV, HeSVKEY,
2672 HeSVKEY_force, HeSVKEY_set, HeVAL, hv_clear, hv_delayfree_ent, hv_delete,
2673 hv_delete_ent, hv_exists, hv_exists_ent, hv_fetch, hv_fetch_ent,
2674 hv_free_ent, hv_iterinit, hv_iterkey, hv_iterkeysv, hv_iternext,
2675 hv_iternextsv, hv_iterval, hv_magic, HvNAME, hv_store, hv_store_ent,
2676 hv_undef, isALNUM, isALPHA, isDIGIT, isLOWER, isSPACE, isUPPER, items, ix,
2677 LEAVE, looks_like_number, MARK, mg_clear, mg_copy, mg_find, mg_free,
2678 mg_get, mg_len, mg_magical, mg_set, Move, PL_na, New, newAV, Newc,
2679 newCONSTSUB, newHV, newRV_inc, newRV_noinc, NEWSV, newSViv, newSVnv,
2680 newSVpv, newSVpvf, newSVpvn, newSVrv, newSVsv, newXS, newXSproto, Newz,
2681 Nullav, Nullch, Nullcv, Nullhv, Nullsv, ORIGMARK, perl_alloc,
2682 perl_call_argv, perl_call_method, perl_call_pv, perl_call_sv,
2683 perl_construct, perl_destruct, perl_eval_sv, perl_eval_pv, perl_free,
2684 perl_get_av, perl_get_cv, perl_get_hv, perl_get_sv, perl_parse,
2685 perl_require_pv, perl_run, POPi, POPl, POPp, POPn, POPs, PUSHMARK, PUSHi,
2686 PUSHn, PUSHp, PUSHs, PUSHu, PUTBACK, Renew, Renewc, RETVAL, safefree,
2687 safemalloc, saferealloc, savepv, savepvn, SAVETMPS, SP, SPAGAIN, ST, strEQ,
2688 strGE, strGT, strLE, strLT, strNE, strnEQ, strnNE, sv_2mortal, sv_bless,
2689 sv_catpv, sv_catpv_mg, sv_catpvn, sv_catpvn_mg, sv_catpvf, sv_catpvf_mg,
2690 sv_catsv, sv_catsv_mg, sv_chop, sv_cmp, SvCUR, SvCUR_set, sv_dec,
2691 sv_derived_from, sv_derived_from, SvEND, sv_eq, SvGETMAGIC, SvGROW,
2692 sv_grow, sv_inc, sv_insert, SvIOK, SvIOK_off, SvIOK_on, SvIOK_only, SvIOKp,
2693 sv_isa, sv_isobject, SvIV, SvIVX, SvLEN, sv_len, sv_magic, sv_mortalcopy,
2694 sv_newmortal, SvNIOK, SvNIOK_off, SvNIOKp, PL_sv_no, SvNOK, SvNOK_off,
2695 SvNOK_on, SvNOK_only, SvNOKp, SvNV, SvNVX, SvOK, SvOOK, SvPOK, SvPOK_off,
2696 SvPOK_on, SvPOK_only, SvPOKp, SvPV, SvPV_force, SvPVX, SvREFCNT,
2697 SvREFCNT_dec, SvREFCNT_inc, SvROK, SvROK_off, SvROK_on, SvRV, SvSETMAGIC,
2698 sv_setiv, sv_setiv_mg, sv_setnv, sv_setnv_mg, sv_setpv, sv_setpv_mg,
2699 sv_setpviv, sv_setpviv_mg, sv_setpvn, sv_setpvn_mg, sv_setpvf,
2700 sv_setpvf_mg, sv_setref_iv, sv_setref_nv, sv_setref_pv, sv_setref_pvn,
2701 SvSetSV, SvSetSV_nosteal, sv_setsv, sv_setsv_mg, sv_setuv, sv_setuv_mg,
2702 SvSTASH, SvTAINT, SvTAINTED, SvTAINTED_off, SvTAINTED_on, SVt_IV, SVt_PV,
2703 SVt_PVAV, SVt_PVCV, SVt_PVHV, SVt_PVMG, SVt_NV, SvTRUE, SvTYPE, svtype,
2704 PL_sv_undef, sv_unref, SvUPGRADE, sv_upgrade, sv_usepvn, sv_usepvn_mg,
2705 sv_vcatpvfn(sv, pat, patlen, args, svargs, svmax, used_locale),
2706 sv_vsetpvfn(sv, pat, patlen, args, svargs, svmax, used_locale), SvUV,
2707 SvUVX, PL_sv_yes, THIS, toLOWER, toUPPER, warn, XPUSHi, XPUSHn, XPUSHp,
2708 XPUSHs, XPUSHu, XS, XSRETURN, XSRETURN_EMPTY, XSRETURN_IV, XSRETURN_NO,
2709 XSRETURN_NV, XSRETURN_PV, XSRETURN_UNDEF, XSRETURN_YES, XST_mIV, XST_mNV,
2710 XST_mNO, XST_mPV, XST_mUNDEF, XST_mYES, XS_VERSION, XS_VERSION_BOOTCHECK,
2711 Zero
2712
2713 =item AUTHORS
2714
2715 =head2 perlcall - Perl calling conventions from C
2716
2717 =item DESCRIPTION
2718
2719 An Error Handler, An Event Driven Program
2720
2721 =item THE PERL_CALL FUNCTIONS
2722
2723 B<perl_call_sv>, B<perl_call_pv>, B<perl_call_method>, B<perl_call_argv>
2724
2725 =item FLAG VALUES
2726
2727 =over
2728
2729 =item  G_VOID
2730
2731 =item  G_SCALAR
2732
2733 =item G_ARRAY
2734
2735 =item G_DISCARD
2736
2737 =item G_NOARGS
2738
2739 =item G_EVAL
2740
2741 =item G_KEEPERR
2742
2743 =item Determining the Context
2744
2745 =back
2746
2747 =item KNOWN PROBLEMS
2748
2749 =item EXAMPLES
2750
2751 =over
2752
2753 =item No Parameters, Nothing returned
2754
2755 =item Passing Parameters
2756
2757 =item Returning a Scalar
2758
2759 =item Returning a list of values
2760
2761 =item Returning a list in a scalar context
2762
2763 =item Returning Data from Perl via the parameter list
2764
2765 =item Using G_EVAL
2766
2767 =item Using G_KEEPERR
2768
2769 =item Using perl_call_sv
2770
2771 =item Using perl_call_argv
2772
2773 =item Using perl_call_method
2774
2775 =item Using GIMME_V
2776
2777 =item Using Perl to dispose of temporaries
2778
2779 =item Strategies for storing Callback Context Information
2780
2781 1. Ignore the problem - Allow only 1 callback, 2. Create a sequence of
2782 callbacks - hard wired limit, 3. Use a parameter to map to the Perl
2783 callback
2784
2785 =item Alternate Stack Manipulation
2786
2787 =item Creating and calling an anonymous subroutine in C
2788
2789 =back
2790
2791 =item SEE ALSO
2792
2793 =item AUTHOR
2794
2795 =item DATE
2796
2797 =head2 perlhist - the Perl history records
2798
2799 =item DESCRIPTION
2800
2801 =item INTRODUCTION
2802
2803 =item THE KEEPERS OF THE PUMPKIN
2804
2805 =over
2806
2807 =item PUMPKIN?
2808
2809 =back
2810
2811 =item THE RECORDS
2812
2813 =over
2814
2815 =item SELECTED RELEASE SIZES
2816
2817 =item SELECTED PATCH SIZES
2818
2819 =back
2820
2821 =item THE KEEPERS OF THE RECORDS
2822
2823 =head1 PRAGMA DOCUMENTATION
2824
2825 =head2 attrs - set/get attributes of a subroutine
2826
2827 =item SYNOPSIS
2828
2829 =item DESCRIPTION
2830
2831 method, locked
2832
2833 =head2 re - Perl pragma to alter regular expression behaviour
2834
2835 =item SYNOPSIS
2836
2837 =item DESCRIPTION
2838
2839 =head2 autouse - postpone load of modules until a function is used
2840
2841 =item SYNOPSIS
2842
2843 =item DESCRIPTION
2844
2845 =item WARNING
2846
2847 =item AUTHOR
2848
2849 =item SEE ALSO
2850
2851 =head2 base - Establish IS-A relationship with base class at compile time
2852
2853 =item SYNOPSIS
2854
2855 =item DESCRIPTION
2856
2857 =item SEE ALSO
2858
2859 =head2 blib - Use MakeMaker's uninstalled version of a package
2860
2861 =item SYNOPSIS
2862
2863 =item DESCRIPTION
2864
2865 =item BUGS
2866
2867 =item AUTHOR
2868
2869 =head2 constant - Perl pragma to declare constants
2870
2871 =item SYNOPSIS
2872
2873 =item DESCRIPTION
2874
2875 =item NOTES
2876
2877 =item TECHNICAL NOTE
2878
2879 =item BUGS
2880
2881 =item AUTHOR
2882
2883 =item COPYRIGHT
2884
2885 =head2 diagnostics - Perl compiler pragma to force verbose warning
2886 diagnostics
2887
2888 =item SYNOPSIS
2889
2890 =item DESCRIPTION
2891
2892 =over
2893
2894 =item The C<diagnostics> Pragma
2895
2896 =item The I<splain> Program
2897
2898 =back
2899
2900 =item EXAMPLES
2901
2902 =item INTERNALS
2903
2904 =item BUGS
2905
2906 =item AUTHOR
2907
2908 =head2 fields - compile-time class fields
2909
2910 =item SYNOPSIS
2911
2912 =item DESCRIPTION
2913
2914 =item SEE ALSO
2915
2916 =head2 integer - Perl pragma to compute arithmetic in integer instead of
2917 double
2918
2919 =item SYNOPSIS
2920
2921 =item DESCRIPTION
2922
2923 =head2 less - perl pragma to request less of something from the compiler
2924
2925 =item SYNOPSIS
2926
2927 =item DESCRIPTION
2928
2929 =head2 lib - manipulate @INC at compile time
2930
2931 =item SYNOPSIS
2932
2933 =item DESCRIPTION
2934
2935 =over
2936
2937 =item ADDING DIRECTORIES TO @INC
2938
2939 =item DELETING DIRECTORIES FROM @INC
2940
2941 =item RESTORING ORIGINAL @INC
2942
2943 =back
2944
2945 =item SEE ALSO
2946
2947 =item AUTHOR
2948
2949 =head2 locale - Perl pragma to use and avoid POSIX locales for built-in
2950 operations
2951
2952 =item SYNOPSIS
2953
2954 =item DESCRIPTION
2955
2956 =head2 overload - Package for overloading perl operations
2957
2958 =item SYNOPSIS
2959
2960 =item CAVEAT SCRIPTOR
2961
2962 =item DESCRIPTION
2963
2964 =over
2965
2966 =item Declaration of overloaded functions
2967
2968 =item Calling Conventions for Binary Operations
2969
2970 FALSE, TRUE, C<undef>
2971
2972 =item Calling Conventions for Unary Operations
2973
2974 =item Overloadable Operations
2975
2976 I<Arithmetic operations>, I<Comparison operations>, I<Bit operations>,
2977 I<Increment and decrement>, I<Transcendental functions>, I<Boolean, string
2978 and numeric conversion>, I<Special>
2979
2980 =item Inheritance and overloading
2981
2982 Strings as values of C<use overload> directive, Overloading of an operation
2983 is inherited by derived classes
2984
2985 =back
2986
2987 =item SPECIAL SYMBOLS FOR C<use overload>
2988
2989 =over
2990
2991 =item Last Resort
2992
2993 =item Fallback
2994
2995 C<undef>, TRUE, defined, but FALSE
2996
2997 =item Copy Constructor
2998
2999 B<Example>
3000
3001 =back
3002
3003 =item MAGIC AUTOGENERATION
3004
3005 I<Assignment forms of arithmetic operations>, I<Conversion operations>,
3006 I<Increment and decrement>, C<abs($a)>, I<Unary minus>, I<Negation>,
3007 I<Concatenation>, I<Comparison operations>, I<Copy operator>
3008
3009 =item WARNING
3010
3011 =item Run-time Overloading
3012
3013 =item Public functions
3014
3015 overload::StrVal(arg), overload::Overloaded(arg), overload::Method(obj,op)
3016
3017 =item Overloading constants
3018
3019 integer, float, binary, q, qr
3020
3021 =item IMPLEMENTATION
3022
3023 =item AUTHOR
3024
3025 =item DIAGNOSTICS
3026
3027 =item BUGS
3028
3029 =head2 sigtrap - Perl pragma to enable simple signal handling
3030
3031 =item SYNOPSIS
3032
3033 =item DESCRIPTION
3034
3035 =item OPTIONS
3036
3037 =over
3038
3039 =item SIGNAL HANDLERS
3040
3041 B<stack-trace>, B<die>, B<handler> I<your-handler>
3042
3043 =item SIGNAL LISTS
3044
3045 B<normal-signals>, B<error-signals>, B<old-interface-signals>
3046
3047 =item OTHER
3048
3049 B<untrapped>, B<any>, I<signal>, I<number>
3050
3051 =back
3052
3053 =item EXAMPLES
3054
3055 =head2 strict - Perl pragma to restrict unsafe constructs
3056
3057 =item SYNOPSIS
3058
3059 =item DESCRIPTION
3060
3061 C<strict refs>, C<strict vars>, C<strict subs>
3062
3063 =head2 subs - Perl pragma to predeclare sub names
3064
3065 =item SYNOPSIS
3066
3067 =item DESCRIPTION
3068
3069 =head2 vars - Perl pragma to predeclare global variable names
3070
3071 =item SYNOPSIS
3072
3073 =item DESCRIPTION
3074
3075 =head1 MODULE DOCUMENTATION
3076
3077 =head2 AnyDBM_File - provide framework for multiple DBMs
3078
3079 =item SYNOPSIS
3080
3081 =item DESCRIPTION
3082
3083 =over
3084
3085 =item DBM Comparisons
3086
3087 [0], [1], [2], [3]
3088
3089 =back
3090
3091 =item SEE ALSO
3092
3093 =head2 AutoLoader - load subroutines only on demand
3094
3095 =item SYNOPSIS
3096
3097 =item DESCRIPTION
3098
3099 =over
3100
3101 =item Subroutine Stubs
3102
3103 =item Using B<AutoLoader>'s AUTOLOAD Subroutine
3104
3105 =item Overriding B<AutoLoader>'s AUTOLOAD Subroutine
3106
3107 =item Package Lexicals
3108
3109 =item B<AutoLoader> vs. B<SelfLoader>
3110
3111 =back
3112
3113 =item CAVEATS
3114
3115 =item SEE ALSO
3116
3117 =head2 AutoSplit - split a package for autoloading
3118
3119 =item SYNOPSIS
3120
3121 =item DESCRIPTION
3122
3123 $keep, $check, $modtime
3124
3125 =over
3126
3127 =item Multiple packages
3128
3129 =back
3130
3131 =item DIAGNOSTICS
3132
3133 =head2 B - The Perl Compiler
3134
3135 =item SYNOPSIS
3136
3137 =item DESCRIPTION
3138
3139 =item OVERVIEW OF CLASSES
3140
3141 =over
3142
3143 =item SV-RELATED CLASSES
3144
3145 =item B::SV METHODS
3146
3147 REFCNT, FLAGS
3148
3149 =item B::IV METHODS
3150
3151 IV, IVX, needs64bits, packiv
3152
3153 =item B::NV METHODS
3154
3155 NV, NVX
3156
3157 =item B::RV METHODS
3158
3159 RV
3160
3161 =item B::PV METHODS
3162
3163 PV
3164
3165 =item B::PVMG METHODS
3166
3167 MAGIC, SvSTASH
3168
3169 =item B::MAGIC METHODS
3170
3171 MOREMAGIC, PRIVATE, TYPE, FLAGS, OBJ, PTR
3172
3173 =item B::PVLV METHODS
3174
3175 TARGOFF, TARGLEN, TYPE, TARG
3176
3177 =item B::BM METHODS
3178
3179 USEFUL, PREVIOUS, RARE, TABLE
3180
3181 =item B::GV METHODS
3182
3183 NAME, STASH, SV, IO, FORM, AV, HV, EGV, CV, CVGEN, LINE, FILEGV, GvREFCNT,
3184 FLAGS
3185
3186 =item B::IO METHODS
3187
3188 LINES, PAGE, PAGE_LEN, LINES_LEFT, TOP_NAME, TOP_GV, FMT_NAME, FMT_GV,
3189 BOTTOM_NAME, BOTTOM_GV, SUBPROCESS, IoTYPE, IoFLAGS
3190
3191 =item B::AV METHODS
3192
3193 FILL, MAX, OFF, ARRAY, AvFLAGS
3194
3195 =item B::CV METHODS
3196
3197 STASH, START, ROOT, GV, FILEGV, DEPTH, PADLIST, OUTSIDE, XSUB, XSUBANY
3198
3199 =item B::HV METHODS
3200
3201 FILL, MAX, KEYS, RITER, NAME, PMROOT, ARRAY
3202
3203 =item OP-RELATED CLASSES
3204
3205 =item B::OP METHODS
3206
3207 next, sibling, ppaddr, desc, targ, type, seq, flags, private
3208
3209 =item B::UNOP METHOD
3210
3211 first
3212
3213 =item B::BINOP METHOD
3214
3215 last
3216
3217 =item B::LOGOP METHOD
3218
3219 other
3220
3221 =item B::CONDOP METHODS
3222
3223 true, false
3224
3225 =item B::LISTOP METHOD
3226
3227 children
3228
3229 =item B::PMOP METHODS
3230
3231 pmreplroot, pmreplstart, pmnext, pmregexp, pmflags, pmpermflags, precomp
3232
3233 =item B::SVOP METHOD
3234
3235 sv
3236
3237 =item B::GVOP METHOD
3238
3239 gv
3240
3241 =item B::PVOP METHOD
3242
3243 pv
3244
3245 =item B::LOOP METHODS
3246
3247 redoop, nextop, lastop
3248
3249 =item B::COP METHODS
3250
3251 label, stash, filegv, cop_seq, arybase, line
3252
3253 =back
3254
3255 =item FUNCTIONS EXPORTED BY C<B>
3256
3257 main_cv, main_root, main_start, comppadlist, sv_undef, sv_yes, sv_no,
3258 walkoptree(OP, METHOD), walkoptree_debug(DEBUG), walksymtable(SYMREF,
3259 METHOD, RECURSE), svref_2object(SV), ppname(OPNUM), hash(STR), cast_I32(I),
3260 minus_c, cstring(STR), class(OBJ), threadsv_names, byteload_fh(FILEHANDLE)
3261
3262 =item AUTHOR
3263
3264 =head2 B::Asmdata - Autogenerated data about Perl ops, used to generate
3265 bytecode
3266
3267 =item SYNOPSIS
3268
3269 =item DESCRIPTION
3270
3271 =item AUTHOR
3272
3273 =head2 B::Assembler - Assemble Perl bytecode
3274
3275 =item SYNOPSIS
3276
3277 =item DESCRIPTION
3278
3279 =item AUTHOR
3280
3281 =head2 B::Bblock - Walk basic blocks
3282
3283 =item SYNOPSIS
3284
3285 =item DESCRIPTION
3286
3287 =item AUTHOR
3288
3289 =head2 B::Bytecode - Perl compiler's bytecode backend
3290
3291 =item SYNOPSIS
3292
3293 =item DESCRIPTION
3294
3295 =item OPTIONS
3296
3297 B<-ofilename>, B<-->, B<-f>, B<-fcompress-nullops>,
3298 B<-fomit-sequence-numbers>, B<-fbypass-nullops>, B<-fstrip-syntax-tree>,
3299 B<-On>, B<-D>, B<-Do>, B<-Db>, B<-Da>, B<-DC>, B<-S>, B<-m>
3300
3301 =item BUGS
3302
3303 =item AUTHOR
3304
3305 =head2 B::C - Perl compiler's C backend
3306
3307 =item SYNOPSIS
3308
3309 =item DESCRIPTION
3310
3311 =item OPTIONS
3312
3313 B<-ofilename>, B<-v>, B<-->, B<-uPackname>, B<-D>, B<-Do>, B<-Dc>, B<-DA>,
3314 B<-DC>, B<-DM>, B<-f>, B<-fcog>, B<-fno-cog>, B<-On>
3315
3316 =item EXAMPLES
3317
3318 =item BUGS
3319
3320 =item AUTHOR
3321
3322 =head2 B::CC - Perl compiler's optimized C translation backend
3323
3324 =item SYNOPSIS
3325
3326 =item DESCRIPTION
3327
3328 =item OPTIONS
3329
3330 B<-ofilename>, B<-v>, B<-->, B<-uPackname>, B<-mModulename>, B<-D>, B<-Dr>,
3331 B<-DO>, B<-Ds>, B<-Dp>, B<-Dq>, B<-Dl>, B<-Dt>, B<-f>,
3332 B<-ffreetmps-each-bblock>, B<-ffreetmps-each-loop>, B<-fomit-taint>, B<-On>
3333
3334 =item EXAMPLES
3335
3336 =item BUGS
3337
3338 =item DIFFERENCES
3339
3340 =over
3341
3342 =item Loops
3343
3344 =item Context of ".."
3345
3346 =item Arithmetic
3347
3348 =item Deprecated features
3349
3350 =back
3351
3352 =item AUTHOR
3353
3354 =head2 B::Debug - Walk Perl syntax tree, printing debug info about ops
3355
3356 =item SYNOPSIS
3357
3358 =item DESCRIPTION
3359
3360 =item AUTHOR
3361
3362 =head2 B::Deparse - Perl compiler backend to produce perl code
3363
3364 =item SYNOPSIS
3365
3366 =item DESCRIPTION
3367
3368 =item OPTIONS
3369
3370 B<-p>, B<-u>I<PACKAGE>, B<-l>, B<-s>I<LETTERS>, B<C>
3371
3372 =item BUGS
3373
3374 =item AUTHOR
3375
3376 =head2 B::Disassembler - Disassemble Perl bytecode
3377
3378 =item SYNOPSIS
3379
3380 =item DESCRIPTION
3381
3382 =item AUTHOR
3383
3384 =head2 B::Lint - Perl lint
3385
3386 =item SYNOPSIS
3387
3388 =item DESCRIPTION
3389
3390 =item OPTIONS AND LINT CHECKS
3391
3392 B<context>, B<implicit-read> and B<implicit-write>, B<dollar-underscore>,
3393 B<private-names>, B<undefined-subs>, B<regexp-variables>, B<all>, B<none>
3394
3395 =item NON LINT-CHECK OPTIONS
3396
3397 B<-u Package>
3398
3399 =item BUGS
3400
3401 =item AUTHOR
3402
3403 =head2 B::O, O - Generic interface to Perl Compiler backends
3404
3405 =item SYNOPSIS
3406
3407 =item DESCRIPTION
3408
3409 =item CONVENTIONS
3410
3411 =item IMPLEMENTATION
3412
3413 =item AUTHOR
3414
3415 =head2 B::Showlex - Show lexical variables used in functions or files
3416
3417 =item SYNOPSIS
3418
3419 =item DESCRIPTION
3420
3421 =item AUTHOR
3422
3423 =head2 B::Stackobj - Helper module for CC backend
3424
3425 =item SYNOPSIS
3426
3427 =item DESCRIPTION
3428
3429 =item AUTHOR
3430
3431 =head2 B::Terse - Walk Perl syntax tree, printing terse info about ops
3432
3433 =item SYNOPSIS
3434
3435 =item DESCRIPTION
3436
3437 =item AUTHOR
3438
3439 =head2 B::Xref - Generates cross reference reports for Perl programs
3440
3441 =item SYNOPSIS
3442
3443 =item DESCRIPTION
3444
3445 =item OPTIONS
3446
3447 C<-oFILENAME>, C<-r>, C<-D[tO]>
3448
3449 =item BUGS
3450
3451 =item AUTHOR
3452
3453 =head2 Benchmark - benchmark running times of code
3454
3455 =item SYNOPSIS
3456
3457 =item DESCRIPTION
3458
3459 =over
3460
3461 =item Methods
3462
3463 new, debug
3464
3465 =item Standard Exports
3466
3467 timeit(COUNT, CODE), timethis ( COUNT, CODE, [ TITLE, [ STYLE ]] ),
3468 timethese ( COUNT, CODEHASHREF, [ STYLE ] ), timediff ( T1, T2 ), timestr (
3469 TIMEDIFF, [ STYLE, [ FORMAT ] ] )
3470
3471 =item Optional Exports
3472
3473 clearcache ( COUNT ), clearallcache ( ), disablecache ( ), enablecache ( )
3474
3475 =back
3476
3477 =item NOTES
3478
3479 =item INHERITANCE
3480
3481 =item CAVEATS
3482
3483 =item AUTHORS
3484
3485 =item MODIFICATION HISTORY
3486
3487 =head2 CGI - Simple Common Gateway Interface Class
3488
3489 =item SYNOPSIS
3490
3491 =item ABSTRACT
3492
3493 =item DESCRIPTION
3494
3495 =over
3496
3497 =item PROGRAMMING STYLE
3498
3499 =item CALLING CGI.PM ROUTINES
3500
3501 1. Use another name for the argument, if one is available.  Forexample,
3502 -value is an alias for -values, 2. Change the capitalization, e.g. -Values,
3503 3. Put quotes around the argument name, e.g. '-values'
3504
3505 =item CREATING A NEW QUERY OBJECT (OBJECT-ORIENTED STYLE):
3506
3507 =item CREATING A NEW QUERY OBJECT FROM AN INPUT FILE
3508
3509 =item FETCHING A LIST OF KEYWORDS FROM THE QUERY:
3510
3511 =item FETCHING THE NAMES OF ALL THE PARAMETERS PASSED TO YOUR SCRIPT:
3512
3513 =item FETCHING THE VALUE OR VALUES OF A SINGLE NAMED PARAMETER:
3514
3515 =item SETTING THE VALUE(S) OF A NAMED PARAMETER:
3516
3517 =item APPENDING ADDITIONAL VALUES TO A NAMED PARAMETER:
3518
3519 =item IMPORTING ALL PARAMETERS INTO A NAMESPACE:
3520
3521 =item DELETING A PARAMETER COMPLETELY:
3522
3523 =item DELETING ALL PARAMETERS:
3524
3525 =item DIRECT ACCESS TO THE PARAMETER LIST:
3526
3527 =item SAVING THE STATE OF THE SCRIPT TO A FILE:
3528
3529 =item USING THE FUNCTION-ORIENTED INTERFACE
3530
3531 B<:cgi>, B<:form>, B<:html2>, B<:html3>, B<:netscape>, B<:html>,
3532 B<:standard>, B<:all>
3533
3534 =item PRAGMAS
3535
3536 -any, -compile, -nph, -autoload, -no_debug, -private_tempfiles
3537
3538 =back
3539
3540 =item GENERATING DYNAMIC DOCUMENTS
3541
3542 =over
3543
3544 =item CREATING A STANDARD HTTP HEADER:
3545
3546 =item GENERATING A REDIRECTION HEADER
3547
3548 =item CREATING THE HTML DOCUMENT HEADER
3549
3550 B<Parameters:>, 4, 5, 6..
3551
3552 =item ENDING THE HTML DOCUMENT:
3553
3554 =item CREATING A SELF-REFERENCING URL THAT PRESERVES STATE INFORMATION:
3555
3556 =item OBTAINING THE SCRIPT'S URL
3557
3558 B<-absolute>, B<-relative>, B<-full>, B<-path> (B<-path_info>), B<-query>
3559 (B<-query_string>)
3560
3561 =back
3562
3563 =item CREATING STANDARD HTML ELEMENTS:
3564
3565 =over
3566
3567 =item PROVIDING ARGUMENTS TO HTML SHORTCUTS
3568
3569 =item THE DISTRIBUTIVE PROPERTY OF HTML SHORTCUTS
3570
3571 =item HTML SHORTCUTS AND LIST INTERPOLATION
3572
3573 =item NON-STANDARD HTML SHORTCUTS
3574
3575 =back
3576
3577 =item CREATING FILL-OUT FORMS:
3578
3579 =over
3580
3581 =item CREATING AN ISINDEX TAG
3582
3583 =item STARTING AND ENDING A FORM
3584
3585 B<application/x-www-form-urlencoded>, B<multipart/form-data>
3586
3587 =item CREATING A TEXT FIELD
3588
3589 B<Parameters>
3590
3591 =item CREATING A BIG TEXT FIELD
3592
3593 =item CREATING A PASSWORD FIELD
3594
3595 =item CREATING A FILE UPLOAD FIELD
3596
3597 B<Parameters>
3598
3599 =item CREATING A POPUP MENU
3600
3601 =item CREATING A SCROLLING LIST
3602
3603 B<Parameters:>
3604
3605 =item CREATING A GROUP OF RELATED CHECKBOXES
3606
3607 B<Parameters:>
3608
3609 =item CREATING A STANDALONE CHECKBOX
3610
3611 B<Parameters:>
3612
3613 =item CREATING A RADIO BUTTON GROUP
3614
3615 B<Parameters:>
3616
3617 =item CREATING A SUBMIT BUTTON
3618
3619 B<Parameters:>
3620
3621 =item CREATING A RESET BUTTON
3622
3623 =item CREATING A DEFAULT BUTTON
3624
3625 =item CREATING A HIDDEN FIELD
3626
3627 B<Parameters:>
3628
3629 =item CREATING A CLICKABLE IMAGE BUTTON
3630
3631 B<Parameters:>, 3.The third option (-align, optional) is an alignment type,
3632 and may be
3633 TOP, BOTTOM or MIDDLE
3634
3635 =item CREATING A JAVASCRIPT ACTION BUTTON
3636
3637 =back
3638
3639 =item NETSCAPE COOKIES
3640
3641 1. an expiration time, 2. a domain, 3. a path, 4. a "secure" flag,
3642 B<-name>, B<-value>, B<-path>, B<-domain>, B<-expires>, B<-secure>
3643
3644 =item WORKING WITH NETSCAPE FRAMES
3645
3646 1. Create a <Frameset> document, 2. Specify the destination for the
3647 document in the HTTP header, 3. Specify the destination for the document in
3648 the <FORM> tag
3649
3650 =item LIMITED SUPPORT FOR CASCADING STYLE SHEETS
3651
3652 =item DEBUGGING
3653
3654 =over
3655
3656 =item DUMPING OUT ALL THE NAME/VALUE PAIRS
3657
3658 =back
3659
3660 =item FETCHING ENVIRONMENT VARIABLES
3661
3662 B<accept()>, B<raw_cookie()>, B<user_agent()>, B<path_info()>,
3663 B<path_translated()>, B<remote_host()>, B<script_name()>Return the script
3664 name as a partial URL, for self-refering
3665 scripts, B<referer()>, B<auth_type ()>, B<server_name ()>, B<virtual_host
3666 ()>, B<server_software ()>, B<remote_user ()>, B<user_name ()>,
3667 B<request_method()>
3668
3669 =item USING NPH SCRIPTS
3670
3671 In the B<use> statement, By calling the B<nph()> method:, By using B<-nph>
3672 parameters in the B<header()> and B<redirect()>  statements:
3673
3674 =item Server Push
3675
3676 multipart_init()
3677 multipart_init(-boundary=>$boundary);, multipart_start(), multipart_end()
3678
3679 =item Avoiding Denial of Service Attacks
3680
3681 B<$CGI::POST_MAX>, B<$CGI::DISABLE_UPLOADS>, B<1. On a script-by-script
3682 basis>, B<2. Globally for all scripts>
3683
3684 =item COMPATIBILITY WITH CGI-LIB.PL
3685
3686 =item AUTHOR INFORMATION
3687
3688 =item CREDITS
3689
3690 Matt Heffron (heffron@falstaff.css.beckman.com), James Taylor
3691 (james.taylor@srs.gov), Scott Anguish <sanguish@digifix.com>, Mike Jewell
3692 (mlj3u@virginia.edu), Timothy Shimmin (tes@kbs.citri.edu.au), Joergen Haegg
3693 (jh@axis.se), Laurent Delfosse (delfosse@csgrad1.cs.wvu.edu), Richard
3694 Resnick (applepi1@aol.com), Craig Bishop (csb@barwonwater.vic.gov.au), Tony
3695 Curtis (tc@vcpc.univie.ac.at), Tim Bunce (Tim.Bunce@ig.co.uk), Tom
3696 Christiansen (tchrist@convex.com), Andreas Koenig
3697 (k@franz.ww.TU-Berlin.DE), Tim MacKenzie (Tim.MacKenzie@fulcrum.com.au),
3698 Kevin B. Hendricks (kbhend@dogwood.tyler.wm.edu), Stephen Dahmen
3699 (joyfire@inxpress.net), Ed Jordan (ed@fidalgo.net), David Alan Pisoni
3700 (david@cnation.com), Doug MacEachern (dougm@opengroup.org), Robin Houston
3701 (robin@oneworld.org), ...and many many more..
3702
3703 =item A COMPLETE EXAMPLE OF A SIMPLE FORM-BASED SCRIPT
3704
3705 =item BUGS
3706
3707 =item SEE ALSO
3708
3709 =head2 CGI::Apache - Make things work with CGI.pm against Perl-Apache API
3710
3711 =item SYNOPSIS
3712
3713 =item DESCRIPTION
3714
3715 =item NOTE 1
3716
3717 =item NOTE 2
3718
3719 =item SEE ALSO
3720
3721 =item AUTHOR
3722
3723 =head2 CGI::Carp, B<CGI::Carp> - CGI routines for writing to the HTTPD (or
3724 other) error log
3725
3726 =item SYNOPSIS
3727
3728 =item DESCRIPTION
3729
3730 =item REDIRECTING ERROR MESSAGES
3731
3732 =item MAKING PERL ERRORS APPEAR IN THE BROWSER WINDOW
3733
3734 =over
3735
3736 =item Changing the default message
3737
3738 =back
3739
3740 =item CHANGE LOG
3741
3742 =item AUTHORS
3743
3744 =item SEE ALSO
3745
3746 =head2 CGI::Cookie - Interface to Netscape Cookies
3747
3748 =item SYNOPSIS
3749
3750 =item DESCRIPTION
3751
3752 =item USING CGI::Cookie
3753
3754 B<1. expiration date>, B<2. domain>, B<3. path>, B<4. secure flag>
3755
3756 =over
3757
3758 =item Creating New Cookies
3759
3760 =item Sending the Cookie to the Browser
3761
3762 =item Recovering Previous Cookies
3763
3764 =item Manipulating Cookies
3765
3766 B<name()>, B<value()>, B<domain()>, B<path()>, B<expires()>
3767
3768 =back
3769
3770 =item AUTHOR INFORMATION
3771
3772 =item BUGS
3773
3774 =item SEE ALSO
3775
3776 =head2 CGI::Fast - CGI Interface for Fast CGI
3777
3778 =item SYNOPSIS
3779
3780 =item DESCRIPTION
3781
3782 =item OTHER PIECES OF THE PUZZLE
3783
3784 =item WRITING FASTCGI PERL SCRIPTS
3785
3786 =item INSTALLING FASTCGI SCRIPTS
3787
3788 =item USING FASTCGI SCRIPTS AS CGI SCRIPTS
3789
3790 =item CAVEATS
3791
3792 =item AUTHOR INFORMATION
3793
3794 =item BUGS
3795
3796 =item SEE ALSO
3797
3798 =head2 CGI::Push - Simple Interface to Server Push
3799
3800 =item SYNOPSIS
3801
3802 =item DESCRIPTION
3803
3804 =item USING CGI::Push
3805
3806 -next_page, -last_page, -type, -delay, -cookie, -target, -expires
3807
3808 =over
3809
3810 =item Heterogeneous Pages
3811
3812 =item Changing the Page Delay on the Fly
3813
3814 =back
3815
3816 =item INSTALLING CGI::Push SCRIPTS
3817
3818 =item CAVEATS
3819
3820 =item AUTHOR INFORMATION
3821
3822 =item BUGS
3823
3824 =item SEE ALSO
3825
3826 =head2 CGI::Switch - Try more than one constructors and return the first
3827 object available
3828
3829 =item SYNOPSIS
3830
3831 =item DESCRIPTION
3832
3833 =item SEE ALSO
3834
3835 =item AUTHOR
3836
3837 =head2 CPAN - query, download and build perl modules from CPAN sites
3838
3839 =item SYNOPSIS
3840
3841 =item DESCRIPTION
3842
3843 =over
3844
3845 =item Interactive Mode
3846
3847 Searching for authors, bundles, distribution files and modules, make, test,
3848 install, clean  modules or distributions, readme, look module or
3849 distribution, Signals
3850
3851 =item CPAN::Shell
3852
3853 =item autobundle
3854
3855 =item recompile
3856
3857 =item The four C<CPAN::*> Classes: Author, Bundle, Module, Distribution
3858
3859 =item ProgrammerE<39>s interface
3860
3861 expand($type,@things), Programming Examples
3862
3863 =item Methods in the four
3864
3865 =item Cache Manager
3866
3867 =item Bundles
3868
3869 =item Prerequisites
3870
3871 =item Finding packages and VERSION
3872
3873 =item Debugging
3874
3875 =item Floppy, Zip, and all that Jazz
3876
3877 =back
3878
3879 =item CONFIGURATION
3880
3881 o conf E<lt>scalar optionE<gt>, o conf E<lt>scalar optionE<gt>
3882 E<lt>valueE<gt>, o conf E<lt>list optionE<gt>, o conf E<lt>list optionE<gt>
3883 [shift|pop], o conf E<lt>list optionE<gt> [unshift|push|splice]
3884 E<lt>listE<gt>
3885
3886 =over
3887
3888 =item CD-ROM support
3889
3890 =back
3891
3892 =item SECURITY
3893
3894 =item EXPORT
3895
3896 =item BUGS
3897
3898 =item AUTHOR
3899
3900 =item SEE ALSO
3901
3902 =head2 CPAN::FirstTime - Utility for CPAN::Config file Initialization
3903
3904 =item SYNOPSIS
3905
3906 =item DESCRIPTION
3907
3908 =head2 CPANox, CPAN::Nox - Wrapper around CPAN.pm without using any XS
3909 module
3910
3911 =item SYNOPSIS
3912
3913 =item DESCRIPTION
3914
3915 =item  SEE ALSO
3916
3917 =head2 Carp, carp    - warn of errors (from perspective of caller)
3918
3919 =item SYNOPSIS
3920
3921 =item DESCRIPTION
3922
3923 =over
3924
3925 =item Forcing a Stack Trace
3926
3927 =back
3928
3929 =head2 Class::Struct - declare struct-like datatypes as Perl classes
3930
3931 =item SYNOPSIS
3932
3933 =item DESCRIPTION
3934
3935 =over
3936
3937 =item The C<struct()> function
3938
3939 =item Element Types and Accessor Methods
3940
3941 Scalar (C<'$'> or C<'*$'>), Array (C<'@'> or C<'*@'>), Hash (C<'%'> or
3942 C<'*%'>), Class (C<'Class_Name'> or C<'*Class_Name'>)
3943
3944 =back
3945
3946 =item EXAMPLES
3947
3948 Example 1, Example 2
3949
3950 =item Author and Modification History
3951
3952 =head2 Cwd, getcwd - get pathname of current working directory
3953
3954 =item SYNOPSIS
3955
3956 =item DESCRIPTION
3957
3958 =head2 DB_File - Perl5 access to Berkeley DB version 1.x
3959
3960 =item SYNOPSIS
3961
3962 =item DESCRIPTION
3963
3964 B<DB_HASH>, B<DB_BTREE>, B<DB_RECNO>
3965
3966 =over
3967
3968 =item Using DB_File with Berkeley DB version 2
3969
3970 =item Interface to Berkeley DB
3971
3972 =item Opening a Berkeley DB Database File
3973
3974 =item Default Parameters
3975
3976 =item In Memory Databases
3977
3978 =back
3979
3980 =item DB_HASH
3981
3982 =over
3983
3984 =item A Simple Example
3985
3986 =back
3987
3988 =item DB_BTREE
3989
3990 =over
3991
3992 =item Changing the BTREE sort order
3993
3994 =item Handling Duplicate Keys
3995
3996 =item The get_dup() Method
3997
3998 =item Matching Partial Keys
3999
4000 =back
4001
4002 =item DB_RECNO
4003
4004 =over
4005
4006 =item The 'bval' Option
4007
4008 =item A Simple Example
4009
4010 =item Extra Methods
4011
4012 B<$X-E<gt>push(list) ;>, B<$value = $X-E<gt>pop ;>, B<$X-E<gt>shift>,
4013 B<$X-E<gt>unshift(list) ;>, B<$X-E<gt>length>
4014
4015 =item Another Example
4016
4017 =back
4018
4019 =item THE API INTERFACE
4020
4021 B<$status = $X-E<gt>get($key, $value [, $flags]) ;>, B<$status =
4022 $X-E<gt>put($key, $value [, $flags]) ;>, B<$status = $X-E<gt>del($key [,
4023 $flags]) ;>, B<$status = $X-E<gt>fd ;>, B<$status = $X-E<gt>seq($key,
4024 $value, $flags) ;>, B<$status = $X-E<gt>sync([$flags]) ;>
4025
4026 =item HINTS AND TIPS
4027
4028 =over
4029
4030 =item Locking Databases
4031
4032 =item Sharing Databases With C Applications
4033
4034 =item The untie() Gotcha
4035
4036 =back
4037
4038 =item COMMON QUESTIONS
4039
4040 =over
4041
4042 =item Why is there Perl source in my database?
4043
4044 =item How do I store complex data structures with DB_File?
4045
4046 =item What does "Invalid Argument" mean?
4047
4048 =item What does "Bareword 'DB_File' not allowed" mean?
4049
4050 =back
4051
4052 =item HISTORY
4053
4054 =item BUGS
4055
4056 =item AVAILABILITY
4057
4058 =item COPYRIGHT
4059
4060 =item SEE ALSO
4061
4062 =item AUTHOR
4063
4064 =head2 Data::Dumper - stringified perl data structures, suitable for both
4065 printing and C<eval>
4066
4067 =item SYNOPSIS
4068
4069 =item DESCRIPTION
4070
4071 =over
4072
4073 =item Methods
4074
4075 I<PACKAGE>->new(I<ARRAYREF [>, I<ARRAYREF]>), I<$OBJ>->Dump  I<or>
4076 I<PACKAGE>->Dump(I<ARRAYREF [>, I<ARRAYREF]>), I<$OBJ>->Dumpxs  I<or>
4077 I<PACKAGE>->Dumpxs(I<ARRAYREF [>, I<ARRAYREF]>),
4078 I<$OBJ>->Seen(I<[HASHREF]>), I<$OBJ>->Values(I<[ARRAYREF]>),
4079 I<$OBJ>->Names(I<[ARRAYREF]>), I<$OBJ>->Reset
4080
4081 =item Functions
4082
4083 Dumper(I<LIST>), DumperX(I<LIST>)
4084
4085 =item Configuration Variables or Methods
4086
4087 $Data::Dumper::Indent  I<or>  I<$OBJ>->Indent(I<[NEWVAL]>),
4088 $Data::Dumper::Purity  I<or>  I<$OBJ>->Purity(I<[NEWVAL]>),
4089 $Data::Dumper::Pad  I<or>  I<$OBJ>->Pad(I<[NEWVAL]>),
4090 $Data::Dumper::Varname  I<or>  I<$OBJ>->Varname(I<[NEWVAL]>),
4091 $Data::Dumper::Useqq  I<or>  I<$OBJ>->Useqq(I<[NEWVAL]>),
4092 $Data::Dumper::Terse  I<or>  I<$OBJ>->Terse(I<[NEWVAL]>),
4093 $Data::Dumper::Freezer  I<or>  $I<OBJ>->Freezer(I<[NEWVAL]>),
4094 $Data::Dumper::Toaster  I<or>  $I<OBJ>->Toaster(I<[NEWVAL]>),
4095 $Data::Dumper::Deepcopy  I<or>  $I<OBJ>->Deepcopy(I<[NEWVAL]>),
4096 $Data::Dumper::Quotekeys  I<or>  $I<OBJ>->Quotekeys(I<[NEWVAL]>),
4097 $Data::Dumper::Bless  I<or>  $I<OBJ>->Bless(I<[NEWVAL]>)
4098
4099 =item Exports
4100
4101 Dumper
4102
4103 =back
4104
4105 =item EXAMPLES
4106
4107 =item BUGS
4108
4109 =item AUTHOR
4110
4111 =item VERSION
4112
4113 =item SEE ALSO
4114
4115 =head2 Devel::SelfStubber - generate stubs for a SelfLoading module
4116
4117 =item SYNOPSIS
4118
4119 =item DESCRIPTION
4120
4121 =head2 DirHandle - supply object methods for directory handles
4122
4123 =item SYNOPSIS
4124
4125 =item DESCRIPTION
4126
4127 =head2 English - use nice English (or awk) names for ugly punctuation
4128 variables
4129
4130 =item SYNOPSIS
4131
4132 =item DESCRIPTION
4133
4134 =head2 Env - perl module that imports environment variables
4135
4136 =item SYNOPSIS
4137
4138 =item DESCRIPTION
4139
4140 =item AUTHOR
4141
4142 =head2 Exporter - Implements default import method for modules
4143
4144 =item SYNOPSIS
4145
4146 =item DESCRIPTION
4147
4148 =over
4149
4150 =item Selecting What To Export
4151
4152 =item Specialised Import Lists
4153
4154 =item Exporting without using Export's import method
4155
4156 =item Module Version Checking
4157
4158 =item Managing Unknown Symbols
4159
4160 =item Tag Handling Utility Functions
4161
4162 =back
4163
4164 =head2 ExtUtils::Command - utilities to replace common UNIX commands in
4165 Makefiles etc.
4166
4167 =item SYNOPSIS
4168
4169 =item DESCRIPTION
4170
4171 cat, eqtime src dst, rm_f files..., rm_f files..., touch files .., mv
4172 source... destination, cp source... destination, chmod mode files.., mkpath
4173 directory.., test_f file
4174
4175 =item BUGS
4176
4177 =item SEE ALSO
4178
4179 =item AUTHOR
4180
4181 =head2 ExtUtils::Embed - Utilities for embedding Perl in C/C++ applications
4182
4183 =item SYNOPSIS
4184
4185 =item DESCRIPTION
4186
4187 =item @EXPORT
4188
4189 =item FUNCTIONS
4190
4191 xsinit(), Examples, ldopts(), Examples, perl_inc(), ccflags(), ccdlflags(),
4192 ccopts(), xsi_header(), xsi_protos(@modules), xsi_body(@modules)
4193
4194 =item EXAMPLES
4195
4196 =item SEE ALSO
4197
4198 =item AUTHOR
4199
4200 =head2 ExtUtils::Install - install files from here to there
4201
4202 =item SYNOPSIS
4203
4204 =item DESCRIPTION
4205
4206 =head2 ExtUtils::Installed - Inventory management of installed modules
4207
4208 =item SYNOPSIS
4209
4210 =item DESCRIPTION
4211
4212 =item USAGE
4213
4214 =item FUNCTIONS
4215
4216 new(), modules(), files(), directories(), directory_tree(), validate(),
4217 packlist(), version()
4218
4219 =item EXAMPLE
4220
4221 =item AUTHOR
4222
4223 =head2 ExtUtils::Liblist - determine libraries to use and how to use them
4224
4225 =item SYNOPSIS
4226
4227 =item DESCRIPTION
4228
4229 For static extensions, For dynamic extensions, For dynamic extensions
4230
4231 =over
4232
4233 =item EXTRALIBS
4234
4235 =item LDLOADLIBS and LD_RUN_PATH
4236
4237 =item BSLOADLIBS
4238
4239 =back
4240
4241 =item PORTABILITY
4242
4243 =over
4244
4245 =item VMS implementation
4246
4247 =item Win32 implementation
4248
4249 =back
4250
4251 =item SEE ALSO
4252
4253 =head2 ExtUtils::MM_OS2 - methods to override UN*X behaviour in
4254 ExtUtils::MakeMaker
4255
4256 =item SYNOPSIS
4257
4258 =item DESCRIPTION
4259
4260 =head2 ExtUtils::MM_Unix - methods used by ExtUtils::MakeMaker
4261
4262 =item SYNOPSIS
4263
4264 =item DESCRIPTION
4265
4266 =item METHODS
4267
4268 =over
4269
4270 =item Preloaded methods
4271
4272 canonpath, catdir, catfile, curdir, rootdir, updir
4273
4274 =item SelfLoaded methods
4275
4276 c_o (o), cflags (o), clean (o), const_cccmd (o), const_config (o),
4277 const_loadlibs (o), constants (o), depend (o), dir_target (o), dist (o),
4278 dist_basics (o), dist_ci (o), dist_core (o), dist_dir (o), dist_test (o),
4279 dlsyms (o), dynamic (o), dynamic_bs (o), dynamic_lib (o), exescan,
4280 extliblist, file_name_is_absolute, find_perl
4281
4282 =item Methods to actually produce chunks of text for the Makefile
4283
4284 fixin, force (o), guess_name, has_link_code, init_dirscan, init_main,
4285 init_others, install (o), installbin (o), libscan (o), linkext (o), lsdir,
4286 macro (o), makeaperl (o), makefile (o), manifypods (o), maybe_command,
4287 maybe_command_in_dirs, needs_linking (o), nicetext, parse_version,
4288 parse_abstract, pasthru (o), path, perl_script, perldepend (o), ppd,
4289 perm_rw (o), perm_rwx (o), pm_to_blib, post_constants (o), post_initialize
4290 (o), postamble (o), prefixify, processPL (o), realclean (o),
4291 replace_manpage_separator, static (o), static_lib (o), staticmake (o),
4292 subdir_x (o), subdirs (o), test (o), test_via_harness (o), test_via_script
4293 (o), tool_autosplit (o), tools_other (o), tool_xsubpp (o), top_targets (o),
4294 writedoc, xs_c (o), xs_o (o), perl_archive, export_list
4295
4296 =back
4297
4298 =item SEE ALSO
4299
4300 =head2 ExtUtils::MM_VMS - methods to override UN*X behaviour in
4301 ExtUtils::MakeMaker
4302
4303 =item SYNOPSIS
4304
4305 =item DESCRIPTION
4306
4307 =over
4308
4309 =item Methods always loaded
4310
4311 eliminate_macros, fixpath, catdir, catfile, wraplist, curdir (override),
4312 rootdir (override), updir (override)
4313
4314 =item SelfLoaded methods
4315
4316 guess_name (override), find_perl (override), path (override), maybe_command
4317 (override), maybe_command_in_dirs (override), perl_script (override),
4318 file_name_is_absolute (override), replace_manpage_separator, init_others
4319 (override), constants (override), cflags (override), const_cccmd
4320 (override), pm_to_blib (override), tool_autosplit (override), tool_sxubpp
4321 (override), xsubpp_version (override), tools_other (override), dist
4322 (override), c_o (override), xs_c (override), xs_o (override), top_targets
4323 (override), dlsyms (override), dynamic_lib (override), dynamic_bs
4324 (override), static_lib (override), manifypods (override), processPL
4325 (override), installbin (override), subdir_x (override), clean (override),
4326 realclean (override), dist_basics (override), dist_core (override),
4327 dist_dir (override), dist_test (override), install (override), perldepend
4328 (override), makefile (override), test (override), test_via_harness
4329 (override), test_via_script (override), makeaperl (override), nicetext
4330 (override)
4331
4332 =back
4333
4334 =head2 ExtUtils::MM_Win32 - methods to override UN*X behaviour in
4335 ExtUtils::MakeMaker
4336
4337 =item SYNOPSIS
4338
4339 =item DESCRIPTION
4340
4341 catfile, constants (o), static_lib (o), dynamic_bs (o), dynamic_lib (o),
4342 canonpath, perl_script, pm_to_blib, test_via_harness (o), tool_autosplit
4343 (override), tools_other (o), xs_o (o), top_targets (o), manifypods (o),
4344 dist_ci (o), dist_core (o), pasthru (o)
4345
4346 =head2 ExtUtils::MakeMaker - create an extension Makefile
4347
4348 =item SYNOPSIS
4349
4350 =item DESCRIPTION
4351
4352 =over
4353
4354 =item How To Write A Makefile.PL
4355
4356 =item Default Makefile Behaviour
4357
4358 =item make test
4359
4360 =item make testdb
4361
4362 =item make install
4363
4364 =item PREFIX and LIB attribute
4365
4366 =item AFS users
4367
4368 =item Static Linking of a new Perl Binary
4369
4370 =item Determination of Perl Library and Installation Locations
4371
4372 =item Which architecture dependent directory?
4373
4374 =item Using Attributes and Parameters
4375
4376 C, CCFLAGS, CONFIG, CONFIGURE, DEFINE, DIR, DISTNAME, DL_FUNCS, DL_VARS,
4377 EXCLUDE_EXT, EXE_FILES, NO_VC, FIRST_MAKEFILE, FULLPERL, H, IMPORTS, INC,
4378 INCLUDE_EXT, INSTALLARCHLIB, INSTALLBIN, INSTALLDIRS, INSTALLMAN1DIR,
4379 INSTALLMAN3DIR, INSTALLPRIVLIB, INSTALLSCRIPT, INSTALLSITELIB,
4380 INSTALLSITEARCH, INST_ARCHLIB, INST_BIN, INST_EXE, INST_LIB, INST_MAN1DIR,
4381 INST_MAN3DIR, INST_SCRIPT, LDFROM, LIBPERL_A, LIB, LIBS, LINKTYPE,
4382 MAKEAPERL, MAKEFILE, MAN1PODS, MAN3PODS, MAP_TARGET, MYEXTLIB, NAME,
4383 NEEDS_LINKING, NOECHO, NORECURS, OBJECT, OPTIMIZE, PERL, PERLMAINCC,
4384 PERL_ARCHLIB, PERL_LIB, PERL_SRC, PERM_RW, PERM_RWX, PL_FILES, PM,
4385 PMLIBDIRS, PREFIX, PREREQ_PM, SKIP, TYPEMAPS, VERSION, VERSION_FROM, XS,
4386 XSOPT, XSPROTOARG, XS_VERSION
4387
4388 =item Additional lowercase attributes
4389
4390 clean, depend, dist, dynamic_lib, installpm, linkext, macro, realclean,
4391 tool_autosplit
4392
4393 =item Overriding MakeMaker Methods
4394
4395 =item Hintsfile support
4396
4397 =item Distribution Support
4398
4399 make distcheck,    make skipcheck,    make distclean,    make manifest,
4400 make distdir,    make tardist,    make dist,    make uutardist,    make
4401 shdist,    make zipdist,    make ci
4402
4403 =item Disabling an extension
4404
4405 =back
4406
4407 =item SEE ALSO
4408
4409 =item AUTHORS
4410
4411 =head2 ExtUtils::Manifest - utilities to write and check a MANIFEST file
4412
4413 =item SYNOPSIS
4414
4415 =item DESCRIPTION
4416
4417 =item MANIFEST.SKIP
4418
4419 =item EXPORT_OK
4420
4421 =item GLOBAL VARIABLES
4422
4423 =item DIAGNOSTICS
4424
4425 C<Not in MANIFEST:> I<file>, C<No such file:> I<file>, C<MANIFEST:> I<$!>,
4426 C<Added to MANIFEST:> I<file>
4427
4428 =item SEE ALSO
4429
4430 =item AUTHOR
4431
4432 =head2 ExtUtils::Mkbootstrap - make a bootstrap file for use by DynaLoader
4433
4434 =item SYNOPSIS
4435
4436 =item DESCRIPTION
4437
4438 =head2 ExtUtils::Mksymlists - write linker options files for dynamic
4439 extension
4440
4441 =item SYNOPSIS
4442
4443 =item DESCRIPTION
4444
4445 NAME, DL_FUNCS, DL_VARS, FILE, FUNCLIST, DLBASE
4446
4447 =item AUTHOR
4448
4449 =item REVISION
4450
4451 =head2 ExtUtils::Packlist - manage .packlist files
4452
4453 =item SYNOPSIS
4454
4455 =item DESCRIPTION
4456
4457 =item USAGE
4458
4459 =item FUNCTIONS
4460
4461 new(), read(), write(), validate(), packlist_file()
4462
4463 =item EXAMPLE
4464
4465 =item AUTHOR
4466
4467 =head2 ExtUtils::testlib - add blib/* directories to @INC
4468
4469 =item SYNOPSIS
4470
4471 =item DESCRIPTION
4472
4473 =head2 Fatal - replace functions with equivalents which succeed or die
4474
4475 =item SYNOPSIS
4476
4477 =item DESCRIPTION
4478
4479 =item AUTHOR
4480
4481 =head2 Fcntl - load the C Fcntl.h defines
4482
4483 =item SYNOPSIS
4484
4485 =item DESCRIPTION
4486
4487 =item NOTE
4488
4489 =item EXPORTED SYMBOLS
4490
4491 =head2 File::Basename, fileparse - split a pathname into pieces
4492
4493 =item SYNOPSIS
4494
4495 =item DESCRIPTION
4496
4497 fileparse_set_fstype, fileparse
4498
4499 =item EXAMPLES
4500
4501 C<basename>, C<dirname>
4502
4503 =head2 File::CheckTree, validate - run many filetest checks on a tree
4504
4505 =item SYNOPSIS
4506
4507 =item DESCRIPTION
4508
4509 =head2 File::Compare - Compare files or filehandles
4510
4511 =item SYNOPSIS
4512
4513 =item DESCRIPTION
4514
4515 =item RETURN
4516
4517 =item AUTHOR
4518
4519 =head2 File::Copy - Copy files or filehandles
4520
4521 =item SYNOPSIS
4522
4523 =item DESCRIPTION
4524
4525 =over
4526
4527 =item Special behavior if C<syscopy> is defined (VMS and OS/2)
4528
4529 rmscopy($from,$to[,$date_flag])
4530
4531 =back
4532
4533 =item RETURN
4534
4535 =item AUTHOR
4536
4537 =head2 File::DosGlob - DOS like globbing and then some
4538
4539 =item SYNOPSIS
4540
4541 =item DESCRIPTION
4542
4543 =item EXPORTS (by request only)
4544
4545 =item BUGS
4546
4547 =item AUTHOR
4548
4549 =item HISTORY
4550
4551 =item SEE ALSO
4552
4553 =head2 File::Find, find - traverse a file tree
4554
4555 =item SYNOPSIS
4556
4557 =item DESCRIPTION
4558
4559 =item BUGS
4560
4561 =head2 File::Path - create or remove a series of directories
4562
4563 =item SYNOPSIS
4564
4565 =item DESCRIPTION
4566
4567 =item AUTHORS
4568
4569 =item REVISION
4570
4571 =head2 File::Spec - portably perform operations on file names
4572
4573 =item SYNOPSIS
4574
4575 =item DESCRIPTION
4576
4577 =item SEE ALSO
4578
4579 =item AUTHORS
4580
4581 =head2 File::Spec::Mac - File::Spec for MacOS
4582
4583 =item SYNOPSIS
4584
4585 =item DESCRIPTION
4586
4587 =item METHODS
4588
4589 canonpath, catdir, catfile, curdir, rootdir, updir, file_name_is_absolute,
4590 path
4591
4592 =item SEE ALSO
4593
4594 =head2 File::Spec::OS2 - methods for OS/2 file specs
4595
4596 =item SYNOPSIS
4597
4598 =item DESCRIPTION
4599
4600 =head2 File::Spec::Unix - methods used by File::Spec
4601
4602 =item SYNOPSIS
4603
4604 =item DESCRIPTION
4605
4606 =item METHODS
4607
4608 canonpath, catdir, catfile, curdir, rootdir, updir, no_upwards,
4609 file_name_is_absolute, path, join, nativename
4610
4611 =item SEE ALSO
4612
4613 =head2 File::Spec::VMS - methods for VMS file specs
4614
4615 =item SYNOPSIS
4616
4617 =item DESCRIPTION
4618
4619 =over
4620
4621 =item Methods always loaded
4622
4623 catdir, catfile, curdir (override), rootdir (override), updir (override),
4624 path (override), file_name_is_absolute (override)
4625
4626 =back
4627
4628 =head2 File::Spec::Win32 - methods for Win32 file specs
4629
4630 =item SYNOPSIS
4631
4632 =item DESCRIPTION
4633
4634 catfile, canonpath
4635
4636 =head2 File::stat - by-name interface to Perl's built-in stat() functions
4637
4638 =item SYNOPSIS
4639
4640 =item DESCRIPTION
4641
4642 =item NOTE
4643
4644 =item AUTHOR
4645
4646 =head2 FileCache - keep more files open than the system permits
4647
4648 =item SYNOPSIS
4649
4650 =item DESCRIPTION
4651
4652 =item BUGS
4653
4654 =head2 FileHandle - supply object methods for filehandles
4655
4656 =item SYNOPSIS
4657
4658 =item DESCRIPTION
4659
4660 $fh->print, $fh->printf, $fh->getline, $fh->getlines
4661
4662 =item SEE ALSO
4663
4664 =head2 FindBin - Locate directory of original perl script
4665
4666 =item SYNOPSIS
4667
4668 =item DESCRIPTION
4669
4670 =item EXPORTABLE VARIABLES
4671
4672 =item KNOWN BUGS
4673
4674 =item AUTHORS
4675
4676 =item COPYRIGHT
4677
4678 =item REVISION
4679
4680 =head2 GDBM_File - Perl5 access to the gdbm library.
4681
4682 =item SYNOPSIS
4683
4684 =item DESCRIPTION
4685
4686 =item AVAILABILITY
4687
4688 =item BUGS
4689
4690 =item SEE ALSO
4691
4692 =head2 Getopt::Long, GetOptions - extended processing of command line
4693 options
4694
4695 =item SYNOPSIS
4696
4697 =item DESCRIPTION
4698
4699 !, +, :s, :i, :f
4700
4701 =over
4702
4703 =item Linkage specification
4704
4705 =item Aliases and abbreviations
4706
4707 =item Non-option call-back routine
4708
4709 =item Option starters
4710
4711 =item Return values and Errors
4712
4713 =back
4714
4715 =item COMPATIBILITY
4716
4717 =item EXAMPLES
4718
4719 =item CONFIGURATION OPTIONS
4720
4721 default, auto_abbrev, getopt_compat, require_order, permute, bundling
4722 (default: reset), bundling_override (default: reset), ignore_case
4723 (default: set), ignore_case_always (default: reset), pass_through (default:
4724 reset), prefix, prefix_pattern, debug (default: reset)
4725
4726 =item OTHER USEFUL VARIABLES
4727
4728 $Getopt::Long::VERSION, $Getopt::Long::error
4729
4730 =item AUTHOR
4731
4732 =item COPYRIGHT AND DISCLAIMER
4733
4734 =head2 Getopt::Std, getopt - Process single-character switches with switch
4735 clustering
4736
4737 =item SYNOPSIS
4738
4739 =item DESCRIPTION
4740
4741 =head2 I18N::Collate - compare 8-bit scalar data according to the current
4742 locale
4743
4744 =item SYNOPSIS
4745
4746 =item DESCRIPTION
4747
4748 =head2 IO - load various IO modules
4749
4750 =item SYNOPSIS
4751
4752 =item DESCRIPTION
4753
4754 =head2 IO::lib::IO::File, IO::File - supply object methods for filehandles
4755
4756 =item SYNOPSIS
4757
4758 =item DESCRIPTION
4759
4760 =item CONSTRUCTOR
4761
4762 new ([ ARGS ] ), new_tmpfile
4763
4764 =item METHODS
4765
4766 open( FILENAME [,MODE [,PERMS]] )
4767
4768 =item SEE ALSO
4769
4770 =item HISTORY
4771
4772 =head2 IO::lib::IO::Handle, IO::Handle - supply object methods for I/O
4773 handles
4774
4775 =item SYNOPSIS
4776
4777 =item DESCRIPTION
4778
4779 =item CONSTRUCTOR
4780
4781 new (), new_from_fd ( FD, MODE )
4782
4783 =item METHODS
4784
4785 $fh->fdopen ( FD, MODE ), $fh->opened, $fh->getline, $fh->getlines,
4786 $fh->ungetc ( ORD ), $fh->write ( BUF, LEN [, OFFSET }\] ), $fh->flush,
4787 $fh->error, $fh->clearerr, $fh->untaint
4788
4789 =item NOTE
4790
4791 =item SEE ALSO
4792
4793 =item BUGS
4794
4795 =item HISTORY
4796
4797 =head2 IO::lib::IO::Pipe, IO::pipe - supply object methods for pipes
4798
4799 =item SYNOPSIS
4800
4801 =item DESCRIPTION
4802
4803 =item CONSTRCUTOR
4804
4805 new ( [READER, WRITER] )
4806
4807 =item METHODS
4808
4809 reader ([ARGS]), writer ([ARGS]), handles ()
4810
4811 =item SEE ALSO
4812
4813 =item AUTHOR
4814
4815 =item COPYRIGHT
4816
4817 =head2 IO::lib::IO::Seekable, IO::Seekable - supply seek based methods for
4818 I/O objects
4819
4820 =item SYNOPSIS
4821
4822 =item DESCRIPTION
4823
4824 =item SEE ALSO
4825
4826 =item HISTORY
4827
4828 =head2 IO::lib::IO::Select, IO::Select - OO interface to the select system
4829 call
4830
4831 =item SYNOPSIS
4832
4833 =item DESCRIPTION
4834
4835 =item CONSTRUCTOR
4836
4837 new ( [ HANDLES ] )
4838
4839 =item METHODS
4840
4841 add ( HANDLES ), remove ( HANDLES ), exists ( HANDLE ), handles, can_read (
4842 [ TIMEOUT ] ), can_write ( [ TIMEOUT ] ), has_error ( [ TIMEOUT ] ), count
4843 (), bits(), bits(), select ( READ, WRITE, ERROR [, TIMEOUT ] )
4844
4845 =item EXAMPLE
4846
4847 =item AUTHOR
4848
4849 =item COPYRIGHT
4850
4851 =head2 IO::lib::IO::Socket, IO::Socket - Object interface to socket
4852 communications
4853
4854 =item SYNOPSIS
4855
4856 =item DESCRIPTION
4857
4858 =item CONSTRUCTOR
4859
4860 new ( [ARGS] )
4861
4862 =item METHODS
4863
4864 accept([PKG]), timeout([VAL]), sockopt(OPT [, VAL]), sockdomain, socktype,
4865 protocol
4866
4867 =item SUB-CLASSES
4868
4869 =over
4870
4871 =item IO::Socket::INET
4872
4873 =item METHODS
4874
4875 sockaddr (), sockport (), sockhost (), peeraddr (), peerport (), peerhost
4876 ()
4877
4878 =item IO::Socket::UNIX
4879
4880 =item METHODS
4881
4882 hostpath(), peerpath()
4883
4884 =back
4885
4886 =item SEE ALSO
4887
4888 =item AUTHOR
4889
4890 =item COPYRIGHT
4891
4892 =head2 IPC::Open2, open2 - open a process for both reading and writing
4893
4894 =item SYNOPSIS
4895
4896 =item DESCRIPTION
4897
4898 =item WARNING
4899
4900 =item SEE ALSO
4901
4902 =head2 IPC::Open3, open3 - open a process for reading, writing, and error
4903 handling
4904
4905 =item SYNOPSIS
4906
4907 =item DESCRIPTION
4908
4909 =item WARNING
4910
4911 =head2 IPC::SysV - SysV IPC constants
4912
4913 =item SYNOPSIS
4914
4915 =item DESCRIPTION
4916
4917 ftok( PATH, ID )
4918
4919 =item SEE ALSO
4920
4921 =item AUTHORS
4922
4923 =item COPYRIGHT
4924
4925 =head2 IPC::SysV::Msg, IPC::Msg - SysV Msg IPC object class
4926
4927 =item SYNOPSIS
4928
4929 =item DESCRIPTION
4930
4931 =item METHODS
4932
4933 new ( KEY , FLAGS ), id, rcv ( BUF, LEN [, TYPE [, FLAGS ]] ), remove, set
4934 ( STAT ), set ( NAME => VALUE [, NAME => VALUE ...] ), snd ( TYPE, MSG [,
4935 FLAGS ] ), stat
4936
4937 =item SEE ALSO
4938
4939 =item AUTHOR
4940
4941 =item COPYRIGHT
4942
4943 =head2 IPC::SysV::Semaphore, IPC::Semaphore - SysV Semaphore IPC object
4944 class
4945
4946 =item SYNOPSIS
4947
4948 =item DESCRIPTION
4949
4950 =item METHODS
4951
4952 new ( KEY , NSEMS , FLAGS ), getall, getncnt ( SEM ), getpid ( SEM ),
4953 getval ( SEM ), getzcnt ( SEM ), id, op ( OPLIST ), remove, set ( STAT ),
4954 set ( NAME => VALUE [, NAME => VALUE ...] ), setall ( VALUES ), setval ( N
4955 , VALUE ), stat
4956
4957 =item SEE ALSO
4958
4959 =item AUTHOR
4960
4961 =item COPYRIGHT
4962
4963 =head2 Math::BigFloat - Arbitrary length float math package
4964
4965 =item SYNOPSIS
4966
4967 =item DESCRIPTION
4968
4969 number format, Error returns 'NaN', Division is computed to
4970
4971 =item BUGS
4972
4973 =item AUTHOR
4974
4975 =head2 Math::BigInt - Arbitrary size integer math package
4976
4977 =item SYNOPSIS
4978
4979 =item DESCRIPTION
4980
4981 Canonical notation, Input, Output
4982
4983 =item EXAMPLES
4984
4985 =item Autocreating constants
4986
4987 =item BUGS
4988
4989 =item AUTHOR
4990
4991 =head2 Math::Complex - complex numbers and associated mathematical
4992 functions
4993
4994 =item SYNOPSIS
4995
4996 =item DESCRIPTION
4997
4998 =item OPERATIONS
4999
5000 =item CREATION
5001
5002 =item STRINGIFICATION
5003
5004 =item USAGE
5005
5006 =item ERRORS DUE TO DIVISION BY ZERO OR LOGARITHM OF ZERO
5007
5008 =item ERRORS DUE TO INDIGESTIBLE ARGUMENTS
5009
5010 =item BUGS
5011
5012 =item AUTHORS
5013
5014 =head2 Math::Trig - trigonometric functions
5015
5016 =item SYNOPSIS
5017
5018 =item DESCRIPTION
5019
5020 =item TRIGONOMETRIC FUNCTIONS
5021
5022 B<tan>
5023
5024 =over
5025
5026 =item ERRORS DUE TO DIVISION BY ZERO
5027
5028 =item SIMPLE (REAL) ARGUMENTS, COMPLEX RESULTS
5029
5030 =back
5031
5032 =item PLANE ANGLE CONVERSIONS
5033
5034 =item RADIAL COORDINATE CONVERSIONS
5035
5036 =over
5037
5038 =item COORDINATE SYSTEMS
5039
5040 =item 3-D ANGLE CONVERSIONS
5041
5042 cartesian_to_cylindrical, cartesian_to_spherical, cylindrical_to_cartesian,
5043 cylindrical_to_spherical, spherical_to_cartesian, spherical_to_cylindrical
5044
5045 =back
5046
5047 =item GREAT CIRCLE DISTANCES
5048
5049 =item EXAMPLES
5050
5051 =item BUGS
5052
5053 =item AUTHORS
5054
5055 =head2 NDBM_File - Tied access to ndbm files
5056
5057 =item SYNOPSIS
5058
5059 =item DESCRIPTION
5060
5061 =head2 Net::Ping - check a remote host for reachability
5062
5063 =item SYNOPSIS
5064
5065 =item DESCRIPTION
5066
5067 =over
5068
5069 =item Functions
5070
5071 Net::Ping->new([$proto [, $def_timeout [, $bytes]]]);, $p->ping($host [,
5072 $timeout]);, $p->close();, pingecho($host [, $timeout]);
5073
5074 =back
5075
5076 =item WARNING
5077
5078 =item NOTES
5079
5080 =head2 Net::hostent - by-name interface to Perl's built-in gethost*()
5081 functions
5082
5083 =item SYNOPSIS
5084
5085 =item DESCRIPTION
5086
5087 =item EXAMPLES
5088
5089 =item NOTE
5090
5091 =item AUTHOR
5092
5093 =head2 Net::netent - by-name interface to Perl's built-in getnet*()
5094 functions
5095
5096 =item SYNOPSIS
5097
5098 =item DESCRIPTION
5099
5100 =item EXAMPLES
5101
5102 =item NOTE
5103
5104 =item AUTHOR
5105
5106 =head2 Net::protoent - by-name interface to Perl's built-in getproto*()
5107 functions
5108
5109 =item SYNOPSIS
5110
5111 =item DESCRIPTION
5112
5113 =item NOTE
5114
5115 =item AUTHOR
5116
5117 =head2 Net::servent - by-name interface to Perl's built-in getserv*()
5118 functions
5119
5120 =item SYNOPSIS
5121
5122 =item DESCRIPTION
5123
5124 =item EXAMPLES
5125
5126 =item NOTE
5127
5128 =item AUTHOR
5129
5130 =head2 ODBM_File - Tied access to odbm files
5131
5132 =item SYNOPSIS
5133
5134 =item DESCRIPTION
5135
5136 =head2 Opcode - Disable named opcodes when compiling perl code
5137
5138 =item SYNOPSIS
5139
5140 =item DESCRIPTION
5141
5142 =item NOTE
5143
5144 =item WARNING
5145
5146 =item Operator Names and Operator Lists
5147
5148 an operator name (opname), an operator tag name (optag), a negated opname
5149 or optag, an operator set (opset)
5150
5151 =item Opcode Functions
5152
5153 opcodes, opset (OP, ...), opset_to_ops (OPSET), opset_to_hex (OPSET),
5154 full_opset, empty_opset, invert_opset (OPSET), verify_opset (OPSET, ...),
5155 define_optag (OPTAG, OPSET), opmask_add (OPSET), opmask, opdesc (OP, ...),
5156 opdump (PAT)
5157
5158 =item Manipulating Opsets
5159
5160 =item TO DO (maybe)
5161
5162 =item Predefined Opcode Tags
5163
5164 :base_core, :base_mem, :base_loop, :base_io, :base_orig, :base_math,
5165 :base_thread, :default, :filesys_read, :sys_db, :browse, :filesys_open,
5166 :filesys_write, :subprocess, :ownprocess, :others, :still_to_be_decided,
5167 :dangerous
5168
5169 =item SEE ALSO
5170
5171 =item AUTHORS
5172
5173 =head2 Opcode::Safe, Safe - Compile and execute code in restricted
5174 compartments
5175
5176 =item SYNOPSIS
5177
5178 =item DESCRIPTION
5179
5180 a new namespace, an operator mask
5181
5182 =item WARNING
5183
5184 =over
5185
5186 =item RECENT CHANGES
5187
5188 =item Methods in class Safe
5189
5190 permit (OP, ...), permit_only (OP, ...), deny (OP, ...), deny_only (OP,
5191 ...), trap (OP, ...), untrap (OP, ...), share (NAME, ...), share_from
5192 (PACKAGE, ARRAYREF), varglob (VARNAME), reval (STRING), rdo (FILENAME),
5193 root (NAMESPACE), mask (MASK)
5194
5195 =item Some Safety Issues
5196
5197 Memory, CPU, Snooping, Signals, State Changes
5198
5199 =item AUTHOR
5200
5201 =back
5202
5203 =head2 Opcode::ops, ops - Perl pragma to restrict unsafe operations when
5204 compiling
5205
5206 =item SYNOPSIS
5207
5208 =item DESCRIPTION
5209
5210 =item SEE ALSO
5211
5212 =head2 POSIX - Perl interface to IEEE Std 1003.1
5213
5214 =item SYNOPSIS
5215
5216 =item DESCRIPTION
5217
5218 =item NOTE
5219
5220 =item CAVEATS
5221
5222 =item FUNCTIONS
5223
5224 _exit, abort, abs, access, acos, alarm, asctime, asin, assert, atan, atan2,
5225 atexit, atof, atoi, atol, bsearch, calloc, ceil, chdir, chmod, chown,
5226 clearerr, clock, close, closedir, cos, cosh, creat, ctermid, ctime,
5227 cuserid, difftime, div, dup, dup2, errno, execl, execle, execlp, execv,
5228 execve, execvp, exit, exp, fabs, fclose, fcntl, fdopen, feof, ferror,
5229 fflush, fgetc, fgetpos, fgets, fileno, floor, fmod, fopen, fork, fpathconf,
5230 fprintf, fputc, fputs, fread, free, freopen, frexp, fscanf, fseek, fsetpos,
5231 fstat, ftell, fwrite, getc, getchar, getcwd, getegid, getenv, geteuid,
5232 getgid, getgrgid, getgrnam, getgroups, getlogin, getpgrp, getpid, getppid,
5233 getpwnam, getpwuid, gets, getuid, gmtime, isalnum, isalpha, isatty,
5234 iscntrl, isdigit, isgraph, islower, isprint, ispunct, isspace, isupper,
5235 isxdigit, kill, labs, ldexp, ldiv, link, localeconv, localtime, log, log10,
5236 longjmp, lseek, malloc, mblen, mbstowcs, mbtowc, memchr, memcmp, memcpy,
5237 memmove, memset, mkdir, mkfifo, mktime, modf, nice, offsetof, open,
5238 opendir, pathconf, pause, perror, pipe, pow, printf, putc, putchar, puts,
5239 qsort, raise, rand, read, readdir, realloc, remove, rename, rewind,
5240 rewinddir, rmdir, scanf, setgid, setjmp, setlocale, setpgid, setsid,
5241 setuid, sigaction, siglongjmp, sigpending, sigprocmask, sigsetjmp,
5242 sigsuspend, sin, sinh, sleep, sprintf, sqrt, srand, sscanf, stat, strcat,
5243 strchr, strcmp, strcoll, strcpy, strcspn, strerror, strftime, strlen,
5244 strncat, strncmp, strncpy, stroul, strpbrk, strrchr, strspn, strstr,
5245 strtod, strtok, strtol, strtoul, strxfrm, sysconf, system, tan, tanh,
5246 tcdrain, tcflow, tcflush, tcgetpgrp, tcsendbreak, tcsetpgrp, time, times,
5247 tmpfile, tmpnam, tolower, toupper, ttyname, tzname, tzset, umask, uname,
5248 ungetc, unlink, utime, vfprintf, vprintf, vsprintf, wait, waitpid,
5249 wcstombs, wctomb, write
5250
5251 =item CLASSES
5252
5253 =over
5254
5255 =item POSIX::SigAction
5256
5257 new
5258
5259 =item POSIX::SigSet
5260
5261 new, addset, delset, emptyset, fillset, ismember
5262
5263 =item POSIX::Termios
5264
5265 new, getattr, getcc, getcflag, getiflag, getispeed, getlflag, getoflag,
5266 getospeed, setattr, setcc, setcflag, setiflag, setispeed, setlflag,
5267 setoflag, setospeed, Baud rate values, Terminal interface values, c_cc
5268 field values, c_cflag field values, c_iflag field values, c_lflag field
5269 values, c_oflag field values
5270
5271 =back
5272
5273 =item PATHNAME CONSTANTS
5274
5275 Constants
5276
5277 =item POSIX CONSTANTS
5278
5279 Constants
5280
5281 =item SYSTEM CONFIGURATION
5282
5283 Constants
5284
5285 =item ERRNO
5286
5287 Constants
5288
5289 =item FCNTL
5290
5291 Constants
5292
5293 =item FLOAT
5294
5295 Constants
5296
5297 =item LIMITS
5298
5299 Constants
5300
5301 =item LOCALE
5302
5303 Constants
5304
5305 =item MATH
5306
5307 Constants
5308
5309 =item SIGNAL
5310
5311 Constants
5312
5313 =item STAT
5314
5315 Constants, Macros
5316
5317 =item STDLIB
5318
5319 Constants
5320
5321 =item STDIO
5322
5323 Constants
5324
5325 =item TIME
5326
5327 Constants
5328
5329 =item UNISTD
5330
5331 Constants
5332
5333 =item WAIT
5334
5335 Constants, Macros
5336
5337 =item CREATION
5338
5339 =head2 Pod::Html - module to convert pod files to HTML
5340
5341 =item SYNOPSIS
5342
5343 =item DESCRIPTION
5344
5345 =item ARGUMENTS
5346
5347 help, htmlroot, infile, outfile, podroot, podpath, libpods, netscape,
5348 nonetscape, index, noindex, recurse, norecurse, title, verbose
5349
5350 =item EXAMPLE
5351
5352 =item AUTHOR
5353
5354 =item BUGS
5355
5356 =item SEE ALSO
5357
5358 =item COPYRIGHT
5359
5360 =head2 Pod::Text - convert POD data to formatted ASCII text
5361
5362 =item SYNOPSIS
5363
5364 =item DESCRIPTION
5365
5366 =item AUTHOR
5367
5368 =item TODO
5369
5370 =head2 SDBM_File - Tied access to sdbm files
5371
5372 =item SYNOPSIS
5373
5374 =item DESCRIPTION
5375
5376 =head2 Search::Dict, look - search for key in dictionary file
5377
5378 =item SYNOPSIS
5379
5380 =item DESCRIPTION
5381
5382 =head2 SelectSaver - save and restore selected file handle
5383
5384 =item SYNOPSIS
5385
5386 =item DESCRIPTION
5387
5388 =head2 SelfLoader - load functions only on demand
5389
5390 =item SYNOPSIS
5391
5392 =item DESCRIPTION
5393
5394 =over
5395
5396 =item The __DATA__ token
5397
5398 =item SelfLoader autoloading
5399
5400 =item Autoloading and package lexicals
5401
5402 =item SelfLoader and AutoLoader
5403
5404 =item __DATA__, __END__, and the FOOBAR::DATA filehandle.
5405
5406 =item Classes and inherited methods.
5407
5408 =back
5409
5410 =item Multiple packages and fully qualified subroutine names
5411
5412 =head2 Shell - run shell commands transparently within perl
5413
5414 =item SYNOPSIS
5415
5416 =item DESCRIPTION
5417
5418 =item AUTHOR
5419
5420 =head2 Socket, sockaddr_in, sockaddr_un, inet_aton, inet_ntoa - load the C
5421 socket.h defines and structure manipulators
5422
5423 =item SYNOPSIS
5424
5425 =item DESCRIPTION
5426
5427 inet_aton HOSTNAME, inet_ntoa IP_ADDRESS, INADDR_ANY, INADDR_BROADCAST,
5428 INADDR_LOOPBACK, INADDR_NONE, sockaddr_in PORT, ADDRESS, sockaddr_in
5429 SOCKADDR_IN, pack_sockaddr_in PORT, IP_ADDRESS, unpack_sockaddr_in
5430 SOCKADDR_IN, sockaddr_un PATHNAME, sockaddr_un SOCKADDR_UN,
5431 pack_sockaddr_un PATH, unpack_sockaddr_un SOCKADDR_UN
5432
5433 =head2 Symbol - manipulate Perl symbols and their names
5434
5435 =item SYNOPSIS
5436
5437 =item DESCRIPTION
5438
5439 =head2 Sys::Hostname - Try every conceivable way to get hostname
5440
5441 =item SYNOPSIS
5442
5443 =item DESCRIPTION
5444
5445 =item AUTHOR
5446
5447 =head2 Syslog, Sys::Syslog, openlog, closelog, setlogmask, syslog - Perl
5448 interface to the UNIX syslog(3) calls
5449
5450 =item SYNOPSIS
5451
5452 =item DESCRIPTION
5453
5454 openlog $ident, $logopt, $facility, syslog $priority, $format, @args,
5455 setlogmask $mask_priority, setlogsock $sock_type (added in 5.004_02),
5456 closelog
5457
5458 =item EXAMPLES
5459
5460 =item DEPENDENCIES
5461
5462 =item SEE ALSO
5463
5464 =item AUTHOR
5465
5466 =head2 Term::Cap - Perl termcap interface
5467
5468 =item SYNOPSIS
5469
5470 =item DESCRIPTION
5471
5472 =item EXAMPLES
5473
5474 =head2 Term::Complete - Perl word completion module
5475
5476 =item SYNOPSIS
5477
5478 =item DESCRIPTION
5479
5480 E<lt>tabE<gt>, ^D, ^U, E<lt>delE<gt>, E<lt>bsE<gt>
5481
5482 =item DIAGNOSTICS
5483
5484 =item BUGS
5485
5486 =item AUTHOR
5487
5488 =head2 Term::ReadLine - Perl interface to various C<readline> packages. If
5489 no real package is found, substitutes stubs instead of basic functions.
5490
5491 =item SYNOPSIS
5492
5493 =item DESCRIPTION
5494
5495 =item Minimal set of supported functions
5496
5497 C<ReadLine>, C<new>, C<readline>, C<addhistory>, C<IN>, $C<OUT>,
5498 C<MinLine>, C<findConsole>, Attribs, C<Features>
5499
5500 =item Additional supported functions
5501
5502 C<tkRunning>, C<ornaments>, C<newTTY>
5503
5504 =item EXPORTS
5505
5506 =item ENVIRONMENT
5507
5508 =head2   Test - provides a simple framework for writing test scripts
5509
5510 =item SYNOPSIS
5511
5512 =item DESCRIPTION
5513
5514 =item TEST TYPES
5515
5516 NORMAL TESTS, SKIPPED TESTS, TODO TESTS
5517
5518 =item ONFAIL
5519
5520 =item SEE ALSO
5521
5522 =item AUTHOR
5523
5524 =head2 Test::Harness - run perl standard test scripts with statistics
5525
5526 =item SYNOPSIS
5527
5528 =item DESCRIPTION
5529
5530 =over
5531
5532 =item The test script output
5533
5534 =back
5535
5536 =item EXPORT
5537
5538 =item DIAGNOSTICS
5539
5540 C<All tests successful.\nFiles=%d,  Tests=%d, %s>, C<FAILED tests
5541 %s\n\tFailed %d/%d tests, %.2f%% okay.>, C<Test returned status %d (wstat
5542 %d)>, C<Failed 1 test, %.2f%% okay. %s>, C<Failed %d/%d tests, %.2f%% okay.
5543 %s>
5544
5545 =item ENVIRONMENT
5546
5547 =item SEE ALSO
5548
5549 =item AUTHORS
5550
5551 =item BUGS
5552
5553 =head2 Text::Abbrev, abbrev - create an abbreviation table from a list
5554
5555 =item SYNOPSIS
5556
5557 =item DESCRIPTION
5558
5559 =item EXAMPLE
5560
5561 =head2 Text::ParseWords - parse text into an array of tokens or array of
5562 arrays
5563
5564 =item SYNOPSIS
5565
5566 =item DESCRIPTION
5567
5568 =item EXAMPLES
5569
5570 0a simple word, 1multiple spaces are skipped because of our $delim, 2use of
5571 quotes to include a space in a word, 3use of a backslash to include a space
5572 in a word, 4use of a backslash to remove the special meaning of a
5573 double-quote, 5another simple word (note the lack of effect of the
5574 backslashed double-quote)
5575
5576 =item AUTHORS
5577
5578 =head2 Text::Soundex - Implementation of the Soundex Algorithm as Described
5579 by Knuth
5580
5581 =item SYNOPSIS
5582
5583 =item DESCRIPTION
5584
5585 =item EXAMPLES
5586
5587 =item LIMITATIONS
5588
5589 =item AUTHOR
5590
5591 =head2 Text::Tabs -- expand and unexpand tabs per the unix expand(1) and
5592 unexpand(1)
5593
5594 =item SYNOPSIS
5595
5596 =item DESCRIPTION
5597
5598 =item BUGS
5599
5600 =item AUTHOR
5601
5602 =head2 Text::Wrap - line wrapping to form simple paragraphs
5603
5604 =item SYNOPSIS
5605
5606 =item DESCRIPTION
5607
5608 =item EXAMPLE
5609
5610 =item BUGS
5611
5612 =item AUTHOR
5613
5614 =head2 Thread - multithreading
5615
5616 =item SYNOPSIS
5617
5618 =item DESCRIPTION
5619
5620 =item FUNCTIONS
5621
5622 new \&start_sub, new \&start_sub, LIST, lock VARIABLE, async BLOCK;,
5623 Thread->self, Thread->list, cond_wait VARIABLE, cond_signal VARIABLE,
5624 cond_broadcast VARIABLE
5625
5626 =item METHODS
5627
5628 join, eval, tid
5629
5630 =item LIMITATIONS
5631
5632 =item SEE ALSO
5633
5634 =head2 Thread::Queue - thread-safe queues
5635
5636 =item SYNOPSIS
5637
5638 =item DESCRIPTION
5639
5640 =item FUNCTIONS AND METHODS
5641
5642 new, enqueue LIST, dequeue, dequeue_nb, pending
5643
5644 =item SEE ALSO
5645
5646 =head2 Thread::Semaphore - thread-safe semaphores
5647
5648 =item SYNOPSIS
5649
5650 =item DESCRIPTION
5651
5652 =item FUNCTIONS AND METHODS
5653
5654 new, new NUMBER, down, down NUMBER, up, up NUMBER
5655
5656 =head2 Thread::Signal - Start a thread which runs signal handlers reliably
5657
5658 =item SYNOPSIS
5659
5660 =item DESCRIPTION
5661
5662 =item BUGS
5663
5664 =head2 Thread::Specific - thread-specific keys
5665
5666 =item SYNOPSIS
5667
5668 =head2 Tie::Array - base class for tied arrays
5669
5670 =item SYNOPSIS
5671
5672 =item DESCRIPTION
5673
5674 TIEARRAY classname, LIST, STORE this, index, value, FETCH this, index,
5675 FETCHSIZE this, STORESIZE this, count, EXTEND this, count, CLEAR this,
5676 DESTROY this, PUSH this, LIST, POP this, SHIFT this, UNSHIFT this, LIST,
5677 SPLICE this, offset, length, LIST
5678
5679 =item CAVEATS
5680
5681 =item AUTHOR
5682
5683 =head2 Tie::Handle - base class definitions for tied handles
5684
5685 =item SYNOPSIS
5686
5687 =item DESCRIPTION
5688
5689 TIEHANDLE classname, LIST, WRITE this, scalar, length, offset, PRINT this,
5690 LIST, PRINTF this, format, LIST, READ this, scalar, length, offset,
5691 READLINE this, GETC this, DESTROY this
5692
5693 =item MORE INFORMATION
5694
5695 =head2 Tie::Hash, Tie::StdHash - base class definitions for tied hashes
5696
5697 =item SYNOPSIS
5698
5699 =item DESCRIPTION
5700
5701 TIEHASH classname, LIST, STORE this, key, value, FETCH this, key, FIRSTKEY
5702 this, NEXTKEY this, lastkey, EXISTS this, key, DELETE this, key, CLEAR this
5703
5704 =item CAVEATS
5705
5706 =item MORE INFORMATION
5707
5708 =head2 Tie::RefHash - use references as hash keys
5709
5710 =item SYNOPSIS
5711
5712 =item DESCRIPTION
5713
5714 =item EXAMPLE
5715
5716 =item AUTHOR
5717
5718 =item VERSION
5719
5720 =item SEE ALSO
5721
5722 =head2 Tie::Scalar, Tie::StdScalar - base class definitions for tied
5723 scalars
5724
5725 =item SYNOPSIS
5726
5727 =item DESCRIPTION
5728
5729 TIESCALAR classname, LIST, FETCH this, STORE this, value, DESTROY this
5730
5731 =item MORE INFORMATION
5732
5733 =head2 Tie::SubstrHash - Fixed-table-size, fixed-key-length hashing
5734
5735 =item SYNOPSIS
5736
5737 =item DESCRIPTION
5738
5739 =item CAVEATS
5740
5741 =head2 Time::Local - efficiently compute time from local and GMT time
5742
5743 =item SYNOPSIS
5744
5745 =item DESCRIPTION
5746
5747 =head2 Time::gmtime - by-name interface to Perl's built-in gmtime()
5748 function
5749
5750 =item SYNOPSIS
5751
5752 =item DESCRIPTION
5753
5754 =item NOTE
5755
5756 =item AUTHOR
5757
5758 =head2 Time::localtime - by-name interface to Perl's built-in localtime()
5759 function
5760
5761 =item SYNOPSIS
5762
5763 =item DESCRIPTION
5764
5765 =item NOTE
5766
5767 =item AUTHOR
5768
5769 =head2 Time::tm - internal object used by Time::gmtime and Time::localtime
5770
5771 =item SYNOPSIS
5772
5773 =item DESCRIPTION
5774
5775 =item AUTHOR
5776
5777 =head2 UNIVERSAL - base class for ALL classes (blessed references)
5778
5779 =item SYNOPSIS
5780
5781 =item DESCRIPTION
5782
5783 isa ( TYPE ), can ( METHOD ), VERSION ( [ REQUIRE ] ), UNIVERSAL::isa (
5784 VAL, TYPE ), UNIVERSAL::can ( VAL, METHOD )
5785
5786 =head2 User::grent - by-name interface to Perl's built-in getgr*()
5787 functions
5788
5789 =item SYNOPSIS
5790
5791 =item DESCRIPTION
5792
5793 =item NOTE
5794
5795 =item AUTHOR
5796
5797 =head2 User::pwent - by-name interface to Perl's built-in getpw*()
5798 functions
5799
5800 =item SYNOPSIS
5801
5802 =item DESCRIPTION
5803
5804 =item NOTE
5805
5806 =item AUTHOR
5807
5808 =head1 AUXILIARY DOCUMENTATION
5809
5810 Here should be listed all the extra programs' documentation, but they
5811 don't all have manual pages yet:
5812
5813 =item a2p
5814
5815 =item s2p
5816
5817 =item find2perl
5818
5819 =item h2ph
5820
5821 =item c2ph
5822
5823 =item h2xs
5824
5825 =item xsubpp
5826
5827 =item pod2man
5828
5829 =item wrapsuid
5830
5831 =head1 AUTHOR
5832
5833 Larry Wall <F<larry@wall.org>>, with the help of oodles
5834 of other folks.
5835