pod/perltoc.pod

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