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