pod/perltoc.pod

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