pod/perltoc.pod

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