pod/perltoc.pod

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