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