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