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<issymlink>, C<ivdformat>, C<ivsize>,
8244 C<ivtype>
8245
8246 =item k
8247
8248 C<known_extensions>, C<ksh>
8249
8250 =item l
8251
8252 C<ld>, C<lddlflags>, C<ldflags>, C<ldflags_uselargefiles>, C<ldlibpthname>,
8253 C<less>, C<lib_ext>, C<libc>, C<libperl>, C<libpth>, C<libs>, C<libsdirs>,
8254 C<libsfiles>, C<libsfound>, C<libspath>, C<libswanted>,
8255 C<libswanted_uselargefiles>, C<line>, C<lint>, C<lkflags>, C<ln>, C<lns>,
8256 C<locincpth>, C<loclibpth>, C<longdblsize>, C<longlongsize>, C<longsize>,
8257 C<lp>, C<lpr>, C<ls>, C<lseeksize>, C<lseektype>
8258
8259 =item m
8260
8261 C<mail>, C<mailx>, C<make>, C<make_set_make>, C<mallocobj>, C<mallocsrc>,
8262 C<malloctype>, C<man1dir>, C<man1direxp>, C<man1ext>, C<man3dir>,
8263 C<man3direxp>, C<man3ext>
8264
8265 =item M
8266
8267 C<Mcc>, C<mips_type>, C<mkdir>, C<mmaptype>, C<modetype>, C<more>,
8268 C<multiarch>, C<mv>, C<myarchname>, C<mydomain>, C<myhostname>, C<myuname>
8269
8270 =item n
8271
8272 C<n>, C<need_va_copy>, C<netdb_hlen_type>, C<netdb_host_type>,
8273 C<netdb_name_type>, C<netdb_net_type>, C<nm>, C<nm_opt>, C<nm_so_opt>,
8274 C<nonxs_ext>, C<nroff>, C<nveformat>, C<nvEUformat>, C<nvfformat>,
8275 C<nvFUformat>, C<nvgformat>, C<nvGUformat>, C<nvsize>, C<nvtype>
8276
8277 =item o
8278
8279 C<o_nonblock>, C<obj_ext>, C<old_pthread_create_joinable>, C<optimize>,
8280 C<orderlib>, C<osname>, C<osvers>, C<otherlibdirs>
8281
8282 =item p
8283
8284 C<package>, C<pager>, C<passcat>, C<patchlevel>, C<path_sep>, C<perl5>,
8285 C<perl>
8286
8287 =item P
8288
8289 C<PERL_REVISION>, C<PERL_SUBVERSION>, C<PERL_VERSION>, C<perladmin>,
8290 C<perllibs>, C<perlpath>, C<pg>, C<phostname>, C<pidtype>, C<plibpth>,
8291 C<pm_apiversion>, C<pmake>, C<pr>, C<prefix>, C<prefixexp>, C<privlib>,
8292 C<privlibexp>, C<prototype>, C<ptrsize>
8293
8294 =item q
8295
8296 C<quadkind>, C<quadtype>
8297
8298 =item r
8299
8300 C<randbits>, C<randfunc>, C<randseedtype>, C<ranlib>, C<rd_nodata>,
8301 C<revision>, C<rm>, C<rmail>, C<runnm>
8302
8303 =item s
8304
8305 C<sched_yield>, C<scriptdir>, C<scriptdirexp>, C<sed>, C<seedfunc>,
8306 C<selectminbits>, C<selecttype>, C<sendmail>, C<sh>, C<shar>, C<sharpbang>,
8307 C<shmattype>, C<shortsize>, C<shrpenv>, C<shsharp>, C<sig_count>,
8308 C<sig_name>, C<sig_name_init>, C<sig_num>, C<sig_num_init>, C<signal_t>,
8309 C<sitearch>, C<sitearchexp>, C<sitebin>, C<sitebinexp>, C<sitelib>,
8310 C<sitelib_stem>, C<sitelibexp>, C<siteprefix>, C<siteprefixexp>,
8311 C<sizesize>, C<sizetype>, C<sleep>, C<smail>, C<so>, C<sockethdr>,
8312 C<socketlib>, C<socksizetype>, C<sort>, C<spackage>, C<spitshell>,
8313 C<sPRId64>, C<sPRIeldbl>, C<sPRIEUldbl>, C<sPRIfldbl>, C<sPRIFUldbl>,
8314 C<sPRIgldbl>, C<sPRIGUldbl>, C<sPRIi64>, C<sPRIo64>, C<sPRIu64>,
8315 C<sPRIx64>, C<sPRIXU64>, C<src>, C<sSCNfldbl>, C<ssizetype>, C<startperl>,
8316 C<startsh>, C<static_ext>, C<stdchar>, C<stdio_base>, C<stdio_bufsiz>,
8317 C<stdio_cnt>, C<stdio_filbuf>, C<stdio_ptr>, C<stdio_stream_array>,
8318 C<strings>, C<submit>, C<subversion>, C<sysman>
8319
8320 =item t
8321
8322 C<tail>, C<tar>, C<tbl>, C<tee>, C<test>, C<timeincl>, C<timetype>,
8323 C<touch>, C<tr>, C<trnl>, C<troff>
8324
8325 =item u
8326
8327 C<u16size>, C<u16type>, C<u32size>, C<u32type>, C<u64size>, C<u64type>,
8328 C<u8size>, C<u8type>, C<uidformat>, C<uidsign>, C<uidsize>, C<uidtype>,
8329 C<uname>, C<uniq>, C<uquadtype>, C<use5005threads>, C<use64bitall>,
8330 C<use64bitint>, C<usedl>, C<useithreads>, C<uselargefiles>,
8331 C<uselongdouble>, C<usemorebits>, C<usemultiplicity>, C<usemymalloc>,
8332 C<usenm>, C<useopcode>, C<useperlio>, C<useposix>, C<usesfio>,
8333 C<useshrplib>, C<usesocks>, C<usethreads>, C<usevendorprefix>, C<usevfork>,
8334 C<usrinc>, C<uuname>, C<uvoformat>, C<uvsize>, C<uvtype>, C<uvuformat>,
8335 C<uvxformat>, C<uvXUformat>
8336
8337 =item v
8338
8339 C<vendorarch>, C<vendorarchexp>, C<vendorbin>, C<vendorbinexp>,
8340 C<vendorlib>, C<vendorlib_stem>, C<vendorlibexp>, C<vendorprefix>,
8341 C<vendorprefixexp>, C<version>, C<versiononly>, C<vi>, C<voidflags>
8342
8343 =item x
8344
8345 C<xlibpth>, C<xs_apiversion>
8346
8347 =item z
8348
8349 C<zcat>, C<zip>
8350
8351 =back
8352
8353 =item NOTE
8354
8355 =back
8356
8357 =head2 Cwd, getcwd - get pathname of current working directory
8358
8359 =over 4
8360
8361 =item SYNOPSIS
8362
8363 =item DESCRIPTION
8364
8365 =back
8366
8367 =head2 DB - programmatic interface to the Perl debugging API (draft,
8368 subject to
8369 change)
8370
8371 =over 4
8372
8373 =item SYNOPSIS
8374
8375 =item DESCRIPTION
8376
8377 =over 4
8378
8379 =item Global Variables
8380
8381  $DB::sub,  %DB::sub,  $DB::single,  $DB::signal,  $DB::trace,  @DB::args,
8382 @DB::dbline,  %DB::dbline,  $DB::package,  $DB::filename,  $DB::subname,
8383 $DB::lineno
8384
8385 =item API Methods
8386
8387 CLIENT->register(), CLIENT->evalcode(STRING), CLIENT->skippkg('D::hide'),
8388 CLIENT->run(), CLIENT->step(), CLIENT->next(), CLIENT->done()
8389
8390 =item Client Callback Methods
8391
8392 CLIENT->init(), CLIENT->prestop([STRING]), CLIENT->stop(), CLIENT->idle(),
8393 CLIENT->poststop([STRING]), CLIENT->evalcode(STRING), CLIENT->cleanup(),
8394 CLIENT->output(LIST)
8395
8396 =back
8397
8398 =item BUGS
8399
8400 =item AUTHOR
8401
8402 =back
8403
8404 =head2 DB_File - Perl5 access to Berkeley DB version 1.x
8405
8406 =over 4
8407
8408 =item SYNOPSIS
8409
8410 =item DESCRIPTION
8411
8412 B<DB_HASH>, B<DB_BTREE>, B<DB_RECNO>
8413
8414 =over 4
8415
8416 =item Using DB_File with Berkeley DB version 2 or 3
8417
8418 =item Interface to Berkeley DB
8419
8420 =item Opening a Berkeley DB Database File
8421
8422 =item Default Parameters
8423
8424 =item In Memory Databases
8425
8426 =back
8427
8428 =item DB_HASH
8429
8430 =over 4
8431
8432 =item A Simple Example
8433
8434 =back
8435
8436 =item DB_BTREE
8437
8438 =over 4
8439
8440 =item Changing the BTREE sort order
8441
8442 =item Handling Duplicate Keys
8443
8444 =item The get_dup() Method
8445
8446 =item The find_dup() Method
8447
8448 =item The del_dup() Method
8449
8450 =item Matching Partial Keys
8451
8452 =back
8453
8454 =item DB_RECNO
8455
8456 =over 4
8457
8458 =item The 'bval' Option
8459
8460 =item A Simple Example
8461
8462 =item Extra RECNO Methods
8463
8464 B<$X-E<gt>push(list) ;>, B<$value = $X-E<gt>pop ;>, B<$X-E<gt>shift>,
8465 B<$X-E<gt>unshift(list) ;>, B<$X-E<gt>length>
8466
8467 =item Another Example
8468
8469 =back
8470
8471 =item THE API INTERFACE
8472
8473 B<$status = $X-E<gt>get($key, $value [, $flags]) ;>, B<$status =
8474 $X-E<gt>put($key, $value [, $flags]) ;>, B<$status = $X-E<gt>del($key [,
8475 $flags]) ;>, B<$status = $X-E<gt>fd ;>, B<$status = $X-E<gt>seq($key,
8476 $value, $flags) ;>, B<$status = $X-E<gt>sync([$flags]) ;>
8477
8478 =item DBM FILTERS
8479
8480 B<filter_store_key>, B<filter_store_value>, B<filter_fetch_key>,
8481 B<filter_fetch_value>
8482
8483 =over 4
8484
8485 =item The Filter
8486
8487 =item An Example -- the NULL termination problem.
8488
8489 =item Another Example -- Key is a C int.
8490
8491 =back
8492
8493 =item HINTS AND TIPS
8494
8495 =over 4
8496
8497 =item Locking: The Trouble with fd
8498
8499 =item Safe ways to lock a database
8500
8501 B<Tie::DB_Lock>, B<Tie::DB_LockFile>, B<DB_File::Lock>
8502
8503 =item Sharing Databases With C Applications
8504
8505 =item The untie() Gotcha
8506
8507 =back
8508
8509 =item COMMON QUESTIONS
8510
8511 =over 4
8512
8513 =item Why is there Perl source in my database?
8514
8515 =item How do I store complex data structures with DB_File?
8516
8517 =item What does "Invalid Argument" mean?
8518
8519 =item What does "Bareword 'DB_File' not allowed" mean?
8520
8521 =back
8522
8523 =item REFERENCES
8524
8525 =item HISTORY
8526
8527 =item BUGS
8528
8529 =item AVAILABILITY
8530
8531 =item COPYRIGHT
8532
8533 =item SEE ALSO
8534
8535 =item AUTHOR
8536
8537 =back
8538
8539 =head2 Data::Dumper - stringified perl data structures, suitable for both
8540 printing and C<eval>
8541
8542 =over 4
8543
8544 =item SYNOPSIS
8545
8546 =item DESCRIPTION
8547
8548 =over 4
8549
8550 =item Methods
8551
8552 I<PACKAGE>->new(I<ARRAYREF [>, I<ARRAYREF]>), I<$OBJ>->Dump  I<or>
8553 I<PACKAGE>->Dump(I<ARRAYREF [>, I<ARRAYREF]>), I<$OBJ>->Seen(I<[HASHREF]>),
8554 I<$OBJ>->Values(I<[ARRAYREF]>), I<$OBJ>->Names(I<[ARRAYREF]>),
8555 I<$OBJ>->Reset
8556
8557 =item Functions
8558
8559 Dumper(I<LIST>)
8560
8561 =item Configuration Variables or Methods
8562
8563 $Data::Dumper::Indent  I<or>  I<$OBJ>->Indent(I<[NEWVAL]>),
8564 $Data::Dumper::Purity  I<or>  I<$OBJ>->Purity(I<[NEWVAL]>),
8565 $Data::Dumper::Pad  I<or>  I<$OBJ>->Pad(I<[NEWVAL]>),
8566 $Data::Dumper::Varname  I<or>  I<$OBJ>->Varname(I<[NEWVAL]>),
8567 $Data::Dumper::Useqq  I<or>  I<$OBJ>->Useqq(I<[NEWVAL]>),
8568 $Data::Dumper::Terse  I<or>  I<$OBJ>->Terse(I<[NEWVAL]>),
8569 $Data::Dumper::Freezer  I<or>  $I<OBJ>->Freezer(I<[NEWVAL]>),
8570 $Data::Dumper::Toaster  I<or>  $I<OBJ>->Toaster(I<[NEWVAL]>),
8571 $Data::Dumper::Deepcopy  I<or>  $I<OBJ>->Deepcopy(I<[NEWVAL]>),
8572 $Data::Dumper::Quotekeys  I<or>  $I<OBJ>->Quotekeys(I<[NEWVAL]>),
8573 $Data::Dumper::Bless  I<or>  $I<OBJ>->Bless(I<[NEWVAL]>),
8574 $Data::Dumper::Maxdepth  I<or>  $I<OBJ>->Maxdepth(I<[NEWVAL]>)
8575
8576 =item Exports
8577
8578 Dumper
8579
8580 =back
8581
8582 =item EXAMPLES
8583
8584 =item BUGS
8585
8586 =item AUTHOR
8587
8588 =item VERSION
8589
8590 =item SEE ALSO
8591
8592 =back
8593
8594 =head2 Devel::DProf - a Perl code profiler
8595
8596 =over 4
8597
8598 =item SYNOPSIS
8599
8600 =item DESCRIPTION
8601
8602 =item PROFILE FORMAT
8603
8604 =item AUTOLOAD
8605
8606 =item ENVIRONMENT
8607
8608 =item BUGS
8609
8610 =item SEE ALSO
8611
8612 =back
8613
8614 =head2 Devel::Peek - A data debugging tool for the XS programmer
8615
8616 =over 4
8617
8618 =item SYNOPSIS
8619
8620 =item DESCRIPTION
8621
8622 =over 4
8623
8624 =item Memory footprint debugging
8625
8626 =back
8627
8628 =item EXAMPLES
8629
8630 =over 4
8631
8632 =item A simple scalar string
8633
8634 =item A simple scalar number
8635
8636 =item A simple scalar with an extra reference
8637
8638 =item A reference to a simple scalar
8639
8640 =item A reference to an array
8641
8642 =item A reference to a hash
8643
8644 =item Dumping a large array or hash
8645
8646 =item A reference to an SV which holds a C pointer
8647
8648 =item A reference to a subroutine
8649
8650 =back
8651
8652 =item EXPORTS
8653
8654 =item BUGS
8655
8656 =item AUTHOR
8657
8658 =item SEE ALSO
8659
8660 =back
8661
8662 =head2 Devel::SelfStubber - generate stubs for a SelfLoading module
8663
8664 =over 4
8665
8666 =item SYNOPSIS
8667
8668 =item DESCRIPTION
8669
8670 =back
8671
8672 =head2 DirHandle - supply object methods for directory handles
8673
8674 =over 4
8675
8676 =item SYNOPSIS
8677
8678 =item DESCRIPTION
8679
8680 =back
8681
8682 =head2 Dumpvalue - provides screen dump of Perl data.
8683
8684 =over 4
8685
8686 =item SYNOPSIS
8687
8688 =item DESCRIPTION
8689
8690 =over 4
8691
8692 =item Creation
8693
8694 C<arrayDepth>, C<hashDepth>, C<compactDump>, C<veryCompact>, C<globPrint>,
8695 C<DumpDBFiles>, C<DumpPackages>, C<DumpReused>, C<tick>, C<HighBit>,
8696 C<printUndef>, C<UsageOnly>, unctrl, subdump, bareStringify, quoteHighBit,
8697 stopDbSignal
8698
8699 =item Methods
8700
8701 dumpValue, dumpValues, dumpvars, set_quote, set_unctrl, compactDump,
8702 veryCompact, set, get
8703
8704 =back
8705
8706 =back
8707
8708 =head2 DynaLoader - Dynamically load C libraries into Perl code
8709
8710 =over 4
8711
8712 =item SYNOPSIS
8713
8714 =item DESCRIPTION
8715
8716 @dl_library_path, @dl_resolve_using, @dl_require_symbols, @dl_librefs,
8717 @dl_modules, dl_error(), $dl_debug, dl_findfile(), dl_expandspec(),
8718 dl_load_file(), dl_unload_file(), dl_loadflags(), dl_find_symbol(),
8719 dl_find_symbol_anywhere(), dl_undef_symbols(), dl_install_xsub(),
8720 bootstrap()
8721
8722 =item AUTHOR
8723
8724 =back
8725
8726 =head2 DynaLoader::XSLoader, XSLoader - Dynamically load C libraries into
8727 Perl code
8728
8729 =over 4
8730
8731 =item SYNOPSIS
8732
8733 =item DESCRIPTION
8734
8735 =item AUTHOR
8736
8737 =back
8738
8739 =head2 Encode - character encodings
8740
8741 =over 4
8742
8743 =item TERMINOLOGY
8744
8745 =item bytes
8746
8747 =item chars
8748
8749 =item chars With Encoding
8750
8751 =item Testing For UTF-8
8752
8753 =item Toggling UTF-8-ness
8754
8755 =item UTF-16 and UTF-32 Encodings
8756
8757 =item Handling Malformed Data
8758
8759 =back
8760
8761 =head2 Encode::EncodeFormat, EncodeFormat - the format of encoding tables
8762 of the Encode extension
8763
8764 =over 4
8765
8766 =item DESCRIPTION
8767
8768 [1]   B<S>, [2]   B<D>, [3]   B<M>, [4]   B<E>
8769
8770 =item KEYWORDS
8771
8772 =item COPYRIGHT
8773
8774 =back
8775
8776 =head2 EncodeFormat - the format of encoding tables of the Encode extension
8777
8778 =over 4
8779
8780 =item DESCRIPTION
8781
8782 [1]   B<S>, [2]   B<D>, [3]   B<M>, [4]   B<E>
8783
8784 =item KEYWORDS
8785
8786 =item COPYRIGHT
8787
8788 =back
8789
8790 =head2 English - use nice English (or awk) names for ugly punctuation
8791 variables
8792
8793 =over 4
8794
8795 =item SYNOPSIS
8796
8797 =item DESCRIPTION
8798
8799 =item PERFORMANCE
8800
8801 =back
8802
8803 =head2 Env - perl module that imports environment variables as scalars or
8804 arrays
8805
8806 =over 4
8807
8808 =item SYNOPSIS
8809
8810 =item DESCRIPTION
8811
8812 =item LIMITATIONS
8813
8814 =item AUTHOR
8815
8816 =back
8817
8818 =head2 Errno - System errno constants
8819
8820 =over 4
8821
8822 =item SYNOPSIS
8823
8824 =item DESCRIPTION
8825
8826 =item CAVEATS
8827
8828 =item AUTHOR
8829
8830 =item COPYRIGHT
8831
8832 =back
8833
8834 =head2 Exporter - Implements default import method for modules
8835
8836 =over 4
8837
8838 =item SYNOPSIS
8839
8840 =item DESCRIPTION
8841
8842 =over 4
8843
8844 =item How to Export
8845
8846 =item Selecting What To Export
8847
8848 =item Specialised Import Lists
8849
8850 =item Exporting without using Export's import method
8851
8852 =item Module Version Checking
8853
8854 =item Managing Unknown Symbols
8855
8856 =item Tag Handling Utility Functions
8857
8858 =back
8859
8860 =back
8861
8862 =head2 Exporter::Heavy - Exporter guts
8863
8864 =over 4
8865
8866 =item SYNOPIS
8867
8868 =item DESCRIPTION
8869
8870 =back
8871
8872 =head2 ExtUtils::Command - utilities to replace common UNIX commands in
8873 Makefiles etc.
8874
8875 =over 4
8876
8877 =item SYNOPSIS
8878
8879 =item DESCRIPTION
8880
8881 =back
8882
8883 cat
8884
8885 eqtime src dst
8886
8887 rm_f files...
8888
8889 rm_f files...
8890
8891 touch files ..
8892
8893 mv source... destination
8894
8895 cp source... destination
8896
8897 chmod mode files..
8898
8899 mkpath directory..
8900
8901 test_f file
8902
8903 =over 4
8904
8905 =item BUGS
8906
8907 =item SEE ALSO
8908
8909 =item AUTHOR
8910
8911 =back
8912
8913 =head2 ExtUtils::Embed - Utilities for embedding Perl in C/C++ applications
8914
8915 =over 4
8916
8917 =item SYNOPSIS
8918
8919 =item DESCRIPTION
8920
8921 =item @EXPORT
8922
8923 =item FUNCTIONS
8924
8925 xsinit(), Examples, ldopts(), Examples, perl_inc(), ccflags(), ccdlflags(),
8926 ccopts(), xsi_header(), xsi_protos(@modules), xsi_body(@modules)
8927
8928 =item EXAMPLES
8929
8930 =item SEE ALSO
8931
8932 =item AUTHOR
8933
8934 =back
8935
8936 =head2 ExtUtils::Install - install files from here to there
8937
8938 =over 4
8939
8940 =item SYNOPSIS
8941
8942 =item DESCRIPTION
8943
8944 =back
8945
8946 =head2 ExtUtils::Installed - Inventory management of installed modules
8947
8948 =over 4
8949
8950 =item SYNOPSIS
8951
8952 =item DESCRIPTION
8953
8954 =item USAGE
8955
8956 =item FUNCTIONS
8957
8958 new(), modules(), files(), directories(), directory_tree(), validate(),
8959 packlist(), version()
8960
8961 =item EXAMPLE
8962
8963 =item AUTHOR
8964
8965 =back
8966
8967 =head2 ExtUtils::Liblist - determine libraries to use and how to use them
8968
8969 =over 4
8970
8971 =item SYNOPSIS
8972
8973 =item DESCRIPTION
8974
8975 For static extensions, For dynamic extensions, For dynamic extensions
8976
8977 =over 4
8978
8979 =item EXTRALIBS
8980
8981 =item LDLOADLIBS and LD_RUN_PATH
8982
8983 =item BSLOADLIBS
8984
8985 =back
8986
8987 =item PORTABILITY
8988
8989 =over 4
8990
8991 =item VMS implementation
8992
8993 =item Win32 implementation
8994
8995 =back
8996
8997 =item SEE ALSO
8998
8999 =back
9000
9001 =head2 ExtUtils::MM_Cygwin - methods to override UN*X behaviour in
9002 ExtUtils::MakeMaker
9003
9004 =over 4
9005
9006 =item SYNOPSIS
9007
9008 =item DESCRIPTION
9009
9010 canonpath, cflags, manifypods, perl_archive
9011
9012 =back
9013
9014 =head2 ExtUtils::MM_OS2 - methods to override UN*X behaviour in
9015 ExtUtils::MakeMaker
9016
9017 =over 4
9018
9019 =item SYNOPSIS
9020
9021 =item DESCRIPTION
9022
9023 =back
9024
9025 =head2 ExtUtils::MM_Unix - methods used by ExtUtils::MakeMaker
9026
9027 =over 4
9028
9029 =item SYNOPSIS
9030
9031 =item DESCRIPTION
9032
9033 =item METHODS
9034
9035 =over 4
9036
9037 =item Preloaded methods
9038
9039 canonpath
9040
9041 =back
9042
9043 =back
9044
9045 catdir
9046
9047 catfile
9048
9049 curdir
9050
9051 rootdir
9052
9053 updir
9054
9055 =over 4
9056
9057 =item SelfLoaded methods
9058
9059 c_o (o)
9060
9061 =back
9062
9063 cflags (o)
9064
9065 clean (o)
9066
9067 const_cccmd (o)
9068
9069 const_config (o)
9070
9071 const_loadlibs (o)
9072
9073 constants (o)
9074
9075 depend (o)
9076
9077 dir_target (o)
9078
9079 dist (o)
9080
9081 dist_basics (o)
9082
9083 dist_ci (o)
9084
9085 dist_core (o)
9086
9087 dist_dir (o)
9088
9089 dist_test (o)
9090
9091 dlsyms (o)
9092
9093 dynamic (o)
9094
9095 dynamic_bs (o)
9096
9097 dynamic_lib (o)
9098
9099 exescan
9100
9101 extliblist
9102
9103 file_name_is_absolute
9104
9105 find_perl
9106
9107 =over 4
9108
9109 =item Methods to actually produce chunks of text for the Makefile
9110
9111 fixin
9112
9113 =back
9114
9115 force (o)
9116
9117 guess_name
9118
9119 has_link_code
9120
9121 htmlifypods (o)
9122
9123 init_dirscan
9124
9125 init_main
9126
9127 init_others
9128
9129 install (o)
9130
9131 installbin (o)
9132
9133 libscan (o)
9134
9135 linkext (o)
9136
9137 lsdir
9138
9139 macro (o)
9140
9141 makeaperl (o)
9142
9143 makefile (o)
9144
9145 manifypods (o)
9146
9147 maybe_command
9148
9149 maybe_command_in_dirs
9150
9151 needs_linking (o)
9152
9153 nicetext
9154
9155 parse_version
9156
9157 parse_abstract
9158
9159 pasthru (o)
9160
9161 path
9162
9163 perl_script
9164
9165 perldepend (o)
9166
9167 ppd
9168
9169 perm_rw (o)
9170
9171 perm_rwx (o)
9172
9173 pm_to_blib
9174
9175 post_constants (o)
9176
9177 post_initialize (o)
9178
9179 postamble (o)
9180
9181 prefixify
9182
9183 processPL (o)
9184
9185 realclean (o)
9186
9187 replace_manpage_separator
9188
9189 static (o)
9190
9191 static_lib (o)
9192
9193 staticmake (o)
9194
9195 subdir_x (o)
9196
9197 subdirs (o)
9198
9199 test (o)
9200
9201 test_via_harness (o)
9202
9203 test_via_script (o)
9204
9205 tool_autosplit (o)
9206
9207 tools_other (o)
9208
9209 tool_xsubpp (o)
9210
9211 top_targets (o)
9212
9213 writedoc
9214
9215 xs_c (o)
9216
9217 xs_cpp (o)
9218
9219 xs_o (o)
9220
9221 perl_archive
9222
9223 export_list
9224
9225 =over 4
9226
9227 =item SEE ALSO
9228
9229 =back
9230
9231 =head2 ExtUtils::MM_VMS - methods to override UN*X behaviour in
9232 ExtUtils::MakeMaker
9233
9234 =over 4
9235
9236 =item SYNOPSIS
9237
9238 =item DESCRIPTION
9239
9240 =over 4
9241
9242 =item Methods always loaded
9243
9244 wraplist
9245
9246 =back
9247
9248 =back
9249
9250 rootdir (override)
9251
9252 =over 4
9253
9254 =item SelfLoaded methods
9255
9256 guess_name (override)
9257
9258 =back
9259
9260 find_perl (override)
9261
9262 path (override)
9263
9264 maybe_command (override)
9265
9266 maybe_command_in_dirs (override)
9267
9268 perl_script (override)
9269
9270 file_name_is_absolute (override)
9271
9272 replace_manpage_separator
9273
9274 init_others (override)
9275
9276 constants (override)
9277
9278 cflags (override)
9279
9280 const_cccmd (override)
9281
9282 pm_to_blib (override)
9283
9284 tool_autosplit (override)
9285
9286 tool_sxubpp (override)
9287
9288 xsubpp_version (override)
9289
9290 tools_other (override)
9291
9292 dist (override)
9293
9294 c_o (override)
9295
9296 xs_c (override)
9297
9298 xs_o (override)
9299
9300 top_targets (override)
9301
9302 dlsyms (override)
9303
9304 dynamic_lib (override)
9305
9306 dynamic_bs (override)
9307
9308 static_lib (override)
9309
9310 manifypods (override)
9311
9312 processPL (override)
9313
9314 installbin (override)
9315
9316 subdir_x (override)
9317
9318 clean (override)
9319
9320 realclean (override)
9321
9322 dist_basics (override)
9323
9324 dist_core (override)
9325
9326 dist_dir (override)
9327
9328 dist_test (override)
9329
9330 install (override)
9331
9332 perldepend (override)
9333
9334 makefile (override)
9335
9336 test (override)
9337
9338 test_via_harness (override)
9339
9340 test_via_script (override)
9341
9342 makeaperl (override)
9343
9344 nicetext (override)
9345
9346 =head2 ExtUtils::MM_Win32 - methods to override UN*X behaviour in
9347 ExtUtils::MakeMaker
9348
9349 =over 4
9350
9351 =item SYNOPSIS
9352
9353 =item DESCRIPTION
9354
9355 =back
9356
9357 catfile
9358
9359 constants (o)
9360
9361 static_lib (o)
9362
9363 dynamic_bs (o)
9364
9365 dynamic_lib (o)
9366
9367 canonpath
9368
9369 perl_script
9370
9371 pm_to_blib
9372
9373 test_via_harness (o)
9374
9375 tool_autosplit (override)
9376
9377 tools_other (o)
9378
9379 xs_o (o)
9380
9381 top_targets (o)
9382
9383 htmlifypods (o)
9384
9385 manifypods (o)
9386
9387 dist_ci (o)
9388
9389 dist_core (o)
9390
9391 pasthru (o)
9392
9393 =head2 ExtUtils::MakeMaker - create an extension Makefile
9394
9395 =over 4
9396
9397 =item SYNOPSIS
9398
9399 =item DESCRIPTION
9400
9401 =over 4
9402
9403 =item How To Write A Makefile.PL
9404
9405 =item Default Makefile Behaviour
9406
9407 =item make test
9408
9409 =item make testdb
9410
9411 =item make install
9412
9413 =item PREFIX and LIB attribute
9414
9415 =item AFS users
9416
9417 =item Static Linking of a new Perl Binary
9418
9419 =item Determination of Perl Library and Installation Locations
9420
9421 =item Which architecture dependent directory?
9422
9423 =item Using Attributes and Parameters
9424
9425 ABSTRACT, ABSTRACT_FROM, AUTHOR, BINARY_LOCATION, C, CAPI, CCFLAGS, CONFIG,
9426 CONFIGURE, DEFINE, DIR, DISTNAME, DL_FUNCS, DL_VARS, EXCLUDE_EXT,
9427 EXE_FILES, FIRST_MAKEFILE, FULLPERL, FUNCLIST, H, HTMLLIBPODS,
9428 HTMLSCRIPTPODS, IMPORTS, INC, INCLUDE_EXT, INSTALLARCHLIB, INSTALLBIN,
9429 INSTALLDIRS, INSTALLHTMLPRIVLIBDIR, INSTALLHTMLSCRIPTDIR,
9430 INSTALLHTMLSITELIBDIR, INSTALLMAN1DIR, INSTALLMAN3DIR, INSTALLPRIVLIB,
9431 INSTALLSCRIPT, INSTALLSITEARCH, INSTALLSITELIB, INST_ARCHLIB, INST_BIN,
9432 INST_EXE, INST_HTMLLIBDIR, INST_HTMLSCRIPTDIR, INST_LIB, INST_MAN1DIR,
9433 INST_MAN3DIR, INST_SCRIPT, LDFROM, LIB, LIBPERL_A, LIBS, LINKTYPE,
9434 MAKEAPERL, MAKEFILE, MAN1PODS, MAN3PODS, MAP_TARGET, MYEXTLIB, NAME,
9435 NEEDS_LINKING, NOECHO, NORECURS, NO_VC, OBJECT, OPTIMIZE, PERL, PERLMAINCC,
9436 PERL_ARCHLIB, PERL_LIB, PERL_MALLOC_OK, PERL_SRC, PERM_RW, PERM_RWX,
9437 PL_FILES, PM, PMLIBDIRS, POLLUTE, PPM_INSTALL_EXEC, PPM_INSTALL_SCRIPT,
9438 PREFIX, PREREQ_PM, SKIP, TYPEMAPS, VERSION, VERSION_FROM, XS, XSOPT,
9439 XSPROTOARG, XS_VERSION
9440
9441 =item Additional lowercase attributes
9442
9443 clean, depend, dist, dynamic_lib, linkext, macro, realclean, test,
9444 tool_autosplit
9445
9446 =item Overriding MakeMaker Methods
9447
9448 =item Hintsfile support
9449
9450 =item Distribution Support
9451
9452    make distcheck,    make skipcheck,    make distclean,    make manifest,
9453   make distdir,    make tardist,    make dist,    make uutardist,    make
9454 shdist,    make zipdist,    make ci
9455
9456 =item Disabling an extension
9457
9458 =back
9459
9460 =item ENVIRONMENT
9461
9462 PERL_MM_OPT
9463
9464 =item SEE ALSO
9465
9466 =item AUTHORS
9467
9468 =back
9469
9470 =head2 ExtUtils::Manifest - utilities to write and check a MANIFEST file
9471
9472 =over 4
9473
9474 =item SYNOPSIS
9475
9476 =item DESCRIPTION
9477
9478 =item MANIFEST.SKIP
9479
9480 =item EXPORT_OK
9481
9482 =item GLOBAL VARIABLES
9483
9484 =item DIAGNOSTICS
9485
9486 C<Not in MANIFEST:> I<file>, C<No such file:> I<file>, C<MANIFEST:> I<$!>,
9487 C<Added to MANIFEST:> I<file>
9488
9489 =item ENVIRONMENT
9490
9491 B<PERL_MM_MANIFEST_DEBUG>
9492
9493 =item SEE ALSO
9494
9495 =item AUTHOR
9496
9497 =back
9498
9499 =head2 ExtUtils::Miniperl, writemain - write the C code for perlmain.c
9500
9501 =over 4
9502
9503 =item SYNOPSIS
9504
9505 =item DESCRIPTION
9506
9507 =item SEE ALSO
9508
9509 =back
9510
9511 =head2 ExtUtils::Mkbootstrap - make a bootstrap file for use by DynaLoader
9512
9513 =over 4
9514
9515 =item SYNOPSIS
9516
9517 =item DESCRIPTION
9518
9519 =back
9520
9521 =head2 ExtUtils::Mksymlists - write linker options files for dynamic
9522 extension
9523
9524 =over 4
9525
9526 =item SYNOPSIS
9527
9528 =item DESCRIPTION
9529
9530 DLBASE, DL_FUNCS, DL_VARS, FILE, FUNCLIST, IMPORTS, NAME
9531
9532 =item AUTHOR
9533
9534 =item REVISION
9535
9536 =back
9537
9538 =head2 ExtUtils::Packlist - manage .packlist files
9539
9540 =over 4
9541
9542 =item SYNOPSIS
9543
9544 =item DESCRIPTION
9545
9546 =item USAGE
9547
9548 =item FUNCTIONS
9549
9550 new(), read(), write(), validate(), packlist_file()
9551
9552 =item EXAMPLE
9553
9554 =item AUTHOR
9555
9556 =back
9557
9558 =head2 ExtUtils::testlib - add blib/* directories to @INC
9559
9560 =over 4
9561
9562 =item SYNOPSIS
9563
9564 =item DESCRIPTION
9565
9566 =back
9567
9568 =head2 Fatal - replace functions with equivalents which succeed or die
9569
9570 =over 4
9571
9572 =item SYNOPSIS
9573
9574 =item DESCRIPTION
9575
9576 =item AUTHOR
9577
9578 =back
9579
9580 =head2 Fcntl - load the C Fcntl.h defines
9581
9582 =over 4
9583
9584 =item SYNOPSIS
9585
9586 =item DESCRIPTION
9587
9588 =item NOTE
9589
9590 =item EXPORTED SYMBOLS
9591
9592 =back
9593
9594 =head2 File::Basename, fileparse - split a pathname into pieces
9595
9596 =over 4
9597
9598 =item SYNOPSIS
9599
9600 =item DESCRIPTION
9601
9602 fileparse_set_fstype, fileparse
9603
9604 =item EXAMPLES
9605
9606 C<basename>, C<dirname>
9607
9608 =back
9609
9610 =head2 File::CheckTree, validate - run many filetest checks on a tree
9611
9612 =over 4
9613
9614 =item SYNOPSIS
9615
9616 =item DESCRIPTION
9617
9618 =back
9619
9620 =head2 File::Compare - Compare files or filehandles
9621
9622 =over 4
9623
9624 =item SYNOPSIS
9625
9626 =item DESCRIPTION
9627
9628 =item RETURN
9629
9630 =item AUTHOR
9631
9632 =back
9633
9634 =head2 File::Copy - Copy files or filehandles
9635
9636 =over 4
9637
9638 =item SYNOPSIS
9639
9640 =item DESCRIPTION
9641
9642 =over 4
9643
9644 =item Special behaviour if C<syscopy> is defined (OS/2, VMS and Win32)
9645
9646 rmscopy($from,$to[,$date_flag])
9647
9648 =back
9649
9650 =item RETURN
9651
9652 =item AUTHOR
9653
9654 =back
9655
9656 =head2 File::DosGlob - DOS like globbing and then some
9657
9658 =over 4
9659
9660 =item SYNOPSIS
9661
9662 =item DESCRIPTION
9663
9664 =item EXPORTS (by request only)
9665
9666 =item BUGS
9667
9668 =item AUTHOR
9669
9670 =item HISTORY
9671
9672 =item SEE ALSO
9673
9674 =back
9675
9676 =head2 File::Find, find - traverse a file tree
9677
9678 =over 4
9679
9680 =item SYNOPSIS
9681
9682 =item DESCRIPTION
9683
9684 C<wanted>, C<bydepth>, C<preprocess>, C<postprocess>, C<follow>,
9685 C<follow_fast>, C<follow_skip>, C<no_chdir>, C<untaint>,
9686 C<untaint_pattern>, C<untaint_skip>
9687
9688 =item CAVEAT
9689
9690 =back
9691
9692 =head2 File::Glob - Perl extension for BSD glob routine
9693
9694 =over 4
9695
9696 =item SYNOPSIS
9697
9698 =item DESCRIPTION
9699
9700 C<GLOB_ERR>, C<GLOB_MARK>, C<GLOB_NOCASE>, C<GLOB_NOCHECK>, C<GLOB_NOSORT>,
9701 C<GLOB_BRACE>, C<GLOB_NOMAGIC>, C<GLOB_QUOTE>, C<GLOB_TILDE>, C<GLOB_CSH>
9702
9703 =item DIAGNOSTICS
9704
9705 C<GLOB_NOSPACE>, C<GLOB_ABEND>
9706
9707 =item NOTES
9708
9709 =item AUTHOR
9710
9711 =back
9712
9713 =head2 File::Path - create or remove directory trees
9714
9715 =over 4
9716
9717 =item SYNOPSIS
9718
9719 =item DESCRIPTION
9720
9721 =item AUTHORS
9722
9723 =back
9724
9725 =head2 File::Spec - portably perform operations on file names
9726
9727 =over 4
9728
9729 =item SYNOPSIS
9730
9731 =item DESCRIPTION
9732
9733 =item SEE ALSO
9734
9735 =item AUTHORS
9736
9737 =back
9738
9739 =head2 File::Spec::Epoc - methods for Epoc file specs
9740
9741 =over 4
9742
9743 =item SYNOPSIS
9744
9745 =item DESCRIPTION
9746
9747 devnull
9748
9749 =back
9750
9751 tmpdir
9752
9753 path
9754
9755 canonpath
9756
9757 splitpath
9758
9759 splitdir
9760
9761 catpath
9762
9763 abs2rel
9764
9765 rel2abs
9766
9767 =over 4
9768
9769 =item SEE ALSO
9770
9771 =back
9772
9773 =head2 File::Spec::Functions - portably perform operations on file names
9774
9775 =over 4
9776
9777 =item SYNOPSIS
9778
9779 =item DESCRIPTION
9780
9781 =over 4
9782
9783 =item Exports
9784
9785 =back
9786
9787 =item SEE ALSO
9788
9789 =back
9790
9791 =head2 File::Spec::Mac - File::Spec for MacOS
9792
9793 =over 4
9794
9795 =item SYNOPSIS
9796
9797 =item DESCRIPTION
9798
9799 =item METHODS
9800
9801 canonpath
9802
9803 =back
9804
9805 catdir
9806
9807 catfile
9808
9809 curdir
9810
9811 devnull
9812
9813 rootdir
9814
9815 tmpdir
9816
9817 updir
9818
9819 file_name_is_absolute
9820
9821 path
9822
9823 splitpath
9824
9825 splitdir
9826
9827 catpath
9828
9829 abs2rel
9830
9831 rel2abs
9832
9833 =over 4
9834
9835 =item SEE ALSO
9836
9837 =back
9838
9839 =head2 File::Spec::OS2 - methods for OS/2 file specs
9840
9841 =over 4
9842
9843 =item SYNOPSIS
9844
9845 =item DESCRIPTION
9846
9847 =back
9848
9849 =head2 File::Spec::Unix - methods used by File::Spec
9850
9851 =over 4
9852
9853 =item SYNOPSIS
9854
9855 =item DESCRIPTION
9856
9857 =item METHODS
9858
9859 canonpath
9860
9861 =back
9862
9863 catdir
9864
9865 catfile
9866
9867 curdir
9868
9869 devnull
9870
9871 rootdir
9872
9873 tmpdir
9874
9875 updir
9876
9877 no_upwards
9878
9879 case_tolerant
9880
9881 file_name_is_absolute
9882
9883 path
9884
9885 join
9886
9887 splitpath
9888
9889 splitdir
9890
9891 catpath
9892
9893 abs2rel
9894
9895 rel2abs
9896
9897 =over 4
9898
9899 =item SEE ALSO
9900
9901 =back
9902
9903 =head2 File::Spec::VMS - methods for VMS file specs
9904
9905 =over 4
9906
9907 =item SYNOPSIS
9908
9909 =item DESCRIPTION
9910
9911 eliminate_macros
9912
9913 =back
9914
9915 fixpath
9916
9917 =over 4
9918
9919 =item Methods always loaded
9920
9921 canonpath (override)
9922
9923 =back
9924
9925 catdir
9926
9927 catfile
9928
9929 curdir (override)
9930
9931 devnull (override)
9932
9933 rootdir (override)
9934
9935 tmpdir (override)
9936
9937 updir (override)
9938
9939 case_tolerant (override)
9940
9941 path (override)
9942
9943 file_name_is_absolute (override)
9944
9945 splitpath (override)
9946
9947 splitdir (override)
9948
9949 catpath (override)
9950
9951 abs2rel (override)
9952
9953 rel2abs (override)
9954
9955 =over 4
9956
9957 =item SEE ALSO
9958
9959 =back
9960
9961 =head2 File::Spec::Win32 - methods for Win32 file specs
9962
9963 =over 4
9964
9965 =item SYNOPSIS
9966
9967 =item DESCRIPTION
9968
9969 devnull
9970
9971 =back
9972
9973 tmpdir
9974
9975 catfile
9976
9977 canonpath
9978
9979 splitpath
9980
9981 splitdir
9982
9983 catpath
9984
9985 =over 4
9986
9987 =item SEE ALSO
9988
9989 =back
9990
9991 =head2 File::Temp - return name and handle of a temporary file safely
9992
9993 =over 4
9994
9995 =item PORTABILITY
9996
9997 =item SYNOPSIS
9998
9999 =item DESCRIPTION
10000
10001 =back
10002
10003 =over 4
10004
10005 =item FUNCTIONS
10006
10007 B<tempfile>
10008
10009 =back
10010
10011 B<tempdir>
10012
10013 =over 4
10014
10015 =item MKTEMP FUNCTIONS
10016
10017 B<mkstemp>
10018
10019 =back
10020
10021 B<mkstemps>
10022
10023 B<mkdtemp>
10024
10025 B<mktemp>
10026
10027 =over 4
10028
10029 =item POSIX FUNCTIONS
10030
10031 B<tmpnam>
10032
10033 =back
10034
10035 B<tmpfile>
10036
10037 =over 4
10038
10039 =item ADDITIONAL FUNCTIONS
10040
10041 B<tempnam>
10042
10043 =back
10044
10045 =over 4
10046
10047 =item UTILITY FUNCTIONS
10048
10049 B<unlink0>
10050
10051 =back
10052
10053 =over 4
10054
10055 =item PACKAGE VARIABLES
10056
10057 B<safe_level>, STANDARD, MEDIUM, HIGH
10058
10059 =back
10060
10061 TopSystemUID
10062
10063 =over 4
10064
10065 =item WARNING
10066
10067 =over 4
10068
10069 =item Temporary files and NFS
10070
10071 =back
10072
10073 =item HISTORY
10074
10075 =item SEE ALSO
10076
10077 =item AUTHOR
10078
10079 =back
10080
10081 =head2 File::stat - by-name interface to Perl's built-in stat() functions
10082
10083 =over 4
10084
10085 =item SYNOPSIS
10086
10087 =item DESCRIPTION
10088
10089 =item NOTE
10090
10091 =item AUTHOR
10092
10093 =back
10094
10095 =head2 FileCache - keep more files open than the system permits
10096
10097 =over 4
10098
10099 =item SYNOPSIS
10100
10101 =item DESCRIPTION
10102
10103 =item BUGS
10104
10105 =back
10106
10107 =head2 FileHandle - supply object methods for filehandles
10108
10109 =over 4
10110
10111 =item SYNOPSIS
10112
10113 =item DESCRIPTION
10114
10115 $fh->print, $fh->printf, $fh->getline, $fh->getlines
10116
10117 =item SEE ALSO
10118
10119 =back
10120
10121 =head2 Filter::Simple - Simplified source filtering
10122
10123 =over 4
10124
10125 =item SYNOPSIS
10126
10127 =item DESCRIPTION
10128
10129 =over 4
10130
10131 =item The Problem
10132
10133 =item A Solution
10134
10135 =item How it works
10136
10137 =back
10138
10139 =item AUTHOR
10140
10141 =item COPYRIGHT
10142
10143 =back
10144
10145 =head2 Filter::Util::Call - Perl Source Filter Utility Module
10146
10147 =over 4
10148
10149 =item DESCRIPTION
10150
10151 =over 4
10152
10153 =item B<use Filter::Util::Call>
10154
10155 =item B<import()>
10156
10157 =item B<filter() and anonymous sub>
10158
10159 B<$_>, B<$status>, B<filter_read> and B<filter_read_exact>, B<filter_del>
10160
10161 =back
10162
10163 =item EXAMPLES
10164
10165 =over 4
10166
10167 =item Example 1: A simple filter.
10168
10169 =item Example 2: Using the context
10170
10171 =item Example 3: Using the context within the filter
10172
10173 =item Example 4: Using filter_del
10174
10175 =back
10176
10177 =item AUTHOR
10178
10179 =item DATE
10180
10181 =back
10182
10183 =head2 FindBin - Locate directory of original perl script
10184
10185 =over 4
10186
10187 =item SYNOPSIS
10188
10189 =item DESCRIPTION
10190
10191 =item EXPORTABLE VARIABLES
10192
10193 =item KNOWN BUGS
10194
10195 =item AUTHORS
10196
10197 =item COPYRIGHT
10198
10199 =back
10200
10201 =head2 GDBM_File - Perl5 access to the gdbm library.
10202
10203 =over 4
10204
10205 =item SYNOPSIS
10206
10207 =item DESCRIPTION
10208
10209 =item AVAILABILITY
10210
10211 =item BUGS
10212
10213 =item SEE ALSO
10214
10215 =back
10216
10217 =head2 Getopt::Long - Extended processing of command line options
10218
10219 =over 4
10220
10221 =item SYNOPSIS
10222
10223 =item DESCRIPTION
10224
10225 =item Command Line Options, an Introduction
10226
10227 =item Getting Started with Getopt::Long
10228
10229 =over 4
10230
10231 =item Simple options
10232
10233 =item A little bit less simple options
10234
10235 =item Mixing command line option with other arguments
10236
10237 =item Options with values
10238
10239 =item Options with multiple values
10240
10241 =item Options with hash values
10242
10243 =item User-defined subroutines to handle options
10244
10245 =item Options with multiple names
10246
10247 =item Case and abbreviations
10248
10249 =item Summary of Option Specifications
10250
10251 !, +, s, i, f, : I<type> [ I<desttype> ]
10252
10253 =back
10254
10255 =item Advanced Possibilities
10256
10257 =over 4
10258
10259 =item Object oriented interface
10260
10261 =item Documentation and help texts
10262
10263 =item Storing options in a hash
10264
10265 =item Bundling
10266
10267 =item The lonesome dash
10268
10269 =item Argument call-back
10270
10271 =back
10272
10273 =item Configuring Getopt::Long
10274
10275 default, posix_default, auto_abbrev, getopt_compat, gnu_compat, gnu_getopt,
10276 require_order, permute, bundling (default: disabled), bundling_override
10277 (default: disabled), ignore_case  (default: enabled), ignore_case_always
10278 (default: disabled), pass_through (default: disabled), prefix,
10279 prefix_pattern, debug (default: disabled)
10280
10281 =item Return values and Errors
10282
10283 =item Legacy
10284
10285 =over 4
10286
10287 =item Default destinations
10288
10289 =item Alternative option starters
10290
10291 =item Configuration variables
10292
10293 =back
10294
10295 =item Trouble Shooting
10296
10297 =over 4
10298
10299 =item Warning: Ignoring '!' modifier for short option
10300
10301 =item GetOptions does not return a false result when an option is not
10302 supplied
10303
10304 =back
10305
10306 =item AUTHOR
10307
10308 =item COPYRIGHT AND DISCLAIMER
10309
10310 =back
10311
10312 =head2 Getopt::Std, getopt - Process single-character switches with switch
10313 clustering
10314
10315 =over 4
10316
10317 =item SYNOPSIS
10318
10319 =item DESCRIPTION
10320
10321 =back
10322
10323 =head2 I18N::Collate - compare 8-bit scalar data according to the current
10324 locale
10325
10326 =over 4
10327
10328 =item SYNOPSIS
10329
10330 =item DESCRIPTION
10331
10332 =back
10333
10334 =head2 IO - load various IO modules
10335
10336 =over 4
10337
10338 =item SYNOPSIS
10339
10340 =item DESCRIPTION
10341
10342 =back
10343
10344 =head2 IO::Dir - supply object methods for directory handles
10345
10346 =over 4
10347
10348 =item SYNOPSIS
10349
10350 =item DESCRIPTION
10351
10352 new ( [ DIRNAME ] ), open ( DIRNAME ), read (), seek ( POS ), tell (),
10353 rewind (), close (), tie %hash, IO::Dir, DIRNAME [, OPTIONS ]
10354
10355 =item SEE ALSO
10356
10357 =item AUTHOR
10358
10359 =item COPYRIGHT
10360
10361 =back
10362
10363 =head2 IO::File - supply object methods for filehandles
10364
10365 =over 4
10366
10367 =item SYNOPSIS
10368
10369 =item DESCRIPTION
10370
10371 =item CONSTRUCTOR
10372
10373 new ( FILENAME [,MODE [,PERMS]] ), new_tmpfile
10374
10375 =item METHODS
10376
10377 open( FILENAME [,MODE [,PERMS]] )
10378
10379 =item SEE ALSO
10380
10381 =item HISTORY
10382
10383 =back
10384
10385 =head2 IO::Handle - supply object methods for I/O handles
10386
10387 =over 4
10388
10389 =item SYNOPSIS
10390
10391 =item DESCRIPTION
10392
10393 =item CONSTRUCTOR
10394
10395 new (), new_from_fd ( FD, MODE )
10396
10397 =item METHODS
10398
10399 $io->fdopen ( FD, MODE ), $io->opened, $io->getline, $io->getlines,
10400 $io->ungetc ( ORD ), $io->write ( BUF, LEN [, OFFSET ] ), $io->error,
10401 $io->clearerr, $io->sync, $io->flush, $io->printflush ( ARGS ),
10402 $io->blocking ( [ BOOL ] ), $io->untaint
10403
10404 =item NOTE
10405
10406 =item SEE ALSO
10407
10408 =item BUGS
10409
10410 =item HISTORY
10411
10412 =back
10413
10414 =head2 IO::Pipe - supply object methods for pipes
10415
10416 =over 4
10417
10418 =item SYNOPSIS
10419
10420 =item DESCRIPTION
10421
10422 =item CONSTRUCTOR
10423
10424 new ( [READER, WRITER] )
10425
10426 =item METHODS
10427
10428 reader ([ARGS]), writer ([ARGS]), handles ()
10429
10430 =item SEE ALSO
10431
10432 =item AUTHOR
10433
10434 =item COPYRIGHT
10435
10436 =back
10437
10438 =head2 IO::Poll - Object interface to system poll call
10439
10440 =over 4
10441
10442 =item SYNOPSIS
10443
10444 =item DESCRIPTION
10445
10446 =item METHODS
10447
10448 mask ( IO [, EVENT_MASK ] ), poll ( [ TIMEOUT ] ), events ( IO ), remove (
10449 IO ), handles( [ EVENT_MASK ] )
10450
10451 =item SEE ALSO
10452
10453 =item AUTHOR
10454
10455 =item COPYRIGHT
10456
10457 =back
10458
10459 =head2 IO::Seekable - supply seek based methods for I/O objects
10460
10461 =over 4
10462
10463 =item SYNOPSIS
10464
10465 =item DESCRIPTION
10466
10467 $io->getpos, $io->setpos, $io->setpos ( POS, WHENCE ), WHENCE=0 (SEEK_SET),
10468 WHENCE=1 (SEEK_CUR), WHENCE=1 (SEEK_END), $io->sysseek( POS, WHENCE ),
10469 $io->tell
10470
10471 =item HISTORY
10472
10473 =back
10474
10475 =head2 IO::Select - OO interface to the select system call
10476
10477 =over 4
10478
10479 =item SYNOPSIS
10480
10481 =item DESCRIPTION
10482
10483 =item CONSTRUCTOR
10484
10485 new ( [ HANDLES ] )
10486
10487 =item METHODS
10488
10489 add ( HANDLES ), remove ( HANDLES ), exists ( HANDLE ), handles, can_read (
10490 [ TIMEOUT ] ), can_write ( [ TIMEOUT ] ), has_exception ( [ TIMEOUT ] ),
10491 count (), bits(), select ( READ, WRITE, ERROR [, TIMEOUT ] )
10492
10493 =item EXAMPLE
10494
10495 =item AUTHOR
10496
10497 =item COPYRIGHT
10498
10499 =back
10500
10501 =head2 IO::Socket - Object interface to socket communications
10502
10503 =over 4
10504
10505 =item SYNOPSIS
10506
10507 =item DESCRIPTION
10508
10509 =item CONSTRUCTOR
10510
10511 new ( [ARGS] )
10512
10513 =item METHODS
10514
10515 accept([PKG]), socketpair(DOMAIN, TYPE, PROTOCOL), timeout([VAL]),
10516 sockopt(OPT [, VAL]), sockdomain, socktype, protocol, connected
10517
10518 =item SEE ALSO
10519
10520 =item AUTHOR
10521
10522 =item COPYRIGHT
10523
10524 =back
10525
10526 =head2 IO::Socket::INET - Object interface for AF_INET domain sockets
10527
10528 =over 4
10529
10530 =item SYNOPSIS
10531
10532 =item DESCRIPTION
10533
10534 =item CONSTRUCTOR
10535
10536 new ( [ARGS] )
10537
10538 =over 4
10539
10540 =item METHODS
10541
10542 sockaddr (), sockport (), sockhost (), peeraddr (), peerport (), peerhost
10543 ()
10544
10545 =back
10546
10547 =item SEE ALSO
10548
10549 =item AUTHOR
10550
10551 =item COPYRIGHT
10552
10553 =back
10554
10555 =head2 IO::Socket::UNIX - Object interface for AF_UNIX domain sockets
10556
10557 =over 4
10558
10559 =item SYNOPSIS
10560
10561 =item DESCRIPTION
10562
10563 =item CONSTRUCTOR
10564
10565 new ( [ARGS] )
10566
10567 =item METHODS
10568
10569 hostpath(), peerpath()
10570
10571 =item SEE ALSO
10572
10573 =item AUTHOR
10574
10575 =item COPYRIGHT
10576
10577 =back
10578
10579 =head2 IO::lib::IO::Dir, IO::Dir - supply object methods for directory
10580 handles
10581
10582 =over 4
10583
10584 =item SYNOPSIS
10585
10586 =item DESCRIPTION
10587
10588 new ( [ DIRNAME ] ), open ( DIRNAME ), read (), seek ( POS ), tell (),
10589 rewind (), close (), tie %hash, IO::Dir, DIRNAME [, OPTIONS ]
10590
10591 =item SEE ALSO
10592
10593 =item AUTHOR
10594
10595 =item COPYRIGHT
10596
10597 =back
10598
10599 =head2 IO::lib::IO::File, IO::File - supply object methods for filehandles
10600
10601 =over 4
10602
10603 =item SYNOPSIS
10604
10605 =item DESCRIPTION
10606
10607 =item CONSTRUCTOR
10608
10609 new ( FILENAME [,MODE [,PERMS]] ), new_tmpfile
10610
10611 =item METHODS
10612
10613 open( FILENAME [,MODE [,PERMS]] )
10614
10615 =item SEE ALSO
10616
10617 =item HISTORY
10618
10619 =back
10620
10621 =head2 IO::lib::IO::Handle, IO::Handle - supply object methods for I/O
10622 handles
10623
10624 =over 4
10625
10626 =item SYNOPSIS
10627
10628 =item DESCRIPTION
10629
10630 =item CONSTRUCTOR
10631
10632 new (), new_from_fd ( FD, MODE )
10633
10634 =item METHODS
10635
10636 $io->fdopen ( FD, MODE ), $io->opened, $io->getline, $io->getlines,
10637 $io->ungetc ( ORD ), $io->write ( BUF, LEN [, OFFSET ] ), $io->error,
10638 $io->clearerr, $io->sync, $io->flush, $io->printflush ( ARGS ),
10639 $io->blocking ( [ BOOL ] ), $io->untaint
10640
10641 =item NOTE
10642
10643 =item SEE ALSO
10644
10645 =item BUGS
10646
10647 =item HISTORY
10648
10649 =back
10650
10651 =head2 IO::lib::IO::Pipe, IO::Pipe - supply object methods for pipes
10652
10653 =over 4
10654
10655 =item SYNOPSIS
10656
10657 =item DESCRIPTION
10658
10659 =item CONSTRUCTOR
10660
10661 new ( [READER, WRITER] )
10662
10663 =item METHODS
10664
10665 reader ([ARGS]), writer ([ARGS]), handles ()
10666
10667 =item SEE ALSO
10668
10669 =item AUTHOR
10670
10671 =item COPYRIGHT
10672
10673 =back
10674
10675 =head2 IO::lib::IO::Poll, IO::Poll - Object interface to system poll call
10676
10677 =over 4
10678
10679 =item SYNOPSIS
10680
10681 =item DESCRIPTION
10682
10683 =item METHODS
10684
10685 mask ( IO [, EVENT_MASK ] ), poll ( [ TIMEOUT ] ), events ( IO ), remove (
10686 IO ), handles( [ EVENT_MASK ] )
10687
10688 =item SEE ALSO
10689
10690 =item AUTHOR
10691
10692 =item COPYRIGHT
10693
10694 =back
10695
10696 =head2 IO::lib::IO::Seekable, IO::Seekable - supply seek based methods for
10697 I/O objects
10698
10699 =over 4
10700
10701 =item SYNOPSIS
10702
10703 =item DESCRIPTION
10704
10705 $io->getpos, $io->setpos, $io->setpos ( POS, WHENCE ), WHENCE=0 (SEEK_SET),
10706 WHENCE=1 (SEEK_CUR), WHENCE=1 (SEEK_END), $io->sysseek( POS, WHENCE ),
10707 $io->tell
10708
10709 =item HISTORY
10710
10711 =back
10712
10713 =head2 IO::lib::IO::Select, IO::Select - OO interface to the select system
10714 call
10715
10716 =over 4
10717
10718 =item SYNOPSIS
10719
10720 =item DESCRIPTION
10721
10722 =item CONSTRUCTOR
10723
10724 new ( [ HANDLES ] )
10725
10726 =item METHODS
10727
10728 add ( HANDLES ), remove ( HANDLES ), exists ( HANDLE ), handles, can_read (
10729 [ TIMEOUT ] ), can_write ( [ TIMEOUT ] ), has_exception ( [ TIMEOUT ] ),
10730 count (), bits(), select ( READ, WRITE, ERROR [, TIMEOUT ] )
10731
10732 =item EXAMPLE
10733
10734 =item AUTHOR
10735
10736 =item COPYRIGHT
10737
10738 =back
10739
10740 =head2 IO::lib::IO::Socket, IO::Socket - Object interface to socket
10741 communications
10742
10743 =over 4
10744
10745 =item SYNOPSIS
10746
10747 =item DESCRIPTION
10748
10749 =item CONSTRUCTOR
10750
10751 new ( [ARGS] )
10752
10753 =item METHODS
10754
10755 accept([PKG]), socketpair(DOMAIN, TYPE, PROTOCOL), timeout([VAL]),
10756 sockopt(OPT [, VAL]), sockdomain, socktype, protocol, connected
10757
10758 =item SEE ALSO
10759
10760 =item AUTHOR
10761
10762 =item COPYRIGHT
10763
10764 =back
10765
10766 =head2 IO::lib::IO::Socket::INET, IO::Socket::INET - Object interface for
10767 AF_INET domain sockets
10768
10769 =over 4
10770
10771 =item SYNOPSIS
10772
10773 =item DESCRIPTION
10774
10775 =item CONSTRUCTOR
10776
10777 new ( [ARGS] )
10778
10779 =over 4
10780
10781 =item METHODS
10782
10783 sockaddr (), sockport (), sockhost (), peeraddr (), peerport (), peerhost
10784 ()
10785
10786 =back
10787
10788 =item SEE ALSO
10789
10790 =item AUTHOR
10791
10792 =item COPYRIGHT
10793
10794 =back
10795
10796 =head2 IO::lib::IO::Socket::UNIX, IO::Socket::UNIX - Object interface for
10797 AF_UNIX domain sockets
10798
10799 =over 4
10800
10801 =item SYNOPSIS
10802
10803 =item DESCRIPTION
10804
10805 =item CONSTRUCTOR
10806
10807 new ( [ARGS] )
10808
10809 =item METHODS
10810
10811 hostpath(), peerpath()
10812
10813 =item SEE ALSO
10814
10815 =item AUTHOR
10816
10817 =item COPYRIGHT
10818
10819 =back
10820
10821 =head2 IPC::Msg - SysV Msg IPC object class
10822
10823 =over 4
10824
10825 =item SYNOPSIS
10826
10827 =item DESCRIPTION
10828
10829 =item METHODS
10830
10831 new ( KEY , FLAGS ), id, rcv ( BUF, LEN [, TYPE [, FLAGS ]] ), remove, set
10832 ( STAT ), set ( NAME => VALUE [, NAME => VALUE ...] ), snd ( TYPE, MSG [,
10833 FLAGS ] ), stat
10834
10835 =item SEE ALSO
10836
10837 =item AUTHOR
10838
10839 =item COPYRIGHT
10840
10841 =back
10842
10843 =head2 IPC::Open2, open2 - open a process for both reading and writing
10844
10845 =over 4
10846
10847 =item SYNOPSIS
10848
10849 =item DESCRIPTION
10850
10851 =item WARNING
10852
10853 =item SEE ALSO
10854
10855 =back
10856
10857 =head2 IPC::Open3, open3 - open a process for reading, writing, and error
10858 handling
10859
10860 =over 4
10861
10862 =item SYNOPSIS
10863
10864 =item DESCRIPTION
10865
10866 =item WARNING
10867
10868 =back
10869
10870 =head2 IPC::Semaphore - SysV Semaphore IPC object class
10871
10872 =over 4
10873
10874 =item SYNOPSIS
10875
10876 =item DESCRIPTION
10877
10878 =item METHODS
10879
10880 new ( KEY , NSEMS , FLAGS ), getall, getncnt ( SEM ), getpid ( SEM ),
10881 getval ( SEM ), getzcnt ( SEM ), id, op ( OPLIST ), remove, set ( STAT ),
10882 set ( NAME => VALUE [, NAME => VALUE ...] ), setall ( VALUES ), setval ( N
10883 , VALUE ), stat
10884
10885 =item SEE ALSO
10886
10887 =item AUTHOR
10888
10889 =item COPYRIGHT
10890
10891 =back
10892
10893 =head2 IPC::SysV - SysV IPC constants
10894
10895 =over 4
10896
10897 =item SYNOPSIS
10898
10899 =item DESCRIPTION
10900
10901 ftok( PATH, ID )
10902
10903 =item SEE ALSO
10904
10905 =item AUTHORS
10906
10907 =item COPYRIGHT
10908
10909 =back
10910
10911 =head2 IPC::SysV::Msg, IPC::Msg - SysV Msg IPC object class
10912
10913 =over 4
10914
10915 =item SYNOPSIS
10916
10917 =item DESCRIPTION
10918
10919 =item METHODS
10920
10921 new ( KEY , FLAGS ), id, rcv ( BUF, LEN [, TYPE [, FLAGS ]] ), remove, set
10922 ( STAT ), set ( NAME => VALUE [, NAME => VALUE ...] ), snd ( TYPE, MSG [,
10923 FLAGS ] ), stat
10924
10925 =item SEE ALSO
10926
10927 =item AUTHOR
10928
10929 =item COPYRIGHT
10930
10931 =back
10932
10933 =head2 IPC::SysV::Semaphore, IPC::Semaphore - SysV Semaphore IPC object
10934 class
10935
10936 =over 4
10937
10938 =item SYNOPSIS
10939
10940 =item DESCRIPTION
10941
10942 =item METHODS
10943
10944 new ( KEY , NSEMS , FLAGS ), getall, getncnt ( SEM ), getpid ( SEM ),
10945 getval ( SEM ), getzcnt ( SEM ), id, op ( OPLIST ), remove, set ( STAT ),
10946 set ( NAME => VALUE [, NAME => VALUE ...] ), setall ( VALUES ), setval ( N
10947 , VALUE ), stat
10948
10949 =item SEE ALSO
10950
10951 =item AUTHOR
10952
10953 =item COPYRIGHT
10954
10955 =back
10956
10957 =head2 Math::BigFloat - Arbitrary length float math package
10958
10959 =over 4
10960
10961 =item SYNOPSIS
10962
10963 =item DESCRIPTION
10964
10965 number format, Error returns 'NaN', Division is computed to, Rounding is
10966 performed
10967
10968 =item BUGS
10969
10970 =item AUTHOR
10971
10972 =back
10973
10974 =head2 Math::BigInt - Arbitrary size integer math package
10975
10976 =over 4
10977
10978 =item SYNOPSIS
10979
10980 =item DESCRIPTION
10981
10982 Canonical notation, Input, Output
10983
10984 =item EXAMPLES
10985
10986 =item Autocreating constants
10987
10988 =item BUGS
10989
10990 =item AUTHOR
10991
10992 =back
10993
10994 =head2 Math::Complex - complex numbers and associated mathematical
10995 functions
10996
10997 =over 4
10998
10999 =item SYNOPSIS
11000
11001 =item DESCRIPTION
11002
11003 =item OPERATIONS
11004
11005 =item CREATION
11006
11007 =item STRINGIFICATION
11008
11009 =over 4
11010
11011 =item CHANGED IN PERL 5.6
11012
11013 =back
11014
11015 =item USAGE
11016
11017 =item ERRORS DUE TO DIVISION BY ZERO OR LOGARITHM OF ZERO
11018
11019 =item ERRORS DUE TO INDIGESTIBLE ARGUMENTS
11020
11021 =item BUGS
11022
11023 =item AUTHORS
11024
11025 =back
11026
11027 =head2 Math::Trig - trigonometric functions
11028
11029 =over 4
11030
11031 =item SYNOPSIS
11032
11033 =item DESCRIPTION
11034
11035 =item TRIGONOMETRIC FUNCTIONS
11036
11037 B<tan>
11038
11039 =over 4
11040
11041 =item ERRORS DUE TO DIVISION BY ZERO
11042
11043 =item SIMPLE (REAL) ARGUMENTS, COMPLEX RESULTS
11044
11045 =back
11046
11047 =item PLANE ANGLE CONVERSIONS
11048
11049 =item RADIAL COORDINATE CONVERSIONS
11050
11051 =over 4
11052
11053 =item COORDINATE SYSTEMS
11054
11055 =item 3-D ANGLE CONVERSIONS
11056
11057 cartesian_to_cylindrical, cartesian_to_spherical, cylindrical_to_cartesian,
11058 cylindrical_to_spherical, spherical_to_cartesian, spherical_to_cylindrical
11059
11060 =back
11061
11062 =item GREAT CIRCLE DISTANCES
11063
11064 =item EXAMPLES
11065
11066 =item BUGS
11067
11068 =item AUTHORS
11069
11070 =back
11071
11072 =head2 NDBM_File - Tied access to ndbm files
11073
11074 =over 4
11075
11076 =item SYNOPSIS
11077
11078 C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR>
11079
11080 =item DIAGNOSTICS
11081
11082 =over 4
11083
11084 =item C<ndbm store returned -1, errno 22, key "..." at ...>
11085
11086 =back
11087
11088 =item BUGS AND WARNINGS
11089
11090 =back
11091
11092 =head2 Net::Ping - check a remote host for reachability
11093
11094 =over 4
11095
11096 =item SYNOPSIS
11097
11098 =item DESCRIPTION
11099
11100 =over 4
11101
11102 =item Functions
11103
11104 Net::Ping->new([$proto [, $def_timeout [, $bytes]]]);, $p->ping($host [,
11105 $timeout]);, $p->close();, pingecho($host [, $timeout]);
11106
11107 =back
11108
11109 =item WARNING
11110
11111 =item NOTES
11112
11113 =back
11114
11115 =head2 Net::hostent - by-name interface to Perl's built-in gethost*()
11116 functions
11117
11118 =over 4
11119
11120 =item SYNOPSIS
11121
11122 =item DESCRIPTION
11123
11124 =item EXAMPLES
11125
11126 =item NOTE
11127
11128 =item AUTHOR
11129
11130 =back
11131
11132 =head2 Net::netent - by-name interface to Perl's built-in getnet*()
11133 functions
11134
11135 =over 4
11136
11137 =item SYNOPSIS
11138
11139 =item DESCRIPTION
11140
11141 =item EXAMPLES
11142
11143 =item NOTE
11144
11145 =item AUTHOR
11146
11147 =back
11148
11149 =head2 Net::protoent - by-name interface to Perl's built-in getproto*()
11150 functions
11151
11152 =over 4
11153
11154 =item SYNOPSIS
11155
11156 =item DESCRIPTION
11157
11158 =item NOTE
11159
11160 =item AUTHOR
11161
11162 =back
11163
11164 =head2 Net::servent - by-name interface to Perl's built-in getserv*()
11165 functions
11166
11167 =over 4
11168
11169 =item SYNOPSIS
11170
11171 =item DESCRIPTION
11172
11173 =item EXAMPLES
11174
11175 =item NOTE
11176
11177 =item AUTHOR
11178
11179 =back
11180
11181 =head2 O - Generic interface to Perl Compiler backends
11182
11183 =over 4
11184
11185 =item SYNOPSIS
11186
11187 =item DESCRIPTION
11188
11189 =item CONVENTIONS
11190
11191 =item IMPLEMENTATION
11192
11193 =item AUTHOR
11194
11195 =back
11196
11197 =head2 ODBM_File - Tied access to odbm files
11198
11199 =over 4
11200
11201 =item SYNOPSIS
11202
11203 C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR>
11204
11205 =item DIAGNOSTICS
11206
11207 =over 4
11208
11209 =item C<odbm store returned -1, errno 22, key "..." at ...>
11210
11211 =back
11212
11213 =item BUGS AND WARNINGS
11214
11215 =back
11216
11217 =head2 Opcode - Disable named opcodes when compiling perl code
11218
11219 =over 4
11220
11221 =item SYNOPSIS
11222
11223 =item DESCRIPTION
11224
11225 =item NOTE
11226
11227 =item WARNING
11228
11229 =item Operator Names and Operator Lists
11230
11231 an operator name (opname), an operator tag name (optag), a negated opname
11232 or optag, an operator set (opset)
11233
11234 =item Opcode Functions
11235
11236 opcodes, opset (OP, ...), opset_to_ops (OPSET), opset_to_hex (OPSET),
11237 full_opset, empty_opset, invert_opset (OPSET), verify_opset (OPSET, ...),
11238 define_optag (OPTAG, OPSET), opmask_add (OPSET), opmask, opdesc (OP, ...),
11239 opdump (PAT)
11240
11241 =item Manipulating Opsets
11242
11243 =item TO DO (maybe)
11244
11245 =back
11246
11247 =over 4
11248
11249 =item Predefined Opcode Tags
11250
11251 :base_core, :base_mem, :base_loop, :base_io, :base_orig, :base_math,
11252 :base_thread, :default, :filesys_read, :sys_db, :browse, :filesys_open,
11253 :filesys_write, :subprocess, :ownprocess, :others, :still_to_be_decided,
11254 :dangerous
11255
11256 =item SEE ALSO
11257
11258 =item AUTHORS
11259
11260 =back
11261
11262 =head2 Opcode::Safe, Safe - Compile and execute code in restricted
11263 compartments
11264
11265 =over 4
11266
11267 =item SYNOPSIS
11268
11269 =item DESCRIPTION
11270
11271 a new namespace, an operator mask
11272
11273 =item WARNING
11274
11275 =over 4
11276
11277 =item RECENT CHANGES
11278
11279 =item Methods in class Safe
11280
11281 permit (OP, ...), permit_only (OP, ...), deny (OP, ...), deny_only (OP,
11282 ...), trap (OP, ...), untrap (OP, ...), share (NAME, ...), share_from
11283 (PACKAGE, ARRAYREF), varglob (VARNAME), reval (STRING), rdo (FILENAME),
11284 root (NAMESPACE), mask (MASK)
11285
11286 =item Some Safety Issues
11287
11288 Memory, CPU, Snooping, Signals, State Changes
11289
11290 =item AUTHOR
11291
11292 =back
11293
11294 =back
11295
11296 =head2 Opcode::ops, ops - Perl pragma to restrict unsafe operations when
11297 compiling
11298
11299 =over 4
11300
11301 =item SYNOPSIS
11302
11303 =item DESCRIPTION
11304
11305 =item SEE ALSO
11306
11307 =back
11308
11309 =head2 POSIX - Perl interface to IEEE Std 1003.1
11310
11311 =over 4
11312
11313 =item SYNOPSIS
11314
11315 =item DESCRIPTION
11316
11317 =item NOTE
11318
11319 =item CAVEATS
11320
11321 =item FUNCTIONS
11322
11323 _exit, abort, abs, access, acos, alarm, asctime, asin, assert, atan, atan2,
11324 atexit, atof, atoi, atol, bsearch, calloc, ceil, chdir, chmod, chown,
11325 clearerr, clock, close, closedir, cos, cosh, creat, ctermid, ctime,
11326 cuserid, difftime, div, dup, dup2, errno, execl, execle, execlp, execv,
11327 execve, execvp, exit, exp, fabs, fclose, fcntl, fdopen, feof, ferror,
11328 fflush, fgetc, fgetpos, fgets, fileno, floor, fmod, fopen, fork, fpathconf,
11329 fprintf, fputc, fputs, fread, free, freopen, frexp, fscanf, fseek, fsetpos,
11330 fstat, ftell, fwrite, getc, getchar, getcwd, getegid, getenv, geteuid,
11331 getgid, getgrgid, getgrnam, getgroups, getlogin, getpgrp, getpid, getppid,
11332 getpwnam, getpwuid, gets, getuid, gmtime, isalnum, isalpha, isatty,
11333 iscntrl, isdigit, isgraph, islower, isprint, ispunct, isspace, isupper,
11334 isxdigit, kill, labs, ldexp, ldiv, link, localeconv, localtime, log, log10,
11335 longjmp, lseek, malloc, mblen, mbstowcs, mbtowc, memchr, memcmp, memcpy,
11336 memmove, memset, mkdir, mkfifo, mktime, modf, nice, offsetof, open,
11337 opendir, pathconf, pause, perror, pipe, pow, printf, putc, putchar, puts,
11338 qsort, raise, rand, read, readdir, realloc, remove, rename, rewind,
11339 rewinddir, rmdir, scanf, setgid, setjmp, setlocale, setpgid, setsid,
11340 setuid, sigaction, siglongjmp, sigpending, sigprocmask, sigsetjmp,
11341 sigsuspend, sin, sinh, sleep, sprintf, sqrt, srand, sscanf, stat, strcat,
11342 strchr, strcmp, strcoll, strcpy, strcspn, strerror, strftime, strlen,
11343 strncat, strncmp, strncpy, strpbrk, strrchr, strspn, strstr, strtod,
11344 strtok, strtol, strtoul, strxfrm, sysconf, system, tan, tanh, tcdrain,
11345 tcflow, tcflush, tcgetpgrp, tcsendbreak, tcsetpgrp, time, times, tmpfile,
11346 tmpnam, tolower, toupper, ttyname, tzname, tzset, umask, uname, ungetc,
11347 unlink, utime, vfprintf, vprintf, vsprintf, wait, waitpid, wcstombs,
11348 wctomb, write
11349
11350 =item CLASSES
11351
11352 =over 4
11353
11354 =item POSIX::SigAction
11355
11356 new
11357
11358 =item POSIX::SigSet
11359
11360 new, addset, delset, emptyset, fillset, ismember
11361
11362 =item POSIX::Termios
11363
11364 new, getattr, getcc, getcflag, getiflag, getispeed, getlflag, getoflag,
11365 getospeed, setattr, setcc, setcflag, setiflag, setispeed, setlflag,
11366 setoflag, setospeed, Baud rate values, Terminal interface values, c_cc
11367 field values, c_cflag field values, c_iflag field values, c_lflag field
11368 values, c_oflag field values
11369
11370 =back
11371
11372 =item PATHNAME CONSTANTS
11373
11374 Constants
11375
11376 =item POSIX CONSTANTS
11377
11378 Constants
11379
11380 =item SYSTEM CONFIGURATION
11381
11382 Constants
11383
11384 =item ERRNO
11385
11386 Constants
11387
11388 =item FCNTL
11389
11390 Constants
11391
11392 =item FLOAT
11393
11394 Constants
11395
11396 =item LIMITS
11397
11398 Constants
11399
11400 =item LOCALE
11401
11402 Constants
11403
11404 =item MATH
11405
11406 Constants
11407
11408 =item SIGNAL
11409
11410 Constants
11411
11412 =item STAT
11413
11414 Constants, Macros
11415
11416 =item STDLIB
11417
11418 Constants
11419
11420 =item STDIO
11421
11422 Constants
11423
11424 =item TIME
11425
11426 Constants
11427
11428 =item UNISTD
11429
11430 Constants
11431
11432 =item WAIT
11433
11434 Constants, Macros
11435
11436 =back
11437
11438 =head2 Pod::Checker, podchecker() - check pod documents for syntax errors
11439
11440 =over 4
11441
11442 =item SYNOPSIS
11443
11444 =item OPTIONS/ARGUMENTS
11445
11446 =over 4
11447
11448 =item podchecker()
11449
11450 B<-warnings> =E<gt> I<val>
11451
11452 =back
11453
11454 =item DESCRIPTION
11455
11456 =item DIAGNOSTICS
11457
11458 =over 4
11459
11460 =item Errors
11461
11462 empty =headn, =over on line I<N> without closing =back, =item without
11463 previous =over, =back without previous =over, No argument for =begin, =end
11464 without =begin, Nested =begin's, =for without formatter specification,
11465 unresolved internal link I<NAME>, Unknown command "I<CMD>", Unknown
11466 interior-sequence "I<SEQ>", nested commands
11467 I<CMD>E<lt>...I<CMD>E<lt>...E<gt>...E<gt>, garbled entity I<STRING>, Entity
11468 number out of range, malformed link LE<lt>E<gt>, nonempty ZE<lt>E<gt>,
11469 empty XE<lt>E<gt>, Spurious text after =pod / =cut, Spurious character(s)
11470 after =back
11471
11472 =item Warnings
11473
11474 multiple occurence of link target I<name>, line containing nothing but
11475 whitespace in paragraph, file does not start with =head, No numeric
11476 argument for =over, previous =item has no contents, preceding non-item
11477 paragraph(s), =item type mismatch (I<one> vs. I<two>), I<N> unescaped
11478 C<E<lt>E<gt>> in paragraph, Unknown entity, No items in =over, No argument
11479 for =item, empty section in previous paragraph, Verbatim paragraph in NAME
11480 section
11481
11482 =item Hyperlinks
11483
11484 collapsing newlines to blanks, ignoring leading/trailing whitespace in
11485 link, (section) in '$page' deprecated, alternative text/node '%s' contains
11486 non-escaped | or /
11487
11488 =back
11489
11490 =item RETURN VALUE
11491
11492 =item EXAMPLES
11493
11494 =item INTERFACE
11495
11496 =back
11497
11498 C<Pod::Checker-E<gt>new( %options )>
11499
11500 C<$checker-E<gt>poderror( @args )>, C<$checker-E<gt>poderror( {%opts},
11501 @args )>
11502
11503 C<$checker-E<gt>num_errors()>
11504
11505 C<$checker-E<gt>name()>
11506
11507 C<$checker-E<gt>node()>
11508
11509 C<$checker-E<gt>idx()>
11510
11511 C<$checker-E<gt>hyperlink()>
11512
11513 =over 4
11514
11515 =item AUTHOR
11516
11517 =back
11518
11519 =head2 Pod::Find - find POD documents in directory trees
11520
11521 =over 4
11522
11523 =item SYNOPSIS
11524
11525 =item DESCRIPTION
11526
11527 =back
11528
11529 =over 4
11530
11531 =item C<pod_find( { %opts } , @directories )>
11532
11533 C<-verbose =E<gt> 1>, C<-perl =E<gt> 1>, C<-script =E<gt> 1>, C<-inc =E<gt>
11534 1>
11535
11536 =back
11537
11538 =over 4
11539
11540 =item C<simplify_name( $str )>
11541
11542 =back
11543
11544 =over 4
11545
11546 =item C<pod_where( { %opts }, $pod )>
11547
11548 C<-inc =E<gt> 1>, C<-dirs =E<gt> [ $dir1, $dir2, ... ]>, C<-verbose =E<gt>
11549 1>
11550
11551 =back
11552
11553 =over 4
11554
11555 =item C<contains_pod( $file , $verbose )>
11556
11557 =back
11558
11559 =over 4
11560
11561 =item AUTHOR
11562
11563 =item SEE ALSO
11564
11565 =back
11566
11567 =head2 Pod::Html - module to convert pod files to HTML
11568
11569 =over 4
11570
11571 =item SYNOPSIS
11572
11573 =item DESCRIPTION
11574
11575 =item ARGUMENTS
11576
11577 backlink, css, flush, header, help, htmldir, htmlroot, index, infile,
11578 libpods, netscape, outfile, podpath, podroot, quiet, recurse, title,
11579 verbose
11580
11581 =item EXAMPLE
11582
11583 =item ENVIRONMENT
11584
11585 =item AUTHOR
11586
11587 =item SEE ALSO
11588
11589 =item COPYRIGHT
11590
11591 =back
11592
11593 =head2 Pod::InputObjects - objects representing POD input paragraphs,
11594 commands, etc.
11595
11596 =over 4
11597
11598 =item SYNOPSIS
11599
11600 =item REQUIRES
11601
11602 =item EXPORTS
11603
11604 =item DESCRIPTION
11605
11606 package B<Pod::InputSource>, package B<Pod::Paragraph>, package
11607 B<Pod::InteriorSequence>, package B<Pod::ParseTree>
11608
11609 =back
11610
11611 =over 4
11612
11613 =item B<Pod::InputSource>
11614
11615 =back
11616
11617 =over 4
11618
11619 =item B<new()>
11620
11621 =back
11622
11623 =over 4
11624
11625 =item B<name()>
11626
11627 =back
11628
11629 =over 4
11630
11631 =item B<handle()>
11632
11633 =back
11634
11635 =over 4
11636
11637 =item B<was_cutting()>
11638
11639 =back
11640
11641 =over 4
11642
11643 =item B<Pod::Paragraph>
11644
11645 =back
11646
11647 =over 4
11648
11649 =item Pod::Paragraph-E<gt>B<new()>
11650
11651 =back
11652
11653 =over 4
11654
11655 =item $pod_para-E<gt>B<cmd_name()>
11656
11657 =back
11658
11659 =over 4
11660
11661 =item $pod_para-E<gt>B<text()>
11662
11663 =back
11664
11665 =over 4
11666
11667 =item $pod_para-E<gt>B<raw_text()>
11668
11669 =back
11670
11671 =over 4
11672
11673 =item $pod_para-E<gt>B<cmd_prefix()>
11674
11675 =back
11676
11677 =over 4
11678
11679 =item $pod_para-E<gt>B<cmd_separator()>
11680
11681 =back
11682
11683 =over 4
11684
11685 =item $pod_para-E<gt>B<parse_tree()>
11686
11687 =back
11688
11689 =over 4
11690
11691 =item $pod_para-E<gt>B<file_line()>
11692
11693 =back
11694
11695 =over 4
11696
11697 =item B<Pod::InteriorSequence>
11698
11699 =back
11700
11701 =over 4
11702
11703 =item Pod::InteriorSequence-E<gt>B<new()>
11704
11705 =back
11706
11707 =over 4
11708
11709 =item $pod_seq-E<gt>B<cmd_name()>
11710
11711 =back
11712
11713 =over 4
11714
11715 =item $pod_seq-E<gt>B<prepend()>
11716
11717 =back
11718
11719 =over 4
11720
11721 =item $pod_seq-E<gt>B<append()>
11722
11723 =back
11724
11725 =over 4
11726
11727 =item $pod_seq-E<gt>B<nested()>
11728
11729 =back
11730
11731 =over 4
11732
11733 =item $pod_seq-E<gt>B<raw_text()>
11734
11735 =back
11736
11737 =over 4
11738
11739 =item $pod_seq-E<gt>B<left_delimiter()>
11740
11741 =back
11742
11743 =over 4
11744
11745 =item $pod_seq-E<gt>B<right_delimiter()>
11746
11747 =back
11748
11749 =over 4
11750
11751 =item $pod_seq-E<gt>B<parse_tree()>
11752
11753 =back
11754
11755 =over 4
11756
11757 =item $pod_seq-E<gt>B<file_line()>
11758
11759 =back
11760
11761 =over 4
11762
11763 =item Pod::InteriorSequence::B<DESTROY()>
11764
11765 =back
11766
11767 =over 4
11768
11769 =item B<Pod::ParseTree>
11770
11771 =back
11772
11773 =over 4
11774
11775 =item Pod::ParseTree-E<gt>B<new()>
11776
11777 =back
11778
11779 =over 4
11780
11781 =item $ptree-E<gt>B<top()>
11782
11783 =back
11784
11785 =over 4
11786
11787 =item $ptree-E<gt>B<children()>
11788
11789 =back
11790
11791 =over 4
11792
11793 =item $ptree-E<gt>B<prepend()>
11794
11795 =back
11796
11797 =over 4
11798
11799 =item $ptree-E<gt>B<append()>
11800
11801 =back
11802
11803 =over 4
11804
11805 =item $ptree-E<gt>B<raw_text()>
11806
11807 =back
11808
11809 =over 4
11810
11811 =item Pod::ParseTree::B<DESTROY()>
11812
11813 =back
11814
11815 =over 4
11816
11817 =item SEE ALSO
11818
11819 =item AUTHOR
11820
11821 =back
11822
11823 =head2 Pod::LaTeX - Convert Pod data to formatted Latex
11824
11825 =over 4
11826
11827 =item SYNOPSIS
11828
11829 =item DESCRIPTION
11830
11831 =back
11832
11833 =over 4
11834
11835 =item OBJECT METHODS
11836
11837 C<initialize>
11838
11839 =back
11840
11841 =over 4
11842
11843 =item Data Accessors
11844
11845 B<AddPreamble>
11846
11847 =back
11848
11849 B<AddPostamble>
11850
11851 B<Head1Level>
11852
11853 B<Label>
11854
11855 B<LevelNoNum>
11856
11857 B<MakeIndex>
11858
11859 B<ReplaceNAMEwithSection>
11860
11861 B<StartWithNewPage>
11862
11863 B<TableOfContents>
11864
11865 B<UniqueLabels>
11866
11867 B<UserPreamble>
11868
11869 B<UserPostamble>
11870
11871 B<Lists>
11872
11873 =over 4
11874
11875 =item Subclassed methods
11876
11877 =back
11878
11879 B<begin_pod>
11880
11881 B<end_pod>
11882
11883 B<command>
11884
11885 B<verbatim>
11886
11887 B<textblock>
11888
11889 B<interior_sequence>
11890
11891 =over 4
11892
11893 =item List Methods
11894
11895 B<begin_list>
11896
11897 =back
11898
11899 B<end_list>
11900
11901 B<add_item>
11902
11903 =over 4
11904
11905 =item Methods for headings
11906
11907 B<head>
11908
11909 =back
11910
11911 =over 4
11912
11913 =item Internal methods
11914
11915 B<_output>
11916
11917 =back
11918
11919 B<_replace_special_chars>
11920
11921 B<_create_label>
11922
11923 B<_create_index>
11924
11925 B<_clean_latex_commands>
11926
11927 =over 4
11928
11929 =item NOTES
11930
11931 =item SEE ALSO
11932
11933 =item AUTHORS
11934
11935 =item COPYRIGHT
11936
11937 =item REVISION
11938
11939 =back
11940
11941 =head2 Pod::Man - Convert POD data to formatted *roff input
11942
11943 =over 4
11944
11945 =item SYNOPSIS
11946
11947 =item DESCRIPTION
11948
11949 center, date, fixed, fixedbold, fixeditalic, fixedbolditalic, quotes,
11950 release, section
11951
11952 =item DIAGNOSTICS
11953
11954 roff font should be 1 or 2 chars, not "%s", Invalid link %s, Invalid quote
11955 specification "%s", %s:%d: Unknown command paragraph "%s", Unknown escape
11956 EE<lt>%sE<gt>, Unknown sequence %s, %s: Unknown command paragraph "%s" on
11957 line %d, Unmatched =back
11958
11959 =item BUGS
11960
11961 =item SEE ALSO
11962
11963 =item AUTHOR
11964
11965 =back
11966
11967 =head2 Pod::ParseUtils - helpers for POD parsing and conversion
11968
11969 =over 4
11970
11971 =item SYNOPSIS
11972
11973 =item DESCRIPTION
11974
11975 =back
11976
11977 =over 4
11978
11979 =item Pod::List
11980
11981 Pod::List-E<gt>new()
11982
11983 =back
11984
11985 $list-E<gt>file()
11986
11987 $list-E<gt>start()
11988
11989 $list-E<gt>indent()
11990
11991 $list-E<gt>type()
11992
11993 $list-E<gt>rx()
11994
11995 $list-E<gt>item()
11996
11997 $list-E<gt>parent()
11998
11999 $list-E<gt>tag()
12000
12001 =over 4
12002
12003 =item Pod::Hyperlink
12004
12005 Pod::Hyperlink-E<gt>new()
12006
12007 =back
12008
12009 $link-E<gt>parse($string)
12010
12011 $link-E<gt>markup($string)
12012
12013 $link-E<gt>text()
12014
12015 $link-E<gt>warning()
12016
12017 $link-E<gt>file(), $link-E<gt>line()
12018
12019 $link-E<gt>page()
12020
12021 $link-E<gt>node()
12022
12023 $link-E<gt>alttext()
12024
12025 $link-E<gt>type()
12026
12027 $link-E<gt>link()
12028
12029 =over 4
12030
12031 =item Pod::Cache
12032
12033 Pod::Cache-E<gt>new()
12034
12035 =back
12036
12037 $cache-E<gt>item()
12038
12039 $cache-E<gt>find_page($name)
12040
12041 =over 4
12042
12043 =item Pod::Cache::Item
12044
12045 Pod::Cache::Item-E<gt>new()
12046
12047 =back
12048
12049 $cacheitem-E<gt>page()
12050
12051 $cacheitem-E<gt>description()
12052
12053 $cacheitem-E<gt>path()
12054
12055 $cacheitem-E<gt>file()
12056
12057 $cacheitem-E<gt>nodes()
12058
12059 $cacheitem-E<gt>find_node($name)
12060
12061 $cacheitem-E<gt>idx()
12062
12063 =over 4
12064
12065 =item AUTHOR
12066
12067 =item SEE ALSO
12068
12069 =back
12070
12071 =head2 Pod::Parser - base class for creating POD filters and translators
12072
12073 =over 4
12074
12075 =item SYNOPSIS
12076
12077 =item REQUIRES
12078
12079 =item EXPORTS
12080
12081 =item DESCRIPTION
12082
12083 =item QUICK OVERVIEW
12084
12085 =item PARSING OPTIONS
12086
12087 B<-want_nonPODs> (default: unset), B<-process_cut_cmd> (default: unset),
12088 B<-warnings> (default: unset)
12089
12090 =back
12091
12092 =over 4
12093
12094 =item RECOMMENDED SUBROUTINE/METHOD OVERRIDES
12095
12096 =back
12097
12098 =over 4
12099
12100 =item B<command()>
12101
12102 C<$cmd>, C<$text>, C<$line_num>, C<$pod_para>
12103
12104 =back
12105
12106 =over 4
12107
12108 =item B<verbatim()>
12109
12110 C<$text>, C<$line_num>, C<$pod_para>
12111
12112 =back
12113
12114 =over 4
12115
12116 =item B<textblock()>
12117
12118 C<$text>, C<$line_num>, C<$pod_para>
12119
12120 =back
12121
12122 =over 4
12123
12124 =item B<interior_sequence()>
12125
12126 =back
12127
12128 =over 4
12129
12130 =item OPTIONAL SUBROUTINE/METHOD OVERRIDES
12131
12132 =back
12133
12134 =over 4
12135
12136 =item B<new()>
12137
12138 =back
12139
12140 =over 4
12141
12142 =item B<initialize()>
12143
12144 =back
12145
12146 =over 4
12147
12148 =item B<begin_pod()>
12149
12150 =back
12151
12152 =over 4
12153
12154 =item B<begin_input()>
12155
12156 =back
12157
12158 =over 4
12159
12160 =item B<end_input()>
12161
12162 =back
12163
12164 =over 4
12165
12166 =item B<end_pod()>
12167
12168 =back
12169
12170 =over 4
12171
12172 =item B<preprocess_line()>
12173
12174 =back
12175
12176 =over 4
12177
12178 =item B<preprocess_paragraph()>
12179
12180 =back
12181
12182 =over 4
12183
12184 =item METHODS FOR PARSING AND PROCESSING
12185
12186 =back
12187
12188 =over 4
12189
12190 =item B<parse_text()>
12191
12192 B<-expand_seq> =E<gt> I<code-ref>|I<method-name>, B<-expand_text> =E<gt>
12193 I<code-ref>|I<method-name>, B<-expand_ptree> =E<gt>
12194 I<code-ref>|I<method-name>
12195
12196 =back
12197
12198 =over 4
12199
12200 =item B<interpolate()>
12201
12202 =back
12203
12204 =over 4
12205
12206 =item B<parse_paragraph()>
12207
12208 =back
12209
12210 =over 4
12211
12212 =item B<parse_from_filehandle()>
12213
12214 =back
12215
12216 =over 4
12217
12218 =item B<parse_from_file()>
12219
12220 =back
12221
12222 =over 4
12223
12224 =item ACCESSOR METHODS
12225
12226 =back
12227
12228 =over 4
12229
12230 =item B<errorsub()>
12231
12232 =back
12233
12234 =over 4
12235
12236 =item B<cutting()>
12237
12238 =back
12239
12240 =over 4
12241
12242 =item B<parseopts()>
12243
12244 =back
12245
12246 =over 4
12247
12248 =item B<output_file()>
12249
12250 =back
12251
12252 =over 4
12253
12254 =item B<output_handle()>
12255
12256 =back
12257
12258 =over 4
12259
12260 =item B<input_file()>
12261
12262 =back
12263
12264 =over 4
12265
12266 =item B<input_handle()>
12267
12268 =back
12269
12270 =over 4
12271
12272 =item B<input_streams()>
12273
12274 =back
12275
12276 =over 4
12277
12278 =item B<top_stream()>
12279
12280 =back
12281
12282 =over 4
12283
12284 =item PRIVATE METHODS AND DATA
12285
12286 =back
12287
12288 =over 4
12289
12290 =item B<_push_input_stream()>
12291
12292 =back
12293
12294 =over 4
12295
12296 =item B<_pop_input_stream()>
12297
12298 =back
12299
12300 =over 4
12301
12302 =item TREE-BASED PARSING
12303
12304 =item SEE ALSO
12305
12306 =item AUTHOR
12307
12308 =back
12309
12310 =head2 Pod::Plainer - Perl extension for converting Pod to old style Pod.
12311
12312 =over 4
12313
12314 =item SYNOPSIS
12315
12316 =item DESCRIPTION
12317
12318 =over 4
12319
12320 =item EXPORT
12321
12322 =back
12323
12324 =item AUTHOR
12325
12326 =item SEE ALSO
12327
12328 =back
12329
12330 =head2 Pod::Select, podselect() - extract selected sections of POD from
12331 input
12332
12333 =over 4
12334
12335 =item SYNOPSIS
12336
12337 =item REQUIRES
12338
12339 =item EXPORTS
12340
12341 =item DESCRIPTION
12342
12343 =item SECTION SPECIFICATIONS
12344
12345 =item RANGE SPECIFICATIONS
12346
12347 =back
12348
12349 =over 4
12350
12351 =item OBJECT METHODS
12352
12353 =back
12354
12355 =over 4
12356
12357 =item B<curr_headings()>
12358
12359 =back
12360
12361 =over 4
12362
12363 =item B<select()>
12364
12365 =back
12366
12367 =over 4
12368
12369 =item B<add_selection()>
12370
12371 =back
12372
12373 =over 4
12374
12375 =item B<clear_selections()>
12376
12377 =back
12378
12379 =over 4
12380
12381 =item B<match_section()>
12382
12383 =back
12384
12385 =over 4
12386
12387 =item B<is_selected()>
12388
12389 =back
12390
12391 =over 4
12392
12393 =item EXPORTED FUNCTIONS
12394
12395 =back
12396
12397 =over 4
12398
12399 =item B<podselect()>
12400
12401 B<-output>, B<-sections>, B<-ranges>
12402
12403 =back
12404
12405 =over 4
12406
12407 =item PRIVATE METHODS AND DATA
12408
12409 =back
12410
12411 =over 4
12412
12413 =item B<_compile_section_spec()>
12414
12415 =back
12416
12417 =over 4
12418
12419 =item $self->{_SECTION_HEADINGS}
12420
12421 =back
12422
12423 =over 4
12424
12425 =item $self->{_SELECTED_SECTIONS}
12426
12427 =back
12428
12429 =over 4
12430
12431 =item SEE ALSO
12432
12433 =item AUTHOR
12434
12435 =back
12436
12437 =head2 Pod::Text - Convert POD data to formatted ASCII text
12438
12439 =over 4
12440
12441 =item SYNOPSIS
12442
12443 =item DESCRIPTION
12444
12445 alt, indent, loose, quotes, sentence, width
12446
12447 =item DIAGNOSTICS
12448
12449 Bizarre space in item, Can't open %s for reading: %s, Invalid quote
12450 specification "%s", %s:%d: Unknown command paragraph "%s", Unknown escape:
12451 %s, Unknown sequence: %s, Unmatched =back
12452
12453 =item RESTRICTIONS
12454
12455 =item NOTES
12456
12457 =item SEE ALSO
12458
12459 =item AUTHOR
12460
12461 =back
12462
12463 =head2 Pod::Text::Color - Convert POD data to formatted color ASCII text
12464
12465 =over 4
12466
12467 =item SYNOPSIS
12468
12469 =item DESCRIPTION
12470
12471 =item BUGS
12472
12473 =item SEE ALSO
12474
12475 =item AUTHOR
12476
12477 =back
12478
12479 =head2 Pod::Text::Termcap, Pod::Text::Color - Convert POD data to ASCII
12480 text with format escapes
12481
12482 =over 4
12483
12484 =item SYNOPSIS
12485
12486 =item DESCRIPTION
12487
12488 =item SEE ALSO
12489
12490 =item AUTHOR
12491
12492 =back
12493
12494 =head2 Pod::Usage, pod2usage() - print a usage message from embedded pod
12495 documentation
12496
12497 =over 4
12498
12499 =item SYNOPSIS
12500
12501 =item ARGUMENTS
12502
12503 C<-message>, C<-msg>, C<-exitval>, C<-verbose>, C<-output>, C<-input>,
12504 C<-pathlist>
12505
12506 =item DESCRIPTION
12507
12508 =item EXAMPLES
12509
12510 =over 4
12511
12512 =item Recommended Use
12513
12514 =back
12515
12516 =item CAVEATS
12517
12518 =item AUTHOR
12519
12520 =item ACKNOWLEDGEMENTS
12521
12522 =back
12523
12524 =head2 SDBM_File - Tied access to sdbm files
12525
12526 =over 4
12527
12528 =item SYNOPSIS
12529
12530 =item DESCRIPTION
12531
12532 C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR>
12533
12534 =item DIAGNOSTICS
12535
12536 =over 4
12537
12538 =item C<sdbm store returned -1, errno 22, key "..." at ...>
12539
12540 =back
12541
12542 =item BUGS AND WARNINGS
12543
12544 =back
12545
12546 =head2 Safe - Compile and execute code in restricted compartments
12547
12548 =over 4
12549
12550 =item SYNOPSIS
12551
12552 =item DESCRIPTION
12553
12554 a new namespace, an operator mask
12555
12556 =item WARNING
12557
12558 =over 4
12559
12560 =item RECENT CHANGES
12561
12562 =item Methods in class Safe
12563
12564 permit (OP, ...), permit_only (OP, ...), deny (OP, ...), deny_only (OP,
12565 ...), trap (OP, ...), untrap (OP, ...), share (NAME, ...), share_from
12566 (PACKAGE, ARRAYREF), varglob (VARNAME), reval (STRING), rdo (FILENAME),
12567 root (NAMESPACE), mask (MASK)
12568
12569 =item Some Safety Issues
12570
12571 Memory, CPU, Snooping, Signals, State Changes
12572
12573 =item AUTHOR
12574
12575 =back
12576
12577 =back
12578
12579 =head2 Search::Dict, look - search for key in dictionary file
12580
12581 =over 4
12582
12583 =item SYNOPSIS
12584
12585 =item DESCRIPTION
12586
12587 =back
12588
12589 =head2 SelectSaver - save and restore selected file handle
12590
12591 =over 4
12592
12593 =item SYNOPSIS
12594
12595 =item DESCRIPTION
12596
12597 =back
12598
12599 =head2 SelfLoader - load functions only on demand
12600
12601 =over 4
12602
12603 =item SYNOPSIS
12604
12605 =item DESCRIPTION
12606
12607 =over 4
12608
12609 =item The __DATA__ token
12610
12611 =item SelfLoader autoloading
12612
12613 =item Autoloading and package lexicals
12614
12615 =item SelfLoader and AutoLoader
12616
12617 =item __DATA__, __END__, and the FOOBAR::DATA filehandle.
12618
12619 =item Classes and inherited methods.
12620
12621 =back
12622
12623 =item Multiple packages and fully qualified subroutine names
12624
12625 =back
12626
12627 =head2 Shell - run shell commands transparently within perl
12628
12629 =over 4
12630
12631 =item SYNOPSIS
12632
12633 =item DESCRIPTION
12634
12635 =over 4
12636
12637 =item OBJECT ORIENTED SYNTAX
12638
12639 =back
12640
12641 =item AUTHOR
12642
12643 =back
12644
12645 =head2 Socket, sockaddr_in, sockaddr_un, inet_aton, inet_ntoa - load the C
12646 socket.h defines and structure manipulators
12647
12648 =over 4
12649
12650 =item SYNOPSIS
12651
12652 =item DESCRIPTION
12653
12654 inet_aton HOSTNAME, inet_ntoa IP_ADDRESS, INADDR_ANY, INADDR_BROADCAST,
12655 INADDR_LOOPBACK, INADDR_NONE, sockaddr_in PORT, ADDRESS, sockaddr_in
12656 SOCKADDR_IN, pack_sockaddr_in PORT, IP_ADDRESS, unpack_sockaddr_in
12657 SOCKADDR_IN, sockaddr_un PATHNAME, sockaddr_un SOCKADDR_UN,
12658 pack_sockaddr_un PATH, unpack_sockaddr_un SOCKADDR_UN
12659
12660 =back
12661
12662 =head2 Storable - persistency for perl data structures
12663
12664 =over 4
12665
12666 =item SYNOPSIS
12667
12668 =item DESCRIPTION
12669
12670 =item MEMORY STORE
12671
12672 =item ADVISORY LOCKING
12673
12674 =item SPEED
12675
12676 =item CANONICAL REPRESENTATION
12677
12678 =item ERROR REPORTING
12679
12680 =item WIZARDS ONLY
12681
12682 =over 4
12683
12684 =item Hooks
12685
12686 C<STORABLE_freeze> I<obj>, I<cloning>, C<STORABLE_thaw> I<obj>, I<cloning>,
12687 I<serialized>, ..
12688
12689 =item Predicates
12690
12691 C<Storable::last_op_in_netorder>, C<Storable::is_storing>,
12692 C<Storable::is_retrieving>
12693
12694 =item Recursion
12695
12696 =item Deep Cloning
12697
12698 =back
12699
12700 =item EXAMPLES
12701
12702 =item WARNING
12703
12704 =item BUGS
12705
12706 =item CREDITS
12707
12708 =item TRANSLATIONS
12709
12710 =item AUTHOR
12711
12712 =item SEE ALSO
12713
12714 =back
12715
12716 =head2 Symbol - manipulate Perl symbols and their names
12717
12718 =over 4
12719
12720 =item SYNOPSIS
12721
12722 =item DESCRIPTION
12723
12724 =back
12725
12726 =head2 Sys::Hostname - Try every conceivable way to get hostname
12727
12728 =over 4
12729
12730 =item SYNOPSIS
12731
12732 =item DESCRIPTION
12733
12734 =item AUTHOR
12735
12736 =back
12737
12738 =head2 Syslog, Sys::Syslog, openlog, closelog, setlogmask, syslog - Perl
12739 interface to the UNIX syslog(3) calls
12740
12741 =over 4
12742
12743 =item SYNOPSIS
12744
12745 =item DESCRIPTION
12746
12747 openlog $ident, $logopt, $facility, syslog $priority, $format, @args,
12748 setlogmask $mask_priority, setlogsock $sock_type (added in 5.004_02),
12749 closelog
12750
12751 =item EXAMPLES
12752
12753 =item SEE ALSO
12754
12755 =item AUTHOR
12756
12757 =back
12758
12759 =head2 Syslog::Syslog, Sys::Syslog, openlog, closelog, setlogmask, syslog -
12760 Perl interface to the UNIX syslog(3) calls
12761
12762 =over 4
12763
12764 =item SYNOPSIS
12765
12766 =item DESCRIPTION
12767
12768 openlog $ident, $logopt, $facility, syslog $priority, $format, @args,
12769 setlogmask $mask_priority, setlogsock $sock_type (added in 5.004_02),
12770 closelog
12771
12772 =item EXAMPLES
12773
12774 =item SEE ALSO
12775
12776 =item AUTHOR
12777
12778 =back
12779
12780 =head2 Term::ANSIColor - Color screen output using ANSI escape sequences
12781
12782 =over 4
12783
12784 =item SYNOPSIS
12785
12786 =item DESCRIPTION
12787
12788 =item DIAGNOSTICS
12789
12790 Invalid attribute name %s, Name "%s" used only once: possible typo, No
12791 comma allowed after filehandle, Bareword "%s" not allowed while "strict
12792 subs" in use
12793
12794 =item RESTRICTIONS
12795
12796 =item NOTES
12797
12798 =item AUTHORS
12799
12800 =back
12801
12802 =head2 Term::Cap - Perl termcap interface
12803
12804 =over 4
12805
12806 =item SYNOPSIS
12807
12808 =item DESCRIPTION
12809
12810 =item EXAMPLES
12811
12812 =back
12813
12814 =head2 Term::Complete - Perl word completion module
12815
12816 =over 4
12817
12818 =item SYNOPSIS
12819
12820 =item DESCRIPTION
12821
12822 E<lt>tabE<gt>, ^D, ^U, E<lt>delE<gt>, E<lt>bsE<gt>
12823
12824 =item DIAGNOSTICS
12825
12826 =item BUGS
12827
12828 =item AUTHOR
12829
12830 =back
12831
12832 =head2 Term::ReadLine - Perl interface to various C<readline> packages. If
12833 no real package is found, substitutes stubs instead of basic functions.
12834
12835 =over 4
12836
12837 =item SYNOPSIS
12838
12839 =item DESCRIPTION
12840
12841 =item Minimal set of supported functions
12842
12843 C<ReadLine>, C<new>, C<readline>, C<addhistory>, C<IN>, $C<OUT>,
12844 C<MinLine>, C<findConsole>, Attribs, C<Features>
12845
12846 =item Additional supported functions
12847
12848 C<tkRunning>, C<ornaments>, C<newTTY>
12849
12850 =item EXPORTS
12851
12852 =item ENVIRONMENT
12853
12854 =back
12855
12856 =head2   Test - provides a simple framework for writing test scripts
12857
12858 =over 4
12859
12860 =item SYNOPSIS
12861
12862 =item DESCRIPTION
12863
12864 =item TEST TYPES
12865
12866 NORMAL TESTS, SKIPPED TESTS, TODO TESTS
12867
12868 =item RETURN VALUE
12869
12870 =item ONFAIL
12871
12872 =item SEE ALSO
12873
12874 =item AUTHOR
12875
12876 =back
12877
12878 =head2 Test::Harness - run perl standard test scripts with statistics
12879
12880 =over 4
12881
12882 =item SYNOPSIS
12883
12884 =item DESCRIPTION
12885
12886 =over 4
12887
12888 =item The test script output
12889
12890 =back
12891
12892 =item EXPORT
12893
12894 =item DIAGNOSTICS
12895
12896 C<All tests successful.\nFiles=%d,  Tests=%d, %s>, C<FAILED tests
12897 %s\n\tFailed %d/%d tests, %.2f%% okay.>, C<Test returned status %d (wstat
12898 %d)>, C<Failed 1 test, %.2f%% okay. %s>, C<Failed %d/%d tests, %.2f%% okay.
12899 %s>, C<FAILED--Further testing stopped%s>
12900
12901 =item ENVIRONMENT
12902
12903 =item SEE ALSO
12904
12905 =item AUTHORS
12906
12907 =item BUGS
12908
12909 =back
12910
12911 =head2 Text::Abbrev, abbrev - create an abbreviation table from a list
12912
12913 =over 4
12914
12915 =item SYNOPSIS
12916
12917 =item DESCRIPTION
12918
12919 =item EXAMPLE
12920
12921 =back
12922
12923 =head2 Text::ParseWords - parse text into an array of tokens or array of
12924 arrays
12925
12926 =over 4
12927
12928 =item SYNOPSIS
12929
12930 =item DESCRIPTION
12931
12932 =item EXAMPLES
12933
12934 0 a simple word, 1 multiple spaces are skipped because of our $delim, 2 use
12935 of quotes to include a space in a word, 3 use of a backslash to include a
12936 space in a word, 4 use of a backslash to remove the special meaning of a
12937 double-quote, 5 another simple word (note the lack of effect of the
12938 backslashed double-quote)
12939
12940 =item AUTHORS
12941
12942 =back
12943
12944 =head2 Text::Soundex - Implementation of the Soundex Algorithm as Described
12945 by Knuth
12946
12947 =over 4
12948
12949 =item SYNOPSIS
12950
12951 =item DESCRIPTION
12952
12953 =item EXAMPLES
12954
12955 =item LIMITATIONS
12956
12957 =item AUTHOR
12958
12959 =back
12960
12961 =head2 Text::Tabs -- expand and unexpand tabs per the unix expand(1) and
12962 unexpand(1)
12963
12964 =over 4
12965
12966 =item SYNOPSIS
12967
12968 =item DESCRIPTION
12969
12970 =item BUGS
12971
12972 =item AUTHOR
12973
12974 =back
12975
12976 =head2 Text::Wrap - line wrapping to form simple paragraphs
12977
12978 =over 4
12979
12980 =item SYNOPSIS
12981
12982 =item DESCRIPTION
12983
12984 =item EXAMPLE
12985
12986 =item AUTHOR
12987
12988 =back
12989
12990 =head2 Thread - manipulate threads in Perl (EXPERIMENTAL, subject to
12991 change)
12992
12993 =over 4
12994
12995 =item SYNOPSIS
12996
12997 =item DESCRIPTION
12998
12999 =item FUNCTIONS
13000
13001 new \&start_sub, new \&start_sub, LIST, lock VARIABLE, async BLOCK;,
13002 Thread->self, Thread->list, cond_wait VARIABLE, cond_signal VARIABLE,
13003 cond_broadcast VARIABLE, yield
13004
13005 =item METHODS
13006
13007 join, eval, detach, equal, tid, flags, done
13008
13009 =item LIMITATIONS
13010
13011 =item SEE ALSO
13012
13013 =back
13014
13015 =head2 Thread::Queue - thread-safe queues
13016
13017 =over 4
13018
13019 =item SYNOPSIS
13020
13021 =item DESCRIPTION
13022
13023 =item FUNCTIONS AND METHODS
13024
13025 new, enqueue LIST, dequeue, dequeue_nb, pending
13026
13027 =item SEE ALSO
13028
13029 =back
13030
13031 =head2 Thread::Semaphore - thread-safe semaphores
13032
13033 =over 4
13034
13035 =item SYNOPSIS
13036
13037 =item DESCRIPTION
13038
13039 =item FUNCTIONS AND METHODS
13040
13041 new, new NUMBER, down, down NUMBER, up, up NUMBER
13042
13043 =back
13044
13045 =head2 Thread::Signal - Start a thread which runs signal handlers reliably
13046
13047 =over 4
13048
13049 =item SYNOPSIS
13050
13051 =item DESCRIPTION
13052
13053 =item BUGS
13054
13055 =back
13056
13057 =head2 Thread::Specific - thread-specific keys
13058
13059 =over 4
13060
13061 =item SYNOPSIS
13062
13063 =item DESCRIPTION
13064
13065 =back
13066
13067 =head2 Tie::Array - base class for tied arrays
13068
13069 =over 4
13070
13071 =item SYNOPSIS
13072
13073 =item DESCRIPTION
13074
13075 TIEARRAY classname, LIST, STORE this, index, value, FETCH this, index,
13076 FETCHSIZE this, STORESIZE this, count, EXTEND this, count, EXISTS this,
13077 key, DELETE this, key, CLEAR this, DESTROY this, PUSH this, LIST, POP this,
13078 SHIFT this, UNSHIFT this, LIST, SPLICE this, offset, length, LIST
13079
13080 =item CAVEATS
13081
13082 =item AUTHOR
13083
13084 =back
13085
13086 =head2 Tie::Handle, Tie::StdHandle  - base class definitions for tied
13087 handles
13088
13089 =over 4
13090
13091 =item SYNOPSIS
13092
13093 =item DESCRIPTION
13094
13095 TIEHANDLE classname, LIST, WRITE this, scalar, length, offset, PRINT this,
13096 LIST, PRINTF this, format, LIST, READ this, scalar, length, offset,
13097 READLINE this, GETC this, CLOSE this, OPEN this, filename, BINMODE this,
13098 EOF this, TELL this, SEEK this, offset, whence, DESTROY this
13099
13100 =item MORE INFORMATION
13101
13102 =item COMPATIBILITY
13103
13104 =back
13105
13106 =head2 Tie::Hash, Tie::StdHash - base class definitions for tied hashes
13107
13108 =over 4
13109
13110 =item SYNOPSIS
13111
13112 =item DESCRIPTION
13113
13114 TIEHASH classname, LIST, STORE this, key, value, FETCH this, key, FIRSTKEY
13115 this, NEXTKEY this, lastkey, EXISTS this, key, DELETE this, key, CLEAR this
13116
13117 =item CAVEATS
13118
13119 =item MORE INFORMATION
13120
13121 =back
13122
13123 =head2 Tie::RefHash - use references as hash keys
13124
13125 =over 4
13126
13127 =item SYNOPSIS
13128
13129 =item DESCRIPTION
13130
13131 =item EXAMPLE
13132
13133 =item AUTHOR
13134
13135 =item VERSION
13136
13137 =item SEE ALSO
13138
13139 =back
13140
13141 =head2 Tie::Scalar, Tie::StdScalar - base class definitions for tied
13142 scalars
13143
13144 =over 4
13145
13146 =item SYNOPSIS
13147
13148 =item DESCRIPTION
13149
13150 TIESCALAR classname, LIST, FETCH this, STORE this, value, DESTROY this
13151
13152 =item MORE INFORMATION
13153
13154 =back
13155
13156 =head2 Tie::SubstrHash - Fixed-table-size, fixed-key-length hashing
13157
13158 =over 4
13159
13160 =item SYNOPSIS
13161
13162 =item DESCRIPTION
13163
13164 =item CAVEATS
13165
13166 =back
13167
13168 =head2 Time::Local - efficiently compute time from local and GMT time
13169
13170 =over 4
13171
13172 =item SYNOPSIS
13173
13174 =item DESCRIPTION
13175
13176 =item IMPLEMENTATION
13177
13178 =item BUGS
13179
13180 =back
13181
13182 =head2 Time::gmtime - by-name interface to Perl's built-in gmtime()
13183 function
13184
13185 =over 4
13186
13187 =item SYNOPSIS
13188
13189 =item DESCRIPTION
13190
13191 =item NOTE
13192
13193 =item AUTHOR
13194
13195 =back
13196
13197 =head2 Time::localtime - by-name interface to Perl's built-in localtime()
13198 function
13199
13200 =over 4
13201
13202 =item SYNOPSIS
13203
13204 =item DESCRIPTION
13205
13206 =item NOTE
13207
13208 =item AUTHOR
13209
13210 =back
13211
13212 =head2 Time::tm - internal object used by Time::gmtime and Time::localtime
13213
13214 =over 4
13215
13216 =item SYNOPSIS
13217
13218 =item DESCRIPTION
13219
13220 =item AUTHOR
13221
13222 =back
13223
13224 =head2 UNIVERSAL - base class for ALL classes (blessed references)
13225
13226 =over 4
13227
13228 =item SYNOPSIS
13229
13230 =item DESCRIPTION
13231
13232 isa ( TYPE ), can ( METHOD ), VERSION ( [ REQUIRE ] ), UNIVERSAL::isa (
13233 VAL, TYPE ), UNIVERSAL::can ( VAL, METHOD )
13234
13235 =back
13236
13237 =head2 User::grent - by-name interface to Perl's built-in getgr*()
13238 functions
13239
13240 =over 4
13241
13242 =item SYNOPSIS
13243
13244 =item DESCRIPTION
13245
13246 =item NOTE
13247
13248 =item AUTHOR
13249
13250 =back
13251
13252 =head2 User::pwent - by-name interface to Perl's built-in getpw*()
13253 functions
13254
13255 =over 4
13256
13257 =item SYNOPSIS
13258
13259 =item DESCRIPTION
13260
13261 =over 4
13262
13263 =item System Specifics
13264
13265 =back
13266
13267 =item NOTE
13268
13269 =item AUTHOR
13270
13271 =item HISTORY
13272
13273 March 18th, 2000
13274
13275 =back
13276
13277 =head2 Win32 - Interfaces to some Win32 API Functions
13278
13279 =over 4
13280
13281 =item DESCRIPTION
13282
13283 =over 4
13284
13285 =item Alphabetical Listing of Win32 Functions
13286
13287 Win32::AbortSystemShutdown(MACHINE), Win32::BuildNumber(),
13288 Win32::CopyFile(FROM, TO, OVERWRITE), Win32::DomainName(),
13289 Win32::ExpandEnvironmentStrings(STRING), Win32::FormatMessage(ERRORCODE),
13290 Win32::FsType(), Win32::FreeLibrary(HANDLE), Win32::GetArchName(),
13291 Win32::GetChipName(), Win32::GetCwd(), Win32::GetFullPathName(FILENAME),
13292 Win32::GetLastError(), Win32::GetLongPathName(PATHNAME),
13293 Win32::GetNextAvailDrive(), Win32::GetOSVersion(),
13294 Win32::GetShortPathName(PATHNAME), Win32::GetProcAddress(INSTANCE,
13295 PROCNAME), Win32::GetTickCount(), Win32::InitiateSystemShutdown(MACHINE,
13296 MESSAGE, TIMEOUT, FORCECLOSE, REBOOT), Win32::IsWinNT(), Win32::IsWin95(),
13297 Win32::LoadLibrary(LIBNAME), Win32::LoginName(),
13298 Win32::LookupAccountName(SYSTEM, ACCOUNT, DOMAIN, SID, SIDTYPE),
13299 Win32::LookupAccountSID(SYSTEM, SID, ACCOUNT, DOMAIN, SIDTYPE),
13300 Win32::MsgBox(MESSAGE [, FLAGS [, TITLE]]), Win32::NodeName(),
13301 Win32::RegisterServer(LIBRARYNAME), Win32::SetCwd(NEWDIRECTORY),
13302 Win32::SetLastError(ERROR), Win32::Sleep(TIME), Win32::Spawn(COMMAND, ARGS,
13303 PID), Win32::UnregisterServer(LIBRARYNAME)
13304
13305 =back
13306
13307 =back
13308
13309 =head2 XSLoader - Dynamically load C libraries into Perl code
13310
13311 =over 4
13312
13313 =item SYNOPSIS
13314
13315 =item DESCRIPTION
13316
13317 =item AUTHOR
13318
13319 =back
13320
13321 =head1 AUXILIARY DOCUMENTATION
13322
13323 Here should be listed all the extra programs' documentation, but they
13324 don't all have manual pages yet:
13325
13326 =over 4
13327
13328 =item a2p
13329
13330 =item s2p
13331
13332 =item find2perl
13333
13334 =item h2ph
13335
13336 =item c2ph
13337
13338 =item h2xs
13339
13340 =item xsubpp
13341
13342 =item pod2man
13343
13344 =item wrapsuid
13345
13346 =back
13347
13348 =head1 AUTHOR
13349
13350 Larry Wall <F<larry@wall.org>>, with the help of oodles
13351 of other folks.
13352