pod/perltoc.pod

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