pod/perltoc.pod

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