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