pod/perltoc.pod

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