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