pod/perltoc.pod

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