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