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