rename byte:: to bytes::
[p5sagit/p5-mst-13.2.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 =over
17
18 =item SYNOPSIS
19
20 =item DESCRIPTION
21
22 modularity and reusability using innumerable modules, embeddable and
23 extensible, roll-your-own magic variables (including multiple simultaneous
24 DBM implementations), subroutines can now be overridden, autoloaded, and
25 prototyped, arbitrarily nested data structures and anonymous functions,
26 object-oriented programming, compilability into C code or Perl bytecode,
27 support for light-weight processes (threads), support for
28 internationalization, localization, and Unicode, lexical scoping, regular
29 expression enhancements, enhanced debugger and interactive Perl
30 environment, with integrated editor support, POSIX 1003.1 compliant library
31
32 =item AVAILABILITY
33
34 =item ENVIRONMENT
35
36 =item AUTHOR
37
38 =item FILES
39
40 =item SEE ALSO
41
42 =item DIAGNOSTICS
43
44 =item BUGS
45
46 =item NOTES
47
48 =back
49
50 =head2 perlfaq - frequently asked questions about Perl ($Date: 1999/05/23
51 20:38:02 $)
52
53 =over
54
55 =item DESCRIPTION
56
57 perlfaq: Structural overview of the FAQ, L<perlfaq1>: General Questions
58 About Perl, What is Perl?, Who supports Perl?  Who develops it?  Why is it
59 free?, Which version of Perl should I use?, What are perl4 and perl5?, What
60 is perl6?, How stable is Perl?, Is Perl difficult to learn?, How does Perl
61 compare with other languages like Java, Python, REXX, Scheme, or Tcl?, Can
62 I do [task] in Perl?, When shouldn't I program in Perl?, What's the
63 difference between "perl" and "Perl"?, Is it a Perl program or a Perl
64 script?, What is a JAPH?, Where can I get a list of Larry Wall witticisms?,
65 How can I convince my sysadmin/supervisor/employees to use version
66 (5/5.005/Perl instead of some other language)?, L<perlfaq2>: Obtaining and
67 Learning about Perl, What machines support Perl?  Where do I get it?, How
68 can I get a binary version of Perl?, I don't have a C compiler on my
69 system.  How can I compile perl?, I copied the Perl binary from one machine
70 to another, but scripts don't work, I grabbed the sources and tried to
71 compile but gdbm/dynamic loading/malloc/linking/... failed.  How do I make
72 it work?, What modules and extensions are available for Perl?  What is
73 CPAN?  What does CPAN/src/... mean?, Is there an ISO or ANSI certified
74 version of Perl?, Where can I get information on Perl?, What are the Perl
75 newsgroups on USENET?  Where do I post questions?, Where should I post
76 source code?, Perl Books, Perl in Magazines, Perl on the Net: FTP and WWW
77 Access, What mailing lists are there for perl?, Archives of
78 comp.lang.perl.misc, Where can I buy a commercial version of Perl?, Where
79 do I send bug reports?, What is perl.com?, L<perlfaq3>: Programming Tools,
80 How do I do (anything)?, How can I use Perl interactively?, Is there a Perl
81 shell?, How do I debug my Perl programs?, How do I profile my Perl
82 programs?, How do I cross-reference my Perl programs?, Is there a
83 pretty-printer (formatter) for Perl?, Is there a ctags for Perl?, Is there
84 an IDE or Windows Perl Editor?, Where can I get Perl macros for vi?, Where
85 can I get perl-mode for emacs?, How can I use curses with Perl?, How can I
86 use X or Tk with Perl?, How can I generate simple menus without using CGI
87 or Tk?, What is undump?, How can I make my Perl program run faster?, How
88 can I make my Perl program take less memory?, Is it unsafe to return a
89 pointer to local data?, How can I free an array or hash so my program
90 shrinks?, How can I make my CGI script more efficient?, How can I hide the
91 source for my Perl program?, How can I compile my Perl program into byte
92 code or C?, How can I compile Perl into Java?, How can I get C<#!perl> to
93 work on [MS-DOS,NT,...]?, Can I write useful perl programs on the command
94 line?, Why don't perl one-liners work on my DOS/Mac/VMS system?, Where can
95 I learn about CGI or Web programming in Perl?, Where can I learn about
96 object-oriented Perl programming?, Where can I learn about linking C with
97 Perl? [h2xs, xsubpp], I've read perlembed, perlguts, etc., but I can't
98 embed perl inmy C program, what am I doing wrong?, When I tried to run my
99 script, I got this message. What does itmean?, What's MakeMaker?,
100 L<perlfaq4>: Data Manipulation, Why am I getting long decimals (eg,
101 19.9499999999999) instead of the numbers I should be getting (eg, 19.95)?,
102 Why isn't my octal data interpreted correctly?, Does Perl have a round()
103 function?  What about ceil() and floor()?  Trig functions?, How do I
104 convert bits into ints?, Why doesn't & work the way I want it to?, How do I
105 multiply matrices?, How do I perform an operation on a series of integers?,
106 How can I output Roman numerals?, Why aren't my random numbers random?, How
107 do I find the week-of-the-year/day-of-the-year?, How do I find the current
108 century or millennium?, How can I compare two dates and find the
109 difference?, How can I take a string and turn it into epoch seconds?, How
110 can I find the Julian Day?, How do I find yesterday's date?, Does Perl have
111 a year 2000 problem?  Is Perl Y2K compliant?, How do I validate input?, How
112 do I unescape a string?, How do I remove consecutive pairs of characters?,
113 How do I expand function calls in a string?, How do I find matching/nesting
114 anything?, How do I reverse a string?, How do I expand tabs in a string?,
115 How do I reformat a paragraph?, How can I access/change the first N letters
116 of a string?, How do I change the Nth occurrence of something?, How can I
117 count the number of occurrences of a substring within a string?, How do I
118 capitalize all the words on one line?, How can I split a [character]
119 delimited string except when inside[character]? (Comma-separated files),
120 How do I strip blank space from the beginning/end of a string?, How do I
121 pad a string with blanks or pad a number with zeroes?, How do I extract
122 selected columns from a string?, How do I find the soundex value of a
123 string?, How can I expand variables in text strings?, What's wrong with
124 always quoting "$vars"?, Why don't my E<lt>E<lt>HERE documents work?, What
125 is the difference between a list and an array?, What is the difference
126 between $array[1] and @array[1]?, How can I remove duplicate elements from
127 a list or array?, How can I tell whether a list or array contains a certain
128 element?, How do I compute the difference of two arrays?  How do I compute
129 the intersection of two arrays?, How do I test whether two arrays or hashes
130 are equal?, How do I find the first array element for which a condition is
131 true?, How do I handle linked lists?, How do I handle circular lists?, How
132 do I shuffle an array randomly?, How do I process/modify each element of an
133 array?, How do I select a random element from an array?, How do I permute N
134 elements of a list?, How do I sort an array by (anything)?, How do I
135 manipulate arrays of bits?, Why does defined() return true on empty arrays
136 and hashes?, How do I process an entire hash?, What happens if I add or
137 remove keys from a hash while iterating over it?, How do I look up a hash
138 element by value?, How can I know how many entries are in a hash?, How do I
139 sort a hash (optionally by value instead of key)?, How can I always keep my
140 hash sorted?, What's the difference between "delete" and "undef" with
141 hashes?, Why don't my tied hashes make the defined/exists distinction?, How
142 do I reset an each() operation part-way through?, How can I get the unique
143 keys from two hashes?, How can I store a multidimensional array in a DBM
144 file?, How can I make my hash remember the order I put elements into it?,
145 Why does passing a subroutine an undefined element in a hash create it?,
146 How can I make the Perl equivalent of a C structure/C++ class/hash or array
147 of hashes or arrays?, How can I use a reference as a hash key?, How do I
148 handle binary data correctly?, How do I determine whether a scalar is a
149 number/whole/integer/float?, How do I keep persistent data across program
150 calls?, How do I print out or copy a recursive data structure?, How do I
151 define methods for every class/object?, How do I verify a credit card
152 checksum?, How do I pack arrays of doubles or floats for XS code?,
153 L<perlfaq5>: Files and Formats, How do I flush/unbuffer an output
154 filehandle?  Why must I do this?, How do I change one line in a file/delete
155 a line in a file/insert a line in the middle of a file/append to the
156 beginning of a file?, How do I count the number of lines in a file?, How do
157 I make a temporary file name?, How can I manipulate fixed-record-length
158 files?, How can I make a filehandle local to a subroutine?  How do I pass
159 filehandles between subroutines?  How do I make an array of filehandles?,
160 How can I use a filehandle indirectly?, How can I set up a footer format to
161 be used with write()?, How can I write() into a string?, How can I output
162 my numbers with commas added?, How can I translate tildes (~) in a
163 filename?, How come when I open a file read-write it wipes it out?, Why do
164 I sometimes get an "Argument list too long" when I use E<lt>*E<gt>?, Is
165 there a leak/bug in glob()?, How can I open a file with a leading "E<gt>"
166 or trailing blanks?, How can I reliably rename a file?, How can I lock a
167 file?, Why can't I just open(FH, ">file.lock")?, I still don't get locking.
168  I just want to increment the number in the file.  How can I do this?, How
169 do I randomly update a binary file?, How do I get a file's timestamp in
170 perl?, How do I set a file's timestamp in perl?, How do I print to more
171 than one file at once?, How can I read in an entire file all at once?, How
172 can I read in a file by paragraphs?, How can I read a single character from
173 a file?  From the keyboard?, How can I tell whether there's a character
174 waiting on a filehandle?, How do I do a C<tail -f> in perl?, How do I dup()
175 a filehandle in Perl?, How do I close a file descriptor by number?, Why
176 can't I use "C:\temp\foo" in DOS paths?  What doesn't `C:\temp\foo.exe`
177 work?, Why doesn't glob("*.*") get all the files?, Why does Perl let me
178 delete read-only files?  Why does C<-i> clobber protected files?  Isn't
179 this a bug in Perl?, How do I select a random line from a file?, Why do I
180 get weird spaces when I print an array of lines?, L<perlfaq6>: Regexps, How
181 can I hope to use regular expressions without creating illegible and
182 unmaintainable code?, I'm having trouble matching over more than one line. 
183 What's wrong?, How can I pull out lines between two patterns that are
184 themselves on different lines?, I put a regular expression into $/ but it
185 didn't work. What's wrong?, How do I substitute case insensitively on the
186 LHS, but preserving case on the RHS?, How can I make C<\w> match national
187 character sets?, How can I match a locale-smart version of C</[a-zA-Z]/>?,
188 How can I quote a variable to use in a regex?, What is C</o> really for?,
189 How do I use a regular expression to strip C style comments from a file?,
190 Can I use Perl regular expressions to match balanced text?, What does it
191 mean that regexes are greedy?  How can I get around it?, How do I process
192 each word on each line?, How can I print out a word-frequency or
193 line-frequency summary?, How can I do approximate matching?, How do I
194 efficiently match many regular expressions at once?, Why don't
195 word-boundary searches with C<\b> work for me?, Why does using $&, $`, or
196 $' slow my program down?, What good is C<\G> in a regular expression?, Are
197 Perl regexes DFAs or NFAs?  Are they POSIX compliant?, What's wrong with
198 using grep or map in a void context?, How can I match strings with
199 multibyte characters?, How do I match a pattern that is supplied by the
200 user?, L<perlfaq7>: General Perl Language Issues, Can I get a BNF/yacc/RE
201 for the Perl language?, What are all these $@%&* punctuation signs, and how
202 do I know when to use them?, Do I always/never have to quote my strings or
203 use semicolons and commas?, How do I skip some return values?, How do I
204 temporarily block warnings?, What's an extension?, Why do Perl operators
205 have different precedence than C operators?, How do I declare/create a
206 structure?, How do I create a module?, How do I create a class?, How can I
207 tell if a variable is tainted?, What's a closure?, What is variable suicide
208 and how can I prevent it?, How can I pass/return a {Function, FileHandle,
209 Array, Hash, Method, Regex}?, How do I create a static variable?, What's
210 the difference between dynamic and lexical (static) scoping?  Between
211 local() and my()?, How can I access a dynamic variable while a similarly
212 named lexical is in scope?, What's the difference between deep and shallow
213 binding?, Why doesn't "my($foo) = E<lt>FILEE<gt>;" work right?, How do I
214 redefine a builtin function, operator, or method?, What's the difference
215 between calling a function as &foo and foo()?, How do I create a switch or
216 case statement?, How can I catch accesses to undefined
217 variables/functions/methods?, Why can't a method included in this same file
218 be found?, How can I find out my current package?, How can I comment out a
219 large block of perl code?, How do I clear a package?, How can I use a
220 variable as a variable name?, L<perlfaq8>: System Interaction, How do I
221 find out which operating system I'm running under?, How come exec() doesn't
222 return?, How do I do fancy stuff with the keyboard/screen/mouse?, How do I
223 print something out in color?, How do I read just one key without waiting
224 for a return key?, How do I check whether input is ready on the keyboard?,
225 How do I clear the screen?, How do I get the screen size?, How do I ask the
226 user for a password?, How do I read and write the serial port?, How do I
227 decode encrypted password files?, How do I start a process in the
228 background?, How do I trap control characters/signals?, How do I modify the
229 shadow password file on a Unix system?, How do I set the time and date?,
230 How can I sleep() or alarm() for under a second?, How can I measure time
231 under a second?, How can I do an atexit() or setjmp()/longjmp()? (Exception
232 handling), Why doesn't my sockets program work under System V (Solaris)?
233 What does the error message "Protocol not supported" mean?, How can I call
234 my system's unique C functions from Perl?, Where do I get the include files
235 to do ioctl() or syscall()?, Why do setuid perl scripts complain about
236 kernel problems?, How can I open a pipe both to and from a command?, Why
237 can't I get the output of a command with system()?, How can I capture
238 STDERR from an external command?, Why doesn't open() return an error when a
239 pipe open fails?, What's wrong with using backticks in a void context?, How
240 can I call backticks without shell processing?, Why can't my script read
241 from STDIN after I gave it EOF (^D on Unix, ^Z on MS-DOS)?, How can I
242 convert my shell script to perl?, Can I use perl to run a telnet or ftp
243 session?, How can I write expect in Perl?, Is there a way to hide perl's
244 command line from programs such as "ps"?, I {changed directory, modified my
245 environment} in a perl script.  How come the change disappeared when I
246 exited the script?  How do I get my changes to be visible?, How do I close
247 a process's filehandle without waiting for it to complete?, How do I fork a
248 daemon process?, How do I make my program run with sh and csh?, How do I
249 find out if I'm running interactively or not?, How do I timeout a slow
250 event?, How do I set CPU limits?, How do I avoid zombies on a Unix system?,
251 How do I use an SQL database?, How do I make a system() exit on control-C?,
252 How do I open a file without blocking?, How do I install a module from
253 CPAN?, What's the difference between require and use?, How do I keep my own
254 module/library directory?, How do I add the directory my program lives in
255 to the module/library search path?, How do I add a directory to my include
256 path at runtime?, What is socket.ph and where do I get it?, L<perlfaq9>:
257 Networking, My CGI script runs from the command line but not the browser.  
258 (500 Server Error), How can I get better error messages from a CGI
259 program?, How do I remove HTML from a string?, How do I extract URLs?, How
260 do I download a file from the user's machine?  How do I open a file on
261 another machine?, How do I make a pop-up menu in HTML?, How do I fetch an
262 HTML file?, How do I automate an HTML form submission?, How do I decode or
263 create those %-encodings on the web?, How do I redirect to another page?,
264 How do I put a password on my web pages?, How do I edit my .htpasswd and
265 .htgroup files with Perl?, How do I make sure users can't enter values into
266 a form that cause my CGI script to do bad things?, How do I parse a mail
267 header?, How do I decode a CGI form?, How do I check a valid mail address?,
268 How do I decode a MIME/BASE64 string?, How do I return the user's mail
269 address?, How do I send mail?, How do I read mail?, How do I find out my
270 hostname/domainname/IP address?, How do I fetch a news article or the
271 active newsgroups?, How do I fetch/put an FTP file?, How can I do RPC in
272 Perl?
273
274 =over
275
276 =item Where to get this document
277
278 =item How to contribute to this document
279
280 =item What will happen if you mail your Perl programming problems to the
281 authors
282
283 =back
284
285 =item Credits
286
287 =item Author and Copyright Information
288
289 =over
290
291 =item Bundled Distributions
292
293 =item Disclaimer
294
295 =back
296
297 =item Changes
298
299 23/May/99, 13/April/99, 7/January/99, 22/June/98, 24/April/97, 23/April/97,
300 25/March/97, 18/March/97, 17/March/97 Version, Initial Release: 11/March/97
301
302 =back
303
304 =head2 perlfaq1 - General Questions About Perl ($Revision: 1.23 $, $Date:
305 1999/05/23 16:08:30 $)
306
307 =over
308
309 =item DESCRIPTION
310
311 =over
312
313 =item What is Perl?
314
315 =item Who supports Perl?  Who develops it?  Why is it free?
316
317 =item Which version of Perl should I use?
318
319 =item What are perl4 and perl5?
320
321 =item What is perl6?
322
323 =item How stable is Perl?
324
325 =item Is Perl difficult to learn?
326
327 =item How does Perl compare with other languages like Java, Python, REXX,
328 Scheme, or Tcl?
329
330 =item Can I do [task] in Perl?
331
332 =item When shouldn't I program in Perl?
333
334 =item What's the difference between "perl" and "Perl"?
335
336 =item Is it a Perl program or a Perl script?
337
338 =item What is a JAPH?
339
340 =item Where can I get a list of Larry Wall witticisms?
341
342 =item How can I convince my sysadmin/supervisor/employees to use version
343 (5/5.005/Perl instead of some other language)?
344
345 =back
346
347 =item AUTHOR AND COPYRIGHT
348
349 =back
350
351 =head2 perlfaq2 - Obtaining and Learning about Perl ($Revision: 1.32 $,
352 $Date: 1999/10/14 18:46:09 $)
353
354 =over
355
356 =item DESCRIPTION
357
358 =over
359
360 =item What machines support Perl?  Where do I get it?
361
362 =item How can I get a binary version of Perl?
363
364 =item I don't have a C compiler on my system.  How can I compile perl?
365
366 =item I copied the Perl binary from one machine to another, but scripts
367 don't work.
368
369 =item I grabbed the sources and tried to compile but gdbm/dynamic
370 loading/malloc/linking/... failed.  How do I make it work?
371
372 =item What modules and extensions are available for Perl?  What is CPAN? 
373 What does CPAN/src/... mean?
374
375 =item Is there an ISO or ANSI certified version of Perl?
376
377 =item Where can I get information on Perl?
378
379 =item What are the Perl newsgroups on Usenet?  Where do I post questions?
380
381 =item Where should I post source code?
382
383 =item Perl Books
384
385 References, Tutorials           
386     *Learning Perl [2nd edition]
387         by Randal L. Schwartz and Tom Christiansen
388             with foreword by Larry Wall, Task-Oriented, Special Topics
389
390 =item Perl in Magazines
391
392 =item Perl on the Net: FTP and WWW Access
393
394 =item What mailing lists are there for Perl?
395
396 =item Archives of comp.lang.perl.misc
397
398 =item Where can I buy a commercial version of Perl?
399
400 =item Where do I send bug reports?
401
402 =item What is perl.com? Perl Mongers? pm.org? perl.org?
403
404 =back
405
406 =item AUTHOR AND COPYRIGHT
407
408 =back
409
410 =head2 perlfaq3 - Programming Tools ($Revision: 1.38 $, $Date: 1999/05/23
411 16:08:30 $)
412
413 =over
414
415 =item DESCRIPTION
416
417 =over
418
419 =item How do I do (anything)?
420
421 =item How can I use Perl interactively?
422
423 =item Is there a Perl shell?
424
425 =item How do I debug my Perl programs?
426
427 =item How do I profile my Perl programs?
428
429 =item How do I cross-reference my Perl programs?
430
431 =item Is there a pretty-printer (formatter) for Perl?
432
433 =item Is there a ctags for Perl?
434
435 =item Is there an IDE or Windows Perl Editor?
436
437 =item Where can I get Perl macros for vi?
438
439 =item Where can I get perl-mode for emacs?
440
441 =item How can I use curses with Perl?
442
443 =item How can I use X or Tk with Perl?
444
445 =item How can I generate simple menus without using CGI or Tk?
446
447 =item What is undump?
448
449 =item How can I make my Perl program run faster?
450
451 =item How can I make my Perl program take less memory?
452
453 =item Is it unsafe to return a pointer to local data?
454
455 =item How can I free an array or hash so my program shrinks?
456
457 =item How can I make my CGI script more efficient?
458
459 =item How can I hide the source for my Perl program?
460
461 =item How can I compile my Perl program into byte code or C?
462
463 =item How can I compile Perl into Java?
464
465 =item How can I get C<#!perl> to work on [MS-DOS,NT,...]?
466
467 =item Can I write useful Perl programs on the command line?
468
469 =item Why don't Perl one-liners work on my DOS/Mac/VMS system?
470
471 =item Where can I learn about CGI or Web programming in Perl?
472
473 =item Where can I learn about object-oriented Perl programming?
474
475 =item Where can I learn about linking C with Perl? [h2xs, xsubpp]
476
477 =item I've read perlembed, perlguts, etc., but I can't embed perl in
478 my C program, what am I doing wrong?
479
480 =item When I tried to run my script, I got this message. What does it
481 mean?
482
483 =item What's MakeMaker?
484
485 =back
486
487 =item AUTHOR AND COPYRIGHT
488
489 =back
490
491 =head2 perlfaq4 - Data Manipulation ($Revision: 1.49 $, $Date: 1999/05/23
492 20:37:49 $)
493
494 =over
495
496 =item DESCRIPTION
497
498 =item Data: Numbers
499
500 =over
501
502 =item Why am I getting long decimals (eg, 19.9499999999999) instead of the
503 numbers I should be getting (eg, 19.95)?
504
505 =item Why isn't my octal data interpreted correctly?
506
507 =item Does Perl have a round() function?  What about ceil() and floor()? 
508 Trig functions?
509
510 =item How do I convert bits into ints?
511
512 =item Why doesn't & work the way I want it to?
513
514 =item How do I multiply matrices?
515
516 =item How do I perform an operation on a series of integers?
517
518 =item How can I output Roman numerals?
519
520 =item Why aren't my random numbers random?
521
522 =back
523
524 =item Data: Dates
525
526 =over
527
528 =item How do I find the week-of-the-year/day-of-the-year?
529
530 =item How do I find the current century or millennium?
531
532 =item How can I compare two dates and find the difference?
533
534 =item How can I take a string and turn it into epoch seconds?
535
536 =item How can I find the Julian Day?
537
538 =item How do I find yesterday's date?
539
540 =item Does Perl have a Year 2000 problem?  Is Perl Y2K compliant?
541
542 =back
543
544 =item Data: Strings
545
546 =over
547
548 =item How do I validate input?
549
550 =item How do I unescape a string?
551
552 =item How do I remove consecutive pairs of characters?
553
554 =item How do I expand function calls in a string?
555
556 =item How do I find matching/nesting anything?
557
558 =item How do I reverse a string?
559
560 =item How do I expand tabs in a string?
561
562 =item How do I reformat a paragraph?
563
564 =item How can I access/change the first N letters of a string?
565
566 =item How do I change the Nth occurrence of something?
567
568 =item How can I count the number of occurrences of a substring within a
569 string?
570
571 =item How do I capitalize all the words on one line?
572
573 =item How can I split a [character] delimited string except when inside
574 [character]? (Comma-separated files)
575
576 =item How do I strip blank space from the beginning/end of a string?
577
578 =item How do I pad a string with blanks or pad a number with zeroes?
579
580 =item How do I extract selected columns from a string?
581
582 =item How do I find the soundex value of a string?
583
584 =item How can I expand variables in text strings?
585
586 =item What's wrong with always quoting "$vars"?
587
588 =item Why don't my E<lt>E<lt>HERE documents work?
589
590 1. There must be no space after the << part, 2. There (probably) should be
591 a semicolon at the end, 3. You can't (easily) have any space in front of
592 the tag
593
594 =back
595
596 =item Data: Arrays
597
598 =over
599
600 =item What is the difference between a list and an array?
601
602 =item What is the difference between $array[1] and @array[1]?
603
604 =item How can I remove duplicate elements from a list or array?
605
606 a) If @in is sorted, and you want @out to be sorted:(this assumes all true
607 values in the array), b) If you don't know whether @in is sorted:, c) Like
608 (b), but @in contains only small integers:, d) A way to do (b) without any
609 loops or greps:, e) Like (d), but @in contains only small positive
610 integers:
611
612 =item How can I tell whether a list or array contains a certain element?
613
614 =item How do I compute the difference of two arrays?  How do I compute the
615 intersection of two arrays?
616
617 =item How do I test whether two arrays or hashes are equal?
618
619 =item How do I find the first array element for which a condition is true?
620
621 =item How do I handle linked lists?
622
623 =item How do I handle circular lists?
624
625 =item How do I shuffle an array randomly?
626
627 =item How do I process/modify each element of an array?
628
629 =item How do I select a random element from an array?
630
631 =item How do I permute N elements of a list?
632
633 =item How do I sort an array by (anything)?
634
635 =item How do I manipulate arrays of bits?
636
637 =item Why does defined() return true on empty arrays and hashes?
638
639 =back
640
641 =item Data: Hashes (Associative Arrays)
642
643 =over
644
645 =item How do I process an entire hash?
646
647 =item What happens if I add or remove keys from a hash while iterating over
648 it?
649
650 =item How do I look up a hash element by value?
651
652 =item How can I know how many entries are in a hash?
653
654 =item How do I sort a hash (optionally by value instead of key)?
655
656 =item How can I always keep my hash sorted?
657
658 =item What's the difference between "delete" and "undef" with hashes?
659
660 =item Why don't my tied hashes make the defined/exists distinction?
661
662 =item How do I reset an each() operation part-way through?
663
664 =item How can I get the unique keys from two hashes?
665
666 =item How can I store a multidimensional array in a DBM file?
667
668 =item How can I make my hash remember the order I put elements into it?
669
670 =item Why does passing a subroutine an undefined element in a hash create
671 it?
672
673 =item How can I make the Perl equivalent of a C structure/C++ class/hash or
674 array of hashes or arrays?
675
676 =item How can I use a reference as a hash key?
677
678 =back
679
680 =item Data: Misc
681
682 =over
683
684 =item How do I handle binary data correctly?
685
686 =item How do I determine whether a scalar is a number/whole/integer/float?
687
688 =item How do I keep persistent data across program calls?
689
690 =item How do I print out or copy a recursive data structure?
691
692 =item How do I define methods for every class/object?
693
694 =item How do I verify a credit card checksum?
695
696 =item How do I pack arrays of doubles or floats for XS code?
697
698 =back
699
700 =item AUTHOR AND COPYRIGHT
701
702 =back
703
704 =head2 perlfaq5 - Files and Formats ($Revision: 1.38 $, $Date: 1999/05/23
705 16:08:30 $)
706
707 =over
708
709 =item DESCRIPTION
710
711 =over
712
713 =item How do I flush/unbuffer an output filehandle?  Why must I do this?
714
715 =item How do I change one line in a file/delete a line in a file/insert a
716 line in the middle of a file/append to the beginning of a file?
717
718 =item How do I count the number of lines in a file?
719
720 =item How do I make a temporary file name?
721
722 =item How can I manipulate fixed-record-length files?
723
724 =item How can I make a filehandle local to a subroutine?  How do I pass
725 filehandles between subroutines?  How do I make an array of filehandles?
726
727 =item How can I use a filehandle indirectly?
728
729 =item How can I set up a footer format to be used with write()?
730
731 =item How can I write() into a string?
732
733 =item How can I output my numbers with commas added?
734
735 =item How can I translate tildes (~) in a filename?
736
737 =item How come when I open a file read-write it wipes it out?
738
739 =item Why do I sometimes get an "Argument list too long" when I use
740 E<lt>*E<gt>?
741
742 =item Is there a leak/bug in glob()?
743
744 =item How can I open a file with a leading "E<gt>" or trailing blanks?
745
746 =item How can I reliably rename a file?
747
748 =item How can I lock a file?
749
750 =item Why can't I just open(FH, ">file.lock")?
751
752 =item I still don't get locking.  I just want to increment the number in
753 the file.  How can I do this?
754
755 =item How do I randomly update a binary file?
756
757 =item How do I get a file's timestamp in perl?
758
759 =item How do I set a file's timestamp in perl?
760
761 =item How do I print to more than one file at once?
762
763 =item How can I read in an entire file all at once?
764
765 =item How can I read in a file by paragraphs?
766
767 =item How can I read a single character from a file?  From the keyboard?
768
769 =item How can I tell whether there's a character waiting on a filehandle?
770
771 =item How do I do a C<tail -f> in perl?
772
773 =item How do I dup() a filehandle in Perl?
774
775 =item How do I close a file descriptor by number?
776
777 =item Why can't I use "C:\temp\foo" in DOS paths?  What doesn't
778 `C:\temp\foo.exe` work?
779
780 =item Why doesn't glob("*.*") get all the files?
781
782 =item Why does Perl let me delete read-only files?  Why does C<-i> clobber
783 protected files?  Isn't this a bug in Perl?
784
785 =item How do I select a random line from a file?
786
787 =item Why do I get weird spaces when I print an array of lines?
788
789 =back
790
791 =item AUTHOR AND COPYRIGHT
792
793 =back
794
795 =head2 perlfaq6 - Regexes ($Revision: 1.27 $, $Date: 1999/05/23 16:08:30 $)
796
797 =over
798
799 =item DESCRIPTION
800
801 =over
802
803 =item How can I hope to use regular expressions without creating illegible
804 and unmaintainable code?
805
806 Comments Outside the Regex, Comments Inside the Regex, Different Delimiters
807
808 =item I'm having trouble matching over more than one line.  What's wrong?
809
810 =item How can I pull out lines between two patterns that are themselves on
811 different lines?
812
813 =item I put a regular expression into $/ but it didn't work. What's wrong?
814
815 =item How do I substitute case insensitively on the LHS, but preserving
816 case on the RHS?
817
818 =item How can I make C<\w> match national character sets?
819
820 =item How can I match a locale-smart version of C</[a-zA-Z]/>?
821
822 =item How can I quote a variable to use in a regex?
823
824 =item What is C</o> really for?
825
826 =item How do I use a regular expression to strip C style comments from a
827 file?
828
829 =item Can I use Perl regular expressions to match balanced text?
830
831 =item What does it mean that regexes are greedy?  How can I get around it?
832
833 =item  How do I process each word on each line?
834
835 =item How can I print out a word-frequency or line-frequency summary?
836
837 =item How can I do approximate matching?
838
839 =item How do I efficiently match many regular expressions at once?
840
841 =item Why don't word-boundary searches with C<\b> work for me?
842
843 =item Why does using $&, $`, or $' slow my program down?
844
845 =item What good is C<\G> in a regular expression?
846
847 =item Are Perl regexes DFAs or NFAs?  Are they POSIX compliant?
848
849 =item What's wrong with using grep or map in a void context?
850
851 =item How can I match strings with multibyte characters?
852
853 =item How do I match a pattern that is supplied by the user?
854
855 =back
856
857 =item AUTHOR AND COPYRIGHT
858
859 =back
860
861 =head2 perlfaq7 - Perl Language Issues ($Revision: 1.28 $, $Date:
862 1999/05/23 20:36:18 $)
863
864 =over
865
866 =item DESCRIPTION
867
868 =over
869
870 =item Can I get a BNF/yacc/RE for the Perl language?
871
872 =item What are all these $@%&* punctuation signs, and how do I know when to
873 use them?
874
875 =item Do I always/never have to quote my strings or use semicolons and
876 commas?
877
878 =item How do I skip some return values?
879
880 =item How do I temporarily block warnings?
881
882 =item What's an extension?
883
884 =item Why do Perl operators have different precedence than C operators?
885
886 =item How do I declare/create a structure?
887
888 =item How do I create a module?
889
890 =item How do I create a class?
891
892 =item How can I tell if a variable is tainted?
893
894 =item What's a closure?
895
896 =item What is variable suicide and how can I prevent it?
897
898 =item How can I pass/return a {Function, FileHandle, Array, Hash, Method,
899 Regex}?
900
901 Passing Variables and Functions, Passing Filehandles, Passing Regexes,
902 Passing Methods
903
904 =item How do I create a static variable?
905
906 =item What's the difference between dynamic and lexical (static) scoping? 
907 Between local() and my()?
908
909 =item How can I access a dynamic variable while a similarly named lexical
910 is in scope?
911
912 =item What's the difference between deep and shallow binding?
913
914 =item Why doesn't "my($foo) = E<lt>FILEE<gt>;" work right?
915
916 =item How do I redefine a builtin function, operator, or method?
917
918 =item What's the difference between calling a function as &foo and foo()?
919
920 =item How do I create a switch or case statement?
921
922 =item How can I catch accesses to undefined variables/functions/methods?
923
924 =item Why can't a method included in this same file be found?
925
926 =item How can I find out my current package?
927
928 =item How can I comment out a large block of perl code?
929
930 =item How do I clear a package?
931
932 =item How can I use a variable as a variable name?
933
934 =back
935
936 =item AUTHOR AND COPYRIGHT
937
938 =back
939
940 =head2 perlfaq8 - System Interaction ($Revision: 1.39 $, $Date: 1999/05/23
941 18:37:57 $)
942
943 =over
944
945 =item DESCRIPTION
946
947 =over
948
949 =item How do I find out which operating system I'm running under?
950
951 =item How come exec() doesn't return?
952
953 =item How do I do fancy stuff with the keyboard/screen/mouse?
954
955 Keyboard, Screen, Mouse
956
957 =item How do I print something out in color?
958
959 =item How do I read just one key without waiting for a return key?
960
961 =item How do I check whether input is ready on the keyboard?
962
963 =item How do I clear the screen?
964
965 =item How do I get the screen size?
966
967 =item How do I ask the user for a password?
968
969 =item How do I read and write the serial port?
970
971 lockfiles, open mode, end of line, flushing output, non-blocking input
972
973 =item How do I decode encrypted password files?
974
975 =item How do I start a process in the background?
976
977 STDIN, STDOUT, and STDERR are shared, Signals, Zombies
978
979 =item How do I trap control characters/signals?
980
981 =item How do I modify the shadow password file on a Unix system?
982
983 =item How do I set the time and date?
984
985 =item How can I sleep() or alarm() for under a second?
986
987 =item How can I measure time under a second?
988
989 =item How can I do an atexit() or setjmp()/longjmp()? (Exception handling)
990
991 =item Why doesn't my sockets program work under System V (Solaris)? What
992 does the error message "Protocol not supported" mean?
993
994 =item How can I call my system's unique C functions from Perl?
995
996 =item Where do I get the include files to do ioctl() or syscall()?
997
998 =item Why do setuid perl scripts complain about kernel problems?
999
1000 =item How can I open a pipe both to and from a command?
1001
1002 =item Why can't I get the output of a command with system()?
1003
1004 =item How can I capture STDERR from an external command?
1005
1006 =item Why doesn't open() return an error when a pipe open fails?
1007
1008 =item What's wrong with using backticks in a void context?
1009
1010 =item How can I call backticks without shell processing?
1011
1012 =item Why can't my script read from STDIN after I gave it EOF (^D on Unix,
1013 ^Z on MS-DOS)?
1014
1015 =item How can I convert my shell script to perl?
1016
1017 =item Can I use perl to run a telnet or ftp session?
1018
1019 =item How can I write expect in Perl?
1020
1021 =item Is there a way to hide perl's command line from programs such as
1022 "ps"?
1023
1024 =item I {changed directory, modified my environment} in a perl script.  How
1025 come the change disappeared when I exited the script?  How do I get my
1026 changes to be visible?
1027
1028 Unix
1029
1030 =item How do I close a process's filehandle without waiting for it to
1031 complete?
1032
1033 =item How do I fork a daemon process?
1034
1035 =item How do I make my program run with sh and csh?
1036
1037 =item How do I find out if I'm running interactively or not?
1038
1039 =item How do I timeout a slow event?
1040
1041 =item How do I set CPU limits?
1042
1043 =item How do I avoid zombies on a Unix system?
1044
1045 =item How do I use an SQL database?
1046
1047 =item How do I make a system() exit on control-C?
1048
1049 =item How do I open a file without blocking?
1050
1051 =item How do I install a module from CPAN?
1052
1053 =item What's the difference between require and use?
1054
1055 =item How do I keep my own module/library directory?
1056
1057 =item How do I add the directory my program lives in to the module/library
1058 search path?
1059
1060 =item How do I add a directory to my include path at runtime?
1061
1062 =item What is socket.ph and where do I get it?
1063
1064 =back
1065
1066 =item AUTHOR AND COPYRIGHT
1067
1068 =back
1069
1070 =head2 perlfaq9 - Networking ($Revision: 1.26 $, $Date: 1999/05/23 16:08:30
1071 $)
1072
1073 =over
1074
1075 =item DESCRIPTION
1076
1077 =over
1078
1079 =item My CGI script runs from the command line but not the browser.   (500
1080 Server Error)
1081
1082 =item How can I get better error messages from a CGI program?
1083
1084 =item How do I remove HTML from a string?
1085
1086 =item How do I extract URLs?
1087
1088 =item How do I download a file from the user's machine?  How do I open a
1089 file on another machine?
1090
1091 =item How do I make a pop-up menu in HTML?
1092
1093 =item How do I fetch an HTML file?
1094
1095 =item How do I automate an HTML form submission?
1096
1097 =item How do I decode or create those %-encodings on the web?
1098
1099 =item How do I redirect to another page?
1100
1101 =item How do I put a password on my web pages?
1102
1103 =item How do I edit my .htpasswd and .htgroup files with Perl?
1104
1105 =item How do I make sure users can't enter values into a form that cause my
1106 CGI script to do bad things?
1107
1108 =item How do I parse a mail header?
1109
1110 =item How do I decode a CGI form?
1111
1112 =item How do I check a valid mail address?
1113
1114 =item How do I decode a MIME/BASE64 string?
1115
1116 =item How do I return the user's mail address?
1117
1118 =item How do I send mail?
1119
1120 =item How do I read mail?
1121
1122 =item How do I find out my hostname/domainname/IP address?
1123
1124 =item How do I fetch a news article or the active newsgroups?
1125
1126 =item How do I fetch/put an FTP file?
1127
1128 =item How can I do RPC in Perl?
1129
1130 =back
1131
1132 =item AUTHOR AND COPYRIGHT
1133
1134 =back
1135
1136 =head2 perldelta - what's new for perl v5.6 (as of v5.005_64)
1137
1138 =over
1139
1140 =item DESCRIPTION
1141
1142 =item Incompatible Changes
1143
1144 =over
1145
1146 =item Perl Source Incompatibilities
1147
1148 CHECK is a new keyword, Treatment of list slices of undef has changed,
1149 Possibly changed pseudo-random number generator, Hashing function for hash
1150 keys has changed, C<undef> fails on read only values, Close-on-exec bit may
1151 be set on pipe() handles, Writing C<"$$1"> to mean C<"${$}1"> is
1152 unsupported, delete(), values() and C<\(%h)> operate on aliases to values,
1153 not copies, vec(EXPR,OFFSET,BITS) enforces powers-of-two BITS, Text of some
1154 diagnostic output has changed, C<%@> has been removed, Parenthesized not()
1155 behaves like a list operator, Semantics of bareword prototype C<(*)> have
1156 changed
1157
1158 =item C Source Incompatibilities
1159
1160 C<PERL_POLLUTE>, C<PERL_IMPLICIT_CONTEXT>, C<PERL_POLLUTE_MALLOC>
1161
1162 =item Compatible C Source API Changes
1163
1164 C<PATCHLEVEL> is now C<PERL_VERSION>, Support for C++ exceptions
1165
1166 =item Binary Incompatibilities
1167
1168 =back
1169
1170 =item Installation and Configuration Improvements
1171
1172 =over
1173
1174 =item New Configure flags
1175
1176 =item -Dusethreads and -Duse64bits now more daring
1177
1178 =item Long Doubles
1179
1180 =item -Dusemorebits
1181
1182 =item -Duselargefiles
1183
1184 =item installusrbinperl
1185
1186 =item SOCKS support
1187
1188 =item C<-A> flag
1189
1190 =item Enhanced Installation Directories
1191
1192 =back
1193
1194 =item Core Changes
1195
1196 =over
1197
1198 =item Unicode and UTF-8 support
1199
1200 =item Interpreter threads
1201
1202 =item Lexically scoped warning categories
1203
1204 =item Lvalue subroutines
1205
1206 =item "our" declarations
1207
1208 =item Weak references
1209
1210 =item File globbing implemented internally
1211
1212 =item Binary numbers supported
1213
1214 =item Some arrows may be omitted in calls through references
1215
1216 =item exists() is supported on subroutine names
1217
1218 =item exists() and delete() are supported on array elements
1219
1220 =item syswrite() ease-of-use
1221
1222 =item File and directory handles can be autovivified
1223
1224 =item 64-bit support
1225
1226 =item Large file support
1227
1228 =item Long doubles
1229
1230 =item "more bits"
1231
1232 =item Enhanced support for sort() subroutines
1233
1234 =item Better syntax checks on parenthesized unary operators
1235
1236 =item POSIX character class syntax [: :] supported
1237
1238 =item Improved C<qw//> operator
1239
1240 =item pack() format 'Z' supported
1241
1242 =item pack() format modifier '!' supported
1243
1244 =item pack() and unpack() support counted strings
1245
1246 =item Comments in pack() templates
1247
1248 =item $^X variables may now have names longer than one character
1249
1250 =item C<use attrs> implicit in subroutine attributes
1251
1252 =item Regular expression improvements
1253
1254 =item Overloading improvements
1255
1256 =item open() with more than two arguments
1257
1258 =item Support for interpolating named characters
1259
1260 =item Experimental support for user-hooks in @INC
1261
1262 =item C<require> and C<do> may be overridden
1263
1264 =item New variable $^C reflects C<-c> switch
1265
1266 =item Optional Y2K warnings
1267
1268 =back
1269
1270 =item Significant bug fixes
1271
1272 =over
1273
1274 =item E<lt>HANDLEE<gt> on empty files
1275
1276 =item C<eval '...'> improvements
1277
1278 =item All compilation errors are true errors
1279
1280 =item Automatic flushing of output buffers
1281
1282 =item Better diagnostics on meaningless filehandle operations
1283
1284 =item Where possible, buffered data discarded from duped input filehandle
1285
1286 =item eof() has the same old magic as <>
1287
1288 =item system(), backticks and pipe open now reflect exec() failure
1289
1290 =item Implicitly closed filehandles are safer
1291
1292 =item C<(\$)> prototype and C<$foo{a}>
1293
1294 =item Pseudo-hashes work better
1295
1296 =item C<goto &sub> and AUTOLOAD
1297
1298 =item C<-bareword> allowed under C<use integer>
1299
1300 =item Boolean assignment operators are legal lvalues
1301
1302 =item C<sort $coderef @foo> allowed
1303
1304 =item Failures in DESTROY()
1305
1306 =item Locale bugs fixed
1307
1308 =item Memory leaks
1309
1310 =item Spurious subroutine stubs after failed subroutine calls
1311
1312 =item Consistent numeric conversions
1313
1314 =item Taint failures under C<-U>
1315
1316 =item END blocks and the C<-c> switch
1317
1318 =item Potential to leak DATA filehandles
1319
1320 =item Diagnostics follow STDERR
1321
1322 =item Other fixes for better diagnostics
1323
1324 =back
1325
1326 =item Performance enhancements
1327
1328 =over
1329
1330 =item Simple sort() using { $a <=> $b } and the like are optimized
1331
1332 =item Optimized assignments to lexical variables
1333
1334 =item Method lookups optimized
1335
1336 =item Faster mechanism to invoke XSUBs
1337
1338 =item Perl_malloc() improvements
1339
1340 =item Faster subroutine calls
1341
1342 =back
1343
1344 =item Platform specific changes
1345
1346 =over
1347
1348 =item Additional supported platforms
1349
1350 =item DOS
1351
1352 =item OS/2
1353
1354 =item VMS
1355
1356 =item Win32
1357
1358 =back
1359
1360 =item New tests
1361
1362 =item Modules and Pragmata
1363
1364 =over
1365
1366 =item Modules
1367
1368 attributes, B, ByteLoader, constant, charnames, Data::Dumper, DB, DB_File,
1369 Devel::DProf, Dumpvalue, Benchmark, Devel::Peek, ExtUtils::MakeMaker,
1370 Fcntl, File::Compare, File::Find, File::Glob, File::Spec,
1371 File::Spec::Functions, Getopt::Long, IO, JPL, lib, Math::BigInt,
1372 Math::Complex, Math::Trig, Pod::Parser, Pod::Text and Pod::Man, SDBM_File,
1373 Time::Local, Win32, DBM Filters
1374
1375 =item Pragmata
1376
1377 =back
1378
1379 =item Utility Changes
1380
1381 =over
1382
1383 =item h2ph
1384
1385 =item perlcc
1386
1387 =item h2xs
1388
1389 =back
1390
1391 =item Documentation Changes
1392
1393 perlapi.pod, perlcompile.pod, perlfilter.pod, perlhack.pod, perlintern.pod,
1394 perlopentut.pod, perlreftut.pod, perltootc.pod
1395
1396 =item New or Changed Diagnostics
1397
1398 "%s" variable %s masks earlier declaration in same %s, "my sub" not yet
1399 implemented, "our" variable %s redeclared, '!' allowed only after types %s,
1400 / cannot take a count, / must be followed by a, A or Z, / must be followed
1401 by a*, A* or Z*, / must follow a numeric type, /%s/: Unrecognized escape
1402 \\%c passed through, /%s/: Unrecognized escape \\%c in character class
1403 passed through, /%s/ should probably be written as "%s", %s() called too
1404 early to check prototype, %s argument is not a HASH or ARRAY element, %s
1405 argument is not a HASH or ARRAY element or slice, %s argument is not a
1406 subroutine name, %s package attribute may clash with future reserved word:
1407 %s,         (in cleanup) %s, <> should be quotes, Attempt to join self, Bad
1408 evalled substitution pattern, Bad realloc() ignored, Binary number >
1409 0b11111111111111111111111111111111 non-portable, Bit vector size > 32
1410 non-portable, Buffer overflow in prime_env_iter: %s, Can't check filesystem
1411 of script "%s", Can't declare class for non-scalar %s in "%s", Can't
1412 declare %s in "%s", Can't ignore signal CHLD, forcing to default, Can't
1413 modify non-lvalue subroutine call, Can't read CRTL environ, Can't remove
1414 %s: %s, skipping file, Can't return %s from lvalue subroutine, Can't weaken
1415 a nonreference, Character class [:%s:] unknown, Character class syntax [%s]
1416 belongs inside character classes, Constant is not %s reference,
1417 constant(%s): %%^H is not localized, constant(%s): %s, defined(@array) is
1418 deprecated, defined(%hash) is deprecated, Did not produce a valid header,
1419 Did you mean "local" instead of "our"?, Document contains no data, entering
1420 effective %s failed, false [] range "%s" in regexp, Filehandle %s opened
1421 only for output, flock() on closed filehandle %s, Global symbol "%s"
1422 requires explicit package name, Hexadecimal number > 0xffffffff
1423 non-portable, Ill-formed CRTL environ value "%s", Ill-formed message in
1424 prime_env_iter: |%s|, Illegal binary digit %s, Illegal binary digit %s
1425 ignored, Illegal number of bits in vec, Integer overflow in %s number,
1426 Invalid %s attribute: %s, Invalid %s attributes: %s, invalid [] range "%s"
1427 in regexp, Invalid separator character %s in attribute list, Invalid
1428 separator character %s in subroutine attribute list, leaving effective %s
1429 failed, Lvalue subs returning %s not implemented yet, Method %s not
1430 permitted, Missing %sbrace%s on \N{}, Missing command in piped open,
1431 Missing name in "my sub", No %s specified for -%c, No package name allowed
1432 for variable %s in "our", No space allowed after -%c, no UTC offset
1433 information; assuming local time is UTC, Octal number > 037777777777
1434 non-portable, panic: del_backref, panic: kid popen errno read, panic:
1435 magic_killbackrefs, Parentheses missing around "%s" list, Possible Y2K bug:
1436 %s, Premature end of script headers, Repeat count in pack overflows, Repeat
1437 count in unpack overflows, realloc() of freed memory ignored, Reference is
1438 already weak, setpgrp can't take arguments, Strange *+?{} on zero-length
1439 expression, switching effective %s is not implemented, This Perl can't
1440 reset CRTL environ elements (%s), This Perl can't set CRTL environ elements
1441 (%s=%s), Unknown open() mode '%s', Unknown process %x sent message to
1442 prime_env_iter: %s, Unrecognized escape \\%c passed through, Unterminated
1443 attribute parameter in attribute list, Unterminated attribute list,
1444 Unterminated attribute parameter in subroutine attribute list, Unterminated
1445 subroutine attribute list, Value of CLI symbol "%s" too long, Version
1446 number must be a constant number
1447
1448 =item Obsolete Diagnostics
1449
1450 Character class syntax [: :] is reserved for future extensions, Ill-formed
1451 logical name |%s| in prime_env_iter, regexp too big, Use of "$$<digit>" to
1452 mean "${$}<digit>" is deprecated
1453
1454 =item BUGS
1455
1456 =item SEE ALSO
1457
1458 =item HISTORY
1459
1460 =back
1461
1462 =head2 perldata - Perl data types
1463
1464 =over
1465
1466 =item DESCRIPTION
1467
1468 =over
1469
1470 =item Variable names
1471
1472 =item Context
1473
1474 =item Scalar values
1475
1476 =item Scalar value constructors
1477
1478 =item List value constructors
1479
1480 =item Slices
1481
1482 =item Typeglobs and Filehandles
1483
1484 =back
1485
1486 =item SEE ALSO
1487
1488 =back
1489
1490 =head2 perlsyn - Perl syntax
1491
1492 =over
1493
1494 =item DESCRIPTION
1495
1496 =over
1497
1498 =item Declarations
1499
1500 =item Simple statements
1501
1502 =item Compound statements
1503
1504 =item Loop Control
1505
1506 =item For Loops
1507
1508 =item Foreach Loops
1509
1510 =item Basic BLOCKs and Switch Statements
1511
1512 =item Goto
1513
1514 =item PODs: Embedded Documentation
1515
1516 =item Plain Old Comments (Not!)
1517
1518 =back
1519
1520 =back
1521
1522 =head2 perlop - Perl operators and precedence
1523
1524 =over
1525
1526 =item SYNOPSIS
1527
1528 =item DESCRIPTION
1529
1530 =over
1531
1532 =item Terms and List Operators (Leftward)
1533
1534 =item The Arrow Operator
1535
1536 =item Auto-increment and Auto-decrement
1537
1538 =item Exponentiation
1539
1540 =item Symbolic Unary Operators
1541
1542 =item Binding Operators
1543
1544 =item Multiplicative Operators
1545
1546 =item Additive Operators
1547
1548 =item Shift Operators
1549
1550 =item Named Unary Operators
1551
1552 =item Relational Operators
1553
1554 =item Equality Operators
1555
1556 =item Bitwise And
1557
1558 =item Bitwise Or and Exclusive Or
1559
1560 =item C-style Logical And
1561
1562 =item C-style Logical Or
1563
1564 =item Range Operators
1565
1566 =item Conditional Operator
1567
1568 =item Assignment Operators
1569
1570 =item Comma Operator
1571
1572 =item List Operators (Rightward)
1573
1574 =item Logical Not
1575
1576 =item Logical And
1577
1578 =item Logical or and Exclusive Or
1579
1580 =item C Operators Missing From Perl
1581
1582 unary &, unary *, (TYPE)
1583
1584 =item Quote and Quote-like Operators
1585
1586 =item Regexp Quote-Like Operators
1587
1588 ?PATTERN?, m/PATTERN/cgimosx, /PATTERN/cgimosx, q/STRING/, C<'STRING'>,
1589 qq/STRING/, "STRING", qr/STRING/imosx, qx/STRING/, `STRING`, qw/STRING/,
1590 s/PATTERN/REPLACEMENT/egimosx, tr/SEARCHLIST/REPLACEMENTLIST/cdsUC,
1591 y/SEARCHLIST/REPLACEMENTLIST/cdsUC
1592
1593 =item Gory details of parsing quoted constructs
1594
1595 Finding the end, Removal of backslashes before delimiters, Interpolation,
1596 C<<<'EOF'>, C<m''>, C<s'''>, C<tr///>, C<y///>, C<''>, C<q//>, C<"">,
1597 C<``>, C<qq//>, C<qx//>, C<<file*globE<gt>>, C<?RE?>, C</RE/>, C<m/RE/>,
1598 C<s/RE/foo/>,, Interpolation of regular expressions, Optimization of
1599 regular expressions
1600
1601 =item I/O Operators
1602
1603 =item Constant Folding
1604
1605 =item Bitwise String Operators
1606
1607 =item Integer Arithmetic
1608
1609 =item Floating-point Arithmetic
1610
1611 =item Bigger Numbers
1612
1613 =back
1614
1615 =back
1616
1617 =head2 perlre - Perl regular expressions
1618
1619 =over
1620
1621 =item DESCRIPTION
1622
1623 i, m, s, x
1624
1625 =over
1626
1627 =item Regular Expressions
1628
1629 cntrl, graph, print, punct, xdigit
1630
1631 =item Extended Patterns
1632
1633 C<(?#text)>, C<(?imsx-imsx)>, C<(?:pattern)>, C<(?imsx-imsx:pattern)>,
1634 C<(?=pattern)>, C<(?!pattern)>, C<(?E<lt>=pattern)>, C<(?<!pattern)>, C<(?{
1635 code })>, C<(?p{ code })>, C<(?E<gt>pattern)>,
1636 C<(?(condition)yes-pattern|no-pattern)>, C<(?(condition)yes-pattern)>
1637
1638 =item Backtracking
1639
1640 =item Version 8 Regular Expressions
1641
1642 =item Warning on \1 vs $1
1643
1644 =item Repeated patterns matching zero-length substring
1645
1646 =item Combining pieces together
1647
1648 C<ST>, C<S|T>, C<S{REPEAT_COUNT}>, C<S{min,max}>, C<S{min,max}?>, C<S?>,
1649 C<S*>, C<S+>, C<S??>, C<S*?>, C<S+?>, C<(?E<gt>S)>, C<(?=S)>, C<(?<=S)>,
1650 C<(?!S)>, C<(?<!S)>, C<(?p{ EXPR })>,
1651 C<(?(condition)yes-pattern|no-pattern)>
1652
1653 =item Creating custom RE engines
1654
1655 =back
1656
1657 =item BUGS
1658
1659 =item SEE ALSO
1660
1661 =back
1662
1663 =head2 perlrun - how to execute the Perl interpreter
1664
1665 =over
1666
1667 =item SYNOPSIS
1668
1669 =item DESCRIPTION
1670
1671 =over
1672
1673 =item #! and quoting on non-Unix systems
1674
1675 OS/2, MS-DOS, Win95/NT, Macintosh, VMS
1676
1677 =item Location of Perl
1678
1679 =item Command Switches
1680
1681 B<-0>[I<digits>], B<-a>, B<-c>, B<-d>, B<-d:>I<foo>, B<-D>I<letters>,
1682 B<-D>I<number>, B<-e> I<commandline>, B<-F>I<pattern>, B<-h>,
1683 B<-i>[I<extension>], B<-I>I<directory>, B<-l>[I<octnum>],
1684 B<-m>[B<->]I<module>, B<-M>[B<->]I<module>, B<-M>[B<->]I<'module ...'>,
1685 B<-[mM]>[B<->]I<module=arg[,arg]...>, B<-n>, B<-p>, B<-P>, B<-s>, B<-S>,
1686 B<-T>, B<-u>, B<-U>, B<-v>, B<-V>, B<-V:>I<name>, B<-w>, B<-W>, B<-X>,
1687 B<-x> I<directory>
1688
1689 =back
1690
1691 =item ENVIRONMENT
1692
1693 HOME, LOGDIR, PATH, PERL5LIB, PERL5OPT, PERLLIB, PERL5DB, PERL5SHELL
1694 (specific to the Win32 port), PERL_DEBUG_MSTATS, PERL_DESTRUCT_LEVEL
1695
1696 =back
1697
1698 =head2 perlfunc - Perl builtin functions
1699
1700 =over
1701
1702 =item DESCRIPTION
1703
1704 =over
1705
1706 =item Perl Functions by Category
1707
1708 Functions for SCALARs or strings, Regular expressions and pattern matching,
1709 Numeric functions, Functions for real @ARRAYs, Functions for list data,
1710 Functions for real %HASHes, Input and output functions, Functions for fixed
1711 length data or records, Functions for filehandles, files, or directories,
1712 Keywords related to the control flow of your perl program, Keywords related
1713 to scoping, Miscellaneous functions, Functions for processes and process
1714 groups, Keywords related to perl modules, Keywords related to classes and
1715 object-orientedness, Low-level socket functions, System V interprocess
1716 communication functions, Fetching user and group info, Fetching network
1717 info, Time-related functions, Functions new in perl5, Functions obsoleted
1718 in perl5
1719
1720 =item Portability
1721
1722 =item Alphabetical Listing of Perl Functions
1723
1724 I<-X> FILEHANDLE, I<-X> EXPR, I<-X>, abs VALUE, abs, accept
1725 NEWSOCKET,GENERICSOCKET, alarm SECONDS, alarm, atan2 Y,X, bind SOCKET,NAME,
1726 binmode FILEHANDLE, bless REF,CLASSNAME, bless REF, caller EXPR, caller,
1727 chdir EXPR, chmod LIST, chomp VARIABLE, chomp LIST, chomp, chop VARIABLE,
1728 chop LIST, chop, chown LIST, chr NUMBER, chr, chroot FILENAME, chroot,
1729 close FILEHANDLE, close, closedir DIRHANDLE, connect SOCKET,NAME, continue
1730 BLOCK, cos EXPR, crypt PLAINTEXT,SALT, dbmclose HASH, dbmopen
1731 HASH,DBNAME,MASK, defined EXPR, defined, delete EXPR, die LIST, do BLOCK,
1732 do SUBROUTINE(LIST), do EXPR, dump LABEL, dump, each HASH, eof FILEHANDLE,
1733 eof (), eof, eval EXPR, eval BLOCK, exec LIST, exec PROGRAM LIST, exists
1734 EXPR, exit EXPR, exp EXPR, exp, fcntl FILEHANDLE,FUNCTION,SCALAR, fileno
1735 FILEHANDLE, flock FILEHANDLE,OPERATION, fork, format, formline
1736 PICTURE,LIST, getc FILEHANDLE, getc, getlogin, getpeername SOCKET, getpgrp
1737 PID, getppid, getpriority WHICH,WHO, getpwnam NAME, getgrnam NAME,
1738 gethostbyname NAME, getnetbyname NAME, getprotobyname NAME, getpwuid UID,
1739 getgrgid GID, getservbyname NAME,PROTO, gethostbyaddr ADDR,ADDRTYPE,
1740 getnetbyaddr ADDR,ADDRTYPE, getprotobynumber NUMBER, getservbyport
1741 PORT,PROTO, getpwent, getgrent, gethostent, getnetent, getprotoent,
1742 getservent, setpwent, setgrent, sethostent STAYOPEN, setnetent STAYOPEN,
1743 setprotoent STAYOPEN, setservent STAYOPEN, endpwent, endgrent, endhostent,
1744 endnetent, endprotoent, endservent, getsockname SOCKET, getsockopt
1745 SOCKET,LEVEL,OPTNAME, glob EXPR, glob, gmtime EXPR, goto LABEL, goto EXPR,
1746 goto &NAME, grep BLOCK LIST, grep EXPR,LIST, hex EXPR, hex, import, index
1747 STR,SUBSTR,POSITION, index STR,SUBSTR, int EXPR, int, ioctl
1748 FILEHANDLE,FUNCTION,SCALAR, join EXPR,LIST, keys HASH, kill SIGNAL, LIST,
1749 last LABEL, last, lc EXPR, lc, lcfirst EXPR, lcfirst, length EXPR, length,
1750 link OLDFILE,NEWFILE, listen SOCKET,QUEUESIZE, local EXPR, localtime EXPR,
1751 lock, log EXPR, log, lstat FILEHANDLE, lstat EXPR, lstat, m//, map BLOCK
1752 LIST, map EXPR,LIST, mkdir FILENAME,MASK, msgctl ID,CMD,ARG, msgget
1753 KEY,FLAGS, msgsnd ID,MSG,FLAGS, msgrcv ID,VAR,SIZE,TYPE,FLAGS, my EXPR, my
1754 EXPR : ATTRIBUTES, next LABEL, next, no Module LIST, oct EXPR, oct, open
1755 FILEHANDLE,MODE,EXPR, open FILEHANDLE,EXPR, open FILEHANDLE, opendir
1756 DIRHANDLE,EXPR, ord EXPR, ord, our EXPR, pack TEMPLATE,LIST, package,
1757 package NAMESPACE, pipe READHANDLE,WRITEHANDLE, pop ARRAY, pop, pos SCALAR,
1758 pos, print FILEHANDLE LIST, print LIST, print, printf FILEHANDLE FORMAT,
1759 LIST, printf FORMAT, LIST, prototype FUNCTION, push ARRAY,LIST, q/STRING/,
1760 qq/STRING/, qr/STRING/, qx/STRING/, qw/STRING/, quotemeta EXPR, quotemeta,
1761 rand EXPR, rand, read FILEHANDLE,SCALAR,LENGTH,OFFSET, read
1762 FILEHANDLE,SCALAR,LENGTH, readdir DIRHANDLE, readline EXPR, readlink EXPR,
1763 readlink, readpipe EXPR, recv SOCKET,SCALAR,LENGTH,FLAGS, redo LABEL, redo,
1764 ref EXPR, ref, rename OLDNAME,NEWNAME, require EXPR, require, reset EXPR,
1765 reset, return EXPR, return, reverse LIST, rewinddir DIRHANDLE, rindex
1766 STR,SUBSTR,POSITION, rindex STR,SUBSTR, rmdir FILENAME, rmdir, s///, scalar
1767 EXPR, seek FILEHANDLE,POSITION,WHENCE, seekdir DIRHANDLE,POS, select
1768 FILEHANDLE, select, select RBITS,WBITS,EBITS,TIMEOUT, semctl
1769 ID,SEMNUM,CMD,ARG, semget KEY,NSEMS,FLAGS, semop KEY,OPSTRING, send
1770 SOCKET,MSG,FLAGS,TO, send SOCKET,MSG,FLAGS, setpgrp PID,PGRP, setpriority
1771 WHICH,WHO,PRIORITY, setsockopt SOCKET,LEVEL,OPTNAME,OPTVAL, shift ARRAY,
1772 shift, shmctl ID,CMD,ARG, shmget KEY,SIZE,FLAGS, shmread ID,VAR,POS,SIZE,
1773 shmwrite ID,STRING,POS,SIZE, shutdown SOCKET,HOW, sin EXPR, sin, sleep
1774 EXPR, sleep, socket SOCKET,DOMAIN,TYPE,PROTOCOL, socketpair
1775 SOCKET1,SOCKET2,DOMAIN,TYPE,PROTOCOL, sort SUBNAME LIST, sort BLOCK LIST,
1776 sort LIST, splice ARRAY,OFFSET,LENGTH,LIST, splice ARRAY,OFFSET,LENGTH,
1777 splice ARRAY,OFFSET, split /PATTERN/,EXPR,LIMIT, split /PATTERN/,EXPR,
1778 split /PATTERN/, split, sprintf FORMAT, LIST, sqrt EXPR, sqrt, srand EXPR,
1779 srand, stat FILEHANDLE, stat EXPR, stat, study SCALAR, study, sub BLOCK,
1780 sub NAME, sub NAME BLOCK, substr EXPR,OFFSET,LENGTH,REPLACEMENT, substr
1781 EXPR,OFFSET,LENGTH, substr EXPR,OFFSET, symlink OLDFILE,NEWFILE, syscall
1782 LIST, sysopen FILEHANDLE,FILENAME,MODE, sysopen
1783 FILEHANDLE,FILENAME,MODE,PERMS, sysread FILEHANDLE,SCALAR,LENGTH,OFFSET,
1784 sysread FILEHANDLE,SCALAR,LENGTH, sysseek FILEHANDLE,POSITION,WHENCE,
1785 system LIST, system PROGRAM LIST, syswrite FILEHANDLE,SCALAR,LENGTH,OFFSET,
1786 syswrite FILEHANDLE,SCALAR,LENGTH, syswrite FILEHANDLE,SCALAR, tell
1787 FILEHANDLE, tell, telldir DIRHANDLE, tie VARIABLE,CLASSNAME,LIST, tied
1788 VARIABLE, time, times, tr///, truncate FILEHANDLE,LENGTH, truncate
1789 EXPR,LENGTH, uc EXPR, uc, ucfirst EXPR, ucfirst, umask EXPR, umask, undef
1790 EXPR, undef, unlink LIST, unlink, unpack TEMPLATE,EXPR, untie VARIABLE,
1791 unshift ARRAY,LIST, use Module LIST, use Module, use Module VERSION LIST,
1792 use VERSION, utime LIST, values HASH, vec EXPR,OFFSET,BITS, wait, waitpid
1793 PID,FLAGS, wantarray, warn LIST, write FILEHANDLE, write EXPR, write, y///
1794
1795 =back
1796
1797 =back
1798
1799 =head2 perlvar - Perl predefined variables
1800
1801 =over
1802
1803 =item DESCRIPTION
1804
1805 =over
1806
1807 =item Predefined Names
1808
1809 $ARG, $_, $E<lt>I<digits>E<gt>, $MATCH, $&, $PREMATCH, $`, $POSTMATCH, $',
1810 $LAST_PAREN_MATCH, $+, @+, $MULTILINE_MATCHING, $*, input_line_number
1811 HANDLE EXPR, $INPUT_LINE_NUMBER, $NR, $, input_record_separator HANDLE
1812 EXPR, $INPUT_RECORD_SEPARATOR, $RS, $/, autoflush HANDLE EXPR,
1813 $OUTPUT_AUTOFLUSH, $|, output_field_separator HANDLE EXPR,
1814 $OUTPUT_FIELD_SEPARATOR, $OFS, $,, output_record_separator HANDLE EXPR,
1815 $OUTPUT_RECORD_SEPARATOR, $ORS, $\, $LIST_SEPARATOR, $",
1816 $SUBSCRIPT_SEPARATOR, $SUBSEP, $;, $OFMT, $#, format_page_number HANDLE
1817 EXPR, $FORMAT_PAGE_NUMBER, $%, format_lines_per_page HANDLE EXPR,
1818 $FORMAT_LINES_PER_PAGE, $=, format_lines_left HANDLE EXPR,
1819 $FORMAT_LINES_LEFT, $-, @-, format_name HANDLE EXPR, $FORMAT_NAME, $~,
1820 format_top_name HANDLE EXPR, $FORMAT_TOP_NAME, $^,
1821 format_line_break_characters HANDLE EXPR, $FORMAT_LINE_BREAK_CHARACTERS,
1822 $:, format_formfeed HANDLE EXPR, $FORMAT_FORMFEED, $^L, $ACCUMULATOR, $^A,
1823 $CHILD_ERROR, $?, $OS_ERROR, $ERRNO, $!, $EXTENDED_OS_ERROR, $^E,
1824 $EVAL_ERROR, $@, $PROCESS_ID, $PID, $$, $REAL_USER_ID, $UID, $<,
1825 $EFFECTIVE_USER_ID, $EUID, $>, $REAL_GROUP_ID, $GID, $(,
1826 $EFFECTIVE_GROUP_ID, $EGID, $), $PROGRAM_NAME, $0, $[, $PERL_VERSION, $],
1827 $COMPILING, $^C, $DEBUGGING, $^D, $SYSTEM_FD_MAX, $^F, $^H, %^H,
1828 $INPLACE_EDIT, $^I, $^M, $OSNAME, $^O, $PERLDB, $^P, 0x01, 0x02, 0x04,
1829 0x08, 0x10, 0x20, $^R, $^S, $BASETIME, $^T, $WARNING, $^W, ${^WARNING_BITS},
1830 $EXECUTABLE_NAME, $^X, $ARGV, @ARGV, @INC, @_, %INC, %ENV, $ENV{expr},
1831 %SIG, $SIG{expr}
1832
1833 =item Error Indicators
1834
1835 =item Technical Note on the Syntax of Variable Names
1836
1837 =back
1838
1839 =item BUGS
1840
1841 =back
1842
1843 =head2 perlsub - Perl subroutines
1844
1845 =over
1846
1847 =item SYNOPSIS
1848
1849 =item DESCRIPTION
1850
1851 =over
1852
1853 =item Private Variables via my()
1854
1855 =item Persistent Private Variables
1856
1857 =item Temporary Values via local()
1858
1859 =item Lvalue subroutines
1860
1861 =item Passing Symbol Table Entries (typeglobs)
1862
1863 =item When to Still Use local()
1864
1865 1. You need to give a global variable a temporary value, especially $_, 2.
1866 You need to create a local file or directory handle or a local function, 3.
1867 You want to temporarily change just one element of an array or hash
1868
1869 =item Pass by Reference
1870
1871 =item Prototypes
1872
1873 =item Constant Functions
1874
1875 =item Overriding Built-in Functions
1876
1877 =item Autoloading
1878
1879 =item Subroutine Attributes
1880
1881 =back
1882
1883 =item SEE ALSO
1884
1885 =back
1886
1887 =head2 perlmod - Perl modules (packages and symbol tables)
1888
1889 =over
1890
1891 =item DESCRIPTION
1892
1893 =over
1894
1895 =item Packages
1896
1897 =item Symbol Tables
1898
1899 =item Package Constructors and Destructors
1900
1901 =item Perl Classes
1902
1903 =item Perl Modules
1904
1905 =back
1906
1907 =item SEE ALSO
1908
1909 =back
1910
1911 =head2 perlmodlib - constructing new Perl modules and finding existing ones
1912
1913 =over
1914
1915 =item DESCRIPTION
1916
1917 =item THE PERL MODULE LIBRARY
1918
1919 =over
1920
1921 =item Pragmatic Modules
1922
1923 attributes, attrs, autouse, base, blib, caller, charnames, constant,
1924 diagnostics, fields, filetest, integer, less, lib, locale, ops, overload,
1925 re, sigtrap, strict, subs, utf8, vars, warnings
1926
1927 =item Standard Modules
1928
1929 AnyDBM_File, AutoLoader, AutoSplit, B, B::Asmdata, B::Assembler, B::Bblock,
1930 B::Bytecode, B::C, B::CC, B::Debug, B::Deparse, B::Disassembler, B::Lint,
1931 B::Showlex, B::Stackobj, B::Terse, B::Xref, Benchmark, ByteLoader, CGI,
1932 CGI::Apache, CGI::Carp, CGI::Cookie, CGI::Fast, CGI::Pretty, CGI::Push,
1933 CGI::Switch, CPAN, CPAN::FirstTime, CPAN::Nox, Carp, Carp::Heavy,
1934 Class::Struct, Config, Cwd, DB, DB_File, Data::Dumper, Devel::DProf,
1935 Devel::Peek, Devel::SelfStubber, DirHandle, Dumpvalue, DynaLoader, English,
1936 Env, Errno, Exporter, Exporter::Heavy, ExtUtils::Command, ExtUtils::Embed,
1937 ExtUtils::Install, ExtUtils::Installed, ExtUtils::Liblist,
1938 ExtUtils::MM_Cygwin, ExtUtils::MM_OS2, ExtUtils::MM_Unix, ExtUtils::MM_VMS,
1939 ExtUtils::MM_Win32, ExtUtils::MakeMaker, ExtUtils::Manifest,
1940 ExtUtils::Mkbootstrap, ExtUtils::Mksymlists, ExtUtils::Packlist,
1941 ExtUtils::testlib, Fatal, Fcntl, File::Basename, File::CheckTree,
1942 File::Compare, File::Copy, File::DosGlob, File::Find, File::Glob,
1943 File::Path, File::Spec, File::Spec::Functions, File::Spec::Mac,
1944 File::Spec::OS2, File::Spec::Unix, File::Spec::VMS, File::Spec::Win32,
1945 File::stat, FileCache, FileHandle, FindBin, GDBM_File, Getopt::Long,
1946 Getopt::Std, I18N::Collate, IO, IO::Dir, IO::File, IO::Handle, IO::Pipe,
1947 IO::Poll, IO::Seekable, IO::Select, IO::Socket, IO::Socket::INET,
1948 IO::Socket::UNIX, IPC::Msg, IPC::Open2, IPC::Open3, IPC::Semaphore,
1949 IPC::SysV, Math::BigFloat, Math::BigInt, Math::Complex, Math::Trig,
1950 Net::Ping, Net::hostent, Net::netent, Net::protoent, Net::servent, O,
1951 Opcode, POSIX, Pod::Checker, Pod::Html, Pod::InputObjects, Pod::Man,
1952 Pod::Parser, Pod::Select, Pod::Text, Pod::Text::Color, Pod::Usage,
1953 SDBM_File, Safe, Search::Dict, SelectSaver, SelfLoader, Shell, Socket,
1954 Symbol, Sys::Hostname, Sys::Syslog, Term::Cap, Term::Complete,
1955 Term::ReadLine, Test, Test::Harness, Text::Abbrev, Text::ParseWords,
1956 Text::Soundex, Text::Wrap, Tie::Array, Tie::Handle, Tie::Hash,
1957 Tie::RefHash, Tie::Scalar, Tie::SubstrHash, Time::Local, Time::gmtime,
1958 Time::localtime, Time::tm, UNIVERSAL, User::grent, User::pwent
1959
1960 =item Extension Modules
1961
1962 =back
1963
1964 =item CPAN
1965
1966 Language Extensions and Documentation Tools, Development Support, Operating
1967 System Interfaces, Networking, Device Control (modems) and InterProcess
1968 Communication, Data Types and Data Type Utilities, Database Interfaces,
1969 User Interfaces, Interfaces to / Emulations of Other Programming Languages,
1970 File Names, File Systems and File Locking (see also File Handles), String
1971 Processing, Language Text Processing, Parsing, and Searching, Option,
1972 Argument, Parameter, and Configuration File Processing,
1973 Internationalization and Locale, Authentication, Security, and Encryption,
1974 World Wide Web, HTML, HTTP, CGI, MIME, Server and Daemon Utilities,
1975 Archiving and Compression, Images, Pixmap and Bitmap Manipulation, Drawing,
1976 and Graphing, Mail and Usenet News, Control Flow Utilities (callbacks and
1977 exceptions etc), File Handle and Input/Output Stream Utilities,
1978 Miscellaneous Modules, Africa, Asia, Australasia, Central America, Europe,
1979 North America, South America
1980
1981 =item Modules: Creation, Use, and Abuse
1982
1983 =over
1984
1985 =item Guidelines for Module Creation
1986
1987 Do similar modules already exist in some form?, Try to design the new
1988 module to be easy to extend and reuse, Some simple style guidelines, Select
1989 what to export, Select a name for the module, Have you got it right?,
1990 README and other Additional Files, A description of the
1991 module/package/extension etc, A copyright notice - see below, Prerequisites
1992 - what else you may need to have, How to build it - possible changes to
1993 Makefile.PL etc, How to install it, Recent changes in this release,
1994 especially incompatibilities, Changes / enhancements you plan to make in
1995 the future, Adding a Copyright Notice, Give the module a
1996 version/issue/release number, How to release and distribute a module, Take
1997 care when changing a released module
1998
1999 =item Guidelines for Converting Perl 4 Library Scripts into Modules
2000
2001 There is no requirement to convert anything, Consider the implications,
2002 Make the most of the opportunity, The pl2pm utility will get you started,
2003 Adds the standard Module prologue lines, Converts package specifiers from '
2004 to ::, Converts die(...) to croak(...), Several other minor changes
2005
2006 =item Guidelines for Reusing Application Code
2007
2008 Complete applications rarely belong in the Perl Module Library, Many
2009 applications contain some Perl code that could be reused, Break-out the
2010 reusable code into one or more separate module files, Take the opportunity
2011 to reconsider and redesign the interfaces, In some cases the 'application'
2012 can then be reduced to a small
2013
2014 =back
2015
2016 =item NOTE
2017
2018 =back
2019
2020 =head2 perlmodinstall - Installing CPAN Modules
2021
2022 =over
2023
2024 =item DESCRIPTION
2025
2026 =over
2027
2028 =item PREAMBLE
2029
2030 B<DECOMPRESS> the file, B<UNPACK> the file into a directory, B<BUILD> the
2031 module (sometimes unnecessary), B<INSTALL> the module
2032
2033 =back
2034
2035 =item HEY
2036
2037 =item AUTHOR
2038
2039 =item COPYRIGHT
2040
2041 =back
2042
2043 =head2 perlfork - Perl's fork() emulation
2044
2045 =over
2046
2047 =item SYNOPSIS
2048
2049 =item DESCRIPTION
2050
2051 =over
2052
2053 =item Behavior of other Perl features in forked pseudo-processes
2054
2055 $$ or $PROCESS_ID, %ENV, chdir() and all other builtins that accept
2056 filenames, wait() and waitpid(), kill(), exec(), exit(), Open handles to
2057 files, directories and network sockets
2058
2059 =item Resource limits
2060
2061 =item Killing the parent process
2062
2063 =item Lifetime of the parent process and pseudo-processes
2064
2065 =item CAVEATS AND LIMITATIONS
2066
2067 BEGIN blocks, Open filehandles, Forking pipe open() not yet implemented,
2068 Global state maintained by XSUBs, Interpreter embedded in larger
2069 application, Thread-safety of extensions
2070
2071 =back
2072
2073 =item BUGS
2074
2075 =item AUTHOR
2076
2077 =item SEE ALSO
2078
2079 =back
2080
2081 =head2 perlform - Perl formats
2082
2083 =over
2084
2085 =item DESCRIPTION
2086
2087 =over
2088
2089 =item Format Variables
2090
2091 =back
2092
2093 =item NOTES
2094
2095 =over
2096
2097 =item Footers
2098
2099 =item Accessing Formatting Internals
2100
2101 =back
2102
2103 =item WARNINGS
2104
2105 =back
2106
2107 =head2 perllocale - Perl locale handling (internationalization and
2108 localization)
2109
2110 =over
2111
2112 =item DESCRIPTION
2113
2114 =item PREPARING TO USE LOCALES
2115
2116 =item USING LOCALES
2117
2118 =over
2119
2120 =item The use locale pragma
2121
2122 =item The setlocale function
2123
2124 =item Finding locales
2125
2126 =item LOCALE PROBLEMS
2127
2128 =item Temporarily fixing locale problems
2129
2130 =item Permanently fixing locale problems
2131
2132 =item Permanently fixing your locale configuration
2133
2134 =item Fixing system locale configuration
2135
2136 =item The localeconv function
2137
2138 =back
2139
2140 =item LOCALE CATEGORIES
2141
2142 =over
2143
2144 =item Category LC_COLLATE: Collation
2145
2146 =item Category LC_CTYPE: Character Types
2147
2148 =item Category LC_NUMERIC: Numeric Formatting
2149
2150 =item Category LC_MONETARY: Formatting of monetary amounts
2151
2152 =item LC_TIME
2153
2154 =item Other categories
2155
2156 =back
2157
2158 =item SECURITY
2159
2160 B<Comparison operators> (C<lt>, C<le>, C<ge>, C<gt> and C<cmp>):,
2161 B<Case-mapping interpolation> (with C<\l>, C<\L>, C<\u> or C<\U>),
2162 B<Matching operator> (C<m//>):, B<Substitution operator> (C<s///>):,
2163 B<Output formatting functions> (printf() and write()):, B<Case-mapping
2164 functions> (lc(), lcfirst(), uc(), ucfirst()):, B<POSIX locale-dependent
2165 functions> (localeconv(), strcoll(),strftime(), strxfrm()):, B<POSIX
2166 character class tests> (isalnum(), isalpha(), isdigit(),isgraph(),
2167 islower(), isprint(), ispunct(), isspace(), isupper(),
2168 isxdigit()):
2169
2170 =item ENVIRONMENT
2171
2172 PERL_BADLANG, LC_ALL, LANGUAGE, LC_CTYPE, LC_COLLATE, LC_MONETARY,
2173 LC_NUMERIC, LC_TIME, LANG
2174
2175 =item NOTES
2176
2177 =over
2178
2179 =item Backward compatibility
2180
2181 =item I18N:Collate obsolete
2182
2183 =item Sort speed and memory use impacts
2184
2185 =item write() and LC_NUMERIC
2186
2187 =item Freely available locale definitions
2188
2189 =item I18n and l10n
2190
2191 =item An imperfect standard
2192
2193 =back
2194
2195 =item BUGS
2196
2197 =over
2198
2199 =item Broken systems
2200
2201 =back
2202
2203 =item SEE ALSO
2204
2205 =item HISTORY
2206
2207 =back
2208
2209 =head2 perlref - Perl references and nested data structures
2210
2211 =over
2212
2213 =item NOTE
2214
2215 =item DESCRIPTION
2216
2217 =over
2218
2219 =item Making References
2220
2221 =item Using References
2222
2223 =item Symbolic references
2224
2225 =item Not-so-symbolic references
2226
2227 =item Pseudo-hashes: Using an array as a hash
2228
2229 =item Function Templates
2230
2231 =back
2232
2233 =item WARNING
2234
2235 =item SEE ALSO
2236
2237 =back
2238
2239 =head2 perlreftut - Mark's very short tutorial about references
2240
2241 =over
2242
2243 =item DESCRIPTION
2244
2245 =item Who Needs Complicated Data Structures?
2246
2247 =item The Solution
2248
2249 =item Syntax
2250
2251 =over
2252
2253 =item Making References
2254
2255 =item Using References
2256
2257 =back
2258
2259 =item An Example
2260
2261 =item Arrow Rule
2262
2263 =item Solution
2264
2265 =item The Rest
2266
2267 =item Summary
2268
2269 =item Credits
2270
2271 =over
2272
2273 =item Distribution Conditions
2274
2275 =back
2276
2277 =back
2278
2279 =head2 perldsc - Perl Data Structures Cookbook
2280
2281 =over
2282
2283 =item DESCRIPTION
2284
2285 arrays of arrays, hashes of arrays, arrays of hashes, hashes of hashes,
2286 more elaborate constructs
2287
2288 =item REFERENCES
2289
2290 =item COMMON MISTAKES
2291
2292 =item CAVEAT ON PRECEDENCE
2293
2294 =item WHY YOU SHOULD ALWAYS C<use strict>
2295
2296 =item DEBUGGING
2297
2298 =item CODE EXAMPLES
2299
2300 =item ARRAYS OF ARRAYS
2301
2302 =over
2303
2304 =item Declaration of a ARRAY OF ARRAYS
2305
2306 =item Generation of a ARRAY OF ARRAYS
2307
2308 =item Access and Printing of a ARRAY OF ARRAYS
2309
2310 =back
2311
2312 =item HASHES OF ARRAYS
2313
2314 =over
2315
2316 =item Declaration of a HASH OF ARRAYS
2317
2318 =item Generation of a HASH OF ARRAYS
2319
2320 =item Access and Printing of a HASH OF ARRAYS
2321
2322 =back
2323
2324 =item ARRAYS OF HASHES
2325
2326 =over
2327
2328 =item Declaration of a ARRAY OF HASHES
2329
2330 =item Generation of a ARRAY OF HASHES
2331
2332 =item Access and Printing of a ARRAY OF HASHES
2333
2334 =back
2335
2336 =item HASHES OF HASHES
2337
2338 =over
2339
2340 =item Declaration of a HASH OF HASHES
2341
2342 =item Generation of a HASH OF HASHES
2343
2344 =item Access and Printing of a HASH OF HASHES
2345
2346 =back
2347
2348 =item MORE ELABORATE RECORDS
2349
2350 =over
2351
2352 =item Declaration of MORE ELABORATE RECORDS
2353
2354 =item Declaration of a HASH OF COMPLEX RECORDS
2355
2356 =item Generation of a HASH OF COMPLEX RECORDS
2357
2358 =back
2359
2360 =item Database Ties
2361
2362 =item SEE ALSO
2363
2364 =item AUTHOR
2365
2366 =back
2367
2368 =head2 perllol - Manipulating Arrays of Arrays in Perl
2369
2370 =over
2371
2372 =item DESCRIPTION
2373
2374 =item Declaration and Access of Arrays of Arrays
2375
2376 =item Growing Your Own
2377
2378 =item Access and Printing
2379
2380 =item Slices
2381
2382 =item SEE ALSO
2383
2384 =item AUTHOR
2385
2386 =back
2387
2388 =head2 perltoot - Tom's object-oriented tutorial for perl
2389
2390 =over
2391
2392 =item DESCRIPTION
2393
2394 =item Creating a Class
2395
2396 =over
2397
2398 =item Object Representation
2399
2400 =item Class Interface
2401
2402 =item Constructors and Instance Methods
2403
2404 =item Planning for the Future: Better Constructors
2405
2406 =item Destructors
2407
2408 =item Other Object Methods
2409
2410 =back
2411
2412 =item Class Data
2413
2414 =over
2415
2416 =item Accessing Class Data
2417
2418 =item Debugging Methods
2419
2420 =item Class Destructors
2421
2422 =item Documenting the Interface
2423
2424 =back
2425
2426 =item Aggregation
2427
2428 =item Inheritance
2429
2430 =over
2431
2432 =item Overridden Methods
2433
2434 =item Multiple Inheritance
2435
2436 =item UNIVERSAL: The Root of All Objects
2437
2438 =back
2439
2440 =item Alternate Object Representations
2441
2442 =over
2443
2444 =item Arrays as Objects
2445
2446 =item Closures as Objects
2447
2448 =back
2449
2450 =item AUTOLOAD: Proxy Methods
2451
2452 =over
2453
2454 =item Autoloaded Data Methods
2455
2456 =item Inherited Autoloaded Data Methods
2457
2458 =back
2459
2460 =item Metaclassical Tools
2461
2462 =over
2463
2464 =item Class::Struct
2465
2466 =item Data Members as Variables
2467
2468 =item NOTES
2469
2470 =item Object Terminology
2471
2472 =back
2473
2474 =item SEE ALSO
2475
2476 =item AUTHOR AND COPYRIGHT
2477
2478 =item COPYRIGHT
2479
2480 =over
2481
2482 =item Acknowledgments
2483
2484 =back
2485
2486 =back
2487
2488 =head2 perltootc - Tom's OO Tutorial for Class Data in Perl
2489
2490 =over
2491
2492 =item DESCRIPTION
2493
2494 =item Class Data as Package Variables
2495
2496 =over
2497
2498 =item Putting All Your Eggs in One Basket
2499
2500 =item Inheritance Concerns
2501
2502 =item The Eponymous Meta-Object
2503
2504 =item Indirect References to Class Data
2505
2506 =item Monadic Classes
2507
2508 =item Translucent Attributes
2509
2510 =back
2511
2512 =item Class Data as Lexical Variables
2513
2514 =over
2515
2516 =item Privacy and Responsibility 
2517
2518 =item File-Scoped Lexicals
2519
2520 =item More Inheritance Concerns
2521
2522 =item Locking the Door and Throwing Away the Key
2523
2524 =item Translucency Revisited
2525
2526 =back
2527
2528 =item NOTES
2529
2530 =item SEE ALSO
2531
2532 =item AUTHOR AND COPYRIGHT
2533
2534 =item ACKNOWLEDGEMENTS
2535
2536 =item HISTORY
2537
2538 =back
2539
2540 =head2 perlobj - Perl objects
2541
2542 =over
2543
2544 =item DESCRIPTION
2545
2546 =over
2547
2548 =item An Object is Simply a Reference
2549
2550 =item A Class is Simply a Package
2551
2552 =item A Method is Simply a Subroutine
2553
2554 =item Method Invocation
2555
2556 =item WARNING
2557
2558 =item Default UNIVERSAL methods
2559
2560 isa(CLASS), can(METHOD), VERSION( [NEED] )
2561
2562 =item Destructors
2563
2564 =item Summary
2565
2566 =item Two-Phased Garbage Collection
2567
2568 =back
2569
2570 =item SEE ALSO
2571
2572 =back
2573
2574 =head2 perltie - how to hide an object class in a simple variable
2575
2576 =over
2577
2578 =item SYNOPSIS
2579
2580 =item DESCRIPTION
2581
2582 =over
2583
2584 =item Tying Scalars
2585
2586 TIESCALAR classname, LIST, FETCH this, STORE this, value, DESTROY this
2587
2588 =item Tying Arrays
2589
2590 TIEARRAY classname, LIST, FETCH this, index, STORE this, index, value,
2591 DESTROY this
2592
2593 =item Tying Hashes
2594
2595 USER, HOME, CLOBBER, LIST, TIEHASH classname, LIST, FETCH this, key, STORE
2596 this, key, value, DELETE this, key, CLEAR this, EXISTS this, key, FIRSTKEY
2597 this, NEXTKEY this, lastkey, DESTROY this
2598
2599 =item Tying FileHandles
2600
2601 TIEHANDLE classname, LIST, WRITE this, LIST, PRINT this, LIST, PRINTF this,
2602 LIST, READ this, LIST, READLINE this, GETC this, CLOSE this, DESTROY this
2603
2604 =item The C<untie> Gotcha
2605
2606 =back
2607
2608 =item SEE ALSO
2609
2610 =item BUGS
2611
2612 =item AUTHOR
2613
2614 =back
2615
2616 =head2 perlbot - Bag'o Object Tricks (the BOT)
2617
2618 =over
2619
2620 =item DESCRIPTION
2621
2622 =item OO SCALING TIPS
2623
2624 =item INSTANCE VARIABLES
2625
2626 =item SCALAR INSTANCE VARIABLES
2627
2628 =item INSTANCE VARIABLE INHERITANCE
2629
2630 =item OBJECT RELATIONSHIPS
2631
2632 =item OVERRIDING SUPERCLASS METHODS
2633
2634 =item USING RELATIONSHIP WITH SDBM
2635
2636 =item THINKING OF CODE REUSE
2637
2638 =item CLASS CONTEXT AND THE OBJECT
2639
2640 =item INHERITING A CONSTRUCTOR
2641
2642 =item DELEGATION
2643
2644 =back
2645
2646 =head2 perlipc - Perl interprocess communication (signals, fifos, pipes,
2647 safe subprocesses, sockets, and semaphores)
2648
2649 =over
2650
2651 =item DESCRIPTION
2652
2653 =item Signals
2654
2655 =item Named Pipes
2656
2657 =over
2658
2659 =item WARNING
2660
2661 =back
2662
2663 =item Using open() for IPC
2664
2665 =over
2666
2667 =item Filehandles
2668
2669 =item Background Processes
2670
2671 =item Complete Dissociation of Child from Parent
2672
2673 =item Safe Pipe Opens
2674
2675 =item Bidirectional Communication with Another Process
2676
2677 =item Bidirectional Communication with Yourself
2678
2679 =back
2680
2681 =item Sockets: Client/Server Communication
2682
2683 =over
2684
2685 =item Internet Line Terminators
2686
2687 =item Internet TCP Clients and Servers
2688
2689 =item Unix-Domain TCP Clients and Servers
2690
2691 =back
2692
2693 =item TCP Clients with IO::Socket
2694
2695 =over
2696
2697 =item A Simple Client
2698
2699 C<Proto>, C<PeerAddr>, C<PeerPort>
2700
2701 =item A Webget Client
2702
2703 =item Interactive Client with IO::Socket
2704
2705 =back
2706
2707 =item TCP Servers with IO::Socket
2708
2709 Proto, LocalPort, Listen, Reuse
2710
2711 =item UDP: Message Passing
2712
2713 =item SysV IPC
2714
2715 =item NOTES
2716
2717 =item BUGS
2718
2719 =item AUTHOR
2720
2721 =item SEE ALSO
2722
2723 =back
2724
2725 =head2 perldbmfilter - Perl DBM Filters
2726
2727 =over
2728
2729 =item SYNOPSIS
2730
2731 =item DESCRIPTION
2732
2733 B<filter_store_key>, B<filter_store_value>, B<filter_fetch_key>,
2734 B<filter_fetch_value>
2735
2736 =over
2737
2738 =item The Filter
2739
2740 =item An Example -- the NULL termination problem.
2741
2742 =item Another Example -- Key is a C int.
2743
2744 =back
2745
2746 =item SEE ALSO
2747
2748 =item AUTHOR
2749
2750 =back
2751
2752 =head2 perldebug - Perl debugging
2753
2754 =over
2755
2756 =item DESCRIPTION
2757
2758 =item The Perl Debugger
2759
2760 =over
2761
2762 =item Debugger Commands
2763
2764 h [command], p expr, x expr, V [pkg [vars]], X [vars], T, s [expr], n
2765 [expr], E<lt>CRE<gt>, c [line|sub], l, l min+incr, l min-max, l line, l
2766 subname, -, w [line], f filename, /pattern/, ?pattern?, L, S [[!]pattern],
2767 t, t expr, b [line] [condition], b subname [condition], b postpone subname
2768 [condition], b load filename, b compile subname, d [line], D, a [line]
2769 command, A, W [expr], W, O [opt[=val]] [opt"val"] [opt?]..,
2770 C<recallCommand>, C<ShellBang>, C<pager>, C<tkRunning>, C<signalLevel>,
2771 C<warnLevel>, C<dieLevel>, C<AutoTrace>, C<LineInfo>, C<inhibit_exit>,
2772 C<PrintRet>, C<ornaments>, C<frame>, C<maxTraceLen>, C<arrayDepth>,
2773 C<hashDepth>, C<compactDump>, C<veryCompact>, C<globPrint>, C<DumpDBFiles>,
2774 C<DumpPackages>, C<DumpReused>, C<quote>, C<HighBit>, C<undefPrint>,
2775 C<UsageOnly>, C<TTY>, C<noTTY>, C<ReadLine>, C<NonStop>, E<lt> [ command ],
2776 E<lt>E<lt> command, E<gt> command, E<gt>E<gt> command, { [ command ], {{
2777 command, ! number, ! -number, ! pattern, !! cmd, H -number, q or ^D, R,
2778 |dbcmd, ||dbcmd, command, m expr, m package
2779
2780 =item Debugger input/output
2781
2782 Prompt, Multiline commands, Stack backtrace, Listing, Frame listing
2783
2784 =item Debugging compile-time statements
2785
2786 =item Debugger Customization
2787
2788 =item Readline Support
2789
2790 =item Editor Support for Debugging
2791
2792 =item The Perl Profiler
2793
2794 =item Debugger support in perl
2795
2796 =item Debugger Internals
2797
2798 =item Other resources
2799
2800 =item BUGS
2801
2802 =back
2803
2804 =item Debugging Perl memory usage
2805
2806 =over
2807
2808 =item Using C<$ENV{PERL_DEBUG_MSTATS}>
2809
2810 C<buckets SMALLEST(APPROX)..GREATEST(APPROX)>, Free/Used, C<Total sbrk():
2811 SBRKed/SBRKs:CONTINUOUS>, C<pad: 0>, C<heads: 2192>, C<chain: 0>, C<tail:
2812 6144>
2813
2814 =item Example of using B<-DL> switch
2815
2816 C<717>, C<002>, C<054>, C<602>, C<702>, C<704>
2817
2818 =item B<-DL> details
2819
2820 C<!!!>, C<!!>, C<!>
2821
2822 =item Limitations of B<-DL> statistic
2823
2824 =back
2825
2826 =item Debugging regular expressions
2827
2828 =over
2829
2830 =item Compile-time output
2831
2832 C<anchored> I<STRING> C<at> I<POS>, C<floating> I<STRING> C<at>
2833 I<POS1..POS2>, C<matching floating/anchored>, C<minlen>, C<stclass>
2834 I<TYPE>, C<noscan>, C<isall>, C<GPOS>, C<plus>, C<implicit>, C<with eval>,
2835 C<anchored(TYPE)>
2836
2837 =item Types of nodes
2838
2839 =item Run-time output
2840
2841 =back
2842
2843 =back
2844
2845 =head2 perldiag - various Perl diagnostics
2846
2847 =over
2848
2849 =item DESCRIPTION
2850
2851 =back
2852
2853 =head2 perlsec - Perl security
2854
2855 =over
2856
2857 =item DESCRIPTION
2858
2859 =over
2860
2861 =item Laundering and Detecting Tainted Data
2862
2863 =item Switches On the "#!" Line
2864
2865 =item Cleaning Up Your Path
2866
2867 =item Security Bugs
2868
2869 =item Protecting Your Programs
2870
2871 =back
2872
2873 =item SEE ALSO
2874
2875 =back
2876
2877 =head2 perltrap - Perl traps for the unwary
2878
2879 =over
2880
2881 =item DESCRIPTION
2882
2883 =over
2884
2885 =item Awk Traps
2886
2887 =item C Traps
2888
2889 =item Sed Traps
2890
2891 =item Shell Traps
2892
2893 =item Perl Traps
2894
2895 =item Perl4 to Perl5 Traps
2896
2897 Discontinuance, Deprecation, and BugFix traps, Parsing Traps, Numerical
2898 Traps, General data type traps, Context Traps - scalar, list contexts,
2899 Precedence Traps, General Regular Expression Traps using s///, etc,
2900 Subroutine, Signal, Sorting Traps, OS Traps, DBM Traps, Unclassified Traps
2901
2902 =item Discontinuance, Deprecation, and BugFix traps
2903
2904 Discontinuance, Deprecation, BugFix, Discontinuance, Discontinuance,
2905 Discontinuance, BugFix, Discontinuance, Discontinuance, BugFix,
2906 Discontinuance, Deprecation, Discontinuance
2907
2908 =item Parsing Traps
2909
2910 Parsing, Parsing, Parsing, Parsing
2911
2912 =item Numerical Traps
2913
2914 Numerical, Numerical, Numerical, Bitwise string ops
2915
2916 =item General data type traps
2917
2918 (Arrays), (Arrays), (Hashes), (Globs), (Globs), (Scalar String),
2919 (Constants), (Scalars), (Variable Suicide)
2920
2921 =item Context Traps - scalar, list contexts
2922
2923 (list context), (scalar context), (scalar context), (list, builtin)
2924
2925 =item Precedence Traps
2926
2927 Precedence, Precedence, Precedence, Precedence, Precedence, Precedence,
2928 Precedence
2929
2930 =item General Regular Expression Traps using s///, etc.
2931
2932 Regular Expression, Regular Expression, Regular Expression, Regular
2933 Expression, Regular Expression, Regular Expression, Regular Expression,
2934 Regular Expression
2935
2936 =item Subroutine, Signal, Sorting Traps
2937
2938 (Signals), (Sort Subroutine), warn() won't let you specify a filehandle
2939
2940 =item OS Traps
2941
2942 (SysV), (SysV)
2943
2944 =item Interpolation Traps
2945
2946 Interpolation, Interpolation, Interpolation, Interpolation, Interpolation,
2947 Interpolation, Interpolation, Interpolation, Interpolation
2948
2949 =item DBM Traps
2950
2951 DBM, DBM
2952
2953 =item Unclassified Traps
2954
2955 C<require>/C<do> trap using returned value, C<split> on empty string with
2956 LIMIT specified
2957
2958 =back
2959
2960 =back
2961
2962 =head2 perlport - Writing portable Perl
2963
2964 =over
2965
2966 =item DESCRIPTION
2967
2968 Not all Perl programs have to be portable, Nearly all of Perl already I<is>
2969 portable
2970
2971 =item ISSUES
2972
2973 =over
2974
2975 =item Newlines
2976
2977 =item Numbers endianness and Width
2978
2979 =item Files and Filesystems
2980
2981 =item System Interaction
2982
2983 =item Interprocess Communication (IPC)
2984
2985 =item External Subroutines (XS)
2986
2987 =item Standard Modules
2988
2989 =item Time and Date
2990
2991 =item Character sets and character encoding
2992
2993 =item Internationalisation
2994
2995 =item System Resources
2996
2997 =item Security
2998
2999 =item Style
3000
3001 =back
3002
3003 =item CPAN Testers
3004
3005 Mailing list: cpan-testers@perl.org, Testing results:
3006 C<http://www.perl.org/cpan-testers/>
3007
3008 =item PLATFORMS
3009
3010 =over
3011
3012 =item Unix
3013
3014 =item DOS and Derivatives
3015
3016 The djgpp environment for DOS, C<http://www.delorie.com/djgpp/>, The EMX
3017 environment for DOS, OS/2, etc.
3018 C<emx@iaehv.nl>,C<http://www.leo.org/pub/comp/os/os2/leo/gnu/emx+gcc/index.
3019 html> or
3020 C<ftp://hobbes.nmsu.edu/pub/os2/dev/emx>, Build instructions for Win32,
3021 L<perlwin32>, The ActiveState Pages, C<http://www.activestate.com/>, The
3022 Cygwin environment for Win32;
3023 L<README.cygwin>,C<http://sourceware.cygnus.com/cygwin/>, The U/WIN
3024 environment for Win32,C<http://www.research.att.com/sw/tools/uwin/>
3025
3026 =item S<Mac OS>
3027
3028 The MacPerl Pages, C<http://www.macperl.com/>, The MacPerl mailing lists,
3029 C<http://www.macperl.org/>, MacPerl Module Porters,
3030 C<http://pudge.net/mmp/>
3031
3032 =item VMS
3033
3034 L<README.vms>, L<perlvms.pod>, vmsperl list, C<majordomo@perl.org>, vmsperl
3035 on the web, C<http://www.sidhe.org/vmsperl/index.html>
3036
3037 =item VOS
3038
3039 L<README.vos>, VOS mailing list, VOS Perl on the web at
3040 C<http://ftp.stratus.com/pub/vos/vos.html>
3041
3042 =item EBCDIC Platforms
3043
3044 L<README.os390>, L<README.posix-bc>, L<README.vmesa>, perl-mvs list, AS/400
3045 Perl information at C<http://as400.rochester.ibm.com/>as well as on CPAN in
3046 the F<ports/> directory
3047
3048 =item Acorn RISC OS
3049
3050 =item Other perls
3051
3052 Amiga, L<README.amiga>, Atari, L<README.mint> and Guido Flohr's web
3053 pageC<http://stud.uni-sb.de/~gufl0000/>, Be OS, L<README.beos>, HP 300
3054 MPE/iX, L<README.mpeix> and Mark Bixby's web
3055 pageC<http://www.cccd.edu/~markb/perlix.html>, Novell Netware, Plan 9,
3056 L<README.plan9>
3057
3058 =back
3059
3060 =item FUNCTION IMPLEMENTATIONS
3061
3062 =over
3063
3064 =item Alphabetical Listing of Perl Functions
3065
3066 -I<X> FILEHANDLE, -I<X> EXPR, -I<X>, binmode FILEHANDLE, chmod LIST, chown
3067 LIST, chroot FILENAME, chroot, crypt PLAINTEXT,SALT, dbmclose HASH, dbmopen
3068 HASH,DBNAME,MODE, dump LABEL, exec LIST, fcntl FILEHANDLE,FUNCTION,SCALAR,
3069 flock FILEHANDLE,OPERATION, fork, getlogin, getpgrp PID, getppid,
3070 getpriority WHICH,WHO, getpwnam NAME, getgrnam NAME, getnetbyname NAME,
3071 getpwuid UID, getgrgid GID, getnetbyaddr ADDR,ADDRTYPE, getprotobynumber
3072 NUMBER, getservbyport PORT,PROTO, getpwent, getgrent, gethostent,
3073 getnetent, getprotoent, getservent, setpwent, setgrent, sethostent
3074 STAYOPEN, setnetent STAYOPEN, setprotoent STAYOPEN, setservent STAYOPEN,
3075 endpwent, endgrent, endhostent, endnetent, endprotoent, endservent,
3076 getsockopt SOCKET,LEVEL,OPTNAME, glob EXPR, glob, ioctl
3077 FILEHANDLE,FUNCTION,SCALAR, kill SIGNAL, LIST, link OLDFILE,NEWFILE, lstat
3078 FILEHANDLE, lstat EXPR, lstat, msgctl ID,CMD,ARG, msgget KEY,FLAGS, msgsnd
3079 ID,MSG,FLAGS, msgrcv ID,VAR,SIZE,TYPE,FLAGS, open FILEHANDLE,EXPR, open
3080 FILEHANDLE, pipe READHANDLE,WRITEHANDLE, readlink EXPR, readlink, select
3081 RBITS,WBITS,EBITS,TIMEOUT, semctl ID,SEMNUM,CMD,ARG, semget
3082 KEY,NSEMS,FLAGS, semop KEY,OPSTRING, setpgrp PID,PGRP, setpriority
3083 WHICH,WHO,PRIORITY, setsockopt SOCKET,LEVEL,OPTNAME,OPTVAL, shmctl
3084 ID,CMD,ARG, shmget KEY,SIZE,FLAGS, shmread ID,VAR,POS,SIZE, shmwrite
3085 ID,STRING,POS,SIZE, socketpair SOCKET1,SOCKET2,DOMAIN,TYPE,PROTOCOL, stat
3086 FILEHANDLE, stat EXPR, stat, symlink OLDFILE,NEWFILE, syscall LIST, sysopen
3087 FILEHANDLE,FILENAME,MODE,PERMS, system LIST, times, truncate
3088 FILEHANDLE,LENGTH, truncate EXPR,LENGTH, umask EXPR, umask, utime LIST,
3089 wait, waitpid PID,FLAGS
3090
3091 =back
3092
3093 =item CHANGES
3094
3095 v1.45, 20 December 1999, v1.44, 19 July 1999, v1.43, 24 May 1999, v1.42, 22
3096 May 1999, v1.41, 19 May 1999, v1.40, 11 April 1999, v1.39, 11 February
3097 1999, v1.38, 31 December 1998, v1.37, 19 December 1998, v1.36, 9 September
3098 1998, v1.35, 13 August 1998, v1.33, 06 August 1998, v1.32, 05 August 1998,
3099 v1.30, 03 August 1998, v1.23, 10 July 1998
3100
3101 =item AUTHORS / CONTRIBUTORS
3102
3103 =item VERSION
3104
3105 =back
3106
3107 =head2 perlstyle - Perl style guide
3108
3109 =over
3110
3111 =item DESCRIPTION
3112
3113 =back
3114
3115 =head2 perlpod - plain old documentation
3116
3117 =over
3118
3119 =item DESCRIPTION
3120
3121 =over
3122
3123 =item Verbatim Paragraph
3124
3125 =item Command Paragraph
3126
3127 =item Ordinary Block of Text
3128
3129 =item The Intent
3130
3131 =item Embedding Pods in Perl Modules
3132
3133 =item Common Pod Pitfalls
3134
3135 =back
3136
3137 =item SEE ALSO
3138
3139 =item AUTHOR
3140
3141 =back
3142
3143 =head2 perlbook - Perl book information
3144
3145 =over
3146
3147 =item DESCRIPTION
3148
3149 =back
3150
3151 =head2 perlembed - how to embed perl in your C program
3152
3153 =over
3154
3155 =item DESCRIPTION
3156
3157 =over
3158
3159 =item PREAMBLE
3160
3161 B<Use C from Perl?>, B<Use a Unix program from Perl?>, B<Use Perl from
3162 Perl?>, B<Use C from C?>, B<Use Perl from C?>
3163
3164 =item ROADMAP
3165
3166 =item Compiling your C program
3167
3168 =item Adding a Perl interpreter to your C program
3169
3170 =item Calling a Perl subroutine from your C program
3171
3172 =item Evaluating a Perl statement from your C program
3173
3174 =item Performing Perl pattern matches and substitutions from your C program
3175
3176 =item Fiddling with the Perl stack from your C program
3177
3178 =item Maintaining a persistent interpreter
3179
3180 =item Maintaining multiple interpreter instances
3181
3182 =item Using Perl modules, which themselves use C libraries, from your C
3183 program
3184
3185 =back
3186
3187 =item Embedding Perl under Win32
3188
3189 =item MORAL
3190
3191 =item AUTHOR
3192
3193 =item COPYRIGHT
3194
3195 =back
3196
3197 =head2 perlapio - perl's IO abstraction interface.
3198
3199 =over
3200
3201 =item SYNOPSIS
3202
3203 =item DESCRIPTION
3204
3205 B<PerlIO *>, B<PerlIO_stdin()>, B<PerlIO_stdout()>, B<PerlIO_stderr()>,
3206 B<PerlIO_open(path, mode)>, B<PerlIO_fdopen(fd,mode)>,
3207 B<PerlIO_printf(f,fmt,...)>, B<PerlIO_vprintf(f,fmt,a)>,
3208 B<PerlIO_stdoutf(fmt,...)>, B<PerlIO_read(f,buf,count)>,
3209 B<PerlIO_write(f,buf,count)>, B<PerlIO_close(f)>, B<PerlIO_puts(f,s)>,
3210 B<PerlIO_putc(f,c)>, B<PerlIO_ungetc(f,c)>, B<PerlIO_getc(f)>,
3211 B<PerlIO_eof(f)>, B<PerlIO_error(f)>, B<PerlIO_fileno(f)>,
3212 B<PerlIO_clearerr(f)>, B<PerlIO_flush(f)>, B<PerlIO_tell(f)>,
3213 B<PerlIO_seek(f,o,w)>, B<PerlIO_getpos(f,p)>, B<PerlIO_setpos(f,p)>,
3214 B<PerlIO_rewind(f)>, B<PerlIO_tmpfile()>
3215
3216 =over
3217
3218 =item Co-existence with stdio
3219
3220 B<PerlIO_importFILE(f,flags)>, B<PerlIO_exportFILE(f,flags)>,
3221 B<PerlIO_findFILE(f)>, B<PerlIO_releaseFILE(p,f)>, B<PerlIO_setlinebuf(f)>,
3222 B<PerlIO_has_cntptr(f)>, B<PerlIO_get_ptr(f)>, B<PerlIO_get_cnt(f)>,
3223 B<PerlIO_canset_cnt(f)>, B<PerlIO_fast_gets(f)>,
3224 B<PerlIO_set_ptrcnt(f,p,c)>, B<PerlIO_set_cnt(f,c)>, B<PerlIO_has_base(f)>,
3225 B<PerlIO_get_base(f)>, B<PerlIO_get_bufsiz(f)>
3226
3227 =back
3228
3229 =back
3230
3231 =head2 perlxs - XS language reference manual
3232
3233 =over
3234
3235 =item DESCRIPTION
3236
3237 =over
3238
3239 =item Introduction
3240
3241 =item On The Road
3242
3243 =item The Anatomy of an XSUB
3244
3245 =item The Argument Stack
3246
3247 =item The RETVAL Variable
3248
3249 =item The MODULE Keyword
3250
3251 =item The PACKAGE Keyword
3252
3253 =item The PREFIX Keyword
3254
3255 =item The OUTPUT: Keyword
3256
3257 =item The CODE: Keyword
3258
3259 =item The INIT: Keyword
3260
3261 =item The NO_INIT Keyword
3262
3263 =item Initializing Function Parameters
3264
3265 =item Default Parameter Values
3266
3267 =item The PREINIT: Keyword
3268
3269 =item The SCOPE: Keyword
3270
3271 =item The INPUT: Keyword
3272
3273 =item Variable-length Parameter Lists
3274
3275 =item The C_ARGS: Keyword
3276
3277 =item The PPCODE: Keyword
3278
3279 =item Returning Undef And Empty Lists
3280
3281 =item The REQUIRE: Keyword
3282
3283 =item The CLEANUP: Keyword
3284
3285 =item The BOOT: Keyword
3286
3287 =item The VERSIONCHECK: Keyword
3288
3289 =item The PROTOTYPES: Keyword
3290
3291 =item The PROTOTYPE: Keyword
3292
3293 =item The ALIAS: Keyword
3294
3295 =item The INTERFACE: Keyword
3296
3297 =item The INTERFACE_MACRO: Keyword
3298
3299 =item The INCLUDE: Keyword
3300
3301 =item The CASE: Keyword
3302
3303 =item The & Unary Operator
3304
3305 =item Inserting Comments and C Preprocessor Directives
3306
3307 =item Using XS With C++
3308
3309 =item Interface Strategy
3310
3311 =item Perl Objects And C Structures
3312
3313 =item The Typemap
3314
3315 =back
3316
3317 =item EXAMPLES
3318
3319 =item XS VERSION
3320
3321 =item AUTHOR
3322
3323 =back
3324
3325 =head2 perlxstut, perlXStut - Tutorial for writing XSUBs
3326
3327 =over
3328
3329 =item DESCRIPTION
3330
3331 =item SPECIAL NOTES
3332
3333 =over
3334
3335 =item make
3336
3337 =item Version caveat
3338
3339 =item Dynamic Loading versus Static Loading
3340
3341 =back
3342
3343 =item TUTORIAL
3344
3345 =over
3346
3347 =item EXAMPLE 1
3348
3349 =item EXAMPLE 2
3350
3351 =item What has gone on?
3352
3353 =item Writing good test scripts
3354
3355 =item EXAMPLE 3
3356
3357 =item What's new here?
3358
3359 =item Input and Output Parameters
3360
3361 =item The XSUBPP Program
3362
3363 =item The TYPEMAP file
3364
3365 =item Warning about Output Arguments
3366
3367 =item EXAMPLE 4
3368
3369 =item What has happened here?
3370
3371 =item Anatomy of .xs file
3372
3373 =item Getting the fat out of XSUBs
3374
3375 =item More about XSUB arguments
3376
3377 =item The Argument Stack
3378
3379 =item Extending your Extension
3380
3381 =item Documenting your Extension
3382
3383 =item Installing your Extension
3384
3385 =item EXAMPLE 5
3386
3387 =item New Things in this Example
3388
3389 =item EXAMPLE 6 (Coming Soon)
3390
3391 =item EXAMPLE 7 (Coming Soon)
3392
3393 =item EXAMPLE 8 (Coming Soon)
3394
3395 =item EXAMPLE 9 (Coming Soon)
3396
3397 =item Troubleshooting these Examples
3398
3399 =back
3400
3401 =item See also
3402
3403 =item Author
3404
3405 =over
3406
3407 =item Last Changed
3408
3409 =back
3410
3411 =back
3412
3413 =head2 perlguts - Introduction to the Perl API
3414
3415 =over
3416
3417 =item DESCRIPTION
3418
3419 =item Variables
3420
3421 =over
3422
3423 =item Datatypes
3424
3425 =item What is an "IV"?
3426
3427 =item Working with SVs
3428
3429 =item What's Really Stored in an SV?
3430
3431 =item Working with AVs
3432
3433 =item Working with HVs
3434
3435 =item Hash API Extensions
3436
3437 =item References
3438
3439 =item Blessed References and Class Objects
3440
3441 =item Creating New Variables
3442
3443 =item Reference Counts and Mortality
3444
3445 =item Stashes and Globs
3446
3447 =item Double-Typed SVs
3448
3449 =item Magic Variables
3450
3451 =item Assigning Magic
3452
3453 =item Magic Virtual Tables
3454
3455 =item Finding Magic
3456
3457 =item Understanding the Magic of Tied Hashes and Arrays
3458
3459 =item Localizing changes
3460
3461 C<SAVEINT(int i)>, C<SAVEIV(IV i)>, C<SAVEI32(I32 i)>, C<SAVELONG(long i)>,
3462 C<SAVESPTR(s)>, C<SAVEPPTR(p)>, C<SAVEFREESV(SV *sv)>, C<SAVEFREEOP(OP
3463 *op)>, C<SAVEFREEPV(p)>, C<SAVECLEARSV(SV *sv)>, C<SAVEDELETE(HV *hv, char
3464 *key, I32 length)>, C<SAVEDESTRUCTOR(DESTRUCTORFUNC_NOCONTEXT_t f, void
3465 *p)>, C<SAVEDESTRUCTOR_X(DESTRUCTORFUNC_t f, void *p)>, C<SAVESTACK_POS()>,
3466 C<SV* save_scalar(GV *gv)>, C<AV* save_ary(GV *gv)>, C<HV* save_hash(GV
3467 *gv)>, C<void save_item(SV *item)>, C<void save_list(SV **sarg, I32
3468 maxsarg)>, C<SV* save_svref(SV **sptr)>, C<void save_aptr(AV **aptr)>,
3469 C<void save_hptr(HV **hptr)>
3470
3471 =back
3472
3473 =item Subroutines
3474
3475 =over
3476
3477 =item XSUBs and the Argument Stack
3478
3479 =item Calling Perl Routines from within C Programs
3480
3481 =item Memory Allocation
3482
3483 =item PerlIO
3484
3485 =item Putting a C value on Perl stack
3486
3487 =item Scratchpads
3488
3489 =item Scratchpads and recursion
3490
3491 =back
3492
3493 =item Compiled code
3494
3495 =over
3496
3497 =item Code tree
3498
3499 =item Examining the tree
3500
3501 =item Compile pass 1: check routines
3502
3503 =item Compile pass 1a: constant folding
3504
3505 =item Compile pass 2: context propagation
3506
3507 =item Compile pass 3: peephole optimization
3508
3509 =back
3510
3511 =item How multiple interpreters and concurrency are supported
3512
3513 =over
3514
3515 =item Background and PERL_IMPLICIT_CONTEXT
3516
3517 =item How do I use all this in extensions?
3518
3519 =item Future Plans and PERL_IMPLICIT_SYS
3520
3521 =back
3522
3523 =item AUTHORS
3524
3525 =item SEE ALSO
3526
3527 =back
3528
3529 =head2 perlcall - Perl calling conventions from C
3530
3531 =over
3532
3533 =item DESCRIPTION
3534
3535 An Error Handler, An Event Driven Program
3536
3537 =item THE PERL_CALL FUNCTIONS
3538
3539 perl_call_sv, perl_call_pv, perl_call_method, perl_call_argv
3540
3541 =item FLAG VALUES
3542
3543 =over
3544
3545 =item  G_VOID
3546
3547 =item  G_SCALAR
3548
3549 =item G_ARRAY
3550
3551 =item G_DISCARD
3552
3553 =item G_NOARGS
3554
3555 =item G_EVAL
3556
3557 =item G_KEEPERR
3558
3559 =item Determining the Context
3560
3561 =back
3562
3563 =item KNOWN PROBLEMS
3564
3565 =item EXAMPLES
3566
3567 =over
3568
3569 =item No Parameters, Nothing returned
3570
3571 =item Passing Parameters
3572
3573 =item Returning a Scalar
3574
3575 =item Returning a list of values
3576
3577 =item Returning a list in a scalar context
3578
3579 =item Returning Data from Perl via the parameter list
3580
3581 =item Using G_EVAL
3582
3583 =item Using G_KEEPERR
3584
3585 =item Using perl_call_sv
3586
3587 =item Using perl_call_argv
3588
3589 =item Using perl_call_method
3590
3591 =item Using GIMME_V
3592
3593 =item Using Perl to dispose of temporaries
3594
3595 =item Strategies for storing Callback Context Information
3596
3597 1. Ignore the problem - Allow only 1 callback, 2. Create a sequence of
3598 callbacks - hard wired limit, 3. Use a parameter to map to the Perl
3599 callback
3600
3601 =item Alternate Stack Manipulation
3602
3603 =item Creating and calling an anonymous subroutine in C
3604
3605 =back
3606
3607 =item SEE ALSO
3608
3609 =item AUTHOR
3610
3611 =item DATE
3612
3613 =back
3614
3615 =head2 perlcompile - Introduction to the Perl Compiler-Translator 
3616
3617 =over
3618
3619 =item DESCRIPTION
3620
3621 =over
3622
3623 =item Layout
3624
3625 B::Bytecode, B::C, B::CC, B::Lint, B::Deparse, B::Xref
3626
3627 =back
3628
3629 =item Using The Back Ends
3630
3631 =over
3632
3633 =item The Cross Referencing Back End (B::Xref)
3634
3635 i, &, s, r
3636
3637 =item The Decompiling Back End
3638
3639 =item The Lint Back End (B::Lint)
3640
3641 =item The Simple C Back End
3642
3643 =item The Bytecode Back End
3644
3645 =item The Optimized C Back End
3646
3647 B, O, B::Asmdata, B::Assembler, B::Bblock, B::Bytecode, B::C, B::CC,
3648 B::Debug, B::Deparse, B::Disassembler, B::Lint, B::Showlex, B::Stackobj,
3649 B::Stash, B::Terse, B::Xref
3650
3651 =back
3652
3653 =item KNOWN PROBLEMS
3654
3655 =item AUTHOR
3656
3657 =back
3658
3659 =head2 perlapi - autogenerated documentation for the perl public API
3660
3661 =over
3662
3663 =item DESCRIPTION
3664
3665 AvFILL, av_clear, av_extend, av_fetch, av_len, av_make, av_pop, av_push,
3666 av_shift, av_store, av_undef, av_unshift, call_argv, call_method, call_pv,
3667 call_sv, CLASS, Copy, croak, CvSTASH, dMARK, dORIGMARK, dSP, dXSARGS,
3668 dXSI32, ENTER, eval_pv, eval_sv, EXTEND, fbm_compile, fbm_instr, FREETMPS,
3669 get_av, get_cv, get_hv, get_sv, GIMME, GIMME_V, GvSV, gv_fetchmeth,
3670 gv_fetchmethod, gv_fetchmethod_autoload, gv_stashpv, gv_stashsv, G_ARRAY,
3671 G_DISCARD, G_EVAL, G_NOARGS, G_SCALAR, G_VOID, HEf_SVKEY, HeHASH, HeKEY,
3672 HeKLEN, HePV, HeSVKEY, HeSVKEY_force, HeSVKEY_set, HeVAL, HvNAME, hv_clear,
3673 hv_delete, hv_delete_ent, hv_exists, hv_exists_ent, hv_fetch, hv_fetch_ent,
3674 hv_iterinit, hv_iterkey, hv_iterkeysv, hv_iternext, hv_iternextsv,
3675 hv_iterval, hv_magic, hv_store, hv_store_ent, hv_undef, isALNUM, isALPHA,
3676 isDIGIT, isLOWER, isSPACE, isUPPER, items, ix, LEAVE, looks_like_number,
3677 MARK, mg_clear, mg_copy, mg_find, mg_free, mg_get, mg_length, mg_magical,
3678 mg_set, Move, New, newAV, Newc, newCONSTSUB, newHV, newRV_inc, newRV_noinc,
3679 NEWSV, newSViv, newSVnv, newSVpv, newSVpvf, newSVpvn, newSVrv, newSVsv,
3680 newXS, newXSproto, Newz, Nullav, Nullch, Nullcv, Nullhv, Nullsv, ORIGMARK,
3681 perl_alloc, perl_construct, perl_destruct, perl_free, perl_parse, perl_run,
3682 PL_DBsingle, PL_DBsub, PL_DBtrace, PL_dowarn, PL_modglobal, PL_na,
3683 PL_sv_no, PL_sv_undef, PL_sv_yes, POPi, POPl, POPn, POPp, POPs, PUSHi,
3684 PUSHMARK, PUSHn, PUSHp, PUSHs, PUSHu, PUTBACK, Renew, Renewc, require_pv,
3685 RETVAL, Safefree, savepv, savepvn, SAVETMPS, SP, SPAGAIN, ST, strEQ, strGE,
3686 strGT, strLE, strLT, strNE, strnEQ, strnNE, StructCopy, SvCUR, SvCUR_set,
3687 SvEND, SvGETMAGIC, SvGROW, SvIOK, SvIOKp, SvIOK_off, SvIOK_on, SvIOK_only,
3688 SvIV, SvIVX, SvLEN, SvNIOK, SvNIOKp, SvNIOK_off, SvNOK, SvNOKp, SvNOK_off,
3689 SvNOK_on, SvNOK_only, SvNV, SvNVX, SvOK, SvOOK, SvPOK, SvPOKp, SvPOK_off,
3690 SvPOK_on, SvPOK_only, SvPV, SvPVX, SvPV_force, SvPV_nolen, SvREFCNT,
3691 SvREFCNT_dec, SvREFCNT_inc, SvROK, SvROK_off, SvROK_on, SvRV, SvSETMAGIC,
3692 SvSetSV, SvSetSV_nosteal, SvSTASH, SvTAINT, SvTAINTED, SvTAINTED_off,
3693 SvTAINTED_on, SvTRUE, SvTYPE, svtype, SVt_IV, SVt_NV, SVt_PV, SVt_PVAV,
3694 SVt_PVCV, SVt_PVHV, SVt_PVMG, SvUPGRADE, SvUV, SvUVX, sv_2mortal, sv_bless,
3695 sv_catpv, sv_catpvf, sv_catpvf_mg, sv_catpvn, sv_catpvn_mg, sv_catpv_mg,
3696 sv_catsv, sv_catsv_mg, sv_chop, sv_cmp, sv_dec, sv_derived_from, sv_eq,
3697 sv_grow, sv_inc, sv_insert, sv_isa, sv_isobject, sv_len, sv_magic,
3698 sv_mortalcopy, sv_newmortal, sv_setiv, sv_setiv_mg, sv_setnv, sv_setnv_mg,
3699 sv_setpv, sv_setpvf, sv_setpvf_mg, sv_setpviv, sv_setpviv_mg, sv_setpvn,
3700 sv_setpvn_mg, sv_setpv_mg, sv_setref_iv, sv_setref_nv, sv_setref_pv,
3701 sv_setref_pvn, sv_setsv, sv_setsv_mg, sv_setuv, sv_setuv_mg, sv_unref,
3702 sv_upgrade, sv_usepvn, sv_usepvn_mg, sv_vcatpvfn, sv_vsetpvfn, THIS,
3703 toLOWER, toUPPER, warn, XPUSHi, XPUSHn, XPUSHp, XPUSHs, XPUSHu, XS,
3704 XSRETURN, XSRETURN_EMPTY, XSRETURN_IV, XSRETURN_NO, XSRETURN_NV,
3705 XSRETURN_PV, XSRETURN_UNDEF, XSRETURN_YES, XST_mIV, XST_mNO, XST_mNV,
3706 XST_mPV, XST_mUNDEF, XST_mYES, XS_VERSION, XS_VERSION_BOOTCHECK, Zero
3707
3708 =item AUTHORS
3709
3710 =item SEE ALSO
3711
3712 =back
3713
3714 =head2 perlintern - autogenerated documentation of purely B<internal> 
3715                  Perl functions
3716
3717 =over
3718
3719 =item DESCRIPTION
3720
3721 =item AUTHORS
3722
3723 =item SEE ALSO
3724
3725 =back
3726
3727 =head2 perlhist - the Perl history records
3728
3729 =over
3730
3731 =item DESCRIPTION
3732
3733 =item INTRODUCTION
3734
3735 =item THE KEEPERS OF THE PUMPKIN
3736
3737 =over
3738
3739 =item PUMPKIN?
3740
3741 =back
3742
3743 =item THE RECORDS
3744
3745 =over
3746
3747 =item SELECTED RELEASE SIZES
3748
3749 =item SELECTED PATCH SIZES
3750
3751 =back
3752
3753 =item THE KEEPERS OF THE RECORDS
3754
3755 =back
3756
3757 =head1 PRAGMA DOCUMENTATION
3758
3759 =head2 attrs - set/get attributes of a subroutine (deprecated)
3760
3761 =over
3762
3763 =item SYNOPSIS
3764
3765 =item DESCRIPTION
3766
3767 method, locked
3768
3769 =back
3770
3771 =head2 re - Perl pragma to alter regular expression behaviour
3772
3773 =over
3774
3775 =item SYNOPSIS
3776
3777 =item DESCRIPTION
3778
3779 =back
3780
3781 =head2 attributes - get/set subroutine or variable attributes
3782
3783 =over
3784
3785 =item SYNOPSIS
3786
3787 =item DESCRIPTION
3788
3789 =over
3790
3791 =item Built-in Attributes
3792
3793 locked, method
3794
3795 =item Available Subroutines
3796
3797 get, reftype
3798
3799 =item Package-specific Attribute Handling
3800
3801 FETCH_I<type>_ATTRIBUTES, MODIFY_I<type>_ATTRIBUTES
3802
3803 =item Syntax of Attribute Lists
3804
3805 =back
3806
3807 =item EXPORTS
3808
3809 =over
3810
3811 =item Default exports
3812
3813 =item Available exports
3814
3815 =item Export tags defined
3816
3817 =back
3818
3819 =item EXAMPLES
3820
3821 =item SEE ALSO
3822
3823 =back
3824
3825 =head2 attrs - set/get attributes of a subroutine (deprecated)
3826
3827 =over
3828
3829 =item SYNOPSIS
3830
3831 =item DESCRIPTION
3832
3833 method, locked
3834
3835 =back
3836
3837 =head2 autouse - postpone load of modules until a function is used
3838
3839 =over
3840
3841 =item SYNOPSIS
3842
3843 =item DESCRIPTION
3844
3845 =item WARNING
3846
3847 =item AUTHOR
3848
3849 =item SEE ALSO
3850
3851 =back
3852
3853 =head2 base - Establish IS-A relationship with base class at compile time
3854
3855 =over
3856
3857 =item SYNOPSIS
3858
3859 =item DESCRIPTION
3860
3861 =item HISTORY
3862
3863 =item SEE ALSO
3864
3865 =back
3866
3867 =head2 blib - Use MakeMaker's uninstalled version of a package
3868
3869 =over
3870
3871 =item SYNOPSIS
3872
3873 =item DESCRIPTION
3874
3875 =item BUGS
3876
3877 =item AUTHOR
3878
3879 =back
3880
3881 =head2 bytes - Perl pragma to turn force treating strings as bytes not
3882 UNICODE
3883
3884 =over
3885
3886 =item SYNOPSIS
3887
3888 =item DESCRIPTION
3889
3890 =back
3891
3892 =head2 caller - inherit pragmatic attributes from the context of the caller
3893
3894 =over
3895
3896 =item SYNOPSIS
3897
3898 =item DESCRIPTION
3899
3900 encoding
3901
3902 =back
3903
3904 =head2 charnames - define character names for C<\N{named}> string literal
3905 escape.
3906
3907 =over
3908
3909 =item SYNOPSIS
3910
3911 =item DESCRIPTION
3912
3913 =item CUSTOM TRANSLATORS
3914
3915 =item BUGS
3916
3917 =back
3918
3919 =head2 constant - Perl pragma to declare constants
3920
3921 =over
3922
3923 =item SYNOPSIS
3924
3925 =item DESCRIPTION
3926
3927 =item NOTES
3928
3929 =item TECHNICAL NOTE
3930
3931 =item BUGS
3932
3933 =item AUTHOR
3934
3935 =item COPYRIGHT
3936
3937 =back
3938
3939 =head2 diagnostics - Perl compiler pragma to force verbose warning
3940 diagnostics
3941
3942 =over
3943
3944 =item SYNOPSIS
3945
3946 =item DESCRIPTION
3947
3948 =over
3949
3950 =item The C<diagnostics> Pragma
3951
3952 =item The I<splain> Program
3953
3954 =back
3955
3956 =item EXAMPLES
3957
3958 =item INTERNALS
3959
3960 =item BUGS
3961
3962 =item AUTHOR
3963
3964 =back
3965
3966 =head2 fields - compile-time class fields
3967
3968 =over
3969
3970 =item SYNOPSIS
3971
3972 =item DESCRIPTION
3973
3974 =item SEE ALSO
3975
3976 =back
3977
3978 =head2 filetest - Perl pragma to control the filetest permission operators
3979
3980 =over
3981
3982 =item SYNOPSIS
3983
3984     $can_perhaps_read = -r "file";      # use the mode bits
3985     {
3986         use filetest 'access';          # intuit harder
3987         $can_really_read = -r "file";
3988     }
3989     $can_perhaps_read = -r "file";      # use the mode bits again
3990
3991 =item DESCRIPTION
3992
3993 =over
3994
3995 =item subpragma access
3996
3997 =back
3998
3999 =back
4000
4001 =head2 integer - Perl pragma to compute arithmetic in integer instead of
4002 double
4003
4004 =over
4005
4006 =item SYNOPSIS
4007
4008 =item DESCRIPTION
4009
4010 =back
4011
4012 =head2 less - perl pragma to request less of something from the compiler
4013
4014 =over
4015
4016 =item SYNOPSIS
4017
4018 =item DESCRIPTION
4019
4020 =back
4021
4022 =head2 lib - manipulate @INC at compile time
4023
4024 =over
4025
4026 =item SYNOPSIS
4027
4028 =item DESCRIPTION
4029
4030 =over
4031
4032 =item Adding directories to @INC
4033
4034 =item Deleting directories from @INC
4035
4036 =item Restoring original @INC
4037
4038 =back
4039
4040 =item SEE ALSO
4041
4042 =item AUTHOR
4043
4044 =back
4045
4046 =head2 locale - Perl pragma to use and avoid POSIX locales for built-in
4047 operations
4048
4049 =over
4050
4051 =item SYNOPSIS
4052
4053 =item DESCRIPTION
4054
4055 =back
4056
4057 =head2 ops - Perl pragma to restrict unsafe operations when compiling
4058
4059 =over
4060
4061 =item SYNOPSIS  
4062
4063 =item DESCRIPTION
4064
4065 =item SEE ALSO
4066
4067 =back
4068
4069 =head2 overload - Package for overloading perl operations
4070
4071 =over
4072
4073 =item SYNOPSIS
4074
4075 =item DESCRIPTION
4076
4077 =over
4078
4079 =item Declaration of overloaded functions
4080
4081 =item Calling Conventions for Binary Operations
4082
4083 FALSE, TRUE, C<undef>
4084
4085 =item Calling Conventions for Unary Operations
4086
4087 =item Calling Conventions for Mutators
4088
4089 C<++> and C<-->, C<x=> and other assignment versions
4090
4091 =item Overloadable Operations
4092
4093 I<Arithmetic operations>, I<Comparison operations>, I<Bit operations>,
4094 I<Increment and decrement>, I<Transcendental functions>, I<Boolean, string
4095 and numeric conversion>, I<Iteration>, I<Dereferencing>, I<Special>
4096
4097 =item Inheritance and overloading
4098
4099 Strings as values of C<use overload> directive, Overloading of an operation
4100 is inherited by derived classes
4101
4102 =back
4103
4104 =item SPECIAL SYMBOLS FOR C<use overload>
4105
4106 =over
4107
4108 =item Last Resort
4109
4110 =item Fallback 
4111
4112 C<undef>, TRUE, defined, but FALSE
4113
4114 =item Copy Constructor
4115
4116 B<Example>
4117
4118 =back
4119
4120 =item MAGIC AUTOGENERATION
4121
4122 I<Assignment forms of arithmetic operations>, I<Conversion operations>,
4123 I<Increment and decrement>, C<abs($a)>, I<Unary minus>, I<Negation>,
4124 I<Concatenation>, I<Comparison operations>, I<Iterator>, I<Dereferencing>,
4125 I<Copy operator>
4126
4127 =item Losing overloading
4128
4129 =item Run-time Overloading
4130
4131 =item Public functions
4132
4133 overload::StrVal(arg), overload::Overloaded(arg), overload::Method(obj,op)
4134
4135 =item Overloading constants
4136
4137 integer, float, binary, q, qr
4138
4139 =item IMPLEMENTATION
4140
4141 =item Metaphor clash
4142
4143 =item Cookbook
4144
4145 =over
4146
4147 =item Two-face scalars
4148
4149 =item Two-face references
4150
4151 =item Symbolic calculator
4152
4153 =item I<Really> symbolic calculator
4154
4155 =back
4156
4157 =item AUTHOR
4158
4159 =item DIAGNOSTICS
4160
4161 =item BUGS
4162
4163 =back
4164
4165 =head2 re - Perl pragma to alter regular expression behaviour
4166
4167 =over
4168
4169 =item SYNOPSIS
4170
4171 =item DESCRIPTION
4172
4173 =back
4174
4175 =head2 sigtrap - Perl pragma to enable simple signal handling
4176
4177 =over
4178
4179 =item SYNOPSIS
4180
4181 =item DESCRIPTION
4182
4183 =item OPTIONS
4184
4185 =over
4186
4187 =item SIGNAL HANDLERS
4188
4189 B<stack-trace>, B<die>, B<handler> I<your-handler>
4190
4191 =item SIGNAL LISTS
4192
4193 B<normal-signals>, B<error-signals>, B<old-interface-signals>
4194
4195 =item OTHER
4196
4197 B<untrapped>, B<any>, I<signal>, I<number>
4198
4199 =back
4200
4201 =item EXAMPLES
4202
4203 =back
4204
4205 =head2 strict - Perl pragma to restrict unsafe constructs
4206
4207 =over
4208
4209 =item SYNOPSIS
4210
4211 =item DESCRIPTION
4212
4213 C<strict refs>, C<strict vars>, C<strict subs>
4214
4215 =back
4216
4217 =head2 subs - Perl pragma to predeclare sub names
4218
4219 =over
4220
4221 =item SYNOPSIS
4222
4223 =item DESCRIPTION
4224
4225 =back
4226
4227 =head2 utf8 - Perl pragma to turn on UTF-8 and Unicode support
4228
4229 =over
4230
4231 =item SYNOPSIS
4232
4233 =item DESCRIPTION
4234
4235 =item CAVEATS
4236
4237 =back
4238
4239 =head2 vars - Perl pragma to predeclare global variable names (obsolete)
4240
4241 =over
4242
4243 =item SYNOPSIS
4244
4245 =item DESCRIPTION
4246
4247 =back
4248
4249 =head2 warnings - Perl pragma to control optional warnings
4250
4251 =over
4252
4253 =item SYNOPSIS
4254
4255 =item DESCRIPTION
4256
4257 =back
4258
4259 =head1 MODULE DOCUMENTATION
4260
4261 =head2 AnyDBM_File - provide framework for multiple DBMs
4262
4263 =over
4264
4265 =item SYNOPSIS
4266
4267 =item DESCRIPTION
4268
4269 =over
4270
4271 =item DBM Comparisons
4272
4273 [0], [1], [2], [3]
4274
4275 =back
4276
4277 =item SEE ALSO
4278
4279 =back
4280
4281 =head2 AutoLoader - load subroutines only on demand
4282
4283 =over
4284
4285 =item SYNOPSIS
4286
4287 =item DESCRIPTION
4288
4289 =over
4290
4291 =item Subroutine Stubs
4292
4293 =item Using B<AutoLoader>'s AUTOLOAD Subroutine
4294
4295 =item Overriding B<AutoLoader>'s AUTOLOAD Subroutine
4296
4297 =item Package Lexicals
4298
4299 =item B<AutoLoader> vs. B<SelfLoader>
4300
4301 =back
4302
4303 =item CAVEATS
4304
4305 =item SEE ALSO
4306
4307 =back
4308
4309 =head2 AutoSplit - split a package for autoloading
4310
4311 =over
4312
4313 =item SYNOPSIS
4314
4315 =item DESCRIPTION
4316
4317 $keep, $check, $modtime
4318
4319 =over
4320
4321 =item Multiple packages
4322
4323 =back
4324
4325 =item DIAGNOSTICS
4326
4327 =back
4328
4329 =head2 B - The Perl Compiler
4330
4331 =over
4332
4333 =item SYNOPSIS
4334
4335 =item DESCRIPTION
4336
4337 =item OVERVIEW OF CLASSES
4338
4339 =over
4340
4341 =item SV-RELATED CLASSES
4342
4343 =item B::SV METHODS
4344
4345 REFCNT, FLAGS
4346
4347 =item B::IV METHODS
4348
4349 IV, IVX, needs64bits, packiv
4350
4351 =item B::NV METHODS
4352
4353 NV, NVX
4354
4355 =item B::RV METHODS
4356
4357 RV
4358
4359 =item B::PV METHODS
4360
4361 PV
4362
4363 =item B::PVMG METHODS
4364
4365 MAGIC, SvSTASH
4366
4367 =item B::MAGIC METHODS
4368
4369 MOREMAGIC, PRIVATE, TYPE, FLAGS, OBJ, PTR
4370
4371 =item B::PVLV METHODS
4372
4373 TARGOFF, TARGLEN, TYPE, TARG
4374
4375 =item B::BM METHODS
4376
4377 USEFUL, PREVIOUS, RARE, TABLE
4378
4379 =item B::GV METHODS
4380
4381 NAME, STASH, SV, IO, FORM, AV, HV, EGV, CV, CVGEN, LINE, FILE, FILEGV,
4382 GvREFCNT, FLAGS
4383
4384 =item B::IO METHODS
4385
4386 LINES, PAGE, PAGE_LEN, LINES_LEFT, TOP_NAME, TOP_GV, FMT_NAME, FMT_GV,
4387 BOTTOM_NAME, BOTTOM_GV, SUBPROCESS, IoTYPE, IoFLAGS
4388
4389 =item B::AV METHODS
4390
4391 FILL, MAX, OFF, ARRAY, AvFLAGS
4392
4393 =item B::CV METHODS
4394
4395 STASH, START, ROOT, GV, FILE, DEPTH, PADLIST, OUTSIDE, XSUB, XSUBANY,
4396 CvFLAGS
4397
4398 =item B::HV METHODS
4399
4400 FILL, MAX, KEYS, RITER, NAME, PMROOT, ARRAY
4401
4402 =item OP-RELATED CLASSES
4403
4404 =item B::OP METHODS
4405
4406 next, sibling, name, ppaddr, desc, targ, type, seq, flags, private
4407
4408 =item B::UNOP METHOD
4409
4410 first
4411
4412 =item B::BINOP METHOD
4413
4414 last
4415
4416 =item B::LOGOP METHOD
4417
4418 other
4419
4420 =item B::LISTOP METHOD
4421
4422 children
4423
4424 =item B::PMOP METHODS
4425
4426 pmreplroot, pmreplstart, pmnext, pmregexp, pmflags, pmpermflags, precomp
4427
4428 =item B::SVOP METHOD
4429
4430 sv, gv
4431
4432 =item B::PADOP METHOD
4433
4434 padix
4435
4436 =item B::PVOP METHOD
4437
4438 pv
4439
4440 =item B::LOOP METHODS
4441
4442 redoop, nextop, lastop
4443
4444 =item B::COP METHODS
4445
4446 label, stash, file, cop_seq, arybase, line
4447
4448 =back
4449
4450 =item FUNCTIONS EXPORTED BY C<B>
4451
4452 main_cv, init_av, main_root, main_start, comppadlist, sv_undef, sv_yes,
4453 sv_no, amagic_generation, walkoptree(OP, METHOD), walkoptree_debug(DEBUG),
4454 walksymtable(SYMREF, METHOD, RECURSE), svref_2object(SV), ppname(OPNUM),
4455 hash(STR), cast_I32(I), minus_c, cstring(STR), class(OBJ), threadsv_names
4456
4457 =item AUTHOR
4458
4459 =back
4460
4461 =head2 B::Asmdata - Autogenerated data about Perl ops, used to generate
4462 bytecode
4463
4464 =over
4465
4466 =item SYNOPSIS
4467
4468 =item DESCRIPTION
4469
4470 =item AUTHOR
4471
4472 =back
4473
4474 =head2 B::Assembler - Assemble Perl bytecode
4475
4476 =over
4477
4478 =item SYNOPSIS
4479
4480 =item DESCRIPTION
4481
4482 =item AUTHOR
4483
4484 =back
4485
4486 =head2 B::Bblock - Walk basic blocks
4487
4488 =over
4489
4490 =item SYNOPSIS
4491
4492 =item DESCRIPTION
4493
4494 =item AUTHOR
4495
4496 =back
4497
4498 =head2 B::Bytecode - Perl compiler's bytecode backend
4499
4500 =over
4501
4502 =item SYNOPSIS
4503
4504 =item DESCRIPTION
4505
4506 =item OPTIONS
4507
4508 B<-ofilename>, B<-afilename>, B<-->, B<-f>, B<-fcompress-nullops>,
4509 B<-fomit-sequence-numbers>, B<-fbypass-nullops>, B<-fstrip-syntax-tree>,
4510 B<-On>, B<-D>, B<-Do>, B<-Db>, B<-Da>, B<-DC>, B<-S>, B<-m>
4511
4512 =item EXAMPLES
4513
4514 =item BUGS
4515
4516 =item AUTHOR
4517
4518 =back
4519
4520 =head2 B::C - Perl compiler's C backend
4521
4522 =over
4523
4524 =item SYNOPSIS
4525
4526 =item DESCRIPTION
4527
4528 =item OPTIONS
4529
4530 B<-ofilename>, B<-v>, B<-->, B<-uPackname>, B<-D>, B<-Do>, B<-Dc>, B<-DA>,
4531 B<-DC>, B<-DM>, B<-f>, B<-fcog>, B<-fno-cog>, B<-On>
4532
4533 =item EXAMPLES
4534
4535 =item BUGS
4536
4537 =item AUTHOR
4538
4539 =back
4540
4541 =head2 B::CC - Perl compiler's optimized C translation backend
4542
4543 =over
4544
4545 =item SYNOPSIS
4546
4547 =item DESCRIPTION
4548
4549 =item OPTIONS
4550
4551 B<-ofilename>, B<-v>, B<-->, B<-uPackname>, B<-mModulename>, B<-D>, B<-Dr>,
4552 B<-DO>, B<-Ds>, B<-Dp>, B<-Dq>, B<-Dl>, B<-Dt>, B<-f>,
4553 B<-ffreetmps-each-bblock>, B<-ffreetmps-each-loop>, B<-fomit-taint>, B<-On>
4554
4555 =item EXAMPLES
4556
4557 =item BUGS
4558
4559 =item DIFFERENCES
4560
4561 =over
4562
4563 =item Loops
4564
4565 =item Context of ".."
4566
4567 =item Arithmetic
4568
4569 =item Deprecated features
4570
4571 =back
4572
4573 =item AUTHOR
4574
4575 =back
4576
4577 =head2 B::Debug - Walk Perl syntax tree, printing debug info about ops
4578
4579 =over
4580
4581 =item SYNOPSIS
4582
4583 =item DESCRIPTION
4584
4585 =item AUTHOR
4586
4587 =back
4588
4589 =head2 B::Deparse - Perl compiler backend to produce perl code
4590
4591 =over
4592
4593 =item SYNOPSIS
4594
4595 =item DESCRIPTION
4596
4597 =item OPTIONS
4598
4599 B<-l>, B<-p>, B<-q>, B<-u>I<PACKAGE>, B<-s>I<LETTERS>, B<C>, B<i>I<NUMBER>,
4600 B<T>, B<v>I<STRING>B<.>
4601
4602 =item USING B::Deparse AS A MODULE
4603
4604 =over
4605
4606 =item Synopsis
4607
4608 =item Description
4609
4610 =item new
4611
4612 =item coderef2text
4613
4614 =back
4615
4616 =item BUGS
4617
4618 =item AUTHOR
4619
4620 =back
4621
4622 =head2 B::Disassembler - Disassemble Perl bytecode
4623
4624 =over
4625
4626 =item SYNOPSIS
4627
4628 =item DESCRIPTION
4629
4630 =item AUTHOR
4631
4632 =back
4633
4634 =head2 B::Lint - Perl lint
4635
4636 =over
4637
4638 =item SYNOPSIS
4639
4640 =item DESCRIPTION
4641
4642 =item OPTIONS AND LINT CHECKS
4643
4644 B<context>, B<implicit-read> and B<implicit-write>, B<dollar-underscore>,
4645 B<private-names>, B<undefined-subs>, B<regexp-variables>, B<all>, B<none>
4646
4647 =item NON LINT-CHECK OPTIONS
4648
4649 B<-u Package>
4650
4651 =item BUGS
4652
4653 =item AUTHOR
4654
4655 =back
4656
4657 =head2 B::O, O - Generic interface to Perl Compiler backends
4658
4659 =over
4660
4661 =item SYNOPSIS
4662
4663 =item DESCRIPTION
4664
4665 =item CONVENTIONS
4666
4667 =item IMPLEMENTATION
4668
4669 =item AUTHOR
4670
4671 =back
4672
4673 =head2 B::Showlex - Show lexical variables used in functions or files
4674
4675 =over
4676
4677 =item SYNOPSIS
4678
4679 =item DESCRIPTION
4680
4681 =item AUTHOR
4682
4683 =back
4684
4685 =head2 B::Stackobj - Helper module for CC backend
4686
4687 =over
4688
4689 =item SYNOPSIS
4690
4691 =item DESCRIPTION
4692
4693 =item AUTHOR
4694
4695 =back
4696
4697 =head2 B::Terse - Walk Perl syntax tree, printing terse info about ops
4698
4699 =over
4700
4701 =item SYNOPSIS
4702
4703 =item DESCRIPTION
4704
4705 =item AUTHOR
4706
4707 =back
4708
4709 =head2 B::Xref - Generates cross reference reports for Perl programs
4710
4711 =over
4712
4713 =item SYNOPSIS
4714
4715 =item DESCRIPTION
4716
4717 =item OPTIONS
4718
4719 C<-oFILENAME>, C<-r>, C<-D[tO]>
4720
4721 =item BUGS
4722
4723 =item AUTHOR
4724
4725 =back
4726
4727 =head2 Bblock, B::Bblock - Walk basic blocks
4728
4729 =over
4730
4731 =item SYNOPSIS
4732
4733 =item DESCRIPTION
4734
4735 =item AUTHOR
4736
4737 =back
4738
4739 =head2 Benchmark - benchmark running times of Perl code
4740
4741 =over
4742
4743 =item SYNOPSIS
4744
4745 =item DESCRIPTION
4746
4747 =over
4748
4749 =item Methods
4750
4751 new, debug, iters
4752
4753 =item Standard Exports
4754
4755 timeit(COUNT, CODE), timethis ( COUNT, CODE, [ TITLE, [ STYLE ]] ),
4756 timethese ( COUNT, CODEHASHREF, [ STYLE ] ), timediff ( T1, T2 ), timestr (
4757 TIMEDIFF, [ STYLE, [ FORMAT ] ] )
4758
4759 =item Optional Exports
4760
4761 clearcache ( COUNT ), clearallcache ( ), cmpthese ( COUT, CODEHASHREF, [
4762 STYLE ] ), cmpthese ( RESULTSHASHREF ), countit(TIME, CODE), disablecache (
4763 ), enablecache ( ), timesum ( T1, T2 )
4764
4765 =back
4766
4767 =item NOTES
4768
4769 =item EXAMPLES
4770
4771 =item INHERITANCE
4772
4773 =item CAVEATS
4774
4775 =item SEE ALSO
4776
4777 =item AUTHORS
4778
4779 =item MODIFICATION HISTORY
4780
4781 =back
4782
4783 =head2 ByteLoader - load byte compiled perl code
4784
4785 =over
4786
4787 =item SYNOPSIS
4788
4789 =item DESCRIPTION
4790
4791 =item AUTHOR
4792
4793 =item SEE ALSO
4794
4795 =back
4796
4797 =head2 Bytecode, B::Bytecode - Perl compiler's bytecode backend
4798
4799 =over
4800
4801 =item SYNOPSIS
4802
4803 =item DESCRIPTION
4804
4805 =item OPTIONS
4806
4807 B<-ofilename>, B<-afilename>, B<-->, B<-f>, B<-fcompress-nullops>,
4808 B<-fomit-sequence-numbers>, B<-fbypass-nullops>, B<-fstrip-syntax-tree>,
4809 B<-On>, B<-D>, B<-Do>, B<-Db>, B<-Da>, B<-DC>, B<-S>, B<-m>
4810
4811 =item EXAMPLES
4812
4813 =item BUGS
4814
4815 =item AUTHOR
4816
4817 =back
4818
4819 =head2 CGI - Simple Common Gateway Interface Class
4820
4821 =over
4822
4823 =item SYNOPSIS
4824
4825 =item ABSTRACT
4826
4827 =item DESCRIPTION
4828
4829 =over
4830
4831 =item PROGRAMMING STYLE
4832
4833 =item CALLING CGI.PM ROUTINES
4834
4835 1. Use another name for the argument, if one is available.  Forexample,
4836 -value is an alias for -values, 2. Change the capitalization, e.g. -Values,
4837 3. Put quotes around the argument name, e.g. '-values'
4838
4839 =item CREATING A NEW QUERY OBJECT (OBJECT-ORIENTED STYLE):
4840
4841 =item CREATING A NEW QUERY OBJECT FROM AN INPUT FILE
4842
4843 =item FETCHING A LIST OF KEYWORDS FROM THE QUERY:
4844
4845 =item FETCHING THE NAMES OF ALL THE PARAMETERS PASSED TO YOUR SCRIPT:
4846
4847 =item FETCHING THE VALUE OR VALUES OF A SINGLE NAMED PARAMETER:
4848
4849 =item SETTING THE VALUE(S) OF A NAMED PARAMETER:
4850
4851 =item APPENDING ADDITIONAL VALUES TO A NAMED PARAMETER:
4852
4853 =item IMPORTING ALL PARAMETERS INTO A NAMESPACE:
4854
4855 =item DELETING A PARAMETER COMPLETELY:
4856
4857 =item DELETING ALL PARAMETERS:
4858
4859 =item DIRECT ACCESS TO THE PARAMETER LIST:
4860
4861 =item FETCHING THE PARAMETER LIST AS A HASH:
4862
4863 =item SAVING THE STATE OF THE SCRIPT TO A FILE:
4864
4865 =item RETRIEVING CGI ERRORS
4866
4867 =item USING THE FUNCTION-ORIENTED INTERFACE
4868
4869 B<:cgi>, B<:form>, B<:html2>, B<:html3>, B<:netscape>, B<:html>,
4870 B<:standard>, B<:all>
4871
4872 =item PRAGMAS
4873
4874 -any, -compile, -nph, -newstyle_urls, -autoload, -no_debug,
4875 -private_tempfiles
4876
4877 =item SPECIAL FORMS FOR IMPORTING HTML-TAG FUNCTIONS
4878
4879 1. start_table() (generates a <TABLE> tag), 2. end_table() (generates a
4880 </TABLE> tag), 3. start_ul() (generates a <UL> tag), 4. end_ul() (generates
4881 a </UL> tag)
4882
4883 =back
4884
4885 =item GENERATING DYNAMIC DOCUMENTS
4886
4887 =over
4888
4889 =item CREATING A STANDARD HTTP HEADER:
4890
4891 =item GENERATING A REDIRECTION HEADER
4892
4893 =item CREATING THE HTML DOCUMENT HEADER
4894
4895 B<Parameters:>, 4, 5, 6..
4896
4897 =item ENDING THE HTML DOCUMENT:
4898
4899 =item CREATING A SELF-REFERENCING URL THAT PRESERVES STATE INFORMATION:
4900
4901 =item OBTAINING THE SCRIPT'S URL
4902
4903 B<-absolute>, B<-relative>, B<-full>, B<-path> (B<-path_info>), B<-query>
4904 (B<-query_string>)
4905
4906 =item MIXING POST AND URL PARAMETERS
4907
4908 =back
4909
4910 =item CREATING STANDARD HTML ELEMENTS:
4911
4912 =over
4913
4914 =item PROVIDING ARGUMENTS TO HTML SHORTCUTS
4915
4916 =item THE DISTRIBUTIVE PROPERTY OF HTML SHORTCUTS
4917
4918 =item HTML SHORTCUTS AND LIST INTERPOLATION
4919
4920 =item NON-STANDARD HTML SHORTCUTS
4921
4922 =item PRETTY-PRINTING HTML
4923
4924 =back
4925
4926 =item CREATING FILL-OUT FORMS:
4927
4928 =over
4929
4930 =item CREATING AN ISINDEX TAG
4931
4932 =item STARTING AND ENDING A FORM
4933
4934 B<application/x-www-form-urlencoded>, B<multipart/form-data>
4935
4936 =item CREATING A TEXT FIELD
4937
4938 B<Parameters>
4939
4940 =item CREATING A BIG TEXT FIELD
4941
4942 =item CREATING A PASSWORD FIELD
4943
4944 =item CREATING A FILE UPLOAD FIELD
4945
4946 B<Parameters>
4947
4948 =item CREATING A POPUP MENU
4949
4950 =item CREATING A SCROLLING LIST
4951
4952 B<Parameters:>
4953
4954 =item CREATING A GROUP OF RELATED CHECKBOXES
4955
4956 B<Parameters:>
4957
4958 =item CREATING A STANDALONE CHECKBOX
4959
4960 B<Parameters:>
4961
4962 =item CREATING A RADIO BUTTON GROUP
4963
4964 B<Parameters:>
4965
4966 =item CREATING A SUBMIT BUTTON 
4967
4968 B<Parameters:>
4969
4970 =item CREATING A RESET BUTTON
4971
4972 =item CREATING A DEFAULT BUTTON
4973
4974 =item CREATING A HIDDEN FIELD
4975
4976 B<Parameters:>
4977
4978 =item CREATING A CLICKABLE IMAGE BUTTON
4979
4980 B<Parameters:>, 3.The third option (-align, optional) is an alignment type,
4981 and may be
4982 TOP, BOTTOM or MIDDLE
4983
4984 =item CREATING A JAVASCRIPT ACTION BUTTON
4985
4986 =back
4987
4988 =item HTTP COOKIES
4989
4990 1. an expiration time, 2. a domain, 3. a path, 4. a "secure" flag,
4991 B<-name>, B<-value>, B<-path>, B<-domain>, B<-expires>, B<-secure>
4992
4993 =item WORKING WITH FRAMES
4994
4995 1. Create a <Frameset> document, 2. Specify the destination for the
4996 document in the HTTP header, 3. Specify the destination for the document in
4997 the <FORM> tag
4998
4999 =item LIMITED SUPPORT FOR CASCADING STYLE SHEETS
5000
5001 =item DEBUGGING
5002
5003 =over
5004
5005 =item DUMPING OUT ALL THE NAME/VALUE PAIRS
5006
5007 =back
5008
5009 =item FETCHING ENVIRONMENT VARIABLES
5010
5011 B<Accept()>, B<raw_cookie()>, B<user_agent()>, B<path_info()>,
5012 B<path_translated()>, B<remote_host()>, B<script_name()>Return the script
5013 name as a partial URL, for self-refering
5014 scripts, B<referer()>, B<auth_type ()>, B<server_name ()>, B<virtual_host
5015 ()>, B<server_software ()>, B<remote_user ()>, B<user_name ()>,
5016 B<request_method()>, B<content_type()>, B<http()>, B<https()>
5017
5018 =item USING NPH SCRIPTS
5019
5020 In the B<use> statement, By calling the B<nph()> method:, By using B<-nph>
5021 parameters in the B<header()> and B<redirect()>  statements:
5022
5023 =item Server Push
5024
5025 multipart_init()     
5026   multipart_init(-boundary=>$boundary);, multipart_start(), multipart_end()
5027
5028 =item Avoiding Denial of Service Attacks
5029
5030 B<$CGI::POST_MAX>, B<$CGI::DISABLE_UPLOADS>, B<1. On a script-by-script
5031 basis>, B<2. Globally for all scripts>
5032
5033 =item COMPATIBILITY WITH CGI-LIB.PL
5034
5035 =item AUTHOR INFORMATION
5036
5037 =item CREDITS
5038
5039 Matt Heffron (heffron@falstaff.css.beckman.com), James Taylor
5040 (james.taylor@srs.gov), Scott Anguish <sanguish@digifix.com>, Mike Jewell
5041 (mlj3u@virginia.edu), Timothy Shimmin (tes@kbs.citri.edu.au), Joergen Haegg
5042 (jh@axis.se), Laurent Delfosse (delfosse@delfosse.com), Richard Resnick
5043 (applepi1@aol.com), Craig Bishop (csb@barwonwater.vic.gov.au), Tony Curtis
5044 (tc@vcpc.univie.ac.at), Tim Bunce (Tim.Bunce@ig.co.uk), Tom Christiansen
5045 (tchrist@convex.com), Andreas Koenig (k@franz.ww.TU-Berlin.DE), Tim
5046 MacKenzie (Tim.MacKenzie@fulcrum.com.au), Kevin B. Hendricks
5047 (kbhend@dogwood.tyler.wm.edu), Stephen Dahmen (joyfire@inxpress.net), Ed
5048 Jordan (ed@fidalgo.net), David Alan Pisoni (david@cnation.com), Doug
5049 MacEachern (dougm@opengroup.org), Robin Houston (robin@oneworld.org),
5050 ...and many many more..
5051
5052 =item A COMPLETE EXAMPLE OF A SIMPLE FORM-BASED SCRIPT
5053
5054 =item BUGS
5055
5056 =item SEE ALSO
5057
5058 =back
5059
5060 =head2 CGI::Apache - Backward compatibility module for CGI.pm
5061
5062 =over
5063
5064 =item SYNOPSIS
5065
5066 =item ABSTRACT
5067
5068 =item DESCRIPTION
5069
5070 =item AUTHOR INFORMATION
5071
5072 =item BUGS
5073
5074 =item SEE ALSO
5075
5076 =back
5077
5078 =head2 CGI::Carp, B<CGI::Carp> - CGI routines for writing to the HTTPD (or
5079 other) error log
5080
5081 =over
5082
5083 =item SYNOPSIS
5084
5085 =item DESCRIPTION
5086
5087 =item REDIRECTING ERROR MESSAGES
5088
5089 =item MAKING PERL ERRORS APPEAR IN THE BROWSER WINDOW
5090
5091 =over
5092
5093 =item Changing the default message
5094
5095 =back
5096
5097 =item CHANGE LOG
5098
5099 =item AUTHORS
5100
5101 =item SEE ALSO
5102
5103 =back
5104
5105 =head2 CGI::Cookie - Interface to Netscape Cookies
5106
5107 =over
5108
5109 =item SYNOPSIS
5110
5111 =item DESCRIPTION
5112
5113 =item USING CGI::Cookie
5114
5115 B<1. expiration date>, B<2. domain>, B<3. path>, B<4. secure flag>
5116
5117 =over
5118
5119 =item Creating New Cookies
5120
5121 =item Sending the Cookie to the Browser
5122
5123 =item Recovering Previous Cookies
5124
5125 =item Manipulating Cookies
5126
5127 B<name()>, B<value()>, B<domain()>, B<path()>, B<expires()>
5128
5129 =back
5130
5131 =item AUTHOR INFORMATION
5132
5133 =item BUGS
5134
5135 =item SEE ALSO
5136
5137 =back
5138
5139 =head2 CGI::Fast - CGI Interface for Fast CGI
5140
5141 =over
5142
5143 =item SYNOPSIS
5144
5145 =item DESCRIPTION
5146
5147 =item OTHER PIECES OF THE PUZZLE
5148
5149 =item WRITING FASTCGI PERL SCRIPTS
5150
5151 =item INSTALLING FASTCGI SCRIPTS
5152
5153 =item USING FASTCGI SCRIPTS AS CGI SCRIPTS
5154
5155 =item CAVEATS
5156
5157 =item AUTHOR INFORMATION
5158
5159 =item BUGS
5160
5161 =item SEE ALSO
5162
5163 =back
5164
5165 =head2 CGI::Pretty - module to produce nicely formatted HTML code
5166
5167 =over
5168
5169 =item SYNOPSIS
5170
5171 =item DESCRIPTION
5172
5173 =over
5174
5175 =item Tags that won't be formatted
5176
5177 =item Customizing the Indenting
5178
5179 =back
5180
5181 =item BUGS
5182
5183 =item AUTHOR
5184
5185 =item SEE ALSO
5186
5187 =back
5188
5189 =head2 CGI::Push - Simple Interface to Server Push
5190
5191 =over
5192
5193 =item SYNOPSIS
5194
5195 =item DESCRIPTION
5196
5197 =item USING CGI::Push
5198
5199 -next_page, -last_page, -type, -delay, -cookie, -target, -expires
5200
5201 =over
5202
5203 =item Heterogeneous Pages
5204
5205 =item Changing the Page Delay on the Fly
5206
5207 =back
5208
5209 =item INSTALLING CGI::Push SCRIPTS
5210
5211 =item AUTHOR INFORMATION
5212
5213 =item BUGS
5214
5215 =item SEE ALSO
5216
5217 =back
5218
5219 =head2 CGI::Switch - Backward compatibility module for defunct CGI::Switch
5220
5221 =over
5222
5223 =item SYNOPSIS
5224
5225 =item ABSTRACT
5226
5227 =item DESCRIPTION
5228
5229 =item AUTHOR INFORMATION
5230
5231 =item BUGS
5232
5233 =item SEE ALSO
5234
5235 =back
5236
5237 =head2 CPAN - query, download and build perl modules from CPAN sites
5238
5239 =over
5240
5241 =item SYNOPSIS
5242
5243 =item DESCRIPTION
5244
5245 =over
5246
5247 =item Interactive Mode
5248
5249 Searching for authors, bundles, distribution files and modules, make, test,
5250 install, clean  modules or distributions, readme, look module or
5251 distribution, Signals
5252
5253 =item CPAN::Shell
5254
5255 =item autobundle
5256
5257 =item recompile
5258
5259 =item The four C<CPAN::*> Classes: Author, Bundle, Module, Distribution
5260
5261 =item ProgrammerE<39>s interface
5262
5263 expand($type,@things), Programming Examples
5264
5265 =item Methods in the four Classes
5266
5267 =item Cache Manager
5268
5269 =item Bundles
5270
5271 =item Prerequisites
5272
5273 =item Finding packages and VERSION
5274
5275 =item Debugging
5276
5277 =item Floppy, Zip, Offline Mode
5278
5279 =back
5280
5281 =item CONFIGURATION
5282
5283 o conf E<lt>scalar optionE<gt>, o conf E<lt>scalar optionE<gt>
5284 E<lt>valueE<gt>, o conf E<lt>list optionE<gt>, o conf E<lt>list optionE<gt>
5285 [shift|pop], o conf E<lt>list optionE<gt> [unshift|push|splice]
5286 E<lt>listE<gt>
5287
5288 =over
5289
5290 =item Note on urllist parameter's format
5291
5292 =item urllist parameter has CD-ROM support
5293
5294 =back
5295
5296 =item SECURITY
5297
5298 =item EXPORT
5299
5300 =item POPULATE AN INSTALLATION WITH LOTS OF MODULES
5301
5302 =item WORKING WITH CPAN.pm BEHIND FIREWALLS
5303
5304 http firewall, ftp firewall, One way visibility, SOCKS, IP Masquerade
5305
5306 =item BUGS
5307
5308 =item AUTHOR
5309
5310 =item SEE ALSO
5311
5312 =back
5313
5314 =head2 CPAN::FirstTime - Utility for CPAN::Config file Initialization
5315
5316 =over
5317
5318 =item SYNOPSIS
5319
5320 =item DESCRIPTION
5321
5322 =back
5323
5324 =head2 CPANox, CPAN::Nox - Wrapper around CPAN.pm without using any XS
5325 module
5326
5327 =over
5328
5329 =item SYNOPSIS
5330
5331 =item DESCRIPTION
5332
5333 =item  SEE ALSO
5334
5335 =back
5336
5337 =head2 Carp, carp    - warn of errors (from perspective of caller)
5338
5339 =over
5340
5341 =item SYNOPSIS
5342
5343 =item DESCRIPTION
5344
5345 =over
5346
5347 =item Forcing a Stack Trace
5348
5349 =back
5350
5351 =item BUGS
5352
5353 =back
5354
5355 =head2 Carp::Heavy - Carp guts
5356
5357 =over
5358
5359 =item SYNOPIS
5360
5361 =item DESCRIPTION
5362
5363 =back
5364
5365 =head2 Class::Struct - declare struct-like datatypes as Perl classes
5366
5367 =over
5368
5369 =item SYNOPSIS
5370
5371 =item DESCRIPTION
5372
5373 =over
5374
5375 =item The C<struct()> function
5376
5377 =item Element Types and Accessor Methods
5378
5379 Scalar (C<'$'> or C<'*$'>), Array (C<'@'> or C<'*@'>), Hash (C<'%'> or
5380 C<'*%'>), Class (C<'Class_Name'> or C<'*Class_Name'>)
5381
5382 =item Initializing with C<new>
5383
5384 =back
5385
5386 =item EXAMPLES
5387
5388 Example 1, Example 2, Example 3
5389
5390 =item Author and Modification History
5391
5392 =back
5393
5394 =head2 Config - access Perl configuration information
5395
5396 =over
5397
5398 =item SYNOPSIS
5399
5400 =item DESCRIPTION
5401
5402 myconfig(), config_sh(), config_vars(@names)
5403
5404 =item EXAMPLE
5405
5406 =item WARNING
5407
5408 =item GLOSSARY
5409
5410 =over
5411
5412 =item _
5413
5414 C<_a>, C<_exe>, C<_o>
5415
5416 =item a
5417
5418 C<afs>, C<alignbytes>, C<ansi2knr>, C<aphostname>, C<api_revision>,
5419 C<api_subversion>, C<api_version>, C<api_versionstring>, C<ar>, C<archlib>,
5420 C<archlibexp>, C<archname64>, C<archname>, C<archobjs>, C<awk>
5421
5422 =item b
5423
5424 C<baserev>, C<bash>, C<bin>, C<bincompat5005>, C<binexp>, C<bison>,
5425 C<byacc>, C<byteorder>
5426
5427 =item c
5428
5429 C<c>, C<castflags>, C<cat>, C<cc>, C<cccdlflags>, C<ccdlflags>, C<ccflags>,
5430 C<ccsymbols>, C<cf_by>, C<cf_email>, C<cf_time>, C<charsize>, C<chgrp>,
5431 C<chmod>, C<chown>, C<clocktype>, C<comm>, C<compress>
5432
5433 =item C
5434
5435 C<CONFIGDOTSH>, C<contains>, C<cp>, C<cpio>, C<cpp>, C<cpp_stuff>,
5436 C<cppccsymbols>, C<cppflags>, C<cpplast>, C<cppminus>, C<cpprun>,
5437 C<cppstdin>, C<cppsymbols>, C<crosscompile>, C<cryptlib>, C<csh>
5438
5439 =item d
5440
5441 C<d_access>, C<d_accessx>, C<d_alarm>, C<d_archlib>, C<d_atolf>,
5442 C<d_atoll>, C<d_attribut>, C<d_bcmp>, C<d_bcopy>, C<d_bincompat5005>,
5443 C<d_bsd>, C<d_bsdgetpgrp>, C<d_bsdsetpgrp>, C<d_bzero>, C<d_casti32>,
5444 C<d_castneg>, C<d_charvspr>, C<d_chown>, C<d_chroot>, C<d_chsize>,
5445 C<d_closedir>, C<d_const>, C<d_crypt>, C<d_csh>, C<d_cuserid>,
5446 C<d_dbl_dig>, C<d_difftime>, C<d_dirnamlen>, C<d_dlerror>, C<d_dlopen>,
5447 C<d_dlsymun>, C<d_dosuid>, C<d_drand48proto>, C<d_dup2>, C<d_eaccess>,
5448 C<d_endgrent>, C<d_endhent>, C<d_endnent>, C<d_endpent>, C<d_endpwent>,
5449 C<d_endsent>, C<d_endspent>, C<d_eofnblk>, C<d_eunice>, C<d_fchmod>,
5450 C<d_fchown>, C<d_fcntl>, C<d_fd_macros>, C<d_fd_set>, C<d_fds_bits>,
5451 C<d_fgetpos>, C<d_flexfnam>, C<d_flock>, C<d_fork>, C<d_fpathconf>,
5452 C<d_fpos64_t>, C<d_fs_data_s>, C<d_fseeko>, C<d_fsetpos>, C<d_fstatfs>,
5453 C<d_fstatvfs>, C<d_ftello>, C<d_ftime>, C<d_Gconvert>, C<d_getgrent>,
5454 C<d_getgrps>, C<d_gethbyaddr>, C<d_gethbyname>, C<d_gethent>,
5455 C<d_gethname>, C<d_gethostprotos>, C<d_getlogin>, C<d_getmnt>,
5456 C<d_getmntent>, C<d_getnbyaddr>, C<d_getnbyname>, C<d_getnent>,
5457 C<d_getnetprotos>, C<d_getpbyname>, C<d_getpbynumber>, C<d_getpent>,
5458 C<d_getpgid>, C<d_getpgrp2>, C<d_getpgrp>, C<d_getppid>, C<d_getprior>,
5459 C<d_getprotoprotos>, C<d_getpwent>, C<d_getsbyname>, C<d_getsbyport>,
5460 C<d_getsent>, C<d_getservprotos>, C<d_getspent>, C<d_getspnam>,
5461 C<d_gettimeod>, C<d_gnulibc>, C<d_grpasswd>, C<d_hasmntopt>, C<d_htonl>,
5462 C<d_index>, C<d_inetaton>, C<d_int64t>, C<d_isascii>, C<d_killpg>,
5463 C<d_lchown>, C<d_ldbl_dig>, C<d_link>, C<d_locconv>, C<d_lockf>,
5464 C<d_longdbl>, C<d_longlong>, C<d_lstat>, C<d_mblen>, C<d_mbstowcs>,
5465 C<d_mbtowc>, C<d_memchr>, C<d_memcmp>, C<d_memcpy>, C<d_memmove>,
5466 C<d_memset>, C<d_mkdir>, C<d_mkfifo>, C<d_mktime>, C<d_msg>,
5467 C<d_msg_ctrunc>, C<d_msg_dontroute>, C<d_msg_oob>, C<d_msg_peek>,
5468 C<d_msg_proxy>, C<d_msgctl>, C<d_msgget>, C<d_msgrcv>, C<d_msgsnd>,
5469 C<d_mymalloc>, C<d_nice>, C<d_nvpresuv>, C<d_off64_t>,
5470 C<d_old_pthread_create_joinable>, C<d_oldpthreads>, C<d_oldsock>,
5471 C<d_open3>, C<d_pathconf>, C<d_pause>, C<d_phostname>, C<d_pipe>,
5472 C<d_poll>, C<d_portable>, C<d_PRId64>, C<d_PRIeldbl>, C<d_PRIEldbl>,
5473 C<d_PRIfldbl>, C<d_PRIFldbl>, C<d_PRIgldbl>, C<d_PRIGldbl>, C<d_PRIi64>,
5474 C<d_PRIo64>, C<d_PRIu64>, C<d_PRIx64>, C<d_PRIX64>, C<d_pthread_yield>,
5475 C<d_pwage>, C<d_pwchange>, C<d_pwclass>, C<d_pwcomment>, C<d_pwexpire>,
5476 C<d_pwgecos>, C<d_pwpasswd>, C<d_pwquota>, C<d_quad>, C<d_readdir>,
5477 C<d_readlink>, C<d_rename>, C<d_rewinddir>, C<d_rmdir>, C<d_safebcpy>,
5478 C<d_safemcpy>, C<d_sanemcmp>, C<d_sched_yield>, C<d_scm_rights>,
5479 C<d_seekdir>, C<d_select>, C<d_sem>, C<d_semctl>, C<d_semctl_semid_ds>,
5480 C<d_semctl_semun>, C<d_semget>, C<d_semop>, C<d_setegid>, C<d_seteuid>,
5481 C<d_setgrent>, C<d_setgrps>, C<d_sethent>, C<d_setlinebuf>, C<d_setlocale>,
5482 C<d_setnent>, C<d_setpent>, C<d_setpgid>, C<d_setpgrp2>, C<d_setpgrp>,
5483 C<d_setprior>, C<d_setpwent>, C<d_setregid>, C<d_setresgid>,
5484 C<d_setresuid>, C<d_setreuid>, C<d_setrgid>, C<d_setruid>, C<d_setsent>,
5485 C<d_setsid>, C<d_setspent>, C<d_setvbuf>, C<d_sfio>, C<d_shm>, C<d_shmat>,
5486 C<d_shmatprototype>, C<d_shmctl>, C<d_shmdt>, C<d_shmget>, C<d_sigaction>,
5487 C<d_sigsetjmp>, C<d_socket>, C<d_sockpair>, C<d_sqrtl>, C<d_statblks>,
5488 C<d_statfs_f_flags>, C<d_statfs_s>, C<d_statvfs>, C<d_stdio_cnt_lval>,
5489 C<d_stdio_ptr_lval>, C<d_stdio_stream_array>, C<d_stdiobase>,
5490 C<d_stdstdio>, C<d_strchr>, C<d_strcoll>, C<d_strctcpy>, C<d_strerrm>,
5491 C<d_strerror>, C<d_strtod>, C<d_strtol>, C<d_strtold>, C<d_strtoll>,
5492 C<d_strtoul>, C<d_strtoull>, C<d_strtouq>, C<d_strxfrm>, C<d_suidsafe>,
5493 C<d_symlink>, C<d_syscall>, C<d_sysconf>, C<d_sysernlst>, C<d_syserrlst>,
5494 C<d_system>, C<d_tcgetpgrp>, C<d_tcsetpgrp>, C<d_telldir>,
5495 C<d_telldirproto>, C<d_time>, C<d_times>, C<d_truncate>, C<d_tzname>,
5496 C<d_umask>, C<d_uname>, C<d_union_semun>, C<d_ustat>, C<d_vendorbin>,
5497 C<d_vendorlib>, C<d_vfork>, C<d_void_closedir>, C<d_voidsig>, C<d_voidtty>,
5498 C<d_volatile>, C<d_vprintf>, C<d_wait4>, C<d_waitpid>, C<d_wcstombs>,
5499 C<d_wctomb>, C<d_xenix>, C<date>, C<db_hashtype>, C<db_prefixtype>,
5500 C<defvoidused>, C<direntrytype>, C<dlext>, C<dlsrc>, C<doublesize>,
5501 C<drand01>, C<dynamic_ext>
5502
5503 =item e
5504
5505 C<eagain>, C<ebcdic>, C<echo>, C<egrep>, C<emacs>, C<eunicefix>,
5506 C<exe_ext>, C<expr>, C<extensions>
5507
5508 =item f
5509
5510 C<fflushall>, C<fflushNULL>, C<find>, C<firstmakefile>, C<flex>,
5511 C<fpossize>, C<fpostype>, C<freetype>, C<full_ar>, C<full_csh>, C<full_sed>
5512
5513 =item g
5514
5515 C<gccversion>, C<gidformat>, C<gidsign>, C<gidsize>, C<gidtype>,
5516 C<glibpth>, C<grep>, C<groupcat>, C<groupstype>, C<gzip>
5517
5518 =item h
5519
5520 C<h_fcntl>, C<h_sysfile>, C<hint>, C<hostcat>, C<huge>
5521
5522 =item i
5523
5524 C<i16size>, C<i16type>, C<i32size>, C<i32type>, C<i64size>, C<i64type>,
5525 C<i8size>, C<i8type>, C<i_arpainet>, C<i_bsdioctl>, C<i_db>, C<i_dbm>,
5526 C<i_dirent>, C<i_dld>, C<i_dlfcn>, C<i_fcntl>, C<i_float>, C<i_gdbm>,
5527 C<i_grp>, C<i_inttypes>, C<i_limits>, C<i_locale>, C<i_machcthr>,
5528 C<i_malloc>, C<i_math>, C<i_memory>, C<i_mntent>, C<i_ndbm>, C<i_netdb>,
5529 C<i_neterrno>, C<i_netinettcp>, C<i_niin>, C<i_poll>, C<i_pthread>,
5530 C<i_pwd>, C<i_rpcsvcdbm>, C<i_sfio>, C<i_sgtty>, C<i_shadow>, C<i_socks>,
5531 C<i_stdarg>, C<i_stddef>, C<i_stdlib>, C<i_string>, C<i_sysaccess>,
5532 C<i_sysdir>, C<i_sysfile>, C<i_sysfilio>, C<i_sysin>, C<i_sysioctl>,
5533 C<i_sysmount>, C<i_sysndir>, C<i_sysparam>, C<i_sysresrc>, C<i_syssecrt>,
5534 C<i_sysselct>, C<i_syssockio>, C<i_sysstat>, C<i_sysstatfs>,
5535 C<i_sysstatvfs>, C<i_systime>, C<i_systimek>, C<i_systimes>, C<i_systypes>,
5536 C<i_sysuio>, C<i_sysun>, C<i_sysvfs>, C<i_syswait>, C<i_termio>,
5537 C<i_termios>, C<i_time>, C<i_unistd>, C<i_ustat>, C<i_utime>, C<i_values>,
5538 C<i_varargs>, C<i_varhdr>, C<i_vfork>, C<ignore_versioned_solibs>,
5539 C<inc_version_list>, C<inc_version_list_init>, C<incpath>, C<inews>,
5540 C<installarchlib>, C<installbin>, C<installman1dir>, C<installman3dir>,
5541 C<installprefix>, C<installprefixexp>, C<installprivlib>, C<installscript>,
5542 C<installsitearch>, C<installsitebin>, C<installsitelib>, C<installstyle>,
5543 C<installusrbinperl>, C<installvendorbin>, C<installvendorlib>, C<intsize>,
5544 C<ivdformat>, C<ivsize>, C<ivtype>
5545
5546 =item k
5547
5548 C<known_extensions>, C<ksh>
5549
5550 =item l
5551
5552 C<large>, C<ld>, C<lddlflags>, C<ldflags>, C<ldlibpthname>, C<less>,
5553 C<lib_ext>, C<libc>, C<libperl>, C<libpth>, C<libs>, C<libswanted>,
5554 C<line>, C<lint>, C<lkflags>, C<ln>, C<lns>, C<locincpth>, C<loclibpth>,
5555 C<longdblsize>, C<longlongsize>, C<longsize>, C<lp>, C<lpr>, C<ls>,
5556 C<lseeksize>, C<lseektype>
5557
5558 =item m
5559
5560 C<mail>, C<mailx>, C<make>, C<make_set_make>, C<mallocobj>, C<mallocsrc>,
5561 C<malloctype>, C<man1dir>, C<man1direxp>, C<man1ext>, C<man3dir>,
5562 C<man3direxp>, C<man3ext>
5563
5564 =item M
5565
5566 C<Mcc>, C<medium>, C<mips_type>, C<mkdir>, C<models>, C<modetype>, C<more>,
5567 C<multiarch>, C<mv>, C<myarchname>, C<mydomain>, C<myhostname>, C<myuname>
5568
5569 =item n
5570
5571 C<n>, C<netdb_hlen_type>, C<netdb_host_type>, C<netdb_name_type>,
5572 C<netdb_net_type>, C<nm>, C<nm_opt>, C<nm_so_opt>, C<nonxs_ext>, C<nroff>,
5573 C<nvsize>, C<nvtype>
5574
5575 =item o
5576
5577 C<o_nonblock>, C<obj_ext>, C<old_pthread_create_joinable>, C<optimize>,
5578 C<orderlib>, C<osname>, C<osvers>
5579
5580 =item p
5581
5582 C<package>, C<pager>, C<passcat>, C<patchlevel>, C<path_sep>, C<perl>
5583
5584 =item P
5585
5586 C<PERL_REVISION>, C<PERL_SUBVERSION>, C<PERL_VERSION>, C<perladmin>,
5587 C<perlpath>, C<pg>, C<phostname>, C<pidtype>, C<plibpth>, C<pmake>, C<pr>,
5588 C<prefix>, C<prefixexp>, C<privlib>, C<privlibexp>, C<prototype>,
5589 C<ptrsize>
5590
5591 =item q
5592
5593 C<quadkind>, C<quadtype>
5594
5595 =item r
5596
5597 C<randbits>, C<randfunc>, C<randseedtype>, C<ranlib>, C<rd_nodata>, C<rm>,
5598 C<rmail>, C<runnm>
5599
5600 =item s
5601
5602 C<sched_yield>, C<scriptdir>, C<scriptdirexp>, C<sed>, C<seedfunc>,
5603 C<selectminbits>, C<selecttype>, C<sendmail>, C<sh>, C<shar>, C<sharpbang>,
5604 C<shmattype>, C<shortsize>, C<shrpenv>, C<shsharp>, C<sig_count>,
5605 C<sig_name>, C<sig_name_init>, C<sig_num>, C<sig_num_init>, C<signal_t>,
5606 C<sitearch>, C<sitearchexp>, C<sitebin>, C<sitebinexp>, C<sitelib>,
5607 C<sitelibexp>, C<siteprefix>, C<siteprefixexp>, C<sizetype>, C<sleep>,
5608 C<smail>, C<small>, C<so>, C<sockethdr>, C<socketlib>, C<sort>,
5609 C<spackage>, C<spitshell>, C<split>, C<sPRId64>, C<sPRIeldbl>,
5610 C<sPRIEldbl>, C<sPRIfldbl>, C<sPRIFldbl>, C<sPRIgldbl>, C<sPRIGldbl>,
5611 C<sPRIi64>, C<sPRIo64>, C<sPRIu64>, C<sPRIx64>, C<sPRIX64>, C<src>,
5612 C<ssizetype>, C<startperl>, C<startsh>, C<static_ext>, C<stdchar>,
5613 C<stdio_base>, C<stdio_bufsiz>, C<stdio_cnt>, C<stdio_filbuf>,
5614 C<stdio_ptr>, C<stdio_stream_array>, C<strings>, C<submit>, C<subversion>,
5615 C<sysman>
5616
5617 =item t
5618
5619 C<tail>, C<tar>, C<tbl>, C<tee>, C<test>, C<timeincl>, C<timetype>,
5620 C<touch>, C<tr>, C<trnl>, C<troff>
5621
5622 =item u
5623
5624 C<u16size>, C<u16type>, C<u32size>, C<u32type>, C<u64size>, C<u64type>,
5625 C<u8size>, C<u8type>, C<uidformat>, C<uidsign>, C<uidsize>, C<uidtype>,
5626 C<uname>, C<uniq>, C<uquadtype>, C<use5005threads>, C<use64bits>, C<usedl>,
5627 C<useithreads>, C<uselargefiles>, C<uselongdouble>, C<uselonglong>,
5628 C<usemorebits>, C<usemultiplicity>, C<usemymalloc>, C<usenm>, C<useopcode>,
5629 C<useperlio>, C<useposix>, C<usesfio>, C<useshrplib>, C<usesocks>,
5630 C<usethreads>, C<usevendorprefix>, C<usevfork>, C<usrinc>, C<uuname>,
5631 C<uvoformat>, C<uvsize>, C<uvtype>, C<uvuformat>, C<uvxformat>
5632
5633 =item v
5634
5635 C<vendorbin>, C<vendorbinexp>, C<vendorlib>, C<vendorlibexp>,
5636 C<vendorprefix>, C<vendorprefixexp>, C<version>, C<vi>, C<voidflags>
5637
5638 =item x
5639
5640 C<xlibpth>
5641
5642 =item z
5643
5644 C<zcat>, C<zip>
5645
5646 =back
5647
5648 =item NOTE
5649
5650 =back
5651
5652 =head2 Cwd, getcwd - get pathname of current working directory
5653
5654 =over
5655
5656 =item SYNOPSIS
5657
5658 =item DESCRIPTION
5659
5660 =back
5661
5662 =head2 DB - programmatic interface to the Perl debugging API (draft,
5663 subject to
5664 change)
5665
5666 =over
5667
5668 =item SYNOPSIS
5669
5670 =item DESCRIPTION
5671
5672 =over
5673
5674 =item Global Variables
5675
5676  $DB::sub,  %DB::sub,  $DB::single,  $DB::signal,  $DB::trace,  @DB::args, 
5677 @DB::dbline,  %DB::dbline,  $DB::package,  $DB::filename,  $DB::subname, 
5678 $DB::lineno
5679
5680 =item API Methods
5681
5682 CLIENT->register(), CLIENT->evalcode(STRING), CLIENT->skippkg('D::hide'),
5683 CLIENT->run(), CLIENT->step(), CLIENT->next(), CLIENT->done()
5684
5685 =item Client Callback Methods
5686
5687 CLIENT->init(), CLIENT->prestop([STRING]), CLIENT->stop(), CLIENT->idle(),
5688 CLIENT->poststop([STRING]), CLIENT->evalcode(STRING), CLIENT->cleanup(),
5689 CLIENT->output(LIST)
5690
5691 =back
5692
5693 =item BUGS
5694
5695 =item AUTHOR
5696
5697 =back
5698
5699 =head2 DB_File - Perl5 access to Berkeley DB version 1.x
5700
5701 =over
5702
5703 =item SYNOPSIS
5704
5705 =item DESCRIPTION
5706
5707 B<DB_HASH>, B<DB_BTREE>, B<DB_RECNO>
5708
5709 =over
5710
5711 =item Using DB_File with Berkeley DB version 2 or 3
5712
5713 =item Interface to Berkeley DB
5714
5715 =item Opening a Berkeley DB Database File
5716
5717 =item Default Parameters
5718
5719 =item In Memory Databases
5720
5721 =back
5722
5723 =item DB_HASH
5724
5725 =over
5726
5727 =item A Simple Example
5728
5729 =back
5730
5731 =item DB_BTREE
5732
5733 =over
5734
5735 =item Changing the BTREE sort order
5736
5737 =item Handling Duplicate Keys 
5738
5739 =item The get_dup() Method
5740
5741 =item The find_dup() Method
5742
5743 =item The del_dup() Method
5744
5745 =item Matching Partial Keys 
5746
5747 =back
5748
5749 =item DB_RECNO
5750
5751 =over
5752
5753 =item The 'bval' Option
5754
5755 =item A Simple Example
5756
5757 =item Extra RECNO Methods
5758
5759 B<$X-E<gt>push(list) ;>, B<$value = $X-E<gt>pop ;>, B<$X-E<gt>shift>,
5760 B<$X-E<gt>unshift(list) ;>, B<$X-E<gt>length>
5761
5762 =item Another Example
5763
5764 =back
5765
5766 =item THE API INTERFACE
5767
5768 B<$status = $X-E<gt>get($key, $value [, $flags]) ;>, B<$status =
5769 $X-E<gt>put($key, $value [, $flags]) ;>, B<$status = $X-E<gt>del($key [,
5770 $flags]) ;>, B<$status = $X-E<gt>fd ;>, B<$status = $X-E<gt>seq($key,
5771 $value, $flags) ;>, B<$status = $X-E<gt>sync([$flags]) ;>
5772
5773 =item DBM FILTERS
5774
5775 B<filter_store_key>, B<filter_store_value>, B<filter_fetch_key>,
5776 B<filter_fetch_value>
5777
5778 =over
5779
5780 =item The Filter
5781
5782 =item An Example -- the NULL termination problem.
5783
5784 =item Another Example -- Key is a C int.
5785
5786 =back
5787
5788 =item HINTS AND TIPS 
5789
5790 =over
5791
5792 =item Locking: The Trouble with fd
5793
5794 =item Safe ways to lock a database
5795
5796 B<Tie::DB_Lock>, B<Tie::DB_LockFile>, B<DB_File::Lock>
5797
5798 =item Sharing Databases With C Applications
5799
5800 =item The untie() Gotcha
5801
5802 =back
5803
5804 =item COMMON QUESTIONS
5805
5806 =over
5807
5808 =item Why is there Perl source in my database?
5809
5810 =item How do I store complex data structures with DB_File?
5811
5812 =item What does "Invalid Argument" mean?
5813
5814 =item What does "Bareword 'DB_File' not allowed" mean? 
5815
5816 =back
5817
5818 =item REFERENCES
5819
5820 =item HISTORY
5821
5822 =item BUGS
5823
5824 =item AVAILABILITY
5825
5826 =item COPYRIGHT
5827
5828 =item SEE ALSO
5829
5830 =item AUTHOR
5831
5832 =back
5833
5834 =head2 Data::Dumper - stringified perl data structures, suitable for both
5835 printing and C<eval>
5836
5837 =over
5838
5839 =item SYNOPSIS
5840
5841 =item DESCRIPTION
5842
5843 =over
5844
5845 =item Methods
5846
5847 I<PACKAGE>->new(I<ARRAYREF [>, I<ARRAYREF]>), I<$OBJ>->Dump  I<or> 
5848 I<PACKAGE>->Dump(I<ARRAYREF [>, I<ARRAYREF]>), I<$OBJ>->Dumpxs  I<or> 
5849 I<PACKAGE>->Dumpxs(I<ARRAYREF [>, I<ARRAYREF]>),
5850 I<$OBJ>->Seen(I<[HASHREF]>), I<$OBJ>->Values(I<[ARRAYREF]>),
5851 I<$OBJ>->Names(I<[ARRAYREF]>), I<$OBJ>->Reset
5852
5853 =item Functions
5854
5855 Dumper(I<LIST>), DumperX(I<LIST>)
5856
5857 =item Configuration Variables or Methods
5858
5859 $Data::Dumper::Indent  I<or>  I<$OBJ>->Indent(I<[NEWVAL]>),
5860 $Data::Dumper::Purity  I<or>  I<$OBJ>->Purity(I<[NEWVAL]>),
5861 $Data::Dumper::Pad  I<or>  I<$OBJ>->Pad(I<[NEWVAL]>),
5862 $Data::Dumper::Varname  I<or>  I<$OBJ>->Varname(I<[NEWVAL]>),
5863 $Data::Dumper::Useqq  I<or>  I<$OBJ>->Useqq(I<[NEWVAL]>),
5864 $Data::Dumper::Terse  I<or>  I<$OBJ>->Terse(I<[NEWVAL]>),
5865 $Data::Dumper::Freezer  I<or>  $I<OBJ>->Freezer(I<[NEWVAL]>),
5866 $Data::Dumper::Toaster  I<or>  $I<OBJ>->Toaster(I<[NEWVAL]>),
5867 $Data::Dumper::Deepcopy  I<or>  $I<OBJ>->Deepcopy(I<[NEWVAL]>),
5868 $Data::Dumper::Quotekeys  I<or>  $I<OBJ>->Quotekeys(I<[NEWVAL]>),
5869 $Data::Dumper::Bless  I<or>  $I<OBJ>->Bless(I<[NEWVAL]>),
5870 $Data::Dumper::Maxdepth  I<or>  $I<OBJ>->Maxdepth(I<[NEWVAL]>)
5871
5872 =item Exports
5873
5874 Dumper
5875
5876 =back
5877
5878 =item EXAMPLES
5879
5880 =item BUGS
5881
5882 =item AUTHOR
5883
5884 =item VERSION
5885
5886 =item SEE ALSO
5887
5888 =back
5889
5890 =head2 Devel::DProf - a Perl code profiler
5891
5892 =over
5893
5894 =item SYNOPSIS
5895
5896 =item DESCRIPTION
5897
5898 =item PROFILE FORMAT
5899
5900 =item AUTOLOAD
5901
5902 =item ENVIRONMENT
5903
5904 =item BUGS
5905
5906 =item SEE ALSO
5907
5908 =back
5909
5910 =head2 Devel::Peek - A data debugging tool for the XS programmer
5911
5912 =over
5913
5914 =item SYNOPSIS
5915
5916 =item DESCRIPTION
5917
5918 =item EXAMPLES
5919
5920 =over
5921
5922 =item A simple scalar string
5923
5924 =item A simple scalar number
5925
5926 =item A simple scalar with an extra reference
5927
5928 =item A reference to a simple scalar
5929
5930 =item A reference to an array
5931
5932 =item A reference to a hash
5933
5934 =item Dumping a large array or hash
5935
5936 =item A reference to an SV which holds a C pointer
5937
5938 =item A reference to a subroutine
5939
5940 =back
5941
5942 =item EXPORTS
5943
5944 =item BUGS
5945
5946 =item AUTHOR
5947
5948 =item SEE ALSO
5949
5950 =back
5951
5952 =head2 Devel::SelfStubber - generate stubs for a SelfLoading module
5953
5954 =over
5955
5956 =item SYNOPSIS
5957
5958 =item DESCRIPTION
5959
5960 =back
5961
5962 =head2 DirHandle - supply object methods for directory handles
5963
5964 =over
5965
5966 =item SYNOPSIS
5967
5968 =item DESCRIPTION
5969
5970 =back
5971
5972 =head2 Dumpvalue - provides screen dump of Perl data.
5973
5974 =over
5975
5976 =item SYNOPSIS
5977
5978 =item DESCRIPTION
5979
5980 =over
5981
5982 =item Creation
5983
5984 C<arrayDepth>, C<hashDepth>, C<compactDump>, C<veryCompact>, C<globPrint>,
5985 C<DumpDBFiles>, C<DumpPackages>, C<DumpReused>, C<tick>, C<HighBit>,
5986 C<printUndef>, C<UsageOnly>, unctrl, subdump, bareStringify, quoteHighBit,
5987 stopDbSignal
5988
5989 =item Methods
5990
5991 dumpValue, dumpValues, dumpvars, set_quote, set_unctrl, compactDump,
5992 veryCompact, set, get
5993
5994 =back
5995
5996 =back
5997
5998 =head2 DynaLoader - Dynamically load C libraries into Perl code
5999
6000 =over
6001
6002 =item SYNOPSIS
6003
6004 =item DESCRIPTION
6005
6006 @dl_library_path, @dl_resolve_using, @dl_require_symbols, @dl_librefs,
6007 @dl_modules, dl_error(), $dl_debug, dl_findfile(), dl_expandspec(),
6008 dl_load_file(), dl_loadflags(), dl_find_symbol(),
6009 dl_find_symbol_anywhere(), dl_undef_symbols(), dl_install_xsub(),
6010 bootstrap()
6011
6012 =item AUTHOR
6013
6014 =back
6015
6016 =head2 DynaLoader::XSLoader, XSLoader - Dynamically load C libraries into
6017 Perl code
6018
6019 =over
6020
6021 =item SYNOPSIS
6022
6023 =item DESCRIPTION
6024
6025 =item AUTHOR
6026
6027 =back
6028
6029 =head2 English - use nice English (or awk) names for ugly punctuation
6030 variables
6031
6032 =over
6033
6034 =item SYNOPSIS
6035
6036 =item DESCRIPTION
6037
6038 =back
6039
6040 =head2 Env - perl module that imports environment variables
6041
6042 =over
6043
6044 =item SYNOPSIS
6045
6046 =item DESCRIPTION
6047
6048 =item AUTHOR
6049
6050 =back
6051
6052 =head2 Errno - System errno constants
6053
6054 =over
6055
6056 =item SYNOPSIS
6057
6058 =item DESCRIPTION
6059
6060 =item AUTHOR
6061
6062 =item COPYRIGHT
6063
6064 =back
6065
6066 =head2 Exporter - Implements default import method for modules
6067
6068 =over
6069
6070 =item SYNOPSIS
6071
6072 =item DESCRIPTION
6073
6074 =over
6075
6076 =item How to Export
6077
6078 =item Selecting What To Export
6079
6080 =item Specialised Import Lists
6081
6082 =item Exporting without using Export's import method
6083
6084 =item Module Version Checking
6085
6086 =item Managing Unknown Symbols
6087
6088 =item Tag Handling Utility Functions
6089
6090 =back
6091
6092 =back
6093
6094 =head2 Exporter::Heavy - Exporter guts
6095
6096 =over
6097
6098 =item SYNOPIS
6099
6100 =item DESCRIPTION
6101
6102 =back
6103
6104 =head2 ExtUtils::Command - utilities to replace common UNIX commands in
6105 Makefiles etc.
6106
6107 =over
6108
6109 =item SYNOPSIS
6110
6111 =item DESCRIPTION
6112
6113 =back
6114
6115 cat
6116
6117 eqtime src dst
6118
6119 rm_f files...
6120
6121 rm_f files...
6122
6123 touch files ..
6124
6125 mv source... destination
6126
6127 cp source... destination
6128
6129 chmod mode files..
6130
6131 mkpath directory..
6132
6133 test_f file
6134
6135 =over
6136
6137 =item BUGS
6138
6139 =item SEE ALSO 
6140
6141 =item AUTHOR
6142
6143 =back
6144
6145 =head2 ExtUtils::Embed - Utilities for embedding Perl in C/C++ applications
6146
6147 =over
6148
6149 =item SYNOPSIS
6150
6151 =item DESCRIPTION
6152
6153 =item @EXPORT
6154
6155 =item FUNCTIONS
6156
6157 xsinit(), Examples, ldopts(), Examples, perl_inc(), ccflags(), ccdlflags(),
6158 ccopts(), xsi_header(), xsi_protos(@modules), xsi_body(@modules)
6159
6160 =item EXAMPLES
6161
6162 =item SEE ALSO
6163
6164 =item AUTHOR
6165
6166 =back
6167
6168 =head2 ExtUtils::Install - install files from here to there
6169
6170 =over
6171
6172 =item SYNOPSIS
6173
6174 =item DESCRIPTION
6175
6176 =back
6177
6178 =head2 ExtUtils::Installed - Inventory management of installed modules
6179
6180 =over
6181
6182 =item SYNOPSIS
6183
6184 =item DESCRIPTION
6185
6186 =item USAGE
6187
6188 =item FUNCTIONS
6189
6190 new(), modules(), files(), directories(), directory_tree(), validate(),
6191 packlist(), version()
6192
6193 =item EXAMPLE
6194
6195 =item AUTHOR
6196
6197 =back
6198
6199 =head2 ExtUtils::Liblist - determine libraries to use and how to use them
6200
6201 =over
6202
6203 =item SYNOPSIS
6204
6205 =item DESCRIPTION
6206
6207 For static extensions, For dynamic extensions, For dynamic extensions
6208
6209 =over
6210
6211 =item EXTRALIBS
6212
6213 =item LDLOADLIBS and LD_RUN_PATH
6214
6215 =item BSLOADLIBS
6216
6217 =back
6218
6219 =item PORTABILITY
6220
6221 =over
6222
6223 =item VMS implementation
6224
6225 =item Win32 implementation
6226
6227 =back
6228
6229 =item SEE ALSO
6230
6231 =back
6232
6233 =head2 ExtUtils::MM_Cygwin - methods to override UN*X behaviour in
6234 ExtUtils::MakeMaker
6235
6236 =over
6237
6238 =item SYNOPSIS
6239
6240 =item DESCRIPTION
6241
6242 canonpath, cflags, manifypods, perl_archive
6243
6244 =back
6245
6246 =head2 ExtUtils::MM_OS2 - methods to override UN*X behaviour in
6247 ExtUtils::MakeMaker
6248
6249 =over
6250
6251 =item SYNOPSIS
6252
6253 =item DESCRIPTION
6254
6255 =back
6256
6257 =head2 ExtUtils::MM_Unix - methods used by ExtUtils::MakeMaker
6258
6259 =over
6260
6261 =item SYNOPSIS
6262
6263 =item DESCRIPTION
6264
6265 =item METHODS
6266
6267 =over
6268
6269 =item Preloaded methods
6270
6271 canonpath
6272
6273 =back
6274
6275 =back
6276
6277 catdir
6278
6279 catfile
6280
6281 curdir
6282
6283 rootdir
6284
6285 updir
6286
6287 =over
6288
6289 =item SelfLoaded methods
6290
6291 c_o (o)
6292
6293 =back
6294
6295 cflags (o)
6296
6297 clean (o)
6298
6299 const_cccmd (o)
6300
6301 const_config (o)
6302
6303 const_loadlibs (o)
6304
6305 constants (o)
6306
6307 depend (o)
6308
6309 dir_target (o)
6310
6311 dist (o)
6312
6313 dist_basics (o)
6314
6315 dist_ci (o)
6316
6317 dist_core (o)
6318
6319 dist_dir (o)
6320
6321 dist_test (o)
6322
6323 dlsyms (o)
6324
6325 dynamic (o)
6326
6327 dynamic_bs (o)
6328
6329 dynamic_lib (o)
6330
6331 exescan
6332
6333 extliblist
6334
6335 file_name_is_absolute
6336
6337 find_perl
6338
6339 =over
6340
6341 =item Methods to actually produce chunks of text for the Makefile
6342
6343 fixin
6344
6345 =back
6346
6347 force (o)
6348
6349 guess_name
6350
6351 has_link_code
6352
6353 htmlifypods (o)
6354
6355 init_dirscan
6356
6357 init_main
6358
6359 init_others
6360
6361 install (o)
6362
6363 installbin (o)
6364
6365 libscan (o)
6366
6367 linkext (o)
6368
6369 lsdir
6370
6371 macro (o)
6372
6373 makeaperl (o)
6374
6375 makefile (o)
6376
6377 manifypods (o)
6378
6379 maybe_command
6380
6381 maybe_command_in_dirs
6382
6383 needs_linking (o)
6384
6385 nicetext
6386
6387 parse_version
6388
6389 parse_abstract
6390
6391 pasthru (o)
6392
6393 path
6394
6395 perl_script
6396
6397 perldepend (o)
6398
6399 ppd
6400
6401 perm_rw (o)
6402
6403 perm_rwx (o)
6404
6405 pm_to_blib
6406
6407 post_constants (o)
6408
6409 post_initialize (o)
6410
6411 postamble (o)
6412
6413 prefixify
6414
6415 processPL (o)
6416
6417 realclean (o)
6418
6419 replace_manpage_separator
6420
6421 static (o)
6422
6423 static_lib (o)
6424
6425 staticmake (o)
6426
6427 subdir_x (o)
6428
6429 subdirs (o)
6430
6431 test (o)
6432
6433 test_via_harness (o)
6434
6435 test_via_script (o)
6436
6437 tool_autosplit (o)
6438
6439 tools_other (o)
6440
6441 tool_xsubpp (o)
6442
6443 top_targets (o)
6444
6445 writedoc
6446
6447 xs_c (o)
6448
6449 xs_cpp (o)
6450
6451 xs_o (o)
6452
6453 perl_archive
6454
6455 export_list
6456
6457 =over
6458
6459 =item SEE ALSO
6460
6461 =back
6462
6463 =head2 ExtUtils::MM_VMS - methods to override UN*X behaviour in
6464 ExtUtils::MakeMaker
6465
6466 =over
6467
6468 =item SYNOPSIS
6469
6470 =item DESCRIPTION
6471
6472 =over
6473
6474 =item Methods always loaded
6475
6476 wraplist
6477
6478 =back
6479
6480 =back
6481
6482 rootdir (override)
6483
6484 =over
6485
6486 =item SelfLoaded methods
6487
6488 guess_name (override)
6489
6490 =back
6491
6492 find_perl (override)
6493
6494 path (override)
6495
6496 maybe_command (override)
6497
6498 maybe_command_in_dirs (override)
6499
6500 perl_script (override)
6501
6502 file_name_is_absolute (override)
6503
6504 replace_manpage_separator
6505
6506 init_others (override)
6507
6508 constants (override)
6509
6510 cflags (override)
6511
6512 const_cccmd (override)
6513
6514 pm_to_blib (override)
6515
6516 tool_autosplit (override)
6517
6518 tool_sxubpp (override)
6519
6520 xsubpp_version (override)
6521
6522 tools_other (override)
6523
6524 dist (override)
6525
6526 c_o (override)
6527
6528 xs_c (override)
6529
6530 xs_o (override)
6531
6532 top_targets (override)
6533
6534 dlsyms (override)
6535
6536 dynamic_lib (override)
6537
6538 dynamic_bs (override)
6539
6540 static_lib (override)
6541
6542 manifypods (override)
6543
6544 processPL (override)
6545
6546 installbin (override)
6547
6548 subdir_x (override)
6549
6550 clean (override)
6551
6552 realclean (override)
6553
6554 dist_basics (override)
6555
6556 dist_core (override)
6557
6558 dist_dir (override)
6559
6560 dist_test (override)
6561
6562 install (override)
6563
6564 perldepend (override)
6565
6566 makefile (override)
6567
6568 test (override)
6569
6570 test_via_harness (override)
6571
6572 test_via_script (override)
6573
6574 makeaperl (override)
6575
6576 nicetext (override)
6577
6578 =head2 ExtUtils::MM_Win32 - methods to override UN*X behaviour in
6579 ExtUtils::MakeMaker
6580
6581 =over
6582
6583 =item SYNOPSIS
6584
6585 =item DESCRIPTION
6586
6587 =back
6588
6589 catfile
6590
6591 constants (o)
6592
6593 static_lib (o)
6594
6595 dynamic_bs (o)
6596
6597 dynamic_lib (o)
6598
6599 canonpath
6600
6601 perl_script
6602
6603 pm_to_blib
6604
6605 test_via_harness (o)
6606
6607 tool_autosplit (override)
6608
6609 tools_other (o)
6610
6611 xs_o (o)
6612
6613 top_targets (o)
6614
6615 htmlifypods (o)
6616
6617 manifypods (o)
6618
6619 dist_ci (o)
6620
6621 dist_core (o)
6622
6623 pasthru (o)
6624
6625 =head2 ExtUtils::MakeMaker - create an extension Makefile
6626
6627 =over
6628
6629 =item SYNOPSIS
6630
6631 =item DESCRIPTION
6632
6633 =over
6634
6635 =item How To Write A Makefile.PL
6636
6637 =item Default Makefile Behaviour
6638
6639 =item make test
6640
6641 =item make testdb
6642
6643 =item make install
6644
6645 =item PREFIX and LIB attribute
6646
6647 =item AFS users
6648
6649 =item Static Linking of a new Perl Binary
6650
6651 =item Determination of Perl Library and Installation Locations
6652
6653 =item Which architecture dependent directory?
6654
6655 =item Using Attributes and Parameters
6656
6657 AUTHOR, ABSTRACT, ABSTRACT_FROM, BINARY_LOCATION, C, CAPI, CCFLAGS, CONFIG,
6658 CONFIGURE, DEFINE, DIR, DISTNAME, DL_FUNCS, DL_VARS, EXCLUDE_EXT,
6659 EXE_FILES, FIRST_MAKEFILE, FULLPERL, FUNCLIST, H, HTMLLIBPODS,
6660 HTMLSCRIPTPODS, IMPORTS, INC, INCLUDE_EXT, INSTALLARCHLIB, INSTALLBIN,
6661 INSTALLDIRS, INSTALLHTMLPRIVLIBDIR, INSTALLHTMLSCRIPTDIR,
6662 INSTALLHTMLSITELIBDIR, INSTALLMAN1DIR, INSTALLMAN3DIR, INSTALLPRIVLIB,
6663 INSTALLSCRIPT, INSTALLSITEARCH, INSTALLSITELIB, INST_ARCHLIB, INST_BIN,
6664 INST_EXE, INST_LIB, INST_HTMLLIBDIR, INST_HTMLSCRIPTDIR, INST_MAN1DIR,
6665 INST_MAN3DIR, INST_SCRIPT, PERL_MALLOC_OK, LDFROM, LIB, LIBPERL_A, LIBS,
6666 LINKTYPE, MAKEAPERL, MAKEFILE, MAN1PODS, MAN3PODS, MAP_TARGET, MYEXTLIB,
6667 NAME, NEEDS_LINKING, NOECHO, NORECURS, NO_VC, OBJECT, OPTIMIZE, PERL,
6668 PERLMAINCC, PERL_ARCHLIB, PERL_LIB, PERL_SRC, PERM_RW, PERM_RWX, PL_FILES,
6669 PM, PMLIBDIRS, POLLUTE, PPM_INSTALL_EXEC, PPM_INSTALL_SCRIPT, PREFIX,
6670 PREREQ_PM, SKIP, TYPEMAPS, VERSION, VERSION_FROM, XS, XSOPT, XSPROTOARG,
6671 XS_VERSION
6672
6673 =item Additional lowercase attributes
6674
6675 clean, depend, dist, dynamic_lib, linkext, macro, realclean, test,
6676 tool_autosplit
6677
6678 =item Overriding MakeMaker Methods
6679
6680 =item Hintsfile support
6681
6682 =item Distribution Support
6683
6684    make distcheck,    make skipcheck,    make distclean,    make manifest, 
6685   make distdir,    make tardist,    make dist,    make uutardist,    make
6686 shdist,    make zipdist,    make ci
6687
6688 =item Disabling an extension
6689
6690 =back
6691
6692 =item ENVIRONMENT
6693
6694 PERL_MM_OPT
6695
6696 =item SEE ALSO
6697
6698 =item AUTHORS
6699
6700 =back
6701
6702 =head2 ExtUtils::Manifest - utilities to write and check a MANIFEST file
6703
6704 =over
6705
6706 =item SYNOPSIS
6707
6708 =item DESCRIPTION
6709
6710 =item MANIFEST.SKIP
6711
6712 =item EXPORT_OK
6713
6714 =item GLOBAL VARIABLES
6715
6716 =item DIAGNOSTICS
6717
6718 C<Not in MANIFEST:> I<file>, C<No such file:> I<file>, C<MANIFEST:> I<$!>,
6719 C<Added to MANIFEST:> I<file>
6720
6721 =item SEE ALSO
6722
6723 =item AUTHOR
6724
6725 =back
6726
6727 =head2 ExtUtils::Miniperl, writemain - write the C code for perlmain.c
6728
6729 =over
6730
6731 =item SYNOPSIS
6732
6733 =item DESCRIPTION
6734
6735 =item SEE ALSO
6736
6737 =back
6738
6739 =head2 ExtUtils::Mkbootstrap - make a bootstrap file for use by DynaLoader
6740
6741 =over
6742
6743 =item SYNOPSIS
6744
6745 =item DESCRIPTION
6746
6747 =back
6748
6749 =head2 ExtUtils::Mksymlists - write linker options files for dynamic
6750 extension
6751
6752 =over
6753
6754 =item SYNOPSIS
6755
6756 =item DESCRIPTION
6757
6758 DLBASE, DL_FUNCS, DL_VARS, FILE, FUNCLIST, IMPORTS, NAME
6759
6760 =item AUTHOR
6761
6762 =item REVISION
6763
6764 =back
6765
6766 =head2 ExtUtils::Packlist - manage .packlist files
6767
6768 =over
6769
6770 =item SYNOPSIS
6771
6772 =item DESCRIPTION
6773
6774 =item USAGE
6775
6776 =item FUNCTIONS
6777
6778 new(), read(), write(), validate(), packlist_file()
6779
6780 =item EXAMPLE
6781
6782 =item AUTHOR
6783
6784 =back
6785
6786 =head2 ExtUtils::testlib - add blib/* directories to @INC
6787
6788 =over
6789
6790 =item SYNOPSIS
6791
6792 =item DESCRIPTION
6793
6794 =back
6795
6796 =head2 Fatal - replace functions with equivalents which succeed or die
6797
6798 =over
6799
6800 =item SYNOPSIS
6801
6802 =item DESCRIPTION
6803
6804 =item AUTHOR
6805
6806 =back
6807
6808 =head2 Fcntl - load the C Fcntl.h defines
6809
6810 =over
6811
6812 =item SYNOPSIS
6813
6814 =item DESCRIPTION
6815
6816 =item NOTE
6817
6818 =item EXPORTED SYMBOLS
6819
6820 =back
6821
6822 =head2 File::Basename, fileparse - split a pathname into pieces
6823
6824 =over
6825
6826 =item SYNOPSIS
6827
6828 =item DESCRIPTION
6829
6830 fileparse_set_fstype, fileparse
6831
6832 =item EXAMPLES
6833
6834 C<basename>, C<dirname>
6835
6836 =back
6837
6838 =head2 File::CheckTree, validate - run many filetest checks on a tree
6839
6840 =over
6841
6842 =item SYNOPSIS
6843
6844 =item DESCRIPTION
6845
6846 =back
6847
6848 =head2 File::Compare - Compare files or filehandles
6849
6850 =over
6851
6852 =item SYNOPSIS
6853
6854 =item DESCRIPTION
6855
6856 =item RETURN
6857
6858 =item AUTHOR
6859
6860 =back
6861
6862 =head2 File::Copy - Copy files or filehandles
6863
6864 =over
6865
6866 =item SYNOPSIS
6867
6868 =item DESCRIPTION
6869
6870 =over
6871
6872 =item Special behaviour if C<syscopy> is defined (OS/2, VMS and Win32)
6873
6874 rmscopy($from,$to[,$date_flag])
6875
6876 =back
6877
6878 =item RETURN
6879
6880 =item AUTHOR
6881
6882 =back
6883
6884 =head2 File::DosGlob - DOS like globbing and then some
6885
6886 =over
6887
6888 =item SYNOPSIS
6889
6890 =item DESCRIPTION
6891
6892 =item EXPORTS (by request only)
6893
6894 =item BUGS
6895
6896 =item AUTHOR
6897
6898 =item HISTORY
6899
6900 =item SEE ALSO
6901
6902 =back
6903
6904 =head2 File::Find, find - traverse a file tree
6905
6906 =over
6907
6908 =item SYNOPSIS
6909
6910 =item DESCRIPTION
6911
6912 C<wanted>, C<bydepth>, C<follow>, C<follow_fast>, C<follow_skip>,
6913 C<no_chdir>, C<untaint>, C<untaint_pattern>, C<untaint_skip>
6914
6915 =item CAVEAT
6916
6917 =back
6918
6919 =head2 File::Glob - Perl extension for BSD glob routine
6920
6921 =over
6922
6923 =item SYNOPSIS
6924
6925 =item DESCRIPTION
6926
6927 C<GLOB_ERR>, C<GLOB_MARK>, C<GLOB_NOCASE>, C<GLOB_NOCHECK>, C<GLOB_NOSORT>,
6928 C<GLOB_BRACE>, C<GLOB_NOMAGIC>, C<GLOB_QUOTE>, C<GLOB_TILDE>, C<GLOB_CSH>
6929
6930 =item DIAGNOSTICS
6931
6932 C<GLOB_NOSPACE>, C<GLOB_ABEND>
6933
6934 =item NOTES
6935
6936 =item AUTHOR
6937
6938 =back
6939
6940 =head2 File::Path - create or remove directory trees
6941
6942 =over
6943
6944 =item SYNOPSIS
6945
6946 =item DESCRIPTION
6947
6948 =item AUTHORS
6949
6950 =back
6951
6952 =head2 File::Spec - portably perform operations on file names
6953
6954 =over
6955
6956 =item SYNOPSIS
6957
6958 =item DESCRIPTION
6959
6960 =item SEE ALSO
6961
6962 =item AUTHORS
6963
6964 =back
6965
6966 =head2 File::Spec::Functions - portably perform operations on file names
6967
6968 =over
6969
6970 =item SYNOPSIS
6971
6972 =item DESCRIPTION
6973
6974 =over
6975
6976 =item Exports
6977
6978 =back
6979
6980 =item SEE ALSO
6981
6982 =back
6983
6984 =head2 File::Spec::Mac - File::Spec for MacOS
6985
6986 =over
6987
6988 =item SYNOPSIS
6989
6990 =item DESCRIPTION
6991
6992 =item METHODS
6993
6994 canonpath
6995
6996 =back
6997
6998 catdir
6999
7000 catfile
7001
7002 curdir
7003
7004 devnull
7005
7006 rootdir
7007
7008 tmpdir
7009
7010 updir
7011
7012 file_name_is_absolute
7013
7014 path
7015
7016 =over
7017
7018 =item SEE ALSO
7019
7020 =back
7021
7022 =head2 File::Spec::OS2 - methods for OS/2 file specs
7023
7024 =over
7025
7026 =item SYNOPSIS
7027
7028 =item DESCRIPTION
7029
7030 =back
7031
7032 =head2 File::Spec::Unix - methods used by File::Spec
7033
7034 =over
7035
7036 =item SYNOPSIS
7037
7038 =item DESCRIPTION
7039
7040 =item METHODS
7041
7042 canonpath
7043
7044 =back
7045
7046 catdir
7047
7048 catfile
7049
7050 curdir
7051
7052 devnull
7053
7054 rootdir
7055
7056 tmpdir
7057
7058 updir
7059
7060 no_upwards
7061
7062 file_name_is_absolute
7063
7064 path
7065
7066 join
7067
7068 splitpath
7069
7070 splitdir
7071
7072 catpath
7073
7074 abs2rel
7075
7076 rel2abs
7077
7078 =over
7079
7080 =item SEE ALSO
7081
7082 =back
7083
7084 =head2 File::Spec::VMS - methods for VMS file specs
7085
7086 =over
7087
7088 =item SYNOPSIS
7089
7090 =item DESCRIPTION
7091
7092 eliminate_macros
7093
7094 =back
7095
7096 fixpath
7097
7098 =over
7099
7100 =item Methods always loaded
7101
7102 catdir
7103
7104 =back
7105
7106 catfile
7107
7108 curdir (override)
7109
7110 devnull (override)
7111
7112 rootdir (override)
7113
7114 tmpdir (override)
7115
7116 updir (override)
7117
7118 path (override)
7119
7120 file_name_is_absolute (override)
7121
7122 =over
7123
7124 =item SEE ALSO
7125
7126 =back
7127
7128 =head2 File::Spec::Win32 - methods for Win32 file specs
7129
7130 =over
7131
7132 =item SYNOPSIS
7133
7134 =item DESCRIPTION
7135
7136 devnull
7137
7138 =back
7139
7140 tmpdir
7141
7142 catfile
7143
7144 canonpath
7145
7146 splitpath
7147
7148 splitdir
7149
7150 catpath
7151
7152 abs2rel
7153
7154 rel2abs
7155
7156 =over
7157
7158 =item SEE ALSO
7159
7160 =back
7161
7162 =head2 File::stat - by-name interface to Perl's built-in stat() functions
7163
7164 =over
7165
7166 =item SYNOPSIS
7167
7168 =item DESCRIPTION
7169
7170 =item NOTE
7171
7172 =item AUTHOR
7173
7174 =back
7175
7176 =head2 FileCache - keep more files open than the system permits
7177
7178 =over
7179
7180 =item SYNOPSIS
7181
7182 =item DESCRIPTION
7183
7184 =item BUGS
7185
7186 =back
7187
7188 =head2 FileHandle - supply object methods for filehandles
7189
7190 =over
7191
7192 =item SYNOPSIS
7193
7194 =item DESCRIPTION
7195
7196 $fh->print, $fh->printf, $fh->getline, $fh->getlines
7197
7198 =item SEE ALSO
7199
7200 =back
7201
7202 =head2 FindBin - Locate directory of original perl script
7203
7204 =over
7205
7206 =item SYNOPSIS
7207
7208 =item DESCRIPTION
7209
7210 =item EXPORTABLE VARIABLES
7211
7212 =item KNOWN BUGS
7213
7214 =item AUTHORS
7215
7216 =item COPYRIGHT
7217
7218 =back
7219
7220 =head2 GDBM_File - Perl5 access to the gdbm library.
7221
7222 =over
7223
7224 =item SYNOPSIS
7225
7226 =item DESCRIPTION
7227
7228 =item AVAILABILITY
7229
7230 =item BUGS
7231
7232 =item SEE ALSO
7233
7234 =back
7235
7236 =head2 Getopt::Long, GetOptions - extended processing of command line
7237 options
7238
7239 =over
7240
7241 =item SYNOPSIS
7242
7243 =item DESCRIPTION
7244
7245 !, +, :s, :i, :f
7246
7247 =over
7248
7249 =item Linkage specification
7250
7251 =item Aliases and abbreviations
7252
7253 =item Non-option call-back routine
7254
7255 =item Option starters
7256
7257 =item Return values and Errors
7258
7259 =back
7260
7261 =item COMPATIBILITY
7262
7263 =item EXAMPLES
7264
7265 =item CONFIGURATION OPTIONS
7266
7267 default, auto_abbrev, getopt_compat, require_order, permute, bundling
7268 (default: reset), bundling_override (default: reset), ignore_case 
7269 (default: set), ignore_case_always (default: reset), pass_through (default:
7270 reset), prefix, prefix_pattern, debug (default: reset)
7271
7272 =item OTHER USEFUL VARIABLES
7273
7274 $Getopt::Long::VERSION, $Getopt::Long::error
7275
7276 =item AUTHOR
7277
7278 =item COPYRIGHT AND DISCLAIMER
7279
7280 =back
7281
7282 =head2 Getopt::Std, getopt - Process single-character switches with switch
7283 clustering
7284
7285 =over
7286
7287 =item SYNOPSIS
7288
7289 =item DESCRIPTION
7290
7291 =back
7292
7293 =head2 I18N::Collate - compare 8-bit scalar data according to the current
7294 locale
7295
7296 =over
7297
7298 =item SYNOPSIS
7299
7300 =item DESCRIPTION
7301
7302 =back
7303
7304 =head2 IO - load various IO modules
7305
7306 =over
7307
7308 =item SYNOPSIS
7309
7310 =item DESCRIPTION
7311
7312 =back
7313
7314 =head2 IO::Dir - supply object methods for directory handles
7315
7316 =over
7317
7318 =item SYNOPSIS
7319
7320 =item DESCRIPTION
7321
7322 new ( [ DIRNAME ] ), open ( DIRNAME ), read (), seek ( POS ), tell (),
7323 rewind (), close (), tie %hash, IO::Dir, DIRNAME [, OPTIONS ]
7324
7325 =item SEE ALSO
7326
7327 =item AUTHOR
7328
7329 =item COPYRIGHT
7330
7331 =back
7332
7333 =head2 IO::File - supply object methods for filehandles
7334
7335 =over
7336
7337 =item SYNOPSIS
7338
7339 =item DESCRIPTION
7340
7341 =item CONSTRUCTOR
7342
7343 new ( FILENAME [,MODE [,PERMS]] ), new_tmpfile
7344
7345 =item METHODS
7346
7347 open( FILENAME [,MODE [,PERMS]] )
7348
7349 =item SEE ALSO
7350
7351 =item HISTORY
7352
7353 =back
7354
7355 =head2 IO::Handle - supply object methods for I/O handles
7356
7357 =over
7358
7359 =item SYNOPSIS
7360
7361 =item DESCRIPTION
7362
7363 =item CONSTRUCTOR
7364
7365 new (), new_from_fd ( FD, MODE )
7366
7367 =item METHODS
7368
7369 $io->fdopen ( FD, MODE ), $io->opened, $io->getline, $io->getlines,
7370 $io->ungetc ( ORD ), $io->write ( BUF, LEN [, OFFSET ] ), $io->error,
7371 $io->clearerr, $io->sync, $io->flush, $io->printflush ( ARGS ),
7372 $io->blocking ( [ BOOL ] ), $io->untaint
7373
7374 =item NOTE
7375
7376 =item SEE ALSO
7377
7378 =item BUGS
7379
7380 =item HISTORY
7381
7382 =back
7383
7384 =head2 IO::Pipe - supply object methods for pipes
7385
7386 =over
7387
7388 =item SYNOPSIS
7389
7390 =item DESCRIPTION
7391
7392 =item CONSTRUCTOR
7393
7394 new ( [READER, WRITER] )
7395
7396 =item METHODS
7397
7398 reader ([ARGS]), writer ([ARGS]), handles ()
7399
7400 =item SEE ALSO
7401
7402 =item AUTHOR
7403
7404 =item COPYRIGHT
7405
7406 =back
7407
7408 =head2 IO::Poll - Object interface to system poll call
7409
7410 =over
7411
7412 =item SYNOPSIS
7413
7414 =item DESCRIPTION
7415
7416 =item METHODS
7417
7418 mask ( IO [, EVENT_MASK ] ), poll ( [ TIMEOUT ] ), events ( IO ), remove (
7419 IO ), handles( [ EVENT_MASK ] )
7420
7421 =item SEE ALSO
7422
7423 =item AUTHOR
7424
7425 =item COPYRIGHT
7426
7427 =back
7428
7429 =head2 IO::Seekable - supply seek based methods for I/O objects
7430
7431 =over
7432
7433 =item SYNOPSIS
7434
7435 =item DESCRIPTION
7436
7437 =item SEE ALSO
7438
7439 =item HISTORY
7440
7441 =back
7442
7443 =head2 IO::Select - OO interface to the select system call
7444
7445 =over
7446
7447 =item SYNOPSIS
7448
7449 =item DESCRIPTION
7450
7451 =item CONSTRUCTOR
7452
7453 new ( [ HANDLES ] )
7454
7455 =item METHODS
7456
7457 add ( HANDLES ), remove ( HANDLES ), exists ( HANDLE ), handles, can_read (
7458 [ TIMEOUT ] ), can_write ( [ TIMEOUT ] ), has_exception ( [ TIMEOUT ] ),
7459 count (), bits(), select ( READ, WRITE, ERROR [, TIMEOUT ] )
7460
7461 =item EXAMPLE
7462
7463 =item AUTHOR
7464
7465 =item COPYRIGHT
7466
7467 =back
7468
7469 =head2 IO::Socket - Object interface to socket communications
7470
7471 =over
7472
7473 =item SYNOPSIS
7474
7475 =item DESCRIPTION
7476
7477 =item CONSTRUCTOR
7478
7479 new ( [ARGS] )
7480
7481 =item METHODS
7482
7483 accept([PKG]), socketpair(DOMAIN, TYPE, PROTOCOL), timeout([VAL]),
7484 sockopt(OPT [, VAL]), sockdomain, socktype, protocol, connected
7485
7486 =item SEE ALSO
7487
7488 =item AUTHOR
7489
7490 =item COPYRIGHT
7491
7492 =back
7493
7494 =head2 IO::Socket::INET - Object interface for AF_INET domain sockets
7495
7496 =over
7497
7498 =item SYNOPSIS
7499
7500 =item DESCRIPTION
7501
7502 =item CONSTRUCTOR
7503
7504 new ( [ARGS] )
7505
7506 =over
7507
7508 =item METHODS
7509
7510 sockaddr (), sockport (), sockhost (), peeraddr (), peerport (), peerhost
7511 ()
7512
7513 =back
7514
7515 =item SEE ALSO
7516
7517 =item AUTHOR
7518
7519 =item COPYRIGHT
7520
7521 =back
7522
7523 =head2 IO::Socket::UNIX - Object interface for AF_UNIX domain sockets
7524
7525 =over
7526
7527 =item SYNOPSIS
7528
7529 =item DESCRIPTION
7530
7531 =item CONSTRUCTOR
7532
7533 new ( [ARGS] )
7534
7535 =item METHODS
7536
7537 hostpath(), peerpath()
7538
7539 =item SEE ALSO
7540
7541 =item AUTHOR
7542
7543 =item COPYRIGHT
7544
7545 =back
7546
7547 =head2 IO::lib::IO::Dir, IO::Dir - supply object methods for directory
7548 handles
7549
7550 =over
7551
7552 =item SYNOPSIS
7553
7554 =item DESCRIPTION
7555
7556 new ( [ DIRNAME ] ), open ( DIRNAME ), read (), seek ( POS ), tell (),
7557 rewind (), close (), tie %hash, IO::Dir, DIRNAME [, OPTIONS ]
7558
7559 =item SEE ALSO
7560
7561 =item AUTHOR
7562
7563 =item COPYRIGHT
7564
7565 =back
7566
7567 =head2 IO::lib::IO::File, IO::File - supply object methods for filehandles
7568
7569 =over
7570
7571 =item SYNOPSIS
7572
7573 =item DESCRIPTION
7574
7575 =item CONSTRUCTOR
7576
7577 new ( FILENAME [,MODE [,PERMS]] ), new_tmpfile
7578
7579 =item METHODS
7580
7581 open( FILENAME [,MODE [,PERMS]] )
7582
7583 =item SEE ALSO
7584
7585 =item HISTORY
7586
7587 =back
7588
7589 =head2 IO::lib::IO::Handle, IO::Handle - supply object methods for I/O
7590 handles
7591
7592 =over
7593
7594 =item SYNOPSIS
7595
7596 =item DESCRIPTION
7597
7598 =item CONSTRUCTOR
7599
7600 new (), new_from_fd ( FD, MODE )
7601
7602 =item METHODS
7603
7604 $io->fdopen ( FD, MODE ), $io->opened, $io->getline, $io->getlines,
7605 $io->ungetc ( ORD ), $io->write ( BUF, LEN [, OFFSET ] ), $io->error,
7606 $io->clearerr, $io->sync, $io->flush, $io->printflush ( ARGS ),
7607 $io->blocking ( [ BOOL ] ), $io->untaint
7608
7609 =item NOTE
7610
7611 =item SEE ALSO
7612
7613 =item BUGS
7614
7615 =item HISTORY
7616
7617 =back
7618
7619 =head2 IO::lib::IO::Pipe, IO::Pipe - supply object methods for pipes
7620
7621 =over
7622
7623 =item SYNOPSIS
7624
7625 =item DESCRIPTION
7626
7627 =item CONSTRUCTOR
7628
7629 new ( [READER, WRITER] )
7630
7631 =item METHODS
7632
7633 reader ([ARGS]), writer ([ARGS]), handles ()
7634
7635 =item SEE ALSO
7636
7637 =item AUTHOR
7638
7639 =item COPYRIGHT
7640
7641 =back
7642
7643 =head2 IO::lib::IO::Poll, IO::Poll - Object interface to system poll call
7644
7645 =over
7646
7647 =item SYNOPSIS
7648
7649 =item DESCRIPTION
7650
7651 =item METHODS
7652
7653 mask ( IO [, EVENT_MASK ] ), poll ( [ TIMEOUT ] ), events ( IO ), remove (
7654 IO ), handles( [ EVENT_MASK ] )
7655
7656 =item SEE ALSO
7657
7658 =item AUTHOR
7659
7660 =item COPYRIGHT
7661
7662 =back
7663
7664 =head2 IO::lib::IO::Seekable, IO::Seekable - supply seek based methods for
7665 I/O objects
7666
7667 =over
7668
7669 =item SYNOPSIS
7670
7671 =item DESCRIPTION
7672
7673 =item SEE ALSO
7674
7675 =item HISTORY
7676
7677 =back
7678
7679 =head2 IO::lib::IO::Select, IO::Select - OO interface to the select system
7680 call
7681
7682 =over
7683
7684 =item SYNOPSIS
7685
7686 =item DESCRIPTION
7687
7688 =item CONSTRUCTOR
7689
7690 new ( [ HANDLES ] )
7691
7692 =item METHODS
7693
7694 add ( HANDLES ), remove ( HANDLES ), exists ( HANDLE ), handles, can_read (
7695 [ TIMEOUT ] ), can_write ( [ TIMEOUT ] ), has_exception ( [ TIMEOUT ] ),
7696 count (), bits(), select ( READ, WRITE, ERROR [, TIMEOUT ] )
7697
7698 =item EXAMPLE
7699
7700 =item AUTHOR
7701
7702 =item COPYRIGHT
7703
7704 =back
7705
7706 =head2 IO::lib::IO::Socket, IO::Socket - Object interface to socket
7707 communications
7708
7709 =over
7710
7711 =item SYNOPSIS
7712
7713 =item DESCRIPTION
7714
7715 =item CONSTRUCTOR
7716
7717 new ( [ARGS] )
7718
7719 =item METHODS
7720
7721 accept([PKG]), socketpair(DOMAIN, TYPE, PROTOCOL), timeout([VAL]),
7722 sockopt(OPT [, VAL]), sockdomain, socktype, protocol, connected
7723
7724 =item SEE ALSO
7725
7726 =item AUTHOR
7727
7728 =item COPYRIGHT
7729
7730 =back
7731
7732 =head2 IO::lib::IO::Socket::INET, IO::Socket::INET - Object interface for
7733 AF_INET domain sockets
7734
7735 =over
7736
7737 =item SYNOPSIS
7738
7739 =item DESCRIPTION
7740
7741 =item CONSTRUCTOR
7742
7743 new ( [ARGS] )
7744
7745 =over
7746
7747 =item METHODS
7748
7749 sockaddr (), sockport (), sockhost (), peeraddr (), peerport (), peerhost
7750 ()
7751
7752 =back
7753
7754 =item SEE ALSO
7755
7756 =item AUTHOR
7757
7758 =item COPYRIGHT
7759
7760 =back
7761
7762 =head2 IO::lib::IO::Socket::UNIX, IO::Socket::UNIX - Object interface for
7763 AF_UNIX domain sockets
7764
7765 =over
7766
7767 =item SYNOPSIS
7768
7769 =item DESCRIPTION
7770
7771 =item CONSTRUCTOR
7772
7773 new ( [ARGS] )
7774
7775 =item METHODS
7776
7777 hostpath(), peerpath()
7778
7779 =item SEE ALSO
7780
7781 =item AUTHOR
7782
7783 =item COPYRIGHT
7784
7785 =back
7786
7787 =head2 IPC::Msg - SysV Msg IPC object class
7788
7789 =over
7790
7791 =item SYNOPSIS
7792
7793 =item DESCRIPTION
7794
7795 =item METHODS
7796
7797 new ( KEY , FLAGS ), id, rcv ( BUF, LEN [, TYPE [, FLAGS ]] ), remove, set
7798 ( STAT ), set ( NAME => VALUE [, NAME => VALUE ...] ), snd ( TYPE, MSG [,
7799 FLAGS ] ), stat
7800
7801 =item SEE ALSO
7802
7803 =item AUTHOR
7804
7805 =item COPYRIGHT
7806
7807 =back
7808
7809 =head2 IPC::Open2, open2 - open a process for both reading and writing
7810
7811 =over
7812
7813 =item SYNOPSIS
7814
7815 =item DESCRIPTION
7816
7817 =item WARNING 
7818
7819 =item SEE ALSO
7820
7821 =back
7822
7823 =head2 IPC::Open3, open3 - open a process for reading, writing, and error
7824 handling
7825
7826 =over
7827
7828 =item SYNOPSIS
7829
7830 =item DESCRIPTION
7831
7832 =item WARNING
7833
7834 =back
7835
7836 =head2 IPC::Semaphore - SysV Semaphore IPC object class
7837
7838 =over
7839
7840 =item SYNOPSIS
7841
7842 =item DESCRIPTION
7843
7844 =item METHODS
7845
7846 new ( KEY , NSEMS , FLAGS ), getall, getncnt ( SEM ), getpid ( SEM ),
7847 getval ( SEM ), getzcnt ( SEM ), id, op ( OPLIST ), remove, set ( STAT ),
7848 set ( NAME => VALUE [, NAME => VALUE ...] ), setall ( VALUES ), setval ( N
7849 , VALUE ), stat
7850
7851 =item SEE ALSO
7852
7853 =item AUTHOR
7854
7855 =item COPYRIGHT
7856
7857 =back
7858
7859 =head2 IPC::SysV - SysV IPC constants
7860
7861 =over
7862
7863 =item SYNOPSIS
7864
7865 =item DESCRIPTION
7866
7867 ftok( PATH, ID )
7868
7869 =item SEE ALSO
7870
7871 =item AUTHORS
7872
7873 =item COPYRIGHT
7874
7875 =back
7876
7877 =head2 IPC::SysV::Msg, IPC::Msg - SysV Msg IPC object class
7878
7879 =over
7880
7881 =item SYNOPSIS
7882
7883 =item DESCRIPTION
7884
7885 =item METHODS
7886
7887 new ( KEY , FLAGS ), id, rcv ( BUF, LEN [, TYPE [, FLAGS ]] ), remove, set
7888 ( STAT ), set ( NAME => VALUE [, NAME => VALUE ...] ), snd ( TYPE, MSG [,
7889 FLAGS ] ), stat
7890
7891 =item SEE ALSO
7892
7893 =item AUTHOR
7894
7895 =item COPYRIGHT
7896
7897 =back
7898
7899 =head2 IPC::SysV::Semaphore, IPC::Semaphore - SysV Semaphore IPC object
7900 class
7901
7902 =over
7903
7904 =item SYNOPSIS
7905
7906 =item DESCRIPTION
7907
7908 =item METHODS
7909
7910 new ( KEY , NSEMS , FLAGS ), getall, getncnt ( SEM ), getpid ( SEM ),
7911 getval ( SEM ), getzcnt ( SEM ), id, op ( OPLIST ), remove, set ( STAT ),
7912 set ( NAME => VALUE [, NAME => VALUE ...] ), setall ( VALUES ), setval ( N
7913 , VALUE ), stat
7914
7915 =item SEE ALSO
7916
7917 =item AUTHOR
7918
7919 =item COPYRIGHT
7920
7921 =back
7922
7923 =head2 Math::BigFloat - Arbitrary length float math package
7924
7925 =over
7926
7927 =item SYNOPSIS
7928
7929 =item DESCRIPTION
7930
7931 number format, Error returns 'NaN', Division is computed to, Rounding is
7932 performed
7933
7934 =item BUGS
7935
7936 =item AUTHOR
7937
7938 =back
7939
7940 =head2 Math::BigInt - Arbitrary size integer math package
7941
7942 =over
7943
7944 =item SYNOPSIS
7945
7946 =item DESCRIPTION
7947
7948 Canonical notation, Input, Output
7949
7950 =item EXAMPLES
7951
7952 =item Autocreating constants
7953
7954 =item BUGS
7955
7956 =item AUTHOR
7957
7958 =back
7959
7960 =head2 Math::Complex - complex numbers and associated mathematical
7961 functions
7962
7963 =over
7964
7965 =item SYNOPSIS
7966
7967 =item DESCRIPTION
7968
7969 =item OPERATIONS
7970
7971 =item CREATION
7972
7973 =item STRINGIFICATION
7974
7975 =item USAGE
7976
7977 =item ERRORS DUE TO DIVISION BY ZERO OR LOGARITHM OF ZERO
7978
7979 =item ERRORS DUE TO INDIGESTIBLE ARGUMENTS
7980
7981 =item BUGS
7982
7983 =item AUTHORS
7984
7985 =back
7986
7987 =head2 Math::Trig - trigonometric functions
7988
7989 =over
7990
7991 =item SYNOPSIS
7992
7993 =item DESCRIPTION
7994
7995 =item TRIGONOMETRIC FUNCTIONS
7996
7997 B<tan>
7998
7999 =over
8000
8001 =item ERRORS DUE TO DIVISION BY ZERO
8002
8003 =item SIMPLE (REAL) ARGUMENTS, COMPLEX RESULTS
8004
8005 =back
8006
8007 =item PLANE ANGLE CONVERSIONS
8008
8009 =item RADIAL COORDINATE CONVERSIONS
8010
8011 =over
8012
8013 =item COORDINATE SYSTEMS
8014
8015 =item 3-D ANGLE CONVERSIONS
8016
8017 cartesian_to_cylindrical, cartesian_to_spherical, cylindrical_to_cartesian,
8018 cylindrical_to_spherical, spherical_to_cartesian, spherical_to_cylindrical
8019
8020 =back
8021
8022 =item GREAT CIRCLE DISTANCES
8023
8024 =item EXAMPLES
8025
8026 =item BUGS
8027
8028 =item AUTHORS
8029
8030 =back
8031
8032 =head2 NDBM_File - Tied access to ndbm files
8033
8034 =over
8035
8036 =item SYNOPSIS
8037
8038 =item DESCRIPTION
8039
8040 =back
8041
8042 =head2 Net::Ping - check a remote host for reachability
8043
8044 =over
8045
8046 =item SYNOPSIS
8047
8048 =item DESCRIPTION
8049
8050 =over
8051
8052 =item Functions
8053
8054 Net::Ping->new([$proto [, $def_timeout [, $bytes]]]);, $p->ping($host [,
8055 $timeout]);, $p->close();, pingecho($host [, $timeout]);
8056
8057 =back
8058
8059 =item WARNING
8060
8061 =item NOTES
8062
8063 =back
8064
8065 =head2 Net::hostent - by-name interface to Perl's built-in gethost*()
8066 functions
8067
8068 =over
8069
8070 =item SYNOPSIS
8071
8072 =item DESCRIPTION
8073
8074 =item EXAMPLES
8075
8076 =item NOTE
8077
8078 =item AUTHOR
8079
8080 =back
8081
8082 =head2 Net::netent - by-name interface to Perl's built-in getnet*()
8083 functions
8084
8085 =over
8086
8087 =item SYNOPSIS
8088
8089 =item DESCRIPTION
8090
8091 =item EXAMPLES
8092
8093 =item NOTE
8094
8095 =item AUTHOR
8096
8097 =back
8098
8099 =head2 Net::protoent - by-name interface to Perl's built-in getproto*()
8100 functions
8101
8102 =over
8103
8104 =item SYNOPSIS
8105
8106 =item DESCRIPTION
8107
8108 =item NOTE
8109
8110 =item AUTHOR
8111
8112 =back
8113
8114 =head2 Net::servent - by-name interface to Perl's built-in getserv*()
8115 functions
8116
8117 =over
8118
8119 =item SYNOPSIS
8120
8121 =item DESCRIPTION
8122
8123 =item EXAMPLES
8124
8125 =item NOTE
8126
8127 =item AUTHOR
8128
8129 =back
8130
8131 =head2 O - Generic interface to Perl Compiler backends
8132
8133 =over
8134
8135 =item SYNOPSIS
8136
8137 =item DESCRIPTION
8138
8139 =item CONVENTIONS
8140
8141 =item IMPLEMENTATION
8142
8143 =item AUTHOR
8144
8145 =back
8146
8147 =head2 ODBM_File - Tied access to odbm files
8148
8149 =over
8150
8151 =item SYNOPSIS
8152
8153 =item DESCRIPTION
8154
8155 =back
8156
8157 =head2 Opcode - Disable named opcodes when compiling perl code
8158
8159 =over
8160
8161 =item SYNOPSIS
8162
8163 =item DESCRIPTION
8164
8165 =item NOTE
8166
8167 =item WARNING
8168
8169 =item Operator Names and Operator Lists
8170
8171 an operator name (opname), an operator tag name (optag), a negated opname
8172 or optag, an operator set (opset)
8173
8174 =item Opcode Functions
8175
8176 opcodes, opset (OP, ...), opset_to_ops (OPSET), opset_to_hex (OPSET),
8177 full_opset, empty_opset, invert_opset (OPSET), verify_opset (OPSET, ...),
8178 define_optag (OPTAG, OPSET), opmask_add (OPSET), opmask, opdesc (OP, ...),
8179 opdump (PAT)
8180
8181 =item Manipulating Opsets
8182
8183 =item TO DO (maybe)
8184
8185 =back
8186
8187 =over
8188
8189 =item Predefined Opcode Tags
8190
8191 :base_core, :base_mem, :base_loop, :base_io, :base_orig, :base_math,
8192 :base_thread, :default, :filesys_read, :sys_db, :browse, :filesys_open,
8193 :filesys_write, :subprocess, :ownprocess, :others, :still_to_be_decided,
8194 :dangerous
8195
8196 =item SEE ALSO
8197
8198 =item AUTHORS
8199
8200 =back
8201
8202 =head2 Opcode::Safe, Safe - Compile and execute code in restricted
8203 compartments
8204
8205 =over
8206
8207 =item SYNOPSIS
8208
8209 =item DESCRIPTION
8210
8211 a new namespace, an operator mask
8212
8213 =item WARNING
8214
8215 =over
8216
8217 =item RECENT CHANGES
8218
8219 =item Methods in class Safe
8220
8221 permit (OP, ...), permit_only (OP, ...), deny (OP, ...), deny_only (OP,
8222 ...), trap (OP, ...), untrap (OP, ...), share (NAME, ...), share_from
8223 (PACKAGE, ARRAYREF), varglob (VARNAME), reval (STRING), rdo (FILENAME),
8224 root (NAMESPACE), mask (MASK)
8225
8226 =item Some Safety Issues
8227
8228 Memory, CPU, Snooping, Signals, State Changes
8229
8230 =item AUTHOR
8231
8232 =back
8233
8234 =back
8235
8236 =head2 Opcode::ops, ops - Perl pragma to restrict unsafe operations when
8237 compiling
8238
8239 =over
8240
8241 =item SYNOPSIS  
8242
8243 =item DESCRIPTION
8244
8245 =item SEE ALSO
8246
8247 =back
8248
8249 =head2 POSIX - Perl interface to IEEE Std 1003.1
8250
8251 =over
8252
8253 =item SYNOPSIS
8254
8255 =item DESCRIPTION
8256
8257 =item NOTE
8258
8259 =item CAVEATS 
8260
8261 =item FUNCTIONS
8262
8263 _exit, abort, abs, access, acos, alarm, asctime, asin, assert, atan, atan2,
8264 atexit, atof, atoi, atol, bsearch, calloc, ceil, chdir, chmod, chown,
8265 clearerr, clock, close, closedir, cos, cosh, creat, ctermid, ctime,
8266 cuserid, difftime, div, dup, dup2, errno, execl, execle, execlp, execv,
8267 execve, execvp, exit, exp, fabs, fclose, fcntl, fdopen, feof, ferror,
8268 fflush, fgetc, fgetpos, fgets, fileno, floor, fmod, fopen, fork, fpathconf,
8269 fprintf, fputc, fputs, fread, free, freopen, frexp, fscanf, fseek, fsetpos,
8270 fstat, ftell, fwrite, getc, getchar, getcwd, getegid, getenv, geteuid,
8271 getgid, getgrgid, getgrnam, getgroups, getlogin, getpgrp, getpid, getppid,
8272 getpwnam, getpwuid, gets, getuid, gmtime, isalnum, isalpha, isatty,
8273 iscntrl, isdigit, isgraph, islower, isprint, ispunct, isspace, isupper,
8274 isxdigit, kill, labs, ldexp, ldiv, link, localeconv, localtime, log, log10,
8275 longjmp, lseek, malloc, mblen, mbstowcs, mbtowc, memchr, memcmp, memcpy,
8276 memmove, memset, mkdir, mkfifo, mktime, modf, nice, offsetof, open,
8277 opendir, pathconf, pause, perror, pipe, pow, printf, putc, putchar, puts,
8278 qsort, raise, rand, read, readdir, realloc, remove, rename, rewind,
8279 rewinddir, rmdir, scanf, setgid, setjmp, setlocale, setpgid, setsid,
8280 setuid, sigaction, siglongjmp, sigpending, sigprocmask, sigsetjmp,
8281 sigsuspend, sin, sinh, sleep, sprintf, sqrt, srand, sscanf, stat, strcat,
8282 strchr, strcmp, strcoll, strcpy, strcspn, strerror, strftime, strlen,
8283 strncat, strncmp, strncpy, stroul, strpbrk, strrchr, strspn, strstr,
8284 strtod, strtok, strtol, strtoul, strxfrm, sysconf, system, tan, tanh,
8285 tcdrain, tcflow, tcflush, tcgetpgrp, tcsendbreak, tcsetpgrp, time, times,
8286 tmpfile, tmpnam, tolower, toupper, ttyname, tzname, tzset, umask, uname,
8287 ungetc, unlink, utime, vfprintf, vprintf, vsprintf, wait, waitpid,
8288 wcstombs, wctomb, write
8289
8290 =item CLASSES
8291
8292 =over
8293
8294 =item POSIX::SigAction
8295
8296 new
8297
8298 =item POSIX::SigSet
8299
8300 new, addset, delset, emptyset, fillset, ismember
8301
8302 =item POSIX::Termios
8303
8304 new, getattr, getcc, getcflag, getiflag, getispeed, getlflag, getoflag,
8305 getospeed, setattr, setcc, setcflag, setiflag, setispeed, setlflag,
8306 setoflag, setospeed, Baud rate values, Terminal interface values, c_cc
8307 field values, c_cflag field values, c_iflag field values, c_lflag field
8308 values, c_oflag field values
8309
8310 =back
8311
8312 =item PATHNAME CONSTANTS
8313
8314 Constants
8315
8316 =item POSIX CONSTANTS
8317
8318 Constants
8319
8320 =item SYSTEM CONFIGURATION
8321
8322 Constants
8323
8324 =item ERRNO
8325
8326 Constants
8327
8328 =item FCNTL
8329
8330 Constants
8331
8332 =item FLOAT
8333
8334 Constants
8335
8336 =item LIMITS
8337
8338 Constants
8339
8340 =item LOCALE
8341
8342 Constants
8343
8344 =item MATH
8345
8346 Constants
8347
8348 =item SIGNAL
8349
8350 Constants
8351
8352 =item STAT
8353
8354 Constants, Macros
8355
8356 =item STDLIB
8357
8358 Constants
8359
8360 =item STDIO
8361
8362 Constants
8363
8364 =item TIME
8365
8366 Constants
8367
8368 =item UNISTD
8369
8370 Constants
8371
8372 =item WAIT
8373
8374 Constants, Macros
8375
8376 =item CREATION
8377
8378 =back
8379
8380 =head2 Pod::Checker, podchecker() - check pod documents for syntax errors
8381
8382 =over
8383
8384 =item SYNOPSIS
8385
8386 =item OPTIONS/ARGUMENTS
8387
8388 =over
8389
8390 =item Options
8391
8392 B<-warnings> =E<gt> I<val>
8393
8394 =back
8395
8396 =item DESCRIPTION
8397
8398 =over
8399
8400 =item Warnings
8401
8402 =back
8403
8404 =item DIAGNOSTICS
8405
8406 =item RETURN VALUE
8407
8408 =item EXAMPLES
8409
8410 =item AUTHOR
8411
8412 =back
8413
8414 =head2 Pod::Checker, Pod::Hyperlink - class for manipulation of POD
8415 hyperlinks
8416
8417 =over
8418
8419 =item SYNOPSIS
8420
8421 =item DESCRIPTION
8422
8423 =item METHODS
8424
8425 new(), parse(), markup($on,$off,$pageon,$pageoff), text(), warning(),
8426 page(), node(), type(), alttext(), line(), file()
8427
8428 =item AUTHOR
8429
8430 =back
8431
8432 =head2 Pod::Html - module to convert pod files to HTML
8433
8434 =over
8435
8436 =item SYNOPSIS
8437
8438 =item DESCRIPTION
8439
8440 =item ARGUMENTS
8441
8442 help, htmldir, htmlroot, infile, outfile, podroot, podpath, libpods,
8443 netscape, nonetscape, index, noindex, recurse, norecurse, title, css,
8444 verbose, quiet
8445
8446 =item EXAMPLE
8447
8448 =item ENVIRONMENT
8449
8450 =item AUTHOR
8451
8452 =item SEE ALSO
8453
8454 =item COPYRIGHT
8455
8456 =back
8457
8458 =head2 Pod::InputObjects - objects representing POD input paragraphs,
8459 commands, etc.
8460
8461 =over
8462
8463 =item SYNOPSIS
8464
8465 =item REQUIRES
8466
8467 =item EXPORTS
8468
8469 =item DESCRIPTION
8470
8471 B<Pod::InputSource>, B<Pod::Paragraph>, B<Pod::InteriorSequence>,
8472 B<Pod::ParseTree>
8473
8474 =back
8475
8476 =over
8477
8478 =item B<Pod::InputSource>
8479
8480 =back
8481
8482 =over
8483
8484 =item B<new()>
8485
8486 =back
8487
8488 =over
8489
8490 =item B<name()>
8491
8492 =back
8493
8494 =over
8495
8496 =item B<handle()>
8497
8498 =back
8499
8500 =over
8501
8502 =item B<was_cutting()>
8503
8504 =back
8505
8506 =over
8507
8508 =item B<Pod::Paragraph>
8509
8510 =back
8511
8512 =over
8513
8514 =item B<new()>
8515
8516 =back
8517
8518 =over
8519
8520 =item B<cmd_name()>
8521
8522 =back
8523
8524 =over
8525
8526 =item B<text()>
8527
8528 =back
8529
8530 =over
8531
8532 =item B<raw_text()>
8533
8534 =back
8535
8536 =over
8537
8538 =item B<cmd_prefix()>
8539
8540 =back
8541
8542 =over
8543
8544 =item B<cmd_separator()>
8545
8546 =back
8547
8548 =over
8549
8550 =item B<parse_tree()>
8551
8552 =back
8553
8554 =over
8555
8556 =item B<file_line()>
8557
8558 =back
8559
8560 =over
8561
8562 =item B<Pod::InteriorSequence>
8563
8564 =back
8565
8566 =over
8567
8568 =item B<new()>
8569
8570 =back
8571
8572 =over
8573
8574 =item B<cmd_name()>
8575
8576 =back
8577
8578 =over
8579
8580 =item B<prepend()>
8581
8582 =back
8583
8584 =over
8585
8586 =item B<append()>
8587
8588 =back
8589
8590 =over
8591
8592 =item B<nested()>
8593
8594 =back
8595
8596 =over
8597
8598 =item B<raw_text()>
8599
8600 =back
8601
8602 =over
8603
8604 =item B<left_delimiter()>
8605
8606 =back
8607
8608 =over
8609
8610 =item B<right_delimiter()>
8611
8612 =back
8613
8614 =over
8615
8616 =item B<parse_tree()>
8617
8618 =back
8619
8620 =over
8621
8622 =item B<file_line()>
8623
8624 =back
8625
8626 =over
8627
8628 =item B<DESTROY()>
8629
8630 =back
8631
8632 =over
8633
8634 =item B<Pod::ParseTree>
8635
8636 =back
8637
8638 =over
8639
8640 =item B<new()>
8641
8642 =back
8643
8644 =over
8645
8646 =item B<top()>
8647
8648 =back
8649
8650 =over
8651
8652 =item B<children()>
8653
8654 =back
8655
8656 =over
8657
8658 =item B<prepend()>
8659
8660 =back
8661
8662 =over
8663
8664 =item B<append()>
8665
8666 =back
8667
8668 =over
8669
8670 =item B<raw_text()>
8671
8672 =back
8673
8674 =over
8675
8676 =item B<DESTROY()>
8677
8678 =back
8679
8680 =over
8681
8682 =item SEE ALSO
8683
8684 =item AUTHOR
8685
8686 =back
8687
8688 =head2 Pod::Man - Convert POD data to formatted *roff input
8689
8690 =over
8691
8692 =item SYNOPSIS
8693
8694 =item DESCRIPTION
8695
8696 center, date, fixed, fixedbold, fixeditalic, fixedbolditalic, release,
8697 section
8698
8699 =item DIAGNOSTICS
8700
8701 roff font should be 1 or 2 chars, not `%s', Invalid link %s, Unknown escape
8702 EE<lt>%sE<gt>, Unknown sequence %s, Unmatched =back
8703
8704 =item BUGS
8705
8706 =item NOTES
8707
8708 =item SEE ALSO
8709
8710 =item AUTHOR
8711
8712 =back
8713
8714 =head2 Pod::Parser - base class for creating POD filters and translators
8715
8716 =over
8717
8718 =item SYNOPSIS
8719
8720 =item REQUIRES
8721
8722 =item EXPORTS
8723
8724 =item DESCRIPTION
8725
8726 =item QUICK OVERVIEW
8727
8728 =item PARSING OPTIONS
8729
8730 B<-want_nonPODs> (default: unset), B<-process_cut_cmd> (default: unset)
8731
8732 =back
8733
8734 =over
8735
8736 =item RECOMMENDED SUBROUTINE/METHOD OVERRIDES
8737
8738 =back
8739
8740 =over
8741
8742 =item B<command()>
8743
8744 C<$cmd>, C<$text>, C<$line_num>, C<$pod_para>
8745
8746 =back
8747
8748 =over
8749
8750 =item B<verbatim()>
8751
8752 C<$text>, C<$line_num>, C<$pod_para>
8753
8754 =back
8755
8756 =over
8757
8758 =item B<textblock()>
8759
8760 C<$text>, C<$line_num>, C<$pod_para>
8761
8762 =back
8763
8764 =over
8765
8766 =item B<interior_sequence()>
8767
8768 =back
8769
8770 =over
8771
8772 =item OPTIONAL SUBROUTINE/METHOD OVERRIDES
8773
8774 =back
8775
8776 =over
8777
8778 =item B<new()>
8779
8780 =back
8781
8782 =over
8783
8784 =item B<initialize()>
8785
8786 =back
8787
8788 =over
8789
8790 =item B<begin_pod()>
8791
8792 =back
8793
8794 =over
8795
8796 =item B<begin_input()>
8797
8798 =back
8799
8800 =over
8801
8802 =item B<end_input()>
8803
8804 =back
8805
8806 =over
8807
8808 =item B<end_pod()>
8809
8810 =back
8811
8812 =over
8813
8814 =item B<preprocess_line()>
8815
8816 =back
8817
8818 =over
8819
8820 =item B<preprocess_paragraph()>
8821
8822 =back
8823
8824 =over
8825
8826 =item METHODS FOR PARSING AND PROCESSING
8827
8828 =back
8829
8830 =over
8831
8832 =item B<parse_text()>
8833
8834 B<-expand_seq> =E<gt> I<code-ref>|I<method-name>, B<-expand_text> =E<gt>
8835 I<code-ref>|I<method-name>, B<-expand_ptree> =E<gt>
8836 I<code-ref>|I<method-name>
8837
8838 =back
8839
8840 =over
8841
8842 =item B<interpolate()>
8843
8844 =back
8845
8846 =over
8847
8848 =item B<parse_paragraph()>
8849
8850 =back
8851
8852 =over
8853
8854 =item B<parse_from_filehandle()>
8855
8856 =back
8857
8858 =over
8859
8860 =item B<parse_from_file()>
8861
8862 =back
8863
8864 =over
8865
8866 =item ACCESSOR METHODS
8867
8868 =back
8869
8870 =over
8871
8872 =item B<errorsub()>
8873
8874 =back
8875
8876 =over
8877
8878 =item B<cutting()>
8879
8880 =back
8881
8882 =over
8883
8884 =item B<parseopts()>
8885
8886 =back
8887
8888 =over
8889
8890 =item B<output_file()>
8891
8892 =back
8893
8894 =over
8895
8896 =item B<output_handle()>
8897
8898 =back
8899
8900 =over
8901
8902 =item B<input_file()>
8903
8904 =back
8905
8906 =over
8907
8908 =item B<input_handle()>
8909
8910 =back
8911
8912 =over
8913
8914 =item B<input_streams()>
8915
8916 =back
8917
8918 =over
8919
8920 =item B<top_stream()>
8921
8922 =back
8923
8924 =over
8925
8926 =item PRIVATE METHODS AND DATA
8927
8928 =back
8929
8930 =over
8931
8932 =item B<_push_input_stream()>
8933
8934 =back
8935
8936 =over
8937
8938 =item B<_pop_input_stream()>
8939
8940 =back
8941
8942 =over
8943
8944 =item TREE-BASED PARSING
8945
8946 =item SEE ALSO
8947
8948 =item AUTHOR
8949
8950 =back
8951
8952 =head2 Pod::Select, podselect() - extract selected sections of POD from
8953 input
8954
8955 =over
8956
8957 =item SYNOPSIS
8958
8959 =item REQUIRES
8960
8961 =item EXPORTS
8962
8963 =item DESCRIPTION
8964
8965 =item SECTION SPECIFICATIONS
8966
8967 =item RANGE SPECIFICATIONS
8968
8969 =back
8970
8971 =over
8972
8973 =item OBJECT METHODS
8974
8975 =back
8976
8977 =over
8978
8979 =item B<curr_headings()>
8980
8981 =back
8982
8983 =over
8984
8985 =item B<select()>
8986
8987 =back
8988
8989 =over
8990
8991 =item B<add_selection()>
8992
8993 =back
8994
8995 =over
8996
8997 =item B<clear_selections()>
8998
8999 =back
9000
9001 =over
9002
9003 =item B<match_section()>
9004
9005 =back
9006
9007 =over
9008
9009 =item B<is_selected()>
9010
9011 =back
9012
9013 =over
9014
9015 =item EXPORTED FUNCTIONS
9016
9017 =back
9018
9019 =over
9020
9021 =item B<podselect()>
9022
9023 B<-output>, B<-sections>, B<-ranges>
9024
9025 =back
9026
9027 =over
9028
9029 =item PRIVATE METHODS AND DATA
9030
9031 =back
9032
9033 =over
9034
9035 =item B<_compile_section_spec()>
9036
9037 =back
9038
9039 =over
9040
9041 =item $self->{_SECTION_HEADINGS}
9042
9043 =back
9044
9045 =over
9046
9047 =item $self->{_SELECTED_SECTIONS}
9048
9049 =back
9050
9051 =over
9052
9053 =item SEE ALSO
9054
9055 =item AUTHOR
9056
9057 =back
9058
9059 =head2 Pod::Text - Convert POD data to formatted ASCII text
9060
9061 =over
9062
9063 =item SYNOPSIS
9064
9065 =item DESCRIPTION
9066
9067 alt, indent, loose, sentence, width
9068
9069 =item DIAGNOSTICS
9070
9071 Bizarre space in item, Can't open %s for reading: %s, Unknown escape: %s,
9072 Unknown sequence: %s, Unmatched =back
9073
9074 =item RESTRICTIONS
9075
9076 =item NOTES
9077
9078 =item SEE ALSO
9079
9080 =item AUTHOR
9081
9082 =back
9083
9084 =head2 Pod::Text::Color - Convert POD data to formatted color ASCII text
9085
9086 =over
9087
9088 =item SYNOPSIS
9089
9090 =item DESCRIPTION
9091
9092 =item BUGS
9093
9094 =item SEE ALSO
9095
9096 =item AUTHOR
9097
9098 =back
9099
9100 =head2 Pod::Text::Termcap, Pod::Text::Color - Convert POD data to ASCII
9101 text with format escapes
9102
9103 =over
9104
9105 =item SYNOPSIS
9106
9107 =item DESCRIPTION
9108
9109 =item SEE ALSO
9110
9111 =item AUTHOR
9112
9113 =back
9114
9115 =head2 Pod::Usage, pod2usage() - print a usage message from embedded pod
9116 documentation
9117
9118 =over
9119
9120 =item SYNOPSIS
9121
9122 =item ARGUMENTS
9123
9124 C<-message>, C<-msg>, C<-exitval>, C<-verbose>, C<-output>, C<-input>,
9125 C<-pathlist>
9126
9127 =item DESCRIPTION
9128
9129 =item EXAMPLES
9130
9131 =over
9132
9133 =item Recommended Use
9134
9135 =back
9136
9137 =item CAVEATS
9138
9139 =item AUTHOR
9140
9141 =item ACKNOWLEDGEMENTS
9142
9143 =back
9144
9145 =head2 SDBM_File - Tied access to sdbm files
9146
9147 =over
9148
9149 =item SYNOPSIS
9150
9151 =item DESCRIPTION
9152
9153 =back
9154
9155 =head2 Safe - Compile and execute code in restricted compartments
9156
9157 =over
9158
9159 =item SYNOPSIS
9160
9161 =item DESCRIPTION
9162
9163 a new namespace, an operator mask
9164
9165 =item WARNING
9166
9167 =over
9168
9169 =item RECENT CHANGES
9170
9171 =item Methods in class Safe
9172
9173 permit (OP, ...), permit_only (OP, ...), deny (OP, ...), deny_only (OP,
9174 ...), trap (OP, ...), untrap (OP, ...), share (NAME, ...), share_from
9175 (PACKAGE, ARRAYREF), varglob (VARNAME), reval (STRING), rdo (FILENAME),
9176 root (NAMESPACE), mask (MASK)
9177
9178 =item Some Safety Issues
9179
9180 Memory, CPU, Snooping, Signals, State Changes
9181
9182 =item AUTHOR
9183
9184 =back
9185
9186 =back
9187
9188 =head2 Search::Dict, look - search for key in dictionary file
9189
9190 =over
9191
9192 =item SYNOPSIS
9193
9194 =item DESCRIPTION
9195
9196 =back
9197
9198 =head2 SelectSaver - save and restore selected file handle
9199
9200 =over
9201
9202 =item SYNOPSIS
9203
9204 =item DESCRIPTION
9205
9206 =back
9207
9208 =head2 SelfLoader - load functions only on demand
9209
9210 =over
9211
9212 =item SYNOPSIS
9213
9214 =item DESCRIPTION
9215
9216 =over
9217
9218 =item The __DATA__ token
9219
9220 =item SelfLoader autoloading
9221
9222 =item Autoloading and package lexicals
9223
9224 =item SelfLoader and AutoLoader
9225
9226 =item __DATA__, __END__, and the FOOBAR::DATA filehandle.
9227
9228 =item Classes and inherited methods.
9229
9230 =back
9231
9232 =item Multiple packages and fully qualified subroutine names
9233
9234 =back
9235
9236 =head2 Shell - run shell commands transparently within perl
9237
9238 =over
9239
9240 =item SYNOPSIS
9241
9242 =item DESCRIPTION
9243
9244 =item AUTHOR
9245
9246 =back
9247
9248 =head2 Socket, sockaddr_in, sockaddr_un, inet_aton, inet_ntoa - load the C
9249 socket.h defines and structure manipulators 
9250
9251 =over
9252
9253 =item SYNOPSIS
9254
9255 =item DESCRIPTION
9256
9257 inet_aton HOSTNAME, inet_ntoa IP_ADDRESS, INADDR_ANY, INADDR_BROADCAST,
9258 INADDR_LOOPBACK, INADDR_NONE, sockaddr_in PORT, ADDRESS, sockaddr_in
9259 SOCKADDR_IN, pack_sockaddr_in PORT, IP_ADDRESS, unpack_sockaddr_in
9260 SOCKADDR_IN, sockaddr_un PATHNAME, sockaddr_un SOCKADDR_UN,
9261 pack_sockaddr_un PATH, unpack_sockaddr_un SOCKADDR_UN
9262
9263 =back
9264
9265 =head2 Symbol - manipulate Perl symbols and their names
9266
9267 =over
9268
9269 =item SYNOPSIS
9270
9271 =item DESCRIPTION
9272
9273 =back
9274
9275 =head2 Sys::Hostname - Try every conceivable way to get hostname
9276
9277 =over
9278
9279 =item SYNOPSIS
9280
9281 =item DESCRIPTION
9282
9283 =item AUTHOR
9284
9285 =back
9286
9287 =head2 Syslog, Sys::Syslog, openlog, closelog, setlogmask, syslog - Perl
9288 interface to the UNIX syslog(3) calls
9289
9290 =over
9291
9292 =item SYNOPSIS
9293
9294 =item DESCRIPTION
9295
9296 openlog $ident, $logopt, $facility, syslog $priority, $format, @args,
9297 setlogmask $mask_priority, setlogsock $sock_type (added in 5.004_02),
9298 closelog
9299
9300 =item EXAMPLES
9301
9302 =item DEPENDENCIES
9303
9304 =item SEE ALSO
9305
9306 =item AUTHOR
9307
9308 =back
9309
9310 =head2 Term::Cap - Perl termcap interface
9311
9312 =over
9313
9314 =item SYNOPSIS
9315
9316 =item DESCRIPTION
9317
9318 =item EXAMPLES
9319
9320 =back
9321
9322 =head2 Term::Complete - Perl word completion module
9323
9324 =over
9325
9326 =item SYNOPSIS
9327
9328 =item DESCRIPTION
9329
9330 E<lt>tabE<gt>, ^D, ^U, E<lt>delE<gt>, E<lt>bsE<gt>
9331
9332 =item DIAGNOSTICS
9333
9334 =item BUGS
9335
9336 =item AUTHOR
9337
9338 =back
9339
9340 =head2 Term::ReadLine - Perl interface to various C<readline> packages. If
9341 no real package is found, substitutes stubs instead of basic functions.
9342
9343 =over
9344
9345 =item SYNOPSIS
9346
9347 =item DESCRIPTION
9348
9349 =item Minimal set of supported functions
9350
9351 C<ReadLine>, C<new>, C<readline>, C<addhistory>, C<IN>, $C<OUT>,
9352 C<MinLine>, C<findConsole>, Attribs, C<Features>
9353
9354 =item Additional supported functions
9355
9356 C<tkRunning>, C<ornaments>, C<newTTY>
9357
9358 =item EXPORTS
9359
9360 =item ENVIRONMENT
9361
9362 =back
9363
9364 =head2   Test - provides a simple framework for writing test scripts
9365
9366 =over
9367
9368 =item SYNOPSIS
9369
9370 =item DESCRIPTION
9371
9372 =item TEST TYPES
9373
9374 NORMAL TESTS, SKIPPED TESTS, TODO TESTS
9375
9376 =item RETURN VALUE
9377
9378 =item ONFAIL
9379
9380 =item SEE ALSO
9381
9382 =item AUTHOR
9383
9384 =back
9385
9386 =head2 Test::Harness - run perl standard test scripts with statistics
9387
9388 =over
9389
9390 =item SYNOPSIS
9391
9392 =item DESCRIPTION
9393
9394 =over
9395
9396 =item The test script output
9397
9398 =back
9399
9400 =item EXPORT
9401
9402 =item DIAGNOSTICS
9403
9404 C<All tests successful.\nFiles=%d,  Tests=%d, %s>, C<FAILED tests
9405 %s\n\tFailed %d/%d tests, %.2f%% okay.>, C<Test returned status %d (wstat
9406 %d)>, C<Failed 1 test, %.2f%% okay. %s>, C<Failed %d/%d tests, %.2f%% okay.
9407 %s>
9408
9409 =item ENVIRONMENT
9410
9411 =item SEE ALSO
9412
9413 =item AUTHORS
9414
9415 =item BUGS
9416
9417 =back
9418
9419 =head2 Text::Abbrev, abbrev - create an abbreviation table from a list
9420
9421 =over
9422
9423 =item SYNOPSIS
9424
9425 =item DESCRIPTION
9426
9427 =item EXAMPLE
9428
9429 =back
9430
9431 =head2 Text::ParseWords - parse text into an array of tokens or array of
9432 arrays
9433
9434 =over
9435
9436 =item SYNOPSIS
9437
9438 =item DESCRIPTION
9439
9440 =item EXAMPLES
9441
9442 0a simple word, 1multiple spaces are skipped because of our $delim, 2use of
9443 quotes to include a space in a word, 3use of a backslash to include a space
9444 in a word, 4use of a backslash to remove the special meaning of a
9445 double-quote, 5another simple word (note the lack of effect of the
9446 backslashed double-quote)
9447
9448 =item AUTHORS
9449
9450 =back
9451
9452 =head2 Text::Soundex - Implementation of the Soundex Algorithm as Described
9453 by Knuth
9454
9455 =over
9456
9457 =item SYNOPSIS
9458
9459 =item DESCRIPTION
9460
9461 =item EXAMPLES
9462
9463 =item LIMITATIONS
9464
9465 =item AUTHOR
9466
9467 =back
9468
9469 =head2 Text::Tabs -- expand and unexpand tabs per the unix expand(1) and
9470 unexpand(1)
9471
9472 =over
9473
9474 =item SYNOPSIS
9475
9476 =item DESCRIPTION
9477
9478 =item BUGS
9479
9480 =item AUTHOR
9481
9482 =back
9483
9484 =head2 Text::Wrap - line wrapping to form simple paragraphs
9485
9486 =over
9487
9488 =item SYNOPSIS 
9489
9490 =item DESCRIPTION
9491
9492 =item EXAMPLE
9493
9494 =item AUTHOR
9495
9496 =back
9497
9498 =head2 Thread - multithreading
9499
9500 =over
9501
9502 =item SYNOPSIS
9503
9504 =item DESCRIPTION
9505
9506 =item FUNCTIONS
9507
9508 new \&start_sub, new \&start_sub, LIST, lock VARIABLE, async BLOCK;,
9509 Thread->self, Thread->list, cond_wait VARIABLE, cond_signal VARIABLE,
9510 cond_broadcast VARIABLE, yield
9511
9512 =item METHODS
9513
9514 join, eval, detach, equal, tid
9515
9516 =item LIMITATIONS
9517
9518 =item SEE ALSO
9519
9520 =back
9521
9522 =head2 Thread::Queue - thread-safe queues
9523
9524 =over
9525
9526 =item SYNOPSIS
9527
9528 =item DESCRIPTION
9529
9530 =item FUNCTIONS AND METHODS
9531
9532 new, enqueue LIST, dequeue, dequeue_nb, pending
9533
9534 =item SEE ALSO
9535
9536 =back
9537
9538 =head2 Thread::Semaphore - thread-safe semaphores
9539
9540 =over
9541
9542 =item SYNOPSIS
9543
9544 =item DESCRIPTION
9545
9546 =item FUNCTIONS AND METHODS
9547
9548 new, new NUMBER, down, down NUMBER, up, up NUMBER
9549
9550 =back
9551
9552 =head2 Thread::Signal - Start a thread which runs signal handlers reliably
9553
9554 =over
9555
9556 =item SYNOPSIS
9557
9558 =item DESCRIPTION
9559
9560 =item BUGS
9561
9562 =back
9563
9564 =head2 Thread::Specific - thread-specific keys
9565
9566 =over
9567
9568 =item SYNOPSIS
9569
9570 =item DESCRIPTION
9571
9572 =back
9573
9574 =head2 Tie::Array - base class for tied arrays
9575
9576 =over
9577
9578 =item SYNOPSIS  
9579
9580 =item DESCRIPTION       
9581
9582 TIEARRAY classname, LIST, STORE this, index, value, FETCH this, index,
9583 FETCHSIZE this, STORESIZE this, count, EXTEND this, count, EXISTS this,
9584 key, DELETE this, key, CLEAR this, DESTROY this, PUSH this, LIST, POP this,
9585 SHIFT this, UNSHIFT this, LIST, SPLICE this, offset, length, LIST
9586
9587 =item CAVEATS
9588
9589 =item AUTHOR 
9590
9591 =back
9592
9593 =head2 Tie::Handle, Tie::StdHandle  - base class definitions for tied
9594 handles
9595
9596 =over
9597
9598 =item SYNOPSIS
9599
9600 =item DESCRIPTION
9601
9602 TIEHANDLE classname, LIST, WRITE this, scalar, length, offset, PRINT this,
9603 LIST, PRINTF this, format, LIST, READ this, scalar, length, offset,
9604 READLINE this, GETC this, CLOSE this, OPEN this, filename, BINMODE this,
9605 EOF this, TELL this, SEEK this, offset, whence, DESTROY this
9606
9607 =item MORE INFORMATION
9608
9609 =back
9610
9611 =head2 Tie::Hash, Tie::StdHash - base class definitions for tied hashes
9612
9613 =over
9614
9615 =item SYNOPSIS
9616
9617 =item DESCRIPTION
9618
9619 TIEHASH classname, LIST, STORE this, key, value, FETCH this, key, FIRSTKEY
9620 this, NEXTKEY this, lastkey, EXISTS this, key, DELETE this, key, CLEAR this
9621
9622 =item CAVEATS
9623
9624 =item MORE INFORMATION
9625
9626 =back
9627
9628 =head2 Tie::RefHash - use references as hash keys
9629
9630 =over
9631
9632 =item SYNOPSIS
9633
9634 =item DESCRIPTION
9635
9636 =item EXAMPLE
9637
9638 =item AUTHOR
9639
9640 =item VERSION
9641
9642 =item SEE ALSO
9643
9644 =back
9645
9646 =head2 Tie::Scalar, Tie::StdScalar - base class definitions for tied
9647 scalars
9648
9649 =over
9650
9651 =item SYNOPSIS
9652
9653 =item DESCRIPTION
9654
9655 TIESCALAR classname, LIST, FETCH this, STORE this, value, DESTROY this
9656
9657 =item MORE INFORMATION
9658
9659 =back
9660
9661 =head2 Tie::SubstrHash - Fixed-table-size, fixed-key-length hashing
9662
9663 =over
9664
9665 =item SYNOPSIS
9666
9667 =item DESCRIPTION
9668
9669 =item CAVEATS
9670
9671 =back
9672
9673 =head2 Time::Local - efficiently compute time from local and GMT time
9674
9675 =over
9676
9677 =item SYNOPSIS
9678
9679 =item DESCRIPTION
9680
9681 =item IMPLEMENTATION
9682
9683 =item BUGS
9684
9685 =back
9686
9687 =head2 Time::gmtime - by-name interface to Perl's built-in gmtime()
9688 function
9689
9690 =over
9691
9692 =item SYNOPSIS
9693
9694 =item DESCRIPTION
9695
9696 =item NOTE
9697
9698 =item AUTHOR
9699
9700 =back
9701
9702 =head2 Time::localtime - by-name interface to Perl's built-in localtime()
9703 function
9704
9705 =over
9706
9707 =item SYNOPSIS
9708
9709 =item DESCRIPTION
9710
9711 =item NOTE
9712
9713 =item AUTHOR
9714
9715 =back
9716
9717 =head2 Time::tm - internal object used by Time::gmtime and Time::localtime
9718
9719 =over
9720
9721 =item SYNOPSIS
9722
9723 =item DESCRIPTION
9724
9725 =item AUTHOR
9726
9727 =back
9728
9729 =head2 UNIVERSAL - base class for ALL classes (blessed references)
9730
9731 =over
9732
9733 =item SYNOPSIS
9734
9735 =item DESCRIPTION
9736
9737 isa ( TYPE ), can ( METHOD ), VERSION ( [ REQUIRE ] ), UNIVERSAL::isa (
9738 VAL, TYPE ), UNIVERSAL::can ( VAL, METHOD )
9739
9740 =back
9741
9742 =head2 User::grent - by-name interface to Perl's built-in getgr*()
9743 functions
9744
9745 =over
9746
9747 =item SYNOPSIS
9748
9749 =item DESCRIPTION
9750
9751 =item NOTE
9752
9753 =item AUTHOR
9754
9755 =back
9756
9757 =head2 User::pwent - by-name interface to Perl's built-in getpw*()
9758 functions
9759
9760 =over
9761
9762 =item SYNOPSIS
9763
9764 =item DESCRIPTION
9765
9766 =item NOTE
9767
9768 =item AUTHOR
9769
9770 =back
9771
9772 =head2 XSLoader - Dynamically load C libraries into Perl code
9773
9774 =over
9775
9776 =item SYNOPSIS
9777
9778 =item DESCRIPTION
9779
9780 =item AUTHOR
9781
9782 =back
9783
9784 =head1 AUXILIARY DOCUMENTATION
9785
9786 Here should be listed all the extra programs' documentation, but they
9787 don't all have manual pages yet:
9788
9789 =over
9790
9791 =item a2p
9792
9793 =item s2p
9794
9795 =item find2perl
9796
9797 =item h2ph
9798
9799 =item c2ph
9800
9801 =item h2xs
9802
9803 =item xsubpp
9804
9805 =item pod2man
9806
9807 =item wrapsuid
9808
9809 =back
9810
9811 =head1 AUTHOR
9812
9813 Larry Wall <F<larry@wall.org>>, with the help of oodles
9814 of other folks.
9815