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