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