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 =item SYNOPSIS
  17
  18 =item DESCRIPTION
  19
  20 modularity and reusability using innumerable modules, embeddable and
  21 extensible, roll-your-own magic variables (including multiple simultaneous
  22 DBM implementations), subroutines can now be overridden, autoloaded, and
  23 prototyped, arbitrarily nested data structures and anonymous functions,
  24 object-oriented programming, compilability into C code or Perl bytecode,
  25 support for light-weight processes (threads), support for
  26 internationalization, localization, and Unicode, lexical scoping, regular
  27 expression enhancements, enhanced debugger and interactive Perl
  28 environment, with integrated editor support, POSIX 1003.1 compliant library
  29
  30 =item AVAILABILITY
  31
  32 =item ENVIRONMENT
  33
  34 =item AUTHOR
  35
  36 =item FILES
  37
  38 =item SEE ALSO
  39
  40 =item DIAGNOSTICS
  41
  42 =item BUGS
  43
  44 =item NOTES
  45
  46 =head2 perlfaq - frequently asked questions about Perl ($Date: 1999/05/23
  47 20:38:02 $)
  48
  49 =item DESCRIPTION
  50
  51 perlfaq: Structural overview of the FAQ, L<perlfaq1>: General Questions
  52 About Perl, What is Perl?, Who supports Perl?  Who develops it?  Why is it
  53 free?, Which version of Perl should I use?, What are perl4 and perl5?, What
  54 is perl6?, How stable is Perl?, Is Perl difficult to learn?, How does Perl
  55 compare with other languages like Java, Python, REXX, Scheme, or Tcl?, Can
  56 I do [task] in Perl?, When shouldn't I program in Perl?, What's the
  57 difference between "perl" and "Perl"?, Is it a Perl program or a Perl
  58 script?, What is a JAPH?, Where can I get a list of Larry Wall witticisms?,
  59 How can I convince my sysadmin/supervisor/employees to use version
  60 (5/5.005/Perl instead of some other language)?, L<perlfaq2>: Obtaining and
  61 Learning about Perl, What machines support Perl?  Where do I get it?, How
  62 can I get a binary version of Perl?, I don't have a C compiler on my
  63 system.  How can I compile perl?, I copied the Perl binary from one machine
  64 to another, but scripts don't work, I grabbed the sources and tried to
  65 compile but gdbm/dynamic loading/malloc/linking/... failed.  How do I make
  66 it work?, What modules and extensions are available for Perl?  What is
  67 CPAN?  What does CPAN/src/... mean?, Is there an ISO or ANSI certified
  68 version of Perl?, Where can I get information on Perl?, What are the Perl
  69 newsgroups on USENET?  Where do I post questions?, Where should I post
  70 source code?, Perl Books, Perl in Magazines, Perl on the Net: FTP and WWW
  71 Access, What mailing lists are there for perl?, Archives of
  72 comp.lang.perl.misc, Where can I buy a commercial version of Perl?, Where
  73 do I send bug reports?, What is perl.com?, L<perlfaq3>: Programming Tools,
  74 How do I do (anything)?, How can I use Perl interactively?, Is there a Perl
  75 shell?, How do I debug my Perl programs?, How do I profile my Perl
  76 programs?, How do I cross-reference my Perl programs?, Is there a
  77 pretty-printer (formatter) for Perl?, Is there a ctags for Perl?, Is there
  78 an IDE or Windows Perl Editor?, Where can I get Perl macros for vi?, Where
  79 can I get perl-mode for emacs?, How can I use curses with Perl?, How can I
  80 use X or Tk with Perl?, How can I generate simple menus without using CGI
  81 or Tk?, What is undump?, How can I make my Perl program run faster?, How
  82 can I make my Perl program take less memory?, Is it unsafe to return a
  83 pointer to local data?, How can I free an array or hash so my program
  84 shrinks?, How can I make my CGI script more efficient?, How can I hide the
  85 source for my Perl program?, How can I compile my Perl program into byte
  86 code or C?, How can I compile Perl into Java?, How can I get C<#!perl> to
  87 work on [MS-DOS,NT,...]?, Can I write useful perl programs on the command
  88 line?, Why don't perl one-liners work on my DOS/Mac/VMS system?, Where can
  89 I learn about CGI or Web programming in Perl?, Where can I learn about
  90 object-oriented Perl programming?, Where can I learn about linking C with
  91 Perl? [h2xs, xsubpp], I've read perlembed, perlguts, etc., but I can't
  92 embed perl inmy C program, what am I doing wrong?, When I tried to run my
  93 script, I got this message. What does itmean?, What's MakeMaker?,
  94 L<perlfaq4>: Data Manipulation, Why am I getting long decimals (eg,
  95 19.9499999999999) instead of the numbers I should be getting (eg, 19.95)?,
  96 Why isn't my octal data interpreted correctly?, Does Perl have a round()
  97 function?  What about ceil() and floor()?  Trig functions?, How do I
  98 convert bits into ints?, Why doesn't & work the way I want it to?, How do I
  99 multiply matrices?, How do I perform an operation on a series of integers?,
 100 How can I output Roman numerals?, Why aren't my random numbers random?, How
 101 do I find the week-of-the-year/day-of-the-year?, How do I find the current
 102 century or millennium?, How can I compare two dates and find the
 103 difference?, How can I take a string and turn it into epoch seconds?, How
 104 can I find the Julian Day?, How do I find yesterday's date?, Does Perl have
 105 a year 2000 problem?  Is Perl Y2K compliant?, How do I validate input?, How
 106 do I unescape a string?, How do I remove consecutive pairs of characters?,
 107 How do I expand function calls in a string?, How do I find matching/nesting
 108 anything?, How do I reverse a string?, How do I expand tabs in a string?,
 109 How do I reformat a paragraph?, How can I access/change the first N letters
 110 of a string?, How do I change the Nth occurrence of something?, How can I
 111 count the number of occurrences of a substring within a string?, How do I
 112 capitalize all the words on one line?, How can I split a [character]
 113 delimited string except when inside[character]? (Comma-separated files),
 114 How do I strip blank space from the beginning/end of a string?, How do I
 115 pad a string with blanks or pad a number with zeroes?, How do I extract
 116 selected columns from a string?, How do I find the soundex value of a
 117 string?, How can I expand variables in text strings?, What's wrong with
 118 always quoting "$vars"?, Why don't my E<lt>E<lt>HERE documents work?, What
 119 is the difference between a list and an array?, What is the difference
 120 between $array[1] and @array[1]?, How can I remove duplicate elements from
 121 a list or array?, How can I tell whether a list or array contains a certain
 122 element?, How do I compute the difference of two arrays?  How do I compute
 123 the intersection of two arrays?, How do I test whether two arrays or hashes
 124 are equal?, How do I find the first array element for which a condition is
 125 true?, How do I handle linked lists?, How do I handle circular lists?, How
 126 do I shuffle an array randomly?, How do I process/modify each element of an
 127 array?, How do I select a random element from an array?, How do I permute N
 128 elements of a list?, How do I sort an array by (anything)?, How do I
 129 manipulate arrays of bits?, Why does defined() return true on empty arrays
 130 and hashes?, How do I process an entire hash?, What happens if I add or
 131 remove keys from a hash while iterating over it?, How do I look up a hash
 132 element by value?, How can I know how many entries are in a hash?, How do I
 133 sort a hash (optionally by value instead of key)?, How can I always keep my
 134 hash sorted?, What's the difference between "delete" and "undef" with
 135 hashes?, Why don't my tied hashes make the defined/exists distinction?, How
 136 do I reset an each() operation part-way through?, How can I get the unique
 137 keys from two hashes?, How can I store a multidimensional array in a DBM
 138 file?, How can I make my hash remember the order I put elements into it?,
 139 Why does passing a subroutine an undefined element in a hash create it?,
 140 How can I make the Perl equivalent of a C structure/C++ class/hash or array
 141 of hashes or arrays?, How can I use a reference as a hash key?, How do I
 142 handle binary data correctly?, How do I determine whether a scalar is a
 143 number/whole/integer/float?, How do I keep persistent data across program
 144 calls?, How do I print out or copy a recursive data structure?, How do I
 145 define methods for every class/object?, How do I verify a credit card
 146 checksum?, How do I pack arrays of doubles or floats for XS code?,
 147 L<perlfaq5>: Files and Formats, How do I flush/unbuffer an output
 148 filehandle?  Why must I do this?, How do I change one line in a file/delete
 149 a line in a file/insert a line in the middle of a file/append to the
 150 beginning of a file?, How do I count the number of lines in a file?, How do
 151 I make a temporary file name?, How can I manipulate fixed-record-length
 152 files?, How can I make a filehandle local to a subroutine?  How do I pass
 153 filehandles between subroutines?  How do I make an array of filehandles?,
 154 How can I use a filehandle indirectly?, How can I set up a footer format to
 155 be used with write()?, How can I write() into a string?, How can I output
 156 my numbers with commas added?, How can I translate tildes (~) in a
 157 filename?, How come when I open a file read-write it wipes it out?, Why do
 158 I sometimes get an "Argument list too long" when I use E<lt>*E<gt>?, Is
 159 there a leak/bug in glob()?, How can I open a file with a leading "E<gt>"
 160 or trailing blanks?, How can I reliably rename a file?, How can I lock a
 161 file?, Why can't I just open(FH, ">file.lock")?, I still don't get locking.
 162  I just want to increment the number in the file.  How can I do this?, How
 163 do I randomly update a binary file?, How do I get a file's timestamp in
 164 perl?, How do I set a file's timestamp in perl?, How do I print to more
 165 than one file at once?, How can I read in an entire file all at once?, How
 166 can I read in a file by paragraphs?, How can I read a single character from
 167 a file?  From the keyboard?, How can I tell whether there's a character
 168 waiting on a filehandle?, How do I do a C<tail -f> in perl?, How do I dup()
 169 a filehandle in Perl?, How do I close a file descriptor by number?, Why
 170 can't I use "C:\temp\foo" in DOS paths?  What doesn't `C:\temp\foo.exe`
 171 work?, Why doesn't glob("*.*") get all the files?, Why does Perl let me
 172 delete read-only files?  Why does C<-i> clobber protected files?  Isn't
 173 this a bug in Perl?, How do I select a random line from a file?, Why do I
 174 get weird spaces when I print an array of lines?, L<perlfaq6>: Regexps, How
 175 can I hope to use regular expressions without creating illegible and
 176 unmaintainable code?, I'm having trouble matching over more than one line.
 177 What's wrong?, How can I pull out lines between two patterns that are
 178 themselves on different lines?, I put a regular expression into $/ but it
 179 didn't work. What's wrong?, How do I substitute case insensitively on the
 180 LHS, but preserving case on the RHS?, How can I make C<\w> match national
 181 character sets?, How can I match a locale-smart version of C</[a-zA-Z]/>?,
 182 How can I quote a variable to use in a regex?, What is C</o> really for?,
 183 How do I use a regular expression to strip C style comments from a file?,
 184 Can I use Perl regular expressions to match balanced text?, What does it
 185 mean that regexes are greedy?  How can I get around it?, How do I process
 186 each word on each line?, How can I print out a word-frequency or
 187 line-frequency summary?, How can I do approximate matching?, How do I
 188 efficiently match many regular expressions at once?, Why don't
 189 word-boundary searches with C<\b> work for me?, Why does using $&, $`, or
 190 $' slow my program down?, What good is C<\G> in a regular expression?, Are
 191 Perl regexes DFAs or NFAs?  Are they POSIX compliant?, What's wrong with
 192 using grep or map in a void context?, How can I match strings with
 193 multibyte characters?, How do I match a pattern that is supplied by the
 194 user?, L<perlfaq7>: General Perl Language Issues, Can I get a BNF/yacc/RE
 195 for the Perl language?, What are all these $@%&* punctuation signs, and how
 196 do I know when to use them?, Do I always/never have to quote my strings or
 197 use semicolons and commas?, How do I skip some return values?, How do I
 198 temporarily block warnings?, What's an extension?, Why do Perl operators
 199 have different precedence than C operators?, How do I declare/create a
 200 structure?, How do I create a module?, How do I create a class?, How can I
 201 tell if a variable is tainted?, What's a closure?, What is variable suicide
 202 and how can I prevent it?, How can I pass/return a {Function, FileHandle,
 203 Array, Hash, Method, Regex}?, How do I create a static variable?, What's
 204 the difference between dynamic and lexical (static) scoping?  Between
 205 local() and my()?, How can I access a dynamic variable while a similarly
 206 named lexical is in scope?, What's the difference between deep and shallow
 207 binding?, Why doesn't "my($foo) = E<lt>FILEE<gt>;" work right?, How do I
 208 redefine a builtin function, operator, or method?, What's the difference
 209 between calling a function as &foo and foo()?, How do I create a switch or
 210 case statement?, How can I catch accesses to undefined
 211 variables/functions/methods?, Why can't a method included in this same file
 212 be found?, How can I find out my current package?, How can I comment out a
 213 large block of perl code?, How do I clear a package?, How can I use a
 214 variable as a variable name?, L<perlfaq8>: System Interaction, How do I
 215 find out which operating system I'm running under?, How come exec() doesn't
 216 return?, How do I do fancy stuff with the keyboard/screen/mouse?, How do I
 217 print something out in color?, How do I read just one key without waiting
 218 for a return key?, How do I check whether input is ready on the keyboard?,
 219 How do I clear the screen?, How do I get the screen size?, How do I ask the
 220 user for a password?, How do I read and write the serial port?, How do I
 221 decode encrypted password files?, How do I start a process in the
 222 background?, How do I trap control characters/signals?, How do I modify the
 223 shadow password file on a Unix system?, How do I set the time and date?,
 224 How can I sleep() or alarm() for under a second?, How can I measure time
 225 under a second?, How can I do an atexit() or setjmp()/longjmp()? (Exception
 226 handling), Why doesn't my sockets program work under System V (Solaris)?
 227 What does the error message "Protocol not supported" mean?, How can I call
 228 my system's unique C functions from Perl?, Where do I get the include files
 229 to do ioctl() or syscall()?, Why do setuid perl scripts complain about
 230 kernel problems?, How can I open a pipe both to and from a command?, Why
 231 can't I get the output of a command with system()?, How can I capture
 232 STDERR from an external command?, Why doesn't open() return an error when a
 233 pipe open fails?, What's wrong with using backticks in a void context?, How
 234 can I call backticks without shell processing?, Why can't my script read
 235 from STDIN after I gave it EOF (^D on Unix, ^Z on MS-DOS)?, How can I
 236 convert my shell script to perl?, Can I use perl to run a telnet or ftp
 237 session?, How can I write expect in Perl?, Is there a way to hide perl's
 238 command line from programs such as "ps"?, I {changed directory, modified my
 239 environment} in a perl script.  How come the change disappeared when I
 240 exited the script?  How do I get my changes to be visible?, How do I close
 241 a process's filehandle without waiting for it to complete?, How do I fork a
 242 daemon process?, How do I make my program run with sh and csh?, How do I
 243 find out if I'm running interactively or not?, How do I timeout a slow
 244 event?, How do I set CPU limits?, How do I avoid zombies on a Unix system?,
 245 How do I use an SQL database?, How do I make a system() exit on control-C?,
 246 How do I open a file without blocking?, How do I install a module from
 247 CPAN?, What's the difference between require and use?, How do I keep my own
 248 module/library directory?, How do I add the directory my program lives in
 249 to the module/library search path?, How do I add a directory to my include
 250 path at runtime?, What is socket.ph and where do I get it?, L<perlfaq9>:
 251 Networking, My CGI script runs from the command line but not the browser.
 252 (500 Server Error), How can I get better error messages from a CGI
 253 program?, How do I remove HTML from a string?, How do I extract URLs?, How
 254 do I download a file from the user's machine?  How do I open a file on
 255 another machine?, How do I make a pop-up menu in HTML?, How do I fetch an
 256 HTML file?, How do I automate an HTML form submission?, How do I decode or
 257 create those %-encodings on the web?, How do I redirect to another page?,
 258 How do I put a password on my web pages?, How do I edit my .htpasswd and
 259 .htgroup files with Perl?, How do I make sure users can't enter values into
 260 a form that cause my CGI script to do bad things?, How do I parse a mail
 261 header?, How do I decode a CGI form?, How do I check a valid mail address?,
 262 How do I decode a MIME/BASE64 string?, How do I return the user's mail
 263 address?, How do I send mail?, How do I read mail?, How do I find out my
 264 hostname/domainname/IP address?, How do I fetch a news article or the
 265 active newsgroups?, How do I fetch/put an FTP file?, How can I do RPC in
 266 Perl?
 267
 268 =over
 269
 270 =item Where to get this document
 271
 272 =item How to contribute to this document
 273
 274 =item What will happen if you mail your Perl programming problems to the
 275 authors
 276
 277 =back
 278
 279 =item Credits
 280
 281 =item Author and Copyright Information
 282
 283 =over
 284
 285 =item Bundled Distributions
 286
 287 =item Disclaimer
 288
 289 =back
 290
 291 =item Changes
 292
 293 23/May/99, 13/April/99, 7/January/99, 22/June/98, 24/April/97, 23/April/97,
 294 25/March/97, 18/March/97, 17/March/97 Version, Initial Release: 11/March/97
 295
 296 =head2 perlfaq1 - General Questions About Perl ($Revision: 1.23 $, $Date:
 297 1999/05/23 16:08:30 $)
 298
 299 =item DESCRIPTION
 300
 301 =over
 302
 303 =item What is Perl?
 304
 305 =item Who supports Perl?  Who develops it?  Why is it free?
 306
 307 =item Which version of Perl should I use?
 308
 309 =item What are perl4 and perl5?
 310
 311 =item What is perl6?
 312
 313 =item How stable is Perl?
 314
 315 =item Is Perl difficult to learn?
 316
 317 =item How does Perl compare with other languages like Java, Python, REXX,
 318 Scheme, or Tcl?
 319
 320 =item Can I do [task] in Perl?
 321
 322 =item When shouldn't I program in Perl?
 323
 324 =item What's the difference between "perl" and "Perl"?
 325
 326 =item Is it a Perl program or a Perl script?
 327
 328 =item What is a JAPH?
 329
 330 =item Where can I get a list of Larry Wall witticisms?
 331
 332 =item How can I convince my sysadmin/supervisor/employees to use version
 333 (5/5.005/Perl instead of some other language)?
 334
 335 =back
 336
 337 =item AUTHOR AND COPYRIGHT
 338
 339 =head2 perlfaq2 - Obtaining and Learning about Perl ($Revision: 1.31 $,
 340 $Date: 1999/04/14 03:46:19 $)
 341
 342 =item DESCRIPTION
 343
 344 =over
 345
 346 =item What machines support Perl?  Where do I get it?
 347
 348 =item How can I get a binary version of Perl?
 349
 350 =item I don't have a C compiler on my system.  How can I compile perl?
 351
 352 =item I copied the Perl binary from one machine to another, but scripts
 353 don't work.
 354
 355 =item I grabbed the sources and tried to compile but gdbm/dynamic
 356 loading/malloc/linking/... failed.  How do I make it work?
 357
 358 =item What modules and extensions are available for Perl?  What is CPAN?
 359 What does CPAN/src/... mean?
 360
 361 =item Is there an ISO or ANSI certified version of Perl?
 362
 363 =item Where can I get information on Perl?
 364
 365 =item What are the Perl newsgroups on USENET?  Where do I post questions?
 366
 367 =item Where should I post source code?
 368
 369 =item Perl Books
 370
 371 References, Tutorials
 372     *Learning Perl [2nd edition]
 373         by Randal L. Schwartz and Tom Christiansen
 374             with foreword by Larry Wall, Task-Oriented, Special Topics
 375
 376 =item Perl in Magazines
 377
 378 =item Perl on the Net: FTP and WWW Access
 379
 380 =item What mailing lists are there for perl?
 381
 382 =item Archives of comp.lang.perl.misc
 383
 384 =item Where can I buy a commercial version of Perl?
 385
 386 =item Where do I send bug reports?
 387
 388 =item What is perl.com?
 389
 390 =back
 391
 392 =item AUTHOR AND COPYRIGHT
 393
 394 =head2 perlfaq3 - Programming Tools ($Revision: 1.38 $, $Date: 1999/05/23
 395 16:08:30 $)
 396
 397 =item DESCRIPTION
 398
 399 =over
 400
 401 =item How do I do (anything)?
 402
 403 =item How can I use Perl interactively?
 404
 405 =item Is there a Perl shell?
 406
 407 =item How do I debug my Perl programs?
 408
 409 =item How do I profile my Perl programs?
 410
 411 =item How do I cross-reference my Perl programs?
 412
 413 =item Is there a pretty-printer (formatter) for Perl?
 414
 415 =item Is there a ctags for Perl?
 416
 417 =item Is there an IDE or Windows Perl Editor?
 418
 419 =item Where can I get Perl macros for vi?
 420
 421 =item Where can I get perl-mode for emacs?
 422
 423 =item How can I use curses with Perl?
 424
 425 =item How can I use X or Tk with Perl?
 426
 427 =item How can I generate simple menus without using CGI or Tk?
 428
 429 =item What is undump?
 430
 431 =item How can I make my Perl program run faster?
 432
 433 =item How can I make my Perl program take less memory?
 434
 435 =item Is it unsafe to return a pointer to local data?
 436
 437 =item How can I free an array or hash so my program shrinks?
 438
 439 =item How can I make my CGI script more efficient?
 440
 441 =item How can I hide the source for my Perl program?
 442
 443 =item How can I compile my Perl program into byte code or C?
 444
 445 =item How can I compile Perl into Java?
 446
 447 =item How can I get C<#!perl> to work on [MS-DOS,NT,...]?
 448
 449 =item Can I write useful perl programs on the command line?
 450
 451 =item Why don't perl one-liners work on my DOS/Mac/VMS system?
 452
 453 =item Where can I learn about CGI or Web programming in Perl?
 454
 455 =item Where can I learn about object-oriented Perl programming?
 456
 457 =item Where can I learn about linking C with Perl? [h2xs, xsubpp]
 458
 459 =item I've read perlembed, perlguts, etc., but I can't embed perl in
 460 my C program, what am I doing wrong?
 461
 462 =item When I tried to run my script, I got this message. What does it
 463 mean?
 464
 465 =item What's MakeMaker?
 466
 467 =back
 468
 469 =item AUTHOR AND COPYRIGHT
 470
 471 =head2 perlfaq4 - Data Manipulation ($Revision: 1.49 $, $Date: 1999/05/23
 472 20:37:49 $)
 473
 474 =item DESCRIPTION
 475
 476 =item Data: Numbers
 477
 478 =over
 479
 480 =item Why am I getting long decimals (eg, 19.9499999999999) instead of the
 481 numbers I should be getting (eg, 19.95)?
 482
 483 =item Why isn't my octal data interpreted correctly?
 484
 485 =item Does Perl have a round() function?  What about ceil() and floor()?
 486 Trig functions?
 487
 488 =item How do I convert bits into ints?
 489
 490 =item Why doesn't & work the way I want it to?
 491
 492 =item How do I multiply matrices?
 493
 494 =item How do I perform an operation on a series of integers?
 495
 496 =item How can I output Roman numerals?
 497
 498 =item Why aren't my random numbers random?
 499
 500 =back
 501
 502 =item Data: Dates
 503
 504 =over
 505
 506 =item How do I find the week-of-the-year/day-of-the-year?
 507
 508 =item How do I find the current century or millennium?
 509
 510 =item How can I compare two dates and find the difference?
 511
 512 =item How can I take a string and turn it into epoch seconds?
 513
 514 =item How can I find the Julian Day?
 515
 516 =item How do I find yesterday's date?
 517
 518 =item Does Perl have a year 2000 problem?  Is Perl Y2K compliant?
 519
 520 =back
 521
 522 =item Data: Strings
 523
 524 =over
 525
 526 =item How do I validate input?
 527
 528 =item How do I unescape a string?
 529
 530 =item How do I remove consecutive pairs of characters?
 531
 532 =item How do I expand function calls in a string?
 533
 534 =item How do I find matching/nesting anything?
 535
 536 =item How do I reverse a string?
 537
 538 =item How do I expand tabs in a string?
 539
 540 =item How do I reformat a paragraph?
 541
 542 =item How can I access/change the first N letters of a string?
 543
 544 =item How do I change the Nth occurrence of something?
 545
 546 =item How can I count the number of occurrences of a substring within a
 547 string?
 548
 549 =item How do I capitalize all the words on one line?
 550
 551 =item How can I split a [character] delimited string except when inside
 552 [character]? (Comma-separated files)
 553
 554 =item How do I strip blank space from the beginning/end of a string?
 555
 556 =item How do I pad a string with blanks or pad a number with zeroes?
 557
 558 =item How do I extract selected columns from a string?
 559
 560 =item How do I find the soundex value of a string?
 561
 562 =item How can I expand variables in text strings?
 563
 564 =item What's wrong with always quoting "$vars"?
 565
 566 =item Why don't my E<lt>E<lt>HERE documents work?
 567
 568 1. There must be no space after the << part, 2. There (probably) should be
 569 a semicolon at the end, 3. You can't (easily) have any space in front of
 570 the tag
 571
 572 =back
 573
 574 =item Data: Arrays
 575
 576 =over
 577
 578 =item What is the difference between a list and an array?
 579
 580 =item What is the difference between $array[1] and @array[1]?
 581
 582 =item How can I remove duplicate elements from a list or array?
 583
 584 a) If @in is sorted, and you want @out to be sorted:(this assumes all true
 585 values in the array), b) If you don't know whether @in is sorted:, c) Like
 586 (b), but @in contains only small integers:, d) A way to do (b) without any
 587 loops or greps:, e) Like (d), but @in contains only small positive
 588 integers:
 589
 590 =item How can I tell whether a list or array contains a certain element?
 591
 592 =item How do I compute the difference of two arrays?  How do I compute the
 593 intersection of two arrays?
 594
 595 =item How do I test whether two arrays or hashes are equal?
 596
 597 =item How do I find the first array element for which a condition is true?
 598
 599 =item How do I handle linked lists?
 600
 601 =item How do I handle circular lists?
 602
 603 =item How do I shuffle an array randomly?
 604
 605 =item How do I process/modify each element of an array?
 606
 607 =item How do I select a random element from an array?
 608
 609 =item How do I permute N elements of a list?
 610
 611 =item How do I sort an array by (anything)?
 612
 613 =item How do I manipulate arrays of bits?
 614
 615 =item Why does defined() return true on empty arrays and hashes?
 616
 617 =back
 618
 619 =item Data: Hashes (Associative Arrays)
 620
 621 =over
 622
 623 =item How do I process an entire hash?
 624
 625 =item What happens if I add or remove keys from a hash while iterating over
 626 it?
 627
 628 =item How do I look up a hash element by value?
 629
 630 =item How can I know how many entries are in a hash?
 631
 632 =item How do I sort a hash (optionally by value instead of key)?
 633
 634 =item How can I always keep my hash sorted?
 635
 636 =item What's the difference between "delete" and "undef" with hashes?
 637
 638 =item Why don't my tied hashes make the defined/exists distinction?
 639
 640 =item How do I reset an each() operation part-way through?
 641
 642 =item How can I get the unique keys from two hashes?
 643
 644 =item How can I store a multidimensional array in a DBM file?
 645
 646 =item How can I make my hash remember the order I put elements into it?
 647
 648 =item Why does passing a subroutine an undefined element in a hash create
 649 it?
 650
 651 =item How can I make the Perl equivalent of a C structure/C++ class/hash or
 652 array of hashes or arrays?
 653
 654 =item How can I use a reference as a hash key?
 655
 656 =back
 657
 658 =item Data: Misc
 659
 660 =over
 661
 662 =item How do I handle binary data correctly?
 663
 664 =item How do I determine whether a scalar is a number/whole/integer/float?
 665
 666 =item How do I keep persistent data across program calls?
 667
 668 =item How do I print out or copy a recursive data structure?
 669
 670 =item How do I define methods for every class/object?
 671
 672 =item How do I verify a credit card checksum?
 673
 674 =item How do I pack arrays of doubles or floats for XS code?
 675
 676 =back
 677
 678 =item AUTHOR AND COPYRIGHT
 679
 680 =head2 perlfaq5 - Files and Formats ($Revision: 1.38 $, $Date: 1999/05/23
 681 16:08:30 $)
 682
 683 =item DESCRIPTION
 684
 685 =over
 686
 687 =item How do I flush/unbuffer an output filehandle?  Why must I do this?
 688
 689 =item How do I change one line in a file/delete a line in a file/insert a
 690 line in the middle of a file/append to the beginning of a file?
 691
 692 =item How do I count the number of lines in a file?
 693
 694 =item How do I make a temporary file name?
 695
 696 =item How can I manipulate fixed-record-length files?
 697
 698 =item How can I make a filehandle local to a subroutine?  How do I pass
 699 filehandles between subroutines?  How do I make an array of filehandles?
 700
 701 =item How can I use a filehandle indirectly?
 702
 703 =item How can I set up a footer format to be used with write()?
 704
 705 =item How can I write() into a string?
 706
 707 =item How can I output my numbers with commas added?
 708
 709 =item How can I translate tildes (~) in a filename?
 710
 711 =item How come when I open a file read-write it wipes it out?
 712
 713 =item Why do I sometimes get an "Argument list too long" when I use
 714 E<lt>*E<gt>?
 715
 716 =item Is there a leak/bug in glob()?
 717
 718 =item How can I open a file with a leading "E<gt>" or trailing blanks?
 719
 720 =item How can I reliably rename a file?
 721
 722 =item How can I lock a file?
 723
 724 =item Why can't I just open(FH, ">file.lock")?
 725
 726 =item I still don't get locking.  I just want to increment the number in
 727 the file.  How can I do this?
 728
 729 =item How do I randomly update a binary file?
 730
 731 =item How do I get a file's timestamp in perl?
 732
 733 =item How do I set a file's timestamp in perl?
 734
 735 =item How do I print to more than one file at once?
 736
 737 =item How can I read in an entire file all at once?
 738
 739 =item How can I read in a file by paragraphs?
 740
 741 =item How can I read a single character from a file?  From the keyboard?
 742
 743 =item How can I tell whether there's a character waiting on a filehandle?
 744
 745 =item How do I do a C<tail -f> in perl?
 746
 747 =item How do I dup() a filehandle in Perl?
 748
 749 =item How do I close a file descriptor by number?
 750
 751 =item Why can't I use "C:\temp\foo" in DOS paths?  What doesn't
 752 `C:\temp\foo.exe` work?
 753
 754 =item Why doesn't glob("*.*") get all the files?
 755
 756 =item Why does Perl let me delete read-only files?  Why does C<-i> clobber
 757 protected files?  Isn't this a bug in Perl?
 758
 759 =item How do I select a random line from a file?
 760
 761 =item Why do I get weird spaces when I print an array of lines?
 762
 763 =back
 764
 765 =item AUTHOR AND COPYRIGHT
 766
 767 =head2 perlfaq6 - Regexes ($Revision: 1.27 $, $Date: 1999/05/23 16:08:30 $)
 768
 769 =item DESCRIPTION
 770
 771 =over
 772
 773 =item How can I hope to use regular expressions without creating illegible
 774 and unmaintainable code?
 775
 776 Comments Outside the Regex, Comments Inside the Regex, Different Delimiters
 777
 778 =item I'm having trouble matching over more than one line.  What's wrong?
 779
 780 =item How can I pull out lines between two patterns that are themselves on
 781 different lines?
 782
 783 =item I put a regular expression into $/ but it didn't work. What's wrong?
 784
 785 =item How do I substitute case insensitively on the LHS, but preserving
 786 case on the RHS?
 787
 788 =item How can I make C<\w> match national character sets?
 789
 790 =item How can I match a locale-smart version of C</[a-zA-Z]/>?
 791
 792 =item How can I quote a variable to use in a regex?
 793
 794 =item What is C</o> really for?
 795
 796 =item How do I use a regular expression to strip C style comments from a
 797 file?
 798
 799 =item Can I use Perl regular expressions to match balanced text?
 800
 801 =item What does it mean that regexes are greedy?  How can I get around it?
 802
 803 =item  How do I process each word on each line?
 804
 805 =item How can I print out a word-frequency or line-frequency summary?
 806
 807 =item How can I do approximate matching?
 808
 809 =item How do I efficiently match many regular expressions at once?
 810
 811 =item Why don't word-boundary searches with C<\b> work for me?
 812
 813 =item Why does using $&, $`, or $' slow my program down?
 814
 815 =item What good is C<\G> in a regular expression?
 816
 817 =item Are Perl regexes DFAs or NFAs?  Are they POSIX compliant?
 818
 819 =item What's wrong with using grep or map in a void context?
 820
 821 =item How can I match strings with multibyte characters?
 822
 823 =item How do I match a pattern that is supplied by the user?
 824
 825 =back
 826
 827 =item AUTHOR AND COPYRIGHT
 828
 829 =head2 perlfaq7 - Perl Language Issues ($Revision: 1.28 $, $Date:
 830 1999/05/23 20:36:18 $)
 831
 832 =item DESCRIPTION
 833
 834 =over
 835
 836 =item Can I get a BNF/yacc/RE for the Perl language?
 837
 838 =item What are all these $@%&* punctuation signs, and how do I know when to
 839 use them?
 840
 841 =item Do I always/never have to quote my strings or use semicolons and
 842 commas?
 843
 844 =item How do I skip some return values?
 845
 846 =item How do I temporarily block warnings?
 847
 848 =item What's an extension?
 849
 850 =item Why do Perl operators have different precedence than C operators?
 851
 852 =item How do I declare/create a structure?
 853
 854 =item How do I create a module?
 855
 856 =item How do I create a class?
 857
 858 =item How can I tell if a variable is tainted?
 859
 860 =item What's a closure?
 861
 862 =item What is variable suicide and how can I prevent it?
 863
 864 =item How can I pass/return a {Function, FileHandle, Array, Hash, Method,
 865 Regex}?
 866
 867 Passing Variables and Functions, Passing Filehandles, Passing Regexes,
 868 Passing Methods
 869
 870 =item How do I create a static variable?
 871
 872 =item What's the difference between dynamic and lexical (static) scoping?
 873 Between local() and my()?
 874
 875 =item How can I access a dynamic variable while a similarly named lexical
 876 is in scope?
 877
 878 =item What's the difference between deep and shallow binding?
 879
 880 =item Why doesn't "my($foo) = E<lt>FILEE<gt>;" work right?
 881
 882 =item How do I redefine a builtin function, operator, or method?
 883
 884 =item What's the difference between calling a function as &foo and foo()?
 885
 886 =item How do I create a switch or case statement?
 887
 888 =item How can I catch accesses to undefined variables/functions/methods?
 889
 890 =item Why can't a method included in this same file be found?
 891
 892 =item How can I find out my current package?
 893
 894 =item How can I comment out a large block of perl code?
 895
 896 =item How do I clear a package?
 897
 898 =item How can I use a variable as a variable name?
 899
 900 =back
 901
 902 =item AUTHOR AND COPYRIGHT
 903
 904 =head2 perlfaq8 - System Interaction ($Revision: 1.39 $, $Date: 1999/05/23
 905 18:37:57 $)
 906
 907 =item DESCRIPTION
 908
 909 =over
 910
 911 =item How do I find out which operating system I'm running under?
 912
 913 =item How come exec() doesn't return?
 914
 915 =item How do I do fancy stuff with the keyboard/screen/mouse?
 916
 917 Keyboard, Screen, Mouse
 918
 919 =item How do I print something out in color?
 920
 921 =item How do I read just one key without waiting for a return key?
 922
 923 =item How do I check whether input is ready on the keyboard?
 924
 925 =item How do I clear the screen?
 926
 927 =item How do I get the screen size?
 928
 929 =item How do I ask the user for a password?
 930
 931 =item How do I read and write the serial port?
 932
 933 lockfiles, open mode, end of line, flushing output, non-blocking input
 934
 935 =item How do I decode encrypted password files?
 936
 937 =item How do I start a process in the background?
 938
 939 STDIN, STDOUT, and STDERR are shared, Signals, Zombies
 940
 941 =item How do I trap control characters/signals?
 942
 943 =item How do I modify the shadow password file on a Unix system?
 944
 945 =item How do I set the time and date?
 946
 947 =item How can I sleep() or alarm() for under a second?
 948
 949 =item How can I measure time under a second?
 950
 951 =item How can I do an atexit() or setjmp()/longjmp()? (Exception handling)
 952
 953 =item Why doesn't my sockets program work under System V (Solaris)? What
 954 does the error message "Protocol not supported" mean?
 955
 956 =item How can I call my system's unique C functions from Perl?
 957
 958 =item Where do I get the include files to do ioctl() or syscall()?
 959
 960 =item Why do setuid perl scripts complain about kernel problems?
 961
 962 =item How can I open a pipe both to and from a command?
 963
 964 =item Why can't I get the output of a command with system()?
 965
 966 =item How can I capture STDERR from an external command?
 967
 968 =item Why doesn't open() return an error when a pipe open fails?
 969
 970 =item What's wrong with using backticks in a void context?
 971
 972 =item How can I call backticks without shell processing?
 973
 974 =item Why can't my script read from STDIN after I gave it EOF (^D on Unix,
 975 ^Z on MS-DOS)?
 976
 977 =item How can I convert my shell script to perl?
 978
 979 =item Can I use perl to run a telnet or ftp session?
 980
 981 =item How can I write expect in Perl?
 982
 983 =item Is there a way to hide perl's command line from programs such as
 984 "ps"?
 985
 986 =item I {changed directory, modified my environment} in a perl script.  How
 987 come the change disappeared when I exited the script?  How do I get my
 988 changes to be visible?
 989
 990 Unix
 991
 992 =item How do I close a process's filehandle without waiting for it to
 993 complete?
 994
 995 =item How do I fork a daemon process?
 996
 997 =item How do I make my program run with sh and csh?
 998
 999 =item How do I find out if I'm running interactively or not?
1000
1001 =item How do I timeout a slow event?
1002
1003 =item How do I set CPU limits?
1004
1005 =item How do I avoid zombies on a Unix system?
1006
1007 =item How do I use an SQL database?
1008
1009 =item How do I make a system() exit on control-C?
1010
1011 =item How do I open a file without blocking?
1012
1013 =item How do I install a module from CPAN?
1014
1015 =item What's the difference between require and use?
1016
1017 =item How do I keep my own module/library directory?
1018
1019 =item How do I add the directory my program lives in to the module/library
1020 search path?
1021
1022 =item How do I add a directory to my include path at runtime?
1023
1024 =item What is socket.ph and where do I get it?
1025
1026 =back
1027
1028 =item AUTHOR AND COPYRIGHT
1029
1030 =head2 perlfaq9 - Networking ($Revision: 1.26 $, $Date: 1999/05/23 16:08:30
1031 $)
1032
1033 =item DESCRIPTION
1034
1035 =over
1036
1037 =item My CGI script runs from the command line but not the browser.   (500
1038 Server Error)
1039
1040 =item How can I get better error messages from a CGI program?
1041
1042 =item How do I remove HTML from a string?
1043
1044 =item How do I extract URLs?
1045
1046 =item How do I download a file from the user's machine?  How do I open a
1047 file on another machine?
1048
1049 =item How do I make a pop-up menu in HTML?
1050
1051 =item How do I fetch an HTML file?
1052
1053 =item How do I automate an HTML form submission?
1054
1055 =item How do I decode or create those %-encodings on the web?
1056
1057 =item How do I redirect to another page?
1058
1059 =item How do I put a password on my web pages?
1060
1061 =item How do I edit my .htpasswd and .htgroup files with Perl?
1062
1063 =item How do I make sure users can't enter values into a form that cause my
1064 CGI script to do bad things?
1065
1066 =item How do I parse a mail header?
1067
1068 =item How do I decode a CGI form?
1069
1070 =item How do I check a valid mail address?
1071
1072 =item How do I decode a MIME/BASE64 string?
1073
1074 =item How do I return the user's mail address?
1075
1076 =item How do I send mail?
1077
1078 =item How do I read mail?
1079
1080 =item How do I find out my hostname/domainname/IP address?
1081
1082 =item How do I fetch a news article or the active newsgroups?
1083
1084 =item How do I fetch/put an FTP file?
1085
1086 =item How can I do RPC in Perl?
1087
1088 =back
1089
1090 =item AUTHOR AND COPYRIGHT
1091
1092 =head2 perldelta - what's new for perl5.006 (as of 5.005_56)
1093
1094 =item DESCRIPTION
1095
1096 =item Incompatible Changes
1097
1098 =over
1099
1100 =item Perl Source Incompatibilities
1101
1102 =item C Source Incompatibilities
1103
1104 C<PERL_POLLUTE>, C<PERL_POLLUTE_MALLOC>, C<PL_na> and C<dTHR> Issues
1105
1106 =item Compatible C Source API Changes
1107
1108 C<PATCHLEVEL> is now C<PERL_VERSION>
1109
1110 =item Binary Incompatibilities
1111
1112 =back
1113
1114 =item Core Changes
1115
1116 =over
1117
1118 =item Unicode and UTF-8 support
1119
1120 =item Lexically scoped warning categories
1121
1122 =item Binary numbers supported
1123
1124 =item syswrite() ease-of-use
1125
1126 =item 64-bit support
1127
1128 =item Better syntax checks on parenthesized unary operators
1129
1130 =item Improved C<qw//> operator
1131
1132 =item pack() format 'Z' supported
1133
1134 =item pack() format modifier '!' supported
1135
1136 =item $^X variables may now have names longer than one character
1137
1138 =back
1139
1140 =item Significant bug fixes
1141
1142 =over
1143
1144 =item E<lt>HANDLEE<gt> on empty files
1145
1146 =item C<eval '...'> improvements
1147
1148 =item Automatic flushing of output buffers
1149
1150 =back
1151
1152 =item Supported Platforms
1153
1154 =item New tests
1155
1156 =item Modules and Pragmata
1157
1158 =over
1159
1160 =item Modules
1161
1162 Dumpvalue, Benchmark, Devel::Peek, Fcntl, File::Spec,
1163 File::Spec::Functions, Math::BigInt, Math::Complex, Math::Trig, SDBM_File,
1164 Time::Local, Win32, DBM Filters
1165
1166 =item Pragmata
1167
1168 =back
1169
1170 =item Utility Changes
1171
1172 =item Documentation Changes
1173
1174 perlopentut.pod, perlreftut.pod, perltootc.pod
1175
1176 =item New Diagnostics
1177
1178 /%s/: Unrecognized escape \\%c passed through, Unrecognized escape \\%c
1179 passed through, Missing command in piped open
1180
1181 =item Obsolete Diagnostics
1182
1183 =item Configuration Changes
1184
1185 =item BUGS
1186
1187 =item SEE ALSO
1188
1189 =item HISTORY
1190
1191 =head2 perldata - Perl data types
1192
1193 =item DESCRIPTION
1194
1195 =over
1196
1197 =item Variable names
1198
1199 =item Context
1200
1201 =item Scalar values
1202
1203 =item Scalar value constructors
1204
1205 =item List value constructors
1206
1207 =item Slices
1208
1209 =item Typeglobs and Filehandles
1210
1211 =back
1212
1213 =item SEE ALSO
1214
1215 =head2 perlsyn - Perl syntax
1216
1217 =item DESCRIPTION
1218
1219 =over
1220
1221 =item Declarations
1222
1223 =item Simple statements
1224
1225 =item Compound statements
1226
1227 =item Loop Control
1228
1229 =item For Loops
1230
1231 =item Foreach Loops
1232
1233 =item Basic BLOCKs and Switch Statements
1234
1235 =item Goto
1236
1237 =item PODs: Embedded Documentation
1238
1239 =item Plain Old Comments (Not!)
1240
1241 =back
1242
1243 =head2 perlop - Perl operators and precedence
1244
1245 =item SYNOPSIS
1246
1247 =item DESCRIPTION
1248
1249 =over
1250
1251 =item Terms and List Operators (Leftward)
1252
1253 =item The Arrow Operator
1254
1255 =item Auto-increment and Auto-decrement
1256
1257 =item Exponentiation
1258
1259 =item Symbolic Unary Operators
1260
1261 =item Binding Operators
1262
1263 =item Multiplicative Operators
1264
1265 =item Additive Operators
1266
1267 =item Shift Operators
1268
1269 =item Named Unary Operators
1270
1271 =item Relational Operators
1272
1273 =item Equality Operators
1274
1275 =item Bitwise And
1276
1277 =item Bitwise Or and Exclusive Or
1278
1279 =item C-style Logical And
1280
1281 =item C-style Logical Or
1282
1283 =item Range Operators
1284
1285 =item Conditional Operator
1286
1287 =item Assignment Operators
1288
1289 =item Comma Operator
1290
1291 =item List Operators (Rightward)
1292
1293 =item Logical Not
1294
1295 =item Logical And
1296
1297 =item Logical or and Exclusive Or
1298
1299 =item C Operators Missing From Perl
1300
1301 unary &, unary *, (TYPE)
1302
1303 =item Quote and Quote-like Operators
1304
1305 =item Regexp Quote-Like Operators
1306
1307 ?PATTERN?, m/PATTERN/cgimosx, /PATTERN/cgimosx, q/STRING/, C<'STRING'>,
1308 qq/STRING/, "STRING", qr/STRING/imosx, qx/STRING/, `STRING`, qw/STRING/,
1309 s/PATTERN/REPLACEMENT/egimosx, tr/SEARCHLIST/REPLACEMENTLIST/cdsUC,
1310 y/SEARCHLIST/REPLACEMENTLIST/cdsUC
1311
1312 =item Gory details of parsing quoted constructs
1313
1314 Finding the end, Removal of backslashes before delimiters, Interpolation,
1315 C<<<'EOF'>, C<m''>, C<s'''>, C<tr///>, C<y///>, C<''>, C<q//>, C<"">,
1316 C<``>, C<qq//>, C<qx//>, C<<file*globE<gt>>, C<?RE?>, C</RE/>, C<m/RE/>,
1317 C<s/RE/foo/>,, Interpolation of regular expressions, Optimization of
1318 regular expressions
1319
1320 =item I/O Operators
1321
1322 =item Constant Folding
1323
1324 =item Bitwise String Operators
1325
1326 =item Integer Arithmetic
1327
1328 =item Floating-point Arithmetic
1329
1330 =item Bigger Numbers
1331
1332 =back
1333
1334 =head2 perlre - Perl regular expressions
1335
1336 =item DESCRIPTION
1337
1338 i, m, s, x
1339
1340 =over
1341
1342 =item Regular Expressions
1343
1344 =item Extended Patterns
1345
1346 C<(?#text)>, C<(?imsx-imsx)>, C<(?:pattern)>, C<(?imsx-imsx:pattern)>,
1347 C<(?=pattern)>, C<(?!pattern)>, C<(?E<lt>=pattern)>, C<(?<!pattern)>, C<(?{
1348 code })>, C<(?p{ code })>, C<(?E<gt>pattern)>,
1349 C<(?(condition)yes-pattern|no-pattern)>, C<(?(condition)yes-pattern)>
1350
1351 =item Backtracking
1352
1353 =item Version 8 Regular Expressions
1354
1355 =item Warning on \1 vs $1
1356
1357 =item Repeated patterns matching zero-length substring
1358
1359 =item Creating custom RE engines
1360
1361 =back
1362
1363 =item BUGS
1364
1365 =item SEE ALSO
1366
1367 =head2 perlrun - how to execute the Perl interpreter
1368
1369 =item SYNOPSIS
1370
1371 =item DESCRIPTION
1372
1373 =over
1374
1375 =item #! and quoting on non-Unix systems
1376
1377 OS/2, MS-DOS, Win95/NT, Macintosh, VMS
1378
1379 =item Location of Perl
1380
1381 =item Command Switches
1382
1383 B<-0>[I<digits>], B<-a>, B<-c>, B<-d>, B<-d:>I<foo>, B<-D>I<letters>,
1384 B<-D>I<number>, B<-e> I<commandline>, B<-F>I<pattern>, B<-h>,
1385 B<-i>[I<extension>], B<-I>I<directory>, B<-l>[I<octnum>],
1386 B<-m>[B<->]I<module>, B<-M>[B<->]I<module>, B<-M>[B<->]I<'module ...'>,
1387 B<-[mM]>[B<->]I<module=arg[,arg]...>, B<-n>, B<-p>, B<-P>, B<-s>, B<-S>,
1388 B<-T>, B<-u>, B<-U>, B<-v>, B<-V>, B<-V:>I<name>, B<-w>, B<-x> I<directory>
1389
1390 =back
1391
1392 =item ENVIRONMENT
1393
1394 HOME, LOGDIR, PATH, PERL5LIB, PERL5OPT, PERLLIB, PERL5DB, PERL5SHELL
1395 (specific to the Win32 port), PERL_DEBUG_MSTATS, PERL_DESTRUCT_LEVEL
1396
1397 =head2 perlfunc - Perl builtin functions
1398
1399 =item DESCRIPTION
1400
1401 =over
1402
1403 =item Perl Functions by Category
1404
1405 Functions for SCALARs or strings, Regular expressions and pattern matching,
1406 Numeric functions, Functions for real @ARRAYs, Functions for list data,
1407 Functions for real %HASHes, Input and output functions, Functions for fixed
1408 length data or records, Functions for filehandles, files, or directories,
1409 Keywords related to the control flow of your perl program, Keywords related
1410 to scoping, Miscellaneous functions, Functions for processes and process
1411 groups, Keywords related to perl modules, Keywords related to classes and
1412 object-orientedness, Low-level socket functions, System V interprocess
1413 communication functions, Fetching user and group info, Fetching network
1414 info, Time-related functions, Functions new in perl5, Functions obsoleted
1415 in perl5
1416
1417 =item Portability
1418
1419 =item Alphabetical Listing of Perl Functions
1420
1421 I<-X> FILEHANDLE, I<-X> EXPR, I<-X>, abs VALUE, abs, accept
1422 NEWSOCKET,GENERICSOCKET, alarm SECONDS, alarm, atan2 Y,X, bind SOCKET,NAME,
1423 binmode FILEHANDLE, bless REF,CLASSNAME, bless REF, caller EXPR, caller,
1424 chdir EXPR, chmod LIST, chomp VARIABLE, chomp LIST, chomp, chop VARIABLE,
1425 chop LIST, chop, chown LIST, chr NUMBER, chr, chroot FILENAME, chroot,
1426 close FILEHANDLE, close, closedir DIRHANDLE, connect SOCKET,NAME, continue
1427 BLOCK, cos EXPR, crypt PLAINTEXT,SALT, dbmclose HASH, dbmopen
1428 HASH,DBNAME,MASK, defined EXPR, defined, delete EXPR, die LIST, do BLOCK,
1429 do SUBROUTINE(LIST), do EXPR, dump LABEL, dump, each HASH, eof FILEHANDLE,
1430 eof (), eof, eval EXPR, eval BLOCK, exec LIST, exec PROGRAM LIST, exists
1431 EXPR, exit EXPR, exp EXPR, exp, fcntl FILEHANDLE,FUNCTION,SCALAR, fileno
1432 FILEHANDLE, flock FILEHANDLE,OPERATION, fork, format, formline
1433 PICTURE,LIST, getc FILEHANDLE, getc, getlogin, getpeername SOCKET, getpgrp
1434 PID, getppid, getpriority WHICH,WHO, getpwnam NAME, getgrnam NAME,
1435 gethostbyname NAME, getnetbyname NAME, getprotobyname NAME, getpwuid UID,
1436 getgrgid GID, getservbyname NAME,PROTO, gethostbyaddr ADDR,ADDRTYPE,
1437 getnetbyaddr ADDR,ADDRTYPE, getprotobynumber NUMBER, getservbyport
1438 PORT,PROTO, getpwent, getgrent, gethostent, getnetent, getprotoent,
1439 getservent, setpwent, setgrent, sethostent STAYOPEN, setnetent STAYOPEN,
1440 setprotoent STAYOPEN, setservent STAYOPEN, endpwent, endgrent, endhostent,
1441 endnetent, endprotoent, endservent, getsockname SOCKET, getsockopt
1442 SOCKET,LEVEL,OPTNAME, glob EXPR, glob, gmtime EXPR, goto LABEL, goto EXPR,
1443 goto &NAME, grep BLOCK LIST, grep EXPR,LIST, hex EXPR, hex, import, index
1444 STR,SUBSTR,POSITION, index STR,SUBSTR, int EXPR, int, ioctl
1445 FILEHANDLE,FUNCTION,SCALAR, join EXPR,LIST, keys HASH, kill LIST, last
1446 LABEL, last, lc EXPR, lc, lcfirst EXPR, lcfirst, length EXPR, length, link
1447 OLDFILE,NEWFILE, listen SOCKET,QUEUESIZE, local EXPR, localtime EXPR, lock,
1448 log EXPR, log, lstat FILEHANDLE, lstat EXPR, lstat, m//, map BLOCK LIST,
1449 map EXPR,LIST, mkdir FILENAME,MASK, msgctl ID,CMD,ARG, msgget KEY,FLAGS,
1450 msgsnd ID,MSG,FLAGS, msgrcv ID,VAR,SIZE,TYPE,FLAGS, my EXPR, next LABEL,
1451 next, no Module LIST, oct EXPR, oct, open FILEHANDLE,EXPR, open FILEHANDLE,
1452 opendir DIRHANDLE,EXPR, ord EXPR, ord, pack TEMPLATE,LIST, package, package
1453 NAMESPACE, pipe READHANDLE,WRITEHANDLE, pop ARRAY, pop, pos SCALAR, pos,
1454 print FILEHANDLE LIST, print LIST, print, printf FILEHANDLE FORMAT, LIST,
1455 printf FORMAT, LIST, prototype FUNCTION, push ARRAY,LIST, q/STRING/,
1456 qq/STRING/, qr/STRING/, qx/STRING/, qw/STRING/, quotemeta EXPR, quotemeta,
1457 rand EXPR, rand, read FILEHANDLE,SCALAR,LENGTH,OFFSET, read
1458 FILEHANDLE,SCALAR,LENGTH, readdir DIRHANDLE, readline EXPR, readlink EXPR,
1459 readlink, readpipe EXPR, recv SOCKET,SCALAR,LENGTH,FLAGS, redo LABEL, redo,
1460 ref EXPR, ref, rename OLDNAME,NEWNAME, require EXPR, require, reset EXPR,
1461 reset, return EXPR, return, reverse LIST, rewinddir DIRHANDLE, rindex
1462 STR,SUBSTR,POSITION, rindex STR,SUBSTR, rmdir FILENAME, rmdir, s///, scalar
1463 EXPR, seek FILEHANDLE,POSITION,WHENCE, seekdir DIRHANDLE,POS, select
1464 FILEHANDLE, select, select RBITS,WBITS,EBITS,TIMEOUT, semctl
1465 ID,SEMNUM,CMD,ARG, semget KEY,NSEMS,FLAGS, semop KEY,OPSTRING, send
1466 SOCKET,MSG,FLAGS,TO, send SOCKET,MSG,FLAGS, setpgrp PID,PGRP, setpriority
1467 WHICH,WHO,PRIORITY, setsockopt SOCKET,LEVEL,OPTNAME,OPTVAL, shift ARRAY,
1468 shift, shmctl ID,CMD,ARG, shmget KEY,SIZE,FLAGS, shmread ID,VAR,POS,SIZE,
1469 shmwrite ID,STRING,POS,SIZE, shutdown SOCKET,HOW, sin EXPR, sin, sleep
1470 EXPR, sleep, socket SOCKET,DOMAIN,TYPE,PROTOCOL, socketpair
1471 SOCKET1,SOCKET2,DOMAIN,TYPE,PROTOCOL, sort SUBNAME LIST, sort BLOCK LIST,
1472 sort LIST, splice ARRAY,OFFSET,LENGTH,LIST, splice ARRAY,OFFSET,LENGTH,
1473 splice ARRAY,OFFSET, split /PATTERN/,EXPR,LIMIT, split /PATTERN/,EXPR,
1474 split /PATTERN/, split, sprintf FORMAT, LIST, sqrt EXPR, sqrt, srand EXPR,
1475 srand, stat FILEHANDLE, stat EXPR, stat, study SCALAR, study, sub BLOCK,
1476 sub NAME, sub NAME BLOCK, substr EXPR,OFFSET,LEN,REPLACEMENT, substr
1477 EXPR,OFFSET,LEN, substr EXPR,OFFSET, symlink OLDFILE,NEWFILE, syscall LIST,
1478 sysopen FILEHANDLE,FILENAME,MODE, sysopen FILEHANDLE,FILENAME,MODE,PERMS,
1479 sysread FILEHANDLE,SCALAR,LENGTH,OFFSET, sysread FILEHANDLE,SCALAR,LENGTH,
1480 sysseek FILEHANDLE,POSITION,WHENCE, system LIST, system PROGRAM LIST,
1481 syswrite FILEHANDLE,SCALAR,LENGTH,OFFSET, syswrite
1482 FILEHANDLE,SCALAR,LENGTH, syswrite FILEHANDLE,SCALAR, tell FILEHANDLE,
1483 tell, telldir DIRHANDLE, tie VARIABLE,CLASSNAME,LIST, tied VARIABLE, time,
1484 times, tr///, truncate FILEHANDLE,LENGTH, truncate EXPR,LENGTH, uc EXPR,
1485 uc, ucfirst EXPR, ucfirst, umask EXPR, umask, undef EXPR, undef, unlink
1486 LIST, unlink, unpack TEMPLATE,EXPR, untie VARIABLE, unshift ARRAY,LIST, use
1487 Module LIST, use Module, use Module VERSION LIST, use VERSION, utime LIST,
1488 values HASH, vec EXPR,OFFSET,BITS, wait, waitpid PID,FLAGS, wantarray, warn
1489 LIST, write FILEHANDLE, write EXPR, write, y///
1490
1491 =back
1492
1493 =head2 perlvar - Perl predefined variables
1494
1495 =item DESCRIPTION
1496
1497 =over
1498
1499 =item Predefined Names
1500
1501 $ARG, $_, $E<lt>I<digits>E<gt>, $MATCH, $&, $PREMATCH, $`, $POSTMATCH, $',
1502 $LAST_PAREN_MATCH, $+, @+, $MULTILINE_MATCHING, $*, input_line_number
1503 HANDLE EXPR, $INPUT_LINE_NUMBER, $NR, $, input_record_separator HANDLE
1504 EXPR, $INPUT_RECORD_SEPARATOR, $RS, $/, autoflush HANDLE EXPR,
1505 $OUTPUT_AUTOFLUSH, $|, output_field_separator HANDLE EXPR,
1506 $OUTPUT_FIELD_SEPARATOR, $OFS, $,, output_record_separator HANDLE EXPR,
1507 $OUTPUT_RECORD_SEPARATOR, $ORS, $\, $LIST_SEPARATOR, $",
1508 $SUBSCRIPT_SEPARATOR, $SUBSEP, $;, $OFMT, $#, format_page_number HANDLE
1509 EXPR, $FORMAT_PAGE_NUMBER, $%, format_lines_per_page HANDLE EXPR,
1510 $FORMAT_LINES_PER_PAGE, $=, format_lines_left HANDLE EXPR,
1511 $FORMAT_LINES_LEFT, $-, @-, format_name HANDLE EXPR, $FORMAT_NAME, $~,
1512 format_top_name HANDLE EXPR, $FORMAT_TOP_NAME, $^,
1513 format_line_break_characters HANDLE EXPR, $FORMAT_LINE_BREAK_CHARACTERS,
1514 $:, format_formfeed HANDLE EXPR, $FORMAT_FORMFEED, $^L, $ACCUMULATOR, $^A,
1515 $CHILD_ERROR, $?, $OS_ERROR, $ERRNO, $!, $EXTENDED_OS_ERROR, $^E,
1516 $EVAL_ERROR, $@, $PROCESS_ID, $PID, $$, $REAL_USER_ID, $UID, $<,
1517 $EFFECTIVE_USER_ID, $EUID, $>, $REAL_GROUP_ID, $GID, $(,
1518 $EFFECTIVE_GROUP_ID, $EGID, $), $PROGRAM_NAME, $0, $[, $PERL_VERSION, $],
1519 $COMPILING, $^C, $DEBUGGING, $^D, $SYSTEM_FD_MAX, $^F, $^H, $INPLACE_EDIT,
1520 $^I, $^M, $OSNAME, $^O, $PERLDB, $^P, 0x01, 0x02, 0x04, 0x08, 0x10, 0x20,
1521 $^R, $^S, $BASETIME, $^T, $WARNING, $^W, $EXECUTABLE_NAME, $^X, $ARGV,
1522 @ARGV, @INC, @_, %INC, %ENV, $ENV{expr}, %SIG, $SIG{expr}
1523
1524 =item Error Indicators
1525
1526 =item Technical Note on the Syntax of Variable Names
1527
1528 =back
1529
1530 =item BUGS
1531
1532 =head2 perlsub - Perl subroutines
1533
1534 =item SYNOPSIS
1535
1536 =item DESCRIPTION
1537
1538 =over
1539
1540 =item Private Variables via my()
1541
1542 =item Persistent Private Variables
1543
1544 =item Temporary Values via local()
1545
1546 =item Passing Symbol Table Entries (typeglobs)
1547
1548 =item When to Still Use local()
1549
1550 1. You need to give a global variable a temporary value, especially $_, 2.
1551 You need to create a local file or directory handle or a local function, 3.
1552 You want to temporarily change just one element of an array or hash
1553
1554 =item Pass by Reference
1555
1556 =item Prototypes
1557
1558 =item Constant Functions
1559
1560 =item Overriding Built-in Functions
1561
1562 =item Autoloading
1563
1564 =back
1565
1566 =item SEE ALSO
1567
1568 =head2 perlmod - Perl modules (packages and symbol tables)
1569
1570 =item DESCRIPTION
1571
1572 =over
1573
1574 =item Packages
1575
1576 =item Symbol Tables
1577
1578 =item Package Constructors and Destructors
1579
1580 =item Perl Classes
1581
1582 =item Perl Modules
1583
1584 =back
1585
1586 =item SEE ALSO
1587
1588 =head2 perlmodlib - constructing new Perl modules and finding existing ones
1589
1590 =item DESCRIPTION
1591
1592 =item THE PERL MODULE LIBRARY
1593
1594 =over
1595
1596 =item Pragmatic Modules
1597
1598 attrs, autouse, base, blib, constant, diagnostics, fields, filetest,
1599 integer, less, lib, locale, ops, overload, re, sigtrap, strict, subs, utf8,
1600 vars, vmsish, warning
1601
1602 =item Standard Modules
1603
1604 AnyDBM_File, AutoLoader, AutoSplit, B, B::Asmdata, B::Assembler, B::Bblock,
1605 B::Bytecode, B::C, B::CC, B::Debug, B::Deparse, B::Disassembler, B::Lint,
1606 B::Showlex, B::Stackobj, B::Terse, B::Xref, Benchmark, CGI, CGI::Apache,
1607 CGI::Carp, CGI::Cookie, CGI::Fast, CGI::Push, CGI::Switch, CPAN,
1608 CPAN::FirstTime, CPAN::Nox, Carp, Class::Struct, Config, Cwd, DB, DB_File,
1609 Data::Dumper, Devel::Peek, Devel::SelfStubber, DirHandle, Dumpvalue,
1610 DynaLoader, English, Env, Errno, Exporter, ExtUtils::Command,
1611 ExtUtils::Embed, ExtUtils::Install, ExtUtils::Installed, ExtUtils::Liblist,
1612 ExtUtils::MM_OS2, ExtUtils::MM_Unix, ExtUtils::MM_VMS, ExtUtils::MM_Win32,
1613 ExtUtils::MakeMaker, ExtUtils::Manifest, ExtUtils::Miniperl,
1614 ExtUtils::Mkbootstrap, ExtUtils::Mksymlists, ExtUtils::Packlist,
1615 ExtUtils::testlib, Fatal, Fcntl, File::Basename, File::Compare, File::Copy,
1616 File::DosGlob, File::Find, File::Path, File::Spec, File::Spec::Functions,
1617 File::Spec::Mac, File::Spec::OS2, File::Spec::Unix, File::Spec::VMS,
1618 File::Spec::Win32, File::stat, FileCache, FileHandle, FindBin, GDBM_File,
1619 Getopt::Long, Getopt::Std, I18N::Collate, IO, IO::Dir, IO::File,
1620 IO::Handle, IO::Pipe, IO::Poll, IO::Seekable, IO::Select, IO::Socket,
1621 IO::Socket::INET, IO::Socket::UNIX, IPC::Msg, IPC::Open2, IPC::Open3,
1622 IPC::Semaphore, IPC::SysV, Math::BigFloat, Math::BigInt, Math::Complex,
1623 Math::Trig, NDBM_File, Net::Ping, Net::hostent, Net::netent, Net::protoent,
1624 Net::servent, O, Opcode, POSIX, Pod::Html, Pod::Text, SDBM_File, Safe,
1625 Search::Dict, SelectSaver, SelfLoader, Shell, Socket, Symbol,
1626 Sys::Hostname, Sys::Syslog, Term::Cap, Term::Complete, Term::ReadLine,
1627 Test, Test::Harness, Text::Abbrev, Text::ParseWords, Text::Soundex,
1628 Text::Tabs -- expand and unexpand tabs per the unix expand(1) and
1629 unexpand(1), Text::Wrap, Thread, Thread::Queue, Thread::Semaphore,
1630 Thread::Signal, Thread::Specific, Tie::Array, Tie::Handle, Tie::Hash,
1631 Tie::StdHash, Tie::RefHash, Tie::Scalar, Tie::StdScalar, Tie::SubstrHash,
1632 Time::Local, Time::gmtime, Time::localtime, Time::tm, UNIVERSAL,
1633 User::grent, User::pwent
1634
1635 =item Extension Modules
1636
1637 =back
1638
1639 =item CPAN
1640
1641 Language Extensions and Documentation Tools, Development Support, Operating
1642 System Interfaces, Networking, Device Control (modems) and InterProcess
1643 Communication, Data Types and Data Type Utilities, Database Interfaces,
1644 User Interfaces, Interfaces to / Emulations of Other Programming Languages,
1645 File Names, File Systems and File Locking (see also File Handles), String
1646 Processing, Language Text Processing, Parsing, and Searching, Option,
1647 Argument, Parameter, and Configuration File Processing,
1648 Internationalization and Locale, Authentication, Security, and Encryption,
1649 World Wide Web, HTML, HTTP, CGI, MIME, Server and Daemon Utilities,
1650 Archiving and Compression, Images, Pixmap and Bitmap Manipulation, Drawing,
1651 and Graphing, Mail and Usenet News, Control Flow Utilities (callbacks and
1652 exceptions etc), File Handle and Input/Output Stream Utilities,
1653 Miscellaneous Modules, Africa, Asia, Australasia, Europe, North America,
1654 South America
1655
1656 =item Modules: Creation, Use, and Abuse
1657
1658 =over
1659
1660 =item Guidelines for Module Creation
1661
1662 Do similar modules already exist in some form?, Try to design the new
1663 module to be easy to extend and reuse, Some simple style guidelines, Select
1664 what to export, Select a name for the module, Have you got it right?,
1665 README and other Additional Files, A description of the
1666 module/package/extension etc, A copyright notice - see below, Prerequisites
1667 - what else you may need to have, How to build it - possible changes to
1668 Makefile.PL etc, How to install it, Recent changes in this release,
1669 especially incompatibilities, Changes / enhancements you plan to make in
1670 the future, Adding a Copyright Notice, Give the module a
1671 version/issue/release number, How to release and distribute a module, Take
1672 care when changing a released module
1673
1674 =item Guidelines for Converting Perl 4 Library Scripts into Modules
1675
1676 There is no requirement to convert anything, Consider the implications,
1677 Make the most of the opportunity, The pl2pm utility will get you started,
1678 Adds the standard Module prologue lines, Converts package specifiers from '
1679 to ::, Converts die(...) to croak(...), Several other minor changes
1680
1681 =item Guidelines for Reusing Application Code
1682
1683 Complete applications rarely belong in the Perl Module Library, Many
1684 applications contain some Perl code that could be reused, Break-out the
1685 reusable code into one or more separate module files, Take the opportunity
1686 to reconsider and redesign the interfaces, In some cases the 'application'
1687 can then be reduced to a small
1688
1689 =back
1690
1691 =item NOTE
1692
1693 =head2 perlmodinstall - Installing CPAN Modules
1694
1695 =item DESCRIPTION
1696
1697 =over
1698
1699 =item PREAMBLE
1700
1701 B<DECOMPRESS> the file, B<UNPACK> the file into a directory, B<BUILD> the
1702 module (sometimes unnecessary), B<INSTALL> the module
1703
1704 =back
1705
1706 =item HEY
1707
1708 =item AUTHOR
1709
1710 =item COPYRIGHT
1711
1712 =head2 perlform - Perl formats
1713
1714 =item DESCRIPTION
1715
1716 =over
1717
1718 =item Format Variables
1719
1720 =back
1721
1722 =item NOTES
1723
1724 =over
1725
1726 =item Footers
1727
1728 =item Accessing Formatting Internals
1729
1730 =back
1731
1732 =item WARNINGS
1733
1734 =head2 perllocale - Perl locale handling (internationalization and
1735 localization)
1736
1737 =item DESCRIPTION
1738
1739 =item PREPARING TO USE LOCALES
1740
1741 =item USING LOCALES
1742
1743 =over
1744
1745 =item The use locale pragma
1746
1747 =item The setlocale function
1748
1749 =item Finding locales
1750
1751 =item LOCALE PROBLEMS
1752
1753 =item Temporarily fixing locale problems
1754
1755 =item Permanently fixing locale problems
1756
1757 =item Permanently fixing your locale configuration
1758
1759 =item Fixing system locale configuration
1760
1761 =item The localeconv function
1762
1763 =back
1764
1765 =item LOCALE CATEGORIES
1766
1767 =over
1768
1769 =item Category LC_COLLATE: Collation
1770
1771 =item Category LC_CTYPE: Character Types
1772
1773 =item Category LC_NUMERIC: Numeric Formatting
1774
1775 =item Category LC_MONETARY: Formatting of monetary amounts
1776
1777 =item LC_TIME
1778
1779 =item Other categories
1780
1781 =back
1782
1783 =item SECURITY
1784
1785 B<Comparison operators> (C<lt>, C<le>, C<ge>, C<gt> and C<cmp>):,
1786 B<Case-mapping interpolation> (with C<\l>, C<\L>, C<\u> or C<\U>),
1787 B<Matching operator> (C<m//>):, B<Substitution operator> (C<s///>):,
1788 B<In-memory formatting function> (sprintf()):, B<Output formatting
1789 functions> (printf() and write()):, B<Case-mapping functions> (lc(),
1790 lcfirst(), uc(), ucfirst()):, B<POSIX locale-dependent functions>
1791 (localeconv(), strcoll(),strftime(), strxfrm()):, B<POSIX character class
1792 tests> (isalnum(), isalpha(), isdigit(),isgraph(), islower(), isprint(),
1793 ispunct(), isspace(), isupper(),
1794 isxdigit()):
1795
1796 =item ENVIRONMENT
1797
1798 PERL_BADLANG, LC_ALL, LANGUAGE, LC_CTYPE, LC_COLLATE, LC_MONETARY,
1799 LC_NUMERIC, LC_TIME, LANG
1800
1801 =item NOTES
1802
1803 =over
1804
1805 =item Backward compatibility
1806
1807 =item I18N:Collate obsolete
1808
1809 =item Sort speed and memory use impacts
1810
1811 =item write() and LC_NUMERIC
1812
1813 =item Freely available locale definitions
1814
1815 =item I18n and l10n
1816
1817 =item An imperfect standard
1818
1819 =back
1820
1821 =item BUGS
1822
1823 =over
1824
1825 =item Broken systems
1826
1827 =back
1828
1829 =item SEE ALSO
1830
1831 =item HISTORY
1832
1833 =head2 perlref - Perl references and nested data structures
1834
1835 =item NOTE
1836
1837 =item DESCRIPTION
1838
1839 =over
1840
1841 =item Making References
1842
1843 =item Using References
1844
1845 =item Symbolic references
1846
1847 =item Not-so-symbolic references
1848
1849 =item Pseudo-hashes: Using an array as a hash
1850
1851 =item Function Templates
1852
1853 =back
1854
1855 =item WARNING
1856
1857 =item SEE ALSO
1858
1859 =head2 perlreftut - Mark's very short tutorial about references
1860
1861 =item DESCRIPTION
1862
1863 =item Who Needs Complicated Data Structures?
1864
1865 =item The Solution
1866
1867 =item Syntax
1868
1869 =over
1870
1871 =item Making References
1872
1873 =item Using References
1874
1875 =back
1876
1877 =item An Example
1878
1879 =item Arrow Rule
1880
1881 =item Solution
1882
1883 =item The Rest
1884
1885 =item Summary
1886
1887 =item Credits
1888
1889 =over
1890
1891 =item Distribution Conditions
1892
1893 =back
1894
1895 =head2 perldsc - Perl Data Structures Cookbook
1896
1897 =item DESCRIPTION
1898
1899 arrays of arrays, hashes of arrays, arrays of hashes, hashes of hashes,
1900 more elaborate constructs
1901
1902 =item REFERENCES
1903
1904 =item COMMON MISTAKES
1905
1906 =item CAVEAT ON PRECEDENCE
1907
1908 =item WHY YOU SHOULD ALWAYS C<use strict>
1909
1910 =item DEBUGGING
1911
1912 =item CODE EXAMPLES
1913
1914 =item ARRAYS OF ARRAYS
1915
1916 =over
1917
1918 =item Declaration of a ARRAY OF ARRAYS
1919
1920 =item Generation of a ARRAY OF ARRAYS
1921
1922 =item Access and Printing of a ARRAY OF ARRAYS
1923
1924 =back
1925
1926 =item HASHES OF ARRAYS
1927
1928 =over
1929
1930 =item Declaration of a HASH OF ARRAYS
1931
1932 =item Generation of a HASH OF ARRAYS
1933
1934 =item Access and Printing of a HASH OF ARRAYS
1935
1936 =back
1937
1938 =item ARRAYS OF HASHES
1939
1940 =over
1941
1942 =item Declaration of a ARRAY OF HASHES
1943
1944 =item Generation of a ARRAY OF HASHES
1945
1946 =item Access and Printing of a ARRAY OF HASHES
1947
1948 =back
1949
1950 =item HASHES OF HASHES
1951
1952 =over
1953
1954 =item Declaration of a HASH OF HASHES
1955
1956 =item Generation of a HASH OF HASHES
1957
1958 =item Access and Printing of a HASH OF HASHES
1959
1960 =back
1961
1962 =item MORE ELABORATE RECORDS
1963
1964 =over
1965
1966 =item Declaration of MORE ELABORATE RECORDS
1967
1968 =item Declaration of a HASH OF COMPLEX RECORDS
1969
1970 =item Generation of a HASH OF COMPLEX RECORDS
1971
1972 =back
1973
1974 =item Database Ties
1975
1976 =item SEE ALSO
1977
1978 =item AUTHOR
1979
1980 =head2 perllol - Manipulating Arrays of Arrays in Perl
1981
1982 =item DESCRIPTION
1983
1984 =item Declaration and Access of Arrays of Arrays
1985
1986 =item Growing Your Own
1987
1988 =item Access and Printing
1989
1990 =item Slices
1991
1992 =item SEE ALSO
1993
1994 =item AUTHOR
1995
1996 =head2 perltoot - Tom's object-oriented tutorial for perl
1997
1998 =item DESCRIPTION
1999
2000 =item Creating a Class
2001
2002 =over
2003
2004 =item Object Representation
2005
2006 =item Class Interface
2007
2008 =item Constructors and Instance Methods
2009
2010 =item Planning for the Future: Better Constructors
2011
2012 =item Destructors
2013
2014 =item Other Object Methods
2015
2016 =back
2017
2018 =item Class Data
2019
2020 =over
2021
2022 =item Accessing Class Data
2023
2024 =item Debugging Methods
2025
2026 =item Class Destructors
2027
2028 =item Documenting the Interface
2029
2030 =back
2031
2032 =item Aggregation
2033
2034 =item Inheritance
2035
2036 =over
2037
2038 =item Overridden Methods
2039
2040 =item Multiple Inheritance
2041
2042 =item UNIVERSAL: The Root of All Objects
2043
2044 =back
2045
2046 =item Alternate Object Representations
2047
2048 =over
2049
2050 =item Arrays as Objects
2051
2052 =item Closures as Objects
2053
2054 =back
2055
2056 =item AUTOLOAD: Proxy Methods
2057
2058 =over
2059
2060 =item Autoloaded Data Methods
2061
2062 =item Inherited Autoloaded Data Methods
2063
2064 =back
2065
2066 =item Metaclassical Tools
2067
2068 =over
2069
2070 =item Class::Struct
2071
2072 =item Data Members as Variables
2073
2074 =item NOTES
2075
2076 =item Object Terminology
2077
2078 =back
2079
2080 =item SEE ALSO
2081
2082 =item AUTHOR AND COPYRIGHT
2083
2084 =item COPYRIGHT
2085
2086 =over
2087
2088 =item Acknowledgments
2089
2090 =back
2091
2092 =head2 perltootc - Tom's OO Tutorial for Class Data in Perl
2093
2094 =item DESCRIPTION
2095
2096 =item Class Data as Package Variables
2097
2098 =over
2099
2100 =item Putting All Your Eggs in One Basket
2101
2102 =item Inheritance Concerns
2103
2104 =item The Eponymous Meta-Object
2105
2106 =item Indirect References to Class Data
2107
2108 =item Monadic Classes
2109
2110 =item Translucent Attributes
2111
2112 =back
2113
2114 =item Class Data as Lexical Variables
2115
2116 =over
2117
2118 =item Privacy and Responsibility
2119
2120 =item File-Scoped Lexicals
2121
2122 =item More Inheritance Concerns
2123
2124 =item Locking the Door and Throwing Away the Key
2125
2126 =item Translucency Revisited
2127
2128 =back
2129
2130 =item NOTES
2131
2132 =item SEE ALSO
2133
2134 =item AUTHOR AND COPYRIGHT
2135
2136 =item ACKNOWLEDGEMENTS
2137
2138 =item HISTORY
2139
2140 =head2 perlobj - Perl objects
2141
2142 =item DESCRIPTION
2143
2144 =over
2145
2146 =item An Object is Simply a Reference
2147
2148 =item A Class is Simply a Package
2149
2150 =item A Method is Simply a Subroutine
2151
2152 =item Method Invocation
2153
2154 =item WARNING
2155
2156 =item Default UNIVERSAL methods
2157
2158 isa(CLASS), can(METHOD), VERSION( [NEED] )
2159
2160 =item Destructors
2161
2162 =item Summary
2163
2164 =item Two-Phased Garbage Collection
2165
2166 =back
2167
2168 =item SEE ALSO
2169
2170 =head2 perltie - how to hide an object class in a simple variable
2171
2172 =item SYNOPSIS
2173
2174 =item DESCRIPTION
2175
2176 =over
2177
2178 =item Tying Scalars
2179
2180 TIESCALAR classname, LIST, FETCH this, STORE this, value, DESTROY this
2181
2182 =item Tying Arrays
2183
2184 TIEARRAY classname, LIST, FETCH this, index, STORE this, index, value,
2185 DESTROY this
2186
2187 =item Tying Hashes
2188
2189 USER, HOME, CLOBBER, LIST, TIEHASH classname, LIST, FETCH this, key, STORE
2190 this, key, value, DELETE this, key, CLEAR this, EXISTS this, key, FIRSTKEY
2191 this, NEXTKEY this, lastkey, DESTROY this
2192
2193 =item Tying FileHandles
2194
2195 TIEHANDLE classname, LIST, WRITE this, LIST, PRINT this, LIST, PRINTF this,
2196 LIST, READ this, LIST, READLINE this, GETC this, CLOSE this, DESTROY this
2197
2198 =item The C<untie> Gotcha
2199
2200 =back
2201
2202 =item SEE ALSO
2203
2204 =item BUGS
2205
2206 =item AUTHOR
2207
2208 =head2 perlbot - Bag'o Object Tricks (the BOT)
2209
2210 =item DESCRIPTION
2211
2212 =item OO SCALING TIPS
2213
2214 =item INSTANCE VARIABLES
2215
2216 =item SCALAR INSTANCE VARIABLES
2217
2218 =item INSTANCE VARIABLE INHERITANCE
2219
2220 =item OBJECT RELATIONSHIPS
2221
2222 =item OVERRIDING SUPERCLASS METHODS
2223
2224 =item USING RELATIONSHIP WITH SDBM
2225
2226 =item THINKING OF CODE REUSE
2227
2228 =item CLASS CONTEXT AND THE OBJECT
2229
2230 =item INHERITING A CONSTRUCTOR
2231
2232 =item DELEGATION
2233
2234 =head2 perlipc - Perl interprocess communication (signals, fifos, pipes,
2235 safe subprocesses, sockets, and semaphores)
2236
2237 =item DESCRIPTION
2238
2239 =item Signals
2240
2241 =item Named Pipes
2242
2243 =over
2244
2245 =item WARNING
2246
2247 =back
2248
2249 =item Using open() for IPC
2250
2251 =over
2252
2253 =item Filehandles
2254
2255 =item Background Processes
2256
2257 =item Complete Dissociation of Child from Parent
2258
2259 =item Safe Pipe Opens
2260
2261 =item Bidirectional Communication with Another Process
2262
2263 =item Bidirectional Communication with Yourself
2264
2265 =back
2266
2267 =item Sockets: Client/Server Communication
2268
2269 =over
2270
2271 =item Internet Line Terminators
2272
2273 =item Internet TCP Clients and Servers
2274
2275 =item Unix-Domain TCP Clients and Servers
2276
2277 =back
2278
2279 =item TCP Clients with IO::Socket
2280
2281 =over
2282
2283 =item A Simple Client
2284
2285 C<Proto>, C<PeerAddr>, C<PeerPort>
2286
2287 =item A Webget Client
2288
2289 =item Interactive Client with IO::Socket
2290
2291 =back
2292
2293 =item TCP Servers with IO::Socket
2294
2295 Proto, LocalPort, Listen, Reuse
2296
2297 =item UDP: Message Passing
2298
2299 =item SysV IPC
2300
2301 =item NOTES
2302
2303 =item BUGS
2304
2305 =item AUTHOR
2306
2307 =item SEE ALSO
2308
2309 =head2 perldbmfilter - Perl DBM Filters
2310
2311 =item SYNOPSIS
2312
2313 =item DESCRIPTION
2314
2315 B<filter_store_key>, B<filter_store_value>, B<filter_fetch_key>,
2316 B<filter_fetch_value>
2317
2318 =over
2319
2320 =item The Filter
2321
2322 =item An Example -- the NULL termination problem.
2323
2324 =item Another Example -- Key is a C int.
2325
2326 =back
2327
2328 =item SEE ALSO
2329
2330 =item AUTHOR
2331
2332 =head2 perldebug - Perl debugging
2333
2334 =item DESCRIPTION
2335
2336 =item The Perl Debugger
2337
2338 =over
2339
2340 =item Debugger Commands
2341
2342 h [command], p expr, x expr, V [pkg [vars]], X [vars], T, s [expr], n
2343 [expr], E<lt>CRE<gt>, c [line|sub], l, l min+incr, l min-max, l line, l
2344 subname, -, w [line], f filename, /pattern/, ?pattern?, L, S [[!]pattern],
2345 t, t expr, b [line] [condition], b subname [condition], b postpone subname
2346 [condition], b load filename, b compile subname, d [line], D, a [line]
2347 command, A, W [expr], W, O [opt[=val]] [opt"val"] [opt?]..,
2348 C<recallCommand>, C<ShellBang>, C<pager>, C<tkRunning>, C<signalLevel>,
2349 C<warnLevel>, C<dieLevel>, C<AutoTrace>, C<LineInfo>, C<inhibit_exit>,
2350 C<PrintRet>, C<ornaments>, C<frame>, C<maxTraceLen>, C<arrayDepth>,
2351 C<hashDepth>, C<compactDump>, C<veryCompact>, C<globPrint>, C<DumpDBFiles>,
2352 C<DumpPackages>, C<DumpReused>, C<quote>, C<HighBit>, C<undefPrint>,
2353 C<UsageOnly>, C<TTY>, C<noTTY>, C<ReadLine>, C<NonStop>, E<lt> [ command ],
2354 E<lt>E<lt> command, E<gt> command, E<gt>E<gt> command, { [ command ], {{
2355 command, ! number, ! -number, ! pattern, !! cmd, H -number, q or ^D, R,
2356 |dbcmd, ||dbcmd, command, m expr, m package
2357
2358 =item Debugger input/output
2359
2360 Prompt, Multiline commands, Stack backtrace, Listing, Frame listing
2361
2362 =item Debugging compile-time statements
2363
2364 =item Debugger Customization
2365
2366 =item Readline Support
2367
2368 =item Editor Support for Debugging
2369
2370 =item The Perl Profiler
2371
2372 =item Debugger support in perl
2373
2374 =item Debugger Internals
2375
2376 =item Other resources
2377
2378 =item BUGS
2379
2380 =back
2381
2382 =item Debugging Perl memory usage
2383
2384 =over
2385
2386 =item Using C<$ENV{PERL_DEBUG_MSTATS}>
2387
2388 C<buckets SMALLEST(APPROX)..GREATEST(APPROX)>, Free/Used, C<Total sbrk():
2389 SBRKed/SBRKs:CONTINUOUS>, C<pad: 0>, C<heads: 2192>, C<chain: 0>, C<tail:
2390 6144>
2391
2392 =item Example of using B<-DL> switch
2393
2394 C<717>, C<002>, C<054>, C<602>, C<702>, C<704>
2395
2396 =item B<-DL> details
2397
2398 C<!!!>, C<!!>, C<!>
2399
2400 =item Limitations of B<-DL> statistic
2401
2402 =back
2403
2404 =item Debugging regular expressions
2405
2406 =over
2407
2408 =item Compile-time output
2409
2410 C<anchored> I<STRING> C<at> I<POS>, C<floating> I<STRING> C<at>
2411 I<POS1..POS2>, C<matching floating/anchored>, C<minlen>, C<stclass>
2412 I<TYPE>, C<noscan>, C<isall>, C<GPOS>, C<plus>, C<implicit>, C<with eval>,
2413 C<anchored(TYPE)>
2414
2415 =item Types of nodes
2416
2417 =item Run-time output
2418
2419 =back
2420
2421 =head2 perldiag - various Perl diagnostics
2422
2423 =item DESCRIPTION
2424
2425 =head2 perlsec - Perl security
2426
2427 =item DESCRIPTION
2428
2429 =over
2430
2431 =item Laundering and Detecting Tainted Data
2432
2433 =item Switches On the "#!" Line
2434
2435 =item Cleaning Up Your Path
2436
2437 =item Security Bugs
2438
2439 =item Protecting Your Programs
2440
2441 =back
2442
2443 =item SEE ALSO
2444
2445 =head2 perltrap - Perl traps for the unwary
2446
2447 =item DESCRIPTION
2448
2449 =over
2450
2451 =item Awk Traps
2452
2453 =item C Traps
2454
2455 =item Sed Traps
2456
2457 =item Shell Traps
2458
2459 =item Perl Traps
2460
2461 =item Perl4 to Perl5 Traps
2462
2463 Discontinuance, Deprecation, and BugFix traps, Parsing Traps, Numerical
2464 Traps, General data type traps, Context Traps - scalar, list contexts,
2465 Precedence Traps, General Regular Expression Traps using s///, etc,
2466 Subroutine, Signal, Sorting Traps, OS Traps, DBM Traps, Unclassified Traps
2467
2468 =item Discontinuance, Deprecation, and BugFix traps
2469
2470 Discontinuance, Deprecation, BugFix, Discontinuance, Discontinuance,
2471 Discontinuance, BugFix, Discontinuance, Discontinuance, BugFix,
2472 Discontinuance, Discontinuance, Deprecation, Discontinuance
2473
2474 =item Parsing Traps
2475
2476 Parsing, Parsing, Parsing, Parsing
2477
2478 =item Numerical Traps
2479
2480 Numerical, Numerical, Numerical
2481
2482 =item General data type traps
2483
2484 (Arrays), (Arrays), (Hashes), (Globs), (Globs), (Scalar String),
2485 (Constants), (Scalars), (Variable Suicide)
2486
2487 =item Context Traps - scalar, list contexts
2488
2489 (list context), (scalar context), (scalar context), (list, builtin)
2490
2491 =item Precedence Traps
2492
2493 Precedence, Precedence, Precedence, Precedence, Precedence, Precedence,
2494 Precedence
2495
2496 =item General Regular Expression Traps using s///, etc.
2497
2498 Regular Expression, Regular Expression, Regular Expression, Regular
2499 Expression, Regular Expression, Regular Expression, Regular Expression,
2500 Regular Expression
2501
2502 =item Subroutine, Signal, Sorting Traps
2503
2504 (Signals), (Sort Subroutine), warn() won't let you specify a filehandle
2505
2506 =item OS Traps
2507
2508 (SysV), (SysV)
2509
2510 =item Interpolation Traps
2511
2512 Interpolation, Interpolation, Interpolation, Interpolation, Interpolation,
2513 Interpolation, Interpolation, Interpolation, Interpolation
2514
2515 =item DBM Traps
2516
2517 DBM, DBM
2518
2519 =item Unclassified Traps
2520
2521 C<require>/C<do> trap using returned value, C<split> on empty string with
2522 LIMIT specified
2523
2524 =back
2525
2526 =head2 perlport - Writing portable Perl
2527
2528 =item DESCRIPTION
2529
2530 Not all Perl programs have to be portable, The vast majority of Perl I<is>
2531 portable
2532
2533 =item ISSUES
2534
2535 =over
2536
2537 =item Newlines
2538
2539 =item Numbers endianness and Width
2540
2541 =item Files and Filesystems
2542
2543 =item System Interaction
2544
2545 =item Interprocess Communication (IPC)
2546
2547 =item External Subroutines (XS)
2548
2549 =item Standard Modules
2550
2551 =item Time and Date
2552
2553 =item Character sets and character encoding
2554
2555 =item Internationalisation
2556
2557 =item System Resources
2558
2559 =item Security
2560
2561 =item Style
2562
2563 =back
2564
2565 =item CPAN Testers
2566
2567 Mailing list: cpan-testers@perl.org, Testing results:
2568 C<http://www.perl.org/cpan-testers/>
2569
2570 =item PLATFORMS
2571
2572 =over
2573
2574 =item Unix
2575
2576 =item DOS and Derivatives
2577
2578 The djgpp environment for DOS, C<http://www.delorie.com/djgpp/>, The EMX
2579 environment for DOS, OS/2, etc.
2580 C<emx@iaehv.nl>,C<http://www.leo.org/pub/comp/os/os2/leo/gnu/emx+gcc/index.
2581 html> or
2582 C<ftp://hobbes.nmsu.edu/pub/os2/dev/emx>, Build instructions for Win32,
2583 L<perlwin32>, The ActiveState Pages, C<http://www.activestate.com/>
2584
2585 =item S<Mac OS>
2586
2587 The MacPerl Pages, C<http://www.macperl.com/>, The MacPerl mailing lists,
2588 C<http://www.macperl.org/>, MacPerl Module Porters,
2589 C<http://pudge.net/mmp/>
2590
2591 =item VMS
2592
2593 L<perlvms.pod>, vmsperl list, C<majordomo@perl.org>, vmsperl on the web,
2594 C<http://www.sidhe.org/vmsperl/index.html>
2595
2596 =item VOS
2597
2598 L<README.vos>, VOS mailing list, VOS Perl on the web at
2599 C<http://ftp.stratus.com/pub/vos/vos.html>
2600
2601 =item EBCDIC Platforms
2602
2603 perl-mvs list, AS/400 Perl information at
2604 C<http://as400.rochester.ibm.com/>
2605
2606 =item Acorn RISC OS
2607
2608 =item Other perls
2609
2610 Atari, Guido Flohr's page C<http://stud.uni-sb.de/~gufl0000/>, HP 300
2611 MPE/iX  C<http://www.cccd.edu/~markb/perlix.html>, Novell Netware
2612
2613 =back
2614
2615 =item FUNCTION IMPLEMENTATIONS
2616
2617 =over
2618
2619 =item Alphabetical Listing of Perl Functions
2620
2621 -I<X> FILEHANDLE, -I<X> EXPR, -I<X>, binmode FILEHANDLE, chmod LIST, chown
2622 LIST, chroot FILENAME, chroot, crypt PLAINTEXT,SALT, dbmclose HASH, dbmopen
2623 HASH,DBNAME,MODE, dump LABEL, exec LIST, fcntl FILEHANDLE,FUNCTION,SCALAR,
2624 flock FILEHANDLE,OPERATION, fork, getlogin, getpgrp PID, getppid,
2625 getpriority WHICH,WHO, getpwnam NAME, getgrnam NAME, getnetbyname NAME,
2626 getpwuid UID, getgrgid GID, getnetbyaddr ADDR,ADDRTYPE, getprotobynumber
2627 NUMBER, getservbyport PORT,PROTO, getpwent, getgrent, gethostent,
2628 getnetent, getprotoent, getservent, setpwent, setgrent, sethostent
2629 STAYOPEN, setnetent STAYOPEN, setprotoent STAYOPEN, setservent STAYOPEN,
2630 endpwent, endgrent, endhostent, endnetent, endprotoent, endservent,
2631 getsockopt SOCKET,LEVEL,OPTNAME, glob EXPR, glob, ioctl
2632 FILEHANDLE,FUNCTION,SCALAR, kill LIST, link OLDFILE,NEWFILE, lstat
2633 FILEHANDLE, lstat EXPR, lstat, msgctl ID,CMD,ARG, msgget KEY,FLAGS, msgsnd
2634 ID,MSG,FLAGS, msgrcv ID,VAR,SIZE,TYPE,FLAGS, open FILEHANDLE,EXPR, open
2635 FILEHANDLE, pipe READHANDLE,WRITEHANDLE, readlink EXPR, readlink, select
2636 RBITS,WBITS,EBITS,TIMEOUT, semctl ID,SEMNUM,CMD,ARG, semget
2637 KEY,NSEMS,FLAGS, semop KEY,OPSTRING, setpgrp PID,PGRP, setpriority
2638 WHICH,WHO,PRIORITY, setsockopt SOCKET,LEVEL,OPTNAME,OPTVAL, shmctl
2639 ID,CMD,ARG, shmget KEY,SIZE,FLAGS, shmread ID,VAR,POS,SIZE, shmwrite
2640 ID,STRING,POS,SIZE, socketpair SOCKET1,SOCKET2,DOMAIN,TYPE,PROTOCOL, stat
2641 FILEHANDLE, stat EXPR, stat, symlink OLDFILE,NEWFILE, syscall LIST, sysopen
2642 FILEHANDLE,FILENAME,MODE,PERMS, system LIST, times, truncate
2643 FILEHANDLE,LENGTH, truncate EXPR,LENGTH, umask EXPR, umask, utime LIST,
2644 wait, waitpid PID,FLAGS
2645
2646 =back
2647
2648 =item CHANGES
2649
2650 v1.42, 22 May 1999Added notes about tests, sprintf/printf, and epoch
2651 offsets.
2652 =item v1.41, 19 May 1999, v1.40, 11 April 1999, v1.39, 11 February 1999,
2653 v1.38, 31 December 1998, v1.37, 19 December 1998, v1.36, 9 September 1998,
2654 v1.35, 13 August 1998, v1.33, 06 August 1998, v1.32, 05 August 1998, v1.30,
2655 03 August 1998, v1.23, 10 July 1998
2656
2657 =item AUTHORS / CONTRIBUTORS
2658
2659 =item VERSION
2660
2661 =head2 perlstyle - Perl style guide
2662
2663 =item DESCRIPTION
2664
2665 =head2 perlpod - plain old documentation
2666
2667 =item DESCRIPTION
2668
2669 =over
2670
2671 =item Verbatim Paragraph
2672
2673 =item Command Paragraph
2674
2675 =item Ordinary Block of Text
2676
2677 =item The Intent
2678
2679 =item Embedding Pods in Perl Modules
2680
2681 =item Common Pod Pitfalls
2682
2683 =back
2684
2685 =item SEE ALSO
2686
2687 =item AUTHOR
2688
2689 =head2 perlbook - Perl book information
2690
2691 =item DESCRIPTION
2692
2693 =head2 perlembed - how to embed perl in your C program
2694
2695 =item DESCRIPTION
2696
2697 =over
2698
2699 =item PREAMBLE
2700
2701 B<Use C from Perl?>, B<Use a Unix program from Perl?>, B<Use Perl from
2702 Perl?>, B<Use C from C?>, B<Use Perl from C?>
2703
2704 =item ROADMAP
2705
2706 =item Compiling your C program
2707
2708 =item Adding a Perl interpreter to your C program
2709
2710 =item Calling a Perl subroutine from your C program
2711
2712 =item Evaluating a Perl statement from your C program
2713
2714 =item Performing Perl pattern matches and substitutions from your C program
2715
2716 =item Fiddling with the Perl stack from your C program
2717
2718 =item Maintaining a persistent interpreter
2719
2720 =item Maintaining multiple interpreter instances
2721
2722 =item Using Perl modules, which themselves use C libraries, from your C
2723 program
2724
2725 =back
2726
2727 =item Embedding Perl under Win32
2728
2729 =item MORAL
2730
2731 =item AUTHOR
2732
2733 =item COPYRIGHT
2734
2735 =head2 perlapio - perl's IO abstraction interface.
2736
2737 =item SYNOPSIS
2738
2739 =item DESCRIPTION
2740
2741 B<PerlIO *>, B<PerlIO_stdin()>, B<PerlIO_stdout()>, B<PerlIO_stderr()>,
2742 B<PerlIO_open(path, mode)>, B<PerlIO_fdopen(fd,mode)>,
2743 B<PerlIO_printf(f,fmt,...)>, B<PerlIO_vprintf(f,fmt,a)>,
2744 B<PerlIO_stdoutf(fmt,...)>, B<PerlIO_read(f,buf,count)>,
2745 B<PerlIO_write(f,buf,count)>, B<PerlIO_close(f)>, B<PerlIO_puts(f,s)>,
2746 B<PerlIO_putc(f,c)>, B<PerlIO_ungetc(f,c)>, B<PerlIO_getc(f)>,
2747 B<PerlIO_eof(f)>, B<PerlIO_error(f)>, B<PerlIO_fileno(f)>,
2748 B<PerlIO_clearerr(f)>, B<PerlIO_flush(f)>, B<PerlIO_tell(f)>,
2749 B<PerlIO_seek(f,o,w)>, B<PerlIO_getpos(f,p)>, B<PerlIO_setpos(f,p)>,
2750 B<PerlIO_rewind(f)>, B<PerlIO_tmpfile()>
2751
2752 =over
2753
2754 =item Co-existence with stdio
2755
2756 B<PerlIO_importFILE(f,flags)>, B<PerlIO_exportFILE(f,flags)>,
2757 B<PerlIO_findFILE(f)>, B<PerlIO_releaseFILE(p,f)>, B<PerlIO_setlinebuf(f)>,
2758 B<PerlIO_has_cntptr(f)>, B<PerlIO_get_ptr(f)>, B<PerlIO_get_cnt(f)>,
2759 B<PerlIO_canset_cnt(f)>, B<PerlIO_fast_gets(f)>,
2760 B<PerlIO_set_ptrcnt(f,p,c)>, B<PerlIO_set_cnt(f,c)>, B<PerlIO_has_base(f)>,
2761 B<PerlIO_get_base(f)>, B<PerlIO_get_bufsiz(f)>
2762
2763 =back
2764
2765 =head2 perlxs - XS language reference manual
2766
2767 =item DESCRIPTION
2768
2769 =over
2770
2771 =item Introduction
2772
2773 =item On The Road
2774
2775 =item The Anatomy of an XSUB
2776
2777 =item The Argument Stack
2778
2779 =item The RETVAL Variable
2780
2781 =item The MODULE Keyword
2782
2783 =item The PACKAGE Keyword
2784
2785 =item The PREFIX Keyword
2786
2787 =item The OUTPUT: Keyword
2788
2789 =item The CODE: Keyword
2790
2791 =item The INIT: Keyword
2792
2793 =item The NO_INIT Keyword
2794
2795 =item Initializing Function Parameters
2796
2797 =item Default Parameter Values
2798
2799 =item The PREINIT: Keyword
2800
2801 =item The SCOPE: Keyword
2802
2803 =item The INPUT: Keyword
2804
2805 =item Variable-length Parameter Lists
2806
2807 =item The C_ARGS: Keyword
2808
2809 =item The PPCODE: Keyword
2810
2811 =item Returning Undef And Empty Lists
2812
2813 =item The REQUIRE: Keyword
2814
2815 =item The CLEANUP: Keyword
2816
2817 =item The BOOT: Keyword
2818
2819 =item The VERSIONCHECK: Keyword
2820
2821 =item The PROTOTYPES: Keyword
2822
2823 =item The PROTOTYPE: Keyword
2824
2825 =item The ALIAS: Keyword
2826
2827 =item The INTERFACE: Keyword
2828
2829 =item The INTERFACE_MACRO: Keyword
2830
2831 =item The INCLUDE: Keyword
2832
2833 =item The CASE: Keyword
2834
2835 =item The & Unary Operator
2836
2837 =item Inserting Comments and C Preprocessor Directives
2838
2839 =item Using XS With C++
2840
2841 =item Interface Strategy
2842
2843 =item Perl Objects And C Structures
2844
2845 =item The Typemap
2846
2847 =back
2848
2849 =item EXAMPLES
2850
2851 =item XS VERSION
2852
2853 =item AUTHOR
2854
2855 =head2 perlxstut, perlXStut - Tutorial for XSUBs
2856
2857 =item DESCRIPTION
2858
2859 =over
2860
2861 =item VERSION CAVEAT
2862
2863 =item DYNAMIC VERSUS STATIC
2864
2865 =item EXAMPLE 1
2866
2867 =item EXAMPLE 2
2868
2869 =item WHAT HAS GONE ON?
2870
2871 =item WRITING GOOD TEST SCRIPTS
2872
2873 =item EXAMPLE 3
2874
2875 =item WHAT'S NEW HERE?
2876
2877 =item INPUT AND OUTPUT PARAMETERS
2878
2879 =item THE XSUBPP COMPILER
2880
2881 =item THE TYPEMAP FILE
2882
2883 =item WARNING
2884
2885 =item EXAMPLE 4
2886
2887 =item WHAT HAS HAPPENED HERE?
2888
2889 =item SPECIFYING ARGUMENTS TO XSUBPP
2890
2891 =item THE ARGUMENT STACK
2892
2893 =item EXTENDING YOUR EXTENSION
2894
2895 =item DOCUMENTING YOUR EXTENSION
2896
2897 =item INSTALLING YOUR EXTENSION
2898
2899 =item SEE ALSO
2900
2901 =item Author
2902
2903 =item Last Changed
2904
2905 =back
2906
2907 =head2 perlguts - Perl's Internal Functions
2908
2909 =item DESCRIPTION
2910
2911 =item Variables
2912
2913 =over
2914
2915 =item Datatypes
2916
2917 =item What is an "IV"?
2918
2919 =item Working with SVs
2920
2921 =item What's Really Stored in an SV?
2922
2923 =item Working with AVs
2924
2925 =item Working with HVs
2926
2927 =item Hash API Extensions
2928
2929 =item References
2930
2931 =item Blessed References and Class Objects
2932
2933 =item Creating New Variables
2934
2935 =item Reference Counts and Mortality
2936
2937 =item Stashes and Globs
2938
2939 =item Double-Typed SVs
2940
2941 =item Magic Variables
2942
2943 =item Assigning Magic
2944
2945 =item Magic Virtual Tables
2946
2947 =item Finding Magic
2948
2949 =item Understanding the Magic of Tied Hashes and Arrays
2950
2951 =item Localizing changes
2952
2953 C<SAVEINT(int i)>, C<SAVEIV(IV i)>, C<SAVEI32(I32 i)>, C<SAVELONG(long i)>,
2954 C<SAVESPTR(s)>, C<SAVEPPTR(p)>, C<SAVEFREESV(SV *sv)>, C<SAVEFREEOP(OP
2955 *op)>, C<SAVEFREEPV(p)>, C<SAVECLEARSV(SV *sv)>, C<SAVEDELETE(HV *hv, char
2956 *key, I32 length)>, C<SAVEDESTRUCTOR(f,p)>, C<SAVESTACK_POS()>, C<SV*
2957 save_scalar(GV *gv)>, C<AV* save_ary(GV *gv)>, C<HV* save_hash(GV *gv)>,
2958 C<void save_item(SV *item)>, C<void save_list(SV **sarg, I32 maxsarg)>,
2959 C<SV* save_svref(SV **sptr)>, C<void save_aptr(AV **aptr)>, C<void
2960 save_hptr(HV **hptr)>
2961
2962 =back
2963
2964 =item Subroutines
2965
2966 =over
2967
2968 =item XSUBs and the Argument Stack
2969
2970 =item Calling Perl Routines from within C Programs
2971
2972 =item Memory Allocation
2973
2974 =item PerlIO
2975
2976 =item Putting a C value on Perl stack
2977
2978 =item Scratchpads
2979
2980 =item Scratchpads and recursion
2981
2982 =back
2983
2984 =item Compiled code
2985
2986 =over
2987
2988 =item Code tree
2989
2990 =item Examining the tree
2991
2992 =item Compile pass 1: check routines
2993
2994 =item Compile pass 1a: constant folding
2995
2996 =item Compile pass 2: context propagation
2997
2998 =item Compile pass 3: peephole optimization
2999
3000 =back
3001
3002 =item API LISTING
3003
3004 av_clear, av_extend, av_fetch, AvFILL, av_len, av_make, av_pop, av_push,
3005 av_shift, av_store, av_undef, av_unshift, CLASS, Copy, croak, CvSTASH,
3006 PL_DBsingle, PL_DBsub, PL_DBtrace, dMARK, dORIGMARK, PL_dowarn, dSP,
3007 dXSARGS, dXSI32, do_binmode, ENTER, EXTEND, fbm_compile, fbm_instr,
3008 FREETMPS, G_ARRAY, G_DISCARD, G_EVAL, GIMME, GIMME_V, G_NOARGS, G_SCALAR,
3009 gv_fetchmeth, gv_fetchmethod, gv_fetchmethod_autoload, G_VOID, gv_stashpv,
3010 gv_stashsv, GvSV, HEf_SVKEY, HeHASH, HeKEY, HeKLEN, HePV, HeSVKEY,
3011 HeSVKEY_force, HeSVKEY_set, HeVAL, hv_clear, hv_delete, hv_delete_ent,
3012 hv_exists, hv_exists_ent, hv_fetch, hv_fetch_ent, hv_iterinit, hv_iterkey,
3013 hv_iterkeysv, hv_iternext, hv_iternextsv, hv_iterval, hv_magic, HvNAME,
3014 hv_store, hv_store_ent, hv_undef, isALNUM, isALPHA, isDIGIT, isLOWER,
3015 isSPACE, isUPPER, items, ix, LEAVE, looks_like_number, MARK, mg_clear,
3016 mg_copy, mg_find, mg_free, mg_get, mg_len, mg_magical, mg_set, modglobal,
3017 Move, PL_na, New, newAV, Newc, newCONSTSUB, newHV, newRV_inc, newRV_noinc,
3018 NEWSV, newSViv, newSVnv, newSVpv, newSVpvf, newSVpvn, newSVrv, newSVsv,
3019 newXS, newXSproto, Newz, Nullav, Nullch, Nullcv, Nullhv, Nullsv, ORIGMARK,
3020 perl_alloc, perl_call_argv, perl_call_method, perl_call_pv, perl_call_sv,
3021 perl_construct, perl_destruct, perl_eval_sv, perl_eval_pv, perl_free,
3022 perl_get_av, perl_get_cv, perl_get_hv, perl_get_sv, perl_parse,
3023 perl_require_pv, perl_run, POPi, POPl, POPp, POPn, POPs, PUSHMARK, PUSHi,
3024 PUSHn, PUSHp, PUSHs, PUSHu, PUTBACK, Renew, Renewc, RETVAL, safefree,
3025 safemalloc, saferealloc, savepv, savepvn, SAVETMPS, SP, SPAGAIN, ST, strEQ,
3026 strGE, strGT, strLE, strLT, strNE, strnEQ, strnNE, sv_2mortal, sv_bless,
3027 sv_catpv, sv_catpv_mg, sv_catpvn, sv_catpvn_mg, sv_catpvf, sv_catpvf_mg,
3028 sv_catsv, sv_catsv_mg, sv_chop, sv_cmp, SvCUR, SvCUR_set, sv_dec,
3029 sv_derived_from, SvEND, sv_eq, SvGETMAGIC, SvGROW, sv_grow, sv_inc,
3030 sv_insert, SvIOK, SvIOK_off, SvIOK_on, SvIOK_only, SvIOKp, sv_isa,
3031 sv_isobject, SvIV, SvIVX, SvLEN, sv_len, sv_magic, sv_mortalcopy,
3032 sv_newmortal, SvNIOK, SvNIOK_off, SvNIOKp, PL_sv_no, SvNOK, SvNOK_off,
3033 SvNOK_on, SvNOK_only, SvNOKp, SvNV, SvNVX, SvOK, SvOOK, SvPOK, SvPOK_off,
3034 SvPOK_on, SvPOK_only, SvPOKp, SvPV, SvPV_force, SvPV_nolen, SvPVX,
3035 SvREFCNT, SvREFCNT_dec, SvREFCNT_inc, SvROK, SvROK_off, SvROK_on, SvRV,
3036 SvSETMAGIC, sv_setiv, sv_setiv_mg, sv_setnv, sv_setnv_mg, sv_setpv,
3037 sv_setpv_mg, sv_setpviv, sv_setpviv_mg, sv_setpvn, sv_setpvn_mg, sv_setpvf,
3038 sv_setpvf_mg, sv_setref_iv, sv_setref_nv, sv_setref_pv, sv_setref_pvn,
3039 SvSetSV, SvSetSV_nosteal, sv_setsv, sv_setsv_mg, sv_setuv, sv_setuv_mg,
3040 SvSTASH, SvTAINT, SvTAINTED, SvTAINTED_off, SvTAINTED_on, SVt_IV, SVt_PV,
3041 SVt_PVAV, SVt_PVCV, SVt_PVHV, SVt_PVMG, SVt_NV, SvTRUE, SvTYPE, svtype,
3042 PL_sv_undef, sv_unref, SvUPGRADE, sv_upgrade, sv_usepvn, sv_usepvn_mg,
3043 sv_vcatpvfn(sv, pat, patlen, args, svargs, svmax, used_locale),
3044 sv_vsetpvfn(sv, pat, patlen, args, svargs, svmax, used_locale), SvUV,
3045 SvUVX, PL_sv_yes, THIS, toLOWER, toUPPER, warn, XPUSHi, XPUSHn, XPUSHp,
3046 XPUSHs, XPUSHu, XS, XSRETURN, XSRETURN_EMPTY, XSRETURN_IV, XSRETURN_NO,
3047 XSRETURN_NV, XSRETURN_PV, XSRETURN_UNDEF, XSRETURN_YES, XST_mIV, XST_mNV,
3048 XST_mNO, XST_mPV, XST_mUNDEF, XST_mYES, XS_VERSION, XS_VERSION_BOOTCHECK,
3049 Zero
3050
3051 =item AUTHORS
3052
3053 =head2 perlcall - Perl calling conventions from C
3054
3055 =item DESCRIPTION
3056
3057 An Error Handler, An Event Driven Program
3058
3059 =item THE PERL_CALL FUNCTIONS
3060
3061 perl_call_sv, perl_call_pv, perl_call_method, perl_call_argv
3062
3063 =item FLAG VALUES
3064
3065 =over
3066
3067 =item  G_VOID
3068
3069 =item  G_SCALAR
3070
3071 =item G_ARRAY
3072
3073 =item G_DISCARD
3074
3075 =item G_NOARGS
3076
3077 =item G_EVAL
3078
3079 =item G_KEEPERR
3080
3081 =item Determining the Context
3082
3083 =back
3084
3085 =item KNOWN PROBLEMS
3086
3087 =item EXAMPLES
3088
3089 =over
3090
3091 =item No Parameters, Nothing returned
3092
3093 =item Passing Parameters
3094
3095 =item Returning a Scalar
3096
3097 =item Returning a list of values
3098
3099 =item Returning a list in a scalar context
3100
3101 =item Returning Data from Perl via the parameter list
3102
3103 =item Using G_EVAL
3104
3105 =item Using G_KEEPERR
3106
3107 =item Using perl_call_sv
3108
3109 =item Using perl_call_argv
3110
3111 =item Using perl_call_method
3112
3113 =item Using GIMME_V
3114
3115 =item Using Perl to dispose of temporaries
3116
3117 =item Strategies for storing Callback Context Information
3118
3119 1. Ignore the problem - Allow only 1 callback, 2. Create a sequence of
3120 callbacks - hard wired limit, 3. Use a parameter to map to the Perl
3121 callback
3122
3123 =item Alternate Stack Manipulation
3124
3125 =item Creating and calling an anonymous subroutine in C
3126
3127 =back
3128
3129 =item SEE ALSO
3130
3131 =item AUTHOR
3132
3133 =item DATE
3134
3135 =head2 perlhist - the Perl history records
3136
3137 =item DESCRIPTION
3138
3139 =item INTRODUCTION
3140
3141 =item THE KEEPERS OF THE PUMPKIN
3142
3143 =over
3144
3145 =item PUMPKIN?
3146
3147 =back
3148
3149 =item THE RECORDS
3150
3151 =over
3152
3153 =item SELECTED RELEASE SIZES
3154
3155 =item SELECTED PATCH SIZES
3156
3157 =back
3158
3159 =item THE KEEPERS OF THE RECORDS
3160
3161 =head1 PRAGMA DOCUMENTATION
3162
3163 =head2 attrs - set/get attributes of a subroutine
3164
3165 =item SYNOPSIS
3166
3167 =item DESCRIPTION
3168
3169 method, locked
3170
3171 =head2 re - Perl pragma to alter regular expression behaviour
3172
3173 =item SYNOPSIS
3174
3175 =item DESCRIPTION
3176
3177 =head2 attrs - set/get attributes of a subroutine
3178
3179 =item SYNOPSIS
3180
3181 =item DESCRIPTION
3182
3183 method, locked
3184
3185 =head2 autouse - postpone load of modules until a function is used
3186
3187 =item SYNOPSIS
3188
3189 =item DESCRIPTION
3190
3191 =item WARNING
3192
3193 =item AUTHOR
3194
3195 =item SEE ALSO
3196
3197 =head2 base - Establish IS-A relationship with base class at compile time
3198
3199 =item SYNOPSIS
3200
3201 =item DESCRIPTION
3202
3203 =item HISTORY
3204
3205 =item SEE ALSO
3206
3207 =head2 blib - Use MakeMaker's uninstalled version of a package
3208
3209 =item SYNOPSIS
3210
3211 =item DESCRIPTION
3212
3213 =item BUGS
3214
3215 =item AUTHOR
3216
3217 =head2 constant - Perl pragma to declare constants
3218
3219 =item SYNOPSIS
3220
3221 =item DESCRIPTION
3222
3223 =item NOTES
3224
3225 =item TECHNICAL NOTE
3226
3227 =item BUGS
3228
3229 =item AUTHOR
3230
3231 =item COPYRIGHT
3232
3233 =head2 diagnostics - Perl compiler pragma to force verbose warning
3234 diagnostics
3235
3236 =item SYNOPSIS
3237
3238 =item DESCRIPTION
3239
3240 =over
3241
3242 =item The C<diagnostics> Pragma
3243
3244 =item The I<splain> Program
3245
3246 =back
3247
3248 =item EXAMPLES
3249
3250 =item INTERNALS
3251
3252 =item BUGS
3253
3254 =item AUTHOR
3255
3256 =head2 fields - compile-time class fields
3257
3258 =item SYNOPSIS
3259
3260 =item DESCRIPTION
3261
3262 =item SEE ALSO
3263
3264 =head2 filetest - Perl pragma to control the filetest permission operators
3265
3266 =item SYNOPSIS
3267
3268     $can_perhaps_read = -r "file";      # use the mode bits
3269     {
3270         use filetest 'access';          # intuit harder
3271         $can_really_read = -r "file";
3272     }
3273     $can_perhaps_read = -r "file";      # use the mode bits again
3274
3275 =item DESCRIPTION
3276
3277 =over
3278
3279 =item subpragma access
3280
3281 =back
3282
3283 =head2 integer - Perl pragma to compute arithmetic in integer instead of
3284 double
3285
3286 =item SYNOPSIS
3287
3288 =item DESCRIPTION
3289
3290 =head2 less - perl pragma to request less of something from the compiler
3291
3292 =item SYNOPSIS
3293
3294 =item DESCRIPTION
3295
3296 =head2 lib - manipulate @INC at compile time
3297
3298 =item SYNOPSIS
3299
3300 =item DESCRIPTION
3301
3302 =over
3303
3304 =item ADDING DIRECTORIES TO @INC
3305
3306 =item DELETING DIRECTORIES FROM @INC
3307
3308 =item RESTORING ORIGINAL @INC
3309
3310 =back
3311
3312 =item SEE ALSO
3313
3314 =item AUTHOR
3315
3316 =head2 locale - Perl pragma to use and avoid POSIX locales for built-in
3317 operations
3318
3319 =item SYNOPSIS
3320
3321 =item DESCRIPTION
3322
3323 =head2 ops - Perl pragma to restrict unsafe operations when compiling
3324
3325 =item SYNOPSIS
3326
3327 =item DESCRIPTION
3328
3329 =item SEE ALSO
3330
3331 =head2 overload - Package for overloading perl operations
3332
3333 =item SYNOPSIS
3334
3335 =item DESCRIPTION
3336
3337 =over
3338
3339 =item Declaration of overloaded functions
3340
3341 =item Calling Conventions for Binary Operations
3342
3343 FALSE, TRUE, C<undef>
3344
3345 =item Calling Conventions for Unary Operations
3346
3347 =item Calling Conventions for Mutators
3348
3349 C<++> and C<-->, C<x=> and other assignment versions
3350
3351 =item Overloadable Operations
3352
3353 I<Arithmetic operations>, I<Comparison operations>, I<Bit operations>,
3354 I<Increment and decrement>, I<Transcendental functions>, I<Boolean, string
3355 and numeric conversion>, I<Iteration>, I<Dereferencing>, I<Special>
3356
3357 =item Inheritance and overloading
3358
3359 Strings as values of C<use overload> directive, Overloading of an operation
3360 is inherited by derived classes
3361
3362 =back
3363
3364 =item SPECIAL SYMBOLS FOR C<use overload>
3365
3366 =over
3367
3368 =item Last Resort
3369
3370 =item Fallback
3371
3372 C<undef>, TRUE, defined, but FALSE
3373
3374 =item Copy Constructor
3375
3376 B<Example>
3377
3378 =back
3379
3380 =item MAGIC AUTOGENERATION
3381
3382 I<Assignment forms of arithmetic operations>, I<Conversion operations>,
3383 I<Increment and decrement>, C<abs($a)>, I<Unary minus>, I<Negation>,
3384 I<Concatenation>, I<Comparison operations>, I<Iterator>, I<Dereferencing>,
3385 I<Copy operator>
3386
3387 =item Losing overloading
3388
3389 =item Run-time Overloading
3390
3391 =item Public functions
3392
3393 overload::StrVal(arg), overload::Overloaded(arg), overload::Method(obj,op)
3394
3395 =item Overloading constants
3396
3397 integer, float, binary, q, qr
3398
3399 =item IMPLEMENTATION
3400
3401 =item Metaphor clash
3402
3403 =item Cookbook
3404
3405 =over
3406
3407 =item Two-face scalars
3408
3409 =item Two-face references
3410
3411 =item Symbolic calculator
3412
3413 =item I<Really> symbolic calculator
3414
3415 =back
3416
3417 =item AUTHOR
3418
3419 =item DIAGNOSTICS
3420
3421 =item BUGS
3422
3423 =head2 re - Perl pragma to alter regular expression behaviour
3424
3425 =item SYNOPSIS
3426
3427 =item DESCRIPTION
3428
3429 =head2 sigtrap - Perl pragma to enable simple signal handling
3430
3431 =item SYNOPSIS
3432
3433 =item DESCRIPTION
3434
3435 =item OPTIONS
3436
3437 =over
3438
3439 =item SIGNAL HANDLERS
3440
3441 B<stack-trace>, B<die>, B<handler> I<your-handler>
3442
3443 =item SIGNAL LISTS
3444
3445 B<normal-signals>, B<error-signals>, B<old-interface-signals>
3446
3447 =item OTHER
3448
3449 B<untrapped>, B<any>, I<signal>, I<number>
3450
3451 =back
3452
3453 =item EXAMPLES
3454
3455 =head2 strict - Perl pragma to restrict unsafe constructs
3456
3457 =item SYNOPSIS
3458
3459 =item DESCRIPTION
3460
3461 C<strict refs>, C<strict vars>, C<strict subs>
3462
3463 =head2 subs - Perl pragma to predeclare sub names
3464
3465 =item SYNOPSIS
3466
3467 =item DESCRIPTION
3468
3469 =head2 utf8 - Perl pragma to turn on UTF-8 and Unicode support
3470
3471 =item SYNOPSIS
3472
3473 =item DESCRIPTION
3474
3475 =item CAVEATS
3476
3477 =head2 vars - Perl pragma to predeclare global variable names
3478
3479 =item SYNOPSIS
3480
3481 =item DESCRIPTION
3482
3483 =head2 warning - Perl pragma to control optional warnings
3484
3485 =item SYNOPSIS
3486
3487 =item DESCRIPTION
3488
3489 C<warning deprecated>
3490
3491 =head1 MODULE DOCUMENTATION
3492
3493 =head2 AnyDBM_File - provide framework for multiple DBMs
3494
3495 =item SYNOPSIS
3496
3497 =item DESCRIPTION
3498
3499 =over
3500
3501 =item DBM Comparisons
3502
3503 [0], [1], [2], [3]
3504
3505 =back
3506
3507 =item SEE ALSO
3508
3509 =head2 AutoLoader - load subroutines only on demand
3510
3511 =item SYNOPSIS
3512
3513 =item DESCRIPTION
3514
3515 =over
3516
3517 =item Subroutine Stubs
3518
3519 =item Using B<AutoLoader>'s AUTOLOAD Subroutine
3520
3521 =item Overriding B<AutoLoader>'s AUTOLOAD Subroutine
3522
3523 =item Package Lexicals
3524
3525 =item B<AutoLoader> vs. B<SelfLoader>
3526
3527 =back
3528
3529 =item CAVEATS
3530
3531 =item SEE ALSO
3532
3533 =head2 AutoSplit - split a package for autoloading
3534
3535 =item SYNOPSIS
3536
3537 =item DESCRIPTION
3538
3539 $keep, $check, $modtime
3540
3541 =over
3542
3543 =item Multiple packages
3544
3545 =back
3546
3547 =item DIAGNOSTICS
3548
3549 =head2 B - The Perl Compiler
3550
3551 =item SYNOPSIS
3552
3553 =item DESCRIPTION
3554
3555 =item OVERVIEW OF CLASSES
3556
3557 =over
3558
3559 =item SV-RELATED CLASSES
3560
3561 =item B::SV METHODS
3562
3563 REFCNT, FLAGS
3564
3565 =item B::IV METHODS
3566
3567 IV, IVX, needs64bits, packiv
3568
3569 =item B::NV METHODS
3570
3571 NV, NVX
3572
3573 =item B::RV METHODS
3574
3575 RV
3576
3577 =item B::PV METHODS
3578
3579 PV
3580
3581 =item B::PVMG METHODS
3582
3583 MAGIC, SvSTASH
3584
3585 =item B::MAGIC METHODS
3586
3587 MOREMAGIC, PRIVATE, TYPE, FLAGS, OBJ, PTR
3588
3589 =item B::PVLV METHODS
3590
3591 TARGOFF, TARGLEN, TYPE, TARG
3592
3593 =item B::BM METHODS
3594
3595 USEFUL, PREVIOUS, RARE, TABLE
3596
3597 =item B::GV METHODS
3598
3599 NAME, STASH, SV, IO, FORM, AV, HV, EGV, CV, CVGEN, LINE, FILEGV, GvREFCNT,
3600 FLAGS
3601
3602 =item B::IO METHODS
3603
3604 LINES, PAGE, PAGE_LEN, LINES_LEFT, TOP_NAME, TOP_GV, FMT_NAME, FMT_GV,
3605 BOTTOM_NAME, BOTTOM_GV, SUBPROCESS, IoTYPE, IoFLAGS
3606
3607 =item B::AV METHODS
3608
3609 FILL, MAX, OFF, ARRAY, AvFLAGS
3610
3611 =item B::CV METHODS
3612
3613 STASH, START, ROOT, GV, FILEGV, DEPTH, PADLIST, OUTSIDE, XSUB, XSUBANY,
3614 CvFLAGS
3615
3616 =item B::HV METHODS
3617
3618 FILL, MAX, KEYS, RITER, NAME, PMROOT, ARRAY
3619
3620 =item OP-RELATED CLASSES
3621
3622 =item B::OP METHODS
3623
3624 next, sibling, ppaddr, desc, targ, type, seq, flags, private
3625
3626 =item B::UNOP METHOD
3627
3628 first
3629
3630 =item B::BINOP METHOD
3631
3632 last
3633
3634 =item B::LOGOP METHOD
3635
3636 other
3637
3638 =item B::CONDOP METHODS
3639
3640 true, false
3641
3642 =item B::LISTOP METHOD
3643
3644 children
3645
3646 =item B::PMOP METHODS
3647
3648 pmreplroot, pmreplstart, pmnext, pmregexp, pmflags, pmpermflags, precomp
3649
3650 =item B::SVOP METHOD
3651
3652 sv
3653
3654 =item B::GVOP METHOD
3655
3656 gv
3657
3658 =item B::PVOP METHOD
3659
3660 pv
3661
3662 =item B::LOOP METHODS
3663
3664 redoop, nextop, lastop
3665
3666 =item B::COP METHODS
3667
3668 label, stash, filegv, cop_seq, arybase, line
3669
3670 =back
3671
3672 =item FUNCTIONS EXPORTED BY C<B>
3673
3674 main_cv, init_av, main_root, main_start, comppadlist, sv_undef, sv_yes,
3675 sv_no, amagic_generation, walkoptree(OP, METHOD), walkoptree_debug(DEBUG),
3676 walksymtable(SYMREF, METHOD, RECURSE), svref_2object(SV), ppname(OPNUM),
3677 hash(STR), cast_I32(I), minus_c, cstring(STR), class(OBJ), threadsv_names,
3678 byteload_fh(FILEHANDLE)
3679
3680 =item AUTHOR
3681
3682 =head2 B::Asmdata - Autogenerated data about Perl ops, used to generate
3683 bytecode
3684
3685 =item SYNOPSIS
3686
3687 =item DESCRIPTION
3688
3689 =item AUTHOR
3690
3691 =head2 B::Assembler - Assemble Perl bytecode
3692
3693 =item SYNOPSIS
3694
3695 =item DESCRIPTION
3696
3697 =item AUTHOR
3698
3699 =head2 B::Bblock - Walk basic blocks
3700
3701 =item SYNOPSIS
3702
3703 =item DESCRIPTION
3704
3705 =item AUTHOR
3706
3707 =head2 B::Bytecode - Perl compiler's bytecode backend
3708
3709 =item SYNOPSIS
3710
3711 =item DESCRIPTION
3712
3713 =item OPTIONS
3714
3715 B<-ofilename>, B<-->, B<-f>, B<-fcompress-nullops>,
3716 B<-fomit-sequence-numbers>, B<-fbypass-nullops>, B<-fstrip-syntax-tree>,
3717 B<-On>, B<-D>, B<-Do>, B<-Db>, B<-Da>, B<-DC>, B<-S>, B<-m>
3718
3719 =item EXAMPLES
3720
3721 =item BUGS
3722
3723 =item AUTHOR
3724
3725 =head2 B::C - Perl compiler's C backend
3726
3727 =item SYNOPSIS
3728
3729 =item DESCRIPTION
3730
3731 =item OPTIONS
3732
3733 B<-ofilename>, B<-v>, B<-->, B<-uPackname>, B<-D>, B<-Do>, B<-Dc>, B<-DA>,
3734 B<-DC>, B<-DM>, B<-f>, B<-fcog>, B<-fno-cog>, B<-On>
3735
3736 =item EXAMPLES
3737
3738 =item BUGS
3739
3740 =item AUTHOR
3741
3742 =head2 B::CC - Perl compiler's optimized C translation backend
3743
3744 =item SYNOPSIS
3745
3746 =item DESCRIPTION
3747
3748 =item OPTIONS
3749
3750 B<-ofilename>, B<-v>, B<-->, B<-uPackname>, B<-mModulename>, B<-D>, B<-Dr>,
3751 B<-DO>, B<-Ds>, B<-Dp>, B<-Dq>, B<-Dl>, B<-Dt>, B<-f>,
3752 B<-ffreetmps-each-bblock>, B<-ffreetmps-each-loop>, B<-fomit-taint>, B<-On>
3753
3754 =item EXAMPLES
3755
3756 =item BUGS
3757
3758 =item DIFFERENCES
3759
3760 =over
3761
3762 =item Loops
3763
3764 =item Context of ".."
3765
3766 =item Arithmetic
3767
3768 =item Deprecated features
3769
3770 =back
3771
3772 =item AUTHOR
3773
3774 =head2 B::Debug - Walk Perl syntax tree, printing debug info about ops
3775
3776 =item SYNOPSIS
3777
3778 =item DESCRIPTION
3779
3780 =item AUTHOR
3781
3782 =head2 B::Deparse - Perl compiler backend to produce perl code
3783
3784 =item SYNOPSIS
3785
3786 =item DESCRIPTION
3787
3788 =item OPTIONS
3789
3790 B<-l>, B<-p>, B<-q>, B<-u>I<PACKAGE>, B<-s>I<LETTERS>, B<C>
3791
3792 =item BUGS
3793
3794 =item AUTHOR
3795
3796 =head2 B::Disassembler - Disassemble Perl bytecode
3797
3798 =item SYNOPSIS
3799
3800 =item DESCRIPTION
3801
3802 =item AUTHOR
3803
3804 =head2 B::Lint - Perl lint
3805
3806 =item SYNOPSIS
3807
3808 =item DESCRIPTION
3809
3810 =item OPTIONS AND LINT CHECKS
3811
3812 B<context>, B<implicit-read> and B<implicit-write>, B<dollar-underscore>,
3813 B<private-names>, B<undefined-subs>, B<regexp-variables>, B<all>, B<none>
3814
3815 =item NON LINT-CHECK OPTIONS
3816
3817 B<-u Package>
3818
3819 =item BUGS
3820
3821 =item AUTHOR
3822
3823 =head2 B::O, O - Generic interface to Perl Compiler backends
3824
3825 =item SYNOPSIS
3826
3827 =item DESCRIPTION
3828
3829 =item CONVENTIONS
3830
3831 =item IMPLEMENTATION
3832
3833 =item AUTHOR
3834
3835 =head2 B::Showlex - Show lexical variables used in functions or files
3836
3837 =item SYNOPSIS
3838
3839 =item DESCRIPTION
3840
3841 =item AUTHOR
3842
3843 =head2 B::Stackobj - Helper module for CC backend
3844
3845 =item SYNOPSIS
3846
3847 =item DESCRIPTION
3848
3849 =item AUTHOR
3850
3851 =head2 B::Terse - Walk Perl syntax tree, printing terse info about ops
3852
3853 =item SYNOPSIS
3854
3855 =item DESCRIPTION
3856
3857 =item AUTHOR
3858
3859 =head2 B::Xref - Generates cross reference reports for Perl programs
3860
3861 =item SYNOPSIS
3862
3863 =item DESCRIPTION
3864
3865 =item OPTIONS
3866
3867 C<-oFILENAME>, C<-r>, C<-D[tO]>
3868
3869 =item BUGS
3870
3871 =item AUTHOR
3872
3873 =head2 Bblock, B::Bblock - Walk basic blocks
3874
3875 =item SYNOPSIS
3876
3877 =item DESCRIPTION
3878
3879 =item AUTHOR
3880
3881 =head2 Benchmark - benchmark running times of code
3882
3883 =item SYNOPSIS
3884
3885 =item DESCRIPTION
3886
3887 =over
3888
3889 =item Methods
3890
3891 new, debug
3892
3893 =item Standard Exports
3894
3895 timeit(COUNT, CODE), timethis ( COUNT, CODE, [ TITLE, [ STYLE ]] ),
3896 timethese ( COUNT, CODEHASHREF, [ STYLE ] ), timediff ( T1, T2 ), timesum (
3897 T1, T2 ), timestr ( TIMEDIFF, [ STYLE, [ FORMAT ] ] )
3898
3899 =item Optional Exports
3900
3901 clearcache ( COUNT ), clearallcache ( ), disablecache ( ), enablecache ( )
3902
3903 =back
3904
3905 =item NOTES
3906
3907 =item INHERITANCE
3908
3909 =item CAVEATS
3910
3911 =item AUTHORS
3912
3913 =item MODIFICATION HISTORY
3914
3915 =head2 ByteLoader - load byte compiled perl code
3916
3917 =item SYNOPSIS
3918
3919 =item DESCRIPTION
3920
3921 =item AUTHOR
3922
3923 =item SEE ALSO
3924
3925 =head2 Bytecode, B::Bytecode - Perl compiler's bytecode backend
3926
3927 =item SYNOPSIS
3928
3929 =item DESCRIPTION
3930
3931 =item OPTIONS
3932
3933 B<-ofilename>, B<-->, B<-f>, B<-fcompress-nullops>,
3934 B<-fomit-sequence-numbers>, B<-fbypass-nullops>, B<-fstrip-syntax-tree>,
3935 B<-On>, B<-D>, B<-Do>, B<-Db>, B<-Da>, B<-DC>, B<-S>, B<-m>
3936
3937 =item EXAMPLES
3938
3939 =item BUGS
3940
3941 =item AUTHOR
3942
3943 =head2 CGI - Simple Common Gateway Interface Class
3944
3945 =item SYNOPSIS
3946
3947 =item ABSTRACT
3948
3949 =item DESCRIPTION
3950
3951 =over
3952
3953 =item PROGRAMMING STYLE
3954
3955 =item CALLING CGI.PM ROUTINES
3956
3957 1. Use another name for the argument, if one is available.  Forexample,
3958 -value is an alias for -values, 2. Change the capitalization, e.g. -Values,
3959 3. Put quotes around the argument name, e.g. '-values'
3960
3961 =item CREATING A NEW QUERY OBJECT (OBJECT-ORIENTED STYLE):
3962
3963 =item CREATING A NEW QUERY OBJECT FROM AN INPUT FILE
3964
3965 =item FETCHING A LIST OF KEYWORDS FROM THE QUERY:
3966
3967 =item FETCHING THE NAMES OF ALL THE PARAMETERS PASSED TO YOUR SCRIPT:
3968
3969 =item FETCHING THE VALUE OR VALUES OF A SINGLE NAMED PARAMETER:
3970
3971 =item SETTING THE VALUE(S) OF A NAMED PARAMETER:
3972
3973 =item APPENDING ADDITIONAL VALUES TO A NAMED PARAMETER:
3974
3975 =item IMPORTING ALL PARAMETERS INTO A NAMESPACE:
3976
3977 =item DELETING A PARAMETER COMPLETELY:
3978
3979 =item DELETING ALL PARAMETERS:
3980
3981 =item DIRECT ACCESS TO THE PARAMETER LIST:
3982
3983 =item SAVING THE STATE OF THE SCRIPT TO A FILE:
3984
3985 =item USING THE FUNCTION-ORIENTED INTERFACE
3986
3987 B<:cgi>, B<:form>, B<:html2>, B<:html3>, B<:netscape>, B<:html>,
3988 B<:standard>, B<:all>
3989
3990 =item PRAGMAS
3991
3992 -any, -compile, -nph, -newstyle_urls, -autoload, -no_debug,
3993 -private_tempfiles
3994
3995 =item SPECIAL FORMS FOR IMPORTING HTML-TAG FUNCTIONS
3996
3997 1. start_table() (generates a <TABLE> tag), 2. end_table() (generates a
3998 </TABLE> tag), 3. start_ul() (generates a <UL> tag), 4. end_ul() (generates
3999 a </UL> tag)
4000
4001 =back
4002
4003 =item GENERATING DYNAMIC DOCUMENTS
4004
4005 =over
4006
4007 =item CREATING A STANDARD HTTP HEADER:
4008
4009 =item GENERATING A REDIRECTION HEADER
4010
4011 =item CREATING THE HTML DOCUMENT HEADER
4012
4013 B<Parameters:>, 4, 5, 6..
4014
4015 =item ENDING THE HTML DOCUMENT:
4016
4017 =item CREATING A SELF-REFERENCING URL THAT PRESERVES STATE INFORMATION:
4018
4019 =item OBTAINING THE SCRIPT'S URL
4020
4021 B<-absolute>, B<-relative>, B<-full>, B<-path> (B<-path_info>), B<-query>
4022 (B<-query_string>)
4023
4024 =item MIXING POST AND URL PARAMETERS
4025
4026 =back
4027
4028 =item CREATING STANDARD HTML ELEMENTS:
4029
4030 =over
4031
4032 =item PROVIDING ARGUMENTS TO HTML SHORTCUTS
4033
4034 =item THE DISTRIBUTIVE PROPERTY OF HTML SHORTCUTS
4035
4036 =item HTML SHORTCUTS AND LIST INTERPOLATION
4037
4038 =item NON-STANDARD HTML SHORTCUTS
4039
4040 =item PRETTY-PRINTING HTML
4041
4042 =back
4043
4044 =item CREATING FILL-OUT FORMS:
4045
4046 =over
4047
4048 =item CREATING AN ISINDEX TAG
4049
4050 =item STARTING AND ENDING A FORM
4051
4052 B<application/x-www-form-urlencoded>, B<multipart/form-data>
4053
4054 =item CREATING A TEXT FIELD
4055
4056 B<Parameters>
4057
4058 =item CREATING A BIG TEXT FIELD
4059
4060 =item CREATING A PASSWORD FIELD
4061
4062 =item CREATING A FILE UPLOAD FIELD
4063
4064 B<Parameters>
4065
4066 =item CREATING A POPUP MENU
4067
4068 =item CREATING A SCROLLING LIST
4069
4070 B<Parameters:>
4071
4072 =item CREATING A GROUP OF RELATED CHECKBOXES
4073
4074 B<Parameters:>
4075
4076 =item CREATING A STANDALONE CHECKBOX
4077
4078 B<Parameters:>
4079
4080 =item CREATING A RADIO BUTTON GROUP
4081
4082 B<Parameters:>
4083
4084 =item CREATING A SUBMIT BUTTON
4085
4086 B<Parameters:>
4087
4088 =item CREATING A RESET BUTTON
4089
4090 =item CREATING A DEFAULT BUTTON
4091
4092 =item CREATING A HIDDEN FIELD
4093
4094 B<Parameters:>
4095
4096 =item CREATING A CLICKABLE IMAGE BUTTON
4097
4098 B<Parameters:>, 3.The third option (-align, optional) is an alignment type,
4099 and may be
4100 TOP, BOTTOM or MIDDLE
4101
4102 =item CREATING A JAVASCRIPT ACTION BUTTON
4103
4104 =back
4105
4106 =item HTTP COOKIES
4107
4108 1. an expiration time, 2. a domain, 3. a path, 4. a "secure" flag,
4109 B<-name>, B<-value>, B<-path>, B<-domain>, B<-expires>, B<-secure>
4110
4111 =item WORKING WITH FRAMES
4112
4113 1. Create a <Frameset> document, 2. Specify the destination for the
4114 document in the HTTP header, 3. Specify the destination for the document in
4115 the <FORM> tag
4116
4117 =item LIMITED SUPPORT FOR CASCADING STYLE SHEETS
4118
4119 =item DEBUGGING
4120
4121 =over
4122
4123 =item DUMPING OUT ALL THE NAME/VALUE PAIRS
4124
4125 =back
4126
4127 =item FETCHING ENVIRONMENT VARIABLES
4128
4129 B<Accept()>, B<raw_cookie()>, B<user_agent()>, B<path_info()>,
4130 B<path_translated()>, B<remote_host()>, B<script_name()>Return the script
4131 name as a partial URL, for self-refering
4132 scripts, B<referer()>, B<auth_type ()>, B<server_name ()>, B<virtual_host
4133 ()>, B<server_software ()>, B<remote_user ()>, B<user_name ()>,
4134 B<request_method()>
4135
4136 =item USING NPH SCRIPTS
4137
4138 In the B<use> statement, By calling the B<nph()> method:, By using B<-nph>
4139 parameters in the B<header()> and B<redirect()>  statements:
4140
4141 =item Server Push
4142
4143 multipart_init()
4144   multipart_init(-boundary=>$boundary);, multipart_start(), multipart_end()
4145
4146 =item Avoiding Denial of Service Attacks
4147
4148 B<$CGI::POST_MAX>, B<$CGI::DISABLE_UPLOADS>, B<1. On a script-by-script
4149 basis>, B<2. Globally for all scripts>
4150
4151 =item COMPATIBILITY WITH CGI-LIB.PL
4152
4153 =item AUTHOR INFORMATION
4154
4155 =item CREDITS
4156
4157 Matt Heffron (heffron@falstaff.css.beckman.com), James Taylor
4158 (james.taylor@srs.gov), Scott Anguish <sanguish@digifix.com>, Mike Jewell
4159 (mlj3u@virginia.edu), Timothy Shimmin (tes@kbs.citri.edu.au), Joergen Haegg
4160 (jh@axis.se), Laurent Delfosse (delfosse@delfosse.com), Richard Resnick
4161 (applepi1@aol.com), Craig Bishop (csb@barwonwater.vic.gov.au), Tony Curtis
4162 (tc@vcpc.univie.ac.at), Tim Bunce (Tim.Bunce@ig.co.uk), Tom Christiansen
4163 (tchrist@convex.com), Andreas Koenig (k@franz.ww.TU-Berlin.DE), Tim
4164 MacKenzie (Tim.MacKenzie@fulcrum.com.au), Kevin B. Hendricks
4165 (kbhend@dogwood.tyler.wm.edu), Stephen Dahmen (joyfire@inxpress.net), Ed
4166 Jordan (ed@fidalgo.net), David Alan Pisoni (david@cnation.com), Doug
4167 MacEachern (dougm@opengroup.org), Robin Houston (robin@oneworld.org),
4168 ...and many many more..
4169
4170 =item A COMPLETE EXAMPLE OF A SIMPLE FORM-BASED SCRIPT
4171
4172 =item BUGS
4173
4174 =item SEE ALSO
4175
4176 =head2 CGI::Apache - Make things work with CGI.pm against Perl-Apache API
4177
4178 =item SYNOPSIS
4179
4180 =item DESCRIPTION
4181
4182 =item NOTE 1
4183
4184 =item NOTE 2
4185
4186 =item SEE ALSO
4187
4188 =item AUTHOR
4189
4190 =head2 CGI::Carp, B<CGI::Carp> - CGI routines for writing to the HTTPD (or
4191 other) error log
4192
4193 =item SYNOPSIS
4194
4195 =item DESCRIPTION
4196
4197 =item REDIRECTING ERROR MESSAGES
4198
4199 =item MAKING PERL ERRORS APPEAR IN THE BROWSER WINDOW
4200
4201 =over
4202
4203 =item Changing the default message
4204
4205 =back
4206
4207 =item CHANGE LOG
4208
4209 =item AUTHORS
4210
4211 =item SEE ALSO
4212
4213 =head2 CGI::Cookie - Interface to Netscape Cookies
4214
4215 =item SYNOPSIS
4216
4217 =item DESCRIPTION
4218
4219 =item USING CGI::Cookie
4220
4221 B<1. expiration date>, B<2. domain>, B<3. path>, B<4. secure flag>
4222
4223 =over
4224
4225 =item Creating New Cookies
4226
4227 =item Sending the Cookie to the Browser
4228
4229 =item Recovering Previous Cookies
4230
4231 =item Manipulating Cookies
4232
4233 B<name()>, B<value()>, B<domain()>, B<path()>, B<expires()>
4234
4235 =back
4236
4237 =item AUTHOR INFORMATION
4238
4239 =item BUGS
4240
4241 =item SEE ALSO
4242
4243 =head2 CGI::Fast - CGI Interface for Fast CGI
4244
4245 =item SYNOPSIS
4246
4247 =item DESCRIPTION
4248
4249 =item OTHER PIECES OF THE PUZZLE
4250
4251 =item WRITING FASTCGI PERL SCRIPTS
4252
4253 =item INSTALLING FASTCGI SCRIPTS
4254
4255 =item USING FASTCGI SCRIPTS AS CGI SCRIPTS
4256
4257 =item CAVEATS
4258
4259 =item AUTHOR INFORMATION
4260
4261 =item BUGS
4262
4263 =item SEE ALSO
4264
4265 =head2 CGI::Push - Simple Interface to Server Push
4266
4267 =item SYNOPSIS
4268
4269 =item DESCRIPTION
4270
4271 =item USING CGI::Push
4272
4273 -next_page, -last_page, -type, -delay, -cookie, -target, -expires
4274
4275 =over
4276
4277 =item Heterogeneous Pages
4278
4279 =item Changing the Page Delay on the Fly
4280
4281 =back
4282
4283 =item INSTALLING CGI::Push SCRIPTS
4284
4285 =item AUTHOR INFORMATION
4286
4287 =item BUGS
4288
4289 =item SEE ALSO
4290
4291 =head2 CGI::Switch - Try more than one constructors and return the first
4292 object available
4293
4294 =item SYNOPSIS
4295
4296 =item DESCRIPTION
4297
4298 =item SEE ALSO
4299
4300 =item AUTHOR
4301
4302 =head2 CPAN - query, download and build perl modules from CPAN sites
4303
4304 =item SYNOPSIS
4305
4306 =item DESCRIPTION
4307
4308 =over
4309
4310 =item Interactive Mode
4311
4312 Searching for authors, bundles, distribution files and modules, make, test,
4313 install, clean  modules or distributions, readme, look module or
4314 distribution, Signals
4315
4316 =item CPAN::Shell
4317
4318 =item autobundle
4319
4320 =item recompile
4321
4322 =item The four C<CPAN::*> Classes: Author, Bundle, Module, Distribution
4323
4324 =item ProgrammerE<39>s interface
4325
4326 expand($type,@things), Programming Examples
4327
4328 =item Methods in the four Classes
4329
4330 =item Cache Manager
4331
4332 =item Bundles
4333
4334 =item Prerequisites
4335
4336 =item Finding packages and VERSION
4337
4338 =item Debugging
4339
4340 =item Floppy, Zip, Offline Mode
4341
4342 =back
4343
4344 =item CONFIGURATION
4345
4346 o conf E<lt>scalar optionE<gt>, o conf E<lt>scalar optionE<gt>
4347 E<lt>valueE<gt>, o conf E<lt>list optionE<gt>, o conf E<lt>list optionE<gt>
4348 [shift|pop], o conf E<lt>list optionE<gt> [unshift|push|splice]
4349 E<lt>listE<gt>
4350
4351 =over
4352
4353 =item Note on urllist parameter's format
4354
4355 =item urllist parameter has CD-ROM support
4356
4357 =back
4358
4359 =item SECURITY
4360
4361 =item EXPORT
4362
4363 =item POPULATE AN INSTALLATION WITH LOTS OF MODULES
4364
4365 =item WORKING WITH CPAN.pm BEHIND FIREWALLS
4366
4367 http firewall, ftp firewall, One way visibility, SOCKS, IP Masquerade
4368
4369 =item BUGS
4370
4371 =item AUTHOR
4372
4373 =item SEE ALSO
4374
4375 =head2 CPAN::FirstTime - Utility for CPAN::Config file Initialization
4376
4377 =item SYNOPSIS
4378
4379 =item DESCRIPTION
4380
4381 =head2 CPANox, CPAN::Nox - Wrapper around CPAN.pm without using any XS
4382 module
4383
4384 =item SYNOPSIS
4385
4386 =item DESCRIPTION
4387
4388 =item  SEE ALSO
4389
4390 =head2 Carp, carp    - warn of errors (from perspective of caller)
4391
4392 =item SYNOPSIS
4393
4394 =item DESCRIPTION
4395
4396 =over
4397
4398 =item Forcing a Stack Trace
4399
4400 =back
4401
4402 =item BUGS
4403
4404 =head2 Class::Struct - declare struct-like datatypes as Perl classes
4405
4406 =item SYNOPSIS
4407
4408 =item DESCRIPTION
4409
4410 =over
4411
4412 =item The C<struct()> function
4413
4414 =item Element Types and Accessor Methods
4415
4416 Scalar (C<'$'> or C<'*$'>), Array (C<'@'> or C<'*@'>), Hash (C<'%'> or
4417 C<'*%'>), Class (C<'Class_Name'> or C<'*Class_Name'>)
4418
4419 =back
4420
4421 =item EXAMPLES
4422
4423 Example 1, Example 2
4424
4425 =item Author and Modification History
4426
4427 =head2 Config - access Perl configuration information
4428
4429 =item SYNOPSIS
4430
4431 =item DESCRIPTION
4432
4433 myconfig(), config_sh(), config_vars(@names)
4434
4435 =item EXAMPLE
4436
4437 =item WARNING
4438
4439 =item GLOSSARY
4440
4441 =over
4442
4443 =item _
4444
4445 C<_a>, C<_exe>, C<_o>
4446
4447 =item a
4448
4449 C<afs>, C<alignbytes>, C<ansi2knr>, C<aphostname>, C<apiversion>, C<ar>,
4450 C<archlib>, C<archlibexp>, C<archname64>, C<archname>, C<archobjs>, C<awk>
4451
4452 =item b
4453
4454 C<baserev>, C<bash>, C<bin>, C<binexp>, C<bison>, C<byacc>, C<byteorder>
4455
4456 =item c
4457
4458 C<c>, C<castflags>, C<cat>, C<cc>, C<cccdlflags>, C<ccdlflags>, C<ccflags>,
4459 C<ccsymbols>, C<cf_by>, C<cf_email>, C<cf_time>, C<chgrp>, C<chmod>,
4460 C<chown>, C<clocktype>, C<comm>, C<compress>, C<contains>, C<cp>, C<cpio>,
4461 C<cpp>, C<cpp_stuff>, C<cppccsymbols>, C<cppflags>, C<cpplast>,
4462 C<cppminus>, C<cpprun>, C<cppstdin>, C<cppsymbols>, C<crosscompile>,
4463 C<cryptlib>, C<csh>
4464
4465 =item d
4466
4467 C<d_access>, C<d_accessx>, C<d_alarm>, C<d_archlib>, C<d_attribut>,
4468 C<d_bcmp>, C<d_bcopy>, C<d_bsd>, C<d_bsdgetpgrp>, C<d_bsdsetpgrp>,
4469 C<d_bzero>, C<d_casti32>, C<d_castneg>, C<d_charvspr>, C<d_chown>,
4470 C<d_chroot>, C<d_chsize>, C<d_closedir>, C<d_cmsghdr_s>, C<d_const>,
4471 C<d_crypt>, C<d_csh>, C<d_cuserid>, C<d_dbl_dig>, C<d_dbmclose64>,
4472 C<d_dbminit64>, C<d_delete64>, C<d_difftime>, C<d_dirent64_s>,
4473 C<d_dirnamlen>, C<d_dlerror>, C<d_dlopen>, C<d_dlsymun>, C<d_dosuid>,
4474 C<d_drand48proto>, C<d_dup2>, C<d_eaccess>, C<d_endgrent>, C<d_endhent>,
4475 C<d_endnent>, C<d_endpent>, C<d_endpwent>, C<d_endsent>, C<d_eofnblk>,
4476 C<d_eunice>, C<d_fchmod>, C<d_fchown>, C<d_fcntl>, C<d_fd_macros>,
4477 C<d_fd_set>, C<d_fds_bits>, C<d_fetch64>, C<d_fgetpos64>, C<d_fgetpos>,
4478 C<d_firstkey64>, C<d_flexfnam>, C<d_flock64_s>, C<d_flock>, C<d_fopen64>,
4479 C<d_fork>, C<d_fpathconf>, C<d_freopen64>, C<d_fseek64>, C<d_fseeko64>,
4480 C<d_fseeko>, C<d_fsetpos64>, C<d_fsetpos>, C<d_fstat64>, C<d_fstatfs>,
4481 C<d_fstatvfs>, C<d_ftell64>, C<d_ftello64>, C<d_ftello>, C<d_ftime>,
4482 C<d_ftruncate64>, C<d_Gconvert>, C<d_getgrent>, C<d_getgrps>,
4483 C<d_gethbyaddr>, C<d_gethbyname>, C<d_gethent>, C<d_gethname>,
4484 C<d_gethostprotos>, C<d_getlogin>, C<d_getmntent>, C<d_getnbyaddr>,
4485 C<d_getnbyname>, C<d_getnent>, C<d_getnetprotos>, C<d_getpbyname>,
4486 C<d_getpbynumber>, C<d_getpent>, C<d_getpgid>, C<d_getpgrp2>, C<d_getpgrp>,
4487 C<d_getppid>, C<d_getprior>, C<d_getprotoprotos>, C<d_getpwent>,
4488 C<d_getsbyname>, C<d_getsbyport>, C<d_getsent>, C<d_getservprotos>,
4489 C<d_gettimeod>, C<d_gnulibc>, C<d_grpasswd>, C<d_hasmntopt>, C<d_htonl>,
4490 C<d_index>, C<d_inetaton>, C<d_ino64_t>, C<d_int64t>, C<d_iovec_s>,
4491 C<d_isascii>, C<d_killpg>, C<d_lchown>, C<d_link>, C<d_llseek>,
4492 C<d_locconv>, C<d_lockf64>, C<d_lockf>, C<d_longdbl>, C<d_longlong>,
4493 C<d_lseek64>, C<d_lstat64>, C<d_lstat>, C<d_madvise>, C<d_mblen>,
4494 C<d_mbstowcs>, C<d_mbtowc>, C<d_memchr>, C<d_memcmp>, C<d_memcpy>,
4495 C<d_memmove>, C<d_memset>, C<d_mkdir>, C<d_mkfifo>, C<d_mktime>, C<d_mmap>,
4496 C<d_mprotect>, C<d_msg>, C<d_msg_ctrunc>, C<d_msg_dontroute>, C<d_msg_oob>,
4497 C<d_msg_peek>, C<d_msg_proxy>, C<d_msgctl>, C<d_msgget>, C<d_msghdr_s>,
4498 C<d_msgrcv>, C<d_msgsnd>, C<d_msync>, C<d_munmap>, C<d_mymalloc>,
4499 C<d_nextkey64>, C<d_nice>, C<d_off64_t>, C<d_offset_t>,
4500 C<d_old_pthread_create_joinable>, C<d_oldpthreads>, C<d_oldsock>,
4501 C<d_open3>, C<d_open64>, C<d_opendir64>, C<d_pathconf>, C<d_pause>,
4502 C<d_phostname>, C<d_pipe>, C<d_poll>, C<d_portable>, C<d_pthread_yield>,
4503 C<d_pwage>, C<d_pwchange>, C<d_pwclass>, C<d_pwcomment>, C<d_pwexpire>,
4504 C<d_pwgecos>, C<d_pwpasswd>, C<d_pwquota>, C<d_readdir64>, C<d_readdir>,
4505 C<d_readlink>, C<d_readv>, C<d_recvmsg>, C<d_rename>, C<d_rewinddir>,
4506 C<d_rmdir>, C<d_safebcpy>, C<d_safemcpy>, C<d_sanemcmp>, C<d_sched_yield>,
4507 C<d_scm_rights>, C<d_seekdir64>, C<d_seekdir>, C<d_select>, C<d_sem>,
4508 C<d_semctl>, C<d_semctl_semid_ds>, C<d_semctl_semun>, C<d_semget>,
4509 C<d_semop>, C<d_sendmsg>, C<d_setegid>, C<d_seteuid>, C<d_setgrent>,
4510 C<d_setgrps>, C<d_sethent>, C<d_setlinebuf>, C<d_setlocale>, C<d_setnent>,
4511 C<d_setpent>, C<d_setpgid>, C<d_setpgrp2>, C<d_setpgrp>, C<d_setprior>,
4512 C<d_setpwent>, C<d_setregid>, C<d_setresgid>, C<d_setresuid>,
4513 C<d_setreuid>, C<d_setrgid>, C<d_setruid>, C<d_setsent>, C<d_setsid>,
4514 C<d_setvbuf>, C<d_sfio>, C<d_shm>, C<d_shmat>, C<d_shmatprototype>,
4515 C<d_shmctl>, C<d_shmdt>, C<d_shmget>, C<d_sigaction>, C<d_sigsetjmp>,
4516 C<d_socket>, C<d_sockpair>, C<d_stat64>, C<d_statblks>, C<d_statfs>,
4517 C<d_statfsflags>, C<d_statvfs>, C<d_stdio_cnt_lval>, C<d_stdio_ptr_lval>,
4518 C<d_stdio_stream_array>, C<d_stdiobase>, C<d_stdstdio>, C<d_store64>,
4519 C<d_strchr>, C<d_strcoll>, C<d_strctcpy>, C<d_strerrm>, C<d_strerror>,
4520 C<d_strtod>, C<d_strtol>, C<d_strtoul>, C<d_strxfrm>, C<d_suidsafe>,
4521 C<d_symlink>, C<d_syscall>, C<d_sysconf>, C<d_sysernlst>, C<d_syserrlst>,
4522 C<d_system>, C<d_tcgetpgrp>, C<d_tcsetpgrp>, C<d_telldir64>, C<d_telldir>,
4523 C<d_telldirproto>, C<d_time>, C<d_times>, C<d_tmpfile64>, C<d_truncate64>,
4524 C<d_truncate>, C<d_tzname>, C<d_umask>, C<d_uname>, C<d_union_semun>,
4525 C<d_vfork>, C<d_void_closedir>, C<d_voidsig>, C<d_voidtty>, C<d_volatile>,
4526 C<d_vprintf>, C<d_wait4>, C<d_waitpid>, C<d_wcstombs>, C<d_wctomb>,
4527 C<d_writev>, C<d_xenix>, C<date>, C<db_hashtype>, C<db_prefixtype>,
4528 C<defvoidused>, C<direntrytype>, C<dlext>, C<dlsrc>, C<doublesize>,
4529 C<drand01>, C<dynamic_ext>
4530
4531 =item e
4532
4533 C<eagain>, C<ebcdic>, C<echo>, C<egrep>, C<emacs>, C<eunicefix>,
4534 C<exe_ext>, C<expr>, C<extensions>
4535
4536 =item f
4537
4538 C<fflushall>, C<fflushNULL>, C<find>, C<firstmakefile>, C<flex>,
4539 C<fpostype>, C<freetype>, C<full_ar>, C<full_csh>, C<full_sed>
4540
4541 =item g
4542
4543 C<gccversion>, C<gidtype>, C<glibpth>, C<grep>, C<groupcat>, C<groupstype>,
4544 C<gzip>
4545
4546 =item h
4547
4548 C<h_fcntl>, C<h_sysfile>, C<hint>, C<hostcat>, C<huge>
4549
4550 =item i
4551
4552 C<i_arpainet>, C<i_bsdioctl>, C<i_db>, C<i_dbm>, C<i_dirent>, C<i_dld>,
4553 C<i_dlfcn>, C<i_fcntl>, C<i_float>, C<i_gdbm>, C<i_grp>, C<i_inttypes>,
4554 C<i_limits>, C<i_locale>, C<i_machcthr>, C<i_malloc>, C<i_math>,
4555 C<i_memory>, C<i_mntent>, C<i_ndbm>, C<i_netdb>, C<i_neterrno>,
4556 C<i_netinettcp>, C<i_niin>, C<i_poll>, C<i_pthread>, C<i_pwd>,
4557 C<i_rpcsvcdbm>, C<i_sfio>, C<i_sgtty>, C<i_stdarg>, C<i_stddef>,
4558 C<i_stdlib>, C<i_string>, C<i_sysaccess>, C<i_sysdir>, C<i_sysfile>,
4559 C<i_sysfilio>, C<i_sysin>, C<i_sysioctl>, C<i_sysmman>, C<i_sysmount>,
4560 C<i_sysndir>, C<i_sysparam>, C<i_sysresrc>, C<i_syssecrt>, C<i_sysselct>,
4561 C<i_syssockio>, C<i_sysstat>, C<i_sysstatvfs>, C<i_systime>, C<i_systimek>,
4562 C<i_systimes>, C<i_systypes>, C<i_sysuio>, C<i_sysun>, C<i_syswait>,
4563 C<i_termio>, C<i_termios>, C<i_time>, C<i_unistd>, C<i_utime>, C<i_values>,
4564 C<i_varargs>, C<i_varhdr>, C<i_vfork>, C<ignore_versioned_solibs>,
4565 C<incpath>, C<inews>, C<installarchlib>, C<installbin>, C<installman1dir>,
4566 C<installman3dir>, C<installprivlib>, C<installscript>, C<installsitearch>,
4567 C<installsitelib>, C<installusrbinperl>, C<intsize>
4568
4569 =item k
4570
4571 C<known_extensions>, C<ksh>
4572
4573 =item l
4574
4575 C<large>, C<ld>, C<lddlflags>, C<ldflags>, C<less>, C<lib_ext>, C<libc>,
4576 C<libperl>, C<libpth>, C<libs>, C<libswanted>, C<line>, C<lint>,
4577 C<lkflags>, C<ln>, C<lns>, C<locincpth>, C<loclibpth>, C<longdblsize>,
4578 C<longlongsize>, C<longsize>, C<lp>, C<lpr>, C<ls>, C<lseeksize>,
4579 C<lseektype>
4580
4581 =item m
4582
4583 C<mail>, C<mailx>, C<make>, C<make_set_make>, C<mallocobj>, C<mallocsrc>,
4584 C<malloctype>, C<man1dir>, C<man1direxp>, C<man1ext>, C<man3dir>,
4585 C<man3direxp>, C<man3ext>
4586
4587 =item M
4588
4589 C<Mcc>, C<medium>, C<mips_type>, C<mkdir>, C<mmaptype>, C<models>,
4590 C<modetype>, C<more>, C<multiarch>, C<mv>, C<myarchname>, C<mydomain>,
4591 C<myhostname>, C<myuname>
4592
4593 =item n
4594
4595 C<n>, C<netdb_hlen_type>, C<netdb_host_type>, C<netdb_name_type>,
4596 C<netdb_net_type>, C<nm>, C<nm_opt>, C<nm_so_opt>, C<nonxs_ext>, C<nroff>
4597
4598 =item o
4599
4600 C<o_nonblock>, C<obj_ext>, C<old_pthread_create_joinable>, C<optimize>,
4601 C<orderlib>, C<osname>, C<osvers>
4602
4603 =item p
4604
4605 C<package>, C<pager>, C<passcat>, C<patchlevel>, C<path_sep>, C<perl>,
4606 C<perladmin>, C<perlpath>, C<pg>, C<phostname>, C<pidtype>, C<plibpth>,
4607 C<pmake>, C<pr>, C<prefix>, C<prefixexp>, C<privlib>, C<privlibexp>,
4608 C<prototype>, C<ptrsize>
4609
4610 =item r
4611
4612 C<randbits>, C<randfunc>, C<randseedtype>, C<ranlib>, C<rd_nodata>, C<rm>,
4613 C<rmail>, C<runnm>
4614
4615 =item s
4616
4617 C<sched_yield>, C<scriptdir>, C<scriptdirexp>, C<sed>, C<seedfunc>,
4618 C<selectminbits>, C<selecttype>, C<sendmail>, C<sh>, C<shar>, C<sharpbang>,
4619 C<shmattype>, C<shortsize>, C<shrpenv>, C<shsharp>, C<sig_count>,
4620 C<sig_name>, C<sig_name_init>, C<sig_num>, C<sig_num_init>, C<signal_t>,
4621 C<sitearch>, C<sitearchexp>, C<sitelib>, C<sitelibexp>, C<sizetype>,
4622 C<sleep>, C<smail>, C<small>, C<so>, C<sockethdr>, C<socketlib>, C<sort>,
4623 C<spackage>, C<spitshell>, C<split>, C<src>, C<ssizetype>, C<startperl>,
4624 C<startsh>, C<static_ext>, C<stdchar>, C<stdio_base>, C<stdio_bufsiz>,
4625 C<stdio_cnt>, C<stdio_filbuf>, C<stdio_ptr>, C<stdio_stream_array>,
4626 C<strings>, C<submit>, C<subversion>, C<sysman>
4627
4628 =item t
4629
4630 C<tail>, C<tar>, C<tbl>, C<tee>, C<test>, C<timeincl>, C<timetype>,
4631 C<touch>, C<tr>, C<trnl>, C<troff>
4632
4633 =item u
4634
4635 C<uidtype>, C<uname>, C<uniq>, C<use64bits>, C<usedl>, C<usemultiplicity>,
4636 C<usemymalloc>, C<usenm>, C<useopcode>, C<useperlio>, C<useposix>,
4637 C<usesfio>, C<useshrplib>, C<usethreads>, C<usevfork>, C<usrinc>, C<uuname>
4638
4639 =item v
4640
4641 C<version>, C<vi>, C<voidflags>
4642
4643 =item x
4644
4645 C<xlibpth>
4646
4647 =item z
4648
4649 C<zcat>, C<zip>
4650
4651 =back
4652
4653 =item NOTE
4654
4655 =head2 Cwd, getcwd - get pathname of current working directory
4656
4657 =item SYNOPSIS
4658
4659 =item DESCRIPTION
4660
4661 =head2 DB - programmatic interface to the Perl debugging API (draft,
4662 subject to
4663 change)
4664
4665 =item SYNOPSIS
4666
4667 =item DESCRIPTION
4668
4669 =over
4670
4671 =item Global Variables
4672
4673  $DB::sub,  %DB::sub,  $DB::single,  $DB::signal,  $DB::trace,  @DB::args,
4674 @DB::dbline,  %DB::dbline,  $DB::package,  $DB::filename,  $DB::subname,
4675 $DB::lineno
4676
4677 =item API Methods
4678
4679 CLIENT->register(), CLIENT->evalcode(STRING), CLIENT->skippkg('D::hide'),
4680 CLIENT->run(), CLIENT->step(), CLIENT->next(), CLIENT->done()
4681
4682 =item Client Callback Methods
4683
4684 CLIENT->init(), CLIENT->prestop([STRING]), CLIENT->stop(), CLIENT->idle(),
4685 CLIENT->poststop([STRING]), CLIENT->evalcode(STRING), CLIENT->cleanup(),
4686 CLIENT->output(LIST)
4687
4688 =back
4689
4690 =item BUGS
4691
4692 =item AUTHOR
4693
4694 =head2 DB_File - Perl5 access to Berkeley DB version 1.x
4695
4696 =item SYNOPSIS
4697
4698 =item DESCRIPTION
4699
4700 B<DB_HASH>, B<DB_BTREE>, B<DB_RECNO>
4701
4702 =over
4703
4704 =item Using DB_File with Berkeley DB version 2
4705
4706 =item Interface to Berkeley DB
4707
4708 =item Opening a Berkeley DB Database File
4709
4710 =item Default Parameters
4711
4712 =item In Memory Databases
4713
4714 =back
4715
4716 =item DB_HASH
4717
4718 =over
4719
4720 =item A Simple Example
4721
4722 =back
4723
4724 =item DB_BTREE
4725
4726 =over
4727
4728 =item Changing the BTREE sort order
4729
4730 =item Handling Duplicate Keys
4731
4732 =item The get_dup() Method
4733
4734 =item The find_dup() Method
4735
4736 =item The del_dup() Method
4737
4738 =item Matching Partial Keys
4739
4740 =back
4741
4742 =item DB_RECNO
4743
4744 =over
4745
4746 =item The 'bval' Option
4747
4748 =item A Simple Example
4749
4750 =item Extra RECNO Methods
4751
4752 B<$X-E<gt>push(list) ;>, B<$value = $X-E<gt>pop ;>, B<$X-E<gt>shift>,
4753 B<$X-E<gt>unshift(list) ;>, B<$X-E<gt>length>
4754
4755 =item Another Example
4756
4757 =back
4758
4759 =item THE API INTERFACE
4760
4761 B<$status = $X-E<gt>get($key, $value [, $flags]) ;>, B<$status =
4762 $X-E<gt>put($key, $value [, $flags]) ;>, B<$status = $X-E<gt>del($key [,
4763 $flags]) ;>, B<$status = $X-E<gt>fd ;>, B<$status = $X-E<gt>seq($key,
4764 $value, $flags) ;>, B<$status = $X-E<gt>sync([$flags]) ;>
4765
4766 =item HINTS AND TIPS
4767
4768 =over
4769
4770 =item Locking Databases
4771
4772 =item Sharing Databases With C Applications
4773
4774 =item The untie() Gotcha
4775
4776 =back
4777
4778 =item COMMON QUESTIONS
4779
4780 =over
4781
4782 =item Why is there Perl source in my database?
4783
4784 =item How do I store complex data structures with DB_File?
4785
4786 =item What does "Invalid Argument" mean?
4787
4788 =item What does "Bareword 'DB_File' not allowed" mean?
4789
4790 =back
4791
4792 =item HISTORY
4793
4794 =item BUGS
4795
4796 =item AVAILABILITY
4797
4798 =item COPYRIGHT
4799
4800 =item SEE ALSO
4801
4802 =item AUTHOR
4803
4804 =head2 Data::Dumper - stringified perl data structures, suitable for both
4805 printing and C<eval>
4806
4807 =item SYNOPSIS
4808
4809 =item DESCRIPTION
4810
4811 =over
4812
4813 =item Methods
4814
4815 I<PACKAGE>->new(I<ARRAYREF [>, I<ARRAYREF]>), I<$OBJ>->Dump  I<or>
4816 I<PACKAGE>->Dump(I<ARRAYREF [>, I<ARRAYREF]>), I<$OBJ>->Dumpxs  I<or>
4817 I<PACKAGE>->Dumpxs(I<ARRAYREF [>, I<ARRAYREF]>),
4818 I<$OBJ>->Seen(I<[HASHREF]>), I<$OBJ>->Values(I<[ARRAYREF]>),
4819 I<$OBJ>->Names(I<[ARRAYREF]>), I<$OBJ>->Reset
4820
4821 =item Functions
4822
4823 Dumper(I<LIST>), DumperX(I<LIST>)
4824
4825 =item Configuration Variables or Methods
4826
4827 $Data::Dumper::Indent  I<or>  I<$OBJ>->Indent(I<[NEWVAL]>),
4828 $Data::Dumper::Purity  I<or>  I<$OBJ>->Purity(I<[NEWVAL]>),
4829 $Data::Dumper::Pad  I<or>  I<$OBJ>->Pad(I<[NEWVAL]>),
4830 $Data::Dumper::Varname  I<or>  I<$OBJ>->Varname(I<[NEWVAL]>),
4831 $Data::Dumper::Useqq  I<or>  I<$OBJ>->Useqq(I<[NEWVAL]>),
4832 $Data::Dumper::Terse  I<or>  I<$OBJ>->Terse(I<[NEWVAL]>),
4833 $Data::Dumper::Freezer  I<or>  $I<OBJ>->Freezer(I<[NEWVAL]>),
4834 $Data::Dumper::Toaster  I<or>  $I<OBJ>->Toaster(I<[NEWVAL]>),
4835 $Data::Dumper::Deepcopy  I<or>  $I<OBJ>->Deepcopy(I<[NEWVAL]>),
4836 $Data::Dumper::Quotekeys  I<or>  $I<OBJ>->Quotekeys(I<[NEWVAL]>),
4837 $Data::Dumper::Bless  I<or>  $I<OBJ>->Bless(I<[NEWVAL]>)
4838
4839 =item Exports
4840
4841 Dumper
4842
4843 =back
4844
4845 =item EXAMPLES
4846
4847 =item BUGS
4848
4849 =item AUTHOR
4850
4851 =item VERSION
4852
4853 =item SEE ALSO
4854
4855 =head2 Devel::Peek - A data debugging tool for the XS programmer
4856
4857 =item SYNOPSIS
4858
4859 =item DESCRIPTION
4860
4861 =item EXAMPLES
4862
4863 =over
4864
4865 =item A simple scalar string
4866
4867 =item A simple scalar number
4868
4869 =item A simple scalar with an extra reference
4870
4871 =item A reference to a simple scalar
4872
4873 =item A reference to an array
4874
4875 =item A reference to a hash
4876
4877 =item Dumping a large array or hash
4878
4879 =item A reference to an SV which holds a C pointer
4880
4881 =item A reference to a subroutine
4882
4883 =back
4884
4885 =item EXPORTS
4886
4887 =item BUGS
4888
4889 =item AUTHOR
4890
4891 =item SEE ALSO
4892
4893 =head2 Devel::SelfStubber - generate stubs for a SelfLoading module
4894
4895 =item SYNOPSIS
4896
4897 =item DESCRIPTION
4898
4899 =head2 DirHandle - supply object methods for directory handles
4900
4901 =item SYNOPSIS
4902
4903 =item DESCRIPTION
4904
4905 =head2 Dumpvalue - provides screen dump of Perl data.
4906
4907 =item SYNOPSYS
4908
4909 =item DESCRIPTION
4910
4911 =over
4912
4913 =item Creation
4914
4915 C<arrayDepth>, C<hashDepth>, C<compactDump>, C<veryCompact>, C<globPrint>,
4916 C<DumpDBFiles>, C<DumpPackages>, C<DumpReused>, C<tick>, C<HighBit>,
4917 C<printUndef>, C<UsageOnly>, unctrl, subdump, bareStringify, quoteHighBit,
4918 stopDbSignal
4919
4920 =item Methods
4921
4922 dumpValue, dumpValues, dumpvars, set_quote, set_unctrl, compactDump,
4923 veryCompact, set, get
4924
4925 =back
4926
4927 =head2 DynaLoader - Dynamically load C libraries into Perl code
4928
4929 =item SYNOPSIS
4930
4931 =item DESCRIPTION
4932
4933 @dl_library_path, @dl_resolve_using, @dl_require_symbols, @dl_librefs,
4934 @dl_modules, dl_error(), $dl_debug, dl_findfile(), dl_expandspec(),
4935 dl_load_file(), dl_loadflags(), dl_find_symbol(),
4936 dl_find_symbol_anywhere(), dl_undef_symbols(), dl_install_xsub(),
4937 bootstrap()
4938
4939 =item AUTHOR
4940
4941 =head2 English - use nice English (or awk) names for ugly punctuation
4942 variables
4943
4944 =item SYNOPSIS
4945
4946 =item DESCRIPTION
4947
4948 =head2 Env - perl module that imports environment variables
4949
4950 =item SYNOPSIS
4951
4952 =item DESCRIPTION
4953
4954 =item AUTHOR
4955
4956 =head2 Errno - System errno constants
4957
4958 =item SYNOPSIS
4959
4960 =item DESCRIPTION
4961
4962 =item AUTHOR
4963
4964 =item COPYRIGHT
4965
4966 =head2 Exporter - Implements default import method for modules
4967
4968 =item SYNOPSIS
4969
4970 =item DESCRIPTION
4971
4972 =over
4973
4974 =item Selecting What To Export
4975
4976 =item Specialised Import Lists
4977
4978 =item Exporting without using Export's import method
4979
4980 =item Module Version Checking
4981
4982 =item Managing Unknown Symbols
4983
4984 =item Tag Handling Utility Functions
4985
4986 =back
4987
4988 =head2 ExtUtils::Command - utilities to replace common UNIX commands in
4989 Makefiles etc.
4990
4991 =item SYNOPSIS
4992
4993 =item DESCRIPTION
4994
4995 cat, eqtime src dst, rm_f files..., rm_f files..., touch files .., mv
4996 source... destination, cp source... destination, chmod mode files.., mkpath
4997 directory.., test_f file
4998
4999 =item BUGS
5000
5001 =item SEE ALSO
5002
5003 =item AUTHOR
5004
5005 =head2 ExtUtils::Embed - Utilities for embedding Perl in C/C++ applications
5006
5007 =item SYNOPSIS
5008
5009 =item DESCRIPTION
5010
5011 =item @EXPORT
5012
5013 =item FUNCTIONS
5014
5015 xsinit(), Examples, ldopts(), Examples, perl_inc(), ccflags(), ccdlflags(),
5016 ccopts(), xsi_header(), xsi_protos(@modules), xsi_body(@modules)
5017
5018 =item EXAMPLES
5019
5020 =item SEE ALSO
5021
5022 =item AUTHOR
5023
5024 =head2 ExtUtils::Install - install files from here to there
5025
5026 =item SYNOPSIS
5027
5028 =item DESCRIPTION
5029
5030 =head2 ExtUtils::Installed - Inventory management of installed modules
5031
5032 =item SYNOPSIS
5033
5034 =item DESCRIPTION
5035
5036 =item USAGE
5037
5038 =item FUNCTIONS
5039
5040 new(), modules(), files(), directories(), directory_tree(), validate(),
5041 packlist(), version()
5042
5043 =item EXAMPLE
5044
5045 =item AUTHOR
5046
5047 =head2 ExtUtils::Liblist - determine libraries to use and how to use them
5048
5049 =item SYNOPSIS
5050
5051 =item DESCRIPTION
5052
5053 For static extensions, For dynamic extensions, For dynamic extensions
5054
5055 =over
5056
5057 =item EXTRALIBS
5058
5059 =item LDLOADLIBS and LD_RUN_PATH
5060
5061 =item BSLOADLIBS
5062
5063 =back
5064
5065 =item PORTABILITY
5066
5067 =over
5068
5069 =item VMS implementation
5070
5071 =item Win32 implementation
5072
5073 =back
5074
5075 =item SEE ALSO
5076
5077 =head2 ExtUtils::MM_Cygwin - methods to override UN*X behaviour in
5078 ExtUtils::MakeMaker
5079
5080 =item SYNOPSIS
5081
5082 =item DESCRIPTION
5083
5084 canonpath, cflags, manifypods, perl_archive
5085
5086 =head2 ExtUtils::MM_OS2 - methods to override UN*X behaviour in
5087 ExtUtils::MakeMaker
5088
5089 =item SYNOPSIS
5090
5091 =item DESCRIPTION
5092
5093 =head2 ExtUtils::MM_Unix - methods used by ExtUtils::MakeMaker
5094
5095 =item SYNOPSIS
5096
5097 =item DESCRIPTION
5098
5099 =item METHODS
5100
5101 =over
5102
5103 =item Preloaded methods
5104
5105 canonpath, catdir, catfile, curdir, rootdir, updir
5106
5107 =item SelfLoaded methods
5108
5109 c_o (o), cflags (o), clean (o), const_cccmd (o), const_config (o),
5110 const_loadlibs (o), constants (o), depend (o), dir_target (o), dist (o),
5111 dist_basics (o), dist_ci (o), dist_core (o), dist_dir (o), dist_test (o),
5112 dlsyms (o), dynamic (o), dynamic_bs (o), dynamic_lib (o), exescan,
5113 extliblist, file_name_is_absolute, find_perl
5114
5115 =item Methods to actually produce chunks of text for the Makefile
5116
5117 fixin, force (o), guess_name, has_link_code, init_dirscan, init_main,
5118 init_others, install (o), installbin (o), libscan (o), linkext (o), lsdir,
5119 macro (o), makeaperl (o), makefile (o), manifypods (o), maybe_command,
5120 maybe_command_in_dirs, needs_linking (o), nicetext, parse_version,
5121 parse_abstract, pasthru (o), path, perl_script, perldepend (o), ppd,
5122 perm_rw (o), perm_rwx (o), pm_to_blib, post_constants (o), post_initialize
5123 (o), postamble (o), prefixify, processPL (o), realclean (o),
5124 replace_manpage_separator, static (o), static_lib (o), staticmake (o),
5125 subdir_x (o), subdirs (o), test (o), test_via_harness (o), test_via_script
5126 (o), tool_autosplit (o), tools_other (o), tool_xsubpp (o), top_targets (o),
5127 writedoc, xs_c (o), xs_cpp (o), xs_o (o), perl_archive, export_list
5128
5129 =back
5130
5131 =item SEE ALSO
5132
5133 =head2 ExtUtils::MM_VMS - methods to override UN*X behaviour in
5134 ExtUtils::MakeMaker
5135
5136 =item SYNOPSIS
5137
5138 =item DESCRIPTION
5139
5140 =over
5141
5142 =item Methods always loaded
5143
5144 eliminate_macros, fixpath, catdir, catfile, wraplist, curdir (override),
5145 rootdir (override), updir (override)
5146
5147 =item SelfLoaded methods
5148
5149 guess_name (override), find_perl (override), path (override), maybe_command
5150 (override), maybe_command_in_dirs (override), perl_script (override),
5151 file_name_is_absolute (override), replace_manpage_separator, init_others
5152 (override), constants (override), cflags (override), const_cccmd
5153 (override), pm_to_blib (override), tool_autosplit (override), tool_sxubpp
5154 (override), xsubpp_version (override), tools_other (override), dist
5155 (override), c_o (override), xs_c (override), xs_o (override), top_targets
5156 (override), dlsyms (override), dynamic_lib (override), dynamic_bs
5157 (override), static_lib (override), manifypods (override), processPL
5158 (override), installbin (override), subdir_x (override), clean (override),
5159 realclean (override), dist_basics (override), dist_core (override),
5160 dist_dir (override), dist_test (override), install (override), perldepend
5161 (override), makefile (override), test (override), test_via_harness
5162 (override), test_via_script (override), makeaperl (override), nicetext
5163 (override)
5164
5165 =back
5166
5167 =head2 ExtUtils::MM_Win32 - methods to override UN*X behaviour in
5168 ExtUtils::MakeMaker
5169
5170 =item SYNOPSIS
5171
5172 =item DESCRIPTION
5173
5174 catfile, constants (o), static_lib (o), dynamic_bs (o), dynamic_lib (o),
5175 canonpath, perl_script, pm_to_blib, test_via_harness (o), tool_autosplit
5176 (override), tools_other (o), xs_o (o), top_targets (o), manifypods (o),
5177 dist_ci (o), dist_core (o), pasthru (o)
5178
5179 =head2 ExtUtils::MakeMaker - create an extension Makefile
5180
5181 =item SYNOPSIS
5182
5183 =item DESCRIPTION
5184
5185 =over
5186
5187 =item How To Write A Makefile.PL
5188
5189 =item Default Makefile Behaviour
5190
5191 =item make test
5192
5193 =item make testdb
5194
5195 =item make install
5196
5197 =item PREFIX and LIB attribute
5198
5199 =item AFS users
5200
5201 =item Static Linking of a new Perl Binary
5202
5203 =item Determination of Perl Library and Installation Locations
5204
5205 =item Which architecture dependent directory?
5206
5207 =item Using Attributes and Parameters
5208
5209 AUTHOR, ABSTRACT, ABSTRACT_FROM, BINARY_LOCATION, C, CAPI, CCFLAGS, CONFIG,
5210 CONFIGURE, DEFINE, DIR, DISTNAME, DL_FUNCS, DL_VARS, EXCLUDE_EXT,
5211 EXE_FILES, FIRST_MAKEFILE, FULLPERL, FUNCLIST, H, IMPORTS, INC,
5212 INCLUDE_EXT, INSTALLARCHLIB, INSTALLBIN, INSTALLDIRS, INSTALLMAN1DIR,
5213 INSTALLMAN3DIR, INSTALLPRIVLIB, INSTALLSCRIPT, INSTALLSITEARCH,
5214 INSTALLSITELIB, INST_ARCHLIB, INST_BIN, INST_EXE, INST_LIB, INST_MAN1DIR,
5215 INST_MAN3DIR, INST_SCRIPT, LDFROM, LIB, LIBPERL_A, LIBS, LINKTYPE,
5216 MAKEAPERL, MAKEFILE, MAN1PODS, MAN3PODS, MAP_TARGET, MYEXTLIB, NAME,
5217 NEEDS_LINKING, NOECHO, NORECURS, NO_VC, OBJECT, OPTIMIZE, PERL, PERLMAINCC,
5218 PERL_ARCHLIB, PERL_LIB, PERL_SRC, PERM_RW, PERM_RWX, PL_FILES, PM,
5219 PMLIBDIRS, POLLUTE, PPM_INSTALL_EXEC, PPM_INSTALL_SCRIPT, PREFIX,
5220 PREREQ_PM, SKIP, TYPEMAPS, VERSION, VERSION_FROM, XS, XSOPT, XSPROTOARG,
5221 XS_VERSION
5222
5223 =item Additional lowercase attributes
5224
5225 clean, depend, dist, dynamic_lib, linkext, macro, realclean, test,
5226 tool_autosplit
5227
5228 =item Overriding MakeMaker Methods
5229
5230 =item Hintsfile support
5231
5232 =item Distribution Support
5233
5234    make distcheck,    make skipcheck,    make distclean,    make manifest,
5235   make distdir,    make tardist,    make dist,    make uutardist,    make
5236 shdist,    make zipdist,    make ci
5237
5238 =item Disabling an extension
5239
5240 =back
5241
5242 =item ENVIRONMENT
5243
5244 PERL_MM_OPT
5245
5246 =item SEE ALSO
5247
5248 =item AUTHORS
5249
5250 =head2 ExtUtils::Manifest - utilities to write and check a MANIFEST file
5251
5252 =item SYNOPSIS
5253
5254 =item DESCRIPTION
5255
5256 =item MANIFEST.SKIP
5257
5258 =item EXPORT_OK
5259
5260 =item GLOBAL VARIABLES
5261
5262 =item DIAGNOSTICS
5263
5264 C<Not in MANIFEST:> I<file>, C<No such file:> I<file>, C<MANIFEST:> I<$!>,
5265 C<Added to MANIFEST:> I<file>
5266
5267 =item SEE ALSO
5268
5269 =item AUTHOR
5270
5271 =head2 ExtUtils::Miniperl, writemain - write the C code for perlmain.c
5272
5273 =item SYNOPSIS
5274
5275 =item DESCRIPTION
5276
5277 =item SEE ALSO
5278
5279 =head2 ExtUtils::Mkbootstrap - make a bootstrap file for use by DynaLoader
5280
5281 =item SYNOPSIS
5282
5283 =item DESCRIPTION
5284
5285 =head2 ExtUtils::Mksymlists - write linker options files for dynamic
5286 extension
5287
5288 =item SYNOPSIS
5289
5290 =item DESCRIPTION
5291
5292 DLBASE, DL_FUNCS, DL_VARS, FILE, FUNCLIST, IMPORTS, NAME
5293
5294 =item AUTHOR
5295
5296 =item REVISION
5297
5298 =head2 ExtUtils::Packlist - manage .packlist files
5299
5300 =item SYNOPSIS
5301
5302 =item DESCRIPTION
5303
5304 =item USAGE
5305
5306 =item FUNCTIONS
5307
5308 new(), read(), write(), validate(), packlist_file()
5309
5310 =item EXAMPLE
5311
5312 =item AUTHOR
5313
5314 =head2 ExtUtils::testlib - add blib/* directories to @INC
5315
5316 =item SYNOPSIS
5317
5318 =item DESCRIPTION
5319
5320 =head2 Fatal - replace functions with equivalents which succeed or die
5321
5322 =item SYNOPSIS
5323
5324 =item DESCRIPTION
5325
5326 =item AUTHOR
5327
5328 =head2 Fcntl - load the C Fcntl.h defines
5329
5330 =item SYNOPSIS
5331
5332 =item DESCRIPTION
5333
5334 =item NOTE
5335
5336 =item EXPORTED SYMBOLS
5337
5338 =head2 File::Basename, fileparse - split a pathname into pieces
5339
5340 =item SYNOPSIS
5341
5342 =item DESCRIPTION
5343
5344 fileparse_set_fstype, fileparse
5345
5346 =item EXAMPLES
5347
5348 C<basename>, C<dirname>
5349
5350 =head2 File::CheckTree, validate - run many filetest checks on a tree
5351
5352 =item SYNOPSIS
5353
5354 =item DESCRIPTION
5355
5356 =head2 File::Compare - Compare files or filehandles
5357
5358 =item SYNOPSIS
5359
5360 =item DESCRIPTION
5361
5362 =item RETURN
5363
5364 =item AUTHOR
5365
5366 =head2 File::Copy - Copy files or filehandles
5367
5368 =item SYNOPSIS
5369
5370 =item DESCRIPTION
5371
5372 =over
5373
5374 =item Special behaviour if C<syscopy> is defined (OS/2, VMS and Win32)
5375
5376 rmscopy($from,$to[,$date_flag])
5377
5378 =back
5379
5380 =item RETURN
5381
5382 =item AUTHOR
5383
5384 =head2 File::DosGlob - DOS like globbing and then some
5385
5386 =item SYNOPSIS
5387
5388 =item DESCRIPTION
5389
5390 =item EXPORTS (by request only)
5391
5392 =item BUGS
5393
5394 =item AUTHOR
5395
5396 =item HISTORY
5397
5398 =item SEE ALSO
5399
5400 =head2 File::Find, find - traverse a file tree
5401
5402 =item SYNOPSIS
5403
5404 =item DESCRIPTION
5405
5406 =item BUGS
5407
5408 =head2 File::Path - create or remove a series of directories
5409
5410 =item SYNOPSIS
5411
5412 =item DESCRIPTION
5413
5414 =item AUTHORS
5415
5416 =head2 File::Spec - portably perform operations on file names
5417
5418 =item SYNOPSIS
5419
5420 =item DESCRIPTION
5421
5422 =item SEE ALSO
5423
5424 =item AUTHORS
5425
5426 =head2 File::Spec::Functions - portably perform operations on file names
5427
5428 =item SYNOPSIS
5429
5430 =item DESCRIPTION
5431
5432 =over
5433
5434 =item Exports
5435
5436 =back
5437
5438 =item SEE ALSO
5439
5440 =head2 File::Spec::Mac - File::Spec for MacOS
5441
5442 =item SYNOPSIS
5443
5444 =item DESCRIPTION
5445
5446 =item METHODS
5447
5448 canonpath, catdir, catfile, curdir, devnull, rootdir, tmpdir, updir,
5449 file_name_is_absolute, path
5450
5451 =item SEE ALSO
5452
5453 =head2 File::Spec::OS2 - methods for OS/2 file specs
5454
5455 =item SYNOPSIS
5456
5457 =item DESCRIPTION
5458
5459 =head2 File::Spec::Unix - methods used by File::Spec
5460
5461 =item SYNOPSIS
5462
5463 =item DESCRIPTION
5464
5465 =item METHODS
5466
5467 canonpath, catdir, catfile, curdir, devnull, rootdir, tmpdir, updir,
5468 no_upwards, file_name_is_absolute, path, join, splitpath, splitdir,
5469 catpath, abs2rel, rel2abs
5470
5471 =item SEE ALSO
5472
5473 =head2 File::Spec::VMS - methods for VMS file specs
5474
5475 =item SYNOPSIS
5476
5477 =item DESCRIPTION
5478
5479 =over
5480
5481 =item Methods always loaded
5482
5483 catdir, catfile, curdir (override), devnull (override), rootdir (override),
5484 tmpdir (override), updir (override), path (override), file_name_is_absolute
5485 (override)
5486
5487 =back
5488
5489 =item SEE ALSO
5490
5491 =head2 File::Spec::Win32 - methods for Win32 file specs
5492
5493 =item SYNOPSIS
5494
5495 =item DESCRIPTION
5496
5497 devnull, tmpdir, catfile, canonpath, splitpath, splitdir, catpath, abs2rel,
5498 rel2abs
5499
5500 =item SEE ALSO
5501
5502 =head2 File::stat - by-name interface to Perl's built-in stat() functions
5503
5504 =item SYNOPSIS
5505
5506 =item DESCRIPTION
5507
5508 =item NOTE
5509
5510 =item AUTHOR
5511
5512 =head2 FileCache - keep more files open than the system permits
5513
5514 =item SYNOPSIS
5515
5516 =item DESCRIPTION
5517
5518 =item BUGS
5519
5520 =head2 FileHandle - supply object methods for filehandles
5521
5522 =item SYNOPSIS
5523
5524 =item DESCRIPTION
5525
5526 $fh->print, $fh->printf, $fh->getline, $fh->getlines
5527
5528 =item SEE ALSO
5529
5530 =head2 FindBin - Locate directory of original perl script
5531
5532 =item SYNOPSIS
5533
5534 =item DESCRIPTION
5535
5536 =item EXPORTABLE VARIABLES
5537
5538 =item KNOWN BUGS
5539
5540 =item AUTHORS
5541
5542 =item COPYRIGHT
5543
5544 =head2 GDBM_File - Perl5 access to the gdbm library.
5545
5546 =item SYNOPSIS
5547
5548 =item DESCRIPTION
5549
5550 =item AVAILABILITY
5551
5552 =item BUGS
5553
5554 =item SEE ALSO
5555
5556 =head2 Getopt::Long, GetOptions - extended processing of command line
5557 options
5558
5559 =item SYNOPSIS
5560
5561 =item DESCRIPTION
5562
5563 !, +, :s, :i, :f
5564
5565 =over
5566
5567 =item Linkage specification
5568
5569 =item Aliases and abbreviations
5570
5571 =item Non-option call-back routine
5572
5573 =item Option starters
5574
5575 =item Return values and Errors
5576
5577 =back
5578
5579 =item COMPATIBILITY
5580
5581 =item EXAMPLES
5582
5583 =item CONFIGURATION OPTIONS
5584
5585 default, auto_abbrev, getopt_compat, require_order, permute, bundling
5586 (default: reset), bundling_override (default: reset), ignore_case
5587 (default: set), ignore_case_always (default: reset), pass_through (default:
5588 reset), prefix, prefix_pattern, debug (default: reset)
5589
5590 =item OTHER USEFUL VARIABLES
5591
5592 $Getopt::Long::VERSION, $Getopt::Long::error
5593
5594 =item AUTHOR
5595
5596 =item COPYRIGHT AND DISCLAIMER
5597
5598 =head2 Getopt::Std, getopt - Process single-character switches with switch
5599 clustering
5600
5601 =item SYNOPSIS
5602
5603 =item DESCRIPTION
5604
5605 =head2 I18N::Collate - compare 8-bit scalar data according to the current
5606 locale
5607
5608 =item SYNOPSIS
5609
5610 =item DESCRIPTION
5611
5612 =head2 IO - load various IO modules
5613
5614 =item SYNOPSIS
5615
5616 =item DESCRIPTION
5617
5618 =head2 IO::Dir - supply object methods for directory handles
5619
5620 =item SYNOPSIS
5621
5622 =item DESCRIPTION
5623
5624 new ( [ DIRNAME ] ), open ( DIRNAME ), read (), seek ( POS ), tell (),
5625 rewind (), close (), tie %hash, IO::Dir, DIRNAME [, OPTIONS ]
5626
5627 =item SEE ALSO
5628
5629 =item AUTHOR
5630
5631 =item COPYRIGHT
5632
5633 =head2 IO::File - supply object methods for filehandles
5634
5635 =item SYNOPSIS
5636
5637 =item DESCRIPTION
5638
5639 =item CONSTRUCTOR
5640
5641 new ( FILENAME [,MODE [,PERMS]] ), new_tmpfile
5642
5643 =item METHODS
5644
5645 open( FILENAME [,MODE [,PERMS]] )
5646
5647 =item SEE ALSO
5648
5649 =item HISTORY
5650
5651 =head2 IO::Handle - supply object methods for I/O handles
5652
5653 =item SYNOPSIS
5654
5655 =item DESCRIPTION
5656
5657 =item CONSTRUCTOR
5658
5659 new (), new_from_fd ( FD, MODE )
5660
5661 =item METHODS
5662
5663 $io->fdopen ( FD, MODE ), $io->opened, $io->getline, $io->getlines,
5664 $io->ungetc ( ORD ), $io->write ( BUF, LEN [, OFFSET ] ), $io->error,
5665 $io->clearerr, $io->sync, $io->flush, $io->printflush ( ARGS ),
5666 $io->blocking ( [ BOOL ] ), $io->untaint
5667
5668 =item NOTE
5669
5670 =item SEE ALSO
5671
5672 =item BUGS
5673
5674 =item HISTORY
5675
5676 =head2 IO::Pipe - supply object methods for pipes
5677
5678 =item SYNOPSIS
5679
5680 =item DESCRIPTION
5681
5682 =item CONSTRUCTOR
5683
5684 new ( [READER, WRITER] )
5685
5686 =item METHODS
5687
5688 reader ([ARGS]), writer ([ARGS]), handles ()
5689
5690 =item SEE ALSO
5691
5692 =item AUTHOR
5693
5694 =item COPYRIGHT
5695
5696 =head2 IO::Poll - Object interface to system poll call
5697
5698 =item SYNOPSIS
5699
5700 =item DESCRIPTION
5701
5702 =item METHODS
5703
5704 mask ( IO [, EVENT_MASK ] ), poll ( [ TIMEOUT ] ), events ( IO ), remove (
5705 IO ), handles( [ EVENT_MASK ] )
5706
5707 =item SEE ALSO
5708
5709 =item AUTHOR
5710
5711 =item COPYRIGHT
5712
5713 =head2 IO::Seekable - supply seek based methods for I/O objects
5714
5715 =item SYNOPSIS
5716
5717 =item DESCRIPTION
5718
5719 =item SEE ALSO
5720
5721 =item HISTORY
5722
5723 =head2 IO::Select - OO interface to the select system call
5724
5725 =item SYNOPSIS
5726
5727 =item DESCRIPTION
5728
5729 =item CONSTRUCTOR
5730
5731 new ( [ HANDLES ] )
5732
5733 =item METHODS
5734
5735 add ( HANDLES ), remove ( HANDLES ), exists ( HANDLE ), handles, can_read (
5736 [ TIMEOUT ] ), can_write ( [ TIMEOUT ] ), has_exception ( [ TIMEOUT ] ),
5737 count (), bits(), select ( READ, WRITE, ERROR [, TIMEOUT ] )
5738
5739 =item EXAMPLE
5740
5741 =item AUTHOR
5742
5743 =item COPYRIGHT
5744
5745 =head2 IO::Socket - Object interface to socket communications
5746
5747 =item SYNOPSIS
5748
5749 =item DESCRIPTION
5750
5751 =item CONSTRUCTOR
5752
5753 new ( [ARGS] )
5754
5755 =item METHODS
5756
5757 accept([PKG]), timeout([VAL]), sockopt(OPT [, VAL]), sockdomain, socktype,
5758 protocol, connected
5759
5760 =item SEE ALSO
5761
5762 =item AUTHOR
5763
5764 =item COPYRIGHT
5765
5766 =head2 IO::Socket::INET - Object interface for AF_INET domain sockets
5767
5768 =item SYNOPSIS
5769
5770 =item DESCRIPTION
5771
5772 =item CONSTRUCTOR
5773
5774 new ( [ARGS] )
5775
5776 =over
5777
5778 =item METHODS
5779
5780 sockaddr (), sockport (), sockhost (), peeraddr (), peerport (), peerhost
5781 ()
5782
5783 =back
5784
5785 =item SEE ALSO
5786
5787 =item AUTHOR
5788
5789 =item COPYRIGHT
5790
5791 =head2 IO::Socket::UNIX - Object interface for AF_UNIX domain sockets
5792
5793 =item SYNOPSIS
5794
5795 =item DESCRIPTION
5796
5797 =item CONSTRUCTOR
5798
5799 new ( [ARGS] )
5800
5801 =item METHODS
5802
5803 hostpath(), peerpath()
5804
5805 =item SEE ALSO
5806
5807 =item AUTHOR
5808
5809 =item COPYRIGHT
5810
5811 =head2 IO::lib::IO::Dir, IO::Dir - supply object methods for directory
5812 handles
5813
5814 =item SYNOPSIS
5815
5816 =item DESCRIPTION
5817
5818 new ( [ DIRNAME ] ), open ( DIRNAME ), read (), seek ( POS ), tell (),
5819 rewind (), close (), tie %hash, IO::Dir, DIRNAME [, OPTIONS ]
5820
5821 =item SEE ALSO
5822
5823 =item AUTHOR
5824
5825 =item COPYRIGHT
5826
5827 =head2 IO::lib::IO::File, IO::File - supply object methods for filehandles
5828
5829 =item SYNOPSIS
5830
5831 =item DESCRIPTION
5832
5833 =item CONSTRUCTOR
5834
5835 new ( FILENAME [,MODE [,PERMS]] ), new_tmpfile
5836
5837 =item METHODS
5838
5839 open( FILENAME [,MODE [,PERMS]] )
5840
5841 =item SEE ALSO
5842
5843 =item HISTORY
5844
5845 =head2 IO::lib::IO::Handle, IO::Handle - supply object methods for I/O
5846 handles
5847
5848 =item SYNOPSIS
5849
5850 =item DESCRIPTION
5851
5852 =item CONSTRUCTOR
5853
5854 new (), new_from_fd ( FD, MODE )
5855
5856 =item METHODS
5857
5858 $io->fdopen ( FD, MODE ), $io->opened, $io->getline, $io->getlines,
5859 $io->ungetc ( ORD ), $io->write ( BUF, LEN [, OFFSET ] ), $io->error,
5860 $io->clearerr, $io->sync, $io->flush, $io->printflush ( ARGS ),
5861 $io->blocking ( [ BOOL ] ), $io->untaint
5862
5863 =item NOTE
5864
5865 =item SEE ALSO
5866
5867 =item BUGS
5868
5869 =item HISTORY
5870
5871 =head2 IO::lib::IO::Pipe, IO::Pipe - supply object methods for pipes
5872
5873 =item SYNOPSIS
5874
5875 =item DESCRIPTION
5876
5877 =item CONSTRUCTOR
5878
5879 new ( [READER, WRITER] )
5880
5881 =item METHODS
5882
5883 reader ([ARGS]), writer ([ARGS]), handles ()
5884
5885 =item SEE ALSO
5886
5887 =item AUTHOR
5888
5889 =item COPYRIGHT
5890
5891 =head2 IO::lib::IO::Poll, IO::Poll - Object interface to system poll call
5892
5893 =item SYNOPSIS
5894
5895 =item DESCRIPTION
5896
5897 =item METHODS
5898
5899 mask ( IO [, EVENT_MASK ] ), poll ( [ TIMEOUT ] ), events ( IO ), remove (
5900 IO ), handles( [ EVENT_MASK ] )
5901
5902 =item SEE ALSO
5903
5904 =item AUTHOR
5905
5906 =item COPYRIGHT
5907
5908 =head2 IO::lib::IO::Seekable, IO::Seekable - supply seek based methods for
5909 I/O objects
5910
5911 =item SYNOPSIS
5912
5913 =item DESCRIPTION
5914
5915 =item SEE ALSO
5916
5917 =item HISTORY
5918
5919 =head2 IO::lib::IO::Select, IO::Select - OO interface to the select system
5920 call
5921
5922 =item SYNOPSIS
5923
5924 =item DESCRIPTION
5925
5926 =item CONSTRUCTOR
5927
5928 new ( [ HANDLES ] )
5929
5930 =item METHODS
5931
5932 add ( HANDLES ), remove ( HANDLES ), exists ( HANDLE ), handles, can_read (
5933 [ TIMEOUT ] ), can_write ( [ TIMEOUT ] ), has_exception ( [ TIMEOUT ] ),
5934 count (), bits(), select ( READ, WRITE, ERROR [, TIMEOUT ] )
5935
5936 =item EXAMPLE
5937
5938 =item AUTHOR
5939
5940 =item COPYRIGHT
5941
5942 =head2 IO::lib::IO::Socket, IO::Socket - Object interface to socket
5943 communications
5944
5945 =item SYNOPSIS
5946
5947 =item DESCRIPTION
5948
5949 =item CONSTRUCTOR
5950
5951 new ( [ARGS] )
5952
5953 =item METHODS
5954
5955 accept([PKG]), timeout([VAL]), sockopt(OPT [, VAL]), sockdomain, socktype,
5956 protocol, connected
5957
5958 =item SEE ALSO
5959
5960 =item AUTHOR
5961
5962 =item COPYRIGHT
5963
5964 =head2 IO::lib::IO::Socket::INET, IO::Socket::INET - Object interface for
5965 AF_INET domain sockets
5966
5967 =item SYNOPSIS
5968
5969 =item DESCRIPTION
5970
5971 =item CONSTRUCTOR
5972
5973 new ( [ARGS] )
5974
5975 =over
5976
5977 =item METHODS
5978
5979 sockaddr (), sockport (), sockhost (), peeraddr (), peerport (), peerhost
5980 ()
5981
5982 =back
5983
5984 =item SEE ALSO
5985
5986 =item AUTHOR
5987
5988 =item COPYRIGHT
5989
5990 =head2 IO::lib::IO::Socket::UNIX, IO::Socket::UNIX - Object interface for
5991 AF_UNIX domain sockets
5992
5993 =item SYNOPSIS
5994
5995 =item DESCRIPTION
5996
5997 =item CONSTRUCTOR
5998
5999 new ( [ARGS] )
6000
6001 =item METHODS
6002
6003 hostpath(), peerpath()
6004
6005 =item SEE ALSO
6006
6007 =item AUTHOR
6008
6009 =item COPYRIGHT
6010
6011 =head2 IPC::Msg - SysV Msg IPC object class
6012
6013 =item SYNOPSIS
6014
6015 =item DESCRIPTION
6016
6017 =item METHODS
6018
6019 new ( KEY , FLAGS ), id, rcv ( BUF, LEN [, TYPE [, FLAGS ]] ), remove, set
6020 ( STAT ), set ( NAME => VALUE [, NAME => VALUE ...] ), snd ( TYPE, MSG [,
6021 FLAGS ] ), stat
6022
6023 =item SEE ALSO
6024
6025 =item AUTHOR
6026
6027 =item COPYRIGHT
6028
6029 =head2 IPC::Open2, open2 - open a process for both reading and writing
6030
6031 =item SYNOPSIS
6032
6033 =item DESCRIPTION
6034
6035 =item WARNING
6036
6037 =item SEE ALSO
6038
6039 =head2 IPC::Open3, open3 - open a process for reading, writing, and error
6040 handling
6041
6042 =item SYNOPSIS
6043
6044 =item DESCRIPTION
6045
6046 =item WARNING
6047
6048 =head2 IPC::Semaphore - SysV Semaphore IPC object class
6049
6050 =item SYNOPSIS
6051
6052 =item DESCRIPTION
6053
6054 =item METHODS
6055
6056 new ( KEY , NSEMS , FLAGS ), getall, getncnt ( SEM ), getpid ( SEM ),
6057 getval ( SEM ), getzcnt ( SEM ), id, op ( OPLIST ), remove, set ( STAT ),
6058 set ( NAME => VALUE [, NAME => VALUE ...] ), setall ( VALUES ), setval ( N
6059 , VALUE ), stat
6060
6061 =item SEE ALSO
6062
6063 =item AUTHOR
6064
6065 =item COPYRIGHT
6066
6067 =head2 IPC::SysV - SysV IPC constants
6068
6069 =item SYNOPSIS
6070
6071 =item DESCRIPTION
6072
6073 ftok( PATH, ID )
6074
6075 =item SEE ALSO
6076
6077 =item AUTHORS
6078
6079 =item COPYRIGHT
6080
6081 =head2 IPC::SysV::Msg, IPC::Msg - SysV Msg IPC object class
6082
6083 =item SYNOPSIS
6084
6085 =item DESCRIPTION
6086
6087 =item METHODS
6088
6089 new ( KEY , FLAGS ), id, rcv ( BUF, LEN [, TYPE [, FLAGS ]] ), remove, set
6090 ( STAT ), set ( NAME => VALUE [, NAME => VALUE ...] ), snd ( TYPE, MSG [,
6091 FLAGS ] ), stat
6092
6093 =item SEE ALSO
6094
6095 =item AUTHOR
6096
6097 =item COPYRIGHT
6098
6099 =head2 IPC::SysV::Semaphore, IPC::Semaphore - SysV Semaphore IPC object
6100 class
6101
6102 =item SYNOPSIS
6103
6104 =item DESCRIPTION
6105
6106 =item METHODS
6107
6108 new ( KEY , NSEMS , FLAGS ), getall, getncnt ( SEM ), getpid ( SEM ),
6109 getval ( SEM ), getzcnt ( SEM ), id, op ( OPLIST ), remove, set ( STAT ),
6110 set ( NAME => VALUE [, NAME => VALUE ...] ), setall ( VALUES ), setval ( N
6111 , VALUE ), stat
6112
6113 =item SEE ALSO
6114
6115 =item AUTHOR
6116
6117 =item COPYRIGHT
6118
6119 =head2 Math::BigFloat - Arbitrary length float math package
6120
6121 =item SYNOPSIS
6122
6123 =item DESCRIPTION
6124
6125 number format, Error returns 'NaN', Division is computed to, Rounding is
6126 performed
6127
6128 =item BUGS
6129
6130 =item AUTHOR
6131
6132 =head2 Math::BigInt - Arbitrary size integer math package
6133
6134 =item SYNOPSIS
6135
6136 =item DESCRIPTION
6137
6138 Canonical notation, Input, Output
6139
6140 =item EXAMPLES
6141
6142 =item Autocreating constants
6143
6144 =item BUGS
6145
6146 =item AUTHOR
6147
6148 =head2 Math::Complex - complex numbers and associated mathematical
6149 functions
6150
6151 =item SYNOPSIS
6152
6153 =item DESCRIPTION
6154
6155 =item OPERATIONS
6156
6157 =item CREATION
6158
6159 =item STRINGIFICATION
6160
6161 =item USAGE
6162
6163 =item ERRORS DUE TO DIVISION BY ZERO OR LOGARITHM OF ZERO
6164
6165 =item ERRORS DUE TO INDIGESTIBLE ARGUMENTS
6166
6167 =item BUGS
6168
6169 =item AUTHORS
6170
6171 =head2 Math::Trig - trigonometric functions
6172
6173 =item SYNOPSIS
6174
6175 =item DESCRIPTION
6176
6177 =item TRIGONOMETRIC FUNCTIONS
6178
6179 B<tan>
6180
6181 =over
6182
6183 =item ERRORS DUE TO DIVISION BY ZERO
6184
6185 =item SIMPLE (REAL) ARGUMENTS, COMPLEX RESULTS
6186
6187 =back
6188
6189 =item PLANE ANGLE CONVERSIONS
6190
6191 =item RADIAL COORDINATE CONVERSIONS
6192
6193 =over
6194
6195 =item COORDINATE SYSTEMS
6196
6197 =item 3-D ANGLE CONVERSIONS
6198
6199 cartesian_to_cylindrical, cartesian_to_spherical, cylindrical_to_cartesian,
6200 cylindrical_to_spherical, spherical_to_cartesian, spherical_to_cylindrical
6201
6202 =back
6203
6204 =item GREAT CIRCLE DISTANCES
6205
6206 =item EXAMPLES
6207
6208 =item BUGS
6209
6210 =item AUTHORS
6211
6212 =head2 NDBM_File - Tied access to ndbm files
6213
6214 =item SYNOPSIS
6215
6216 =item DESCRIPTION
6217
6218 =head2 Net::Ping - check a remote host for reachability
6219
6220 =item SYNOPSIS
6221
6222 =item DESCRIPTION
6223
6224 =over
6225
6226 =item Functions
6227
6228 Net::Ping->new([$proto [, $def_timeout [, $bytes]]]);, $p->ping($host [,
6229 $timeout]);, $p->close();, pingecho($host [, $timeout]);
6230
6231 =back
6232
6233 =item WARNING
6234
6235 =item NOTES
6236
6237 =head2 Net::hostent - by-name interface to Perl's built-in gethost*()
6238 functions
6239
6240 =item SYNOPSIS
6241
6242 =item DESCRIPTION
6243
6244 =item EXAMPLES
6245
6246 =item NOTE
6247
6248 =item AUTHOR
6249
6250 =head2 Net::netent - by-name interface to Perl's built-in getnet*()
6251 functions
6252
6253 =item SYNOPSIS
6254
6255 =item DESCRIPTION
6256
6257 =item EXAMPLES
6258
6259 =item NOTE
6260
6261 =item AUTHOR
6262
6263 =head2 Net::protoent - by-name interface to Perl's built-in getproto*()
6264 functions
6265
6266 =item SYNOPSIS
6267
6268 =item DESCRIPTION
6269
6270 =item NOTE
6271
6272 =item AUTHOR
6273
6274 =head2 Net::servent - by-name interface to Perl's built-in getserv*()
6275 functions
6276
6277 =item SYNOPSIS
6278
6279 =item DESCRIPTION
6280
6281 =item EXAMPLES
6282
6283 =item NOTE
6284
6285 =item AUTHOR
6286
6287 =head2 O - Generic interface to Perl Compiler backends
6288
6289 =item SYNOPSIS
6290
6291 =item DESCRIPTION
6292
6293 =item CONVENTIONS
6294
6295 =item IMPLEMENTATION
6296
6297 =item AUTHOR
6298
6299 =head2 ODBM_File - Tied access to odbm files
6300
6301 =item SYNOPSIS
6302
6303 =item DESCRIPTION
6304
6305 =head2 Opcode - Disable named opcodes when compiling perl code
6306
6307 =item SYNOPSIS
6308
6309 =item DESCRIPTION
6310
6311 =item NOTE
6312
6313 =item WARNING
6314
6315 =item Operator Names and Operator Lists
6316
6317 an operator name (opname), an operator tag name (optag), a negated opname
6318 or optag, an operator set (opset)
6319
6320 =item Opcode Functions
6321
6322 opcodes, opset (OP, ...), opset_to_ops (OPSET), opset_to_hex (OPSET),
6323 full_opset, empty_opset, invert_opset (OPSET), verify_opset (OPSET, ...),
6324 define_optag (OPTAG, OPSET), opmask_add (OPSET), opmask, opdesc (OP, ...),
6325 opdump (PAT)
6326
6327 =item Manipulating Opsets
6328
6329 =item TO DO (maybe)
6330
6331 =item Predefined Opcode Tags
6332
6333 :base_core, :base_mem, :base_loop, :base_io, :base_orig, :base_math,
6334 :base_thread, :default, :filesys_read, :sys_db, :browse, :filesys_open,
6335 :filesys_write, :subprocess, :ownprocess, :others, :still_to_be_decided,
6336 :dangerous
6337
6338 =item SEE ALSO
6339
6340 =item AUTHORS
6341
6342 =head2 Opcode::Safe, Safe - Compile and execute code in restricted
6343 compartments
6344
6345 =item SYNOPSIS
6346
6347 =item DESCRIPTION
6348
6349 a new namespace, an operator mask
6350
6351 =item WARNING
6352
6353 =over
6354
6355 =item RECENT CHANGES
6356
6357 =item Methods in class Safe
6358
6359 permit (OP, ...), permit_only (OP, ...), deny (OP, ...), deny_only (OP,
6360 ...), trap (OP, ...), untrap (OP, ...), share (NAME, ...), share_from
6361 (PACKAGE, ARRAYREF), varglob (VARNAME), reval (STRING), rdo (FILENAME),
6362 root (NAMESPACE), mask (MASK)
6363
6364 =item Some Safety Issues
6365
6366 Memory, CPU, Snooping, Signals, State Changes
6367
6368 =item AUTHOR
6369
6370 =back
6371
6372 =head2 Opcode::ops, ops - Perl pragma to restrict unsafe operations when
6373 compiling
6374
6375 =item SYNOPSIS
6376
6377 =item DESCRIPTION
6378
6379 =item SEE ALSO
6380
6381 =head2 POSIX - Perl interface to IEEE Std 1003.1
6382
6383 =item SYNOPSIS
6384
6385 =item DESCRIPTION
6386
6387 =item NOTE
6388
6389 =item CAVEATS
6390
6391 =item FUNCTIONS
6392
6393 _exit, abort, abs, access, acos, alarm, asctime, asin, assert, atan, atan2,
6394 atexit, atof, atoi, atol, bsearch, calloc, ceil, chdir, chmod, chown,
6395 clearerr, clock, close, closedir, cos, cosh, creat, ctermid, ctime,
6396 cuserid, difftime, div, dup, dup2, errno, execl, execle, execlp, execv,
6397 execve, execvp, exit, exp, fabs, fclose, fcntl, fdopen, feof, ferror,
6398 fflush, fgetc, fgetpos, fgets, fileno, floor, fmod, fopen, fork, fpathconf,
6399 fprintf, fputc, fputs, fread, free, freopen, frexp, fscanf, fseek, fsetpos,
6400 fstat, ftell, fwrite, getc, getchar, getcwd, getegid, getenv, geteuid,
6401 getgid, getgrgid, getgrnam, getgroups, getlogin, getpgrp, getpid, getppid,
6402 getpwnam, getpwuid, gets, getuid, gmtime, isalnum, isalpha, isatty,
6403 iscntrl, isdigit, isgraph, islower, isprint, ispunct, isspace, isupper,
6404 isxdigit, kill, labs, ldexp, ldiv, link, localeconv, localtime, log, log10,
6405 longjmp, lseek, malloc, mblen, mbstowcs, mbtowc, memchr, memcmp, memcpy,
6406 memmove, memset, mkdir, mkfifo, mktime, modf, nice, offsetof, open,
6407 opendir, pathconf, pause, perror, pipe, pow, printf, putc, putchar, puts,
6408 qsort, raise, rand, read, readdir, realloc, remove, rename, rewind,
6409 rewinddir, rmdir, scanf, setgid, setjmp, setlocale, setpgid, setsid,
6410 setuid, sigaction, siglongjmp, sigpending, sigprocmask, sigsetjmp,
6411 sigsuspend, sin, sinh, sleep, sprintf, sqrt, srand, sscanf, stat, strcat,
6412 strchr, strcmp, strcoll, strcpy, strcspn, strerror, strftime, strlen,
6413 strncat, strncmp, strncpy, stroul, strpbrk, strrchr, strspn, strstr,
6414 strtod, strtok, strtol, strtoul, strxfrm, sysconf, system, tan, tanh,
6415 tcdrain, tcflow, tcflush, tcgetpgrp, tcsendbreak, tcsetpgrp, time, times,
6416 tmpfile, tmpnam, tolower, toupper, ttyname, tzname, tzset, umask, uname,
6417 ungetc, unlink, utime, vfprintf, vprintf, vsprintf, wait, waitpid,
6418 wcstombs, wctomb, write
6419
6420 =item CLASSES
6421
6422 =over
6423
6424 =item POSIX::SigAction
6425
6426 new
6427
6428 =item POSIX::SigSet
6429
6430 new, addset, delset, emptyset, fillset, ismember
6431
6432 =item POSIX::Termios
6433
6434 new, getattr, getcc, getcflag, getiflag, getispeed, getlflag, getoflag,
6435 getospeed, setattr, setcc, setcflag, setiflag, setispeed, setlflag,
6436 setoflag, setospeed, Baud rate values, Terminal interface values, c_cc
6437 field values, c_cflag field values, c_iflag field values, c_lflag field
6438 values, c_oflag field values
6439
6440 =back
6441
6442 =item PATHNAME CONSTANTS
6443
6444 Constants
6445
6446 =item POSIX CONSTANTS
6447
6448 Constants
6449
6450 =item SYSTEM CONFIGURATION
6451
6452 Constants
6453
6454 =item ERRNO
6455
6456 Constants
6457
6458 =item FCNTL
6459
6460 Constants
6461
6462 =item FLOAT
6463
6464 Constants
6465
6466 =item LIMITS
6467
6468 Constants
6469
6470 =item LOCALE
6471
6472 Constants
6473
6474 =item MATH
6475
6476 Constants
6477
6478 =item SIGNAL
6479
6480 Constants
6481
6482 =item STAT
6483
6484 Constants, Macros
6485
6486 =item STDLIB
6487
6488 Constants
6489
6490 =item STDIO
6491
6492 Constants
6493
6494 =item TIME
6495
6496 Constants
6497
6498 =item UNISTD
6499
6500 Constants
6501
6502 =item WAIT
6503
6504 Constants, Macros
6505
6506 =item CREATION
6507
6508 =head2 Pod::Checker, podchecker() - check pod documents for syntax errors
6509
6510 =item SYNOPSIS
6511
6512 =item OPTIONS/ARGUMENTS
6513
6514 =item DESCRIPTION
6515
6516 =item EXAMPLES
6517
6518 =item AUTHOR
6519
6520 =head2 Pod::Html - module to convert pod files to HTML
6521
6522 =item SYNOPSIS
6523
6524 =item DESCRIPTION
6525
6526 =item ARGUMENTS
6527
6528 help, htmldir, htmlroot, infile, outfile, podroot, podpath, libpods,
6529 netscape, nonetscape, index, noindex, recurse, norecurse, title, verbose
6530
6531 =item EXAMPLE
6532
6533 =item AUTHOR
6534
6535 =item BUGS
6536
6537 =item SEE ALSO
6538
6539 =item COPYRIGHT
6540
6541 =head2 Pod::InputObjects - objects representing POD input paragraphs,
6542 commands, etc.
6543
6544 =item SYNOPSIS
6545
6546 =item REQUIRES
6547
6548 =item EXPORTS
6549
6550 =item DESCRIPTION
6551
6552 B<Pod::InputSource>, B<Pod::Paragraph>, B<Pod::InteriorSequence>,
6553 B<Pod::ParseTree>
6554
6555 =item B<Pod::InputSource>
6556
6557 =over
6558
6559 =item B<new()>
6560
6561 =item B<name()>
6562
6563 =item B<handle()>
6564
6565 =item B<was_cutting()>
6566
6567 =back
6568
6569 =item B<Pod::Paragraph>
6570
6571 =over
6572
6573 =item B<new()>
6574
6575 =item B<cmd_name()>
6576
6577 =item B<text()>
6578
6579 =item B<raw_text()>
6580
6581 =item B<cmd_prefix()>
6582
6583 =item B<cmd_separator()>
6584
6585 =item B<parse_tree()>
6586
6587 =item B<file_line()>
6588
6589 =back
6590
6591 =item B<Pod::InteriorSequence>
6592
6593 =over
6594
6595 =item B<new()>
6596
6597 =item B<cmd_name()>
6598
6599 =item B<prepend()>
6600
6601 =item B<append()>
6602
6603 =item B<nested()>
6604
6605 =item B<raw_text()>
6606
6607 =item B<left_delimiter()>
6608
6609 =item B<right_delimiter()>
6610
6611 =item B<parse_tree()>
6612
6613 =item B<file_line()>
6614
6615 =item B<DESTROY()>
6616
6617 =back
6618
6619 =item B<Pod::ParseTree>
6620
6621 =over
6622
6623 =item B<new()>
6624
6625 =item B<top()>
6626
6627 =item B<children()>
6628
6629 =item B<prepend()>
6630
6631 =item B<append()>
6632
6633 =item B<raw_text()>
6634
6635 =item B<DESTROY()>
6636
6637 =back
6638
6639 =item SEE ALSO
6640
6641 =item AUTHOR
6642
6643 =head2 Pod::Parser - base class for creating POD filters and translators
6644
6645 =item SYNOPSIS
6646
6647 =item REQUIRES
6648
6649 =item EXPORTS
6650
6651 =item DESCRIPTION
6652
6653 =item QUICK OVERVIEW
6654
6655 =item RECOMMENDED SUBROUTINE/METHOD OVERRIDES
6656
6657 =item B<command()>
6658
6659 C<$cmd>, C<$text>, C<$line_num>, C<$pod_para>
6660
6661 =item B<verbatim()>
6662
6663 C<$text>, C<$line_num>, C<$pod_para>
6664
6665 =item B<textblock()>
6666
6667 C<$text>, C<$line_num>, C<$pod_para>
6668
6669 =item B<interior_sequence()>
6670
6671 =item OPTIONAL SUBROUTINE/METHOD OVERRIDES
6672
6673 =item B<new()>
6674
6675 =item B<initialize()>
6676
6677 =item B<begin_pod()>
6678
6679 =item B<begin_input()>
6680
6681 =item B<end_input()>
6682
6683 =item B<end_pod()>
6684
6685 =item B<preprocess_line()>
6686
6687 =item B<preprocess_paragraph()>
6688
6689 =item METHODS FOR PARSING AND PROCESSING
6690
6691 =item B<parse_text()>
6692
6693 B<-expand_seq> =E<gt> I<code-ref>|I<method-name>, B<-expand_ptree> =E<gt>
6694 I<code-ref>|I<method-name>
6695
6696 =item B<interpolate()>
6697
6698 =item B<parse_paragraph()>
6699
6700 =item B<parse_from_filehandle()>
6701
6702 =item B<parse_from_file()>
6703
6704 =item ACCESSOR METHODS
6705
6706 =item B<cutting()>
6707
6708 =item B<output_file()>
6709
6710 =item B<output_handle()>
6711
6712 =item B<input_file()>
6713
6714 =item B<input_handle()>
6715
6716 =item B<input_streams()>
6717
6718 =item B<top_stream()>
6719
6720 =item PRIVATE METHODS AND DATA
6721
6722 =item B<_push_input_stream()>
6723
6724 =item B<_pop_input_stream()>
6725
6726 =item SEE ALSO
6727
6728 =item AUTHOR
6729
6730 =head2 Pod::PlainText, pod2plaintext - function to convert POD data to
6731 formatted ASCII text
6732
6733 =item SYNOPSIS
6734
6735 =item REQUIRES
6736
6737 =item EXPORTS
6738
6739 =item DESCRIPTION
6740
6741 =item SEE ALSO
6742
6743 =item AUTHOR
6744
6745 =head2 Pod::Select, podselect() - extract selected sections of POD from
6746 input
6747
6748 =item SYNOPSIS
6749
6750 =item REQUIRES
6751
6752 =item EXPORTS
6753
6754 =item DESCRIPTION
6755
6756 =item SECTION SPECIFICATIONS
6757
6758 =item RANGE SPECIFICATIONS
6759
6760 =item OBJECT METHODS
6761
6762 =item B<curr_headings()>
6763
6764 =item B<select()>
6765
6766 =item B<add_selection()>
6767
6768 =item B<clear_selections()>
6769
6770 =item B<match_section()>
6771
6772 =item B<is_selected()>
6773
6774 =item EXPORTED FUNCTIONS
6775
6776 =item B<podselect()>
6777
6778 B<-output>, B<-sections>, B<-ranges>
6779
6780 =item PRIVATE METHODS AND DATA
6781
6782 =item B<_compile_section_spec()>
6783
6784 =over
6785
6786 =item $self->{_SECTION_HEADINGS}
6787
6788 =item $self->{_SELECTED_SECTIONS}
6789
6790 =back
6791
6792 =item SEE ALSO
6793
6794 =item AUTHOR
6795
6796 =head2 Pod::Text - convert POD data to formatted ASCII text
6797
6798 =item SYNOPSIS
6799
6800 =item DESCRIPTION
6801
6802 =item AUTHOR
6803
6804 =item TODO
6805
6806 =head2 Pod::Usage, pod2usage() - print a usage message from embedded pod
6807 documentation
6808
6809 =item SYNOPSIS
6810
6811 =item ARGUMENTS
6812
6813 C<-message>, C<-msg>, C<-exitval>, C<-verbose>, C<-output>, C<-input>,
6814 C<-pathlist>
6815
6816 =item DESCRIPTION
6817
6818 =item EXAMPLES
6819
6820 =over
6821
6822 =item Recommended Use
6823
6824 =back
6825
6826 =item CAVEATS
6827
6828 =item AUTHOR
6829
6830 =item ACKNOWLEDGEMENTS
6831
6832 =head2 SDBM_File - Tied access to sdbm files
6833
6834 =item SYNOPSIS
6835
6836 =item DESCRIPTION
6837
6838 =head2 Safe - Compile and execute code in restricted compartments
6839
6840 =item SYNOPSIS
6841
6842 =item DESCRIPTION
6843
6844 a new namespace, an operator mask
6845
6846 =item WARNING
6847
6848 =over
6849
6850 =item RECENT CHANGES
6851
6852 =item Methods in class Safe
6853
6854 permit (OP, ...), permit_only (OP, ...), deny (OP, ...), deny_only (OP,
6855 ...), trap (OP, ...), untrap (OP, ...), share (NAME, ...), share_from
6856 (PACKAGE, ARRAYREF), varglob (VARNAME), reval (STRING), rdo (FILENAME),
6857 root (NAMESPACE), mask (MASK)
6858
6859 =item Some Safety Issues
6860
6861 Memory, CPU, Snooping, Signals, State Changes
6862
6863 =item AUTHOR
6864
6865 =back
6866
6867 =head2 Search::Dict, look - search for key in dictionary file
6868
6869 =item SYNOPSIS
6870
6871 =item DESCRIPTION
6872
6873 =head2 SelectSaver - save and restore selected file handle
6874
6875 =item SYNOPSIS
6876
6877 =item DESCRIPTION
6878
6879 =head2 SelfLoader - load functions only on demand
6880
6881 =item SYNOPSIS
6882
6883 =item DESCRIPTION
6884
6885 =over
6886
6887 =item The __DATA__ token
6888
6889 =item SelfLoader autoloading
6890
6891 =item Autoloading and package lexicals
6892
6893 =item SelfLoader and AutoLoader
6894
6895 =item __DATA__, __END__, and the FOOBAR::DATA filehandle.
6896
6897 =item Classes and inherited methods.
6898
6899 =back
6900
6901 =item Multiple packages and fully qualified subroutine names
6902
6903 =head2 Shell - run shell commands transparently within perl
6904
6905 =item SYNOPSIS
6906
6907 =item DESCRIPTION
6908
6909 =item AUTHOR
6910
6911 =head2 Socket, sockaddr_in, sockaddr_un, inet_aton, inet_ntoa - load the C
6912 socket.h defines and structure manipulators
6913
6914 =item SYNOPSIS
6915
6916 =item DESCRIPTION
6917
6918 inet_aton HOSTNAME, inet_ntoa IP_ADDRESS, INADDR_ANY, INADDR_BROADCAST,
6919 INADDR_LOOPBACK, INADDR_NONE, sockaddr_in PORT, ADDRESS, sockaddr_in
6920 SOCKADDR_IN, pack_sockaddr_in PORT, IP_ADDRESS, unpack_sockaddr_in
6921 SOCKADDR_IN, sockaddr_un PATHNAME, sockaddr_un SOCKADDR_UN,
6922 pack_sockaddr_un PATH, unpack_sockaddr_un SOCKADDR_UN
6923
6924 =head2 Symbol - manipulate Perl symbols and their names
6925
6926 =item SYNOPSIS
6927
6928 =item DESCRIPTION
6929
6930 =head2 Sys::Hostname - Try every conceivable way to get hostname
6931
6932 =item SYNOPSIS
6933
6934 =item DESCRIPTION
6935
6936 =item AUTHOR
6937
6938 =head2 Syslog, Sys::Syslog, openlog, closelog, setlogmask, syslog - Perl
6939 interface to the UNIX syslog(3) calls
6940
6941 =item SYNOPSIS
6942
6943 =item DESCRIPTION
6944
6945 openlog $ident, $logopt, $facility, syslog $priority, $format, @args,
6946 setlogmask $mask_priority, setlogsock $sock_type (added in 5.004_02),
6947 closelog
6948
6949 =item EXAMPLES
6950
6951 =item DEPENDENCIES
6952
6953 =item SEE ALSO
6954
6955 =item AUTHOR
6956
6957 =head2 Term::Cap - Perl termcap interface
6958
6959 =item SYNOPSIS
6960
6961 =item DESCRIPTION
6962
6963 =item EXAMPLES
6964
6965 =head2 Term::Complete - Perl word completion module
6966
6967 =item SYNOPSIS
6968
6969 =item DESCRIPTION
6970
6971 E<lt>tabE<gt>, ^D, ^U, E<lt>delE<gt>, E<lt>bsE<gt>
6972
6973 =item DIAGNOSTICS
6974
6975 =item BUGS
6976
6977 =item AUTHOR
6978
6979 =head2 Term::ReadLine - Perl interface to various C<readline> packages. If
6980 no real package is found, substitutes stubs instead of basic functions.
6981
6982 =item SYNOPSIS
6983
6984 =item DESCRIPTION
6985
6986 =item Minimal set of supported functions
6987
6988 C<ReadLine>, C<new>, C<readline>, C<addhistory>, C<IN>, $C<OUT>,
6989 C<MinLine>, C<findConsole>, Attribs, C<Features>
6990
6991 =item Additional supported functions
6992
6993 C<tkRunning>, C<ornaments>, C<newTTY>
6994
6995 =item EXPORTS
6996
6997 =item ENVIRONMENT
6998
6999 =head2   Test - provides a simple framework for writing test scripts
7000
7001 =item SYNOPSIS
7002
7003 =item DESCRIPTION
7004
7005 =item TEST TYPES
7006
7007 NORMAL TESTS, SKIPPED TESTS, TODO TESTS
7008
7009 =item RETURN VALUE
7010
7011 =item ONFAIL
7012
7013 =item SEE ALSO
7014
7015 =item AUTHOR
7016
7017 =head2 Test::Harness - run perl standard test scripts with statistics
7018
7019 =item SYNOPSIS
7020
7021 =item DESCRIPTION
7022
7023 =over
7024
7025 =item The test script output
7026
7027 =back
7028
7029 =item EXPORT
7030
7031 =item DIAGNOSTICS
7032
7033 C<All tests successful.\nFiles=%d,  Tests=%d, %s>, C<FAILED tests
7034 %s\n\tFailed %d/%d tests, %.2f%% okay.>, C<Test returned status %d (wstat
7035 %d)>, C<Failed 1 test, %.2f%% okay. %s>, C<Failed %d/%d tests, %.2f%% okay.
7036 %s>
7037
7038 =item ENVIRONMENT
7039
7040 =item SEE ALSO
7041
7042 =item AUTHORS
7043
7044 =item BUGS
7045
7046 =head2 Text::Abbrev, abbrev - create an abbreviation table from a list
7047
7048 =item SYNOPSIS
7049
7050 =item DESCRIPTION
7051
7052 =item EXAMPLE
7053
7054 =head2 Text::ParseWords - parse text into an array of tokens or array of
7055 arrays
7056
7057 =item SYNOPSIS
7058
7059 =item DESCRIPTION
7060
7061 =item EXAMPLES
7062
7063 0a simple word, 1multiple spaces are skipped because of our $delim, 2use of
7064 quotes to include a space in a word, 3use of a backslash to include a space
7065 in a word, 4use of a backslash to remove the special meaning of a
7066 double-quote, 5another simple word (note the lack of effect of the
7067 backslashed double-quote)
7068
7069 =item AUTHORS
7070
7071 =head2 Text::Soundex - Implementation of the Soundex Algorithm as Described
7072 by Knuth
7073
7074 =item SYNOPSIS
7075
7076 =item DESCRIPTION
7077
7078 =item EXAMPLES
7079
7080 =item LIMITATIONS
7081
7082 =item AUTHOR
7083
7084 =head2 Text::Tabs -- expand and unexpand tabs per the unix expand(1) and
7085 unexpand(1)
7086
7087 =item SYNOPSIS
7088
7089 =item DESCRIPTION
7090
7091 =item BUGS
7092
7093 =item AUTHOR
7094
7095 =head2 Text::Wrap - line wrapping to form simple paragraphs
7096
7097 =item SYNOPSIS
7098
7099 =item DESCRIPTION
7100
7101 =item EXAMPLE
7102
7103 =item AUTHOR
7104
7105 =head2 Thread - multithreading
7106
7107 =item SYNOPSIS
7108
7109 =item DESCRIPTION
7110
7111 =item FUNCTIONS
7112
7113 new \&start_sub, new \&start_sub, LIST, lock VARIABLE, async BLOCK;,
7114 Thread->self, Thread->list, cond_wait VARIABLE, cond_signal VARIABLE,
7115 cond_broadcast VARIABLE, yield
7116
7117 =item METHODS
7118
7119 join, eval, detach, equal, tid
7120
7121 =item LIMITATIONS
7122
7123 =item SEE ALSO
7124
7125 =head2 Thread::Queue - thread-safe queues
7126
7127 =item SYNOPSIS
7128
7129 =item DESCRIPTION
7130
7131 =item FUNCTIONS AND METHODS
7132
7133 new, enqueue LIST, dequeue, dequeue_nb, pending
7134
7135 =item SEE ALSO
7136
7137 =head2 Thread::Semaphore - thread-safe semaphores
7138
7139 =item SYNOPSIS
7140
7141 =item DESCRIPTION
7142
7143 =item FUNCTIONS AND METHODS
7144
7145 new, new NUMBER, down, down NUMBER, up, up NUMBER
7146
7147 =head2 Thread::Signal - Start a thread which runs signal handlers reliably
7148
7149 =item SYNOPSIS
7150
7151 =item DESCRIPTION
7152
7153 =item BUGS
7154
7155 =head2 Thread::Specific - thread-specific keys
7156
7157 =item SYNOPSIS
7158
7159 =item DESCRIPTION
7160
7161 =head2 Tie::Array - base class for tied arrays
7162
7163 =item SYNOPSIS
7164
7165 =item DESCRIPTION
7166
7167 TIEARRAY classname, LIST, STORE this, index, value, FETCH this, index,
7168 FETCHSIZE this, STORESIZE this, count, EXTEND this, count, CLEAR this,
7169 DESTROY this, PUSH this, LIST, POP this, SHIFT this, UNSHIFT this, LIST,
7170 SPLICE this, offset, length, LIST
7171
7172 =item CAVEATS
7173
7174 =item AUTHOR
7175
7176 =head2 Tie::Handle, Tie::StdHandle  - base class definitions for tied
7177 handles
7178
7179 =item SYNOPSIS
7180
7181 =item DESCRIPTION
7182
7183 TIEHANDLE classname, LIST, WRITE this, scalar, length, offset, PRINT this,
7184 LIST, PRINTF this, format, LIST, READ this, scalar, length, offset,
7185 READLINE this, GETC this, CLOSE this, OPEN this, filename, BINMODE this,
7186 EOF this, TELL this, SEEK this, offset, whence, DESTROY this
7187
7188 =item MORE INFORMATION
7189
7190 =head2 Tie::Hash, Tie::StdHash - base class definitions for tied hashes
7191
7192 =item SYNOPSIS
7193
7194 =item DESCRIPTION
7195
7196 TIEHASH classname, LIST, STORE this, key, value, FETCH this, key, FIRSTKEY
7197 this, NEXTKEY this, lastkey, EXISTS this, key, DELETE this, key, CLEAR this
7198
7199 =item CAVEATS
7200
7201 =item MORE INFORMATION
7202
7203 =head2 Tie::RefHash - use references as hash keys
7204
7205 =item SYNOPSIS
7206
7207 =item DESCRIPTION
7208
7209 =item EXAMPLE
7210
7211 =item AUTHOR
7212
7213 =item VERSION
7214
7215 =item SEE ALSO
7216
7217 =head2 Tie::Scalar, Tie::StdScalar - base class definitions for tied
7218 scalars
7219
7220 =item SYNOPSIS
7221
7222 =item DESCRIPTION
7223
7224 TIESCALAR classname, LIST, FETCH this, STORE this, value, DESTROY this
7225
7226 =item MORE INFORMATION
7227
7228 =head2 Tie::SubstrHash - Fixed-table-size, fixed-key-length hashing
7229
7230 =item SYNOPSIS
7231
7232 =item DESCRIPTION
7233
7234 =item CAVEATS
7235
7236 =head2 Time::Local - efficiently compute time from local and GMT time
7237
7238 =item SYNOPSIS
7239
7240 =item DESCRIPTION
7241
7242 =item IMPLEMENTATION
7243
7244 =item BUGS
7245
7246 =head2 Time::gmtime - by-name interface to Perl's built-in gmtime()
7247 function
7248
7249 =item SYNOPSIS
7250
7251 =item DESCRIPTION
7252
7253 =item NOTE
7254
7255 =item AUTHOR
7256
7257 =head2 Time::localtime - by-name interface to Perl's built-in localtime()
7258 function
7259
7260 =item SYNOPSIS
7261
7262 =item DESCRIPTION
7263
7264 =item NOTE
7265
7266 =item AUTHOR
7267
7268 =head2 Time::tm - internal object used by Time::gmtime and Time::localtime
7269
7270 =item SYNOPSIS
7271
7272 =item DESCRIPTION
7273
7274 =item AUTHOR
7275
7276 =head2 UNIVERSAL - base class for ALL classes (blessed references)
7277
7278 =item SYNOPSIS
7279
7280 =item DESCRIPTION
7281
7282 isa ( TYPE ), can ( METHOD ), VERSION ( [ REQUIRE ] ), UNIVERSAL::isa (
7283 VAL, TYPE ), UNIVERSAL::can ( VAL, METHOD )
7284
7285 =head2 User::grent - by-name interface to Perl's built-in getgr*()
7286 functions
7287
7288 =item SYNOPSIS
7289
7290 =item DESCRIPTION
7291
7292 =item NOTE
7293
7294 =item AUTHOR
7295
7296 =head2 User::pwent - by-name interface to Perl's built-in getpw*()
7297 functions
7298
7299 =item SYNOPSIS
7300
7301 =item DESCRIPTION
7302
7303 =item NOTE
7304
7305 =item AUTHOR
7306
7307 =head1 AUXILIARY DOCUMENTATION
7308
7309 Here should be listed all the extra programs' documentation, but they
7310 don't all have manual pages yet:
7311
7312 =item a2p
7313
7314 =item s2p
7315
7316 =item find2perl
7317
7318 =item h2ph
7319
7320 =item c2ph
7321
7322 =item h2xs
7323
7324 =item xsubpp
7325
7326 =item pod2man
7327
7328 =item wrapsuid
7329
7330 =head1 AUTHOR
7331
7332 Larry Wall <F<larry@wall.org>>, with the help of oodles
7333 of other folks.
7334