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