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