pod/perltoc.pod

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