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