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