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