This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
update Changes; integrate cfgperl contents into mainline
[perl5.git] / pod / perltoc.pod
1
2 =head1 NAME
3
4 perltoc - perl documentation table of contents
5
6 =head1 DESCRIPTION
7
8 This page provides a brief table of contents for the rest of the Perl
9 documentation set.  It is meant to be scanned quickly or grepped
10 through to locate the proper section you're looking for.
11
12 =head1 BASIC DOCUMENTATION
13
14 =head2 perl - Practical Extraction and Report Language
15
16 =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 <<HERE documents work?, What is the
125 difference between a list and an array?, What is the difference between
126 $array[1] and @array[1]?, How can I remove duplicate elements from a list
127 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 <*>?, Is there a
165 leak/bug in glob()?, How can I open a file with a leading ">" or trailing
166 blanks?, How can I reliably rename a file?, How can I lock a file?, Why
167 can't I just open(FH, ">file.lock")?, I still don't get locking.  I just
168 want to increment the number in the file.  How can I do this?, How do I
169 randomly update a binary file?, How do I get a file's timestamp in perl?,
170 How do I set a file's timestamp in perl?, How do I print to more than one
171 file at once?, How can I read in an entire file all at once?, How can I
172 read in a file by paragraphs?, How can I read a single character from a
173 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) = <FILE>;" work right?, How do I redefine a
214 builtin function, operator, or method?, What's the difference between
215 calling a function as &foo and foo()?, How do I create a switch or case
216 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, Task-Oriented, Special Topics
386
387 =item Perl in Magazines
388
389 =item Perl on the Net: FTP and WWW Access
390
391 =item What mailing lists are there for Perl?
392
393 =item Archives of comp.lang.perl.misc
394
395 =item Where can I buy a commercial version of Perl?
396
397 =item Where do I send bug reports?
398
399 =item What is perl.com? Perl Mongers? pm.org? perl.org?
400
401 =back
402
403 =item AUTHOR AND COPYRIGHT
404
405 =back
406
407 =head2 perlfaq3 - Programming Tools ($Revision: 1.38 $, $Date: 1999/05/23
408 16:08:30 $)
409
410 =over
411
412 =item DESCRIPTION
413
414 =over
415
416 =item How do I do (anything)?
417
418 =item How can I use Perl interactively?
419
420 =item Is there a Perl shell?
421
422 =item How do I debug my Perl programs?
423
424 =item How do I profile my Perl programs?
425
426 =item How do I cross-reference my Perl programs?
427
428 =item Is there a pretty-printer (formatter) for Perl?
429
430 =item Is there a ctags for Perl?
431
432 =item Is there an IDE or Windows Perl Editor?
433
434 =item Where can I get Perl macros for vi?
435
436 =item Where can I get perl-mode for emacs?
437
438 =item How can I use curses with Perl?
439
440 =item How can I use X or Tk with Perl?
441
442 =item How can I generate simple menus without using CGI or Tk?
443
444 =item What is undump?
445
446 =item How can I make my Perl program run faster?
447
448 =item How can I make my Perl program take less memory?
449
450 =item Is it unsafe to return a pointer to local data?
451
452 =item How can I free an array or hash so my program shrinks?
453
454 =item How can I make my CGI script more efficient?
455
456 =item How can I hide the source for my Perl program?
457
458 =item How can I compile my Perl program into byte code or C?
459
460 =item How can I compile Perl into Java?
461
462 =item How can I get C<#!perl> to work on [MS-DOS,NT,...]?
463
464 =item Can I write useful Perl programs on the command line?
465
466 =item Why don't Perl one-liners work on my DOS/Mac/VMS system?
467
468 =item Where can I learn about CGI or Web programming in Perl?
469
470 =item Where can I learn about object-oriented Perl programming?
471
472 =item Where can I learn about linking C with Perl? [h2xs, xsubpp]
473
474 =item I've read perlembed, perlguts, etc., but I can't embed perl in
475 my C program, what am I doing wrong?
476
477 =item When I tried to run my script, I got this message. What does it
478 mean?
479
480 =item What's MakeMaker?
481
482 =back
483
484 =item AUTHOR AND COPYRIGHT
485
486 =back
487
488 =head2 perlfaq4 - Data Manipulation ($Revision: 1.49 $, $Date: 1999/05/23
489 20:37:49 $)
490
491 =over
492
493 =item DESCRIPTION
494
495 =item Data: Numbers
496
497 =over
498
499 =item Why am I getting long decimals (eg, 19.9499999999999) instead of the
500 numbers I should be getting (eg, 19.95)?
501
502 =item Why isn't my octal data interpreted correctly?
503
504 =item Does Perl have a round() function?  What about ceil() and floor()? 
505 Trig functions?
506
507 =item How do I convert bits into ints?
508
509 =item Why doesn't & work the way I want it to?
510
511 =item How do I multiply matrices?
512
513 =item How do I perform an operation on a series of integers?
514
515 =item How can I output Roman numerals?
516
517 =item Why aren't my random numbers random?
518
519 =back
520
521 =item Data: Dates
522
523 =over
524
525 =item How do I find the week-of-the-year/day-of-the-year?
526
527 =item How do I find the current century or millennium?
528
529 =item How can I compare two dates and find the difference?
530
531 =item How can I take a string and turn it into epoch seconds?
532
533 =item How can I find the Julian Day?
534
535 =item How do I find yesterday's date?
536
537 =item Does Perl have a Year 2000 problem?  Is Perl Y2K compliant?
538
539 =back
540
541 =item Data: Strings
542
543 =over
544
545 =item How do I validate input?
546
547 =item How do I unescape a string?
548
549 =item How do I remove consecutive pairs of characters?
550
551 =item How do I expand function calls in a string?
552
553 =item How do I find matching/nesting anything?
554
555 =item How do I reverse a string?
556
557 =item How do I expand tabs in a string?
558
559 =item How do I reformat a paragraph?
560
561 =item How can I access/change the first N letters of a string?
562
563 =item How do I change the Nth occurrence of something?
564
565 =item How can I count the number of occurrences of a substring within a
566 string?
567
568 =item How do I capitalize all the words on one line?
569
570 =item How can I split a [character] delimited string except when inside
571 [character]? (Comma-separated files)
572
573 =item How do I strip blank space from the beginning/end of a string?
574
575 =item How do I pad a string with blanks or pad a number with zeroes?
576
577 =item How do I extract selected columns from a string?
578
579 =item How do I find the soundex value of a string?
580
581 =item How can I expand variables in text strings?
582
583 =item What's wrong with always quoting "$vars"?
584
585 =item Why don't my <<HERE documents work?
586
587 1. There must be no space after the << part, 2. There (probably) should be
588 a semicolon at the end, 3. You can't (easily) have any space in front of
589 the tag
590
591 =back
592
593 =item Data: Arrays
594
595 =over
596
597 =item What is the difference between a list and an array?
598
599 =item What is the difference between $array[1] and @array[1]?
600
601 =item How can I remove duplicate elements from a list or array?
602
603 a) If @in is sorted, and you want @out to be sorted:(this assumes all true
604 values in the array), b) If you don't know whether @in is sorted:, c) Like
605 (b), but @in contains only small integers:, d) A way to do (b) without any
606 loops or greps:, e) Like (d), but @in contains only small positive
607 integers:
608
609 =item How can I tell whether a list or array contains a certain element?
610
611 =item How do I compute the difference of two arrays?  How do I compute the
612 intersection of two arrays?
613
614 =item How do I test whether two arrays or hashes are equal?
615
616 =item How do I find the first array element for which a condition is true?
617
618 =item How do I handle linked lists?
619
620 =item How do I handle circular lists?
621
622 =item How do I shuffle an array randomly?
623
624 =item How do I process/modify each element of an array?
625
626 =item How do I select a random element from an array?
627
628 =item How do I permute N elements of a list?
629
630 =item How do I sort an array by (anything)?
631
632 =item How do I manipulate arrays of bits?
633
634 =item Why does defined() return true on empty arrays and hashes?
635
636 =back
637
638 =item Data: Hashes (Associative Arrays)
639
640 =over
641
642 =item How do I process an entire hash?
643
644 =item What happens if I add or remove keys from a hash while iterating over
645 it?
646
647 =item How do I look up a hash element by value?
648
649 =item How can I know how many entries are in a hash?
650
651 =item How do I sort a hash (optionally by value instead of key)?
652
653 =item How can I always keep my hash sorted?
654
655 =item What's the difference between "delete" and "undef" with hashes?
656
657 =item Why don't my tied hashes make the defined/exists distinction?
658
659 =item How do I reset an each() operation part-way through?
660
661 =item How can I get the unique keys from two hashes?
662
663 =item How can I store a multidimensional array in a DBM file?
664
665 =item How can I make my hash remember the order I put elements into it?
666
667 =item Why does passing a subroutine an undefined element in a hash create
668 it?
669
670 =item How can I make the Perl equivalent of a C structure/C++ class/hash or
671 array of hashes or arrays?
672
673 =item How can I use a reference as a hash key?
674
675 =back
676
677 =item Data: Misc
678
679 =over
680
681 =item How do I handle binary data correctly?
682
683 =item How do I determine whether a scalar is a number/whole/integer/float?
684
685 =item How do I keep persistent data across program calls?
686
687 =item How do I print out or copy a recursive data structure?
688
689 =item How do I define methods for every class/object?
690
691 =item How do I verify a credit card checksum?
692
693 =item How do I pack arrays of doubles or floats for XS code?
694
695 =back
696
697 =item AUTHOR AND COPYRIGHT
698
699 =back
700
701 =head2 perlfaq5 - Files and Formats ($Revision: 1.38 $, $Date: 1999/05/23
702 16:08:30 $)
703
704 =over
705
706 =item DESCRIPTION
707
708 =over
709
710 =item How do I flush/unbuffer an output filehandle?  Why must I do this?
711
712 =item How do I change one line in a file/delete a line in a file/insert a
713 line in the middle of a file/append to the beginning of a file?
714
715 =item How do I count the number of lines in a file?
716
717 =item How do I make a temporary file name?
718
719 =item How can I manipulate fixed-record-length files?
720
721 =item How can I make a filehandle local to a subroutine?  How do I pass
722 filehandles between subroutines?  How do I make an array of filehandles?
723
724 =item How can I use a filehandle indirectly?
725
726 =item How can I set up a footer format to be used with write()?
727
728 =item How can I write() into a string?
729
730 =item How can I output my numbers with commas added?
731
732 =item How can I translate tildes (~) in a filename?
733
734 =item How come when I open a file read-write it wipes it out?
735
736 =item Why do I sometimes get an "Argument list too long" when I use <*>?
737
738 =item Is there a leak/bug in glob()?
739
740 =item How can I open a file with a leading ">" or trailing blanks?
741
742 =item How can I reliably rename a file?
743
744 =item How can I lock a file?
745
746 =item Why can't I just open(FH, ">file.lock")?
747
748 =item I still don't get locking.  I just want to increment the number in
749 the file.  How can I do this?
750
751 =item How do I randomly update a binary file?
752
753 =item How do I get a file's timestamp in perl?
754
755 =item How do I set a file's timestamp in perl?
756
757 =item How do I print to more than one file at once?
758
759 =item How can I read in an entire file all at once?
760
761 =item How can I read in a file by paragraphs?
762
763 =item How can I read a single character from a file?  From the keyboard?
764
765 =item How can I tell whether there's a character waiting on a filehandle?
766
767 =item How do I do a C<tail -f> in perl?
768
769 =item How do I dup() a filehandle in Perl?
770
771 =item How do I close a file descriptor by number?
772
773 =item Why can't I use "C:\temp\foo" in DOS paths?  What doesn't
774 `C:\temp\foo.exe` work?
775
776 =item Why doesn't glob("*.*") get all the files?
777
778 =item Why does Perl let me delete read-only files?  Why does C<-i> clobber
779 protected files?  Isn't this a bug in Perl?
780
781 =item How do I select a random line from a file?
782
783 =item Why do I get weird spaces when I print an array of lines?
784
785 =back
786
787 =item AUTHOR AND COPYRIGHT
788
789 =back
790
791 =head2 perlfaq6 - Regexes ($Revision: 1.27 $, $Date: 1999/05/23 16:08:30 $)
792
793 =over
794
795 =item DESCRIPTION
796
797 =over
798
799 =item How can I hope to use regular expressions without creating illegible
800 and unmaintainable code?
801
802 Comments Outside the Regex, Comments Inside the Regex, Different Delimiters
803
804 =item I'm having trouble matching over more than one line.  What's wrong?
805
806 =item How can I pull out lines between two patterns that are themselves on
807 different lines?
808
809 =item I put a regular expression into $/ but it didn't work. What's wrong?
810
811 =item How do I substitute case insensitively on the LHS, but preserving
812 case on the RHS?
813
814 =item How can I make C<\w> match national character sets?
815
816 =item How can I match a locale-smart version of C</[a-zA-Z]/>?
817
818 =item How can I quote a variable to use in a regex?
819
820 =item What is C</o> really for?
821
822 =item How do I use a regular expression to strip C style comments from a
823 file?
824
825 =item Can I use Perl regular expressions to match balanced text?
826
827 =item What does it mean that regexes are greedy?  How can I get around it?
828
829 =item  How do I process each word on each line?
830
831 =item How can I print out a word-frequency or line-frequency summary?
832
833 =item How can I do approximate matching?
834
835 =item How do I efficiently match many regular expressions at once?
836
837 =item Why don't word-boundary searches with C<\b> work for me?
838
839 =item Why does using $&, $`, or $' slow my program down?
840
841 =item What good is C<\G> in a regular expression?
842
843 =item Are Perl regexes DFAs or NFAs?  Are they POSIX compliant?
844
845 =item What's wrong with using grep or map in a void context?
846
847 =item How can I match strings with multibyte characters?
848
849 =item How do I match a pattern that is supplied by the user?
850
851 =back
852
853 =item AUTHOR AND COPYRIGHT
854
855 =back
856
857 =head2 perlfaq7 - Perl Language Issues ($Revision: 1.28 $, $Date:
858 1999/05/23 20:36:18 $)
859
860 =over
861
862 =item DESCRIPTION
863
864 =over
865
866 =item Can I get a BNF/yacc/RE for the Perl language?
867
868 =item What are all these $@%&* punctuation signs, and how do I know when to
869 use them?
870
871 =item Do I always/never have to quote my strings or use semicolons and
872 commas?
873
874 =item How do I skip some return values?
875
876 =item How do I temporarily block warnings?
877
878 =item What's an extension?
879
880 =item Why do Perl operators have different precedence than C operators?
881
882 =item How do I declare/create a structure?
883
884 =item How do I create a module?
885
886 =item How do I create a class?
887
888 =item How can I tell if a variable is tainted?
889
890 =item What's a closure?
891
892 =item What is variable suicide and how can I prevent it?
893
894 =item How can I pass/return a {Function, FileHandle, Array, Hash, Method,
895 Regex}?
896
897 Passing Variables and Functions, Passing Filehandles, Passing Regexes,
898 Passing Methods
899
900 =item How do I create a static variable?
901
902 =item What's the difference between dynamic and lexical (static) scoping? 
903 Between local() and my()?
904
905 =item How can I access a dynamic variable while a similarly named lexical
906 is in scope?
907
908 =item What's the difference between deep and shallow binding?
909
910 =item Why doesn't "my($foo) = <FILE>;" work right?
911
912 =item How do I redefine a builtin function, operator, or method?
913
914 =item What's the difference between calling a function as &foo and foo()?
915
916 =item How do I create a switch or case statement?
917
918 =item How can I catch accesses to undefined variables/functions/methods?
919
920 =item Why can't a method included in this same file be found?
921
922 =item How can I find out my current package?
923
924 =item How can I comment out a large block of perl code?
925
926 =item How do I clear a package?
927
928 =item How can I use a variable as a variable name?
929
930 =back
931
932 =item AUTHOR AND COPYRIGHT
933
934 =back
935
936 =head2 perlfaq8 - System Interaction ($Revision: 1.39 $, $Date: 1999/05/23
937 18:37:57 $)
938
939 =over
940
941 =item DESCRIPTION
942
943 =over
944
945 =item How do I find out which operating system I'm running under?
946
947 =item How come exec() doesn't return?
948
949 =item How do I do fancy stuff with the keyboard/screen/mouse?
950
951 Keyboard, Screen, Mouse
952
953 =item How do I print something out in color?
954
955 =item How do I read just one key without waiting for a return key?
956
957 =item How do I check whether input is ready on the keyboard?
958
959 =item How do I clear the screen?
960
961 =item How do I get the screen size?
962
963 =item How do I ask the user for a password?
964
965 =item How do I read and write the serial port?
966
967 lockfiles, open mode, end of line, flushing output, non-blocking input
968
969 =item How do I decode encrypted password files?
970
971 =item How do I start a process in the background?
972
973 STDIN, STDOUT, and STDERR are shared, Signals, Zombies
974
975 =item How do I trap control characters/signals?
976
977 =item How do I modify the shadow password file on a Unix system?
978
979 =item How do I set the time and date?
980
981 =item How can I sleep() or alarm() for under a second?
982
983 =item How can I measure time under a second?
984
985 =item How can I do an atexit() or setjmp()/longjmp()? (Exception handling)
986
987 =item Why doesn't my sockets program work under System V (Solaris)? What
988 does the error message "Protocol not supported" mean?
989
990 =item How can I call my system's unique C functions from Perl?
991
992 =item Where do I get the include files to do ioctl() or syscall()?
993
994 =item Why do setuid perl scripts complain about kernel problems?
995
996 =item How can I open a pipe both to and from a command?
997
998 =item Why can't I get the output of a command with system()?
999
1000 =item How can I capture STDERR from an external command?
1001
1002 =item Why doesn't open() return an error when a pipe open fails?
1003
1004 =item What's wrong with using backticks in a void context?
1005
1006 =item How can I call backticks without shell processing?
1007
1008 =item Why can't my script read from STDIN after I gave it EOF (^D on Unix,
1009 ^Z on MS-DOS)?
1010
1011 =item How can I convert my shell script to perl?
1012
1013 =item Can I use perl to run a telnet or ftp session?
1014
1015 =item How can I write expect in Perl?
1016
1017 =item Is there a way to hide perl's command line from programs such as
1018 "ps"?
1019
1020 =item I {changed directory, modified my environment} in a perl script.  How
1021 come the change disappeared when I exited the script?  How do I get my
1022 changes to be visible?
1023
1024 Unix
1025
1026 =item How do I close a process's filehandle without waiting for it to
1027 complete?
1028
1029 =item How do I fork a daemon process?
1030
1031 =item How do I make my program run with sh and csh?
1032
1033 =item How do I find out if I'm running interactively or not?
1034
1035 =item How do I timeout a slow event?
1036
1037 =item How do I set CPU limits?
1038
1039 =item How do I avoid zombies on a Unix system?
1040
1041 =item How do I use an SQL database?
1042
1043 =item How do I make a system() exit on control-C?
1044
1045 =item How do I open a file without blocking?
1046
1047 =item How do I install a module from CPAN?
1048
1049 =item What's the difference between require and use?
1050
1051 =item How do I keep my own module/library directory?
1052
1053 =item How do I add the directory my program lives in to the module/library
1054 search path?
1055
1056 =item How do I add a directory to my include path at runtime?
1057
1058 =item What is socket.ph and where do I get it?
1059
1060 =back
1061
1062 =item AUTHOR AND COPYRIGHT
1063
1064 =back
1065
1066 =head2 perlfaq9 - Networking ($Revision: 1.26 $, $Date: 1999/05/23 16:08:30
1067 $)
1068
1069 =over
1070
1071 =item DESCRIPTION
1072
1073 =over
1074
1075 =item My CGI script runs from the command line but not the browser.   (500
1076 Server Error)
1077
1078 =item How can I get better error messages from a CGI program?
1079
1080 =item How do I remove HTML from a string?
1081
1082 =item How do I extract URLs?
1083
1084 =item How do I download a file from the user's machine?  How do I open a
1085 file on another machine?
1086
1087 =item How do I make a pop-up menu in HTML?
1088
1089 =item How do I fetch an HTML file?
1090
1091 =item How do I automate an HTML form submission?
1092
1093 =item How do I decode or create those %-encodings on the web?
1094
1095 =item How do I redirect to another page?
1096
1097 =item How do I put a password on my web pages?
1098
1099 =item How do I edit my .htpasswd and .htgroup files with Perl?
1100
1101 =item How do I make sure users can't enter values into a form that cause my
1102 CGI script to do bad things?
1103
1104 =item How do I parse a mail header?
1105
1106 =item How do I decode a CGI form?
1107
1108 =item How do I check a valid mail address?
1109
1110 =item How do I decode a MIME/BASE64 string?
1111
1112 =item How do I return the user's mail address?
1113
1114 =item How do I send mail?
1115
1116 =item How do I read mail?
1117
1118 =item How do I find out my hostname/domainname/IP address?
1119
1120 =item How do I fetch a news article or the active newsgroups?
1121
1122 =item How do I fetch/put an FTP file?
1123
1124 =item How can I do RPC in Perl?
1125
1126 =back
1127
1128 =item AUTHOR AND COPYRIGHT
1129
1130 =back
1131
1132 =head2 perldelta - what's new for perl v5.6.0
1133
1134 =over
1135
1136 =item DESCRIPTION
1137
1138 =item Incompatible Changes
1139
1140 =over
1141
1142 =item Perl Source Incompatibilities
1143
1144 CHECK is a new keyword, Treatment of list slices of undef has changed
1145
1146 =item Perl's version numbering has changed
1147
1148 Literals of the form C<1.2.3> parse differently, Possibly changed
1149 pseudo-random number generator, Hashing function for hash keys has changed,
1150 C<undef> fails on read only values, Close-on-exec bit may be set on pipe
1151 and socket handles, Writing C<"$$1"> to mean C<"${$}1"> is unsupported,
1152 delete(), values() and C<\(%h)> operate on aliases to values, not copies,
1153 vec(EXPR,OFFSET,BITS) enforces powers-of-two BITS, Text of some diagnostic
1154 output has changed, C<%@> has been removed, Parenthesized not() behaves
1155 like a list operator, Semantics of bareword prototype C<(*)> have changed
1156
1157 =item On 64-bit platforms the semantics of bit operators have changed
1158
1159 =item C Source Incompatibilities
1160
1161 C<PERL_POLLUTE>, C<PERL_IMPLICIT_CONTEXT>, C<PERL_POLLUTE_MALLOC>
1162
1163 =item Compatible C Source API Changes
1164
1165 C<PATCHLEVEL> is now C<PERL_VERSION>
1166
1167 =item Binary Incompatibilities
1168
1169 =back
1170
1171 =item Installation and Configuration Improvements
1172
1173 =over
1174
1175 =item -Dusethreads means something different
1176
1177 =item New Configure flags
1178
1179 =item Threadedness and 64-bitness now more daring
1180
1181 =item Long Doubles
1182
1183 =item -Dusemorebits
1184
1185 =item -Duselargefiles
1186
1187 =item installusrbinperl
1188
1189 =item SOCKS support
1190
1191 =item C<-A> flag
1192
1193 =item Enhanced Installation Directories
1194
1195 =back
1196
1197 =item Core Changes
1198
1199 =over
1200
1201 =item Unicode and UTF-8 support
1202
1203 =item Interpreter cloning, threads, and concurrency
1204
1205 =item Lexically scoped warning categories
1206
1207 =item Lvalue subroutines
1208
1209 =item "our" declarations
1210
1211 =item Support for strings represented as a vector of ordinals
1212
1213 =item Weak references
1214
1215 =item File globbing implemented internally
1216
1217 =item Binary numbers supported
1218
1219 =item Some arrows may be omitted in calls through references
1220
1221 =item exists() is supported on subroutine names
1222
1223 =item exists() and delete() are supported on array elements
1224
1225 =item syswrite() ease-of-use
1226
1227 =item File and directory handles can be autovivified
1228
1229 =item open() with more than two arguments
1230
1231 =item 64-bit support
1232
1233 =item Large file support
1234
1235 =item Long doubles
1236
1237 =item "more bits"
1238
1239 =item Enhanced support for sort() subroutines
1240
1241 =item Better syntax checks on parenthesized unary operators
1242
1243 =item POSIX character class syntax [: :] supported
1244
1245 =item Improved C<qw//> operator
1246
1247 =item pack() format 'Z' supported
1248
1249 =item pack() format modifier '!' supported
1250
1251 =item pack() and unpack() support counted strings
1252
1253 =item Comments in pack() templates
1254
1255 =item $^X variables may now have names longer than one character
1256
1257 =item C<use attrs> implicit in subroutine attributes
1258
1259 =item Support for interpolating named characters
1260
1261 =item C<require> and C<do> may be overridden
1262
1263 =item New variable $^C reflects C<-c> switch
1264
1265 =item New variable $^V contains Perl version as a string
1266
1267 =item Optional Y2K warnings
1268
1269 =back
1270
1271 =item Significant bug fixes
1272
1273 =over
1274
1275 =item <HANDLE> on empty files
1276
1277 =item C<eval '...'> improvements
1278
1279 =item All compilation errors are true errors
1280
1281 =item Automatic flushing of output buffers
1282
1283 =item Better diagnostics on meaningless filehandle operations
1284
1285 =item Where possible, buffered data discarded from duped input filehandle
1286
1287 =item eof() has the same old magic as <>
1288
1289 =item system(), backticks and pipe open now reflect exec() failure
1290
1291 =item Implicitly closed filehandles are safer
1292
1293 =item C<(\$)> prototype and C<$foo{a}>
1294
1295 =item Pseudo-hashes work better
1296
1297 =item C<goto &sub> and AUTOLOAD
1298
1299 =item C<-bareword> allowed under C<use integer>
1300
1301 =item Boolean assignment operators are legal lvalues
1302
1303 =item C<sort $coderef @foo> allowed
1304
1305 =item Failures in DESTROY()
1306
1307 =item Locale bugs fixed
1308
1309 =item Memory leaks
1310
1311 =item Spurious subroutine stubs after failed subroutine calls
1312
1313 =item Taint failures under C<-U>
1314
1315 =item END blocks and the C<-c> switch
1316
1317 =item Potential to leak DATA filehandles
1318
1319 =item Diagnostics follow STDERR
1320
1321 =item Other fixes for better diagnostics
1322
1323 =back
1324
1325 =item Performance enhancements
1326
1327 =over
1328
1329 =item Simple sort() using { $a <=> $b } and the like are optimized
1330
1331 =item Optimized assignments to lexical variables
1332
1333 =item Faster subroutine calls
1334
1335 =back
1336
1337 =item Platform specific changes
1338
1339 =over
1340
1341 =item Supported platforms
1342
1343 =item DOS
1344
1345 =item OS390 (OpenEdition MVS)
1346
1347 =item VMS
1348
1349 =item Win32
1350
1351 =back
1352
1353 =item New tests
1354
1355 =item Modules and Pragmata
1356
1357 =over
1358
1359 =item Modules
1360
1361 attributes, B, ByteLoader, constant, charnames, Data::Dumper, DB, DB_File,
1362 Devel::DProf, Dumpvalue, Benchmark, Devel::Peek, English, Env, Fcntl,
1363 File::Compare, File::Find, File::Glob, File::Spec, File::Spec::Functions,
1364 Getopt::Long, IO, JPL, lib, Math::BigInt, Math::Complex, Math::Trig,
1365 Pod::Parser, Pod::InputObjects, Pod::Checker, podchecker, Pod::ParseUtils,
1366 Pod::Find, Pod::Select, podselect, Pod::Usage, pod2usage, Pod::Text and
1367 Pod::Man, SDBM_File, Sys::Syslog, Sys::Hostname, Term::ANSIColor,
1368 Time::Local, Win32, DBM Filters
1369
1370 =item Pragmata
1371
1372 =back
1373
1374 =item Utility Changes
1375
1376 =over
1377
1378 =item perlcc
1379
1380 =item perldoc
1381
1382 =item The Perl Debugger
1383
1384 =back
1385
1386 =item Documentation Changes
1387
1388 perlapi.pod, perlcompile.pod, perldebug.pod, perldebguts.pod,
1389 perlfilter.pod, perlhack.pod, perlintern.pod, perlopentut.pod,
1390 perlreftut.pod, perlboot.pod, perltootc.pod, perlunicode.pod
1391
1392 =item New or Changed Diagnostics
1393
1394 "%s" variable %s masks earlier declaration in same %s, "my sub" not yet
1395 implemented, "our" variable %s redeclared, '!' allowed only after types %s,
1396 / cannot take a count, / must be followed by a, A or Z, / must be followed
1397 by a*, A* or Z*, / must follow a numeric type, /%s/: Unrecognized escape
1398 \\%c passed through, /%s/: Unrecognized escape \\%c in character class
1399 passed through, /%s/ should probably be written as "%s", %s() called too
1400 early to check prototype, %s argument is not a HASH or ARRAY element, %s
1401 argument is not a HASH or ARRAY element or slice, %s argument is not a
1402 subroutine name, %s package attribute may clash with future reserved word:
1403 %s,         (in cleanup) %s, <> should be quotes, Attempt to join self, Bad
1404 evalled substitution pattern, Bad realloc() ignored, Bareword found in
1405 conditional, Binary number > 0b11111111111111111111111111111111
1406 non-portable, Bit vector size > 32 non-portable, Buffer overflow in
1407 prime_env_iter: %s, Can't check filesystem of script "%s", Can't declare
1408 class for non-scalar %s in "%s", Can't declare %s in "%s", Can't ignore
1409 signal CHLD, forcing to default, Can't modify non-lvalue subroutine call,
1410 Can't read CRTL environ, Can't remove %s: %s, skipping file, Can't return
1411 %s from lvalue subroutine, Can't weaken a nonreference, Character class
1412 [:%s:] unknown, Character class syntax [%s] belongs inside character
1413 classes, Constant is not %s reference, constant(%s): %%^H is not localized,
1414 constant(%s): %s, CORE::%s is not a keyword, defined(@array) is deprecated,
1415 defined(%hash) is deprecated, Did not produce a valid header, Did you mean
1416 "local" instead of "our"?, Document contains no data, entering effective %s
1417 failed, false [] range "%s" in regexp, Filehandle %s opened only for
1418 output, flock() on closed filehandle %s, Global symbol "%s" requires
1419 explicit package name, Hexadecimal number > 0xffffffff non-portable,
1420 Ill-formed CRTL environ value "%s", Ill-formed message in prime_env_iter:
1421 |%s|, Illegal binary digit %s, Illegal binary digit %s ignored, Illegal
1422 number of bits in vec, Integer overflow in %s number, Invalid %s attribute:
1423 %s, Invalid %s attributes: %s, invalid [] range "%s" in regexp, Invalid
1424 separator character %s in attribute list, Invalid separator character %s in
1425 subroutine attribute list, leaving effective %s failed, Lvalue subs
1426 returning %s not implemented yet, Method %s not permitted, Missing
1427 %sbrace%s on \N{}, Missing command in piped open, Missing name in "my sub",
1428 No %s specified for -%c, No package name allowed for variable %s in "our",
1429 No space allowed after -%c, no UTC offset information; assuming local time
1430 is UTC, Octal number > 037777777777 non-portable, panic: del_backref,
1431 panic: kid popen errno read, panic: magic_killbackrefs, Parentheses missing
1432 around "%s" list, Possible Y2K bug: %s, Premature end of script headers,
1433 Repeat count in pack overflows, Repeat count in unpack overflows, realloc()
1434 of freed memory ignored, Reference is already weak, setpgrp can't take
1435 arguments, Strange *+?{} on zero-length expression, switching effective %s
1436 is not implemented, This Perl can't reset CRTL environ elements (%s), This
1437 Perl can't set CRTL environ elements (%s=%s), Unknown open() mode '%s',
1438 Unknown process %x sent message to prime_env_iter: %s, Unrecognized escape
1439 \\%c passed through, Unterminated attribute parameter in attribute list,
1440 Unterminated attribute list, Unterminated attribute parameter in subroutine
1441 attribute list, Unterminated subroutine attribute list, Value of CLI symbol
1442 "%s" too long, Version number must be a constant number
1443
1444 =item Obsolete Diagnostics
1445
1446 Character class syntax [: :] is reserved for future extensions, Ill-formed
1447 logical name |%s| in prime_env_iter, Probable precedence problem on %s,
1448 regexp too big, Use of "$$<digit>" to mean "${$}<digit>" is deprecated
1449
1450 =item BUGS
1451
1452 =item SEE ALSO
1453
1454 =item HISTORY
1455
1456 =back
1457
1458 =head2 perldata - Perl data types
1459
1460 =over
1461
1462 =item DESCRIPTION
1463
1464 =over
1465
1466 =item Variable names
1467
1468 =item Context
1469
1470 =item Scalar values
1471
1472 =item Scalar value constructors
1473
1474 =item List value constructors
1475
1476 =item Slices
1477
1478 =item Typeglobs and Filehandles
1479
1480 =back
1481
1482 =item SEE ALSO
1483
1484 =back
1485
1486 =head2 perlsyn - Perl syntax
1487
1488 =over
1489
1490 =item DESCRIPTION
1491
1492 =over
1493
1494 =item Declarations
1495
1496 =item Simple statements
1497
1498 =item Compound statements
1499
1500 =item Loop Control
1501
1502 =item For Loops
1503
1504 =item Foreach Loops
1505
1506 =item Basic BLOCKs and Switch Statements
1507
1508 =item Goto
1509
1510 =item PODs: Embedded Documentation
1511
1512 =item Plain Old Comments (Not!)
1513
1514 =back
1515
1516 =back
1517
1518 =head2 perlop - Perl operators and precedence
1519
1520 =over
1521
1522 =item SYNOPSIS
1523
1524 =item DESCRIPTION
1525
1526 =over
1527
1528 =item Terms and List Operators (Leftward)
1529
1530 =item The Arrow Operator
1531
1532 =item Auto-increment and Auto-decrement
1533
1534 =item Exponentiation
1535
1536 =item Symbolic Unary Operators
1537
1538 =item Binding Operators
1539
1540 =item Multiplicative Operators
1541
1542 =item Additive Operators
1543
1544 =item Shift Operators
1545
1546 =item Named Unary Operators
1547
1548 =item Relational Operators
1549
1550 =item Equality Operators
1551
1552 =item Bitwise And
1553
1554 =item Bitwise Or and Exclusive Or
1555
1556 =item C-style Logical And
1557
1558 =item C-style Logical Or
1559
1560 =item Range Operators
1561
1562 =item Conditional Operator
1563
1564 =item Assignment Operators
1565
1566 =item Comma Operator
1567
1568 =item List Operators (Rightward)
1569
1570 =item Logical Not
1571
1572 =item Logical And
1573
1574 =item Logical or and Exclusive Or
1575
1576 =item C Operators Missing From Perl
1577
1578 unary &, unary *, (TYPE)
1579
1580 =item Quote and Quote-like Operators
1581
1582 =item Regexp Quote-Like Operators
1583
1584 ?PATTERN?, m/PATTERN/cgimosx, /PATTERN/cgimosx, q/STRING/, C<'STRING'>,
1585 qq/STRING/, "STRING", qr/STRING/imosx, qx/STRING/, `STRING`, qw/STRING/,
1586 s/PATTERN/REPLACEMENT/egimosx, tr/SEARCHLIST/REPLACEMENTLIST/cdsUC,
1587 y/SEARCHLIST/REPLACEMENTLIST/cdsUC
1588
1589 =item Gory details of parsing quoted constructs
1590
1591 Finding the end, Removal of backslashes before delimiters, Interpolation,
1592 C<<<'EOF'>, C<m''>, C<s'''>, C<tr///>, C<y///>, C<''>, C<q//>, C<"">,
1593 C<``>, C<qq//>, C<qx//>, C<< <file*glob> >>, C<?RE?>, C</RE/>, C<m/RE/>,
1594 C<s/RE/foo/>,, Interpolation of regular expressions, Optimization of
1595 regular expressions
1596
1597 =item I/O Operators
1598
1599 =item Constant Folding
1600
1601 =item Bitwise String Operators
1602
1603 =item Integer Arithmetic
1604
1605 =item Floating-point Arithmetic
1606
1607 =item Bigger Numbers
1608
1609 =back
1610
1611 =back
1612
1613 =head2 perlre - Perl regular expressions
1614
1615 =over
1616
1617 =item DESCRIPTION
1618
1619 i, m, s, x
1620
1621 =over
1622
1623 =item Regular Expressions
1624
1625 cntrl, graph, print, punct, xdigit
1626
1627 =item Extended Patterns
1628
1629 C<(?#text)>, C<(?imsx-imsx)>, C<(?:pattern)>, C<(?imsx-imsx:pattern)>,
1630 C<(?=pattern)>, C<(?!pattern)>, C<(?<=pattern)>, C<(?<!pattern)>, C<(?{
1631 code })>, C<(??{ code })>, C<< (?>pattern) >>,
1632 C<(?(condition)yes-pattern|no-pattern)>, C<(?(condition)yes-pattern)>
1633
1634 =item Backtracking
1635
1636 =item Version 8 Regular Expressions
1637
1638 =item Warning on \1 vs $1
1639
1640 =item Repeated patterns matching zero-length substring
1641
1642 =item Combining pieces together
1643
1644 C<ST>, C<S|T>, C<S{REPEAT_COUNT}>, C<S{min,max}>, C<S{min,max}?>, C<S?>,
1645 C<S*>, C<S+>, C<S??>, C<S*?>, C<S+?>, C<< (?>S) >>, C<(?=S)>, C<(?<=S)>,
1646 C<(?!S)>, C<(?<!S)>, C<(??{ EXPR })>,
1647 C<(?(condition)yes-pattern|no-pattern)>
1648
1649 =item Creating custom RE engines
1650
1651 =back
1652
1653 =item BUGS
1654
1655 =item SEE ALSO
1656
1657 =back
1658
1659 =head2 perlrun - how to execute the Perl interpreter
1660
1661 =over
1662
1663 =item SYNOPSIS
1664
1665 =item DESCRIPTION
1666
1667 =over
1668
1669 =item #! and quoting on non-Unix systems
1670
1671 OS/2, MS-DOS, Win95/NT, Macintosh, VMS
1672
1673 =item Location of Perl
1674
1675 =item Command Switches
1676
1677 B<-0>[I<digits>], B<-a>, B<-C>, B<-c>, B<-d>, B<-d:>I<foo>,
1678 B<-D>I<letters>, B<-D>I<number>, B<-e> I<commandline>, B<-F>I<pattern>,
1679 B<-h>, B<-i>[I<extension>], B<-I>I<directory>, B<-l>[I<octnum>],
1680 B<-m>[B<->]I<module>, B<-M>[B<->]I<module>, B<-M>[B<->]I<'module ...'>,
1681 B<-[mM]>[B<->]I<module=arg[,arg]...>, B<-n>, B<-p>, B<-P>, B<-s>, B<-S>,
1682 B<-T>, B<-u>, B<-U>, B<-v>, B<-V>, B<-V:>I<name>, B<-w>, B<-W>, B<-X>,
1683 B<-x> I<directory>
1684
1685 =back
1686
1687 =item ENVIRONMENT
1688
1689 HOME, LOGDIR, PATH, PERL5LIB, PERL5OPT, PERLLIB, PERL5DB, PERL5SHELL
1690 (specific to the Win32 port), PERL_DEBUG_MSTATS, PERL_DESTRUCT_LEVEL
1691
1692 =back
1693
1694 =head2 perlfunc - Perl builtin functions
1695
1696 =over
1697
1698 =item DESCRIPTION
1699
1700 =over
1701
1702 =item Perl Functions by Category
1703
1704 Functions for SCALARs or strings, Regular expressions and pattern matching,
1705 Numeric functions, Functions for real @ARRAYs, Functions for list data,
1706 Functions for real %HASHes, Input and output functions, Functions for fixed
1707 length data or records, Functions for filehandles, files, or directories,
1708 Keywords related to the control flow of your perl program, Keywords related
1709 to scoping, Miscellaneous functions, Functions for processes and process
1710 groups, Keywords related to perl modules, Keywords related to classes and
1711 object-orientedness, Low-level socket functions, System V interprocess
1712 communication functions, Fetching user and group info, Fetching network
1713 info, Time-related functions, Functions new in perl5, Functions obsoleted
1714 in perl5
1715
1716 =item Portability
1717
1718 =item Alphabetical Listing of Perl Functions
1719
1720 I<-X> FILEHANDLE, I<-X> EXPR, I<-X>, abs VALUE, abs, accept
1721 NEWSOCKET,GENERICSOCKET, alarm SECONDS, alarm, atan2 Y,X, bind SOCKET,NAME,
1722 binmode FILEHANDLE, DISCIPLINE, binmode FILEHANDLE, bless REF,CLASSNAME,
1723 bless REF, caller EXPR, caller, chdir EXPR, chmod LIST, chomp VARIABLE,
1724 chomp LIST, chomp, chop VARIABLE, chop LIST, chop, chown LIST, chr NUMBER,
1725 chr, chroot FILENAME, chroot, close FILEHANDLE, close, closedir DIRHANDLE,
1726 connect SOCKET,NAME, continue BLOCK, cos EXPR, crypt PLAINTEXT,SALT,
1727 dbmclose HASH, dbmopen HASH,DBNAME,MASK, defined EXPR, defined, delete
1728 EXPR, die LIST, do BLOCK, do SUBROUTINE(LIST), do EXPR, dump LABEL, dump,
1729 each HASH, eof FILEHANDLE, eof (), eof, eval EXPR, eval BLOCK, exec LIST,
1730 exec PROGRAM LIST, exists EXPR, exit EXPR, exp EXPR, exp, fcntl
1731 FILEHANDLE,FUNCTION,SCALAR, fileno FILEHANDLE, flock FILEHANDLE,OPERATION,
1732 fork, format, formline PICTURE,LIST, getc FILEHANDLE, getc, getlogin,
1733 getpeername SOCKET, getpgrp PID, getppid, getpriority WHICH,WHO, getpwnam
1734 NAME, getgrnam NAME, gethostbyname NAME, getnetbyname NAME, getprotobyname
1735 NAME, getpwuid UID, getgrgid GID, getservbyname NAME,PROTO, gethostbyaddr
1736 ADDR,ADDRTYPE, getnetbyaddr ADDR,ADDRTYPE, getprotobynumber NUMBER,
1737 getservbyport PORT,PROTO, getpwent, getgrent, gethostent, getnetent,
1738 getprotoent, getservent, setpwent, setgrent, sethostent STAYOPEN, setnetent
1739 STAYOPEN, setprotoent STAYOPEN, setservent STAYOPEN, endpwent, endgrent,
1740 endhostent, endnetent, endprotoent, endservent, getsockname SOCKET,
1741 getsockopt SOCKET,LEVEL,OPTNAME, glob EXPR, glob, gmtime EXPR, goto LABEL,
1742 goto EXPR, goto &NAME, grep BLOCK LIST, grep EXPR,LIST, hex EXPR, hex,
1743 import, index STR,SUBSTR,POSITION, index STR,SUBSTR, int EXPR, int, ioctl
1744 FILEHANDLE,FUNCTION,SCALAR, join EXPR,LIST, keys HASH, kill SIGNAL, LIST,
1745 last LABEL, last, lc EXPR, lc, lcfirst EXPR, lcfirst, length EXPR, length,
1746 link OLDFILE,NEWFILE, listen SOCKET,QUEUESIZE, local EXPR, localtime EXPR,
1747 lock, log EXPR, log, lstat FILEHANDLE, lstat EXPR, lstat, m//, map BLOCK
1748 LIST, map EXPR,LIST, mkdir FILENAME,MASK, mkdir FILENAME, msgctl
1749 ID,CMD,ARG, msgget KEY,FLAGS, msgsnd ID,MSG,FLAGS, msgrcv
1750 ID,VAR,SIZE,TYPE,FLAGS, my EXPR, my EXPR : ATTRIBUTES, next LABEL, next, no
1751 Module LIST, oct EXPR, oct, open FILEHANDLE,MODE,LIST, open
1752 FILEHANDLE,EXPR, open FILEHANDLE, opendir DIRHANDLE,EXPR, ord EXPR, ord,
1753 our EXPR, pack TEMPLATE,LIST, package, package NAMESPACE, pipe
1754 READHANDLE,WRITEHANDLE, pop ARRAY, pop, pos SCALAR, pos, print FILEHANDLE
1755 LIST, print LIST, print, printf FILEHANDLE FORMAT, LIST, printf FORMAT,
1756 LIST, prototype FUNCTION, push ARRAY,LIST, q/STRING/, qq/STRING/,
1757 qr/STRING/, qx/STRING/, qw/STRING/, quotemeta EXPR, quotemeta, rand EXPR,
1758 rand, read FILEHANDLE,SCALAR,LENGTH,OFFSET, read FILEHANDLE,SCALAR,LENGTH,
1759 readdir DIRHANDLE, readline EXPR, readlink EXPR, readlink, readpipe EXPR,
1760 recv SOCKET,SCALAR,LENGTH,FLAGS, redo LABEL, redo, ref EXPR, ref, rename
1761 OLDNAME,NEWNAME, require VERSION, require EXPR, require, reset EXPR, reset,
1762 return EXPR, return, reverse LIST, rewinddir DIRHANDLE, rindex
1763 STR,SUBSTR,POSITION, rindex STR,SUBSTR, rmdir FILENAME, rmdir, s///, scalar
1764 EXPR, seek FILEHANDLE,POSITION,WHENCE, seekdir DIRHANDLE,POS, select
1765 FILEHANDLE, select, select RBITS,WBITS,EBITS,TIMEOUT, semctl
1766 ID,SEMNUM,CMD,ARG, semget KEY,NSEMS,FLAGS, semop KEY,OPSTRING, send
1767 SOCKET,MSG,FLAGS,TO, send SOCKET,MSG,FLAGS, setpgrp PID,PGRP, setpriority
1768 WHICH,WHO,PRIORITY, setsockopt SOCKET,LEVEL,OPTNAME,OPTVAL, shift ARRAY,
1769 shift, shmctl ID,CMD,ARG, shmget KEY,SIZE,FLAGS, shmread ID,VAR,POS,SIZE,
1770 shmwrite ID,STRING,POS,SIZE, shutdown SOCKET,HOW, sin EXPR, sin, sleep
1771 EXPR, sleep, socket SOCKET,DOMAIN,TYPE,PROTOCOL, socketpair
1772 SOCKET1,SOCKET2,DOMAIN,TYPE,PROTOCOL, sort SUBNAME LIST, sort BLOCK LIST,
1773 sort LIST, splice ARRAY,OFFSET,LENGTH,LIST, splice ARRAY,OFFSET,LENGTH,
1774 splice ARRAY,OFFSET, splice ARRAY, split /PATTERN/,EXPR,LIMIT, split
1775 /PATTERN/,EXPR, split /PATTERN/, split, sprintf FORMAT, LIST, sqrt EXPR,
1776 sqrt, srand EXPR, srand, stat FILEHANDLE, stat EXPR, stat, study SCALAR,
1777 study, sub BLOCK, sub NAME, sub NAME BLOCK, substr
1778 EXPR,OFFSET,LENGTH,REPLACEMENT, substr EXPR,OFFSET,LENGTH, substr
1779 EXPR,OFFSET, symlink OLDFILE,NEWFILE, syscall LIST, sysopen
1780 FILEHANDLE,FILENAME,MODE, sysopen FILEHANDLE,FILENAME,MODE,PERMS, sysread
1781 FILEHANDLE,SCALAR,LENGTH,OFFSET, sysread FILEHANDLE,SCALAR,LENGTH, sysseek
1782 FILEHANDLE,POSITION,WHENCE, system LIST, system PROGRAM LIST, syswrite
1783 FILEHANDLE,SCALAR,LENGTH,OFFSET, syswrite FILEHANDLE,SCALAR,LENGTH,
1784 syswrite FILEHANDLE,SCALAR, tell FILEHANDLE, tell, telldir DIRHANDLE, tie
1785 VARIABLE,CLASSNAME,LIST, tied VARIABLE, time, times, tr///, truncate
1786 FILEHANDLE,LENGTH, truncate EXPR,LENGTH, uc EXPR, uc, ucfirst EXPR,
1787 ucfirst, umask EXPR, umask, undef EXPR, undef, unlink LIST, unlink, unpack
1788 TEMPLATE,EXPR, untie VARIABLE, unshift ARRAY,LIST, use Module VERSION LIST,
1789 use Module VERSION, use Module LIST, use Module, use VERSION, utime LIST,
1790 values HASH, vec EXPR,OFFSET,BITS, wait, waitpid PID,FLAGS, wantarray, warn
1791 LIST, write FILEHANDLE, write EXPR, write, y///
1792
1793 =back
1794
1795 =back
1796
1797 =head2 perlvar - Perl predefined variables
1798
1799 =over
1800
1801 =item DESCRIPTION
1802
1803 =over
1804
1805 =item Predefined Names
1806
1807 $ARG, $_, $<I<digits>>, $MATCH, $&, $PREMATCH, $`, $POSTMATCH, $',
1808 $LAST_PAREN_MATCH, $+, @+, $MULTILINE_MATCHING, $*, input_line_number
1809 HANDLE EXPR, $INPUT_LINE_NUMBER, $NR, $, input_record_separator HANDLE
1810 EXPR, $INPUT_RECORD_SEPARATOR, $RS, $/, autoflush HANDLE EXPR,
1811 $OUTPUT_AUTOFLUSH, $|, output_field_separator HANDLE EXPR,
1812 $OUTPUT_FIELD_SEPARATOR, $OFS, $,, output_record_separator HANDLE EXPR,
1813 $OUTPUT_RECORD_SEPARATOR, $ORS, $\, $LIST_SEPARATOR, $",
1814 $SUBSCRIPT_SEPARATOR, $SUBSEP, $;, $OFMT, $#, format_page_number HANDLE
1815 EXPR, $FORMAT_PAGE_NUMBER, $%, format_lines_per_page HANDLE EXPR,
1816 $FORMAT_LINES_PER_PAGE, $=, format_lines_left HANDLE EXPR,
1817 $FORMAT_LINES_LEFT, $-, @-, C<$`> is the same as C<substr($var, 0, $-[0]>),
1818 C<$&> is the same as C<substr($var, $-[0], $+[0] - $-[0]>), C<$'> is the
1819 same as C<substr($var, $+[0]>), C<$1> is the same as C<substr($var, $-[1],
1820 $+[1] - $-[1])>, C<$2> is the same as C<substr($var, $-[2], $+[2] -
1821 $-[2])>, C<$3> is the same as C<substr $var, $-[3], $+[3] - $-[3]>),
1822 format_name HANDLE EXPR, $FORMAT_NAME, $~, format_top_name HANDLE EXPR,
1823 $FORMAT_TOP_NAME, $^, format_line_break_characters HANDLE EXPR,
1824 $FORMAT_LINE_BREAK_CHARACTERS, $:, format_formfeed HANDLE EXPR,
1825 $FORMAT_FORMFEED, $^L, $ACCUMULATOR, $^A, $CHILD_ERROR, $?, $OS_ERROR,
1826 $ERRNO, $!, $EXTENDED_OS_ERROR, $^E, $EVAL_ERROR, $@, $PROCESS_ID, $PID,
1827 $$, $REAL_USER_ID, $UID, $<, $EFFECTIVE_USER_ID, $EUID, $>, $REAL_GROUP_ID,
1828 $GID, $(, $EFFECTIVE_GROUP_ID, $EGID, $), $PROGRAM_NAME, $0, $[, $],
1829 $COMPILING, $^C, $DEBUGGING, $^D, $SYSTEM_FD_MAX, $^F, $^H, %^H,
1830 $INPLACE_EDIT, $^I, $^M, $OSNAME, $^O, $PERLDB, $^P, 0x01, 0x02, 0x04,
1831 0x08, 0x10, 0x20, 0x40, 0x80, 0x100, 0x200, $LAST_REGEXP_CODE_RESULT, $^R,
1832 $EXCEPTIONS_BEING_CAUGHT, $^S, $BASETIME, $^T, $PERL_VERSION, $^V,
1833 $WARNING, $^W, ${^WARNING_BITS}, ${^WIDE_SYSTEM_CALLS}, $EXECUTABLE_NAME,
1834 $^X, $ARGV, @ARGV, @INC, @_, %INC, %ENV, $ENV{expr}, %SIG, $SIG{expr}
1835
1836 =item Error Indicators
1837
1838 =item Technical Note on the Syntax of Variable Names
1839
1840 =back
1841
1842 =item BUGS
1843
1844 =back
1845
1846 =head2 perlsub - Perl subroutines
1847
1848 =over
1849
1850 =item SYNOPSIS
1851
1852 =item DESCRIPTION
1853
1854 =over
1855
1856 =item Private Variables via my()
1857
1858 =item Persistent Private Variables
1859
1860 =item Temporary Values via local()
1861
1862 =item Lvalue subroutines
1863
1864 =item Passing Symbol Table Entries (typeglobs)
1865
1866 =item When to Still Use local()
1867
1868 1. You need to give a global variable a temporary value, especially $_, 2.
1869 You need to create a local file or directory handle or a local function, 3.
1870 You want to temporarily change just one element of an array or hash
1871
1872 =item Pass by Reference
1873
1874 =item Prototypes
1875
1876 =item Constant Functions
1877
1878 =item Overriding Built-in Functions
1879
1880 =item Autoloading
1881
1882 =item Subroutine Attributes
1883
1884 =back
1885
1886 =item SEE ALSO
1887
1888 =back
1889
1890 =head2 perlmod - Perl modules (packages and symbol tables)
1891
1892 =over
1893
1894 =item DESCRIPTION
1895
1896 =over
1897
1898 =item Packages
1899
1900 =item Symbol Tables
1901
1902 =item Package Constructors and Destructors
1903
1904 =item Perl Classes
1905
1906 =item Perl Modules
1907
1908 =back
1909
1910 =item SEE ALSO
1911
1912 =back
1913
1914 =head2 perlmodlib - constructing new Perl modules and finding existing ones
1915
1916 =over
1917
1918 =item DESCRIPTION
1919
1920 =item THE PERL MODULE LIBRARY
1921
1922 =over
1923
1924 =item Pragmatic Modules
1925
1926 attributes, attrs, autouse, base, blib, caller, charnames, constant,
1927 diagnostics, fields, filetest, integer, less, lib, locale, ops, overload,
1928 re, sigtrap, strict, subs, utf8, vars, warnings
1929
1930 =item Standard Modules
1931
1932 AnyDBM_File, AutoLoader, AutoSplit, B, B::Asmdata, B::Assembler, B::Bblock,
1933 B::Bytecode, B::C, B::CC, B::Debug, B::Deparse, B::Disassembler, B::Lint,
1934 B::Showlex, B::Stackobj, B::Terse, B::Xref, Benchmark, ByteLoader, CGI,
1935 CGI::Apache, CGI::Carp, CGI::Cookie, CGI::Fast, CGI::Pretty, CGI::Push,
1936 CGI::Switch, CPAN, CPAN::FirstTime, CPAN::Nox, Carp, Carp::Heavy,
1937 Class::Struct, Config, Cwd, DB, DB_File, Data::Dumper, Devel::DProf,
1938 Devel::Peek, Devel::SelfStubber, DirHandle, Dumpvalue, DynaLoader, English,
1939 Env, Errno, Exporter, Exporter::Heavy, ExtUtils::Command, ExtUtils::Embed,
1940 ExtUtils::Install, ExtUtils::Installed, ExtUtils::Liblist,
1941 ExtUtils::MM_Cygwin, ExtUtils::MM_OS2, ExtUtils::MM_Unix, ExtUtils::MM_VMS,
1942 ExtUtils::MM_Win32, ExtUtils::MakeMaker, ExtUtils::Manifest,
1943 ExtUtils::Mkbootstrap, ExtUtils::Mksymlists, ExtUtils::Packlist,
1944 ExtUtils::testlib, Fatal, Fcntl, File::Basename, File::CheckTree,
1945 File::Compare, File::Copy, File::DosGlob, File::Find, File::Glob,
1946 File::Path, File::Spec, File::Spec::Functions, File::Spec::Mac,
1947 File::Spec::OS2, File::Spec::Unix, File::Spec::VMS, File::Spec::Win32,
1948 File::stat, FileCache, FileHandle, FindBin, GDBM_File, Getopt::Long,
1949 Getopt::Std, I18N::Collate, IO, IO::Dir, IO::File, IO::Handle, IO::Pipe,
1950 IO::Poll, IO::Seekable, IO::Select, IO::Socket, IO::Socket::INET,
1951 IO::Socket::UNIX, IPC::Msg, IPC::Open2, IPC::Open3, IPC::Semaphore,
1952 IPC::SysV, Math::BigFloat, Math::BigInt, Math::Complex, Math::Trig,
1953 Net::Ping, Net::hostent, Net::netent, Net::protoent, Net::servent, O,
1954 Opcode, POSIX, Pod::Checker, Pod::Html, Pod::InputObjects, Pod::Man,
1955 Pod::Parser, Pod::Select, Pod::Text, Pod::Text::Color, Pod::Usage,
1956 SDBM_File, Safe, Search::Dict, SelectSaver, SelfLoader, Shell, Socket,
1957 Symbol, Sys::Hostname, Sys::Syslog, Term::Cap, Term::Complete,
1958 Term::ReadLine, Test, Test::Harness, Text::Abbrev, Text::ParseWords,
1959 Text::Soundex, Text::Wrap, Tie::Array, Tie::Handle, Tie::Hash,
1960 Tie::RefHash, Tie::Scalar, Tie::SubstrHash, Time::Local, Time::gmtime,
1961 Time::localtime, Time::tm, UNIVERSAL, User::grent, User::pwent
1962
1963 =item Extension Modules
1964
1965 =back
1966
1967 =item CPAN
1968
1969 Language Extensions and Documentation Tools, Development Support, Operating
1970 System Interfaces, Networking, Device Control (modems) and InterProcess
1971 Communication, Data Types and Data Type Utilities, Database Interfaces,
1972 User Interfaces, Interfaces to / Emulations of Other Programming Languages,
1973 File Names, File Systems and File Locking (see also File Handles), String
1974 Processing, Language Text Processing, Parsing, and Searching, Option,
1975 Argument, Parameter, and Configuration File Processing,
1976 Internationalization and Locale, Authentication, Security, and Encryption,
1977 World Wide Web, HTML, HTTP, CGI, MIME, Server and Daemon Utilities,
1978 Archiving and Compression, Images, Pixmap and Bitmap Manipulation, Drawing,
1979 and Graphing, Mail and Usenet News, Control Flow Utilities (callbacks and
1980 exceptions etc), File Handle and Input/Output Stream Utilities,
1981 Miscellaneous Modules, Africa, Asia, Australasia, Central America, Europe,
1982 North America, South America
1983
1984 =item Modules: Creation, Use, and Abuse
1985
1986 =over
1987
1988 =item Guidelines for Module Creation
1989
1990 Do similar modules already exist in some form?, Try to design the new
1991 module to be easy to extend and reuse, Some simple style guidelines, Select
1992 what to export, Select a name for the module, Have you got it right?,
1993 README and other Additional Files, A description of the
1994 module/package/extension etc, A copyright notice - see below, Prerequisites
1995 - what else you may need to have, How to build it - possible changes to
1996 Makefile.PL etc, How to install it, Recent changes in this release,
1997 especially incompatibilities, Changes / enhancements you plan to make in
1998 the future, Adding a Copyright Notice, Give the module a
1999 version/issue/release number, How to release and distribute a module, Take
2000 care when changing a released module
2001
2002 =item Guidelines for Converting Perl 4 Library Scripts into Modules
2003
2004 There is no requirement to convert anything, Consider the implications,
2005 Make the most of the opportunity, The pl2pm utility will get you started,
2006 Adds the standard Module prologue lines, Converts package specifiers from '
2007 to ::, Converts die(...) to croak(...), Several other minor changes
2008
2009 =item Guidelines for Reusing Application Code
2010
2011 Complete applications rarely belong in the Perl Module Library, Many
2012 applications contain some Perl code that could be reused, Break-out the
2013 reusable code into one or more separate module files, Take the opportunity
2014 to reconsider and redesign the interfaces, In some cases the 'application'
2015 can then be reduced to a small
2016
2017 =back
2018
2019 =item NOTE
2020
2021 =back
2022
2023 =head2 perlmodinstall - Installing CPAN Modules
2024
2025 =over
2026
2027 =item DESCRIPTION
2028
2029 =over
2030
2031 =item PREAMBLE
2032
2033 B<DECOMPRESS> the file, B<UNPACK> the file into a directory, B<BUILD> the
2034 module (sometimes unnecessary), B<INSTALL> the module
2035
2036 =back
2037
2038 =item HEY
2039
2040 =item AUTHOR
2041
2042 =item COPYRIGHT
2043
2044 =back
2045
2046 =head2 perlfork - Perl's fork() emulation
2047
2048 =over
2049
2050 =item SYNOPSIS
2051
2052 =item DESCRIPTION
2053
2054 =over
2055
2056 =item Behavior of other Perl features in forked pseudo-processes
2057
2058 $$ or $PROCESS_ID, %ENV, chdir() and all other builtins that accept
2059 filenames, wait() and waitpid(), kill(), exec(), exit(), Open handles to
2060 files, directories and network sockets
2061
2062 =item Resource limits
2063
2064 =item Killing the parent process
2065
2066 =item Lifetime of the parent process and pseudo-processes
2067
2068 =item CAVEATS AND LIMITATIONS
2069
2070 BEGIN blocks, Open filehandles, Forking pipe open() not yet implemented,
2071 Global state maintained by XSUBs, Interpreter embedded in larger
2072 application, Thread-safety of extensions
2073
2074 =back
2075
2076 =item BUGS
2077
2078 =item AUTHOR
2079
2080 =item SEE ALSO
2081
2082 =back
2083
2084 =head2 perlform - Perl formats
2085
2086 =over
2087
2088 =item DESCRIPTION
2089
2090 =over
2091
2092 =item Format Variables
2093
2094 =back
2095
2096 =item NOTES
2097
2098 =over
2099
2100 =item Footers
2101
2102 =item Accessing Formatting Internals
2103
2104 =back
2105
2106 =item WARNINGS
2107
2108 =back
2109
2110 =head2 perllocale - Perl locale handling (internationalization and
2111 localization)
2112
2113 =over
2114
2115 =item DESCRIPTION
2116
2117 =item PREPARING TO USE LOCALES
2118
2119 =item USING LOCALES
2120
2121 =over
2122
2123 =item The use locale pragma
2124
2125 =item The setlocale function
2126
2127 =item Finding locales
2128
2129 =item LOCALE PROBLEMS
2130
2131 =item Temporarily fixing locale problems
2132
2133 =item Permanently fixing locale problems
2134
2135 =item Permanently fixing your system's locale configuration
2136
2137 =item Fixing system locale configuration
2138
2139 =item The localeconv function
2140
2141 =back
2142
2143 =item LOCALE CATEGORIES
2144
2145 =over
2146
2147 =item Category LC_COLLATE: Collation
2148
2149 =item Category LC_CTYPE: Character Types
2150
2151 =item Category LC_NUMERIC: Numeric Formatting
2152
2153 =item Category LC_MONETARY: Formatting of monetary amounts
2154
2155 =item LC_TIME
2156
2157 =item Other categories
2158
2159 =back
2160
2161 =item SECURITY
2162
2163 B<Comparison operators> (C<lt>, C<le>, C<ge>, C<gt> and C<cmp>):,
2164 B<Case-mapping interpolation> (with C<\l>, C<\L>, C<\u> or C<\U>),
2165 B<Matching operator> (C<m//>):, B<Substitution operator> (C<s///>):,
2166 B<Output formatting functions> (printf() and write()):, B<Case-mapping
2167 functions> (lc(), lcfirst(), uc(), ucfirst()):, B<POSIX locale-dependent
2168 functions> (localeconv(), strcoll(),strftime(), strxfrm()):, B<POSIX
2169 character class tests> (isalnum(), isalpha(), isdigit(),isgraph(),
2170 islower(), isprint(), ispunct(), isspace(), isupper(),
2171 isxdigit()):
2172
2173 =item ENVIRONMENT
2174
2175 PERL_BADLANG, LC_ALL, LANGUAGE, LC_CTYPE, LC_COLLATE, LC_MONETARY,
2176 LC_NUMERIC, LC_TIME, LANG
2177
2178 =item NOTES
2179
2180 =over
2181
2182 =item Backward compatibility
2183
2184 =item I18N:Collate obsolete
2185
2186 =item Sort speed and memory use impacts
2187
2188 =item write() and LC_NUMERIC
2189
2190 =item Freely available locale definitions
2191
2192 =item I18n and l10n
2193
2194 =item An imperfect standard
2195
2196 =back
2197
2198 =item BUGS
2199
2200 =over
2201
2202 =item Broken systems
2203
2204 =back
2205
2206 =item SEE ALSO
2207
2208 =item HISTORY
2209
2210 =back
2211
2212 =head2 perlref - Perl references and nested data structures
2213
2214 =over
2215
2216 =item NOTE
2217
2218 =item DESCRIPTION
2219
2220 =over
2221
2222 =item Making References
2223
2224 =item Using References
2225
2226 =item Symbolic references
2227
2228 =item Not-so-symbolic references
2229
2230 =item Pseudo-hashes: Using an array as a hash
2231
2232 =item Function Templates
2233
2234 =back
2235
2236 =item WARNING
2237
2238 =item SEE ALSO
2239
2240 =back
2241
2242 =head2 perlreftut - Mark's very short tutorial about references
2243
2244 =over
2245
2246 =item DESCRIPTION
2247
2248 =item Who Needs Complicated Data Structures?
2249
2250 =item The Solution
2251
2252 =item Syntax
2253
2254 =over
2255
2256 =item Making References
2257
2258 =item Using References
2259
2260 =back
2261
2262 =item An Example
2263
2264 =item Arrow Rule
2265
2266 =item Solution
2267
2268 =item The Rest
2269
2270 =item Summary
2271
2272 =item Credits
2273
2274 =over
2275
2276 =item Distribution Conditions
2277
2278 =back
2279
2280 =back
2281
2282 =head2 perldsc - Perl Data Structures Cookbook
2283
2284 =over
2285
2286 =item DESCRIPTION
2287
2288 arrays of arrays, hashes of arrays, arrays of hashes, hashes of hashes,
2289 more elaborate constructs
2290
2291 =item REFERENCES
2292
2293 =item COMMON MISTAKES
2294
2295 =item CAVEAT ON PRECEDENCE
2296
2297 =item WHY YOU SHOULD ALWAYS C<use strict>
2298
2299 =item DEBUGGING
2300
2301 =item CODE EXAMPLES
2302
2303 =item ARRAYS OF ARRAYS
2304
2305 =over
2306
2307 =item Declaration of a ARRAY OF ARRAYS
2308
2309 =item Generation of a ARRAY OF ARRAYS
2310
2311 =item Access and Printing of a ARRAY OF ARRAYS
2312
2313 =back
2314
2315 =item HASHES OF ARRAYS
2316
2317 =over
2318
2319 =item Declaration of a HASH OF ARRAYS
2320
2321 =item Generation of a HASH OF ARRAYS
2322
2323 =item Access and Printing of a HASH OF ARRAYS
2324
2325 =back
2326
2327 =item ARRAYS OF HASHES
2328
2329 =over
2330
2331 =item Declaration of a ARRAY OF HASHES
2332
2333 =item Generation of a ARRAY OF HASHES
2334
2335 =item Access and Printing of a ARRAY OF HASHES
2336
2337 =back
2338
2339 =item HASHES OF HASHES
2340
2341 =over
2342
2343 =item Declaration of a HASH OF HASHES
2344
2345 =item Generation of a HASH OF HASHES
2346
2347 =item Access and Printing of a HASH OF HASHES
2348
2349 =back
2350
2351 =item MORE ELABORATE RECORDS
2352
2353 =over
2354
2355 =item Declaration of MORE ELABORATE RECORDS
2356
2357 =item Declaration of a HASH OF COMPLEX RECORDS
2358
2359 =item Generation of a HASH OF COMPLEX RECORDS
2360
2361 =back
2362
2363 =item Database Ties
2364
2365 =item SEE ALSO
2366
2367 =item AUTHOR
2368
2369 =back
2370
2371 =head2 perllol - Manipulating Arrays of Arrays in Perl
2372
2373 =over
2374
2375 =item DESCRIPTION
2376
2377 =item Declaration and Access of Arrays of Arrays
2378
2379 =item Growing Your Own
2380
2381 =item Access and Printing
2382
2383 =item Slices
2384
2385 =item SEE ALSO
2386
2387 =item AUTHOR
2388
2389 =back
2390
2391 =head2 perlboot - Beginner's Object-Oriented Tutorial
2392
2393 =over
2394
2395 =item DESCRIPTION
2396
2397 =over
2398
2399 =item If we could talk to the animals...
2400
2401 =item Introducing the method invocation arrow
2402
2403 =item Invoking a barnyard
2404
2405 =item The extra parameter of method invocation
2406
2407 =item Calling a second method to simplify things
2408
2409 =item Inheriting the windpipes
2410
2411 =item A few notes about @ISA
2412
2413 =item Overriding the methods
2414
2415 =item Starting the search from a different place
2416
2417 =item The SUPER way of doing things
2418
2419 =item Where we're at so far...
2420
2421 =item A horse is a horse, of course of course -- or is it?
2422
2423 =item Invoking an instance method
2424
2425 =item Accessing the instance data
2426
2427 =item How to build a horse
2428
2429 =item Inheriting the constructor
2430
2431 =item Making a method work with either classes or instances
2432
2433 =item Adding parameters to a method
2434
2435 =item More interesting instances
2436
2437 =item A horse of a different color
2438
2439 =item Summary
2440
2441 =back
2442
2443 =item SEE ALSO
2444
2445 =item COPYRIGHT
2446
2447 =back
2448
2449 =head2 perltoot - Tom's object-oriented tutorial for perl
2450
2451 =over
2452
2453 =item DESCRIPTION
2454
2455 =item Creating a Class
2456
2457 =over
2458
2459 =item Object Representation
2460
2461 =item Class Interface
2462
2463 =item Constructors and Instance Methods
2464
2465 =item Planning for the Future: Better Constructors
2466
2467 =item Destructors
2468
2469 =item Other Object Methods
2470
2471 =back
2472
2473 =item Class Data
2474
2475 =over
2476
2477 =item Accessing Class Data
2478
2479 =item Debugging Methods
2480
2481 =item Class Destructors
2482
2483 =item Documenting the Interface
2484
2485 =back
2486
2487 =item Aggregation
2488
2489 =item Inheritance
2490
2491 =over
2492
2493 =item Overridden Methods
2494
2495 =item Multiple Inheritance
2496
2497 =item UNIVERSAL: The Root of All Objects
2498
2499 =back
2500
2501 =item Alternate Object Representations
2502
2503 =over
2504
2505 =item Arrays as Objects
2506
2507 =item Closures as Objects
2508
2509 =back
2510
2511 =item AUTOLOAD: Proxy Methods
2512
2513 =over
2514
2515 =item Autoloaded Data Methods
2516
2517 =item Inherited Autoloaded Data Methods
2518
2519 =back
2520
2521 =item Metaclassical Tools
2522
2523 =over
2524
2525 =item Class::Struct
2526
2527 =item Data Members as Variables
2528
2529 =item NOTES
2530
2531 =item Object Terminology
2532
2533 =back
2534
2535 =item SEE ALSO
2536
2537 =item AUTHOR AND COPYRIGHT
2538
2539 =item COPYRIGHT
2540
2541 =over
2542
2543 =item Acknowledgments
2544
2545 =back
2546
2547 =back
2548
2549 =head2 perltootc - Tom's OO Tutorial for Class Data in Perl
2550
2551 =over
2552
2553 =item DESCRIPTION
2554
2555 =item Class Data as Package Variables
2556
2557 =over
2558
2559 =item Putting All Your Eggs in One Basket
2560
2561 =item Inheritance Concerns
2562
2563 =item The Eponymous Meta-Object
2564
2565 =item Indirect References to Class Data
2566
2567 =item Monadic Classes
2568
2569 =item Translucent Attributes
2570
2571 =back
2572
2573 =item Class Data as Lexical Variables
2574
2575 =over
2576
2577 =item Privacy and Responsibility 
2578
2579 =item File-Scoped Lexicals
2580
2581 =item More Inheritance Concerns
2582
2583 =item Locking the Door and Throwing Away the Key
2584
2585 =item Translucency Revisited
2586
2587 =back
2588
2589 =item NOTES
2590
2591 =item SEE ALSO
2592
2593 =item AUTHOR AND COPYRIGHT
2594
2595 =item ACKNOWLEDGEMENTS
2596
2597 =item HISTORY
2598
2599 =back
2600
2601 =head2 perlobj - Perl objects
2602
2603 =over
2604
2605 =item DESCRIPTION
2606
2607 =over
2608
2609 =item An Object is Simply a Reference
2610
2611 =item A Class is Simply a Package
2612
2613 =item A Method is Simply a Subroutine
2614
2615 =item Method Invocation
2616
2617 =item WARNING
2618
2619 =item Default UNIVERSAL methods
2620
2621 isa(CLASS), can(METHOD), VERSION( [NEED] )
2622
2623 =item Destructors
2624
2625 =item Summary
2626
2627 =item Two-Phased Garbage Collection
2628
2629 =back
2630
2631 =item SEE ALSO
2632
2633 =back
2634
2635 =head2 perltie - how to hide an object class in a simple variable
2636
2637 =over
2638
2639 =item SYNOPSIS
2640
2641 =item DESCRIPTION
2642
2643 =over
2644
2645 =item Tying Scalars
2646
2647 TIESCALAR classname, LIST, FETCH this, STORE this, value, DESTROY this
2648
2649 =item Tying Arrays
2650
2651 TIEARRAY classname, LIST, FETCH this, index, STORE this, index, value,
2652 DESTROY this
2653
2654 =item Tying Hashes
2655
2656 USER, HOME, CLOBBER, LIST, TIEHASH classname, LIST, FETCH this, key, STORE
2657 this, key, value, DELETE this, key, CLEAR this, EXISTS this, key, FIRSTKEY
2658 this, NEXTKEY this, lastkey, DESTROY this
2659
2660 =item Tying FileHandles
2661
2662 TIEHANDLE classname, LIST, WRITE this, LIST, PRINT this, LIST, PRINTF this,
2663 LIST, READ this, LIST, READLINE this, GETC this, CLOSE this, DESTROY this
2664
2665 =item The C<untie> Gotcha
2666
2667 =back
2668
2669 =item SEE ALSO
2670
2671 =item BUGS
2672
2673 =item AUTHOR
2674
2675 =back
2676
2677 =head2 perlbot - Bag'o Object Tricks (the BOT)
2678
2679 =over
2680
2681 =item DESCRIPTION
2682
2683 =item OO SCALING TIPS
2684
2685 =item INSTANCE VARIABLES
2686
2687 =item SCALAR INSTANCE VARIABLES
2688
2689 =item INSTANCE VARIABLE INHERITANCE
2690
2691 =item OBJECT RELATIONSHIPS
2692
2693 =item OVERRIDING SUPERCLASS METHODS
2694
2695 =item USING RELATIONSHIP WITH SDBM
2696
2697 =item THINKING OF CODE REUSE
2698
2699 =item CLASS CONTEXT AND THE OBJECT
2700
2701 =item INHERITING A CONSTRUCTOR
2702
2703 =item DELEGATION
2704
2705 =back
2706
2707 =head2 perlipc - Perl interprocess communication (signals, fifos, pipes,
2708 safe subprocesses, sockets, and semaphores)
2709
2710 =over
2711
2712 =item DESCRIPTION
2713
2714 =item Signals
2715
2716 =item Named Pipes
2717
2718 =over
2719
2720 =item WARNING
2721
2722 =back
2723
2724 =item Using open() for IPC
2725
2726 =over
2727
2728 =item Filehandles
2729
2730 =item Background Processes
2731
2732 =item Complete Dissociation of Child from Parent
2733
2734 =item Safe Pipe Opens
2735
2736 =item Bidirectional Communication with Another Process
2737
2738 =item Bidirectional Communication with Yourself
2739
2740 =back
2741
2742 =item Sockets: Client/Server Communication
2743
2744 =over
2745
2746 =item Internet Line Terminators
2747
2748 =item Internet TCP Clients and Servers
2749
2750 =item Unix-Domain TCP Clients and Servers
2751
2752 =back
2753
2754 =item TCP Clients with IO::Socket
2755
2756 =over
2757
2758 =item A Simple Client
2759
2760 C<Proto>, C<PeerAddr>, C<PeerPort>
2761
2762 =item A Webget Client
2763
2764 =item Interactive Client with IO::Socket
2765
2766 =back
2767
2768 =item TCP Servers with IO::Socket
2769
2770 Proto, LocalPort, Listen, Reuse
2771
2772 =item UDP: Message Passing
2773
2774 =item SysV IPC
2775
2776 =item NOTES
2777
2778 =item BUGS
2779
2780 =item AUTHOR
2781
2782 =item SEE ALSO
2783
2784 =back
2785
2786 =head2 perldbmfilter - Perl DBM Filters
2787
2788 =over
2789
2790 =item SYNOPSIS
2791
2792 =item DESCRIPTION
2793
2794 B<filter_store_key>, B<filter_store_value>, B<filter_fetch_key>,
2795 B<filter_fetch_value>
2796
2797 =over
2798
2799 =item The Filter
2800
2801 =item An Example -- the NULL termination problem.
2802
2803 =item Another Example -- Key is a C int.
2804
2805 =back
2806
2807 =item SEE ALSO
2808
2809 =item AUTHOR
2810
2811 =back
2812
2813 =head2 perldebug - Perl debugging
2814
2815 =over
2816
2817 =item DESCRIPTION
2818
2819 =item The Perl Debugger
2820
2821 =over
2822
2823 =item Debugger Commands
2824
2825 h [command], p expr, x expr, V [pkg [vars]], X [vars], T, s [expr], n
2826 [expr], r, <CR>, c [line|sub], l, l min+incr, l min-max, l line, l subname,
2827 -, w [line], f filename, /pattern/, ?pattern?, L, S [[!]regex], t, t expr,
2828 b [line] [condition], b subname [condition], b postpone subname
2829 [condition], b load filename, b compile subname, d [line], D, a [line]
2830 command, a [line], A, W expr, W, O booloption .., O anyoption? .., O
2831 option=value .., < ?, < [ command ], << command, > ?, > command, >>
2832 command, { ?, { [ command ], {{ command, ! number, ! -number, ! pattern, !!
2833 cmd, H -number, q or ^D, R, |dbcmd, ||dbcmd, command, m expr, man [manpage]
2834
2835 =item Configurable Options
2836
2837 C<recallCommand>, C<ShellBang>, C<pager>, C<tkRunning>, C<signalLevel>,
2838 C<warnLevel>, C<dieLevel>, C<AutoTrace>, C<LineInfo>, C<inhibit_exit>,
2839 C<PrintRet>, C<ornaments>, C<frame>, C<maxTraceLen>, C<arrayDepth>,
2840 C<hashDepth>, C<compactDump>, C<veryCompact>, C<globPrint>, C<DumpDBFiles>,
2841 C<DumpPackages>, C<DumpReused>, C<quote>, C<HighBit>, C<undefPrint>,
2842 C<UsageOnly>, C<TTY>, C<noTTY>, C<ReadLine>, C<NonStop>
2843
2844 =item Debugger input/output
2845
2846 Prompt, Multiline commands, Stack backtrace, Line Listing Format, Frame
2847 listing
2848
2849 =item Debugging compile-time statements
2850
2851 =item Debugger Customization
2852
2853 =item Readline Support
2854
2855 =item Editor Support for Debugging
2856
2857 =item The Perl Profiler
2858
2859 =back
2860
2861 =item Debugging regular expressions
2862
2863 =item Debugging memory usage
2864
2865 =item SEE ALSO
2866
2867 =item BUGS
2868
2869 =back
2870
2871 =head2 perlnumber - semantics of numbers and numeric operations in Perl
2872
2873 =over
2874
2875 =item SYNOPSIS
2876
2877 =item DESCRIPTION
2878
2879 =item Storing numbers
2880
2881 =item Numeric operators and numeric conversions
2882
2883 =item Flavors of Perl numeric operations
2884
2885 Arithmetic operators except, C<no integer>, Arithmetic operators except,
2886 C<use integer>, Bitwise operators, C<no integer>, Bitwise operators, C<use
2887 integer>, Operators which expect an integer, Operators which expect a
2888 string
2889
2890 =item AUTHOR
2891
2892 =item SEE ALSO
2893
2894 =back
2895
2896 =head2 perldebguts - Guts of Perl debugging 
2897
2898 =over
2899
2900 =item DESCRIPTION
2901
2902 =item Debugger Internals
2903
2904 =over
2905
2906 =item Writing Your Own Debugger
2907
2908 =back
2909
2910 =item Frame Listing Output Examples
2911
2912 =item Debugging regular expressions
2913
2914 =over
2915
2916 =item Compile-time output
2917
2918 C<anchored> I<STRING> C<at> I<POS>, C<floating> I<STRING> C<at>
2919 I<POS1..POS2>, C<matching floating/anchored>, C<minlen>, C<stclass>
2920 I<TYPE>, C<noscan>, C<isall>, C<GPOS>, C<plus>, C<implicit>, C<with eval>,
2921 C<anchored(TYPE)>
2922
2923 =item Types of nodes
2924
2925 =item Run-time output
2926
2927 =back
2928
2929 =item Debugging Perl memory usage
2930
2931 =over
2932
2933 =item Using C<$ENV{PERL_DEBUG_MSTATS}>
2934
2935 C<buckets SMALLEST(APPROX)..GREATEST(APPROX)>, Free/Used, C<Total sbrk():
2936 SBRKed/SBRKs:CONTINUOUS>, C<pad: 0>, C<heads: 2192>, C<chain: 0>, C<tail:
2937 6144>
2938
2939 =item Example of using B<-DL> switch
2940
2941 C<717>, C<002>, C<054>, C<602>, C<702>, C<704>
2942
2943 =item B<-DL> details
2944
2945 C<!!!>, C<!!>, C<!>
2946
2947 =item Limitations of B<-DL> statistics
2948
2949 =back
2950
2951 =item SEE ALSO
2952
2953 =back
2954
2955 =head2 perldiag - various Perl diagnostics
2956
2957 =over
2958
2959 =item DESCRIPTION
2960
2961 =back
2962
2963 =head2 perlsec - Perl security
2964
2965 =over
2966
2967 =item DESCRIPTION
2968
2969 =over
2970
2971 =item Laundering and Detecting Tainted Data
2972
2973 =item Switches On the "#!" Line
2974
2975 =item Cleaning Up Your Path
2976
2977 =item Security Bugs
2978
2979 =item Protecting Your Programs
2980
2981 =back
2982
2983 =item SEE ALSO
2984
2985 =back
2986
2987 =head2 perltrap - Perl traps for the unwary
2988
2989 =over
2990
2991 =item DESCRIPTION
2992
2993 =over
2994
2995 =item Awk Traps
2996
2997 =item C Traps
2998
2999 =item Sed Traps
3000
3001 =item Shell Traps
3002
3003 =item Perl Traps
3004
3005 =item Perl4 to Perl5 Traps
3006
3007 Discontinuance, Deprecation, and BugFix traps, Parsing Traps, Numerical
3008 Traps, General data type traps, Context Traps - scalar, list contexts,
3009 Precedence Traps, General Regular Expression Traps using s///, etc,
3010 Subroutine, Signal, Sorting Traps, OS Traps, DBM Traps, Unclassified Traps
3011
3012 =item Discontinuance, Deprecation, and BugFix traps
3013
3014 Discontinuance, Deprecation, BugFix, Discontinuance, Discontinuance,
3015 Discontinuance, BugFix, Discontinuance, Discontinuance, BugFix,
3016 Discontinuance, Deprecation, Discontinuance
3017
3018 =item Parsing Traps
3019
3020 Parsing, Parsing, Parsing, Parsing
3021
3022 =item Numerical Traps
3023
3024 Numerical, Numerical, Numerical, Bitwise string ops
3025
3026 =item General data type traps
3027
3028 (Arrays), (Arrays), (Hashes), (Globs), (Globs), (Scalar String),
3029 (Constants), (Scalars), (Variable Suicide)
3030
3031 =item Context Traps - scalar, list contexts
3032
3033 (list context), (scalar context), (scalar context), (list, builtin)
3034
3035 =item Precedence Traps
3036
3037 Precedence, Precedence, Precedence, Precedence, Precedence, Precedence,
3038 Precedence
3039
3040 =item General Regular Expression Traps using s///, etc.
3041
3042 Regular Expression, Regular Expression, Regular Expression, Regular
3043 Expression, Regular Expression, Regular Expression, Regular Expression,
3044 Regular Expression
3045
3046 =item Subroutine, Signal, Sorting Traps
3047
3048 (Signals), (Sort Subroutine), warn() won't let you specify a filehandle
3049
3050 =item OS Traps
3051
3052 (SysV), (SysV)
3053
3054 =item Interpolation Traps
3055
3056 Interpolation, Interpolation, Interpolation, Interpolation, Interpolation,
3057 Interpolation, Interpolation, Interpolation, Interpolation
3058
3059 =item DBM Traps
3060
3061 DBM, DBM
3062
3063 =item Unclassified Traps
3064
3065 C<require>/C<do> trap using returned value, C<split> on empty string with
3066 LIMIT specified
3067
3068 =back
3069
3070 =back
3071
3072 =head2 perlport - Writing portable Perl
3073
3074 =over
3075
3076 =item DESCRIPTION
3077
3078 Not all Perl programs have to be portable, Nearly all of Perl already I<is>
3079 portable
3080
3081 =item ISSUES
3082
3083 =over
3084
3085 =item Newlines
3086
3087 =item Numbers endianness and Width
3088
3089 =item Files and Filesystems
3090
3091 =item System Interaction
3092
3093 =item Interprocess Communication (IPC)
3094
3095 =item External Subroutines (XS)
3096
3097 =item Standard Modules
3098
3099 =item Time and Date
3100
3101 =item Character sets and character encoding
3102
3103 =item Internationalisation
3104
3105 =item System Resources
3106
3107 =item Security
3108
3109 =item Style
3110
3111 =back
3112
3113 =item CPAN Testers
3114
3115 Mailing list: cpan-testers@perl.org, Testing results:
3116 C<http://testers.cpan.org/>
3117
3118 =item PLATFORMS
3119
3120 =over
3121
3122 =item Unix
3123
3124 =item DOS and Derivatives
3125
3126 The djgpp environment for DOS, C<http://www.delorie.com/djgpp/>, The EMX
3127 environment for DOS, OS/2, etc.
3128 C<emx@iaehv.nl>,C<http://www.leo.org/pub/comp/os/os2/leo/gnu/emx+gcc/index.
3129 html> or
3130 C<ftp://hobbes.nmsu.edu/pub/os2/dev/emx>, Build instructions for Win32,
3131 L<perlwin32>, The ActiveState Pages, C<http://www.activestate.com/>, The
3132 Cygwin environment for Win32; F<README.cygwin> (installed as
3133 L<perlcygwin>), C<http://sourceware.cygnus.com/cygwin/>, The U/WIN
3134 environment for Win32,C<http://www.research.att.com/sw/tools/uwin/>
3135
3136 =item S<Mac OS>
3137
3138 The MacPerl Pages, C<http://www.macperl.com/>, The MacPerl mailing lists,
3139 C<http://www.macperl.org/>, MacPerl Module Porters,
3140 C<http://pudge.net/mmp/>
3141
3142 =item VMS
3143
3144 F<README.vms> (installed as L<README_vms>), L<perlvms>, vmsperl list,
3145 C<majordomo@perl.org>, vmsperl on the web,
3146 C<http://www.sidhe.org/vmsperl/index.html>
3147
3148 =item VOS
3149
3150 F<README.vos>, VOS mailing list, VOS Perl on the web at
3151 C<http://ftp.stratus.com/pub/vos/vos.html>
3152
3153 =item EBCDIC Platforms
3154
3155 F<README.os390>, F<README.posix-bc>, F<README.vmesa>, perl-mvs list, AS/400
3156 Perl information at C<http://as400.rochester.ibm.com/>as well as on CPAN in
3157 the F<ports/> directory
3158
3159 =item Acorn RISC OS
3160
3161 =item Other perls
3162
3163 Amiga, F<README.amiga> (installed as L<perlamiga>), Atari, F<README.mint>
3164 and Guido Flohr's web pageC<http://stud.uni-sb.de/~gufl0000/>, Be OS,
3165 F<README.beos>, HP 300 MPE/iX, F<README.mpeix> and Mark Bixby's web
3166 pageC<http://www.cccd.edu/~markb/perlix.html>, Novell Netware, Plan 9,
3167 F<README.plan9>
3168
3169 =back
3170
3171 =item FUNCTION IMPLEMENTATIONS
3172
3173 =over
3174
3175 =item Alphabetical Listing of Perl Functions
3176
3177 -I<X> FILEHANDLE, -I<X> EXPR, -I<X>, alarm SECONDS, alarm, binmode
3178 FILEHANDLE, chmod LIST, chown LIST, chroot FILENAME, chroot, crypt
3179 PLAINTEXT,SALT, dbmclose HASH, dbmopen HASH,DBNAME,MODE, dump LABEL, exec
3180 LIST, fcntl FILEHANDLE,FUNCTION,SCALAR, flock FILEHANDLE,OPERATION, fork,
3181 getlogin, getpgrp PID, getppid, getpriority WHICH,WHO, getpwnam NAME,
3182 getgrnam NAME, getnetbyname NAME, getpwuid UID, getgrgid GID, getnetbyaddr
3183 ADDR,ADDRTYPE, getprotobynumber NUMBER, getservbyport PORT,PROTO, getpwent,
3184 getgrent, gethostent, getnetent, getprotoent, getservent, setpwent,
3185 setgrent, sethostent STAYOPEN, setnetent STAYOPEN, setprotoent STAYOPEN,
3186 setservent STAYOPEN, endpwent, endgrent, endhostent, endnetent,
3187 endprotoent, endservent, getsockopt SOCKET,LEVEL,OPTNAME, glob EXPR, glob,
3188 ioctl FILEHANDLE,FUNCTION,SCALAR, kill SIGNAL, LIST, link OLDFILE,NEWFILE,
3189 lstat FILEHANDLE, lstat EXPR, lstat, msgctl ID,CMD,ARG, msgget KEY,FLAGS,
3190 msgsnd ID,MSG,FLAGS, msgrcv ID,VAR,SIZE,TYPE,FLAGS, open FILEHANDLE,EXPR,
3191 open FILEHANDLE, pipe READHANDLE,WRITEHANDLE, readlink EXPR, readlink,
3192 select RBITS,WBITS,EBITS,TIMEOUT, semctl ID,SEMNUM,CMD,ARG, semget
3193 KEY,NSEMS,FLAGS, semop KEY,OPSTRING, setgrent, setpgrp PID,PGRP,
3194 setpriority WHICH,WHO,PRIORITY, setpwent, setsockopt
3195 SOCKET,LEVEL,OPTNAME,OPTVAL, shmctl ID,CMD,ARG, shmget KEY,SIZE,FLAGS,
3196 shmread ID,VAR,POS,SIZE, shmwrite ID,STRING,POS,SIZE, socketpair
3197 SOCKET1,SOCKET2,DOMAIN,TYPE,PROTOCOL, stat FILEHANDLE, stat EXPR, stat,
3198 symlink OLDFILE,NEWFILE, syscall LIST, sysopen
3199 FILEHANDLE,FILENAME,MODE,PERMS, system LIST, times, truncate
3200 FILEHANDLE,LENGTH, truncate EXPR,LENGTH, umask EXPR, umask, utime LIST,
3201 wait, waitpid PID,FLAGS
3202
3203 =back
3204
3205 =item CHANGES
3206
3207 v1.46, 12 February 2000, v1.45, 20 December 1999, v1.44, 19 July 1999,
3208 v1.43, 24 May 1999, v1.42, 22 May 1999, v1.41, 19 May 1999, v1.40, 11 April
3209 1999, v1.39, 11 February 1999, v1.38, 31 December 1998, v1.37, 19 December
3210 1998, v1.36, 9 September 1998, v1.35, 13 August 1998, v1.33, 06 August
3211 1998, v1.32, 05 August 1998, v1.30, 03 August 1998, v1.23, 10 July 1998
3212
3213 =item Supported Platforms
3214
3215 =item AUTHORS / CONTRIBUTORS
3216
3217 =item VERSION
3218
3219 =back
3220
3221 =head2 perlstyle - Perl style guide
3222
3223 =over
3224
3225 =item DESCRIPTION
3226
3227 =back
3228
3229 =head2 perlpod - plain old documentation
3230
3231 =over
3232
3233 =item DESCRIPTION
3234
3235 =over
3236
3237 =item Verbatim Paragraph
3238
3239 =item Command Paragraph
3240
3241 =item Ordinary Block of Text
3242
3243 =item The Intent
3244
3245 =item Embedding Pods in Perl Modules
3246
3247 =item Common Pod Pitfalls
3248
3249 =back
3250
3251 =item SEE ALSO
3252
3253 =item AUTHOR
3254
3255 =back
3256
3257 =head2 perlbook - Perl book information
3258
3259 =over
3260
3261 =item DESCRIPTION
3262
3263 =back
3264
3265 =head2 perlembed - how to embed perl in your C program
3266
3267 =over
3268
3269 =item DESCRIPTION
3270
3271 =over
3272
3273 =item PREAMBLE
3274
3275 B<Use C from Perl?>, B<Use a Unix program from Perl?>, B<Use Perl from
3276 Perl?>, B<Use C from C?>, B<Use Perl from C?>
3277
3278 =item ROADMAP
3279
3280 =item Compiling your C program
3281
3282 =item Adding a Perl interpreter to your C program
3283
3284 =item Calling a Perl subroutine from your C program
3285
3286 =item Evaluating a Perl statement from your C program
3287
3288 =item Performing Perl pattern matches and substitutions from your C program
3289
3290 =item Fiddling with the Perl stack from your C program
3291
3292 =item Maintaining a persistent interpreter
3293
3294 =item Maintaining multiple interpreter instances
3295
3296 =item Using Perl modules, which themselves use C libraries, from your C
3297 program
3298
3299 =back
3300
3301 =item Embedding Perl under Win32
3302
3303 =item MORAL
3304
3305 =item AUTHOR
3306
3307 =item COPYRIGHT
3308
3309 =back
3310
3311 =head2 perlapio - perl's IO abstraction interface.
3312
3313 =over
3314
3315 =item SYNOPSIS
3316
3317 =item DESCRIPTION
3318
3319 B<PerlIO *>, B<PerlIO_stdin()>, B<PerlIO_stdout()>, B<PerlIO_stderr()>,
3320 B<PerlIO_open(path, mode)>, B<PerlIO_fdopen(fd,mode)>,
3321 B<PerlIO_printf(f,fmt,...)>, B<PerlIO_vprintf(f,fmt,a)>,
3322 B<PerlIO_stdoutf(fmt,...)>, B<PerlIO_read(f,buf,count)>,
3323 B<PerlIO_write(f,buf,count)>, B<PerlIO_close(f)>, B<PerlIO_puts(f,s)>,
3324 B<PerlIO_putc(f,c)>, B<PerlIO_ungetc(f,c)>, B<PerlIO_getc(f)>,
3325 B<PerlIO_eof(f)>, B<PerlIO_error(f)>, B<PerlIO_fileno(f)>,
3326 B<PerlIO_clearerr(f)>, B<PerlIO_flush(f)>, B<PerlIO_tell(f)>,
3327 B<PerlIO_seek(f,o,w)>, B<PerlIO_getpos(f,p)>, B<PerlIO_setpos(f,p)>,
3328 B<PerlIO_rewind(f)>, B<PerlIO_tmpfile()>
3329
3330 =over
3331
3332 =item Co-existence with stdio
3333
3334 B<PerlIO_importFILE(f,flags)>, B<PerlIO_exportFILE(f,flags)>,
3335 B<PerlIO_findFILE(f)>, B<PerlIO_releaseFILE(p,f)>, B<PerlIO_setlinebuf(f)>,
3336 B<PerlIO_has_cntptr(f)>, B<PerlIO_get_ptr(f)>, B<PerlIO_get_cnt(f)>,
3337 B<PerlIO_canset_cnt(f)>, B<PerlIO_fast_gets(f)>,
3338 B<PerlIO_set_ptrcnt(f,p,c)>, B<PerlIO_set_cnt(f,c)>, B<PerlIO_has_base(f)>,
3339 B<PerlIO_get_base(f)>, B<PerlIO_get_bufsiz(f)>
3340
3341 =back
3342
3343 =back
3344
3345 =head2 perlxs - XS language reference manual
3346
3347 =over
3348
3349 =item DESCRIPTION
3350
3351 =over
3352
3353 =item Introduction
3354
3355 =item On The Road
3356
3357 =item The Anatomy of an XSUB
3358
3359 =item The Argument Stack
3360
3361 =item The RETVAL Variable
3362
3363 =item The MODULE Keyword
3364
3365 =item The PACKAGE Keyword
3366
3367 =item The PREFIX Keyword
3368
3369 =item The OUTPUT: Keyword
3370
3371 =item The CODE: Keyword
3372
3373 =item The INIT: Keyword
3374
3375 =item The NO_INIT Keyword
3376
3377 =item Initializing Function Parameters
3378
3379 =item Default Parameter Values
3380
3381 =item The PREINIT: Keyword
3382
3383 =item The SCOPE: Keyword
3384
3385 =item The INPUT: Keyword
3386
3387 =item Variable-length Parameter Lists
3388
3389 =item The C_ARGS: Keyword
3390
3391 =item The PPCODE: Keyword
3392
3393 =item Returning Undef And Empty Lists
3394
3395 =item The REQUIRE: Keyword
3396
3397 =item The CLEANUP: Keyword
3398
3399 =item The BOOT: Keyword
3400
3401 =item The VERSIONCHECK: Keyword
3402
3403 =item The PROTOTYPES: Keyword
3404
3405 =item The PROTOTYPE: Keyword
3406
3407 =item The ALIAS: Keyword
3408
3409 =item The INTERFACE: Keyword
3410
3411 =item The INTERFACE_MACRO: Keyword
3412
3413 =item The INCLUDE: Keyword
3414
3415 =item The CASE: Keyword
3416
3417 =item The & Unary Operator
3418
3419 =item Inserting Comments and C Preprocessor Directives
3420
3421 =item Using XS With C++
3422
3423 =item Interface Strategy
3424
3425 =item Perl Objects And C Structures
3426
3427 =item The Typemap
3428
3429 =back
3430
3431 =item EXAMPLES
3432
3433 =item XS VERSION
3434
3435 =item AUTHOR
3436
3437 =back
3438
3439 =head2 perlxstut, perlXStut - Tutorial for writing XSUBs
3440
3441 =over
3442
3443 =item DESCRIPTION
3444
3445 =item SPECIAL NOTES
3446
3447 =over
3448
3449 =item make
3450
3451 =item Version caveat
3452
3453 =item Dynamic Loading versus Static Loading
3454
3455 =back
3456
3457 =item TUTORIAL
3458
3459 =over
3460
3461 =item EXAMPLE 1
3462
3463 =item EXAMPLE 2
3464
3465 =item What has gone on?
3466
3467 =item Writing good test scripts
3468
3469 =item EXAMPLE 3
3470
3471 =item What's new here?
3472
3473 =item Input and Output Parameters
3474
3475 =item The XSUBPP Program
3476
3477 =item The TYPEMAP file
3478
3479 =item Warning about Output Arguments
3480
3481 =item EXAMPLE 4
3482
3483 =item What has happened here?
3484
3485 =item Anatomy of .xs file
3486
3487 =item Getting the fat out of XSUBs
3488
3489 =item More about XSUB arguments
3490
3491 =item The Argument Stack
3492
3493 =item Extending your Extension
3494
3495 =item Documenting your Extension
3496
3497 =item Installing your Extension
3498
3499 =item EXAMPLE 5
3500
3501 =item New Things in this Example
3502
3503 =item EXAMPLE 6 (Coming Soon)
3504
3505 =item EXAMPLE 7 (Coming Soon)
3506
3507 =item EXAMPLE 8 (Coming Soon)
3508
3509 =item EXAMPLE 9 (Coming Soon)
3510
3511 =item Troubleshooting these Examples
3512
3513 =back
3514
3515 =item See also
3516
3517 =item Author
3518
3519 =over
3520
3521 =item Last Changed
3522
3523 =back
3524
3525 =back
3526
3527 =head2 perlguts - Introduction to the Perl API
3528
3529 =over
3530
3531 =item DESCRIPTION
3532
3533 =item Variables
3534
3535 =over
3536
3537 =item Datatypes
3538
3539 =item What is an "IV"?
3540
3541 =item Working with SVs
3542
3543 =item What's Really Stored in an SV?
3544
3545 =item Working with AVs
3546
3547 =item Working with HVs
3548
3549 =item Hash API Extensions
3550
3551 =item References
3552
3553 =item Blessed References and Class Objects
3554
3555 =item Creating New Variables
3556
3557 =item Reference Counts and Mortality
3558
3559 =item Stashes and Globs
3560
3561 =item Double-Typed SVs
3562
3563 =item Magic Variables
3564
3565 =item Assigning Magic
3566
3567 =item Magic Virtual Tables
3568
3569 =item Finding Magic
3570
3571 =item Understanding the Magic of Tied Hashes and Arrays
3572
3573 =item Localizing changes
3574
3575 C<SAVEINT(int i)>, C<SAVEIV(IV i)>, C<SAVEI32(I32 i)>, C<SAVELONG(long i)>,
3576 C<SAVESPTR(s)>, C<SAVEPPTR(p)>, C<SAVEFREESV(SV *sv)>, C<SAVEFREEOP(OP
3577 *op)>, C<SAVEFREEPV(p)>, C<SAVECLEARSV(SV *sv)>, C<SAVEDELETE(HV *hv, char
3578 *key, I32 length)>, C<SAVEDESTRUCTOR(DESTRUCTORFUNC_NOCONTEXT_t f, void
3579 *p)>, C<SAVEDESTRUCTOR_X(DESTRUCTORFUNC_t f, void *p)>, C<SAVESTACK_POS()>,
3580 C<SV* save_scalar(GV *gv)>, C<AV* save_ary(GV *gv)>, C<HV* save_hash(GV
3581 *gv)>, C<void save_item(SV *item)>, C<void save_list(SV **sarg, I32
3582 maxsarg)>, C<SV* save_svref(SV **sptr)>, C<void save_aptr(AV **aptr)>,
3583 C<void save_hptr(HV **hptr)>
3584
3585 =back
3586
3587 =item Subroutines
3588
3589 =over
3590
3591 =item XSUBs and the Argument Stack
3592
3593 =item Calling Perl Routines from within C Programs
3594
3595 =item Memory Allocation
3596
3597 =item PerlIO
3598
3599 =item Putting a C value on Perl stack
3600
3601 =item Scratchpads
3602
3603 =item Scratchpads and recursion
3604
3605 =back
3606
3607 =item Compiled code
3608
3609 =over
3610
3611 =item Code tree
3612
3613 =item Examining the tree
3614
3615 =item Compile pass 1: check routines
3616
3617 =item Compile pass 1a: constant folding
3618
3619 =item Compile pass 2: context propagation
3620
3621 =item Compile pass 3: peephole optimization
3622
3623 =back
3624
3625 =item How multiple interpreters and concurrency are supported
3626
3627 =over
3628
3629 =item Background and PERL_IMPLICIT_CONTEXT
3630
3631 =item How do I use all this in extensions?
3632
3633 =item Future Plans and PERL_IMPLICIT_SYS
3634
3635 =back
3636
3637 =item AUTHORS
3638
3639 =item SEE ALSO
3640
3641 =back
3642
3643 =head2 perlcall - Perl calling conventions from C
3644
3645 =over
3646
3647 =item DESCRIPTION
3648
3649 An Error Handler, An Event Driven Program
3650
3651 =item THE CALL_ FUNCTIONS
3652
3653 call_sv, call_pv, call_method, call_argv
3654
3655 =item FLAG VALUES
3656
3657 =over
3658
3659 =item  G_VOID
3660
3661 =item  G_SCALAR
3662
3663 =item G_ARRAY
3664
3665 =item G_DISCARD
3666
3667 =item G_NOARGS
3668
3669 =item G_EVAL
3670
3671 =item G_KEEPERR
3672
3673 =item Determining the Context
3674
3675 =back
3676
3677 =item KNOWN PROBLEMS
3678
3679 =item EXAMPLES
3680
3681 =over
3682
3683 =item No Parameters, Nothing returned
3684
3685 =item Passing Parameters
3686
3687 =item Returning a Scalar
3688
3689 =item Returning a list of values
3690
3691 =item Returning a list in a scalar context
3692
3693 =item Returning Data from Perl via the parameter list
3694
3695 =item Using G_EVAL
3696
3697 =item Using G_KEEPERR
3698
3699 =item Using call_sv
3700
3701 =item Using call_argv
3702
3703 =item Using call_method
3704
3705 =item Using GIMME_V
3706
3707 =item Using Perl to dispose of temporaries
3708
3709 =item Strategies for storing Callback Context Information
3710
3711 1. Ignore the problem - Allow only 1 callback, 2. Create a sequence of
3712 callbacks - hard wired limit, 3. Use a parameter to map to the Perl
3713 callback
3714
3715 =item Alternate Stack Manipulation
3716
3717 =item Creating and calling an anonymous subroutine in C
3718
3719 =back
3720
3721 =item SEE ALSO
3722
3723 =item AUTHOR
3724
3725 =item DATE
3726
3727 =back
3728
3729 =head2 perlcompile - Introduction to the Perl Compiler-Translator 
3730
3731 =over
3732
3733 =item DESCRIPTION
3734
3735 =over
3736
3737 =item Layout
3738
3739 B::Bytecode, B::C, B::CC, B::Lint, B::Deparse, B::Xref
3740
3741 =back
3742
3743 =item Using The Back Ends
3744
3745 =over
3746
3747 =item The Cross Referencing Back End
3748
3749 i, &, s, r
3750
3751 =item The Decompiling Back End
3752
3753 =item The Lint Back End
3754
3755 =item The Simple C Back End
3756
3757 =item The Bytecode Back End
3758
3759 =item The Optimized C Back End
3760
3761 B, O, B::Asmdata, B::Assembler, B::Bblock, B::Bytecode, B::C, B::CC,
3762 B::Debug, B::Deparse, B::Disassembler, B::Lint, B::Showlex, B::Stackobj,
3763 B::Stash, B::Terse, B::Xref
3764
3765 =back
3766
3767 =item KNOWN PROBLEMS
3768
3769 =item AUTHOR
3770
3771 =back
3772
3773 =head2 perlapi - autogenerated documentation for the perl public API
3774
3775 =over
3776
3777 =item DESCRIPTION
3778
3779 AvFILL, av_clear, av_extend, av_fetch, av_len, av_make, av_pop, av_push,
3780 av_shift, av_store, av_undef, av_unshift, call_argv, call_method, call_pv,
3781 call_sv, CLASS, Copy, croak, CvSTASH, dMARK, dORIGMARK, dSP, dXSARGS,
3782 dXSI32, ENTER, eval_pv, eval_sv, EXTEND, fbm_compile, fbm_instr, FREETMPS,
3783 get_av, get_cv, get_hv, get_sv, GIMME, GIMME_V, GvSV, gv_fetchmeth,
3784 gv_fetchmethod, gv_fetchmethod_autoload, gv_stashpv, gv_stashsv, G_ARRAY,
3785 G_DISCARD, G_EVAL, G_NOARGS, G_SCALAR, G_VOID, HEf_SVKEY, HeHASH, HeKEY,
3786 HeKLEN, HePV, HeSVKEY, HeSVKEY_force, HeSVKEY_set, HeVAL, HvNAME, hv_clear,
3787 hv_delete, hv_delete_ent, hv_exists, hv_exists_ent, hv_fetch, hv_fetch_ent,
3788 hv_iterinit, hv_iterkey, hv_iterkeysv, hv_iternext, hv_iternextsv,
3789 hv_iterval, hv_magic, hv_store, hv_store_ent, hv_undef, isALNUM, isALPHA,
3790 isDIGIT, isLOWER, isSPACE, isUPPER, items, ix, LEAVE, looks_like_number,
3791 MARK, mg_clear, mg_copy, mg_find, mg_free, mg_get, mg_length, mg_magical,
3792 mg_set, Move, New, newAV, Newc, newCONSTSUB, newHV, newRV_inc, newRV_noinc,
3793 NEWSV, newSViv, newSVnv, newSVpv, newSVpvf, newSVpvn, newSVrv, newSVsv,
3794 newXS, newXSproto, Newz, Nullav, Nullch, Nullcv, Nullhv, Nullsv, ORIGMARK,
3795 perl_alloc, perl_construct, perl_destruct, perl_free, perl_parse, perl_run,
3796 PL_DBsingle, PL_DBsub, PL_DBtrace, PL_dowarn, PL_modglobal, PL_na,
3797 PL_sv_no, PL_sv_undef, PL_sv_yes, POPi, POPl, POPn, POPp, POPs, PUSHi,
3798 PUSHMARK, PUSHn, PUSHp, PUSHs, PUSHu, PUTBACK, Renew, Renewc, require_pv,
3799 RETVAL, Safefree, savepv, savepvn, SAVETMPS, SP, SPAGAIN, ST, strEQ, strGE,
3800 strGT, strLE, strLT, strNE, strnEQ, strnNE, StructCopy, SvCUR, SvCUR_set,
3801 SvEND, SvGETMAGIC, SvGROW, SvIOK, SvIOKp, SvIOK_off, SvIOK_on, SvIOK_only,
3802 SvIV, SvIVX, SvLEN, SvNIOK, SvNIOKp, SvNIOK_off, SvNOK, SvNOKp, SvNOK_off,
3803 SvNOK_on, SvNOK_only, SvNV, SvNVX, SvOK, SvOOK, SvPOK, SvPOKp, SvPOK_off,
3804 SvPOK_on, SvPOK_only, SvPV, SvPVX, SvPV_force, SvPV_nolen, SvREFCNT,
3805 SvREFCNT_dec, SvREFCNT_inc, SvROK, SvROK_off, SvROK_on, SvRV, SvSETMAGIC,
3806 SvSetSV, SvSetSV_nosteal, SvSTASH, SvTAINT, SvTAINTED, SvTAINTED_off,
3807 SvTAINTED_on, SvTRUE, SvTYPE, svtype, SVt_IV, SVt_NV, SVt_PV, SVt_PVAV,
3808 SVt_PVCV, SVt_PVHV, SVt_PVMG, SvUPGRADE, SvUV, SvUVX, sv_2mortal, sv_bless,
3809 sv_catpv, sv_catpvf, sv_catpvf_mg, sv_catpvn, sv_catpvn_mg, sv_catpv_mg,
3810 sv_catsv, sv_catsv_mg, sv_chop, sv_cmp, sv_dec, sv_derived_from, sv_eq,
3811 sv_grow, sv_inc, sv_insert, sv_isa, sv_isobject, sv_len, sv_magic,
3812 sv_mortalcopy, sv_newmortal, sv_setiv, sv_setiv_mg, sv_setnv, sv_setnv_mg,
3813 sv_setpv, sv_setpvf, sv_setpvf_mg, sv_setpviv, sv_setpviv_mg, sv_setpvn,
3814 sv_setpvn_mg, sv_setpv_mg, sv_setref_iv, sv_setref_nv, sv_setref_pv,
3815 sv_setref_pvn, sv_setsv, sv_setsv_mg, sv_setuv, sv_setuv_mg, sv_unref,
3816 sv_upgrade, sv_usepvn, sv_usepvn_mg, sv_vcatpvfn, sv_vsetpvfn, THIS,
3817 toLOWER, toUPPER, warn, XPUSHi, XPUSHn, XPUSHp, XPUSHs, XPUSHu, XS,
3818 XSRETURN, XSRETURN_EMPTY, XSRETURN_IV, XSRETURN_NO, XSRETURN_NV,
3819 XSRETURN_PV, XSRETURN_UNDEF, XSRETURN_YES, XST_mIV, XST_mNO, XST_mNV,
3820 XST_mPV, XST_mUNDEF, XST_mYES, XS_VERSION, XS_VERSION_BOOTCHECK, Zero
3821
3822 =item AUTHORS
3823
3824 =item SEE ALSO
3825
3826 =back
3827
3828 =head2 perlintern - autogenerated documentation of purely B<internal> 
3829                  Perl functions
3830
3831 =over
3832
3833 =item DESCRIPTION
3834
3835 =item AUTHORS
3836
3837 =item SEE ALSO
3838
3839 =back
3840
3841 =head2 perlhist - the Perl history records
3842
3843 =over
3844
3845 =item DESCRIPTION
3846
3847 =item INTRODUCTION
3848
3849 =item THE KEEPERS OF THE PUMPKIN
3850
3851 =over
3852
3853 =item PUMPKIN?
3854
3855 =back
3856
3857 =item THE RECORDS
3858
3859 =over
3860
3861 =item SELECTED RELEASE SIZES
3862
3863 =item SELECTED PATCH SIZES
3864
3865 =back
3866
3867 =item THE KEEPERS OF THE RECORDS
3868
3869 =back
3870
3871 =head1 PRAGMA DOCUMENTATION
3872
3873 =head2 attrs - set/get attributes of a subroutine (deprecated)
3874
3875 =over
3876
3877 =item SYNOPSIS
3878
3879 =item DESCRIPTION
3880
3881 method, locked
3882
3883 =back
3884
3885 =head2 re - Perl pragma to alter regular expression behaviour
3886
3887 =over
3888
3889 =item SYNOPSIS
3890
3891 =item DESCRIPTION
3892
3893 =back
3894
3895 =head2 attributes - get/set subroutine or variable attributes
3896
3897 =over
3898
3899 =item SYNOPSIS
3900
3901 =item DESCRIPTION
3902
3903 =over
3904
3905 =item Built-in Attributes
3906
3907 locked, method, lvalue
3908
3909 =item Available Subroutines
3910
3911 get, reftype
3912
3913 =item Package-specific Attribute Handling
3914
3915 FETCH_I<type>_ATTRIBUTES, MODIFY_I<type>_ATTRIBUTES
3916
3917 =item Syntax of Attribute Lists
3918
3919 =back
3920
3921 =item EXPORTS
3922
3923 =over
3924
3925 =item Default exports
3926
3927 =item Available exports
3928
3929 =item Export tags defined
3930
3931 =back
3932
3933 =item EXAMPLES
3934
3935 =item SEE ALSO
3936
3937 =back
3938
3939 =head2 attrs - set/get attributes of a subroutine (deprecated)
3940
3941 =over
3942
3943 =item SYNOPSIS
3944
3945 =item DESCRIPTION
3946
3947 method, locked
3948
3949 =back
3950
3951 =head2 autouse - postpone load of modules until a function is used
3952
3953 =over
3954
3955 =item SYNOPSIS
3956
3957 =item DESCRIPTION
3958
3959 =item WARNING
3960
3961 =item AUTHOR
3962
3963 =item SEE ALSO
3964
3965 =back
3966
3967 =head2 base - Establish IS-A relationship with base class at compile time
3968
3969 =over
3970
3971 =item SYNOPSIS
3972
3973 =item DESCRIPTION
3974
3975 =item HISTORY
3976
3977 =item SEE ALSO
3978
3979 =back
3980
3981 =head2 blib - Use MakeMaker's uninstalled version of a package
3982
3983 =over
3984
3985 =item SYNOPSIS
3986
3987 =item DESCRIPTION
3988
3989 =item BUGS
3990
3991 =item AUTHOR
3992
3993 =back
3994
3995 =head2 bytes - Perl pragma to force byte semantics rather than character
3996 semantics
3997
3998 =over
3999
4000 =item SYNOPSIS
4001
4002 =item DESCRIPTION
4003
4004 =item SEE ALSO
4005
4006 =back
4007
4008 =head2 charnames - define character names for C<\N{named}> string literal
4009 escape.
4010
4011 =over
4012
4013 =item SYNOPSIS
4014
4015 =item DESCRIPTION
4016
4017 =item CUSTOM TRANSLATORS
4018
4019 =item BUGS
4020
4021 =back
4022
4023 =head2 constant - Perl pragma to declare constants
4024
4025 =over
4026
4027 =item SYNOPSIS
4028
4029 =item DESCRIPTION
4030
4031 =item NOTES
4032
4033 =item TECHNICAL NOTE
4034
4035 =item BUGS
4036
4037 =item AUTHOR
4038
4039 =item COPYRIGHT
4040
4041 =back
4042
4043 =head2 diagnostics - Perl compiler pragma to force verbose warning
4044 diagnostics
4045
4046 =over
4047
4048 =item SYNOPSIS
4049
4050 =item DESCRIPTION
4051
4052 =over
4053
4054 =item The C<diagnostics> Pragma
4055
4056 =item The I<splain> Program
4057
4058 =back
4059
4060 =item EXAMPLES
4061
4062 =item INTERNALS
4063
4064 =item BUGS
4065
4066 =item AUTHOR
4067
4068 =back
4069
4070 =head2 fields - compile-time class fields
4071
4072 =over
4073
4074 =item SYNOPSIS
4075
4076 =item DESCRIPTION
4077
4078 new, phash
4079
4080 =item SEE ALSO
4081
4082 =back
4083
4084 =head2 filetest - Perl pragma to control the filetest permission operators
4085
4086 =over
4087
4088 =item SYNOPSIS
4089
4090 =item DESCRIPTION
4091
4092 =over
4093
4094 =item subpragma access
4095
4096 =back
4097
4098 =back
4099
4100 =head2 integer - Perl pragma to compute arithmetic in integer instead of
4101 double
4102
4103 =over
4104
4105 =item SYNOPSIS
4106
4107 =item DESCRIPTION
4108
4109 =back
4110
4111 =head2 less - perl pragma to request less of something from the compiler
4112
4113 =over
4114
4115 =item SYNOPSIS
4116
4117 =item DESCRIPTION
4118
4119 =back
4120
4121 =head2 lib - manipulate @INC at compile time
4122
4123 =over
4124
4125 =item SYNOPSIS
4126
4127 =item DESCRIPTION
4128
4129 =over
4130
4131 =item Adding directories to @INC
4132
4133 =item Deleting directories from @INC
4134
4135 =item Restoring original @INC
4136
4137 =back
4138
4139 =item SEE ALSO
4140
4141 =item AUTHOR
4142
4143 =back
4144
4145 =head2 locale - Perl pragma to use and avoid POSIX locales for built-in
4146 operations
4147
4148 =over
4149
4150 =item SYNOPSIS
4151
4152 =item DESCRIPTION
4153
4154 =back
4155
4156 =head2 open - perl pragma to set default disciplines for input and output
4157
4158 =over
4159
4160 =item SYNOPSIS
4161
4162 =item DESCRIPTION
4163
4164 =item UNIMPLEMENTED FUNCTIONALITY
4165
4166 =item SEE ALSO
4167
4168 =back
4169
4170 =head2 ops - Perl pragma to restrict unsafe operations when compiling
4171
4172 =over
4173
4174 =item SYNOPSIS  
4175
4176 =item DESCRIPTION
4177
4178 =item SEE ALSO
4179
4180 =back
4181
4182 =head2 overload - Package for overloading perl operations
4183
4184 =over
4185
4186 =item SYNOPSIS
4187
4188 =item DESCRIPTION
4189
4190 =over
4191
4192 =item Declaration of overloaded functions
4193
4194 =item Calling Conventions for Binary Operations
4195
4196 FALSE, TRUE, C<undef>
4197
4198 =item Calling Conventions for Unary Operations
4199
4200 =item Calling Conventions for Mutators
4201
4202 C<++> and C<-->, C<x=> and other assignment versions
4203
4204 =item Overloadable Operations
4205
4206 I<Arithmetic operations>, I<Comparison operations>, I<Bit operations>,
4207 I<Increment and decrement>, I<Transcendental functions>, I<Boolean, string
4208 and numeric conversion>, I<Iteration>, I<Dereferencing>, I<Special>
4209
4210 =item Inheritance and overloading
4211
4212 Strings as values of C<use overload> directive, Overloading of an operation
4213 is inherited by derived classes
4214
4215 =back
4216
4217 =item SPECIAL SYMBOLS FOR C<use overload>
4218
4219 =over
4220
4221 =item Last Resort
4222
4223 =item Fallback 
4224
4225 C<undef>, TRUE, defined, but FALSE
4226
4227 =item Copy Constructor
4228
4229 B<Example>
4230
4231 =back
4232
4233 =item MAGIC AUTOGENERATION
4234
4235 I<Assignment forms of arithmetic operations>, I<Conversion operations>,
4236 I<Increment and decrement>, C<abs($a)>, I<Unary minus>, I<Negation>,
4237 I<Concatenation>, I<Comparison operations>, I<Iterator>, I<Dereferencing>,
4238 I<Copy operator>
4239
4240 =item Losing overloading
4241
4242 =item Run-time Overloading
4243
4244 =item Public functions
4245
4246 overload::StrVal(arg), overload::Overloaded(arg), overload::Method(obj,op)
4247
4248 =item Overloading constants
4249
4250 integer, float, binary, q, qr
4251
4252 =item IMPLEMENTATION
4253
4254 =item Metaphor clash
4255
4256 =item Cookbook
4257
4258 =over
4259
4260 =item Two-face scalars
4261
4262 =item Two-face references
4263
4264 =item Symbolic calculator
4265
4266 =item I<Really> symbolic calculator
4267
4268 =back
4269
4270 =item AUTHOR
4271
4272 =item DIAGNOSTICS
4273
4274 =item BUGS
4275
4276 =back
4277
4278 =head2 re - Perl pragma to alter regular expression behaviour
4279
4280 =over
4281
4282 =item SYNOPSIS
4283
4284 =item DESCRIPTION
4285
4286 =back
4287
4288 =head2 sigtrap - Perl pragma to enable simple signal handling
4289
4290 =over
4291
4292 =item SYNOPSIS
4293
4294 =item DESCRIPTION
4295
4296 =item OPTIONS
4297
4298 =over
4299
4300 =item SIGNAL HANDLERS
4301
4302 B<stack-trace>, B<die>, B<handler> I<your-handler>
4303
4304 =item SIGNAL LISTS
4305
4306 B<normal-signals>, B<error-signals>, B<old-interface-signals>
4307
4308 =item OTHER
4309
4310 B<untrapped>, B<any>, I<signal>, I<number>
4311
4312 =back
4313
4314 =item EXAMPLES
4315
4316 =back
4317
4318 =head2 strict - Perl pragma to restrict unsafe constructs
4319
4320 =over
4321
4322 =item SYNOPSIS
4323
4324 =item DESCRIPTION
4325
4326 C<strict refs>, C<strict vars>, C<strict subs>
4327
4328 =back
4329
4330 =head2 subs - Perl pragma to predeclare sub names
4331
4332 =over
4333
4334 =item SYNOPSIS
4335
4336 =item DESCRIPTION
4337
4338 =back
4339
4340 =head2 utf8 - Perl pragma to enable/disable UTF-8 in source code
4341
4342 =over
4343
4344 =item SYNOPSIS
4345
4346 =item DESCRIPTION
4347
4348 =item SEE ALSO
4349
4350 =back
4351
4352 =head2 vars - Perl pragma to predeclare global variable names (obsolete)
4353
4354 =over
4355
4356 =item SYNOPSIS
4357
4358 =item DESCRIPTION
4359
4360 =back
4361
4362 =head2 warnings - Perl pragma to control optional warnings
4363
4364 =over
4365
4366 =item SYNOPSIS
4367
4368 =item DESCRIPTION
4369
4370 use warnings::register, warnings::enabled([$category]),
4371 warnings::warn([$category,] $message)
4372
4373 =back
4374
4375 =head1 MODULE DOCUMENTATION
4376
4377 =head2 AnyDBM_File - provide framework for multiple DBMs
4378
4379 =over
4380
4381 =item SYNOPSIS
4382
4383 =item DESCRIPTION
4384
4385 =over
4386
4387 =item DBM Comparisons
4388
4389 [0], [1], [2], [3]
4390
4391 =back
4392
4393 =item SEE ALSO
4394
4395 =back
4396
4397 =head2 AutoLoader - load subroutines only on demand
4398
4399 =over
4400
4401 =item SYNOPSIS
4402
4403 =item DESCRIPTION
4404
4405 =over
4406
4407 =item Subroutine Stubs
4408
4409 =item Using B<AutoLoader>'s AUTOLOAD Subroutine
4410
4411 =item Overriding B<AutoLoader>'s AUTOLOAD Subroutine
4412
4413 =item Package Lexicals
4414
4415 =item B<AutoLoader> vs. B<SelfLoader>
4416
4417 =back
4418
4419 =item CAVEATS
4420
4421 =item SEE ALSO
4422
4423 =back
4424
4425 =head2 AutoSplit - split a package for autoloading
4426
4427 =over
4428
4429 =item SYNOPSIS
4430
4431 =item DESCRIPTION
4432
4433 $keep, $check, $modtime
4434
4435 =over
4436
4437 =item Multiple packages
4438
4439 =back
4440
4441 =item DIAGNOSTICS
4442
4443 =back
4444
4445 =head2 B - The Perl Compiler
4446
4447 =over
4448
4449 =item SYNOPSIS
4450
4451 =item DESCRIPTION
4452
4453 =item OVERVIEW OF CLASSES
4454
4455 =over
4456
4457 =item SV-RELATED CLASSES
4458
4459 =item B::SV METHODS
4460
4461 REFCNT, FLAGS
4462
4463 =item B::IV METHODS
4464
4465 IV, IVX, needs64bits, packiv
4466
4467 =item B::NV METHODS
4468
4469 NV, NVX
4470
4471 =item B::RV METHODS
4472
4473 RV
4474
4475 =item B::PV METHODS
4476
4477 PV
4478
4479 =item B::PVMG METHODS
4480
4481 MAGIC, SvSTASH
4482
4483 =item B::MAGIC METHODS
4484
4485 MOREMAGIC, PRIVATE, TYPE, FLAGS, OBJ, PTR
4486
4487 =item B::PVLV METHODS
4488
4489 TARGOFF, TARGLEN, TYPE, TARG
4490
4491 =item B::BM METHODS
4492
4493 USEFUL, PREVIOUS, RARE, TABLE
4494
4495 =item B::GV METHODS
4496
4497 is_empty, NAME, STASH, SV, IO, FORM, AV, HV, EGV, CV, CVGEN, LINE, FILE,
4498 FILEGV, GvREFCNT, FLAGS
4499
4500 =item B::IO METHODS
4501
4502 LINES, PAGE, PAGE_LEN, LINES_LEFT, TOP_NAME, TOP_GV, FMT_NAME, FMT_GV,
4503 BOTTOM_NAME, BOTTOM_GV, SUBPROCESS, IoTYPE, IoFLAGS
4504
4505 =item B::AV METHODS
4506
4507 FILL, MAX, OFF, ARRAY, AvFLAGS
4508
4509 =item B::CV METHODS
4510
4511 STASH, START, ROOT, GV, FILE, DEPTH, PADLIST, OUTSIDE, XSUB, XSUBANY,
4512 CvFLAGS
4513
4514 =item B::HV METHODS
4515
4516 FILL, MAX, KEYS, RITER, NAME, PMROOT, ARRAY
4517
4518 =item OP-RELATED CLASSES
4519
4520 =item B::OP METHODS
4521
4522 next, sibling, name, ppaddr, desc, targ, type, seq, flags, private
4523
4524 =item B::UNOP METHOD
4525
4526 first
4527
4528 =item B::BINOP METHOD
4529
4530 last
4531
4532 =item B::LOGOP METHOD
4533
4534 other
4535
4536 =item B::LISTOP METHOD
4537
4538 children
4539
4540 =item B::PMOP METHODS
4541
4542 pmreplroot, pmreplstart, pmnext, pmregexp, pmflags, pmpermflags, precomp
4543
4544 =item B::SVOP METHOD
4545
4546 sv, gv
4547
4548 =item B::PADOP METHOD
4549
4550 padix
4551
4552 =item B::PVOP METHOD
4553
4554 pv
4555
4556 =item B::LOOP METHODS
4557
4558 redoop, nextop, lastop
4559
4560 =item B::COP METHODS
4561
4562 label, stash, file, cop_seq, arybase, line
4563
4564 =back
4565
4566 =item FUNCTIONS EXPORTED BY C<B>
4567
4568 main_cv, init_av, main_root, main_start, comppadlist, sv_undef, sv_yes,
4569 sv_no, amagic_generation, walkoptree(OP, METHOD), walkoptree_debug(DEBUG),
4570 walksymtable(SYMREF, METHOD, RECURSE), svref_2object(SV), ppname(OPNUM),
4571 hash(STR), cast_I32(I), minus_c, cstring(STR), class(OBJ), threadsv_names
4572
4573 =item AUTHOR
4574
4575 =back
4576
4577 =head2 B::Asmdata - Autogenerated data about Perl ops, used to generate
4578 bytecode
4579
4580 =over
4581
4582 =item SYNOPSIS
4583
4584 =item DESCRIPTION
4585
4586 =item AUTHOR
4587
4588 =back
4589
4590 =head2 B::Assembler - Assemble Perl bytecode
4591
4592 =over
4593
4594 =item SYNOPSIS
4595
4596 =item DESCRIPTION
4597
4598 =item AUTHOR
4599
4600 =back
4601
4602 =head2 B::Bblock - Walk basic blocks
4603
4604 =over
4605
4606 =item SYNOPSIS
4607
4608 =item DESCRIPTION
4609
4610 =item AUTHOR
4611
4612 =back
4613
4614 =head2 B::Bytecode - Perl compiler's bytecode backend
4615
4616 =over
4617
4618 =item SYNOPSIS
4619
4620 =item DESCRIPTION
4621
4622 =item OPTIONS
4623
4624 B<-ofilename>, B<-afilename>, B<-->, B<-f>, B<-fcompress-nullops>,
4625 B<-fomit-sequence-numbers>, B<-fbypass-nullops>, B<-fstrip-syntax-tree>,
4626 B<-On>, B<-D>, B<-Do>, B<-Db>, B<-Da>, B<-DC>, B<-S>, B<-m>
4627
4628 =item EXAMPLES
4629
4630 =item BUGS
4631
4632 =item AUTHOR
4633
4634 =back
4635
4636 =head2 B::C - Perl compiler's C backend
4637
4638 =over
4639
4640 =item SYNOPSIS
4641
4642 =item DESCRIPTION
4643
4644 =item OPTIONS
4645
4646 B<-ofilename>, B<-v>, B<-->, B<-uPackname>, B<-D>, B<-Do>, B<-Dc>, B<-DA>,
4647 B<-DC>, B<-DM>, B<-f>, B<-fcog>, B<-fno-cog>, B<-On>, B<-llimit>
4648
4649 =item EXAMPLES
4650
4651 =item BUGS
4652
4653 =item AUTHOR
4654
4655 =back
4656
4657 =head2 B::CC - Perl compiler's optimized C translation backend
4658
4659 =over
4660
4661 =item SYNOPSIS
4662
4663 =item DESCRIPTION
4664
4665 =item OPTIONS
4666
4667 B<-ofilename>, B<-v>, B<-->, B<-uPackname>, B<-mModulename>, B<-D>, B<-Dr>,
4668 B<-DO>, B<-Ds>, B<-Dp>, B<-Dq>, B<-Dl>, B<-Dt>, B<-f>,
4669 B<-ffreetmps-each-bblock>, B<-ffreetmps-each-loop>, B<-fomit-taint>, B<-On>
4670
4671 =item EXAMPLES
4672
4673 =item BUGS
4674
4675 =item DIFFERENCES
4676
4677 =over
4678
4679 =item Loops
4680
4681 =item Context of ".."
4682
4683 =item Arithmetic
4684
4685 =item Deprecated features
4686
4687 =back
4688
4689 =item AUTHOR
4690
4691 =back
4692
4693 =head2 B::Debug - Walk Perl syntax tree, printing debug info about ops
4694
4695 =over
4696
4697 =item SYNOPSIS
4698
4699 =item DESCRIPTION
4700
4701 =item AUTHOR
4702
4703 =back
4704
4705 =head2 B::Deparse - Perl compiler backend to produce perl code
4706
4707 =over
4708
4709 =item SYNOPSIS
4710
4711 =item DESCRIPTION
4712
4713 =item OPTIONS
4714
4715 B<-l>, B<-p>, B<-q>, B<-u>I<PACKAGE>, B<-s>I<LETTERS>, B<C>, B<i>I<NUMBER>,
4716 B<T>, B<v>I<STRING>B<.>
4717
4718 =item USING B::Deparse AS A MODULE
4719
4720 =over
4721
4722 =item Synopsis
4723
4724 =item Description
4725
4726 =item new
4727
4728 =item coderef2text
4729
4730 =back
4731
4732 =item BUGS
4733
4734 =item AUTHOR
4735
4736 =back
4737
4738 =head2 B::Disassembler - Disassemble Perl bytecode
4739
4740 =over
4741
4742 =item SYNOPSIS
4743
4744 =item DESCRIPTION
4745
4746 =item AUTHOR
4747
4748 =back
4749
4750 =head2 B::Lint - Perl lint
4751
4752 =over
4753
4754 =item SYNOPSIS
4755
4756 =item DESCRIPTION
4757
4758 =item OPTIONS AND LINT CHECKS
4759
4760 B<context>, B<implicit-read> and B<implicit-write>, B<dollar-underscore>,
4761 B<private-names>, B<undefined-subs>, B<regexp-variables>, B<all>, B<none>
4762
4763 =item NON LINT-CHECK OPTIONS
4764
4765 B<-u Package>
4766
4767 =item BUGS
4768
4769 =item AUTHOR
4770
4771 =back
4772
4773 =head2 B::O, O - Generic interface to Perl Compiler backends
4774
4775 =over
4776
4777 =item SYNOPSIS
4778
4779 =item DESCRIPTION
4780
4781 =item CONVENTIONS
4782
4783 =item IMPLEMENTATION
4784
4785 =item AUTHOR
4786
4787 =back
4788
4789 =head2 B::Showlex - Show lexical variables used in functions or files
4790
4791 =over
4792
4793 =item SYNOPSIS
4794
4795 =item DESCRIPTION
4796
4797 =item AUTHOR
4798
4799 =back
4800
4801 =head2 B::Stackobj - Helper module for CC backend
4802
4803 =over
4804
4805 =item SYNOPSIS
4806
4807 =item DESCRIPTION
4808
4809 =item AUTHOR
4810
4811 =back
4812
4813 =head2 B::Terse - Walk Perl syntax tree, printing terse info about ops
4814
4815 =over
4816
4817 =item SYNOPSIS
4818
4819 =item DESCRIPTION
4820
4821 =item AUTHOR
4822
4823 =back
4824
4825 =head2 B::Xref - Generates cross reference reports for Perl programs
4826
4827 =over
4828
4829 =item SYNOPSIS
4830
4831 =item DESCRIPTION
4832
4833 =item OPTIONS
4834
4835 C<-oFILENAME>, C<-r>, C<-D[tO]>
4836
4837 =item BUGS
4838
4839 =item AUTHOR
4840
4841 =back
4842
4843 =head2 Bblock, B::Bblock - Walk basic blocks
4844
4845 =over
4846
4847 =item SYNOPSIS
4848
4849 =item DESCRIPTION
4850
4851 =item AUTHOR
4852
4853 =back
4854
4855 =head2 Benchmark - benchmark running times of Perl code
4856
4857 =over
4858
4859 =item SYNOPSIS
4860
4861 =item DESCRIPTION
4862
4863 =over
4864
4865 =item Methods
4866
4867 new, debug, iters
4868
4869 =item Standard Exports
4870
4871 timeit(COUNT, CODE), timethis ( COUNT, CODE, [ TITLE, [ STYLE ]] ),
4872 timethese ( COUNT, CODEHASHREF, [ STYLE ] ), timediff ( T1, T2 ), timestr (
4873 TIMEDIFF, [ STYLE, [ FORMAT ] ] )
4874
4875 =item Optional Exports
4876
4877 clearcache ( COUNT ), clearallcache ( ), cmpthese ( COUT, CODEHASHREF, [
4878 STYLE ] ), cmpthese ( RESULTSHASHREF ), countit(TIME, CODE), disablecache (
4879 ), enablecache ( ), timesum ( T1, T2 )
4880
4881 =back
4882
4883 =item NOTES
4884
4885 =item EXAMPLES
4886
4887 =item INHERITANCE
4888
4889 =item CAVEATS
4890
4891 =item SEE ALSO
4892
4893 =item AUTHORS
4894
4895 =item MODIFICATION HISTORY
4896
4897 =back
4898
4899 =head2 ByteLoader - load byte compiled perl code
4900
4901 =over
4902
4903 =item SYNOPSIS
4904
4905 =item DESCRIPTION
4906
4907 =item AUTHOR
4908
4909 =item SEE ALSO
4910
4911 =back
4912
4913 =head2 Bytecode, B::Bytecode - Perl compiler's bytecode backend
4914
4915 =over
4916
4917 =item SYNOPSIS
4918
4919 =item DESCRIPTION
4920
4921 =item OPTIONS
4922
4923 B<-ofilename>, B<-afilename>, B<-->, B<-f>, B<-fcompress-nullops>,
4924 B<-fomit-sequence-numbers>, B<-fbypass-nullops>, B<-fstrip-syntax-tree>,
4925 B<-On>, B<-D>, B<-Do>, B<-Db>, B<-Da>, B<-DC>, B<-S>, B<-m>
4926
4927 =item EXAMPLES
4928
4929 =item BUGS
4930
4931 =item AUTHOR
4932
4933 =back
4934
4935 =head2 CGI - Simple Common Gateway Interface Class
4936
4937 =over
4938
4939 =item SYNOPSIS
4940
4941 =item ABSTRACT
4942
4943 =item DESCRIPTION
4944
4945 =over
4946
4947 =item PROGRAMMING STYLE
4948
4949 =item CALLING CGI.PM ROUTINES
4950
4951 1. Use another name for the argument, if one is available.  Forexample,
4952 -value is an alias for -values, 2. Change the capitalization, e.g. -Values,
4953 3. Put quotes around the argument name, e.g. '-values'
4954
4955 =item CREATING A NEW QUERY OBJECT (OBJECT-ORIENTED STYLE):
4956
4957 =item CREATING A NEW QUERY OBJECT FROM AN INPUT FILE
4958
4959 =item FETCHING A LIST OF KEYWORDS FROM THE QUERY:
4960
4961 =item FETCHING THE NAMES OF ALL THE PARAMETERS PASSED TO YOUR SCRIPT:
4962
4963 =item FETCHING THE VALUE OR VALUES OF A SINGLE NAMED PARAMETER:
4964
4965 =item SETTING THE VALUE(S) OF A NAMED PARAMETER:
4966
4967 =item APPENDING ADDITIONAL VALUES TO A NAMED PARAMETER:
4968
4969 =item IMPORTING ALL PARAMETERS INTO A NAMESPACE:
4970
4971 =item DELETING A PARAMETER COMPLETELY:
4972
4973 =item DELETING ALL PARAMETERS:
4974
4975 =item DIRECT ACCESS TO THE PARAMETER LIST:
4976
4977 =item FETCHING THE PARAMETER LIST AS A HASH:
4978
4979 =item SAVING THE STATE OF THE SCRIPT TO A FILE:
4980
4981 =item RETRIEVING CGI ERRORS
4982
4983 =item USING THE FUNCTION-ORIENTED INTERFACE
4984
4985 B<:cgi>, B<:form>, B<:html2>, B<:html3>, B<:netscape>, B<:html>,
4986 B<:standard>, B<:all>
4987
4988 =item PRAGMAS
4989
4990 -any, -compile, -nph, -newstyle_urls, -autoload, -no_debug,
4991 -private_tempfiles
4992
4993 =item SPECIAL FORMS FOR IMPORTING HTML-TAG FUNCTIONS
4994
4995 1. start_table() (generates a <TABLE> tag), 2. end_table() (generates a
4996 </TABLE> tag), 3. start_ul() (generates a <UL> tag), 4. end_ul() (generates
4997 a </UL> tag)
4998
4999 =back
5000
5001 =item GENERATING DYNAMIC DOCUMENTS
5002
5003 =over
5004
5005 =item CREATING A STANDARD HTTP HEADER:
5006
5007 =item GENERATING A REDIRECTION HEADER
5008
5009 =item CREATING THE HTML DOCUMENT HEADER
5010
5011 B<Parameters:>, 4, 5, 6..
5012
5013 =item ENDING THE HTML DOCUMENT:
5014
5015 =item CREATING A SELF-REFERENCING URL THAT PRESERVES STATE INFORMATION:
5016
5017 =item OBTAINING THE SCRIPT'S URL
5018
5019 B<-absolute>, B<-relative>, B<-full>, B<-path> (B<-path_info>), B<-query>
5020 (B<-query_string>)
5021
5022 =item MIXING POST AND URL PARAMETERS
5023
5024 =back
5025
5026 =item CREATING STANDARD HTML ELEMENTS:
5027
5028 =over
5029
5030 =item PROVIDING ARGUMENTS TO HTML SHORTCUTS
5031
5032 =item THE DISTRIBUTIVE PROPERTY OF HTML SHORTCUTS
5033
5034 =item HTML SHORTCUTS AND LIST INTERPOLATION
5035
5036 =item NON-STANDARD HTML SHORTCUTS
5037
5038 =item PRETTY-PRINTING HTML
5039
5040 =back
5041
5042 =item CREATING FILL-OUT FORMS:
5043
5044 =over
5045
5046 =item CREATING AN ISINDEX TAG
5047
5048 =item STARTING AND ENDING A FORM
5049
5050 B<application/x-www-form-urlencoded>, B<multipart/form-data>
5051
5052 =item CREATING A TEXT FIELD
5053
5054 B<Parameters>
5055
5056 =item CREATING A BIG TEXT FIELD
5057
5058 =item CREATING A PASSWORD FIELD
5059
5060 =item CREATING A FILE UPLOAD FIELD
5061
5062 B<Parameters>
5063
5064 =item CREATING A POPUP MENU
5065
5066 =item CREATING A SCROLLING LIST
5067
5068 B<Parameters:>
5069
5070 =item CREATING A GROUP OF RELATED CHECKBOXES
5071
5072 B<Parameters:>
5073
5074 =item CREATING A STANDALONE CHECKBOX
5075
5076 B<Parameters:>
5077
5078 =item CREATING A RADIO BUTTON GROUP
5079
5080 B<Parameters:>
5081
5082 =item CREATING A SUBMIT BUTTON 
5083
5084 B<Parameters:>
5085
5086 =item CREATING A RESET BUTTON
5087
5088 =item CREATING A DEFAULT BUTTON
5089
5090 =item CREATING A HIDDEN FIELD
5091
5092 B<Parameters:>
5093
5094 =item CREATING A CLICKABLE IMAGE BUTTON
5095
5096 B<Parameters:>, 3.The third option (-align, optional) is an alignment type,
5097 and may be
5098 TOP, BOTTOM or MIDDLE
5099
5100 =item CREATING A JAVASCRIPT ACTION BUTTON
5101
5102 =back
5103
5104 =item HTTP COOKIES
5105
5106 1. an expiration time, 2. a domain, 3. a path, 4. a "secure" flag,
5107 B<-name>, B<-value>, B<-path>, B<-domain>, B<-expires>, B<-secure>
5108
5109 =item WORKING WITH FRAMES
5110
5111 1. Create a <Frameset> document, 2. Specify the destination for the
5112 document in the HTTP header, 3. Specify the destination for the document in
5113 the <FORM> tag
5114
5115 =item LIMITED SUPPORT FOR CASCADING STYLE SHEETS
5116
5117 =item DEBUGGING
5118
5119 =over
5120
5121 =item DUMPING OUT ALL THE NAME/VALUE PAIRS
5122
5123 =back
5124
5125 =item FETCHING ENVIRONMENT VARIABLES
5126
5127 B<Accept()>, B<raw_cookie()>, B<user_agent()>, B<path_info()>,
5128 B<path_translated()>, B<remote_host()>, B<script_name()>Return the script
5129 name as a partial URL, for self-refering
5130 scripts, B<referer()>, B<auth_type ()>, B<server_name ()>, B<virtual_host
5131 ()>, B<server_software ()>, B<remote_user ()>, B<user_name ()>,
5132 B<request_method()>, B<content_type()>, B<http()>, B<https()>
5133
5134 =item USING NPH SCRIPTS
5135
5136 In the B<use> statement, By calling the B<nph()> method:, By using B<-nph>
5137 parameters in the B<header()> and B<redirect()>  statements:
5138
5139 =item Server Push
5140
5141 multipart_init(), multipart_start(), multipart_end()
5142
5143 =item Avoiding Denial of Service Attacks
5144
5145 B<$CGI::POST_MAX>, B<$CGI::DISABLE_UPLOADS>, B<1. On a script-by-script
5146 basis>, B<2. Globally for all scripts>
5147
5148 =item COMPATIBILITY WITH CGI-LIB.PL
5149
5150 =item AUTHOR INFORMATION
5151
5152 =item CREDITS
5153
5154 Matt Heffron (heffron@falstaff.css.beckman.com), James Taylor
5155 (james.taylor@srs.gov), Scott Anguish <sanguish@digifix.com>, Mike Jewell
5156 (mlj3u@virginia.edu), Timothy Shimmin (tes@kbs.citri.edu.au), Joergen Haegg
5157 (jh@axis.se), Laurent Delfosse (delfosse@delfosse.com), Richard Resnick
5158 (applepi1@aol.com), Craig Bishop (csb@barwonwater.vic.gov.au), Tony Curtis
5159 (tc@vcpc.univie.ac.at), Tim Bunce (Tim.Bunce@ig.co.uk), Tom Christiansen
5160 (tchrist@convex.com), Andreas Koenig (k@franz.ww.TU-Berlin.DE), Tim
5161 MacKenzie (Tim.MacKenzie@fulcrum.com.au), Kevin B. Hendricks
5162 (kbhend@dogwood.tyler.wm.edu), Stephen Dahmen (joyfire@inxpress.net), Ed
5163 Jordan (ed@fidalgo.net), David Alan Pisoni (david@cnation.com), Doug
5164 MacEachern (dougm@opengroup.org), Robin Houston (robin@oneworld.org),
5165 ...and many many more..
5166
5167 =item A COMPLETE EXAMPLE OF A SIMPLE FORM-BASED SCRIPT
5168
5169 =item BUGS
5170
5171 =item SEE ALSO
5172
5173 =back
5174
5175 =head2 CGI::Apache - Backward compatibility module for CGI.pm
5176
5177 =over
5178
5179 =item SYNOPSIS
5180
5181 =item ABSTRACT
5182
5183 =item DESCRIPTION
5184
5185 =item AUTHOR INFORMATION
5186
5187 =item BUGS
5188
5189 =item SEE ALSO
5190
5191 =back
5192
5193 =head2 CGI::Carp, B<CGI::Carp> - CGI routines for writing to the HTTPD (or
5194 other) error log
5195
5196 =over
5197
5198 =item SYNOPSIS
5199
5200 =item DESCRIPTION
5201
5202 =item REDIRECTING ERROR MESSAGES
5203
5204 =item MAKING PERL ERRORS APPEAR IN THE BROWSER WINDOW
5205
5206 =over
5207
5208 =item Changing the default message
5209
5210 =back
5211
5212 =item CHANGE LOG
5213
5214 =item AUTHORS
5215
5216 =item SEE ALSO
5217
5218 =back
5219
5220 =head2 CGI::Cookie - Interface to Netscape Cookies
5221
5222 =over
5223
5224 =item SYNOPSIS
5225
5226 =item DESCRIPTION
5227
5228 =item USING CGI::Cookie
5229
5230 B<1. expiration date>, B<2. domain>, B<3. path>, B<4. secure flag>
5231
5232 =over
5233
5234 =item Creating New Cookies
5235
5236 =item Sending the Cookie to the Browser
5237
5238 =item Recovering Previous Cookies
5239
5240 =item Manipulating Cookies
5241
5242 B<name()>, B<value()>, B<domain()>, B<path()>, B<expires()>
5243
5244 =back
5245
5246 =item AUTHOR INFORMATION
5247
5248 =item BUGS
5249
5250 =item SEE ALSO
5251
5252 =back
5253
5254 =head2 CGI::Fast - CGI Interface for Fast CGI
5255
5256 =over
5257
5258 =item SYNOPSIS
5259
5260 =item DESCRIPTION
5261
5262 =item OTHER PIECES OF THE PUZZLE
5263
5264 =item WRITING FASTCGI PERL SCRIPTS
5265
5266 =item INSTALLING FASTCGI SCRIPTS
5267
5268 =item USING FASTCGI SCRIPTS AS CGI SCRIPTS
5269
5270 =item CAVEATS
5271
5272 =item AUTHOR INFORMATION
5273
5274 =item BUGS
5275
5276 =item SEE ALSO
5277
5278 =back
5279
5280 =head2 CGI::Pretty - module to produce nicely formatted HTML code
5281
5282 =over
5283
5284 =item SYNOPSIS
5285
5286 =item DESCRIPTION
5287
5288 =over
5289
5290 =item Tags that won't be formatted
5291
5292 =item Customizing the Indenting
5293
5294 =back
5295
5296 =item BUGS
5297
5298 =item AUTHOR
5299
5300 =item SEE ALSO
5301
5302 =back
5303
5304 =head2 CGI::Push - Simple Interface to Server Push
5305
5306 =over
5307
5308 =item SYNOPSIS
5309
5310 =item DESCRIPTION
5311
5312 =item USING CGI::Push
5313
5314 -next_page, -last_page, -type, -delay, -cookie, -target, -expires
5315
5316 =over
5317
5318 =item Heterogeneous Pages
5319
5320 =item Changing the Page Delay on the Fly
5321
5322 =back
5323
5324 =item INSTALLING CGI::Push SCRIPTS
5325
5326 =item AUTHOR INFORMATION
5327
5328 =item BUGS
5329
5330 =item SEE ALSO
5331
5332 =back
5333
5334 =head2 CGI::Switch - Backward compatibility module for defunct CGI::Switch
5335
5336 =over
5337
5338 =item SYNOPSIS
5339
5340 =item ABSTRACT
5341
5342 =item DESCRIPTION
5343
5344 =item AUTHOR INFORMATION
5345
5346 =item BUGS
5347
5348 =item SEE ALSO
5349
5350 =back
5351
5352 =head2 CPAN - query, download and build perl modules from CPAN sites
5353
5354 =over
5355
5356 =item SYNOPSIS
5357
5358 =item DESCRIPTION
5359
5360 =over
5361
5362 =item Interactive Mode
5363
5364 Searching for authors, bundles, distribution files and modules, make, test,
5365 install, clean  modules or distributions, get, readme, look module or
5366 distribution, Signals
5367
5368 =item CPAN::Shell
5369
5370 =item autobundle
5371
5372 =item recompile
5373
5374 =item The four C<CPAN::*> Classes: Author, Bundle, Module, Distribution
5375
5376 =item ProgrammerE<39>s interface
5377
5378 expand($type,@things), Programming Examples
5379
5380 =item Methods in the four Classes
5381
5382 =item Cache Manager
5383
5384 =item Bundles
5385
5386 =item Prerequisites
5387
5388 =item Finding packages and VERSION
5389
5390 =item Debugging
5391
5392 =item Floppy, Zip, Offline Mode
5393
5394 =back
5395
5396 =item CONFIGURATION
5397
5398 C<o conf E<lt>scalar optionE<gt>>, C<o conf E<lt>scalar optionE<gt>
5399 E<lt>valueE<gt>>, C<o conf E<lt>list optionE<gt>>, C<o conf E<lt>list
5400 optionE<gt> [shift|pop]>, C<o conf E<lt>list optionE<gt>
5401 [unshift|push|splice] E<lt>listE<gt>>
5402
5403 =over
5404
5405 =item Note on urllist parameter's format
5406
5407 =item urllist parameter has CD-ROM support
5408
5409 =back
5410
5411 =item SECURITY
5412
5413 =item EXPORT
5414
5415 =item POPULATE AN INSTALLATION WITH LOTS OF MODULES
5416
5417 =item WORKING WITH CPAN.pm BEHIND FIREWALLS
5418
5419 http firewall, ftp firewall, One way visibility, SOCKS, IP Masquerade
5420
5421 =item BUGS
5422
5423 =item AUTHOR
5424
5425 =item SEE ALSO
5426
5427 =back
5428
5429 =head2 CPAN::FirstTime - Utility for CPAN::Config file Initialization
5430
5431 =over
5432
5433 =item SYNOPSIS
5434
5435 =item DESCRIPTION
5436
5437 =back
5438
5439 =head2 CPANox, CPAN::Nox - Wrapper around CPAN.pm without using any XS
5440 module
5441
5442 =over
5443
5444 =item SYNOPSIS
5445
5446 =item DESCRIPTION
5447
5448 =item  SEE ALSO
5449
5450 =back
5451
5452 =head2 Carp, carp    - warn of errors (from perspective of caller)
5453
5454 =over
5455
5456 =item SYNOPSIS
5457
5458 =item DESCRIPTION
5459
5460 =over
5461
5462 =item Forcing a Stack Trace
5463
5464 =back
5465
5466 =item BUGS
5467
5468 =back
5469
5470 =head2 Carp::Heavy - Carp guts
5471
5472 =over
5473
5474 =item SYNOPIS
5475
5476 =item DESCRIPTION
5477
5478 =back
5479
5480 =head2 Class::Struct - declare struct-like datatypes as Perl classes
5481
5482 =over
5483
5484 =item SYNOPSIS
5485
5486 =item DESCRIPTION
5487
5488 =over
5489
5490 =item The C<struct()> function
5491
5492 =item Element Types and Accessor Methods
5493
5494 Scalar (C<'$'> or C<'*$'>), Array (C<'@'> or C<'*@'>), Hash (C<'%'> or
5495 C<'*%'>), Class (C<'Class_Name'> or C<'*Class_Name'>)
5496
5497 =item Initializing with C<new>
5498
5499 =back
5500
5501 =item EXAMPLES
5502
5503 Example 1, Example 2, Example 3
5504
5505 =item Author and Modification History
5506
5507 =back
5508
5509 =head2 Config - access Perl configuration information
5510
5511 =over
5512
5513 =item SYNOPSIS
5514
5515 =item DESCRIPTION
5516
5517 myconfig(), config_sh(), config_vars(@names)
5518
5519 =item EXAMPLE
5520
5521 =item WARNING
5522
5523 =item GLOSSARY
5524
5525 =over
5526
5527 =item _
5528
5529 C<_a>, C<_exe>, C<_o>
5530
5531 =item a
5532
5533 C<afs>, C<alignbytes>, C<ansi2knr>, C<aphostname>, C<api_revision>,
5534 C<api_subversion>, C<api_version>, C<api_versionstring>, C<ar>, C<archlib>,
5535 C<archlibexp>, C<archname64>, C<archname>, C<archobjs>, C<awk>
5536
5537 =item b
5538
5539 C<baserev>, C<bash>, C<bin>, C<bincompat5005>, C<binexp>, C<bison>,
5540 C<byacc>, C<byteorder>
5541
5542 =item c
5543
5544 C<c>, C<castflags>, C<cat>, C<cc>, C<cccdlflags>, C<ccdlflags>, C<ccflags>,
5545 C<ccsymbols>, C<cf_by>, C<cf_email>, C<cf_time>, C<charsize>, C<chgrp>,
5546 C<chmod>, C<chown>, C<clocktype>, C<comm>, C<compress>
5547
5548 =item C
5549
5550 C<CONFIGDOTSH>, C<contains>, C<cp>, C<cpio>, C<cpp>, C<cpp_stuff>,
5551 C<cppccsymbols>, C<cppflags>, C<cpplast>, C<cppminus>, C<cpprun>,
5552 C<cppstdin>, C<cppsymbols>, C<crosscompile>, C<cryptlib>, C<csh>
5553
5554 =item d
5555
5556 C<d_access>, C<d_accessx>, C<d_alarm>, C<d_archlib>, C<d_atolf>,
5557 C<d_atoll>, C<d_attribut>, C<d_bcmp>, C<d_bcopy>, C<d_bincompat5005>,
5558 C<d_bsd>, C<d_bsdgetpgrp>, C<d_bsdsetpgrp>, C<d_bzero>, C<d_casti32>,
5559 C<d_castneg>, C<d_charvspr>, C<d_chown>, C<d_chroot>, C<d_chsize>,
5560 C<d_closedir>, C<d_const>, C<d_crypt>, C<d_csh>, C<d_cuserid>,
5561 C<d_dbl_dig>, C<d_difftime>, C<d_dirnamlen>, C<d_dlerror>, C<d_dlopen>,
5562 C<d_dlsymun>, C<d_dosuid>, C<d_drand48proto>, C<d_dup2>, C<d_eaccess>,
5563 C<d_endgrent>, C<d_endhent>, C<d_endnent>, C<d_endpent>, C<d_endpwent>,
5564 C<d_endsent>, C<d_endspent>, C<d_eofnblk>, C<d_eunice>, C<d_fchmod>,
5565 C<d_fchown>, C<d_fcntl>, C<d_fd_macros>, C<d_fd_set>, C<d_fds_bits>,
5566 C<d_fgetpos>, C<d_flexfnam>, C<d_flock>, C<d_fork>, C<d_fpathconf>,
5567 C<d_fpos64_t>, C<d_fs_data_s>, C<d_fseeko>, C<d_fsetpos>, C<d_fstatfs>,
5568 C<d_fstatvfs>, C<d_ftello>, C<d_ftime>, C<d_Gconvert>, C<d_getcwd>,
5569 C<d_getfsstat>, C<d_getgrent>, C<d_getgrps>, C<d_gethbyaddr>,
5570 C<d_gethbyname>, C<d_gethent>, C<d_gethname>, C<d_gethostprotos>,
5571 C<d_getlogin>, C<d_getmnt>, C<d_getmntent>, C<d_getnbyaddr>,
5572 C<d_getnbyname>, C<d_getnent>, C<d_getnetprotos>, C<d_getpbyname>,
5573 C<d_getpbynumber>, C<d_getpent>, C<d_getpgid>, C<d_getpgrp2>, C<d_getpgrp>,
5574 C<d_getppid>, C<d_getprior>, C<d_getprotoprotos>, C<d_getpwent>,
5575 C<d_getsbyname>, C<d_getsbyport>, C<d_getsent>, C<d_getservprotos>,
5576 C<d_getspent>, C<d_getspnam>, C<d_gettimeod>, C<d_gnulibc>, C<d_grpasswd>,
5577 C<d_hasmntopt>, C<d_htonl>, C<d_iconv>, C<d_index>, C<d_inetaton>,
5578 C<d_int64_t>, C<d_isascii>, C<d_killpg>, C<d_lchown>, C<d_ldbl_dig>,
5579 C<d_link>, C<d_locconv>, C<d_lockf>, C<d_longdbl>, C<d_longlong>,
5580 C<d_lseekproto>, C<d_lstat>, C<d_madvise>, C<d_mblen>, C<d_mbstowcs>,
5581 C<d_mbtowc>, C<d_memchr>, C<d_memcmp>, C<d_memcpy>, C<d_memmove>,
5582 C<d_memset>, C<d_mkdir>, C<d_mkdtemp>, C<d_mkfifo>, C<d_mkstemp>,
5583 C<d_mkstemps>, C<d_mktime>, C<d_mmap>, C<d_mprotect>, C<d_msg>,
5584 C<d_msg_ctrunc>, C<d_msg_dontroute>, C<d_msg_oob>, C<d_msg_peek>,
5585 C<d_msg_proxy>, C<d_msgctl>, C<d_msgget>, C<d_msgrcv>, C<d_msgsnd>,
5586 C<d_msync>, C<d_munmap>, C<d_mymalloc>, C<d_nice>, C<d_nv_preserves_uv>,
5587 C<d_off64_t>, C<d_old_pthread_create_joinable>, C<d_oldpthreads>,
5588 C<d_oldsock>, C<d_open3>, C<d_pathconf>, C<d_pause>, C<d_phostname>,
5589 C<d_pipe>, C<d_poll>, C<d_portable>, C<d_PRId64>, C<d_PRIeldbl>,
5590 C<d_PRIEldbl>, C<d_PRIfldbl>, C<d_PRIFldbl>, C<d_PRIgldbl>, C<d_PRIGldbl>,
5591 C<d_PRIi64>, C<d_PRIo64>, C<d_PRIu64>, C<d_PRIx64>, C<d_PRIX64>,
5592 C<d_pthread_yield>, C<d_pwage>, C<d_pwchange>, C<d_pwclass>,
5593 C<d_pwcomment>, C<d_pwexpire>, C<d_pwgecos>, C<d_pwpasswd>, C<d_pwquota>,
5594 C<d_qgcvt>, C<d_quad>, C<d_readdir>, C<d_readlink>, C<d_rename>,
5595 C<d_rewinddir>, C<d_rmdir>, C<d_safebcpy>, C<d_safemcpy>, C<d_sanemcmp>,
5596 C<d_sched_yield>, C<d_scm_rights>, C<d_seekdir>, C<d_select>, C<d_sem>,
5597 C<d_semctl>, C<d_semctl_semid_ds>, C<d_semctl_semun>, C<d_semget>,
5598 C<d_semop>, C<d_setegid>, C<d_seteuid>, C<d_setgrent>, C<d_setgrps>,
5599 C<d_sethent>, C<d_setlinebuf>, C<d_setlocale>, C<d_setnent>, C<d_setpent>,
5600 C<d_setpgid>, C<d_setpgrp2>, C<d_setpgrp>, C<d_setprior>, C<d_setpwent>,
5601 C<d_setregid>, C<d_setresgid>, C<d_setresuid>, C<d_setreuid>, C<d_setrgid>,
5602 C<d_setruid>, C<d_setsent>, C<d_setsid>, C<d_setspent>, C<d_setvbuf>,
5603 C<d_sfio>, C<d_shm>, C<d_shmat>, C<d_shmatprototype>, C<d_shmctl>,
5604 C<d_shmdt>, C<d_shmget>, C<d_sigaction>, C<d_sigsetjmp>, C<d_socket>,
5605 C<d_socklen_t>, C<d_sockpair>, C<d_sqrtl>, C<d_statblks>,
5606 C<d_statfs_f_flags>, C<d_statfs_s>, C<d_statvfs>, C<d_stdio_cnt_lval>,
5607 C<d_stdio_ptr_lval>, C<d_stdio_stream_array>, C<d_stdiobase>,
5608 C<d_stdstdio>, C<d_strchr>, C<d_strcoll>, C<d_strctcpy>, C<d_strerrm>,
5609 C<d_strerror>, C<d_strtod>, C<d_strtol>, C<d_strtold>, C<d_strtoll>,
5610 C<d_strtoul>, C<d_strtoull>, C<d_strtouq>, C<d_strxfrm>, C<d_suidsafe>,
5611 C<d_symlink>, C<d_syscall>, C<d_sysconf>, C<d_sysernlst>, C<d_syserrlst>,
5612 C<d_system>, C<d_tcgetpgrp>, C<d_tcsetpgrp>, C<d_telldir>,
5613 C<d_telldirproto>, C<d_time>, C<d_times>, C<d_truncate>, C<d_tzname>,
5614 C<d_umask>, C<d_uname>, C<d_union_semun>, C<d_ustat>, C<d_vendorarch>,
5615 C<d_vendorbin>, C<d_vendorlib>, C<d_vfork>, C<d_void_closedir>,
5616 C<d_voidsig>, C<d_voidtty>, C<d_volatile>, C<d_vprintf>, C<d_wait4>,
5617 C<d_waitpid>, C<d_wcstombs>, C<d_wctomb>, C<d_xenix>, C<date>,
5618 C<db_hashtype>, C<db_prefixtype>, C<defvoidused>, C<direntrytype>,
5619 C<dlext>, C<dlsrc>, C<doublesize>, C<drand01>, C<dynamic_ext>
5620
5621 =item e
5622
5623 C<eagain>, C<ebcdic>, C<echo>, C<egrep>, C<emacs>, C<eunicefix>,
5624 C<exe_ext>, C<expr>, C<extensions>
5625
5626 =item f
5627
5628 C<fflushall>, C<fflushNULL>, C<find>, C<firstmakefile>, C<flex>,
5629 C<fpossize>, C<fpostype>, C<freetype>, C<full_ar>, C<full_csh>, C<full_sed>
5630
5631 =item g
5632
5633 C<gccversion>, C<gidformat>, C<gidsign>, C<gidsize>, C<gidtype>,
5634 C<glibpth>, C<grep>, C<groupcat>, C<groupstype>, C<gzip>
5635
5636 =item h
5637
5638 C<h_fcntl>, C<h_sysfile>, C<hint>, C<hostcat>, C<huge>
5639
5640 =item i
5641
5642 C<i16size>, C<i16type>, C<i32size>, C<i32type>, C<i64size>, C<i64type>,
5643 C<i8size>, C<i8type>, C<i_arpainet>, C<i_bsdioctl>, C<i_db>, C<i_dbm>,
5644 C<i_dirent>, C<i_dld>, C<i_dlfcn>, C<i_fcntl>, C<i_float>, C<i_gdbm>,
5645 C<i_grp>, C<i_iconv>, C<i_ieeefp>, C<i_inttypes>, C<i_limits>, C<i_locale>,
5646 C<i_machcthr>, C<i_malloc>, C<i_math>, C<i_memory>, C<i_mntent>, C<i_ndbm>,
5647 C<i_netdb>, C<i_neterrno>, C<i_netinettcp>, C<i_niin>, C<i_poll>,
5648 C<i_pthread>, C<i_pwd>, C<i_rpcsvcdbm>, C<i_sfio>, C<i_sgtty>, C<i_shadow>,
5649 C<i_socks>, C<i_stdarg>, C<i_stddef>, C<i_stdlib>, C<i_string>,
5650 C<i_sunmath>, C<i_sysaccess>, C<i_sysdir>, C<i_sysfile>, C<i_sysfilio>,
5651 C<i_sysin>, C<i_sysioctl>, C<i_syslog>, C<i_sysmman>, C<i_sysmode>,
5652 C<i_sysmount>, C<i_sysndir>, C<i_sysparam>, C<i_sysresrc>, C<i_syssecrt>,
5653 C<i_sysselct>, C<i_syssockio>, C<i_sysstat>, C<i_sysstatfs>,
5654 C<i_sysstatvfs>, C<i_systime>, C<i_systimek>, C<i_systimes>, C<i_systypes>,
5655 C<i_sysuio>, C<i_sysun>, C<i_sysutsname>, C<i_sysvfs>, C<i_syswait>,
5656 C<i_termio>, C<i_termios>, C<i_time>, C<i_unistd>, C<i_ustat>, C<i_utime>,
5657 C<i_values>, C<i_varargs>, C<i_varhdr>, C<i_vfork>,
5658 C<ignore_versioned_solibs>, C<inc_version_list>, C<inc_version_list_init>,
5659 C<incpath>, C<inews>, C<installarchlib>, C<installbin>, C<installman1dir>,
5660 C<installman3dir>, C<installprefix>, C<installprefixexp>,
5661 C<installprivlib>, C<installscript>, C<installsitearch>, C<installsitebin>,
5662 C<installsitelib>, C<installstyle>, C<installusrbinperl>,
5663 C<installvendorarch>, C<installvendorbin>, C<installvendorlib>, C<intsize>,
5664 C<ivdformat>, C<ivsize>, C<ivtype>
5665
5666 =item k
5667
5668 C<known_extensions>, C<ksh>