pod/perltoc.pod

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