pod/perltoc.pod

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