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