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