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 =item SYNOPSIS
  17
  18 =item DESCRIPTION
  19
  20 Many usability enhancements, Simplified grammar, Lexical scoping,
  21 Arbitrarily nested data structures, Modularity and reusability,
  22 Object-oriented programming, Embeddable and Extensible, POSIX compliant,
  23 Package constructors and destructors, Multiple simultaneous DBM
  24 implementations, Subroutine definitions may now be autoloaded, Regular
  25 expression enhancements, Innumerable Unbundled Modules, Compilability
  26
  27 =item ENVIRONMENT
  28
  29 HOME, LOGDIR, PATH, PERL5LIB, PERL5DB, PERL_DESTRUCT_LEVEL, PERLLIB
  30
  31 =item AUTHOR
  32
  33 =item FILES
  34
  35 =item SEE ALSO
  36
  37 =item DIAGNOSTICS
  38
  39 =item BUGS
  40
  41 =item NOTES
  42
  43 =head2 perldelta - what's new for perl5.004
  44
  45 =item DESCRIPTION
  46
  47 =item Supported Environments
  48
  49 =item Core Changes
  50
  51 =over
  52
  53 =item Compilation Option: Binary Compatibility With 5.003
  54
  55 =item New Opcode Module and Revised Safe Module
  56
  57 =item Fixed Parsing of $$<digit>, &$<digit>, etc.
  58
  59 =item Internal Change: FileHandle Deprecated
  60
  61 =item Internal Change: PerlIO internal IO abstraction interface
  62
  63 =item New and Changed Built-in Variables
  64
  65 $^E, $^H, $^M
  66
  67 =item New and Changed Built-in Functions
  68
  69 delete on slices, flock, printf and sprintf, keys as an lvalue, my() in
  70 Control Structures, unpack() and pack(), use VERSION, use Module VERSION
  71 LIST, prototype(FUNCTION), $_ as Default, C<m//g> does not trigger a pos()
  72 reset on failure, nested C<sub{}> closures work now, formats work right on
  73 changing lexicals
  74
  75 =item New Built-in Methods
  76
  77 isa(CLASS), can(METHOD), VERSION( [NEED] )
  78
  79 =item TIEHANDLE Now Supported
  80
  81 TIEHANDLE classname, LIST, PRINT this, LIST, READLINE this, DESTROY this
  82
  83 =item Malloc Enhancements
  84
  85 -DEMERGENCY_SBRK, -DPACK_MALLOC, -DTWO_POT_OPTIMIZE
  86
  87 =item Miscellaneous Efficiency Enhancements
  88
  89 =back
  90
  91 =item Pragmata
  92
  93 use blib, use blib 'dir', use locale, use ops, use vmsish
  94
  95 =item Modules
  96
  97 =over
  98
  99 =item Installation Directories
 100
 101 =item Fcntl
 102
 103 =item Module Information Summary
 104
 105 =item IO
 106
 107 =item Math::Complex
 108
 109 =item DB_File
 110
 111 =item Net::Ping
 112
 113 =item Overridden Built-ins
 114
 115 =back
 116
 117 =item Utility Changes
 118
 119 =over
 120
 121 =item xsubpp
 122
 123 C<void> XSUBs now default to returning nothing
 124
 125 =back
 126
 127 =item C Language API Changes
 128
 129 C<gv_fetchmethod> and C<perl_call_sv>
 130
 131 =item Documentation Changes
 132
 133 L<perldelta>, L<perllocale>, L<perltoot>, L<perlapio>, L<perldebug>,
 134 L<perlsec>
 135
 136 =item New Diagnostics
 137
 138 "my" variable %s masks earlier declaration in same scope, %s argument is
 139 not a HASH element or slice, Allocation too large: %lx, Allocation too
 140 large, Attempt to free non-existent shared string, Attempt to use reference
 141 as lvalue in substr, Unsupported function fork, Ill-formed logical name
 142 |%s| in prime_env_iter, Can't use bareword ("%s") as %s ref while "strict
 143 refs" in use, Constant subroutine %s redefined, Died, Integer overflow in
 144 hex number, Integer overflow in octal number, Name "%s::%s" used only once:
 145 possible typo, Null picture in formline, Offset outside string, Stub found
 146 while resolving method `%s' overloading `%s' in package `%s', Cannot
 147 resolve method `%s' overloading `%s' in package `s', Out of memory!, Out of
 148 memory during request for %s, Possible attempt to put comments in qw()
 149 list, Possible attempt to separate words with commas, Scalar value @%s{%s}
 150 better written as $%s{%s}, untie attempted while %d inner references still
 151 exist, Value of %s construct can be "0"; test with defined(), Variable "%s"
 152 may be unavailable, Variable "%s" will not stay shared, Warning:
 153 something's wrong, Got an error from DosAllocMem, Malformed PERLLIB_PREFIX,
 154 PERL_SH_DIR too long, Process terminated by SIG%s
 155
 156 =item BUGS
 157
 158 =item SEE ALSO
 159
 160 =item HISTORY
 161
 162 =head2 perldata - Perl data types
 163
 164 =item DESCRIPTION
 165
 166 =over
 167
 168 =item Variable names
 169
 170 =item Context
 171
 172 =item Scalar values
 173
 174 =item Scalar value constructors
 175
 176 =item List value constructors
 177
 178 =item Typeglobs and Filehandles
 179
 180 =back
 181
 182 =head2 perlsyn - Perl syntax
 183
 184 =item DESCRIPTION
 185
 186 =over
 187
 188 =item Declarations
 189
 190 =item Simple statements
 191
 192 =item Compound statements
 193
 194 =item Loop Control
 195
 196 =item For Loops
 197
 198 =item Foreach Loops
 199
 200 =item Basic BLOCKs and Switch Statements
 201
 202 =item Goto
 203
 204 =item PODs: Embedded Documentation
 205
 206 =item Plain Old Comments (Not!)
 207
 208 =back
 209
 210 =head2 perlop - Perl operators and precedence
 211
 212 =item SYNOPSIS
 213
 214 =item DESCRIPTION
 215
 216 =over
 217
 218 =item Terms and List Operators (Leftward)
 219
 220 =item The Arrow Operator
 221
 222 =item Auto-increment and Auto-decrement
 223
 224 =item Exponentiation
 225
 226 =item Symbolic Unary Operators
 227
 228 =item Binding Operators
 229
 230 =item Multiplicative Operators
 231
 232 =item Additive Operators
 233
 234 =item Shift Operators
 235
 236 =item Named Unary Operators
 237
 238 =item Relational Operators
 239
 240 =item Equality Operators
 241
 242 =item Bitwise And
 243
 244 =item Bitwise Or and Exclusive Or
 245
 246 =item C-style Logical And
 247
 248 =item C-style Logical Or
 249
 250 =item Range Operator
 251
 252 =item Conditional Operator
 253
 254 =item Assignment Operators
 255
 256 =item Comma Operator
 257
 258 =item List Operators (Rightward)
 259
 260 =item Logical Not
 261
 262 =item Logical And
 263
 264 =item Logical or and Exclusive Or
 265
 266 =item C Operators Missing From Perl
 267
 268 unary &, unary *, (TYPE)
 269
 270 =item Quote and Quote-like Operators
 271
 272 =item Regexp Quote-Like Operators
 273
 274 ?PATTERN?, m/PATTERN/gimosx, /PATTERN/gimosx, q/STRING/, C<'STRING'>,
 275 qq/STRING/, "STRING", qx/STRING/, `STRING`, qw/STRING/,
 276 s/PATTERN/REPLACEMENT/egimosx, tr/SEARCHLIST/REPLACEMENTLIST/cds,
 277 y/SEARCHLIST/REPLACEMENTLIST/cds
 278
 279 =item I/O Operators
 280
 281 =item Constant Folding
 282
 283 =item Integer Arithmetic
 284
 285 =back
 286
 287 =head2 perlre - Perl regular expressions
 288
 289 =item DESCRIPTION
 290
 291 i, m, s, x
 292
 293 =over
 294
 295 =item Regular Expressions
 296
 297 (?#text), (?:regexp), (?=regexp), (?!regexp), (?imsx)
 298
 299 =item Backtracking
 300
 301 =item Version 8 Regular Expressions
 302
 303 =item WARNING on \1 vs $1
 304
 305 =back
 306
 307 =head2 perlrun - how to execute the Perl interpreter
 308
 309 =item SYNOPSIS
 310
 311 =item DESCRIPTION
 312
 313 =over
 314
 315 =item Switches
 316
 317 B<-0>[I<digits>], B<-a>, B<-c>, B<-d>, B<-d:>I<foo>, B<-D>I<number>,
 318 B<-D>I<list>, B<-e> I<commandline>, B<-F>I<pattern>, B<-h>,
 319 B<-i>[I<extension>], B<-I>I<directory>, B<-l>[I<octnum>],
 320 B<-m>[B<->]I<module>, B<-M>[B<->]I<module>, B<-M>[B<->]I<'module ...'>,
 321 B<-[mM]>[B<->]I<module=arg[,arg]...>, B<-n>, B<-p>, B<-P>, B<-s>, B<-S>,
 322 B<-T>, B<-u>, B<-U>, B<-v>, B<-V>, B<-V:>I<name>, B<-w>, B<-x> I<directory>
 323
 324 =back
 325
 326 =head2 perlfunc - Perl builtin functions
 327
 328 =item DESCRIPTION
 329
 330  I<THERE IS NO GENERAL RULE FOR CONVERTING A LIST INTO A SCALAR!>
 331
 332 =over
 333
 334 =item Perl Functions by Category
 335
 336 Functions for SCALARs or strings, Regular expressions and pattern matching,
 337 Numeric functions, Functions for real @ARRAYs, Functions for list data,
 338 Functions for real %HASHes, Input and output functions, Functions for fixed
 339 length data or records, Functions for filehandles, files, or directories,
 340 Keywords related to the control flow of your perl program, Keywords related
 341 to scoping, Miscellaneous functions, Functions for processes and process
 342 groups, Keywords related to perl modules, Keywords related to classes and
 343 object-orientedness, Low-level socket functions, System V interprocess
 344 communication functions, Fetching user and group info, Fetching network
 345 info, Time-related functions, Functions new in perl5, Functions obsoleted
 346 in perl5
 347
 348 =item Alphabetical Listing of Perl Functions
 349
 350 -I<X> FILEHANDLE, -I<X> EXPR, -I<X>, abs VALUE, abs, accept
 351 NEWSOCKET,GENERICSOCKET, alarm SECONDS, alarm, atan2 Y,X, bind SOCKET,NAME,
 352 binmode FILEHANDLE, bless REF,CLASSNAME, bless REF, caller EXPR, caller,
 353 chdir EXPR, chmod LIST, chomp VARIABLE, chomp LIST, chomp, chop VARIABLE,
 354 chop LIST, chop, chown LIST, chr NUMBER, chr, chroot FILENAME, chroot,
 355 close FILEHANDLE, closedir DIRHANDLE, connect SOCKET,NAME, continue BLOCK,
 356 cos EXPR, crypt PLAINTEXT,SALT, dbmclose HASH, dbmopen HASH,DBNAME,MODE,
 357 defined EXPR, defined, delete EXPR, die LIST, do BLOCK, do
 358 SUBROUTINE(LIST), do EXPR, dump LABEL, each HASH, eof FILEHANDLE, eof (),
 359 eof, eval EXPR, eval BLOCK, exec LIST, exists EXPR, exit EXPR, exp EXPR,
 360 exp, fcntl FILEHANDLE,FUNCTION,SCALAR, fileno FILEHANDLE, flock
 361 FILEHANDLE,OPERATION, fork, format, formline PICTURE, LIST, getc
 362 FILEHANDLE, getc, getlogin, getpeername SOCKET, getpgrp PID, getppid,
 363 getpriority WHICH,WHO, getpwnam NAME, getgrnam NAME, gethostbyname NAME,
 364 getnetbyname NAME, getprotobyname NAME, getpwuid UID, getgrgid GID,
 365 getservbyname NAME,PROTO, gethostbyaddr ADDR,ADDRTYPE, getnetbyaddr
 366 ADDR,ADDRTYPE, getprotobynumber NUMBER, getservbyport PORT,PROTO, getpwent,
 367 getgrent, gethostent, getnetent, getprotoent, getservent, setpwent,
 368 setgrent, sethostent STAYOPEN, setnetent STAYOPEN, setprotoent STAYOPEN,
 369 setservent STAYOPEN, endpwent, endgrent, endhostent, endnetent,
 370 endprotoent, endservent, getsockname SOCKET, getsockopt
 371 SOCKET,LEVEL,OPTNAME, glob EXPR, glob, gmtime EXPR, goto LABEL, goto EXPR,
 372 goto &NAME, grep BLOCK LIST, grep EXPR,LIST, hex EXPR, hex, import, index
 373 STR,SUBSTR,POSITION, index STR,SUBSTR, int EXPR, int, ioctl
 374 FILEHANDLE,FUNCTION,SCALAR, join EXPR,LIST, keys HASH, kill LIST, last
 375 LABEL, last, lc EXPR, lc, lcfirst EXPR, lcfirst, length EXPR, length, link
 376 OLDFILE,NEWFILE, listen SOCKET,QUEUESIZE, local EXPR, localtime EXPR, log
 377 EXPR, log, lstat FILEHANDLE, lstat EXPR, lstat, m//, map BLOCK LIST, map
 378 EXPR,LIST, mkdir FILENAME,MODE, msgctl ID,CMD,ARG, msgget KEY,FLAGS, msgsnd
 379 ID,MSG,FLAGS, msgrcv ID,VAR,SIZE,TYPE,FLAGS, my EXPR, next LABEL, next, no
 380 Module LIST, oct EXPR, oct, open FILEHANDLE,EXPR, open FILEHANDLE, opendir
 381 DIRHANDLE,EXPR, ord EXPR, ord, pack TEMPLATE,LIST, package NAMESPACE, pipe
 382 READHANDLE,WRITEHANDLE, pop ARRAY, pop, pos SCALAR, pos, print FILEHANDLE
 383 LIST, print LIST, print, printf FILEHANDLE FORMAT, LIST, printf FORMAT,
 384 LIST, prototype FUNCTION, push ARRAY,LIST, q/STRING/, qq/STRING/,
 385 qx/STRING/, qw/STRING/, quotemeta EXPR, quotemeta, rand EXPR, rand, read
 386 FILEHANDLE,SCALAR,LENGTH,OFFSET, read FILEHANDLE,SCALAR,LENGTH, readdir
 387 DIRHANDLE, readlink EXPR, readlink, recv SOCKET,SCALAR,LEN,FLAGS, redo
 388 LABEL, redo, ref EXPR, ref, rename OLDNAME,NEWNAME, require EXPR, require,
 389 reset EXPR, reset, return LIST, reverse LIST, rewinddir DIRHANDLE, rindex
 390 STR,SUBSTR,POSITION, rindex STR,SUBSTR, rmdir FILENAME, rmdir, s///, scalar
 391 EXPR, seek FILEHANDLE,POSITION,WHENCE, seekdir DIRHANDLE,POS, select
 392 FILEHANDLE, select, select RBITS,WBITS,EBITS,TIMEOUT, semctl
 393 ID,SEMNUM,CMD,ARG, semget KEY,NSEMS,FLAGS, semop KEY,OPSTRING, send
 394 SOCKET,MSG,FLAGS,TO, send SOCKET,MSG,FLAGS, setpgrp PID,PGRP, setpriority
 395 WHICH,WHO,PRIORITY, setsockopt SOCKET,LEVEL,OPTNAME,OPTVAL, shift ARRAY,
 396 shift, shmctl ID,CMD,ARG, shmget KEY,SIZE,FLAGS, shmread ID,VAR,POS,SIZE,
 397 shmwrite ID,STRING,POS,SIZE, shutdown SOCKET,HOW, sin EXPR, sin, sleep
 398 EXPR, sleep, socket SOCKET,DOMAIN,TYPE,PROTOCOL, socketpair
 399 SOCKET1,SOCKET2,DOMAIN,TYPE,PROTOCOL, sort SUBNAME LIST, sort BLOCK LIST,
 400 sort LIST, splice ARRAY,OFFSET,LENGTH,LIST, splice ARRAY,OFFSET,LENGTH,
 401 splice ARRAY,OFFSET, split /PATTERN/,EXPR,LIMIT, split /PATTERN/,EXPR,
 402 split /PATTERN/, split, sprintf FORMAT, LIST, sqrt EXPR, sqrt, srand EXPR,
 403 stat FILEHANDLE, stat EXPR, stat, study SCALAR, study, sub BLOCK, sub NAME,
 404 sub NAME BLOCK, substr EXPR,OFFSET,LEN, substr EXPR,OFFSET, symlink
 405 OLDFILE,NEWFILE, syscall LIST, sysopen FILEHANDLE,FILENAME,MODE, sysopen
 406 FILEHANDLE,FILENAME,MODE,PERMS, sysread FILEHANDLE,SCALAR,LENGTH,OFFSET,
 407 sysread FILEHANDLE,SCALAR,LENGTH, system LIST, syswrite
 408 FILEHANDLE,SCALAR,LENGTH,OFFSET, syswrite FILEHANDLE,SCALAR,LENGTH, tell
 409 FILEHANDLE, tell, telldir DIRHANDLE, tie VARIABLE,CLASSNAME,LIST, tied
 410 VARIABLE, time, times, tr///, truncate FILEHANDLE,LENGTH, truncate
 411 EXPR,LENGTH, uc EXPR, uc, ucfirst EXPR, ucfirst, umask EXPR, umask, undef
 412 EXPR, undef, unlink LIST, unlink, unpack TEMPLATE,EXPR, untie VARIABLE,
 413 unshift ARRAY,LIST, use Module LIST, use Module, use Module VERSION LIST,
 414 use VERSION, utime LIST, values HASH, vec EXPR,OFFSET,BITS, wait, waitpid
 415 PID,FLAGS, wantarray, warn LIST, write FILEHANDLE, write EXPR, write, y///
 416
 417 =back
 418
 419 =head2 perlvar - Perl predefined variables
 420
 421 =item DESCRIPTION
 422
 423 =over
 424
 425 =item Predefined Names
 426
 427 $ARG, $_, $E<lt>I<digit>E<gt>, $MATCH, $&, $PREMATCH, $`, $POSTMATCH, $',
 428 $LAST_PAREN_MATCH, $+, $MULTILINE_MATCHING, $*, input_line_number HANDLE
 429 EXPR, $INPUT_LINE_NUMBER, $NR, $, input_record_separator HANDLE EXPR,
 430 $INPUT_RECORD_SEPARATOR, $RS, $/, autoflush HANDLE EXPR, $OUTPUT_AUTOFLUSH,
 431 $|, output_field_separator HANDLE EXPR, $OUTPUT_FIELD_SEPARATOR, $OFS, $,,
 432 output_record_separator HANDLE EXPR, $OUTPUT_RECORD_SEPARATOR, $ORS, $\,
 433 $LIST_SEPARATOR, $", $SUBSCRIPT_SEPARATOR, $SUBSEP, $;, $OFMT, $#,
 434 format_page_number HANDLE EXPR, $FORMAT_PAGE_NUMBER, $%,
 435 format_lines_per_page HANDLE EXPR, $FORMAT_LINES_PER_PAGE, $=,
 436 format_lines_left HANDLE EXPR, $FORMAT_LINES_LEFT, $-, format_name HANDLE
 437 EXPR, $FORMAT_NAME, $~, format_top_name HANDLE EXPR, $FORMAT_TOP_NAME, $^,
 438 format_line_break_characters HANDLE EXPR, $FORMAT_LINE_BREAK_CHARACTERS,
 439 $:, format_formfeed HANDLE EXPR, $FORMAT_FORMFEED, $^L, $ACCUMULATOR, $^A,
 440 $CHILD_ERROR, $?, $OS_ERROR, $ERRNO, $!, $EXTENDED_OS_ERROR, $^E,
 441 $EVAL_ERROR, $@, $PROCESS_ID, $PID, $$, $REAL_USER_ID, $UID, $<,
 442 $EFFECTIVE_USER_ID, $EUID, $>, $REAL_GROUP_ID, $GID, $(,
 443 $EFFECTIVE_GROUP_ID, $EGID, $), $PROGRAM_NAME, $0, $[, $PERL_VERSION, $],
 444 $DEBUGGING, $^D, $SYSTEM_FD_MAX, $^F, $^H, $INPLACE_EDIT, $^I, $OSNAME,
 445 $^O, $PERLDB, $^P, $BASETIME, $^T, $WARNING, $^W, $EXECUTABLE_NAME, $^X,
 446 $ARGV, @ARGV, @INC, %INC, $ENV{expr}, $SIG{expr}
 447
 448 =back
 449
 450 =head2 perlsub - Perl subroutines
 451
 452 =item SYNOPSIS
 453
 454 =item DESCRIPTION
 455
 456 =over
 457
 458 =item Private Variables via my()
 459
 460 =item Temporary Values via local()
 461
 462 =item Passing Symbol Table Entries (typeglobs)
 463
 464 =item Pass by Reference
 465
 466 =item Prototypes
 467
 468 =item Constant Functions
 469
 470 =item Overriding Builtin Functions
 471
 472 =item Autoloading
 473
 474 =back
 475
 476 =item SEE ALSO
 477
 478 =head2 perlmod - Perl modules (packages)
 479
 480 =item DESCRIPTION
 481
 482 =over
 483
 484 =item Packages
 485
 486 =item Symbol Tables
 487
 488 =item Package Constructors and Destructors
 489
 490 =item Perl Classes
 491
 492 =item Perl Modules
 493
 494 =back
 495
 496 =item NOTE
 497
 498 =item THE PERL MODULE LIBRARY
 499
 500 =over
 501
 502 =item Pragmatic Modules
 503
 504 blib, diagnostics, integer, less, lib, locale, ops, overload, sigtrap,
 505 strict, subs, vmsish, vars
 506
 507 =item Standard Modules
 508
 509 AnyDBM_File, AutoLoader, AutoSplit, Benchmark, CPAN, CPAN::FirstTime,
 510 CPAN::Nox, Carp, Class::Template, Config, Cwd, DB_File, Devel::SelfStubber,
 511 DirHandle, DynaLoader, English, Env, Exporter, ExtUtils::Embed,
 512 ExtUtils::Install, ExtUtils::Liblist, ExtUtils::MM_OS2, ExtUtils::MM_Unix,
 513 ExtUtils::MM_VMS, ExtUtils::MakeMaker, ExtUtils::Manifest,
 514 ExtUtils::Mkbootstrap, ExtUtils::Mksymlists, ExtUtils::testlib, Fcntl,
 515 File::Basename, File::CheckTree, File::Compare, File::Copy, File::Find,
 516 File::Path, File::stat, FileCache, FileHandle, FindBin, GDBM_File,
 517 Getopt::Long, Getopt::Std, I18N::Collate, IO, IO::File, IO::Handle,
 518 IO::Pipe, IO::Seekable, IO::Select, IO::Socket, IPC::Open2, IPC::Open3,
 519 Math::BigFloat, Math::BigInt, Math::Complex, NDBM_File, Net::Ping,
 520 Net::hostent, Net::netent, Net::protoent, Net::servent, Opcode, Pod::Text,
 521 POSIX, SDBM_File, Safe, Search::Dict, SelectSaver, SelfLoader, Shell,
 522 Socket, Symbol, Sys::Hostname, Sys::Syslog, Term::Cap, Term::Complete,
 523 Term::ReadLine, Test::Harness, Text::Abbrev, Text::ParseWords,
 524 Text::Soundex, Text::Tabs, Text::Wrap, Tie::Hash, Tie::RefHash,
 525 Tie::Scalar, Tie::SubstrHash, Time::Local, Time::gmtime, Time::localtime,
 526 Time::tm, UNIVERSAL, User::grent, User::pwent
 527
 528 =item Extension Modules
 529
 530 =back
 531
 532 =item CPAN
 533
 534 Language Extensions and Documentation Tools, Development Support, Operating
 535 System Interfaces, Networking, Device Control (modems) and InterProcess
 536 Communication, Data Types and Data Type Utilities, Database Interfaces,
 537 User Interfaces, Interfaces to / Emulations of Other Programming Languages,
 538 File Names, File Systems and File Locking (see also File Handles), String
 539 Processing, Language Text Processing, Parsing, and Searching, Option,
 540 Argument, Parameter, and Configuration File Processing,
 541 Internationalization and Locale, Authentication, Security, and Encryption,
 542 World Wide Web, HTML, HTTP, CGI, MIME, Server and Daemon Utilities,
 543 Archiving and Compression, Images, Pixmap and Bitmap Manipulation, Drawing,
 544 and Graphing, Mail and Usenet News, Control Flow Utilities (callbacks and
 545 exceptions etc), File Handle and Input/Output Stream Utilities,
 546 Miscellaneous Modules
 547
 548 =item Modules: Creation, Use, and Abuse
 549
 550 =over
 551
 552 =item Guidelines for Module Creation
 553
 554 Do similar modules already exist in some form?, Try to design the new
 555 module to be easy to extend and reuse, Some simple style guidelines, Select
 556 what to export, Select a name for the module, Have you got it right?,
 557 README and other Additional Files, A description of the
 558 module/package/extension etc, A copyright notice - see below, Prerequisites
 559 - what else you may need to have, How to build it - possible changes to
 560 Makefile.PL etc, How to install it, Recent changes in this release,
 561 especially incompatibilities, Changes / enhancements you plan to make in
 562 the future, Adding a Copyright Notice, Give the module a
 563 version/issue/release number, How to release and distribute a module, Take
 564 care when changing a released module
 565
 566 =item Guidelines for Converting Perl 4 Library Scripts into Modules
 567
 568 There is no requirement to convert anything, Consider the implications,
 569 Make the most of the opportunity, The pl2pm utility will get you started,
 570 Adds the standard Module prologue lines, Converts package specifiers from '
 571 to ::, Converts die(...) to croak(...), Several other minor changes
 572
 573 =item Guidelines for Reusing Application Code
 574
 575 Complete applications rarely belong in the Perl Module Library, Many
 576 applications contain some perl code which could be reused, Break-out the
 577 reusable code into one or more separate module files, Take the opportunity
 578 to reconsider and redesign the interfaces, In some cases the 'application'
 579 can then be reduced to a small
 580
 581 =back
 582
 583 =head2 perlform - Perl formats
 584
 585 =item DESCRIPTION
 586
 587 =over
 588
 589 =item Format Variables
 590
 591 =back
 592
 593 =item NOTES
 594
 595 =over
 596
 597 =item Footers
 598
 599 =item Accessing Formatting Internals
 600
 601 =back
 602
 603 =item WARNINGS
 604
 605 =head2 perllocale - Perl locale handling (internationalization and
 606 localization)
 607
 608 =item DESCRIPTION
 609
 610 =item PREPARING TO USE LOCALES
 611
 612 =item USING LOCALES
 613
 614 =over
 615
 616 =item The use locale pragma
 617
 618 =item The setlocale function
 619
 620 =item The localeconv function
 621
 622 =back
 623
 624 =item LOCALE CATEGORIES
 625
 626 =over
 627
 628 =item Category LC_COLLATE: Collation
 629
 630 =item Category LC_CTYPE: Character Types
 631
 632 =item Category LC_NUMERIC: Numeric Formatting
 633
 634 =item Category LC_MONETARY: Formatting of monetary amounts
 635
 636 =item LC_TIME
 637
 638 =item Other categories
 639
 640 =back
 641
 642 =item SECURITY
 643
 644 B<Comparison operators> (C<lt>, C<le>, C<ge>, C<gt> and C<cmp>):,
 645 B<Case-mapping interpolation> (with C<\l>, C<\L>, C<\u> or <\U>),
 646 B<Matching operator> (C<m//>):, B<Substitution operator> (C<s///>):,
 647 B<In-memory formatting function> (sprintf()):, B<Output formatting
 648 functions> (printf() and write()):, B<Case-mapping functions> (lc(),
 649 lcfirst(), uc(), ucfirst()):, B<POSIX locale-dependent functions>
 650 (localeconv(), strcoll(),strftime(), strxfrm()):, B<POSIX character class
 651 tests> (isalnum(), isalpha(), isdigit(),isgraph(), islower(), isprint(),
 652 ispunct(), isspace(), isupper(),
 653 isxdigit()):
 654
 655 =item ENVIRONMENT
 656
 657 PERL_BADLANG, LC_ALL, LC_CTYPE, LC_COLLATE, LC_MONETARY, LC_NUMERIC,
 658 LC_TIME, LANG
 659
 660 =item NOTES
 661
 662 =over
 663
 664 =item Backward compatibility
 665
 666 =item I18N:Collate obsolete
 667
 668 =item Sort speed and memory use impacts
 669
 670 =item write() and LC_NUMERIC
 671
 672 =item Freely available locale definitions
 673
 674 =item I18n and l10n
 675
 676 =item An imperfect standard
 677
 678 =back
 679
 680 =item BUGS
 681
 682 =over
 683
 684 =item Broken systems
 685
 686 =back
 687
 688 =item SEE ALSO
 689
 690 =item HISTORY
 691
 692 =head2 perlref - Perl references and nested data structures
 693
 694 =item DESCRIPTION
 695
 696 =over
 697
 698 =item Symbolic references
 699
 700 =item Not-so-symbolic references
 701
 702 =back
 703
 704 =item WARNING
 705
 706 =item SEE ALSO
 707
 708 =head2 perldsc - Perl Data Structures Cookbook
 709
 710 =item DESCRIPTION
 711
 712 arrays of arrays, hashes of arrays, arrays of hashes, hashes of hashes,
 713 more elaborate constructs
 714
 715 =item REFERENCES
 716
 717 =item COMMON MISTAKES
 718
 719 =item CAVEAT ON PRECEDENCE
 720
 721 =item WHY YOU SHOULD ALWAYS C<use strict>
 722
 723 =item DEBUGGING
 724
 725 =item CODE EXAMPLES
 726
 727 =item LISTS OF LISTS
 728
 729 =over
 730
 731 =item Declaration of a LIST OF LISTS
 732
 733 =item Generation of a LIST OF LISTS
 734
 735 =item Access and Printing of a LIST OF LISTS
 736
 737 =back
 738
 739 =item HASHES OF LISTS
 740
 741 =over
 742
 743 =item Declaration of a HASH OF LISTS
 744
 745 =item Generation of a HASH OF LISTS
 746
 747 =item Access and Printing of a HASH OF LISTS
 748
 749 =back
 750
 751 =item LISTS OF HASHES
 752
 753 =over
 754
 755 =item Declaration of a LIST OF HASHES
 756
 757 =item Generation of a LIST OF HASHES
 758
 759 =item Access and Printing of a LIST OF HASHES
 760
 761 =back
 762
 763 =item HASHES OF HASHES
 764
 765 =over
 766
 767 =item Declaration of a HASH OF HASHES
 768
 769 =item Generation of a HASH OF HASHES
 770
 771 =item Access and Printing of a HASH OF HASHES
 772
 773 =back
 774
 775 =item MORE ELABORATE RECORDS
 776
 777 =over
 778
 779 =item Declaration of MORE ELABORATE RECORDS
 780
 781 =item Declaration of a HASH OF COMPLEX RECORDS
 782
 783 =item Generation of a HASH OF COMPLEX RECORDS
 784
 785 =back
 786
 787 =item Database Ties
 788
 789 =item SEE ALSO
 790
 791 =item AUTHOR
 792
 793 =head2 perllol, perlLoL - Manipulating Lists of Lists in Perl
 794
 795 =item DESCRIPTION
 796
 797 =item Declaration and Access of Lists of Lists
 798
 799 =item Growing Your Own
 800
 801 =item Access and Printing
 802
 803 =item Slices
 804
 805 =item SEE ALSO
 806
 807 =item AUTHOR
 808
 809 =head2 perltoot - Tom's object-oriented tutorial for perl
 810
 811 =item DESCRIPTION
 812
 813 =item Creating a Class
 814
 815 =over
 816
 817 =item Object Representation
 818
 819 =item Class Interface
 820
 821 =item Constructors and Instance Methods
 822
 823 =item Planning for the Future: Better Constructors
 824
 825 =item Destructors
 826
 827 =item Other Object Methods
 828
 829 =back
 830
 831 =item Class Data
 832
 833 =over
 834
 835 =item Accessing Class Data
 836
 837 =item Debugging Methods
 838
 839 =item Class Destructors
 840
 841 =item Documenting the Interface
 842
 843 =back
 844
 845 =item Aggregation
 846
 847 =item Inheritance
 848
 849 =over
 850
 851 =item Overridden Methods
 852
 853 =item Multiple Inheritance
 854
 855 =item UNIVERSAL: The Root of All Objects
 856
 857 =back
 858
 859 =item Alternate Object Representations
 860
 861 =over
 862
 863 =item Arrays as Objects
 864
 865 =item Closures as Objects
 866
 867 =back
 868
 869 =item AUTOLOAD: Proxy Methods
 870
 871 =over
 872
 873 =item Autoloaded Data Methods
 874
 875 =item Inherited Autoloaded Data Methods
 876
 877 =back
 878
 879 =item Metaclassical Tools
 880
 881 =over
 882
 883 =item Class::Template
 884
 885 =item Data Members as Variables
 886
 887 =item NOTES
 888
 889 =item Object Terminology
 890
 891 =back
 892
 893 =item SEE ALSO
 894
 895 =item COPYRIGHT
 896
 897 =over
 898
 899 =item Acknowledgments
 900
 901 =back
 902
 903 =head2 perlobj - Perl objects
 904
 905 =item DESCRIPTION
 906
 907 =over
 908
 909 =item An Object is Simply a Reference
 910
 911 =item A Class is Simply a Package
 912
 913 =item A Method is Simply a Subroutine
 914
 915 =item Method Invocation
 916
 917 =item Default UNIVERSAL methods
 918
 919 isa(CLASS), can(METHOD), VERSION( [NEED] )
 920
 921 =item Destructors
 922
 923 =item WARNING
 924
 925 =item Summary
 926
 927 =item Two-Phased Garbage Collection
 928
 929 =back
 930
 931 =item SEE ALSO
 932
 933 =head2 perltie - how to hide an object class in a simple variable
 934
 935 =item SYNOPSIS
 936
 937 =item DESCRIPTION
 938
 939 =over
 940
 941 =item Tying Scalars
 942
 943 TIESCALAR classname, LIST, FETCH this, STORE this, value, DESTROY this
 944
 945 =item Tying Arrays
 946
 947 TIEARRAY classname, LIST, FETCH this, index, STORE this, index, value,
 948 DESTROY this
 949
 950 =item Tying Hashes
 951
 952 USER, HOME, CLOBBER, LIST, TIEHASH classname, LIST, FETCH this, key, STORE
 953 this, key, value, DELETE this, key, CLEAR this, EXISTS this, key, FIRSTKEY
 954 this, NEXTKEY this, lastkey, DESTROY this
 955
 956 =item Tying FileHandles
 957
 958 TIEHANDLE classname, LIST, PRINT this, LIST, READLINE this, DESTROY this
 959
 960 =item The C<untie> Gotcha
 961
 962 =back
 963
 964 =item SEE ALSO
 965
 966 =item BUGS
 967
 968 =item AUTHOR
 969
 970 =head2 perlbot - Bag'o Object Tricks (the BOT)
 971
 972 =item DESCRIPTION
 973
 974 =item OO SCALING TIPS
 975
 976 =item INSTANCE VARIABLES
 977
 978 =item SCALAR INSTANCE VARIABLES
 979
 980 =item INSTANCE VARIABLE INHERITANCE
 981
 982 =item OBJECT RELATIONSHIPS
 983
 984 =item OVERRIDING SUPERCLASS METHODS
 985
 986 =item USING RELATIONSHIP WITH SDBM
 987
 988 =item THINKING OF CODE REUSE
 989
 990 =item CLASS CONTEXT AND THE OBJECT
 991
 992 =item INHERITING A CONSTRUCTOR
 993
 994 =item DELEGATION
 995
 996 =head2 perlipc - Perl interprocess communication (signals, fifos, pipes,
 997 safe subprocesses, sockets, and semaphores)
 998
 999 =item DESCRIPTION
1000
1001 =item Signals
1002
1003 =item Named Pipes
1004
1005 =item Using open() for IPC
1006
1007 =over
1008
1009 =item Safe Pipe Opens
1010
1011 =item Bidirectional Communication
1012
1013 =back
1014
1015 =item Sockets: Client/Server Communication
1016
1017 =over
1018
1019 =item Internet TCP Clients and Servers
1020
1021 =item Unix-Domain TCP Clients and Servers
1022
1023 =item UDP: Message Passing
1024
1025 =back
1026
1027 =item SysV IPC
1028
1029 =item WARNING
1030
1031 =item NOTES
1032
1033 =item BUGS
1034
1035 =item AUTHOR
1036
1037 =item SEE ALSO
1038
1039 =head2 perldebug - Perl debugging
1040
1041 =item DESCRIPTION
1042
1043 =item The Perl Debugger
1044
1045 =over
1046
1047 =item Debugger Commands
1048
1049 h [command], p expr, x expr, V [pkg [vars]], X [vars], T, s [expr], n
1050 [expr], E<lt>CRE<gt>, c [line|sub], l, l min+incr, l min-max, l line, l
1051 subname, -, w [line], f filename, /pattern/, ?pattern?, L, S [[!]pattern],
1052 t, t expr, b [line] [condition], b subname [condition], b postpone subname
1053 [condition], b load filename, b compile subname, d [line], D, a [line]
1054 command, A, O [opt[=val]] [opt"val"] [opt?].., C<recallCommand>,
1055 C<ShellBang>, C<pager>, C<tkRunning>, C<signalLevel>, C<warnLevel>,
1056 C<dieLevel>, C<AutoTrace>, C<LineInfo>, C<inhibit_exit>, C<PrintRet>,
1057 C<frame>, C<maxTraceLen>, C<arrayDepth>, C<hashDepth>, C<compactDump>,
1058 C<veryCompact>, C<globPrint>, C<DumpDBFiles>, C<DumpPackages>, C<quote>,
1059 C<HighBit>, C<undefPrint>, C<UsageOnly>, C<TTY>, C<noTTY>, C<ReadLine>,
1060 C<NonStop>, E<lt> [ command ], E<lt>E<lt> command, E<gt> command,
1061 E<gt>E<gt> command, { [ command ], {{ command, ! number, ! -number, !
1062 pattern, !! cmd, H -number, q or ^D, R, |dbcmd, ||dbcmd, = [alias value],
1063 command, m expr, m package
1064
1065 =item Debugger input/output
1066
1067 Prompt, Multi-line commands, Stack backtrace, Listing, Frame listing
1068
1069 =item Debugging compile-time statements
1070
1071 =item Debugger Customization
1072
1073 =item Readline Support
1074
1075 =item Editor Support for Debugging
1076
1077 =item The Perl Profiler
1078
1079 =item Debugger support in perl
1080
1081 =item Debugger Internals
1082
1083 =item Other resources
1084
1085 =back
1086
1087 =item BUGS
1088
1089 =head2 perldiag - various Perl diagnostics
1090
1091 =item DESCRIPTION
1092
1093 =head2 perlsec - Perl security
1094
1095 =item DESCRIPTION
1096
1097 =over
1098
1099 =item Laundering and Detecting Tainted Data
1100
1101 =item Cleaning Up Your Path
1102
1103 =item Security Bugs
1104
1105 =back
1106
1107 =head2 perltrap - Perl traps for the unwary
1108
1109 =item DESCRIPTION
1110
1111 =over
1112
1113 =item Awk Traps
1114
1115 =item C Traps
1116
1117 =item Sed Traps
1118
1119 =item Shell Traps
1120
1121 =item Perl Traps
1122
1123 =item Perl4 to Perl5 Traps
1124
1125 Discontinuance, Deprecation, and BugFix traps, Parsing Traps, Numerical
1126 Traps, General data type traps, Context Traps - scalar, list contexts,
1127 Precedence Traps, General Regular Expression Traps using s///, etc,
1128 Subroutine, Signal, Sorting Traps, OS Traps, DBM Traps, Unclassified Traps
1129
1130 =item Discontinuance, Deprecation, and BugFix traps
1131
1132 Discontinuance, Deprecation, BugFix, Discontinuance, Discontinuance,
1133 Discontinuance, BugFix, Discontinuance, Discontinuance, BugFix,
1134 Discontinuance, Deprecation, Discontinuance
1135
1136 =item Parsing Traps
1137
1138 Parsing, Parsing, Parsing
1139
1140 =item Numerical Traps
1141
1142 Numerical, Numerical, Numerical
1143
1144 =item General data type traps
1145
1146 (Arrays), (Arrays), (Hashes), (Globs), (Scalar String), (Constants),
1147 (Scalars), (Variable Suicide)
1148
1149 =item Context Traps - scalar, list contexts
1150
1151 (list context), (scalar context), (scalar context), (list, builtin)
1152
1153 =item Precedence Traps
1154
1155 Precedence, Precedence, Precedence, Precedence, Precedence, Precedence,
1156 Precedence
1157
1158 =item General Regular Expression Traps using s///, etc.
1159
1160 Regular Expression, Regular Expression, Regular Expression, Regular
1161 Expression, Regular Expression, Regular Expression, Regular Expression,
1162 Regular Expression
1163
1164 =item Subroutine, Signal, Sorting Traps
1165
1166 (Signals), (Sort Subroutine), warn() won't let you specify a filehandle
1167
1168 =item OS Traps
1169
1170 (SysV), (SysV)
1171
1172 =item Interpolation Traps
1173
1174 Interpolation, Interpolation, Interpolation, Interpolation, Interpolation,
1175 Interpolation, Interpolation, Interpolation, Interpolation
1176
1177 =item DBM Traps
1178
1179 DBM, DBM
1180
1181 =item Unclassified Traps
1182
1183 Unclassified
1184
1185 =back
1186
1187 =head2 perlstyle - Perl style guide
1188
1189 =item DESCRIPTION
1190
1191 =head2 perlpod - plain old documentation
1192
1193 =item DESCRIPTION
1194
1195 =item Embedding Pods in Perl Modules
1196
1197 =item Common Pod Pitfalls
1198
1199 =item SEE ALSO
1200
1201 =item AUTHOR
1202
1203 =head2 perlbook - Perl book information
1204
1205 =item DESCRIPTION
1206
1207 =head2 perlembed - how to embed perl in your C program
1208
1209 =item DESCRIPTION
1210
1211 =over
1212
1213 =item PREAMBLE
1214
1215 B<Use C from Perl?>, B<Use a UNIX program from Perl?>, B<Use Perl from
1216 Perl?>, B<Use C from C?>, B<Use Perl from C?>
1217
1218 =item ROADMAP
1219
1220 =item Compiling your C program
1221
1222 =item Adding a Perl interpreter to your C program
1223
1224 =item Calling a Perl subroutine from your C program
1225
1226 =item Evaluating a Perl statement from your C program
1227
1228 =item Performing Perl pattern matches and substitutions from your C program
1229
1230 =item Fiddling with the Perl stack from your C program
1231
1232 =item Maintaining a persistent interpreter
1233
1234 =item Maintaining multiple interpreter instances
1235
1236 =item Using Perl modules, which themselves use C libraries, from your C
1237 program
1238
1239 =back
1240
1241 =item MORAL
1242
1243 =item AUTHOR
1244
1245 =item COPYRIGHT
1246
1247 =head2 perlapio - perl's IO abstraction interface.
1248
1249 =item SYNOPSIS
1250
1251 =item DESCRIPTION
1252
1253 B<PerlIO *>, B<PerlIO_stdin()>, B<PerlIO_stdout()>, B<PerlIO_stderr()>,
1254 B<PerlIO_open(path, mode)>, B<PerlIO_fdopen(fd,mode)>,
1255 B<PerlIO_printf(f,fmt,...)>, B<PerlIO_vprintf(f,fmt,a)>,
1256 B<PerlIO_stdoutf(fmt,...)>, B<PerlIO_read(f,buf,count)>,
1257 B<PerlIO_write(f,buf,count)>, B<PerlIO_close(f)>, B<PerlIO_puts(s,f)>,
1258 B<PerlIO_putc(c,f)>, B<PerlIO_ungetc(c,f)>, B<PerlIO_getc(f)>,
1259 B<PerlIO_eof(f)>, B<PerlIO_error(f)>, B<PerlIO_fileno(f)>,
1260 B<PerlIO_clearerr(f)>, B<PerlIO_flush(f)>, B<PerlIO_tell(f)>,
1261 B<PerlIO_seek(f,o,w)>, B<PerlIO_getpos(f,p)>, B<PerlIO_setpos(f,p)>,
1262 B<PerlIO_rewind(f)>, B<PerlIO_tmpfile()>
1263
1264 =over
1265
1266 =item Co-existence with stdio
1267
1268 B<PerlIO_importFILE(f,flags)>, B<PerlIO_exportFILE(f,flags)>,
1269 B<PerlIO_findFILE(f)>, B<PerlIO_releaseFILE(p,f)>, B<PerlIO_setlinebuf(f)>,
1270 B<PerlIO_has_cntptr(f)>, B<PerlIO_get_ptr(f)>, B<PerlIO_get_cnt(f)>,
1271 B<PerlIO_canset_cnt(f)>, B<PerlIO_fast_gets(f)>,
1272 B<PerlIO_set_ptrcnt(f,p,c)>, B<PerlIO_set_cnt(f,c)>, B<PerlIO_has_base(f)>,
1273 B<PerlIO_get_base(f)>, B<PerlIO_get_bufsiz(f)>
1274
1275 =back
1276
1277 =head2 perlxs - XS language reference manual
1278
1279 =item DESCRIPTION
1280
1281 =over
1282
1283 =item Introduction
1284
1285 =item On The Road
1286
1287 =item The Anatomy of an XSUB
1288
1289 =item The Argument Stack
1290
1291 =item The RETVAL Variable
1292
1293 =item The MODULE Keyword
1294
1295 =item The PACKAGE Keyword
1296
1297 =item The PREFIX Keyword
1298
1299 =item The OUTPUT: Keyword
1300
1301 =item The CODE: Keyword
1302
1303 =item The INIT: Keyword
1304
1305 =item The NO_INIT Keyword
1306
1307 =item Initializing Function Parameters
1308
1309 =item Default Parameter Values
1310
1311 =item The PREINIT: Keyword
1312
1313 =item The SCOPE: Keyword
1314
1315 =item The INPUT: Keyword
1316
1317 =item Variable-length Parameter Lists
1318
1319 =item The PPCODE: Keyword
1320
1321 =item Returning Undef And Empty Lists
1322
1323 =item The REQUIRE: Keyword
1324
1325 =item The CLEANUP: Keyword
1326
1327 =item The BOOT: Keyword
1328
1329 =item The VERSIONCHECK: Keyword
1330
1331 =item The PROTOTYPES: Keyword
1332
1333 =item The PROTOTYPE: Keyword
1334
1335 =item The ALIAS: Keyword
1336
1337 =item The INCLUDE: Keyword
1338
1339 =item The CASE: Keyword
1340
1341 =item The & Unary Operator
1342
1343 =item Inserting Comments and C Preprocessor Directives
1344
1345 =item Using XS With C++
1346
1347 =item Interface Strategy
1348
1349 =item Perl Objects And C Structures
1350
1351 =item The Typemap
1352
1353 =back
1354
1355 =item EXAMPLES
1356
1357 =item XS VERSION
1358
1359 =item AUTHOR
1360
1361 =head2 perlxstut, perlXStut - Tutorial for XSUBs
1362
1363 =item DESCRIPTION
1364
1365 =over
1366
1367 =item VERSION CAVEAT
1368
1369 =item DYNAMIC VERSUS STATIC
1370
1371 =item EXAMPLE 1
1372
1373 =item EXAMPLE 2
1374
1375 =item WHAT HAS GONE ON?
1376
1377 =item WRITING GOOD TEST SCRIPTS
1378
1379 =item EXAMPLE 3
1380
1381 =item WHAT'S NEW HERE?
1382
1383 =item INPUT AND OUTPUT PARAMETERS
1384
1385 =item THE XSUBPP COMPILER
1386
1387 =item THE TYPEMAP FILE
1388
1389 =item WARNING
1390
1391 =item EXAMPLE 4
1392
1393 =item WHAT HAS HAPPENED HERE?
1394
1395 =item SPECIFYING ARGUMENTS TO XSUBPP
1396
1397 =item THE ARGUMENT STACK
1398
1399 =item EXTENDING YOUR EXTENSION
1400
1401 =item DOCUMENTING YOUR EXTENSION
1402
1403 =item INSTALLING YOUR EXTENSION
1404
1405 =item SEE ALSO
1406
1407 =item Author
1408
1409 =item Last Changed
1410
1411 =back
1412
1413 =head2 perlguts - Perl's Internal Functions
1414
1415 =item DESCRIPTION
1416
1417 =item Variables
1418
1419 =over
1420
1421 =item Datatypes
1422
1423 =item What is an "IV"?
1424
1425 =item Working with SV's
1426
1427 =item What's Really Stored in an SV?
1428
1429 =item Working with AV's
1430
1431 =item Working with HV's
1432
1433 =item References
1434
1435 =item Blessed References and Class Objects
1436
1437 =item Creating New Variables
1438
1439 =item Reference Counts and Mortality
1440
1441 =item Stashes and Globs
1442
1443 =item Double-Typed SV's
1444
1445 =item Magic Variables
1446
1447 =item Assigning Magic
1448
1449 =item Magic Virtual Tables
1450
1451 =item Finding Magic
1452
1453 =back
1454
1455 =item Subroutines
1456
1457 =over
1458
1459 =item XSUB's and the Argument Stack
1460
1461 =item Calling Perl Routines from within C Programs
1462
1463 =item Memory Allocation
1464
1465 =item PerlIO
1466
1467 =item Putting a C value on Perl stack
1468
1469 =item Scratchpads
1470
1471 =item Scratchpads and recursions
1472
1473 =back
1474
1475 =item Compiled code
1476
1477 =over
1478
1479 =item Code tree
1480
1481 =item Examining the tree
1482
1483 =item Compile pass 1: check routines
1484
1485 =item Compile pass 1a: constant folding
1486
1487 =item Compile pass 2: context propagation
1488
1489 =item Compile pass 3: peephole optimization
1490
1491 =back
1492
1493 =item API LISTING
1494
1495 AvFILL, av_clear, av_extend, av_fetch, av_len, av_make, av_pop, av_push,
1496 av_shift, av_store, av_undef, av_unshift, CLASS, Copy, croak, CvSTASH,
1497 DBsingle, DBsub, DBtrace, dMARK, dORIGMARK, dowarn, dSP, dXSARGS, dXSI32,
1498 dXSI32, ENTER, EXTEND, FREETMPS, G_ARRAY, G_DISCARD, G_EVAL, GIMME,
1499 G_NOARGS, G_SCALAR, gv_fetchmeth, gv_fetchmethod, gv_stashpv, gv_stashsv,
1500 GvSV, he_delayfree, he_free, hv_clear, hv_delete, hv_exists, hv_fetch,
1501 hv_iterinit, hv_iterkey, hv_iternext, hv_iternextsv, hv_iterval, hv_magic,
1502 HvNAME, hv_store, hv_undef, isALNUM, isALPHA, isDIGIT, isLOWER, isSPACE,
1503 isUPPER, items, ix, LEAVE, MARK, mg_clear, mg_copy, mg_find, mg_free,
1504 mg_get, mg_len, mg_magical, mg_set, Move, na, New, Newc, Newz, newAV,
1505 newHV, newRV_inc, newRV_noinc, newSV, newSViv, newSVnv, newSVpv, newSVrv,
1506 newSVsv, newXS, newXSproto, Nullav, Nullch, Nullcv, Nullhv, Nullsv,
1507 ORIGMARK, perl_alloc, perl_call_argv, perl_call_method, perl_call_pv,
1508 perl_call_sv, perl_construct, perl_destruct, perl_eval_sv, perl_free,
1509 perl_get_av, perl_get_cv, perl_get_hv, perl_get_sv, perl_parse,
1510 perl_require_pv, perl_run, POPi, POPl, POPp, POPn, POPs, PUSHMARK, PUSHi,
1511 PUSHn, PUSHp, PUSHs, PUTBACK, Renew, Renewc, RETVAL, safefree, safemalloc,
1512 saferealloc, savepv, savepvn, SAVETMPS, SP, SPAGAIN, ST, strEQ, strGE,
1513 strGT, strLE, strLT, strNE, strnEQ, strnNE, sv_2mortal, sv_bless, sv_catpv,
1514 sv_catpvn, sv_catsv, sv_cmp, sv_cmp, SvCUR, SvCUR_set, sv_dec, sv_dec,
1515 SvEND, sv_eq, SvGROW, sv_grow, sv_inc, SvIOK, SvIOK_off, SvIOK_on,
1516 SvIOK_only, SvIOK_only, SvIOKp, sv_isa, SvIV, sv_isobject, SvIVX, SvLEN,
1517 sv_len, sv_len, sv_magic, sv_mortalcopy, SvOK, sv_newmortal, sv_no, SvNIOK,
1518 SvNIOK_off, SvNIOKp, SvNOK, SvNOK_off, SvNOK_on, SvNOK_only, SvNOK_only,
1519 SvNOKp, SvNV, SvNVX, SvPOK, SvPOK_off, SvPOK_on, SvPOK_only, SvPOK_only,
1520 SvPOKp, SvPV, SvPVX, SvREFCNT, SvREFCNT_dec, SvREFCNT_inc, SvROK,
1521 SvROK_off, SvROK_on, SvRV, sv_setiv, sv_setnv, sv_setpv, sv_setpvn,
1522 sv_setref_iv, sv_setref_nv, sv_setref_pv, sv_setref_pvn, sv_setsv, SvSTASH,
1523 SVt_IV, SVt_PV, SVt_PVAV, SVt_PVCV, SVt_PVHV, SVt_PVMG, SVt_NV, SvTRUE,
1524 SvTYPE, svtype, SvUPGRADE, sv_upgrade, sv_undef, sv_unref, sv_usepvn,
1525 sv_yes, THIS, toLOWER, toUPPER, warn, XPUSHi, XPUSHn, XPUSHp, XPUSHs, XS,
1526 XSRETURN, XSRETURN_EMPTY, XSRETURN_IV, XSRETURN_NO, XSRETURN_NV,
1527 XSRETURN_PV, XSRETURN_UNDEF, XSRETURN_YES, XST_mIV, XST_mNV, XST_mNO,
1528 XST_mPV, XST_mUNDEF, XST_mYES, XS_VERSION, XS_VERSION_BOOTCHECK, Zero
1529
1530 =item EDITOR
1531
1532 =item DATE
1533
1534 =head2 perlcall - Perl calling conventions from C
1535
1536 =item DESCRIPTION
1537
1538 An Error Handler, An Event Driven Program
1539
1540 =item THE PERL_CALL FUNCTIONS
1541
1542 B<perl_call_sv>, B<perl_call_pv>, B<perl_call_method>, B<perl_call_argv>
1543
1544 =item FLAG VALUES
1545
1546 =over
1547
1548 =item  G_SCALAR
1549
1550 =item G_ARRAY
1551
1552 =item G_DISCARD
1553
1554 =item G_NOARGS
1555
1556 =item G_EVAL
1557
1558 =item G_KEEPERR
1559
1560 =item Determining the Context
1561
1562 =back
1563
1564 =item KNOWN PROBLEMS
1565
1566 =item EXAMPLES
1567
1568 =over
1569
1570 =item No Parameters, Nothing returned
1571
1572 =item Passing Parameters
1573
1574 =item Returning a Scalar
1575
1576 =item Returning a list of values
1577
1578 =item Returning a list in a scalar context
1579
1580 =item Returning Data from Perl via the parameter list
1581
1582 =item Using G_EVAL
1583
1584 =item Using G_KEEPERR
1585
1586 =item Using perl_call_sv
1587
1588 =item Using perl_call_argv
1589
1590 =item Using perl_call_method
1591
1592 =item Using GIMME
1593
1594 =item Using Perl to dispose of temporaries
1595
1596 =item Strategies for storing Callback Context Information
1597
1598 1. Ignore the problem - Allow only 1 callback, 2. Create a sequence of
1599 callbacks - hard wired limit, 3. Use a parameter to map to the Perl
1600 callback
1601
1602 =item Alternate Stack Manipulation
1603
1604 =back
1605
1606 =item SEE ALSO
1607
1608 =item AUTHOR
1609
1610 =item DATE
1611
1612 =head1 PRAGMA DOCUMENTATION
1613
1614 =head2 blib - Use MakeMaker's uninstalled version of a package
1615
1616 =item SYNOPSIS
1617
1618 =item DESCRIPTION
1619
1620 =item BUGS
1621
1622 =item AUTHOR
1623
1624 =head2 diagnostics - Perl compiler pragma to force verbose warning
1625 diagnostics
1626
1627 =item SYNOPSIS
1628
1629 =item DESCRIPTION
1630
1631 =over
1632
1633 =item The C<diagnostics> Pragma
1634
1635 =item The I<splain> Program
1636
1637 =back
1638
1639 =item EXAMPLES
1640
1641 =item INTERNALS
1642
1643 =item BUGS
1644
1645 =item AUTHOR
1646
1647 =head2 integer - Perl pragma to compute arithmetic in integer instead of
1648 double
1649
1650 =item SYNOPSIS
1651
1652 =item DESCRIPTION
1653
1654 =head2 less - perl pragma to request less of something from the compiler
1655
1656 =item SYNOPSIS
1657
1658 =item DESCRIPTION
1659
1660 =head2 lib - manipulate @INC at compile time
1661
1662 =item SYNOPSIS
1663
1664 =item DESCRIPTION
1665
1666 =over
1667
1668 =item ADDING DIRECTORIES TO @INC
1669
1670 =item DELETING DIRECTORIES FROM @INC
1671
1672 =item RESTORING ORIGINAL @INC
1673
1674 =back
1675
1676 =item SEE ALSO
1677
1678 =item AUTHOR
1679
1680 =head2 locale - Perl pragma to use and avoid POSIX locales for built-in
1681 operations
1682
1683 =item SYNOPSIS
1684
1685 =item DESCRIPTION
1686
1687 =head2 ops - Perl pragma to restrict unsafe operations when compiling
1688
1689 =item SYNOPSIS
1690
1691 =item DESCRIPTION
1692
1693 =item SEE ALSO
1694
1695 =head2 overload - Package for overloading perl operations
1696
1697 =item SYNOPSIS
1698
1699 =item CAVEAT SCRIPTOR
1700
1701 =item DESCRIPTION
1702
1703 =over
1704
1705 =item Declaration of overloaded functions
1706
1707 =item Calling Conventions for Binary Operations
1708
1709 FALSE, TRUE, C<undef>
1710
1711 =item Calling Conventions for Unary Operations
1712
1713 =item Overloadable Operations
1714
1715 I<Arithmetic operations>, I<Comparison operations>, I<Bit operations>,
1716 I<Increment and decrement>, I<Transcendental functions>, I<Boolean, string
1717 and numeric conversion>, I<Special>
1718
1719 =item Inheritance and overloading
1720
1721 Strings as values of C<use overload> directive, Overloading of an operation
1722 is inherited by derived classes
1723
1724 =back
1725
1726 =item SPECIAL SYMBOLS FOR C<use overload>
1727
1728 =over
1729
1730 =item Last Resort
1731
1732 =item Fallback
1733
1734 C<undef>, TRUE, defined, but FALSE
1735
1736 =item Copy Constructor
1737
1738 B<Example>
1739
1740 =back
1741
1742 =item MAGIC AUTOGENERATION
1743
1744 I<Assignment forms of arithmetic operations>, I<Conversion operations>,
1745 I<Increment and decrement>, C<abs($a)>, I<Unary minus>, I<Negation>,
1746 I<Concatenation>, I<Comparison operations>, I<Copy operator>
1747
1748 =item WARNING
1749
1750 =item Run-time Overloading
1751
1752 =item Public functions
1753
1754 overload::StrVal(arg), overload::Overloaded(arg), overload::Method(obj,op)
1755
1756 =item IMPLEMENTATION
1757
1758 =item AUTHOR
1759
1760 =item DIAGNOSTICS
1761
1762 =item BUGS
1763
1764 =head2 sigtrap - Perl pragma to enable simple signal handling
1765
1766 =item SYNOPSIS
1767
1768 =item DESCRIPTION
1769
1770 =item OPTIONS
1771
1772 =over
1773
1774 =item SIGNAL HANDLERS
1775
1776 B<stack-trace>, B<die>, B<handler> I<your-handler>
1777
1778 =item SIGNAL LISTS
1779
1780 B<normal-signals>, B<error-signals>, B<old-interface-signals>
1781
1782 =item OTHER
1783
1784 B<untrapped>, B<any>, I<signal>, I<number>
1785
1786 =back
1787
1788 =item EXAMPLES
1789
1790 =head2 strict - Perl pragma to restrict unsafe constructs
1791
1792 =item SYNOPSIS
1793
1794 =item DESCRIPTION
1795
1796 C<strict refs>, C<strict vars>, C<strict subs>
1797
1798 =head2 subs - Perl pragma to predeclare sub names
1799
1800 =item SYNOPSIS
1801
1802 =item DESCRIPTION
1803
1804 =head2 vars - Perl pragma to predeclare global variable names
1805
1806 =item SYNOPSIS
1807
1808 =item DESCRIPTION
1809
1810 =head1 MODULE DOCUMENTATION
1811
1812 =head2 AnyDBM_File - provide framework for multiple DBMs
1813
1814 =item SYNOPSIS
1815
1816 =item DESCRIPTION
1817
1818 =over
1819
1820 =item DBM Comparisons
1821
1822 [0], [1], [2], [3]
1823
1824 =back
1825
1826 =item SEE ALSO
1827
1828 =head2 AutoLoader - load functions only on demand
1829
1830 =item SYNOPSIS
1831
1832 =item DESCRIPTION
1833
1834 =over
1835
1836 =item __END__
1837
1838 =item Loading Stubs
1839
1840 =item Package Lexicals
1841
1842 =item AutoLoader vs. SelfLoader
1843
1844 =back
1845
1846 =item CAVEAT
1847
1848 =head2 AutoSplit - split a package for autoloading
1849
1850 =item SYNOPSIS
1851
1852 =item DESCRIPTION
1853
1854 =item CAVEATS
1855
1856 =item DIAGNOSTICS
1857
1858 =head2 Benchmark - benchmark running times of code
1859
1860 =item SYNOPSIS
1861
1862 =item DESCRIPTION
1863
1864 =over
1865
1866 =item Methods
1867
1868 new, debug
1869
1870 =item Standard Exports
1871
1872 timeit(COUNT, CODE), timethis, timethese, timediff, timestr
1873
1874 =item Optional Exports
1875
1876 =back
1877
1878 =item NOTES
1879
1880 =item INHERITANCE
1881
1882 =item CAVEATS
1883
1884 =item AUTHORS
1885
1886 =item MODIFICATION HISTORY
1887
1888 =head2 Bundle::CPAN - A bundle to play with all the other modules on CPAN
1889
1890 =item SYNOPSIS
1891
1892 =item CONTENTS
1893
1894 =item DESCRIPTION
1895
1896 =item AUTHOR
1897
1898 =head2 CPAN - query, download and build perl modules from CPAN sites
1899
1900 =item SYNOPSIS
1901
1902 =item DESCRIPTION
1903
1904 =over
1905
1906 =item Interactive Mode
1907
1908 Searching for authors, bundles, distribution files and modules, make, test,
1909 install, clean  modules or distributions, readme, look module or
1910 distribution
1911
1912 =item CPAN::Shell
1913
1914 =item autobundle
1915
1916 =item recompile
1917
1918 =item ProgrammerE<39>s interface
1919
1920 =item Cache Manager
1921
1922 =item Bundles
1923
1924 =item Prerequisites
1925
1926 =item Debugging
1927
1928 =item Floppy, Zip, and all that Jazz
1929
1930 =back
1931
1932 =item CONFIGURATION
1933
1934 o conf E<lt>scalar optionE<gt>, o conf E<lt>scalar optionE<gt>
1935 E<lt>valueE<gt>, o conf E<lt>list optionE<gt>, o conf E<lt>list optionE<gt>
1936 [shift|pop], o conf E<lt>list optionE<gt> [unshift|push|splice]
1937 E<lt>listE<gt>
1938
1939 =item SECURITY
1940
1941 =item EXPORT
1942
1943 =item BUGS
1944
1945 =item AUTHOR
1946
1947 =item SEE ALSO
1948
1949 =head2 CPAN::FirstTime - Utility for CPAN::Config file Initialization
1950
1951 =item SYNOPSIS
1952
1953 =item DESCRIPTION
1954
1955 =head2 CPANox, CPAN::Nox - Wrapper around CPAN.pm without using any XS
1956 module
1957
1958 =item SYNOPSIS
1959
1960 =item DESCRIPTION
1961
1962 =item  SEE ALSO
1963
1964 =head2 Carp, carp - warn of errors (from perspective of caller)
1965
1966 =item SYNOPSIS
1967
1968 =item DESCRIPTION
1969
1970 =head2 Class::Template - struct/member template builder
1971
1972 =item SYNOPSIS
1973
1974 =item DESCRIPTION
1975
1976 =item EXAMPLES
1977
1978 Example 1, Example 2
1979
1980 =item NOTES
1981
1982 =head2 Config - access Perl configuration information
1983
1984 =item SYNOPSIS
1985
1986 =item DESCRIPTION
1987
1988 myconfig(), config_sh(), config_vars(@names)
1989
1990 =item EXAMPLE
1991
1992 =item WARNING
1993
1994 =item NOTE
1995
1996 =head2 Cwd, getcwd - get pathname of current working directory
1997
1998 =item SYNOPSIS
1999
2000 =item DESCRIPTION
2001
2002 =head2 DB_File - Perl5 access to Berkeley DB
2003
2004 =item SYNOPSIS
2005
2006 =item DESCRIPTION
2007
2008 B<DB_HASH>, B<DB_BTREE>, B<DB_RECNO>
2009
2010 =over
2011
2012 =item How does DB_File interface to Berkeley DB?
2013
2014 =item Opening a Berkeley DB Database File
2015
2016 =item Default Parameters
2017
2018 =item In Memory Databases
2019
2020 =back
2021
2022 =item DB_HASH
2023
2024 =over
2025
2026 =item A Simple Example.
2027
2028 =back
2029
2030 =item DB_BTREE
2031
2032 =over
2033
2034 =item Changing the BTREE sort order
2035
2036 =item Handling duplicate keys
2037
2038 =item The get_dup method.
2039
2040 =item Matching Partial Keys
2041
2042 =back
2043
2044 =item DB_RECNO
2045
2046 =over
2047
2048 =item The bval option
2049
2050 =item A Simple Example
2051
2052 =item Extra Methods
2053
2054 B<$X-E<gt>push(list) ;>, B<$value = $X-E<gt>pop ;>, B<$X-E<gt>shift>,
2055 B<$X-E<gt>unshift(list) ;>, B<$X-E<gt>length>
2056
2057 =item Another Example
2058
2059 =back
2060
2061 =item THE API INTERFACE
2062
2063 B<$status = $X-E<gt>get($key, $value [, $flags]) ;>, B<$status =
2064 $X-E<gt>put($key, $value [, $flags]) ;>, B<$status = $X-E<gt>del($key [,
2065 $flags]) ;>, B<$status = $X-E<gt>fd ;>, B<$status = $X-E<gt>seq($key,
2066 $value, $flags) ;>, B<$status = $X-E<gt>sync([$flags]) ;>
2067
2068 =item HINTS AND TIPS
2069
2070 =over
2071
2072 =item Locking Databases
2073
2074 =item Sharing databases with C applications
2075
2076 =item The untie gotcha
2077
2078 =back
2079
2080 =item COMMON QUESTIONS
2081
2082 =over
2083
2084 =item Why is there Perl source in my database?
2085
2086 =item How do I store complex data structures with DB_File?
2087
2088 =item What does "Invalid Argument" mean?
2089
2090 =item What does "Bareword 'DB_File' not allowed" mean?
2091
2092 =back
2093
2094 =item HISTORY
2095
2096 =item BUGS
2097
2098 =item AVAILABILITY
2099
2100 =item SEE ALSO
2101
2102 =item AUTHOR
2103
2104 =head2 Devel::SelfStubber - generate stubs for a SelfLoading module
2105
2106 =item SYNOPSIS
2107
2108 =item DESCRIPTION
2109
2110 =head2 DirHandle - supply object methods for directory handles
2111
2112 =item SYNOPSIS
2113
2114 =item DESCRIPTION
2115
2116 =head2 DynaLoader - Dynamically load C libraries into Perl code
2117
2118 =item SYNOPSIS
2119
2120 =item DESCRIPTION
2121
2122 @dl_library_path, @dl_resolve_using, @dl_require_symbols, @dl_librefs,
2123 @dl_modules, dl_error(), $dl_debug, dl_findfile(), dl_expandspec(),
2124 dl_load_file(), dl_loadflags(), dl_find_symbol(),
2125 dl_find_symbol_anywhere(), dl_undef_symbols(), dl_install_xsub(),
2126 bootstrap()
2127
2128 =item AUTHOR
2129
2130 =head2 English - use nice English (or awk) names for ugly punctuation
2131 variables
2132
2133 =item SYNOPSIS
2134
2135 =item DESCRIPTION
2136
2137 =head2 Env - perl module that imports environment variables
2138
2139 =item SYNOPSIS
2140
2141 =item DESCRIPTION
2142
2143 =item AUTHOR
2144
2145 =head2 Exporter - Implements default import method for modules
2146
2147 =item SYNOPSIS
2148
2149 =item DESCRIPTION
2150
2151 =over
2152
2153 =item Selecting What To Export
2154
2155 =item Specialised Import Lists
2156
2157 =item Module Version Checking
2158
2159 =item Managing Unknown Symbols
2160
2161 =item Tag Handling Utility Functions
2162
2163 =back
2164
2165 =head2 ExtUtils::Embed - Utilities for embedding Perl in C/C++ applications
2166
2167 =item SYNOPSIS
2168
2169 =item DESCRIPTION
2170
2171 =item @EXPORT
2172
2173 =item FUNCTIONS
2174
2175 xsinit(), Examples, ldopts(), Examples, perl_inc(), ccflags(), ccdlflags(),
2176 ccopts(), xsi_header(), xsi_protos(@modules), xsi_body(@modules)
2177
2178 =item EXAMPLES
2179
2180 =item SEE ALSO
2181
2182 =item AUTHOR
2183
2184 =head2 ExtUtils::Install - install files from here to there
2185
2186 =item SYNOPSIS
2187
2188 =item DESCRIPTION
2189
2190 =head2 ExtUtils::Liblist - determine libraries to use and how to use them
2191
2192 =item SYNOPSIS
2193
2194 =item DESCRIPTION
2195
2196 For static extensions, For dynamic extensions, For dynamic extensions
2197
2198 =over
2199
2200 =item EXTRALIBS
2201
2202 =item LDLOADLIBS and LD_RUN_PATH
2203
2204 =item BSLOADLIBS
2205
2206 =back
2207
2208 =item PORTABILITY
2209
2210 =over
2211
2212 =item VMS implementation
2213
2214 =back
2215
2216 =item SEE ALSO
2217
2218 =head2 ExtUtils::MM_OS2 - methods to override UN*X behaviour in
2219 ExtUtils::MakeMaker
2220
2221 =item SYNOPSIS
2222
2223 =item DESCRIPTION
2224
2225 =head2 ExtUtils::MM_Unix - methods used by ExtUtils::MakeMaker
2226
2227 =item SYNOPSIS
2228
2229 =item DESCRIPTION
2230
2231 =item METHODS
2232
2233 =over
2234
2235 =item Preloaded methods
2236
2237 canonpath, catdir, catfile, curdir, rootdir, updir
2238
2239 =item SelfLoaded methods
2240
2241 c_o (o), cflags (o), clean (o), const_cccmd (o), const_config (o),
2242 const_loadlibs (o), constants (o), depend (o), dir_target (o), dist (o),
2243 dist_basics (o), dist_ci (o), dist_core (o), dist_dir (o), dist_test (o),
2244 dlsyms (o), dynamic (o), dynamic_bs (o), dynamic_lib (o), exescan,
2245 extliblist, file_name_is_absolute, find_perl
2246
2247 =item Methods to actually produce chunks of text for the Makefile
2248
2249 force (o), guess_name, has_link_code, init_dirscan, init_main, init_others,
2250 install (o), installbin (o), libscan (o), linkext (o), lsdir, macro (o),
2251 makeaperl (o), makefile (o), manifypods (o), maybe_command,
2252 maybe_command_in_dirs, needs_linking (o), nicetext, parse_version, pasthru
2253 (o), path, perl_script, perldepend (o), pm_to_blib, post_constants (o),
2254 post_initialize (o), postamble (o), prefixify, processPL (o), realclean
2255 (o), replace_manpage_separator, static (o), static_lib (o), staticmake (o),
2256 subdir_x (o), subdirs (o), test (o), test_via_harness (o), test_via_script
2257 (o), tool_autosplit (o), tools_other (o), tool_xsubpp (o), top_targets (o),
2258 writedoc, xs_c (o), xs_o (o)
2259
2260 =back
2261
2262 =item SEE ALSO
2263
2264 =head2 ExtUtils::MM_VMS - methods to override UN*X behaviour in
2265 ExtUtils::MakeMaker
2266
2267 =item SYNOPSIS
2268
2269 =item DESCRIPTION
2270
2271 =over
2272
2273 =item Methods always loaded
2274
2275 eliminate_macros, fixpath, catdir, catfile, wraplist, curdir (override),
2276 rootdir (override), updir (override)
2277
2278 =item SelfLoaded methods
2279
2280 guess_name (override), find_perl (override), path (override), maybe_command
2281 (override), maybe_command_in_dirs (override), perl_script (override),
2282 file_name_is_absolute (override), replace_manpage_separator, init_others
2283 (override), constants (override), cflags (override), const_cccmd
2284 (override), pm_to_blib (override), tool_autosplit (override), tool_sxubpp
2285 (override), xsubpp_version (override), tools_other (override), dist
2286 (override), c_o (override), xs_c (override), xs_o (override), top_targets
2287 (override), dlsyms (override), dynamic_lib (override), dynamic_bs
2288 (override), static_lib (override), manifypods (override), processPL
2289 (override), installbin (override), subdir_x (override), clean (override),
2290 realclean (override), dist_basics (override), dist_core (override),
2291 dist_dir (override), dist_test (override), install (override), perldepend
2292 (override), makefile (override), test (override), test_via_harness
2293 (override), test_via_script (override), makeaperl (override), nicetext
2294 (override)
2295
2296 =back
2297
2298 =head2 ExtUtils::MakeMaker - create an extension Makefile
2299
2300 =item SYNOPSIS
2301
2302 =item DESCRIPTION
2303
2304 =over
2305
2306 =item How To Write A Makefile.PL
2307
2308 =item Default Makefile Behaviour
2309
2310 =item make test
2311
2312 =item make testdb
2313
2314 =item make install
2315
2316 =item PREFIX and LIB attribute
2317
2318 =item AFS users
2319
2320 =item Static Linking of a new Perl Binary
2321
2322 =item Determination of Perl Library and Installation Locations
2323
2324 =item Which architecture dependent directory?
2325
2326 =item Using Attributes and Parameters
2327
2328 C, CONFIG, CONFIGURE, DEFINE, DIR, DISTNAME, DL_FUNCS, DL_VARS,
2329 EXCLUDE_EXT, EXE_FILES, NO_VC, FIRST_MAKEFILE, FULLPERL, H, INC,
2330 INCLUDE_EXT, INSTALLARCHLIB, INSTALLBIN, INSTALLDIRS, INSTALLMAN1DIR,
2331 INSTALLMAN3DIR, INSTALLPRIVLIB, INSTALLSCRIPT, INSTALLSITELIB,
2332 INSTALLSITEARCH, INST_ARCHLIB, INST_BIN, INST_EXE, INST_LIB, INST_MAN1DIR,
2333 INST_MAN3DIR, INST_SCRIPT, LDFROM, LIBPERL_A, LIB, LIBS, LINKTYPE,
2334 MAKEAPERL, MAKEFILE, MAN1PODS, MAN3PODS, MAP_TARGET, MYEXTLIB, NAME,
2335 NEEDS_LINKING, NOECHO, NORECURS, OBJECT, OPTIMIZE, PERL, PERLMAINCC,
2336 PERL_ARCHLIB, PERL_LIB, PERL_SRC, PL_FILES, PM, PMLIBDIRS, PREFIX,
2337 PREREQ_PM, SKIP, TYPEMAPS, VERSION, VERSION_FROM, XS, XSOPT, XSPROTOARG,
2338 XS_VERSION
2339
2340 =item Additional lowercase attributes
2341
2342 clean, depend, dist, dynamic_lib, installpm, linkext, macro, realclean,
2343 tool_autosplit
2344
2345 =item Overriding MakeMaker Methods
2346
2347 =item Hintsfile support
2348
2349 =item Distribution Support
2350
2351    make distcheck,    make skipcheck,    make distclean,    make manifest,
2352   make distdir,    make tardist,    make dist,    make uutardist,    make
2353 shdist,    make zipdist,    make ci
2354
2355 =back
2356
2357 =item SEE ALSO
2358
2359 =item AUTHORS
2360
2361 =head2 ExtUtils::Manifest - utilities to write and check a MANIFEST file
2362
2363 =item SYNOPSIS
2364
2365 =item DESCRIPTION
2366
2367 =item MANIFEST.SKIP
2368
2369 =item EXPORT_OK
2370
2371 =item GLOBAL VARIABLES
2372
2373 =item DIAGNOSTICS
2374
2375 C<Not in MANIFEST:> I<file>, C<No such file:> I<file>, C<MANIFEST:> I<$!>,
2376 C<Added to MANIFEST:> I<file>
2377
2378 =item SEE ALSO
2379
2380 =item AUTHOR
2381
2382 =head2 ExtUtils::Miniperl, writemain - write the C code for perlmain.c
2383
2384 =item SYNOPSIS
2385
2386 =item DESCRIPTION
2387
2388 =item SEE ALSO
2389
2390 =head2 ExtUtils::Mkbootstrap - make a bootstrap file for use by DynaLoader
2391
2392 =item SYNOPSIS
2393
2394 =item DESCRIPTION
2395
2396 =head2 ExtUtils::Mksymlists - write linker options files for dynamic
2397 extension
2398
2399 =item SYNOPSIS
2400
2401 =item DESCRIPTION
2402
2403 NAME, DL_FUNCS, DL_VARS, FILE, FUNCLIST, DLBASE
2404
2405 =item AUTHOR
2406
2407 =item REVISION
2408
2409 =head2 ExtUtils::testlib - add blib/* directories to @INC
2410
2411 =item SYNOPSIS
2412
2413 =item DESCRIPTION
2414
2415 =head2 Fcntl - load the C Fcntl.h defines
2416
2417 =item SYNOPSIS
2418
2419 =item DESCRIPTION
2420
2421 =item NOTE
2422
2423 =item EXPORTED SYMBOLS
2424
2425 =head2 File::Basename, fileparse - split a pathname into pieces
2426
2427 =item SYNOPSIS
2428
2429 =item DESCRIPTION
2430
2431 fileparse_set_fstype, fileparse
2432
2433 =item EXAMPLES
2434
2435 C<basename>, C<dirname>
2436
2437 =head2 File::CheckTree, validate - run many filetest checks on a tree
2438
2439 =item SYNOPSIS
2440
2441 =item DESCRIPTION
2442
2443 =head2 File::Compare - Compare files or filehandles
2444
2445 =item SYNOPSIS
2446
2447 =item DESCRIPTION
2448
2449 =item RETURN
2450
2451 =item AUTHOR
2452
2453 =head2 File::Copy - Copy files or filehandles
2454
2455 =item SYNOPSIS
2456
2457 =item DESCRIPTION
2458
2459 =over
2460
2461 =item Special behavior if C<syscopy> is defined (VMS and OS/2)
2462
2463 rmscopy($from,$to[,$date_flag])
2464
2465 =back
2466
2467 =item RETURN
2468
2469 =item AUTHOR
2470
2471 =head2 File::Find, find - traverse a file tree
2472
2473 =item SYNOPSIS
2474
2475 =item DESCRIPTION
2476
2477 =head2 File::Path - create or remove a series of directories
2478
2479 =item SYNOPSIS
2480
2481 =item DESCRIPTION
2482
2483 =item AUTHORS
2484
2485 =item REVISION
2486
2487 =head2 File::stat - by-name interface to Perl's built-in stat() functions
2488
2489 =item SYNOPSIS
2490
2491 =item DESCRIPTION
2492
2493 =item NOTE
2494
2495 =item AUTHOR
2496
2497 =head2 FileCache - keep more files open than the system permits
2498
2499 =item SYNOPSIS
2500
2501 =item DESCRIPTION
2502
2503 =item BUGS
2504
2505 =head2 FileHandle - supply object methods for filehandles
2506
2507 =item SYNOPSIS
2508
2509 =item DESCRIPTION
2510
2511 $fh->print, $fh->printf, $fh->getline, $fh->getlines
2512
2513 =item SEE ALSO
2514
2515 =head2 FindBin - Locate directory of original perl script
2516
2517 =item SYNOPSIS
2518
2519 =item DESCRIPTION
2520
2521 =item EXPORTABLE VARIABLES
2522
2523 =item KNOWN BUGS
2524
2525 =item AUTHORS
2526
2527 =item COPYRIGHT
2528
2529 =item REVISION
2530
2531 =head2 GDBM_File - Perl5 access to the gdbm library.
2532
2533 =item SYNOPSIS
2534
2535 =item DESCRIPTION
2536
2537 =item AVAILABILITY
2538
2539 =item BUGS
2540
2541 =item SEE ALSO
2542
2543 =head2 Getopt::Long, GetOptions - extended processing of command line
2544 options
2545
2546 =item SYNOPSIS
2547
2548 =item DESCRIPTION
2549
2550 E<lt>noneE<gt>, !, =s, :s, =i, :i, =f, :f
2551
2552 =over
2553
2554 =item Linkage specification
2555
2556 =item Aliases and abbreviations
2557
2558 =item Non-option call-back routine
2559
2560 =item Option starters
2561
2562 =item Return value
2563
2564 =back
2565
2566 =item COMPATIBILITY
2567
2568 =item EXAMPLES
2569
2570 =item CONFIGURATION VARIABLES
2571
2572 $Getopt::Long::autoabbrev, $Getopt::Long::getopt_compat,
2573 $Getopt::Long::order, $Getopt::Long::bundling, $Getopt::Long::ignorecase,
2574 $Getopt::Long::passthrough, $Getopt::Long::VERSION, $Getopt::Long::error,
2575 $Getopt::Long::debug
2576
2577 =head2 Getopt::Std, getopt - Process single-character switches with switch
2578 clustering
2579
2580 =item SYNOPSIS
2581
2582 =item DESCRIPTION
2583
2584 =head2 I18N::Collate - compare 8-bit scalar data according to the current
2585 locale
2586
2587 =item SYNOPSIS
2588
2589 =item DESCRIPTION
2590
2591 =head2 IO - load various IO modules
2592
2593 =item SYNOPSIS
2594
2595 =item DESCRIPTION
2596
2597 =head2 IO::File - supply object methods for filehandles
2598
2599 =item SYNOPSIS
2600
2601 =item DESCRIPTION
2602
2603 =item CONSTRUCTOR
2604
2605 new ([ ARGS ] )
2606
2607 =item METHODS
2608
2609 open( FILENAME [,MODE [,PERMS]] )
2610
2611 =item SEE ALSO
2612
2613 =item HISTORY
2614
2615 =head2 IO::Handle - supply object methods for I/O handles
2616
2617 =item SYNOPSIS
2618
2619 =item DESCRIPTION
2620
2621 =item CONSTRUCTOR
2622
2623 new (), new_from_fd ( FD, MODE )
2624
2625 =item METHODS
2626
2627 $fh->getline, $fh->getlines, $fh->fdopen ( FD, MODE ), $fh->write ( BUF,
2628 LEN [, OFFSET }\] ), $fh->opened, $fh->untaint
2629
2630 =item NOTE
2631
2632 =item SEE ALSO
2633
2634 =item BUGS
2635
2636 =item HISTORY
2637
2638 =head2 IO::Pipe, IO::pipe - supply object methods for pipes
2639
2640 =item SYNOPSIS
2641
2642 =item DESCRIPTION
2643
2644 =item CONSTRCUTOR
2645
2646 new ( [READER, WRITER] )
2647
2648 =item METHODS
2649
2650 reader ([ARGS]), writer ([ARGS]), handles ()
2651
2652 =item SEE ALSO
2653
2654 =item AUTHOR
2655
2656 =item COPYRIGHT
2657
2658 =head2 IO::Seekable - supply seek based methods for I/O objects
2659
2660 =item SYNOPSIS
2661
2662 =item DESCRIPTION
2663
2664 =item SEE ALSO
2665
2666 =item HISTORY
2667
2668 =head2 IO::Select - OO interface to the select system call
2669
2670 =item SYNOPSIS
2671
2672 =item DESCRIPTION
2673
2674 =item CONSTRUCTOR
2675
2676 new ( [ HANDLES ] )
2677
2678 =item METHODS
2679
2680 add ( HANDLES ), remove ( HANDLES ), exists ( HANDLE ), handles, can_read (
2681 [ TIMEOUT ] ), can_write ( [ TIMEOUT ] ), has_error ( [ TIMEOUT ] ), count
2682 (), bits(), bits(), select ( READ, WRITE, ERROR [, TIMEOUT ] )
2683
2684 =item EXAMPLE
2685
2686 =item AUTHOR
2687
2688 =item COPYRIGHT
2689
2690 =head2 IO::Socket - Object interface to socket communications
2691
2692 =item SYNOPSIS
2693
2694 =item DESCRIPTION
2695
2696 =item CONSTRUCTOR
2697
2698 new ( [ARGS] )
2699
2700 =item METHODS
2701
2702 accept([PKG]), timeout([VAL]), sockopt(OPT [, VAL]), sockdomain, socktype,
2703 protocol
2704
2705 =item SUB-CLASSES
2706
2707 =over
2708
2709 =item IO::Socket::INET
2710
2711 =item METHODS
2712
2713 sockaddr (), sockport (), sockhost (), peeraddr (), peerport (), peerhost
2714 ()
2715
2716 =item IO::Socket::UNIX
2717
2718 =item METHODS
2719
2720 hostpath(), peerpath()
2721
2722 =back
2723
2724 =item SEE ALSO
2725
2726 =item AUTHOR
2727
2728 =item COPYRIGHT
2729
2730 =head2 IO::lib::IO::File, IO::File - supply object methods for filehandles
2731
2732 =item SYNOPSIS
2733
2734 =item DESCRIPTION
2735
2736 =item CONSTRUCTOR
2737
2738 new ([ ARGS ] )
2739
2740 =item METHODS
2741
2742 open( FILENAME [,MODE [,PERMS]] )
2743
2744 =item SEE ALSO
2745
2746 =item HISTORY
2747
2748 =head2 IO::lib::IO::Handle, IO::Handle - supply object methods for I/O
2749 handles
2750
2751 =item SYNOPSIS
2752
2753 =item DESCRIPTION
2754
2755 =item CONSTRUCTOR
2756
2757 new (), new_from_fd ( FD, MODE )
2758
2759 =item METHODS
2760
2761 $fh->getline, $fh->getlines, $fh->fdopen ( FD, MODE ), $fh->write ( BUF,
2762 LEN [, OFFSET }\] ), $fh->opened, $fh->untaint
2763
2764 =item NOTE
2765
2766 =item SEE ALSO
2767
2768 =item BUGS
2769
2770 =item HISTORY
2771
2772 =head2 IO::lib::IO::Pipe, IO::pipe - supply object methods for pipes
2773
2774 =item SYNOPSIS
2775
2776 =item DESCRIPTION
2777
2778 =item CONSTRCUTOR
2779
2780 new ( [READER, WRITER] )
2781
2782 =item METHODS
2783
2784 reader ([ARGS]), writer ([ARGS]), handles ()
2785
2786 =item SEE ALSO
2787
2788 =item AUTHOR
2789
2790 =item COPYRIGHT
2791
2792 =head2 IO::lib::IO::Seekable, IO::Seekable - supply seek based methods for
2793 I/O objects
2794
2795 =item SYNOPSIS
2796
2797 =item DESCRIPTION
2798
2799 =item SEE ALSO
2800
2801 =item HISTORY
2802
2803 =head2 IO::lib::IO::Select, IO::Select - OO interface to the select system
2804 call
2805
2806 =item SYNOPSIS
2807
2808 =item DESCRIPTION
2809
2810 =item CONSTRUCTOR
2811
2812 new ( [ HANDLES ] )
2813
2814 =item METHODS
2815
2816 add ( HANDLES ), remove ( HANDLES ), exists ( HANDLE ), handles, can_read (
2817 [ TIMEOUT ] ), can_write ( [ TIMEOUT ] ), has_error ( [ TIMEOUT ] ), count
2818 (), bits(), bits(), select ( READ, WRITE, ERROR [, TIMEOUT ] )
2819
2820 =item EXAMPLE
2821
2822 =item AUTHOR
2823
2824 =item COPYRIGHT
2825
2826 =head2 IO::lib::IO::Socket, IO::Socket - Object interface to socket
2827 communications
2828
2829 =item SYNOPSIS
2830
2831 =item DESCRIPTION
2832
2833 =item CONSTRUCTOR
2834
2835 new ( [ARGS] )
2836
2837 =item METHODS
2838
2839 accept([PKG]), timeout([VAL]), sockopt(OPT [, VAL]), sockdomain, socktype,
2840 protocol
2841
2842 =item SUB-CLASSES
2843
2844 =over
2845
2846 =item IO::Socket::INET
2847
2848 =item METHODS
2849
2850 sockaddr (), sockport (), sockhost (), peeraddr (), peerport (), peerhost
2851 ()
2852
2853 =item IO::Socket::UNIX
2854
2855 =item METHODS
2856
2857 hostpath(), peerpath()
2858
2859 =back
2860
2861 =item SEE ALSO
2862
2863 =item AUTHOR
2864
2865 =item COPYRIGHT
2866
2867 =head2 IPC::Open2, open2 - open a process for both reading and writing
2868
2869 =item SYNOPSIS
2870
2871 =item DESCRIPTION
2872
2873 =item WARNING
2874
2875 =item SEE ALSO
2876
2877 =head2 IPC::Open3, open3 - open a process for reading, writing, and error
2878 handling
2879
2880 =item SYNOPSIS
2881
2882 =item DESCRIPTION
2883
2884 =item WARNING
2885
2886 =head2 Math::BigFloat - Arbitrary length float math package
2887
2888 =item SYNOPSIS
2889
2890 =item DESCRIPTION
2891
2892 number format, Error returns 'NaN', Division is computed to
2893
2894 =item BUGS
2895
2896 =item AUTHOR
2897
2898 =head2 Math::BigInt - Arbitrary size integer math package
2899
2900 =item SYNOPSIS
2901
2902 =item DESCRIPTION
2903
2904 Canonical notation, Input, Output
2905
2906 =item EXAMPLES
2907
2908 =item BUGS
2909
2910 =item AUTHOR
2911
2912 =head2 Math::Complex - complex numbers and associated mathematical
2913 functions
2914
2915 =item SYNOPSIS
2916
2917 =item DESCRIPTION
2918
2919 =item OPERATIONS
2920
2921 =item CREATION
2922
2923 =item STRINGIFICATION
2924
2925 =item USAGE
2926
2927 =item BUGS
2928
2929 =item AUTHOR
2930
2931 =head2 NDBM_File - Tied access to ndbm files
2932
2933 =item SYNOPSIS
2934
2935 =item DESCRIPTION
2936
2937 =head2 Net::Ping - check a remote host for reachability
2938
2939 =item SYNOPSIS
2940
2941 =item DESCRIPTION
2942
2943 =over
2944
2945 =item Functions
2946
2947 Net::Ping->new([$proto [, $def_timeout [, $bytes]]]);, $p->ping($host [,
2948 $timeout]);, $p->close();, pingecho($host [, $timeout]);
2949
2950 =back
2951
2952 =item WARNING
2953
2954 =item NOTES
2955
2956 =head2 Net::hostent - by-name interface to Perl's built-in gethost*()
2957 functions
2958
2959 =item SYNOPSIS
2960
2961 =item DESCRIPTION
2962
2963 =item EXAMPLES
2964
2965 =item NOTE
2966
2967 =item AUTHOR
2968
2969 =head2 Net::netent - by-name interface to Perl's built-in getnet*()
2970 functions
2971
2972 =item SYNOPSIS
2973
2974 =item DESCRIPTION
2975
2976 =item EXAMPLES
2977
2978 =item NOTE
2979
2980 =item AUTHOR
2981
2982 =head2 Net::protoent - by-name interface to Perl's built-in getproto*()
2983 functions
2984
2985 =item SYNOPSIS
2986
2987 =item DESCRIPTION
2988
2989 =item NOTE
2990
2991 =item AUTHOR
2992
2993 =head2 Net::servent - by-name interface to Perl's built-in getserv*()
2994 functions
2995
2996 =item SYNOPSIS
2997
2998 =item DESCRIPTION
2999
3000 =item EXAMPLES
3001
3002 =item NOTE
3003
3004 =item AUTHOR
3005
3006 =head2 ODBM_File - Tied access to odbm files
3007
3008 =item SYNOPSIS
3009
3010 =item DESCRIPTION
3011
3012 =head2 Opcode - Disable named opcodes when compiling perl code
3013
3014 =item SYNOPSIS
3015
3016 =item DESCRIPTION
3017
3018 =item NOTE
3019
3020 =item WARNING
3021
3022 =item Operator Names and Operator Lists
3023
3024 an operator name (opname), an operator tag name (optag), a negated opname
3025 or optag, an operator set (opset)
3026
3027 =item Opcode Functions
3028
3029 opcodes, opset (OP, ...), opset_to_ops (OPSET), opset_to_hex (OPSET),
3030 full_opset, empty_opset, invert_opset (OPSET), verify_opset (OPSET, ...),
3031 define_optag (OPTAG, OPSET), opmask_add (OPSET), opmask, opdesc (OP, ...),
3032 opdump (PAT)
3033
3034 =item Manipulating Opsets
3035
3036 =item TO DO (maybe)
3037
3038 =item Predefined Opcode Tags
3039
3040 :base_core, :base_mem, :base_loop, :base_io, :base_orig, :base_math,
3041 :default, :filesys_read, :sys_db, :browse, :filesys_open, :filesys_write,
3042 :subprocess, :ownprocess, :others, :still_to_be_decided, :dangerous
3043
3044 =item SEE ALSO
3045
3046 =item AUTHORS
3047
3048 =head2 Opcode::Safe, Safe - Compile and execute code in restricted
3049 compartments
3050
3051 =item SYNOPSIS
3052
3053 =item DESCRIPTION
3054
3055 a new namespace, an operator mask
3056
3057 =item WARNING
3058
3059 =over
3060
3061 =item RECENT CHANGES
3062
3063 =item Methods in class Safe
3064
3065 permit (OP, ...), permit_only (OP, ...), deny (OP, ...), deny_only (OP,
3066 ...), trap (OP, ...), untrap (OP, ...), share (NAME, ...), share_from
3067 (PACKAGE, ARRAYREF), varglob (VARNAME), reval (STRING), rdo (FILENAME),
3068 root (NAMESPACE), mask (MASK)
3069
3070 =item Some Safety Issues
3071
3072 Memory, CPU, Snooping, Signals, State Changes
3073
3074 =item AUTHOR
3075
3076 =back
3077
3078 =head2 Opcode::ops, ops - Perl pragma to restrict unsafe operations when
3079 compiling
3080
3081 =item SYNOPSIS
3082
3083 =item DESCRIPTION
3084
3085 =item SEE ALSO
3086
3087 =head2 POSIX - Perl interface to IEEE Std 1003.1
3088
3089 =item SYNOPSIS
3090
3091 =item DESCRIPTION
3092
3093 =item NOTE
3094
3095 =item CAVEATS
3096
3097 =item FUNCTIONS
3098
3099 _exit, abort, abs, access, acos, alarm, asctime, asin, assert, atan, atan2,
3100 atexit, atof, atoi, atol, bsearch, calloc, ceil, chdir, chmod, chown,
3101 clearerr, clock, close, closedir, cos, cosh, creat, ctermid, ctime,
3102 cuserid, difftime, div, dup, dup2, errno, execl, execle, execlp, execv,
3103 execve, execvp, exit, exp, fabs, fclose, fcntl, fdopen, feof, ferror,
3104 fflush, fgetc, fgetpos, fgets, fileno, floor, fmod, fopen, fork, fpathconf,
3105 fprintf, fputc, fputs, fread, free, freopen, frexp, fscanf, fseek, fsetpos,
3106 fstat, ftell, fwrite, getc, getchar, getcwd, getegid, getenv, geteuid,
3107 getgid, getgrgid, getgrnam, getgroups, getlogin, getpgrp, getpid, getppid,
3108 getpwnam, getpwuid, gets, getuid, gmtime, isalnum, isalpha, isatty,
3109 iscntrl, isdigit, isgraph, islower, isprint, ispunct, isspace, isupper,
3110 isxdigit, kill, labs, ldexp, ldiv, link, localeconv, localtime, log, log10,
3111 longjmp, lseek, malloc, mblen, mbstowcs, mbtowc, memchr, memcmp, memcpy,
3112 memmove, memset, mkdir, mkfifo, mktime, modf, nice, offsetof, open,
3113 opendir, pathconf, pause, perror, pipe, pow, printf, putc, putchar, puts,
3114 qsort, raise, rand, read, readdir, realloc, remove, rename, rewind,
3115 rewinddir, rmdir, scanf, setgid, setjmp, setlocale, setpgid, setsid,
3116 setuid, sigaction, siglongjmp, sigpending, sigprocmask, sigsetjmp,
3117 sigsuspend, sin, sinh, sleep, sprintf, sqrt, srand, sscanf, stat, strcat,
3118 strchr, strcmp, strcoll, strcpy, strcspn, strerror, strftime, strlen,
3119 strncat, strncmp, strncpy, stroul, strpbrk, strrchr, strspn, strstr,
3120 strtod, strtok, strtol, strtoul, strxfrm, sysconf, system, tan, tanh,
3121 tcdrain, tcflow, tcflush, tcgetpgrp, tcsendbreak, tcsetpgrp, time, times,
3122 tmpfile, tmpnam, tolower, toupper, ttyname, tzname, tzset, umask, uname,
3123 ungetc, unlink, utime, vfprintf, vprintf, vsprintf, wait, waitpid,
3124 wcstombs, wctomb, write
3125
3126 =item CLASSES
3127
3128 =over
3129
3130 =item POSIX::SigAction
3131
3132 new
3133
3134 =item POSIX::SigSet
3135
3136 new, addset, delset, emptyset, fillset, ismember
3137
3138 =item POSIX::Termios
3139
3140 new, getattr, getcc, getcflag, getiflag, getispeed, getlflag, getoflag,
3141 getospeed, setattr, setcc, setcflag, setiflag, setispeed, setlflag,
3142 setoflag, setospeed, Baud rate values, Terminal interface values, c_cc
3143 field values, c_cflag field values, c_iflag field values, c_lflag field
3144 values, c_oflag field values
3145
3146 =back
3147
3148 =item PATHNAME CONSTANTS
3149
3150 Constants
3151
3152 =item POSIX CONSTANTS
3153
3154 Constants
3155
3156 =item SYSTEM CONFIGURATION
3157
3158 Constants
3159
3160 =item ERRNO
3161
3162 Constants
3163
3164 =item FCNTL
3165
3166 Constants
3167
3168 =item FLOAT
3169
3170 Constants
3171
3172 =item LIMITS
3173
3174 Constants
3175
3176 =item LOCALE
3177
3178 Constants
3179
3180 =item MATH
3181
3182 Constants
3183
3184 =item SIGNAL
3185
3186 Constants
3187
3188 =item STAT
3189
3190 Constants, Macros
3191
3192 =item STDLIB
3193
3194 Constants
3195
3196 =item STDIO
3197
3198 Constants
3199
3200 =item TIME
3201
3202 Constants
3203
3204 =item UNISTD
3205
3206 Constants
3207
3208 =item WAIT
3209
3210 Constants, Macros
3211
3212 =item CREATION
3213
3214 =head2 Pod::Text - convert POD data to formatted ASCII text
3215
3216 =item SYNOPSIS
3217
3218 =item DESCRIPTION
3219
3220 =item AUTHOR
3221
3222 =item TODO
3223
3224 =head2 SDBM_File - Tied access to sdbm files
3225
3226 =item SYNOPSIS
3227
3228 =item DESCRIPTION
3229
3230 =head2 Safe - Compile and execute code in restricted compartments
3231
3232 =item SYNOPSIS
3233
3234 =item DESCRIPTION
3235
3236 a new namespace, an operator mask
3237
3238 =item WARNING
3239
3240 =over
3241
3242 =item RECENT CHANGES
3243
3244 =item Methods in class Safe
3245
3246 permit (OP, ...), permit_only (OP, ...), deny (OP, ...), deny_only (OP,
3247 ...), trap (OP, ...), untrap (OP, ...), share (NAME, ...), share_from
3248 (PACKAGE, ARRAYREF), varglob (VARNAME), reval (STRING), rdo (FILENAME),
3249 root (NAMESPACE), mask (MASK)
3250
3251 =item Some Safety Issues
3252
3253 Memory, CPU, Snooping, Signals, State Changes
3254
3255 =item AUTHOR
3256
3257 =back
3258
3259 =head2 Search::Dict, look - search for key in dictionary file
3260
3261 =item SYNOPSIS
3262
3263 =item DESCRIPTION
3264
3265 =head2 SelectSaver - save and restore selected file handle
3266
3267 =item SYNOPSIS
3268
3269 =item DESCRIPTION
3270
3271 =head2 SelfLoader - load functions only on demand
3272
3273 =item SYNOPSIS
3274
3275 =item DESCRIPTION
3276
3277 =over
3278
3279 =item The __DATA__ token
3280
3281 =item SelfLoader autoloading
3282
3283 =item Autoloading and package lexicals
3284
3285 =item SelfLoader and AutoLoader
3286
3287 =item __DATA__, __END__, and the FOOBAR::DATA filehandle.
3288
3289 =item Classes and inherited methods.
3290
3291 =back
3292
3293 =item Multiple packages and fully qualified subroutine names
3294
3295 =head2 Shell - run shell commands transparently within perl
3296
3297 =item SYNOPSIS
3298
3299 =item DESCRIPTION
3300
3301 =item AUTHOR
3302
3303 =head2 Socket, sockaddr_in, sockaddr_un, inet_aton, inet_ntoa - load the C
3304 socket.h defines and structure manipulators
3305
3306 =item SYNOPSIS
3307
3308 =item DESCRIPTION
3309
3310 inet_aton HOSTNAME, inet_ntoa IP_ADDRESS, INADDR_ANY, INADDR_BROADCAST,
3311 INADDR_LOOPBACK, INADDR_NONE, sockaddr_in PORT, ADDRESS, sockaddr_in
3312 SOCKADDR_IN, pack_sockaddr_in PORT, IP_ADDRESS, unpack_sockaddr_in
3313 SOCKADDR_IN, sockaddr_un PATHNAME, sockaddr_un SOCKADDR_UN,
3314 pack_sockaddr_un PATH, unpack_sockaddr_un SOCKADDR_UN
3315
3316 =head2 Symbol - manipulate Perl symbols and their names
3317
3318 =item SYNOPSIS
3319
3320 =item DESCRIPTION
3321
3322 =head2 Sys::Hostname - Try every conceivable way to get hostname
3323
3324 =item SYNOPSIS
3325
3326 =item DESCRIPTION
3327
3328 =item AUTHOR
3329
3330 =head2 Syslog, Sys::Syslog, openlog, closelog, setlogmask, syslog - Perl
3331 interface to the UNIX syslog(3) calls
3332
3333 =item SYNOPSIS
3334
3335 =item DESCRIPTION
3336
3337 openlog $ident, $logopt, $facility, syslog $priority, $format, @args,
3338 setlogmask $mask_priority, closelog
3339
3340 =item EXAMPLES
3341
3342 =item DEPENDENCIES
3343
3344 =item SEE ALSO
3345
3346 =item AUTHOR
3347
3348 =head2 Term::Cap - Perl termcap interface
3349
3350 =item SYNOPSIS
3351
3352 =item DESCRIPTION
3353
3354 =item EXAMPLES
3355
3356 =head2 Term::Complete - Perl word completion module
3357
3358 =item SYNOPSIS
3359
3360 =item DESCRIPTION
3361
3362 E<lt>tabE<gt>Attempts word completion.
3363 Cannot be changed, ^D, ^U, E<lt>delE<gt>, E<lt>bsE<gt>
3364
3365 =item DIAGNOSTICS
3366
3367 =item BUGS
3368
3369 =item AUTHOR
3370
3371 =head2 Term::ReadLine - Perl interface to various C<readline> packages. If
3372 no real package is found, substitutes stubs instead of basic functions.
3373
3374 =item SYNOPSIS
3375
3376 =item DESCRIPTION
3377
3378 =item Minimal set of supported functions
3379
3380 C<ReadLine>, C<new>, C<readline>, C<addhistory>, C<IN>, $C<OUT>,
3381 C<MinLine>, C<findConsole>, C<Features>
3382
3383 =item EXPORTS
3384
3385 =head2 Test::Harness - run perl standard test scripts with statistics
3386
3387 =item SYNOPSIS
3388
3389 =item DESCRIPTION
3390
3391 =over
3392
3393 =item The test script output
3394
3395 =back
3396
3397 =item EXPORT
3398
3399 =item DIAGNOSTICS
3400
3401 C<All tests successful.\nFiles=%d,  Tests=%d, %s>, C<FAILED tests
3402 %s\n\tFailed %d/%d tests, %.2f%% okay.>, C<Test returned status %d (wstat
3403 %d)>, C<Failed 1 test, %.2f%% okay. %s>, C<Failed %d/%d tests, %.2f%% okay.
3404 %s>
3405
3406 =item SEE ALSO
3407
3408 =item AUTHORS
3409
3410 =item BUGS
3411
3412 =head2 Text::Abbrev, abbrev - create an abbreviation table from a list
3413
3414 =item SYNOPSIS
3415
3416 =item DESCRIPTION
3417
3418 =item EXAMPLE
3419
3420 =head2 Text::ParseWords - parse text into an array of tokens
3421
3422 =item SYNOPSIS
3423
3424 =item DESCRIPTION
3425
3426 =item AUTHORS
3427
3428 =head2 Text::Soundex - Implementation of the Soundex Algorithm as Described
3429 by Knuth
3430
3431 =item SYNOPSIS
3432
3433 =item DESCRIPTION
3434
3435 =item EXAMPLES
3436
3437 =item LIMITATIONS
3438
3439 =item AUTHOR
3440
3441 =head2 Text::Tabs -- expand and unexpand tabs per the unix expand(1) and
3442 unexpand(1)
3443
3444 =item SYNOPSIS
3445
3446 =item DESCRIPTION
3447
3448 =item BUGS
3449
3450 =item AUTHOR
3451
3452 =head2 Text::Wrap - line wrapping to form simple paragraphs
3453
3454 =item SYNOPSIS
3455
3456 =item DESCRIPTION
3457
3458 =item EXAMPLE
3459
3460 =item BUGS
3461
3462 =item AUTHOR
3463
3464 =head2 Tie::Hash, Tie::StdHash - base class definitions for tied hashes
3465
3466 =item SYNOPSIS
3467
3468 =item DESCRIPTION
3469
3470 TIEHASH classname, LIST, STORE this, key, value, FETCH this, key, FIRSTKEY
3471 this, NEXTKEY this, lastkey, EXISTS this, key, DELETE this, key, CLEAR this
3472
3473 =item CAVEATS
3474
3475 =item MORE INFORMATION
3476
3477 =head2 Tie::RefHash - use references as hash keys
3478
3479 =item SYNOPSIS
3480
3481 =item DESCRIPTION
3482
3483 =item EXAMPLE
3484
3485 =item AUTHOR
3486
3487 =item VERSION
3488
3489 =item SEE ALSO
3490
3491 =head2 Tie::Scalar, Tie::StdScalar - base class definitions for tied
3492 scalars
3493
3494 =item SYNOPSIS
3495
3496 =item DESCRIPTION
3497
3498 TIESCALAR classname, LIST, FETCH this, STORE this, value, DESTROY this
3499
3500 =item MORE INFORMATION
3501
3502 =head2 Tie::SubstrHash - Fixed-table-size, fixed-key-length hashing
3503
3504 =item SYNOPSIS
3505
3506 =item DESCRIPTION
3507
3508 =item CAVEATS
3509
3510 =head2 Time::Local - efficiently compute time from local and GMT time
3511
3512 =item SYNOPSIS
3513
3514 =item DESCRIPTION
3515
3516 =head2 Time::gmtime - by-name interface to Perl's built-in gmtime()
3517 function
3518
3519 =item SYNOPSIS
3520
3521 =item DESCRIPTION
3522
3523 =item NOTE
3524
3525 =item AUTHOR
3526
3527 =head2 Time::localtime - by-name interface to Perl's built-in localtime()
3528 function
3529
3530 =item SYNOPSIS
3531
3532 =item DESCRIPTION
3533
3534 =item NOTE
3535
3536 =item AUTHOR
3537
3538 =head2 Time::tm - internal object used by Time::gmtime and Time::localtime
3539
3540 =item SYNOPSIS
3541
3542 =item DESCRIPTION
3543
3544 =item AUTHOR
3545
3546 =head2 UNIVERSAL - base class for ALL classes (blessed references)
3547
3548 =item SYNOPSIS
3549
3550 =item DESCRIPTION
3551
3552 isa ( TYPE ), can ( METHOD ), VERSION ( [ REQUIRE ] ), isa ( REF, TYPE )
3553
3554 =head2 User::grent - by-name interface to Perl's built-in getgr*()
3555 functions
3556
3557 =item SYNOPSIS
3558
3559 =item DESCRIPTION
3560
3561 =item NOTE
3562
3563 =item AUTHOR
3564
3565 =head2 User::pwent - by-name interface to Perl's built-in getpw*()
3566 functions
3567
3568 =item SYNOPSIS
3569
3570 =item DESCRIPTION
3571
3572 =item NOTE
3573
3574 =item AUTHOR
3575
3576 =head1 AUXILIARY DOCUMENTATION
3577
3578 Here should be listed all the extra programs' documentation, but they
3579 don't all have manual pages yet:
3580
3581 =item a2p
3582
3583 =item s2p
3584
3585 =item find2perl
3586
3587 =item h2ph
3588
3589 =item c2ph
3590
3591 =item h2xs
3592
3593 =item xsubpp
3594
3595 =item pod2man
3596
3597 =item wrapsuid
3598
3599 =head1 AUTHOR
3600
3601 Larry Wall E<lt>F<larry@wall.org>E<gt>, with the help of oodles
3602 of other folks.
3603