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