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