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