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