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