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