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