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