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