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