X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=pod%2Fperltoc.pod;h=f7cd79a2a1da9df66aaa6a6b6bf622a00f774f54;hb=b30f304ae36b3931349d7d5816f5a5646afe5397;hp=740b0f54e362f3e1be3dddad4d944a4e5f134c7e;hpb=83272a45226e83bd136d713158e9b44ace2dbc8d;p=p5sagit%2Fp5-mst-13.2.git diff --git a/pod/perltoc.pod b/pod/perltoc.pod index 740b0f5..f7cd79a 100644 --- a/pod/perltoc.pod +++ b/pod/perltoc.pod @@ -103,8 +103,8 @@ Parentheses for capturing, Other regexp features =back -=head2 perlfaq - frequently asked questions about Perl ($Date: 2002/03/11 -21:32:23 $) +=head2 perlfaq - frequently asked questions about Perl ($Date: 2003/01/31 +17:37:17 $) =over 4 @@ -112,58 +112,58 @@ Parentheses for capturing, Other regexp features =over 4 -=item perlfaq: Structural overview of the FAQ. - -=item L: General Questions About Perl +=item Where to get the perlfaq -=item L: Obtaining and Learning about Perl +=item How to contribute to the perlfaq -=item L: Programming Tools +=item What will happen if you mail your Perl programming problems to the +authors -=item L: Data Manipulation +=back -=item L: Files and Formats +=item Credits -=item L: Regular Expressions +=item Author and Copyright Information -=item L: General Perl Language Issues +=over 4 -=item L: System Interaction +=item Bundled Distributions -=item L: Networking +=item Disclaimer =back -=item About the perlfaq documents +=item Table of Contents -=over 4 +perlfaq - this document, perlfaq1 - General Questions About Perl, perlfaq2 +- Obtaining and Learning about Perl, perlfaq3 - Programming Tools, perlfaq4 +- Data Manipulation, perlfaq5 - Files and Formats, perlfaq6 - Regular +Expressions, perlfaq7 - General Perl Language Issues, perlfaq8 - System +Interaction, perlfaq9 - Networking -=item Where to get the perlfaq +=item The Questions -=item How to contribute to the perlfaq +=over 4 -=item What will happen if you mail your Perl programming problems to the -authors +=item L: General Questions About Perl -=back +=item L: Obtaining and Learning about Perl -=item Credits +=item L: Programming Tools -=item Author and Copyright Information +=item L: Data Manipulation -=over 4 +=item L: Files and Formats -=item Bundled Distributions +=item L: Regular Expressions -=item Disclaimer +=item L: General Perl Language Issues -=back +=item L: System Interaction -=item Changes +=item L: Networking -1/November/2000, 23/May/99, 13/April/99, 7/January/99, 22/June/98, -24/April/97, 23/April/97, 25/March/97, 18/March/97, 17/March/97 Version, -Initial Release: 11/March/97 +=back =back @@ -185,9 +185,11 @@ Initial Release: 11/March/97 =item Declarations -=item Simple statements +=item Comments + +=item Simple Statements -=item Compound statements +=item Compound Statements =item Loop Control @@ -225,6 +227,8 @@ Initial Release: 11/March/97 =item List value constructors +=item Subscripts + =item Slices =item Typeglobs and Filehandles @@ -277,6 +281,8 @@ Initial Release: 11/March/97 =item C-style Logical Or +=item C-style Logical Defined-Or + =item Range Operators =item Conditional Operator @@ -291,7 +297,7 @@ Initial Release: 11/March/97 =item Logical And -=item Logical or and Exclusive Or +=item Logical or, Defined or, and Exclusive Or =item C Operators Missing From Perl @@ -398,7 +404,7 @@ in perl5 =item Alphabetical Listing of Perl Functions -I<-X> FILEHANDLE, I<-X> EXPR, I<-X>, abs VALUE, abs, accept +-I FILEHANDLE, -I EXPR, -I, abs VALUE, abs, accept NEWSOCKET,GENERICSOCKET, alarm SECONDS, alarm, atan2 Y,X, bind SOCKET,NAME, binmode FILEHANDLE, LAYER, binmode FILEHANDLE, bless REF,CLASSNAME, bless REF, caller EXPR, caller, chdir EXPR, chmod LIST, chomp VARIABLE, chomp( @@ -455,24 +461,25 @@ EXPR, sleep, socket SOCKET,DOMAIN,TYPE,PROTOCOL, socketpair SOCKET1,SOCKET2,DOMAIN,TYPE,PROTOCOL, sort SUBNAME LIST, sort BLOCK LIST, sort LIST, splice ARRAY,OFFSET,LENGTH,LIST, splice ARRAY,OFFSET,LENGTH, splice ARRAY,OFFSET, splice ARRAY, split /PATTERN/,EXPR,LIMIT, split -/PATTERN/,EXPR, split /PATTERN/, split, sprintf FORMAT, LIST, sqrt EXPR, -sqrt, srand EXPR, srand, stat FILEHANDLE, stat EXPR, stat, study SCALAR, -study, sub NAME BLOCK, sub NAME (PROTO) BLOCK, sub NAME : ATTRS BLOCK, sub -NAME (PROTO) : ATTRS BLOCK, substr EXPR,OFFSET,LENGTH,REPLACEMENT, substr -EXPR,OFFSET,LENGTH, substr EXPR,OFFSET, symlink OLDFILE,NEWFILE, syscall -LIST, sysopen FILEHANDLE,FILENAME,MODE, sysopen -FILEHANDLE,FILENAME,MODE,PERMS, sysread FILEHANDLE,SCALAR,LENGTH,OFFSET, -sysread FILEHANDLE,SCALAR,LENGTH, sysseek FILEHANDLE,POSITION,WHENCE, -system LIST, system PROGRAM LIST, syswrite FILEHANDLE,SCALAR,LENGTH,OFFSET, -syswrite FILEHANDLE,SCALAR,LENGTH, syswrite FILEHANDLE,SCALAR, tell -FILEHANDLE, tell, telldir DIRHANDLE, tie VARIABLE,CLASSNAME,LIST, tied -VARIABLE, time, times, tr///, truncate FILEHANDLE,LENGTH, truncate -EXPR,LENGTH, uc EXPR, uc, ucfirst EXPR, ucfirst, umask EXPR, umask, undef -EXPR, undef, unlink LIST, unlink, unpack TEMPLATE,EXPR, untie VARIABLE, -unshift ARRAY,LIST, use Module VERSION LIST, use Module VERSION, use Module -LIST, use Module, use VERSION, utime LIST, values HASH, vec -EXPR,OFFSET,BITS, wait, waitpid PID,FLAGS, wantarray, warn LIST, write -FILEHANDLE, write EXPR, write, y/// +/PATTERN/,EXPR, split /PATTERN/, split, sprintf FORMAT, LIST, format +parameter index, flags, vector flag, (minimum) width, precision, or maximum +width, size, order of arguments, sqrt EXPR, sqrt, srand EXPR, srand, stat +FILEHANDLE, stat EXPR, stat, study SCALAR, study, sub NAME BLOCK, sub NAME +(PROTO) BLOCK, sub NAME : ATTRS BLOCK, sub NAME (PROTO) : ATTRS BLOCK, +substr EXPR,OFFSET,LENGTH,REPLACEMENT, substr EXPR,OFFSET,LENGTH, substr +EXPR,OFFSET, symlink OLDFILE,NEWFILE, syscall LIST, sysopen +FILEHANDLE,FILENAME,MODE, sysopen FILEHANDLE,FILENAME,MODE,PERMS, sysread +FILEHANDLE,SCALAR,LENGTH,OFFSET, sysread FILEHANDLE,SCALAR,LENGTH, sysseek +FILEHANDLE,POSITION,WHENCE, system LIST, system PROGRAM LIST, syswrite +FILEHANDLE,SCALAR,LENGTH,OFFSET, syswrite FILEHANDLE,SCALAR,LENGTH, +syswrite FILEHANDLE,SCALAR, tell FILEHANDLE, tell, telldir DIRHANDLE, tie +VARIABLE,CLASSNAME,LIST, tied VARIABLE, time, times, tr///, truncate +FILEHANDLE,LENGTH, truncate EXPR,LENGTH, uc EXPR, uc, ucfirst EXPR, +ucfirst, umask EXPR, umask, undef EXPR, undef, unlink LIST, unlink, unpack +TEMPLATE,EXPR, unpack TEMPLATE, untie VARIABLE, unshift ARRAY,LIST, use +Module VERSION LIST, use Module VERSION, use Module LIST, use Module, use +VERSION, utime LIST, values HASH, vec EXPR,OFFSET,BITS, wait, waitpid +PID,FLAGS, wantarray, warn LIST, write FILEHANDLE, write EXPR, write, y/// =back @@ -496,12 +503,12 @@ FILEHANDLE, write EXPR, write, y/// =item Using References -=back - =item An Example =item Arrow Rule +=back + =item Solution =item The Rest @@ -750,7 +757,7 @@ First:, Second:, Third:, Fourth:, Fifth:, Sixth: =item Awk Traps -=item C Traps +=item C/C++ Traps =item Sed Traps @@ -797,7 +804,7 @@ Precedence Regular Expression, Regular Expression, Regular Expression, Regular Expression, Regular Expression, Regular Expression, Regular Expression, -Regular Expression +Regular Expression, Regular Expression =item Subroutine, Signal, Sorting Traps @@ -843,9 +850,10 @@ OS/2, MS-DOS, Win95/NT, Macintosh, VMS =item Command Switches -B<-0>[I], B<-a>, B<-C>, B<-c>, B<-d>, B<-d:>I, -B<-D>I, B<-D>I, B<-e> I, B<-F>I, -B<-h>, B<-i>[I], B<-I>I, B<-l>[I], +B<-0>[I], B<-A [I]>, B<-a>, B<-C +[I]>, B<-c>, B<-d>, B<-d:>I, B<-D>I, +B<-D>I, B<-e> I, B<-F>I, B<-h>, +B<-i>[I], B<-I>I, B<-l>[I], B<-m>[B<->]I, B<-M>[B<->]I, B<-M>[B<->]I<'module ...'>, B<-[mM]>[B<->]I, B<-n>, B<-p>, B<-P>, B<-s>, B<-S>, B<-t>, B<-T>, B<-u>, B<-U>, B<-v>, B<-V>, B<-V:>I, B<-w>, B<-W>, @@ -856,10 +864,11 @@ B<-X>, B<-x> I =item ENVIRONMENT HOME, LOGDIR, PATH, PERL5LIB, PERL5OPT, PERLIO, :bytes, :crlf, :mmap, -:perlio, :raw, :stdio, :unix, :utf8, :win32, PERLIO_DEBUG, PERLLIB, +:perlio, :pop, :raw, :stdio, :unix, :utf8, :win32, PERLIO_DEBUG, PERLLIB, PERL5DB, PERL5SHELL (specific to the Win32 port), PERL_DEBUG_MSTATS, -PERL_DESTRUCT_LEVEL, PERL_ENCODING, PERL_ROOT (specific to the VMS port), -SYS$LOGIN (specific to the VMS port) +PERL_DESTRUCT_LEVEL, PERL_ENCODING, PERL_HASH_SEED, PERL_HASH_SEED_DEBUG, +PERL_ROOT (specific to the VMS port), PERL_SIGNALS, PERL_UNICODE, SYS$LOGIN +(specific to the VMS port) =back @@ -958,9 +967,10 @@ min+incr, l min-max, l line, l subname, -, v [line], f filename, /pattern/, subname [condition], b postpone subname [condition], b load filename, b compile subname, B line, B *, a [line] command, A line, A *, w expr, W expr, W *, o, o booloption .., o anyoption? .., o option=value .., < ?, < [ -command ], << command, > ?, > command, >> command, { ?, { [ command ], {{ -command, ! number, ! -number, ! pattern, !! cmd, source file, H -number, q -or ^D, R, |dbcmd, ||dbcmd, command, m expr, M, man [manpage] +command ], < *, << command, > ?, > command, > *, >> command, { ?, { [ +command ], { *, {{ command, ! number, ! -number, ! pattern, !! cmd, source +file, H -number, q or ^D, R, |dbcmd, ||dbcmd, command, m expr, M, man +[manpage] =item Configurable Options @@ -1010,7 +1020,7 @@ listing =item Predefined Names $ARG, $_, $a, $b, $>, $MATCH, $&, $PREMATCH, $`, $POSTMATCH, $', -$LAST_PAREN_MATCH, $+, $^N, @LAST_MATCH_END, @+, $MULTILINE_MATCHING, $*, +$LAST_PAREN_MATCH, $+, $^N, @LAST_MATCH_END, @+, HANDLE->input_line_number(EXPR), $INPUT_LINE_NUMBER, $NR, $, IO::Handle->input_record_separator(EXPR), $INPUT_RECORD_SEPARATOR, $RS, $/, HANDLE->autoflush(EXPR), $OUTPUT_AUTOFLUSH, $|, @@ -1035,10 +1045,11 @@ $>, $REAL_GROUP_ID, $GID, $(, $EFFECTIVE_GROUP_ID, $EGID, $), $PROGRAM_NAME, $0, $[, $], $COMPILING, $^C, $DEBUGGING, $^D, $SYSTEM_FD_MAX, $^F, $^H, %^H, $INPLACE_EDIT, $^I, $^M, $OSNAME, $^O, ${^OPEN}, $PERLDB, $^P, 0x01, 0x02, 0x04, 0x08, 0x10, 0x20, 0x40, 0x80, -0x100, 0x200, $LAST_REGEXP_CODE_RESULT, $^R, $EXCEPTIONS_BEING_CAUGHT, $^S, -$BASETIME, $^T, ${^TAINT}, $PERL_VERSION, $^V, $WARNING, $^W, -${^WARNING_BITS}, ${^WIDE_SYSTEM_CALLS}, $EXECUTABLE_NAME, $^X, ARGV, -$ARGV, @ARGV, @F, @INC, @_, %INC, %ENV, $ENV{expr}, %SIG, $SIG{expr} +0x100, 0x200, 0x400, $LAST_REGEXP_CODE_RESULT, $^R, +$EXCEPTIONS_BEING_CAUGHT, $^S, $BASETIME, $^T, ${^TAINT}, ${^UNICODE}, +$PERL_VERSION, $^V, $WARNING, $^W, ${^WARNING_BITS}, $EXECUTABLE_NAME, $^X, +ARGV, $ARGV, @ARGV, ARGVOUT, @F, @INC, @_, %INC, %ENV, $ENV{expr}, %SIG, +$SIG{expr} =item Error Indicators @@ -1086,6 +1097,8 @@ $ARGV, @ARGV, @F, @INC, @_, %INC, %ENV, $ENV{expr}, %SIG, $SIG{expr} =item Simple Opens +=item Indirect Filehandles + =item Pipe Opens =item The Minus File @@ -1126,6 +1139,10 @@ $ARGV, @ARGV, @F, @INC, @_, %INC, %ENV, $ENV{expr}, %SIG, $SIG{expr} =item Opening Non-File Files +=item Opening Named Pipes + +=item Opening Sockets + =item Binary Files =item File Locking @@ -1182,6 +1199,8 @@ $ARGV, @ARGV, @F, @INC, @_, %INC, %ENV, $ENV{expr}, %SIG, $SIG{expr} =back +=item Template Grouping + =item Lengths and Widths =over 4 @@ -1190,6 +1209,8 @@ $ARGV, @ARGV, @F, @INC, @_, %INC, %ENV, $ENV{expr}, %SIG, $SIG{expr} =item Dynamic Templates +=item Counting Repetitions + =back =item Packing and Unpacking C Structures @@ -1660,6 +1681,8 @@ isa(CLASS), can(METHOD), VERSION( [NEED] ) =item DELEGATION +=item SEE ALSO + =back =head2 perltie - how to hide an object class in a simple variable @@ -1730,10 +1753,10 @@ safe subprocesses, sockets, and semaphores) =over 4 -=item Deferred Signals +=item Deferred Signals (Safe signals) -Long running opcodes, Interrupting IO, Signals as "faults", Signals -triggered by operating system state +Long running opcodes, Interrupting IO, Restartable system calls, Signals as +"faults", Signals triggered by operating system state =back @@ -1851,8 +1874,8 @@ application, Thread-safety of extensions =item Flavors of Perl numeric operations -Arithmetic operators except, C, Arithmetic operators except, -C, Bitwise operators, C, Bitwise operators, C, Other +mathematical operators, Bitwise operators, Bitwise operators during C, Operators which expect an integer, Operators which expect a string @@ -1888,7 +1911,7 @@ string =item What kind of threads are Perl threads? -=item Threadsafe Modules +=item Thread-Safe Modules =item Thread Basics @@ -1956,7 +1979,9 @@ string =item Performance considerations -=item Threadsafety of System Libraries +=item Process-scope Changes + +=item Thread-Safety of System Libraries =item Conclusion @@ -2119,6 +2144,8 @@ portable =item Command names versus file pathnames +=item Networking + =item Interprocess Communication (IPC) =item External Subroutines (XS) @@ -2179,16 +2206,17 @@ LIST, exit EXPR, exit, fcntl FILEHANDLE,FUNCTION,SCALAR, flock FILEHANDLE,OPERATION, fork, getlogin, getpgrp PID, getppid, getpriority WHICH,WHO, getpwnam NAME, getgrnam NAME, getnetbyname NAME, getpwuid UID, getgrgid GID, getnetbyaddr ADDR,ADDRTYPE, getprotobynumber NUMBER, -getservbyport PORT,PROTO, getpwent, getgrent, gethostent, getnetent, -getprotoent, getservent, sethostent STAYOPEN, setnetent STAYOPEN, -setprotoent STAYOPEN, setservent STAYOPEN, endpwent, endgrent, endhostent, -endnetent, endprotoent, endservent, getsockopt SOCKET,LEVEL,OPTNAME, glob -EXPR, glob, ioctl FILEHANDLE,FUNCTION,SCALAR, kill SIGNAL, LIST, link -OLDFILE,NEWFILE, lstat FILEHANDLE, lstat EXPR, lstat, msgctl ID,CMD,ARG, -msgget KEY,FLAGS, msgsnd ID,MSG,FLAGS, msgrcv ID,VAR,SIZE,TYPE,FLAGS, open -FILEHANDLE,EXPR, open FILEHANDLE, pipe READHANDLE,WRITEHANDLE, readlink -EXPR, readlink, select RBITS,WBITS,EBITS,TIMEOUT, semctl ID,SEMNUM,CMD,ARG, -semget KEY,NSEMS,FLAGS, semop KEY,OPSTRING, setgrent, setpgrp PID,PGRP, +getservbyport PORT,PROTO, getpwent, getgrent, gethostbyname, gethostent, +getnetent, getprotoent, getservent, sethostent STAYOPEN, setnetent +STAYOPEN, setprotoent STAYOPEN, setservent STAYOPEN, endpwent, endgrent, +endhostent, endnetent, endprotoent, endservent, getsockopt +SOCKET,LEVEL,OPTNAME, glob EXPR, glob, ioctl FILEHANDLE,FUNCTION,SCALAR, +kill SIGNAL, LIST, link OLDFILE,NEWFILE, lstat FILEHANDLE, lstat EXPR, +lstat, msgctl ID,CMD,ARG, msgget KEY,FLAGS, msgsnd ID,MSG,FLAGS, msgrcv +ID,VAR,SIZE,TYPE,FLAGS, open FILEHANDLE,EXPR, open FILEHANDLE, pipe +READHANDLE,WRITEHANDLE, readlink EXPR, readlink, select +RBITS,WBITS,EBITS,TIMEOUT, semctl ID,SEMNUM,CMD,ARG, semget +KEY,NSEMS,FLAGS, semop KEY,OPSTRING, setgrent, setpgrp PID,PGRP, setpriority WHICH,WHO,PRIORITY, setpwent, setsockopt SOCKET,LEVEL,OPTNAME,OPTVAL, shmctl ID,CMD,ARG, shmget KEY,SIZE,FLAGS, shmread ID,VAR,POS,SIZE, shmwrite ID,STRING,POS,SIZE, sockatmark SOCKET, @@ -2202,12 +2230,12 @@ wait, waitpid PID,FLAGS =item CHANGES -v1.48, 02 February 2001, v1.47, 22 March 2000, v1.46, 12 February 2000, -v1.45, 20 December 1999, v1.44, 19 July 1999, v1.43, 24 May 1999, v1.42, 22 -May 1999, v1.41, 19 May 1999, v1.40, 11 April 1999, v1.39, 11 February -1999, v1.38, 31 December 1998, v1.37, 19 December 1998, v1.36, 9 September -1998, v1.35, 13 August 1998, v1.33, 06 August 1998, v1.32, 05 August 1998, -v1.30, 03 August 1998, v1.23, 10 July 1998 +v1.49, 12 August 2002, v1.48, 02 February 2001, v1.47, 22 March 2000, +v1.46, 12 February 2000, v1.45, 20 December 1999, v1.44, 19 July 1999, +v1.43, 24 May 1999, v1.42, 22 May 1999, v1.41, 19 May 1999, v1.40, 11 April +1999, v1.39, 11 February 1999, v1.38, 31 December 1998, v1.37, 19 December +1998, v1.36, 9 September 1998, v1.35, 13 August 1998, v1.33, 06 August +1998, v1.32, 05 August 1998, v1.30, 03 August 1998, v1.23, 10 July 1998 =item Supported Platforms @@ -2398,6 +2426,10 @@ enable UTF-8/UTF-EBCDIC in scripts =item Locales +=item When Unicode Does Not Happen + +=item Forcing Unicode in Perl (Or Unforcing Unicode in Perl) + =item Using Unicode in XS =back @@ -2412,6 +2444,8 @@ enable UTF-8/UTF-EBCDIC in scripts =item Speed +=item Porting code from perl-5.6.X + =back =item SEE ALSO @@ -2520,9 +2554,9 @@ chr(), ord(), pack(), print(), printf(), sort(), sprintf(), unpack() =over 4 -=item OS/400 +=item OS/400 -IFS access +PASE, IFS access =item OS/390, z/OS @@ -2566,6 +2600,8 @@ chcp, dataset access, OS/390, z/OS iconv, locales =item Unicode +=item Algorithmic Complexity Attacks + =back =item SEE ALSO @@ -2627,67 +2663,85 @@ module (sometimes unnecessary), B the module =over 4 -=item DESCRIPTION - =item THE PERL MODULE LIBRARY =over 4 =item Pragmatic Modules -attributes, attrs, autouse, base, bigint, bignum, bigrat, blib, bytes, -charnames, constant, diagnostics, encoding, fields, filetest, if, integer, -less, locale, open, ops, overload, re, sigtrap, sort, strict, subs, -threads, utf8, vars, vmsish, warnings, warnings::register +assertions, assertions::activate, attributes, attrs, autouse, base, bigint, +bignum, bigrat, blib, bytes, charnames, constant, diagnostics, encoding, +fields, filetest, if, integer, less, lib, locale, open, ops, overload, re, +sigtrap, sort, strict, subs, threads, threads::shared, utf8, vars, version, +vmsish, warnings, warnings::register =item Standard Modules AnyDBM_File, Attribute::Handlers, AutoLoader, AutoSplit, B, B::Asmdata, B::Assembler, B::Bblock, B::Bytecode, B::C, B::CC, B::Concise, B::Debug, B::Deparse, B::Disassembler, B::Lint, B::Showlex, B::Stackobj, B::Stash, -B::Terse, B::Xref, Benchmark, ByteLoader, CGI, CGI::Apache, CGI::Carp, -CGI::Cookie, CGI::Fast, CGI::Pretty, CGI::Push, CGI::Switch, CGI::Util, -CPAN, CPAN::FirstTime, CPAN::Nox, Carp, Carp::Heavy, Class::ISA, -Class::Struct, Config, Cwd, DB, DB_File, Devel::SelfStubber, Digest, -DirHandle, Dumpvalue, Encode, English, Env, Errno, Exporter, -Exporter::Heavy, ExtUtils::Command, ExtUtils::Command::MM, +B::Terse, B::Xref, Benchmark, CGI, CGI::Apache, CGI::Carp, CGI::Cookie, +CGI::Fast, CGI::Pretty, CGI::Push, CGI::Switch, CGI::Util, CPAN, +CPAN::FirstTime, CPAN::Nox, Carp, Carp::Heavy, Class::ISA, Class::Struct, +Config, Cwd, DB, DB_File, Data::Dumper, Devel::DProf, Devel::PPPort, +Devel::Peek, Devel::SelfStubber, Digest, Digest::MD5, DirHandle, Dumpvalue, +DynaLoader, Encode, Encode::Alias, Encode::Byte, Encode::CJKConstants, +Encode::CN, Encode::CN::HZ, Encode::Config, Encode::EBCDIC, +Encode::Encoder, Encode::Encoding, Encode::Guess, Encode::JP, +Encode::JP::H2Z, Encode::JP::JIS7, Encode::KR, Encode::KR::2022_KR, +Encode::MIME::Header, Encode::PerlIO, Encode::Supported, Encode::Symbol, +Encode::TW, Encode::Unicode, Encode::Unicode::UTF7, English, Env, Errno, +Exporter, Exporter::Heavy, ExtUtils::Command, ExtUtils::Command::MM, ExtUtils::Constant, ExtUtils::Embed, ExtUtils::Install, ExtUtils::Installed, ExtUtils::Liblist, ExtUtils::MM, ExtUtils::MM_Any, ExtUtils::MM_BeOS, ExtUtils::MM_Cygwin, ExtUtils::MM_DOS, ExtUtils::MM_MacOS, ExtUtils::MM_NW5, ExtUtils::MM_OS2, ExtUtils::MM_UWIN, ExtUtils::MM_Unix, ExtUtils::MM_VMS, ExtUtils::MM_Win32, -ExtUtils::MM_Win95, ExtUtils::MY, ExtUtils::MakeMaker, ExtUtils::Manifest, -ExtUtils::Mkbootstrap, ExtUtils::Mksymlists, ExtUtils::Packlist, -ExtUtils::testlib, Fatal, Fcntl, File::Basename, File::CheckTree, -File::Compare, File::Copy, File::DosGlob, File::Find, File::Path, -File::Spec, File::Spec::Cygwin, File::Spec::Epoc, File::Spec::Functions, -File::Spec::Mac, File::Spec::OS2, File::Spec::Unix, File::Spec::VMS, -File::Spec::Win32, File::Temp, File::stat, FileCache, FileHandle, -Filter::Simple, FindBin, Getopt::Long, Getopt::Std, Hash::Util, -I18N::Collate, I18N::LangTags, I18N::LangTags::List, IO, IPC::Open2, -IPC::Open3, Locale::Constants, Locale::Country, Locale::Currency, -Locale::Language, Locale::Maketext, Locale::Maketext::TPJ13, -Locale::Script, Math::BigFloat, Math::BigInt, Math::BigInt::Calc, -Math::BigRat, Math::Complex, Math::Trig, Memoize, Memoize::AnyDBM_File, -Memoize::Expire, Memoize::ExpireFile, Memoize::ExpireTest, -Memoize::NDBM_File, Memoize::SDBM_File, Memoize::Storable, NDBM_File, NEXT, -Net::Cmd, Net::Config, Net::Domain, Net::FTP, Net::NNTP, Net::Netrc, -Net::POP3, Net::Ping, Net::SMTP, Net::Time, Net::hostent, Net::libnetFAQ, -Net::netent, Net::protoent, Net::servent, O, ODBM_File, Opcode, POSIX, -PerlIO, PerlIO::via::QuotedPrint, Pod::Checker, Pod::Find, Pod::Functions, -Pod::Html, Pod::InputObjects, Pod::LaTeX, Pod::Man, Pod::ParseLink, -Pod::ParseUtils, Pod::Parser, Pod::Plainer, Pod::Select, Pod::Text, -Pod::Text::Color, Pod::Text::Overstrike, Pod::Text::Termcap, Pod::Usage, -SDBM_File, Safe, Search::Dict, SelectSaver, SelfLoader, Shell, Socket, -Storable, Switch, Symbol, Term::ANSIColor, Term::Cap, Term::Complete, -Term::ReadLine, Test, Test::Builder, Test::Harness, Test::Harness::Assert, -Test::Harness::Iterator, Test::Harness::Straps, Test::More, Test::Simple, -Test::Tutorial, Text::Abbrev, Text::Balanced, Text::ParseWords, -Text::Soundex, Text::Tabs, Text::Wrap, Thread, Thread::Queue, -Thread::Semaphore, Tie::Array, Tie::File, Tie::Handle, Tie::Hash, -Tie::Memoize, Tie::RefHash, Tie::Scalar, Tie::SubstrHash, Time::Local, -Time::gmtime, Time::localtime, Time::tm, UNIVERSAL, Unicode::Collate, -Unicode::UCD, User::grent, User::pwent, Win32 +ExtUtils::MM_Win95, ExtUtils::MY, ExtUtils::MakeMaker, +ExtUtils::MakeMaker::FAQ, ExtUtils::MakeMaker::Tutorial, +ExtUtils::MakeMaker::bytes, ExtUtils::MakeMaker::vmsish, +ExtUtils::Manifest, ExtUtils::Mkbootstrap, ExtUtils::Mksymlists, +ExtUtils::Packlist, ExtUtils::testlib, Fatal, Fcntl, File::Basename, +File::CheckTree, File::Compare, File::Copy, File::DosGlob, File::Find, +File::Glob, File::Path, File::Spec, File::Spec::Cygwin, File::Spec::Epoc, +File::Spec::Functions, File::Spec::Mac, File::Spec::OS2, File::Spec::Unix, +File::Spec::VMS, File::Spec::Win32, File::Temp, File::stat, FileCache, +FileHandle, Filter::Simple, Filter::Util::Call, FindBin, GDBM_File, +Getopt::Long, Getopt::Std, Hash::Util, I18N::Collate, I18N::LangTags, +I18N::LangTags::List, I18N::Langinfo, IO, IO::Dir, IO::File, IO::Handle, +IO::Pipe, IO::Poll, IO::Seekable, IO::Select, IO::Socket, IO::Socket::INET, +IO::Socket::UNIX, IPC::Open2, IPC::Open3, IPC::SysV, IPC::SysV::Msg, +IPC::SysV::Semaphore, List::Util, Locale::Constants, Locale::Country, +Locale::Currency, Locale::Language, Locale::Maketext, +Locale::Maketext::TPJ13, Locale::Script, MIME::Base64, +MIME::Base64::QuotedPrint, Math::BigFloat, Math::BigInt, +Math::BigInt::Calc, Math::BigInt::Scalar, Math::BigRat, Math::Complex, +Math::Trig, Memoize, Memoize::AnyDBM_File, Memoize::Expire, +Memoize::ExpireFile, Memoize::ExpireTest, Memoize::NDBM_File, +Memoize::SDBM_File, Memoize::Storable, NDBM_File, NEXT, Net::Cmd, +Net::Config, Net::Domain, Net::FTP, Net::NNTP, Net::Netrc, Net::POP3, +Net::Ping, Net::SMTP, Net::Time, Net::hostent, Net::libnetFAQ, Net::netent, +Net::protoent, Net::servent, O, ODBM_File, Opcode, POSIX, PerlIO, +PerlIO::encoding, PerlIO::scalar, PerlIO::via, PerlIO::via::QuotedPrint, +Pod::Checker, Pod::Find, Pod::Functions, Pod::Html, Pod::InputObjects, +Pod::LaTeX, Pod::Man, Pod::ParseLink, Pod::ParseUtils, Pod::Parser, +Pod::Perldoc::ToChecker, Pod::Perldoc::ToMan, Pod::Perldoc::ToNroff, +Pod::Perldoc::ToPod, Pod::Perldoc::ToRtf, Pod::Perldoc::ToText, +Pod::Perldoc::ToTk, Pod::Perldoc::ToXml, Pod::PlainText, Pod::Plainer, +Pod::Select, Pod::Text, Pod::Text::Color, Pod::Text::Overstrike, +Pod::Text::Termcap, Pod::Usage, SDBM_File, Safe, Scalar::Util, +Search::Dict, SelectSaver, SelfLoader, Shell, Socket, Storable, Switch, +Symbol, Sys::Hostname, Sys::Syslog, Term::ANSIColor, Term::Cap, +Term::Complete, Term::ReadLine, Test, Test::Builder, Test::Harness, +Test::Harness::Assert, Test::Harness::Iterator, Test::Harness::Straps, +Test::More, Test::Simple, Test::Tutorial, Text::Abbrev, Text::Balanced, +Text::ParseWords, Text::Soundex, Text::Tabs, Text::Wrap, Thread, +Thread::Queue, Thread::Semaphore, Thread::Signal, Thread::Specific, +Tie::Array, Tie::File, Tie::Handle, Tie::Hash, Tie::Memoize, Tie::RefHash, +Tie::Scalar, Tie::SubstrHash, Time::HiRes, Time::Local, Time::gmtime, +Time::localtime, Time::tm, UNIVERSAL, Unicode::Collate, Unicode::Normalize, +Unicode::UCD, User::grent, User::pwent, Win32, XS::APItest, XS::Typemap, +XSLoader =item Extension Modules @@ -2699,18 +2753,43 @@ Unicode::UCD, User::grent, User::pwent, Win32 =item Africa +South Africa + =item Asia +China, Indonesia, Israel, Japan, Malaysia, Russian Federation, Saudi +Arabia, Singapore, South Korea, Taiwan + =item Central America +Costa Rica + =item Europe +Austria, Belgium, Bulgaria, Croatia, Czech Republic, Denmark, Estonia, +Finland, France, Germany, Greece, Hungary, Iceland, Ireland, Italy, Latvia, +Lithuania, Netherlands, Norway, Poland, Portugal, Romania, Russia, +Slovakia, Slovenia, Spain, Sweden, Switzerland, Turkey, Ukraine, United +Kingdom + =item North America +Canada, Alberta, Manitoba, Nova Scotia, Ontario, Mexico, United States, +Alabama, California, Colorado, Delaware, District of Columbia, Florida, +Illinois, Indiana, Kentucky, Massachusetts, Michigan, Nevada, New Jersey, +New York, North Carolina, Oklahoma, Oregon, Pennsylvania, Tennessee, Texas, +Utah, Virginia, Washington, Wisconsin + =item Oceania +Australia, New Zealand, United States + =item South America +Argentina, Brazil, Chile + +=item RSYNC Mirrors + =back =item Modules: Creation, Use, and Abuse @@ -2791,6 +2870,9 @@ Parameter passing =item README, INSTALL, release notes, changelogs +perl Makefile.PL, make, make test, make install, perl Build.PL, perl Build, +perl Build test, perl Build install + =back =item RELEASE CONSIDERATIONS @@ -2823,8 +2905,9 @@ Parameter passing =item SEE ALSO -L, L, L, L, Testing tools, -http://pause.perl.org/, Any good book on software engineering +L, L, L, L, Packaging Tools, +Testing tools, http://pause.perl.org/, Any good book on software +engineering =item AUTHOR @@ -2865,8 +2948,8 @@ tarball, Announce to the modules list, Announce to clpa, Fix bugs! =back -=head2 perlfaq1 - General Questions About Perl ($Revision: 1.8 $, $Date: -2002/04/07 18:46:13 $) +=head2 perlfaq1 - General Questions About Perl ($Revision: 1.12 $, $Date: +2003/07/09 15:47:28 $) =over 4 @@ -2882,6 +2965,8 @@ tarball, Announce to the modules list, Announce to clpa, Fix bugs! =item What are perl4 and perl5? +=item What is Ponie? + =item What is perl6? =item How stable is Perl? @@ -2912,8 +2997,8 @@ Scheme, or Tcl? =back -=head2 perlfaq2 - Obtaining and Learning about Perl ($Revision: 1.13 $, -$Date: 2002/04/26 16:56:35 $) +=head2 perlfaq2 - Obtaining and Learning about Perl ($Revision: 1.20 $, +$Date: 2003/01/26 17:50:56 $) =over 4 @@ -2968,8 +3053,8 @@ References, Tutorials, Task-Oriented, Special Topics =back -=head2 perlfaq3 - Programming Tools ($Revision: 1.22 $, $Date: 2002/05/06 -13:11:13 $) +=head2 perlfaq3 - Programming Tools ($Revision: 1.33 $, $Date: 2003/01/31 +17:34:56 $) =over 4 @@ -2983,6 +3068,8 @@ References, Tutorials, Task-Oriented, Special Topics =item Is there a Perl shell? +=item How do I find which modules are installed on my system? + =item How do I debug my Perl programs? =item How do I profile my Perl programs? @@ -2996,7 +3083,7 @@ References, Tutorials, Task-Oriented, Special Topics =item Is there an IDE or Windows Perl Editor? Komodo, The Object System, Open Perl IDE, PerlBuilder, visiPerl+, OptiPerl, -CodeMagicCD, GNU Emacs, MicroEMACS, XEmacs, Elvis, Vile, Vim, Codewright, +GNU Emacs, MicroEMACS, XEmacs, Jed, Elvis, Vile, Vim, Codewright, MultiEdit, SlickEdit, Bash, Ksh, Tcsh, Zsh, BBEdit and BBEdit Lite, Alpha =item Where can I get Perl macros for vi? @@ -3016,7 +3103,7 @@ MultiEdit, SlickEdit, Bash, Ksh, Tcsh, Zsh, BBEdit and BBEdit Lite, Alpha Don't slurp!, Use map and grep selectively, Avoid unnecessary quotes and stringification, Pass by reference, Tie large variables to disk -=item Is it unsafe to return a pointer to local data? +=item Is it safe to return a reference to local or lexical data? =item How can I free an array or hash so my program shrinks? @@ -3053,8 +3140,8 @@ my C program; what am I doing wrong? =back -=head2 perlfaq4 - Data Manipulation ($Revision: 1.25 $, $Date: 2002/05/30 -07:04:25 $) +=head2 perlfaq4 - Data Manipulation ($Revision: 1.44 $, $Date: 2003/07/28 +17:35:21 $) =over 4 @@ -3097,9 +3184,7 @@ from decimal to binary =over 4 -=item How do I find the week-of-the-year/day-of-the-year? - -=item How do I find the current century or millennium? +=item How do I find the day or week of the year? =item How can I compare two dates and find the difference? @@ -3133,7 +3218,7 @@ from decimal to binary =item How do I reformat a paragraph? -=item How can I access/change the first N letters of a string? +=item How can I access or change N characters of a string? =item How do I change the Nth occurrence of something? @@ -3143,7 +3228,7 @@ string? =item How do I capitalize all the words on one line? =item How can I split a [character] delimited string except when inside -[character]? (Comma-separated files) +[character]? =item How do I strip blank space from the beginning/end of a string? @@ -3157,10 +3242,10 @@ string? =item What's wrong with always quoting "$vars"? -=item Why don't my <EHERE documents work? -1. There must be no space after the << part, 2. There (probably) should be -a semicolon at the end, 3. You can't (easily) have any space in front of +There must be no space after the EE part, There (probably) should +be a semicolon at the end, You can't (easily) have any space in front of the tag =back @@ -3270,8 +3355,8 @@ array of hashes or arrays? =back -=head2 perlfaq5 - Files and Formats ($Revision: 1.18 $, $Date: 2002/05/30 -07:04:25 $) +=head2 perlfaq5 - Files and Formats ($Revision: 1.28 $, $Date: 2003/01/26 +17:45:46 $) =over 4 @@ -3286,6 +3371,8 @@ line in the middle of a file/append to the beginning of a file? =item How do I count the number of lines in a file? +=item How can I use Perl's C<-i> option from within a program? + =item How do I make a temporary file name? =item How can I manipulate fixed-record-length files? @@ -3305,7 +3392,8 @@ filehandles between subroutines? How do I make an array of filehandles? =item How come when I open a file read-write it wipes it out? -=item Why do I sometimes get an "Argument list too long" when I use <*>? +=item Why do I sometimes get an "Argument list too long" when I use +E*E? =item Is there a leak/bug in glob()? @@ -3315,7 +3403,7 @@ filehandles between subroutines? How do I make an array of filehandles? =item How can I lock a file? -=item Why can't I just open(FH, ">file.lock")? +=item Why can't I just open(FH, "Efile.lock")? =item I still don't get locking. I just want to increment the number in the file. How can I do this? @@ -3363,8 +3451,8 @@ protected files? Isn't this a bug in Perl? =back -=head2 perlfaq6 - Regular Expressions ($Revision: 1.12 $, $Date: 2002/06/01 -22:31:09 $) +=head2 perlfaq6 - Regular Expressions ($Revision: 1.20 $, $Date: 2003/01/03 +20:05:28 $) =over 4 @@ -3430,8 +3518,8 @@ file? =back -=head2 perlfaq7 - General Perl Language Issues ($Revision: 1.8 $, $Date: -2002/03/26 15:48:32 $) +=head2 perlfaq7 - General Perl Language Issues ($Revision: 1.15 $, $Date: +2003/07/24 02:17:21 $) =over 4 @@ -3483,7 +3571,7 @@ is in scope? =item What's the difference between deep and shallow binding? -=item Why doesn't "my($foo) = ;" work right? +=item Why doesn't "my($foo) = EFILEE;" work right? =item How do I redefine a builtin function, operator, or method? @@ -3491,7 +3579,8 @@ is in scope? =item How do I create a switch or case statement? -=item How can I catch accesses to undefined variables/functions/methods? +=item How can I catch accesses to undefined variables, functions, or +methods? =item Why can't a method included in this same file be found? @@ -3503,14 +3592,16 @@ is in scope? =item How can I use a variable as a variable name? +=item What does "bad interpreter" mean? + =back =item AUTHOR AND COPYRIGHT =back -=head2 perlfaq8 - System Interaction ($Revision: 1.8 $, $Date: 2002/05/16 -12:41:42 $) +=head2 perlfaq8 - System Interaction ($Revision: 1.17 $, $Date: 2003/01/26 +17:44:04 $) =over 4 @@ -3637,7 +3728,7 @@ search path? =back -=head2 perlfaq9 - Networking ($Revision: 1.9 $, $Date: 2002/04/07 18:46:13 +=head2 perlfaq9 - Networking ($Revision: 1.15 $, $Date: 2003/01/31 17:36:57 $) =over 4 @@ -3793,6 +3884,8 @@ program =item Embedding Perl under Win32 +=item Hiding Perl_ + =item MORAL =item AUTHOR @@ -4024,6 +4117,8 @@ C, C, C =item The OVERLOAD: Keyword +=item The FALLBACK: Keyword + =item The INTERFACE: Keyword =item The INTERFACE_MACRO: Keyword @@ -4116,6 +4211,8 @@ C, C

, C, C =item Hash API Extensions +=item AVs, HVs and undefined values + =item References =item Blessed References and Class Objects @@ -4397,6 +4494,10 @@ B =item CONCLUSION +=item THINGS TO LOOK OUT FOR + +Some Filters Clobber the C Handle + =item REQUIREMENTS =item AUTHOR @@ -4467,12 +4568,12 @@ CvSTASH, get_cv, Nullcv =item Embedding Functions -load_module, nothreadhook, perl_alloc, perl_construct, perl_destruct, -perl_free, perl_parse, perl_run, require_pv +cv_undef, load_module, nothreadhook, perl_alloc, perl_construct, +perl_destruct, perl_free, perl_parse, perl_run, require_pv =item Functions in file pp_pack.c -pack_cat, unpack_str +packlist, pack_cat, unpackstring, unpack_str =item Global Variables @@ -4508,8 +4609,9 @@ savepv, savepvn, savesharedpv, StructCopy, Zero =item Miscellaneous Functions -fbm_compile, fbm_instr, form, getcwd_sv, strEQ, strGE, strGT, strLE, strLT, -strNE, strnEQ, strnNE +fbm_compile, fbm_instr, form, getcwd_sv, new_version, scan_version, strEQ, +strGE, strGT, strLE, strLT, strNE, strnEQ, strnNE, sv_nolocking, +sv_nosharing, sv_nounlocking, upg_version, vcmp, vnumify, vstringify =item Numeric functions @@ -4520,6 +4622,10 @@ scan_hex, scan_oct cv_const_sv, newCONSTSUB, newXS +=item Pad Data Structures + +pad_sv + =item Stack Manipulation Macros dMARK, dORIGMARK, dSP, EXTEND, MARK, ORIGMARK, POPi, POPl, POPn, POPp, @@ -4536,45 +4642,46 @@ svtype, SVt_IV, SVt_NV, SVt_PV, SVt_PVAV, SVt_PVCV, SVt_PVHV, SVt_PVMG get_sv, looks_like_number, newRV_inc, newRV_noinc, newSV, newSViv, newSVnv, newSVpv, newSVpvf, newSVpvn, newSVpvn_share, newSVrv, newSVsv, newSVuv, -new_vstring, SvCUR, SvCUR_set, SvEND, SvGROW, SvIOK, SvIOKp, SvIOK_notUV, -SvIOK_off, SvIOK_on, SvIOK_only, SvIOK_only_UV, SvIOK_UV, SvIV, SvIVx, -SvIVX, SvLEN, SvNIOK, SvNIOKp, SvNIOK_off, SvNOK, SvNOKp, SvNOK_off, -SvNOK_on, SvNOK_only, SvNV, SvNVX, SvNVx, SvOK, SvOOK, SvPOK, SvPOKp, -SvPOK_off, SvPOK_on, SvPOK_only, SvPOK_only_UTF8, SvPV, SvPVbyte, -SvPVbytex, SvPVbytex_force, SvPVbyte_force, SvPVbyte_nolen, SvPVutf8, -SvPVutf8x, SvPVutf8x_force, SvPVutf8_force, SvPVutf8_nolen, SvPVx, SvPVX, -SvPV_force, SvPV_force_nomg, SvPV_nolen, SvREFCNT, SvREFCNT_dec, -SvREFCNT_inc, SvROK, SvROK_off, SvROK_on, SvRV, SvSTASH, SvTAINT, -SvTAINTED, SvTAINTED_off, SvTAINTED_on, SvTRUE, SvTYPE, SvUNLOCK, SvUOK, -SvUPGRADE, SvUTF8, SvUTF8_off, SvUTF8_on, SvUV, SvUVX, SvUVx, sv_2bool, -sv_2cv, sv_2io, sv_2iv, sv_2mortal, sv_2nv, sv_2pvbyte, sv_2pvbyte_nolen, -sv_2pvutf8, sv_2pvutf8_nolen, sv_2pv_flags, sv_2pv_nolen, sv_2uv, -sv_backoff, sv_bless, sv_catpv, sv_catpvf, sv_catpvf_mg, sv_catpvn, -sv_catpvn_flags, sv_catpvn_mg, sv_catpv_mg, sv_catsv, sv_catsv_flags, -sv_catsv_mg, sv_chop, sv_clear, sv_cmp, sv_cmp_locale, sv_collxfrm, -sv_copypv, sv_dec, sv_derived_from, sv_eq, sv_force_normal, -sv_force_normal_flags, sv_free, sv_gets, sv_grow, sv_inc, sv_insert, -sv_isa, sv_isobject, sv_iv, sv_len, sv_len_utf8, sv_magic, sv_magicext, -sv_mortalcopy, sv_newmortal, sv_newref, sv_nolocking, sv_nosharing, -sv_nounlocking, sv_nv, sv_pos_b2u, sv_pos_u2b, sv_pv, sv_pvbyte, -sv_pvbyten, sv_pvbyten_force, sv_pvn, sv_pvn_force, sv_pvn_force_flags, -sv_pvutf8, sv_pvutf8n, sv_pvutf8n_force, sv_reftype, sv_replace, -sv_report_used, sv_reset, sv_rvweaken, sv_setiv, sv_setiv_mg, sv_setnv, -sv_setnv_mg, sv_setpv, sv_setpvf, sv_setpvf_mg, sv_setpvn, sv_setpvn_mg, -sv_setpv_mg, sv_setref_iv, sv_setref_nv, sv_setref_pv, sv_setref_pvn, -sv_setref_uv, sv_setsv, sv_setsv_flags, sv_setsv_mg, sv_setuv, sv_setuv_mg, -sv_taint, sv_tainted, sv_true, sv_unmagic, sv_unref, sv_unref_flags, -sv_untaint, sv_upgrade, sv_usepvn, sv_usepvn_mg, sv_utf8_decode, -sv_utf8_downgrade, sv_utf8_encode, sv_utf8_upgrade, sv_utf8_upgrade_flags, -sv_uv, sv_vcatpvfn, sv_vsetpvfn +SvCUR, SvCUR_set, SvEND, SvGROW, SvIOK, SvIOKp, SvIOK_notUV, SvIOK_off, +SvIOK_on, SvIOK_only, SvIOK_only_UV, SvIOK_UV, SvIsCOW, +SvIsCOW_shared_hash, SvIV, SvIVx, SvIVX, SvLEN, SvNIOK, SvNIOKp, +SvNIOK_off, SvNOK, SvNOKp, SvNOK_off, SvNOK_on, SvNOK_only, SvNV, SvNVX, +SvNVx, SvOK, SvOOK, SvPOK, SvPOKp, SvPOK_off, SvPOK_on, SvPOK_only, +SvPOK_only_UTF8, SvPV, SvPVbyte, SvPVbytex, SvPVbytex_force, +SvPVbyte_force, SvPVbyte_nolen, SvPVutf8, SvPVutf8x, SvPVutf8x_force, +SvPVutf8_force, SvPVutf8_nolen, SvPVx, SvPVX, SvPV_force, SvPV_force_nomg, +SvPV_nolen, SvREFCNT, SvREFCNT_dec, SvREFCNT_inc, SvROK, SvROK_off, +SvROK_on, SvRV, SvSTASH, SvTAINT, SvTAINTED, SvTAINTED_off, SvTAINTED_on, +SvTRUE, SvTYPE, SvUNLOCK, SvUOK, SvUPGRADE, SvUTF8, SvUTF8_off, SvUTF8_on, +SvUV, SvUVX, SvUVx, SvVOK, sv_2bool, sv_2cv, sv_2io, sv_2iv, sv_2mortal, +sv_2nv, sv_2pvbyte, sv_2pvbyte_nolen, sv_2pvutf8, sv_2pvutf8_nolen, +sv_2pv_flags, sv_2pv_nolen, sv_2uv, sv_backoff, sv_bless, sv_catpv, +sv_catpvf, sv_catpvf_mg, sv_catpvn, sv_catpvn_flags, sv_catpvn_mg, +sv_catpv_mg, sv_catsv, sv_catsv_flags, sv_catsv_mg, sv_chop, sv_clear, +sv_cmp, sv_cmp_locale, sv_collxfrm, sv_copypv, sv_dec, sv_derived_from, +sv_eq, sv_force_normal, sv_force_normal_flags, sv_free, sv_gets, sv_grow, +sv_inc, sv_insert, sv_isa, sv_isobject, sv_iv, sv_len, sv_len_utf8, +sv_magic, sv_magicext, sv_mortalcopy, sv_newmortal, sv_newref, sv_nv, +sv_pos_b2u, sv_pos_u2b, sv_pv, sv_pvbyte, sv_pvbyten, sv_pvbyten_force, +sv_pvn, sv_pvn_force, sv_pvn_force_flags, sv_pvutf8, sv_pvutf8n, +sv_pvutf8n_force, sv_reftype, sv_replace, sv_report_used, sv_reset, +sv_rvweaken, sv_setiv, sv_setiv_mg, sv_setnv, sv_setnv_mg, sv_setpv, +sv_setpvf, sv_setpvf_mg, sv_setpviv, sv_setpviv_mg, sv_setpvn, +sv_setpvn_mg, sv_setpv_mg, sv_setref_iv, sv_setref_nv, sv_setref_pv, +sv_setref_pvn, sv_setref_uv, sv_setsv, sv_setsv_flags, sv_setsv_mg, +sv_setuv, sv_setuv_mg, sv_taint, sv_tainted, sv_true, sv_unmagic, sv_unref, +sv_unref_flags, sv_untaint, sv_upgrade, sv_usepvn, sv_usepvn_mg, +sv_utf8_decode, sv_utf8_downgrade, sv_utf8_encode, sv_utf8_upgrade, +sv_utf8_upgrade_flags, sv_uv, sv_vcatpvfn, sv_vsetpvfn =item Unicode Support bytes_from_utf8, bytes_to_utf8, ibcmp_utf8, is_utf8_char, is_utf8_string, -pv_uni_display, sv_recode_to_utf8, sv_uni_display, to_utf8_case, -to_utf8_fold, to_utf8_lower, to_utf8_title, to_utf8_upper, utf8n_to_uvchr, -utf8n_to_uvuni, utf8_distance, utf8_hop, utf8_length, utf8_to_bytes, -utf8_to_uvchr, utf8_to_uvuni, uvchr_to_utf8, uvuni_to_utf8_flags +pv_uni_display, sv_cat_decode, sv_recode_to_utf8, sv_uni_display, +to_utf8_case, to_utf8_fold, to_utf8_lower, to_utf8_title, to_utf8_upper, +utf8n_to_uvchr, utf8n_to_uvuni, utf8_distance, utf8_hop, utf8_length, +utf8_to_bytes, utf8_to_uvchr, utf8_to_uvuni, uvchr_to_utf8, +uvuni_to_utf8_flags =item Variables created by C and C internal functions @@ -4598,6 +4705,22 @@ croak, warn =item DESCRIPTION +=item CV reference counts and CvOUTSIDE + +CvWEAKOUTSIDE + +=item Functions in file pad.h + +CX_CURPAD_SAVE, CX_CURPAD_SV, PAD_BASE_SV, PAD_CLONE_VARS, +PAD_COMPNAME_FLAGS, PAD_COMPNAME_GEN, PAD_COMPNAME_OURSTASH, +PAD_COMPNAME_PV, PAD_COMPNAME_TYPE, PAD_DUP, PAD_RESTORE_LOCAL, +PAD_SAVE_LOCAL, PAD_SAVE_SETNULLPAD, PAD_SETSV, PAD_SET_CUR, PAD_SV, +PAD_SVl, SAVECLEARSV, SAVECOMPPAD, SAVEPADSV + +=item Functions in file pp_ctl.c + +find_runcv + =item Global Variables PL_DBsingle, PL_DBsub, PL_DBtrace, PL_dowarn, PL_last_in_gv, PL_ofs_sv, @@ -4613,7 +4736,10 @@ start_glob =item Pad Data Structures -CvPADLIST +CvPADLIST, cv_clone, cv_dump, do_dump_pad, intro_my, pad_add_anon, +pad_add_name, pad_alloc, pad_block_start, pad_check_dup, pad_findlex, +pad_findmy, pad_fixup_inner_anons, pad_free, pad_leavemy, pad_new, +pad_push, pad_reset, pad_setsv, pad_swipe, pad_tidy, pad_undef =item Stack Manipulation Macros @@ -4666,6 +4792,8 @@ Getarg, Fileno, Dup, Read, Write, Seek, Tell, Close, Flush, Fill, Eof, Error, Clearerr, Setlinebuf, Get_base, Get_bufsiz, Get_ptr, Get_cnt, Set_ptrcnt +=item Implementing PerlIO Layers + =item Core Layers "unix", "perlio", "stdio", "crlf", "mmap", "pending", "raw", "utf8" @@ -4905,6 +5033,9 @@ PerlIO_apply_layers(f,mode,layers), PerlIO_binmode(f,ptype,imode,layers), =item Taint rethink +=item Perform correctly when XSUBs call subroutines that exit via +goto(LABEL) and friends + =back =item Vague ideas @@ -4955,6 +5086,8 @@ PerlIO_apply_layers(f,mode,layers), PerlIO_binmode(f,ptype,imode,layers), =back +=item Unicode in %ENV + =item Recently done things =over 4 @@ -5109,10 +5242,7 @@ It's easier to rsync the source tree, It's more reliable It's easier to rsync the patches, It's a good reference, Finding a start point, Finding how to fix a bug, Finding the source of misbehaviour -=item Perlbug remote interface - -1 http://bugs.perl.org, 2 bugdb@perl.org, 3 -commands_and_bugdids@bugs.perl.org, notes, patches, tests +=item Perlbug administration =item Submitting patches @@ -5137,6 +5267,8 @@ Argument stack, Mark stack, Save stack =item Millions of Macros +=item The .i Targets + =item Poking at Perl =item Using a source-level debugger @@ -5144,6 +5276,8 @@ Argument stack, Mark stack, Save stack run [args], break function_name, break source.c:xxx, step, next, continue, finish, 'enter', print +=item gdb macro support + =item Dumping Perl Data Structures =item Patching @@ -5155,12 +5289,18 @@ finish, 'enter', print =item Writing a test F, F, F, F, F, F, -F, F, t/base t/comp, t/cmd t/run t/io t/op, t/lib ext lib +F, F, F, F, F, t/base t/comp, +t/cmd t/run t/io t/op, t/lib ext lib =item Special Make Test Targets coretest, test.deparse, minitest, test.third check.third utest.third -ucheck.third, test.torture torturetest, utest ucheck test.utf8 check.utf8 +ucheck.third, test.torture torturetest, utest ucheck test.utf8 check.utf8, +test_harness + +=item Running tests by hand + +PERL_CORE=1, PERL_DESTRUCT_LEVEL=2, PERL, PERL_SKIP_TTY_TEST =back @@ -5207,6 +5347,31 @@ I =back +=head2 perldoc - Look up Perl documentation in Pod format. + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item OPTIONS + +B<-h>, B<-v>, B<-t>, B<-u>, B<-m> I, B<-l>, B<-F>, B<-f> +I, B<-q> I, B<-T>, B<-d> +I, B<-o> I, B<-M> I, +B<-w> I or B<-w> I

tag =item FETCHING ENVIRONMENT VARIABLES B, B, B, B, -B, B, B, B, -B, B, B, B, +B, B, B Return the script +name as a partial URL, for self-refering scripts, B, B, B, B, B, B, B, B, B, B, B, B @@ -10092,7 +10581,7 @@ other) error log =item MAKING WARNINGS APPEAR AS HTML COMMENTS -=item CHANGE LOG +=item OVERRIDING THE NAME OF THE PROGRAM =item AUTHORS @@ -10256,6 +10745,8 @@ FCGI_SOCKET_PATH, FCGI_LISTEN_QUEUE =item SYNOPSIS +=item STATUS + =item DESCRIPTION =over 4 @@ -10472,7 +10963,7 @@ Example 1, Example 2, Example 3 =item DESCRIPTION -myconfig(), config_sh(), config_vars(@names) +myconfig(), config_sh(), config_re($regex), config_vars(@names) =item EXAMPLE @@ -10509,91 +11000,93 @@ C, C, C =item d -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, -C, C, C, C, -C, C, C, C, -C, C, C, C, C, -C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, -C, C, C, C, -C, C, C, C, -C, C, C, C, -C, C, C, C, -C, C, C, C, -C, C, C, C, -C, C, C, C, C, -C, C, C, -C, C, C, -C, C, C, C, -C, C, C, C, -C, C, C, -C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, -C, C, C, C, C, -C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, -C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, +C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, +C, C, C, C, +C, C, C, +C, C, C, C, +C, C, C, C, +C, C, C, C, +C, C, C, C, +C, C, C, C, C, +C, C, C, +C, C, C, C, +C, C, C, C, +C, C, C, C, +C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, +C, C, C, +C, C, C, C, +C, C, C, C, C, +C, C, C, C, +C, C, C, C, C, +C, C, C, C, +C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, -C, C, C, C, -C, C, C, C, C, -C, C, C, C, -C, C, C, C, C, -C, C, C, C, -C, C, C, C, -C, C, C, C, C, -C, C, C, C, -C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, -C, C, C, C, C, -C, C, C, C, -C, C, C, C, -C, C, C, -C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, -C, C, C, C, -C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, +C, C, C, C, +C, C, C, C, C, +C, C, C, C, +C, C, C, C, C, +C, C, C, C, +C, C, C, C, +C, C, C, C, C, +C, C, C, C, +C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, +C, C, C, C, +C, C, C, C, +C, C, C, C, +C, C, C, C, +C, C, +C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, +C, C, C, C, C, +C, C, C, C, +C, C, C, C, C, +C, C, C, C, +C, C, C, C, +C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, @@ -10615,20 +11108,21 @@ C =item g -C, C, C, C, -C, C, C, -C, C, C, -C, C, C, -C, C, C, -C, C, C, -C, C, C, -C, C, C, C, C, C, -C, C, C, C, C, -C +C, C, C, C, +C, C, C, +C, C, C, +C, C, C, +C, C, +C, C, C, +C, C, C, +C, C, C, C, +C, C, C, C, C, +C, C, C, C, C =item h -C, C, C, C +C, C, C, C, C, C, +C, C =item i @@ -10650,12 +11144,16 @@ C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, -C, C, C, C, C, -C, C, C, -C, C, C, C, -C, C, C, -C, C, C, C, -C, C, C, C +C, C, C, C, C, +C, C, C, C, +C, C, C, +C, C, C, +C, C, C, +C, C, C, +C, C, C, +C, C, C, +C, C, C, +C, C, C, C, C =item k @@ -10679,8 +11177,9 @@ C, C =item M -C, C, C, C, C, C, -C, C, C, C, C, C +C, C, C, C, C, C, +C, C, C, C, C, C, +C =item n @@ -10726,16 +11225,19 @@ C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, -C, C, C, C, C +C, C, C, C, +C, C, C, C, +C, C, C, C, +C, C, C, C, +C, C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, +C, C, C =item t @@ -10748,18 +11250,22 @@ C C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, -C, C, C, C, -C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C +C, C, C, C, +C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C =item v C, C, C, C, -C, C, C, C, -C, C, C, +C, C, C, +C, C, C, C, +C, C, C, +C, C, C, C, +C, C, C, C, C, C =item x @@ -11005,22 +11511,6 @@ Dumper(I) =item Configuration Variables or Methods -$Data::Dumper::Indent I I<$OBJ>->Indent(I<[NEWVAL]>), -$Data::Dumper::Purity I I<$OBJ>->Purity(I<[NEWVAL]>), -$Data::Dumper::Pad I I<$OBJ>->Pad(I<[NEWVAL]>), -$Data::Dumper::Varname I I<$OBJ>->Varname(I<[NEWVAL]>), -$Data::Dumper::Useqq I I<$OBJ>->Useqq(I<[NEWVAL]>), -$Data::Dumper::Terse I I<$OBJ>->Terse(I<[NEWVAL]>), -$Data::Dumper::Freezer I $I->Freezer(I<[NEWVAL]>), -$Data::Dumper::Toaster I $I->Toaster(I<[NEWVAL]>), -$Data::Dumper::Deepcopy I $I->Deepcopy(I<[NEWVAL]>), -$Data::Dumper::Quotekeys I $I->Quotekeys(I<[NEWVAL]>), -$Data::Dumper::Bless I $I->Bless(I<[NEWVAL]>), -$Data::Dumper::Maxdepth I $I->Maxdepth(I<[NEWVAL]>), -$Data::Dumper::Useperl I $I->Useperl(I<[NEWVAL]>), -$Data::Dumper::Sortkeys I $I->Sortkeys(I<[NEWVAL]>), -$Data::Dumper::Deparse I $I->Deparse(I<[NEWVAL]>) - =item Exports Dumper @@ -11031,6 +11521,12 @@ Dumper =item BUGS +=over 4 + +=item NOTE + +=back + =item AUTHOR =item VERSION @@ -11059,7 +11555,7 @@ Dumper =back -=head2 Devel::PPPort, Perl/Pollution/Portability +=head2 Devel::PPPort - Perl/Pollution/Portability =over 4 @@ -11154,8 +11650,9 @@ I, I, I =item OO INTERFACE $ctx = Digest->XXX($arg,...), $ctx = Digest->new(XXX => $arg,...), $ctx = -Digest::XXX->new($arg,...), $ctx->reset, $ctx->add($data,...), -$ctx->addfile($io_handle), $ctx->digest, $ctx->hexdigest, $ctx->b64digest +Digest::XXX->new($arg,...), $other_ctx = $ctx->clone, $ctx->reset, +$ctx->add($data,...), $ctx->addfile($io_handle), $ctx->digest, +$ctx->hexdigest, $ctx->b64digest =item SEE ALSO @@ -11177,7 +11674,7 @@ md5($data,...), md5_hex($data,...), md5_base64($data,...) =item METHODS -$md5 = Digest::MD5->new, $md5->reset, $md5->add($data,...), +$md5 = Digest::MD5->new, $md5->reset, $md5->clone, $md5->add($data,...), $md5->addfile($io_handle), $md5->digest, $md5->hexdigest, $md5->b64digest =item EXAMPLES @@ -11238,7 +11735,7 @@ compactDump, veryCompact, set, get @dl_library_path, @dl_resolve_using, @dl_require_symbols, @dl_librefs, @dl_modules, dl_error(), $dl_debug, dl_findfile(), dl_expandspec(), -dl_load_file(), dl_unload_file(), dl_loadflags(), dl_find_symbol(), +dl_load_file(), dl_unload_file(), dl_load_flags(), dl_find_symbol(), dl_find_symbol_anywhere(), dl_undef_symbols(), dl_install_xsub(), bootstrap() @@ -11365,7 +11862,7 @@ reference, e.g.: =back -=head2 Encode::CJKConstants -- Internally used by Encode::??::ISO_2022_* +=head2 Encode::CJKConstants -- Internally used by Encode::??::ISO_2022_* =head2 Encode::CN - China-based Chinese Encodings @@ -11413,11 +11910,12 @@ reference, e.g.: =item Methods you should implement --Eencode($string [,$check]), -Edecode($octets [,$check]) +-Eencode($string [,$check]), -Edecode($octets [,$check]), +-Ecat_decode($destination, $octets, $offset, $terminator [,$check]) =item Other methods defined in Encode::Encodings --Ename, -Enew_sequence, -Eperlio_ok(), -Eneeds_lines() +-Ename, -Erenew, -Eperlio_ok(), -Eneeds_lines() =item Example: Encode::ROT13 @@ -11521,12 +12019,10 @@ guess_encoding($data, [, I]) =item How does it work? -=item BUGS +=item Line Buffering =over 4 -=item Workaround - =item How can I tell whether my encoding fully supports PerlIO ? =back @@ -11677,6 +12173,20 @@ BOM as integer when fetched in network byte order =back +=head2 Encode::Unicode::UTF7 -- UTF-7 encoding + +=over 4 + +=item SYNOPSIS + +=item ABSTRACT + +=item In Practice + +=item SEE ALSO + +=back + =head2 Encode::lib::Encode::Alias, Encode::Alias - alias definitions to encodings @@ -11699,7 +12209,7 @@ reference, e.g.: =back -=head2 Encode::lib::Encode::CJKConstants, Encode::CJKConstants.pm -- +=head2 Encode::lib::Encode::CJKConstants, Encode::CJKConstants.pm -- Internally used by Encode::??::ISO_2022_* =head2 Encode::lib::Encode::CN::HZ, Encode::CN::HZ -- internally used by @@ -11721,11 +12231,12 @@ Implementation Base Class =item Methods you should implement --Eencode($string [,$check]), -Edecode($octets [,$check]) +-Eencode($string [,$check]), -Edecode($octets [,$check]), +-Ecat_decode($destination, $octets, $offset, $terminator [,$check]) =item Other methods defined in Encode::Encodings --Ename, -Enew_sequence, -Eperlio_ok(), -Eneeds_lines() +-Ename, -Erenew, -Eperlio_ok(), -Eneeds_lines() =item Example: Encode::ROT13 @@ -11803,12 +12314,10 @@ on Encode and PerlIO =item How does it work? -=item BUGS +=item Line Buffering =over 4 -=item Workaround - =item How can I tell whether my encoding fully supports PerlIO ? =back @@ -11902,34 +12411,34 @@ C by Ken Lunde =back -=head2 Encode::lib::Encoder, Encode::Encoder -- Object Oriented Encoder +=head2 Encode::lib::Encode::Unicode::UTF7, Encode::Unicode::UTF7 -- UTF-7 +encoding =over 4 =item SYNOPSIS - use Encode::Encoder; - # Encode::encode("ISO-8859-1", $data); - Encode::Encoder->new($data)->iso_8859_1; # OOP way - # shortcut - use Encode::Encoder qw(encoder); - encoder($data)->iso_8859_1; - # you can stack them! - encoder($data)->iso_8859_1->base64; # provided base64() is defined - # you can use it as a decoder as well - encoder($base64)->bytes('base64')->latin1; - # stringified - print encoder($data)->utf8->latin1; # prints the string in latin1 - # numified - encoder("\x{abcd}\x{ef}g")->utf8 == 6; # true. bytes::length($data) - =item ABSTRACT -=item Description +=item In Practice -=over 4 +=item SEE ALSO -=item Predefined Methods +=back + +=head2 Encode::lib::Encoder, Encode::Encoder -- Object Oriented Encoder + +=over 4 + +=item SYNOPSIS + +=item ABSTRACT + +=item Description + +=over 4 + +=item Predefined Methods $e = Encode::Encoder-Enew([$data, $encoding]);, encoder(), $e-Edata([$data]), $e-Eencoding([$encoding]), @@ -11954,10 +12463,30 @@ non-ascii or non-utf8 =item ABSTRACT +=over 4 + +=item Literal Conversions + +=item PerlIO layers for C + +=back + +=item FEATURES THAT REQUIRE 5.8.1 + +"NON-EUC" doublebyte encodings, tr//, DATA pseudo-filehandle + =item USAGE use encoding [I] ;, use encoding I [ STDIN =E -I ...] ;, no encoding; +I ...] ;, use encoding I Filter=E1;, no encoding; + +=item The Filter Option + +=over 4 + +=item Filter-related changes at Encode version 1.87 + +=back =item CAVEATS @@ -11967,16 +12496,20 @@ I ...] ;, no encoding; =item DO NOT MIX MULTIPLE ENCODINGS -=back +=item tr/// with ranges -=item Non-ASCII Identifiers and Filter option +Legend of characters above -use encoding I Filter=E1; +=back =item EXAMPLE - Greekperl =item KNOWN PROBLEMS +literals in regex that are longer than 127 bytes, EBCDIC, format + +=item HISTORY + =item SEE ALSO =back @@ -11987,21 +12520,6 @@ use encoding I Filter=E1; =item SYNOPSIS - use Encode::Encoder; - # Encode::encode("ISO-8859-1", $data); - Encode::Encoder->new($data)->iso_8859_1; # OOP way - # shortcut - use Encode::Encoder qw(encoder); - encoder($data)->iso_8859_1; - # you can stack them! - encoder($data)->iso_8859_1->base64; # provided base64() is defined - # you can use it as a decoder as well - encoder($base64)->bytes('base64')->latin1; - # stringified - print encoder($data)->utf8->latin1; # prints the string in latin1 - # numified - encoder("\x{abcd}\x{ef}g")->utf8 == 6; # true. bytes::length($data) - =item ABSTRACT =item Description @@ -12173,6 +12691,14 @@ B =back +B + +B + +B + +B + =head2 ExtUtils::Constant - generate XS code to import C header constants =over 4 @@ -12258,6 +12784,34 @@ ccopts(), xsi_header(), xsi_protos(@modules), xsi_body(@modules) =item DESCRIPTION +=over 4 + +=item Functions + +B + +=back + +=back + +B I + +B + +B + +_autosplit + +=over 4 + +=item ENVIRONMENT + +B + +=item AUTHOR + +=item LICENSE + =back =head2 ExtUtils::Installed - Inventory management of installed modules @@ -12336,39 +12890,69 @@ dynamic extensions at load time =item Inherently Cross-Platform Methods +installvars + +=back + +os_flavor_is + =over 4 -=item File::Spec wrappers B +=item File::Spec wrappers -canonpath +catfile =back +=over 4 + +=item Thought To Be Cross-Platform Methods + +B + =back -catdir +B -catfile +init_VERSION -curdir +wraplist -file_name_is_absolute +manifypods -path +manifypods_target -rootdir +makemakerdflt_target -updir +special_targets + +POD2MAN_EXE_macro + +test_via_harness + +test_via_script + +libscan + +tool_autosplit + +all_target + +metafile_target + +metafile_addtomanifest_target =over 4 -=item Thought To Be Cross-Platform Methods +=item Abstract methods -test_via_harness +oneliner, B, B, max_exec_len, +B, init_DIRFILESEP, init_linker, init_platform, +platform_constants =back -test_via_script +os_flavor =over 4 @@ -12387,7 +12971,9 @@ ExtUtils::MakeMaker =back -perl_archive +os_flavor (o) + +init_linker =head2 ExtUtils::MM_Cygwin - methods to override UN*X behaviour in ExtUtils::MakeMaker @@ -12398,10 +12984,16 @@ ExtUtils::MakeMaker =item DESCRIPTION -canonpath, cflags, manifypods, perl_archive +os_flavor (o) =back +cflags (o) + +replace_manpage_separator (o) + +init_linker + =head2 ExtUtils::MM_DOS - DOS specific subclass of ExtUtils::MM_Unix =over 4 @@ -12414,12 +13006,14 @@ canonpath, cflags, manifypods, perl_archive =item Overridden methods -B +os_flavor =back =back +B + =over 4 =item AUTHOR @@ -12451,11 +13045,13 @@ init_main init_others +init_platform, platform_constants + init_dirscan -libscan (o) +init_VERSION (o) -constants (o) +special_targets (o) static (o) @@ -12465,12 +13061,18 @@ dynamic (o) clean (o) +clean_subdirs_target + realclean (o) +realclean_subdirs_target + rulez (o) processPL (o) +os_flavor + =head2 ExtUtils::MM_NW5 - methods to override UN*X behaviour in ExtUtils::MakeMaker @@ -12482,7 +13084,11 @@ ExtUtils::MakeMaker =back -constants (o) +os_flavor + +init_platform (o), platform_constants + +const_cccmd (o) static_lib (o) @@ -12499,9 +13105,13 @@ ExtUtils::MakeMaker =item METHODS +init_dist (o) + =back -perl_archive_after +init_linker + +os_flavor =head2 ExtUtils::MM_UWIN - U/WIN specific subclass of ExtUtils::MM_Unix @@ -12515,12 +13125,14 @@ perl_archive_after =item Overridden methods -B +os_flavor =back =back +B + =over 4 =item AUTHOR @@ -12543,16 +13155,20 @@ B =over 4 -=item SelfLoaded methods +=item Methods -c_o (o) +os_flavor (o) =back +c_o (o) + cflags (o) clean (o) +clean_subdirs_target + const_cccmd (o) const_config (o) @@ -12565,6 +13181,10 @@ depend (o) dir_target (o) +init_DEST + +init_dist + dist (o) dist_basics (o) @@ -12573,7 +13193,21 @@ dist_ci (o) dist_core (o) -dist_dir +B + +B + +B + +B + +zipfile_target + +uutardist_target + +shdist_target + +distdir dist_test @@ -12609,6 +13243,8 @@ has_link_code init_dirscan +init_DIRFILESEP + init_main init_others @@ -12617,18 +13253,22 @@ init_INST init_INSTALL +init_linker + init_lib2arch init_PERL +init_platform (o), platform_constants (o) + init_PERM +init_xs + install (o) installbin (o) -libscan (o) - linkext (o) lsdir @@ -12639,12 +13279,8 @@ makeaperl (o) makefile (o) -manifypods (o) - maybe_command -maybe_command_in_dirs - needs_linking (o) nicetext @@ -12681,8 +13317,18 @@ quote_paren realclean (o) +realclean_subdirs_target + replace_manpage_separator +oneliner (o) + +quote_literal + +escape_newlines + +max_exec_len + static (o) static_lib (o) @@ -12699,12 +13345,12 @@ test_via_harness (override) test_via_script (override) -tool_autosplit (o) - tools_other (o) tool_xsubpp (o) +all_target + top_targets (o) writedoc @@ -12715,12 +13361,6 @@ xs_cpp (o) xs_o (o) -perl_archive - -perl_archive_after - -export_list - =over 4 =item SEE ALSO @@ -12758,33 +13398,37 @@ find_perl (override) maybe_command (override) -maybe_command_in_dirs (override) - perl_script (override) replace_manpage_separator +init_DEST + +init_DIRFILESEP + init_main (override) init_others (override) +init_platform (override) + +platform_constants + +init_VERSION (override) + constants (override) +special_targets + cflags (override) const_cccmd (override) -pm_to_blib (override) - -tool_autosplit (override) - tool_sxubpp (override) -xsubpp_version (override) - tools_other (override) -dist (override) +init_dist (override) c_o (override) @@ -12792,8 +13436,6 @@ xs_c (override) xs_o (override) -top_targets (override) - dlsyms (override) dynamic_lib (override) @@ -12802,8 +13444,6 @@ dynamic_bs (override) static_lib (override) -manifypods (override) - processPL (override) installbin (override) @@ -12812,9 +13452,11 @@ subdir_x (override) clean (override) +clean_subdirs_target + realclean (override) -dist_core (override) +zipfile_target (o), tarfile_target (o), shdist_target (o) dist_test (override) @@ -12834,6 +13476,24 @@ nicetext (override) prefixify (override) +oneliner (o) + +B (o) + +quote_literal + +escape_newlines + +max_exec_len + +init_linker (o) + +eliminate_macros + +fixpath + +os_flavor + =head2 ExtUtils::MM_Win32 - methods to override UN*X behaviour in ExtUtils::MakeMaker @@ -12845,34 +13505,48 @@ ExtUtils::MakeMaker =back -constants (o) +=over 4 -static_lib (o) +=item Overridden methods -dynamic_bs (o) +B -dynamic_lib (o) +=back -perl_script +replace_manpage_separator -pm_to_blib +B -tool_autosplit (override) +B -tools_other (o) +B -xs_o (o) +B -top_targets (o) +init_platform (o), platform_constants (o) -manifypods (o) +special_targets (o) -dist_ci (o) +static_lib (o) -dist_core (o) +dynamic_lib (o) + +clean + +init_linker + +perl_script + +xs_o (o) pasthru (o) +oneliner (o) + +max_exec_len + +os_flavor + =head2 ExtUtils::MM_Win95 - method to customize MakeMaker for Win9X =over 4 @@ -12881,6 +13555,36 @@ pasthru (o) =item DESCRIPTION +=over 4 + +=item Overriden methods + +dist_test + +=back + +=back + +subdir_x + +xs_c + +xs_cpp + +xs_o + +clean_subdirs_target + +realclean_subdirs_target + +max_exec_len + +os_flavor + +=over 4 + +=item AUTHOR + =back =head2 ExtUtils::MY - ExtUtils::MakeMaker subclass for customization @@ -12893,7 +13597,7 @@ pasthru (o) =back -=head2 ExtUtils::MakeMaker - create an extension Makefile +=head2 ExtUtils::MakeMaker - Create a module Makefile =over 4 @@ -12926,27 +13630,28 @@ pasthru (o) =item Using Attributes and Parameters ABSTRACT, ABSTRACT_FROM, AUTHOR, BINARY_LOCATION, C, CCFLAGS, CONFIG, -CONFIGURE, DEFINE, DIR, DISTNAME, DL_FUNCS, DL_VARS, EXCLUDE_EXT, -EXE_FILES, FIRST_MAKEFILE, FULLPERL, FULLPERLRUN, FULLPERLRUNINST, -FUNCLIST, H, IMPORTS, INC, INCLUDE_EXT, INSTALLARCHLIB, INSTALLBIN, -INSTALLDIRS, INSTALLMAN1DIR, INSTALLMAN3DIR, INSTALLPRIVLIB, INSTALLSCRIPT, -INSTALLSITEARCH, INSTALLSITEBIN, INSTALLSITELIB, INSTALLSITEMAN1DIR, -INSTALLSITEMAN3DIR, INSTALLVENDORARCH, INSTALLVENDORBIN, INSTALLVENDORLIB, -INSTALLVENDORMAN1DIR, INSTALLVENDORMAN3DIR, INST_ARCHLIB, INST_BIN, -INST_LIB, INST_MAN1DIR, INST_MAN3DIR, INST_SCRIPT, LDDLFLAGS, LDFROM, LIB, -LIBPERL_A, LIBS, LINKTYPE, MAKEAPERL, MAKEFILE, MAN1PODS, MAN3PODS, -MAP_TARGET, MYEXTLIB, NAME, NEEDS_LINKING, NOECHO, NORECURS, NO_VC, OBJECT, +CONFIGURE, DEFINE, DESTDIR, DIR, DISTNAME, DISTVNAME, DL_FUNCS, DL_VARS, +EXCLUDE_EXT, EXE_FILES, FIRST_MAKEFILE, FULLPERL, FULLPERLRUN, +FULLPERLRUNINST, FUNCLIST, H, IMPORTS, INC, INCLUDE_EXT, INSTALLARCHLIB, +INSTALLBIN, INSTALLDIRS, INSTALLMAN1DIR, INSTALLMAN3DIR, INSTALLPRIVLIB, +INSTALLSCRIPT, INSTALLSITEARCH, INSTALLSITEBIN, INSTALLSITELIB, +INSTALLSITEMAN1DIR, INSTALLSITEMAN3DIR, INSTALLVENDORARCH, +INSTALLVENDORBIN, INSTALLVENDORLIB, INSTALLVENDORMAN1DIR, +INSTALLVENDORMAN3DIR, INST_ARCHLIB, INST_BIN, INST_LIB, INST_MAN1DIR, +INST_MAN3DIR, INST_SCRIPT, LD, LDDLFLAGS, LDFROM, LIB, LIBPERL_A, LIBS, +LINKTYPE, MAKEAPERL, MAKEFILE_OLD, MAN1PODS, MAN3PODS, MAP_TARGET, +MYEXTLIB, NAME, NEEDS_LINKING, NOECHO, NORECURS, NO_META, NO_VC, OBJECT, OPTIMIZE, PERL, PERL_CORE, PERLMAINCC, PERL_ARCHLIB, PERL_LIB, -PERL_MALLOC_OK, PERLRUN, PERLRUNINST, PERL_SRC, PERM_RW, PERM_RWX, -PL_FILES, PM, PMLIBDIRS, PM_FILTER, POLLUTE, PPM_INSTALL_EXEC, +PERL_MALLOC_OK, PERLPREFIX, PERLRUN, PERLRUNINST, PERL_SRC, PERM_RW, +PERM_RWX, PL_FILES, PM, PMLIBDIRS, PM_FILTER, POLLUTE, PPM_INSTALL_EXEC, PPM_INSTALL_SCRIPT, PREFIX, PREREQ_FATAL, PREREQ_PM, PREREQ_PRINT, PRINT_PREREQ, SITEPREFIX, SKIP, TYPEMAPS, VENDORPREFIX, VERBINST, VERSION, -VERSION_FROM, XS, XSOPT, XSPROTOARG, XS_VERSION +VERSION_FROM, VERSION_SYM, XS, XSOPT, XSPROTOARG, XS_VERSION =item Additional lowercase attributes -clean, depend, dist, dynamic_lib, linkext, macro, realclean, test, -tool_autosplit +clean, depend, dist, dynamic_lib, linkext, macro, postamble, realclean, +test, tool_autosplit =item Overriding MakeMaker Methods @@ -12962,8 +13667,14 @@ C< ' '>> make distdir, make disttest, make tardist, make dist, make uutardist, make shdist, make zipdist, make ci +=item Module Meta-Data + =item Disabling an extension +=item Other Handy Functions + +prompt + =back =item ENVIRONMENT @@ -12974,9 +13685,47 @@ PERL_MM_OPT, PERL_MM_USE_DEFAULT =item AUTHORS +=item LICENSE + =back -=head2 ExtUtils::Manifest - utilities to write and check a MANIFEST file +=head2 ExtUtils::MakeMaker::FAQ - Frequently Asked Questions About +MakeMaker + +=over 4 + +=item DESCRIPTION + +=over 4 + +=item Philosophy and History + +Why not just use ?, What's +Module::Build and how does it relate to MakeMaker?, pure perl. no make, no +shell commands, easier to customize, cleaner internals, less cruft + +=item Module Writing + +How do I keep my $VERSION up to date without resetting it manually?, What's +this F thing and how did it get in my F?! + +=item XS + +How to I prevent "object version X.XX does not match bootstrap parameter +Y.YY" errors?, How do I make two or more XS files coexist in the same +directory? + +=back + +=item PATCHING + +=item AUTHOR + +=item SEE ALSO + +=back + +=head2 ExtUtils::MakeMaker::Tutorial - Writing a module with MakeMaker =over 4 @@ -12984,28 +13733,42 @@ PERL_MM_OPT, PERL_MM_USE_DEFAULT =item DESCRIPTION -=item MANIFEST.SKIP +=over 4 -=item EXPORT_OK +=item The Mantra -=item GLOBAL VARIABLES +=item The Layout -=item DIAGNOSTICS +Makefile.PL, MANIFEST, lib/, t/, Changes, README, INSTALL, MANIFEST.SKIP, +bin/ -C I, C I, C I, -C I<$!>, C I +=back -=item ENVIRONMENT +=item SEE ALSO -B +=back -=item SEE ALSO +=head2 ExtUtils::MakeMaker::bytes - Version agnostic bytes.pm -=item AUTHOR +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=back + +=head2 ExtUtils::MakeMaker::vmsish - Platform agnostic vmsish.pm + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION =back -=head2 ExtUtils::Miniperl, writemain - write the C code for perlmain.c +=head2 ExtUtils::Manifest - utilities to write and check a MANIFEST file =over 4 @@ -13013,8 +13776,59 @@ B =item DESCRIPTION +=over 4 + +=item Functions + +mkmanifest + +=back + +=back + +manifind + +manicheck + +filecheck + +fullcheck + +skipcheck + +maniread + +manicopy + +maniadd + +=over 4 + +=item MANIFEST + +=item MANIFEST.SKIP + +=item EXPORT_OK + +=item GLOBAL VARIABLES + +=back + +=over 4 + +=item DIAGNOSTICS + +C I, C I, C I, +C I<$!>, C I + +=item ENVIRONMENT + +B + =item SEE ALSO +=item AUTHOR + =back =head2 ExtUtils::Mkbootstrap - make a bootstrap file for use by DynaLoader @@ -13258,6 +14072,8 @@ C, C =item DESCRIPTION +=item DIAGNOSTICS + =item AUTHORS =back @@ -13292,6 +14108,12 @@ splitdir, catpath(), abs2rel, rel2abs() =back +canonpath + +file_name_is_absolute + +tmpdir (override) + =head2 File::Spec::Epoc - methods for Epoc file specs =over 4 @@ -13300,10 +14122,12 @@ splitdir, catpath(), abs2rel, rel2abs() =item DESCRIPTION -canonpath() +=item AUTHORS =back +canonpath() + =over 4 =item SEE ALSO @@ -13378,6 +14202,8 @@ rel2abs =back +tmpdir + canonpath splitpath @@ -13643,6 +14469,8 @@ TopSystemUID =item DESCRIPTION +=item BUGS + =item NOTE =item AUTHOR @@ -13663,6 +14491,8 @@ cacheout EXPR, cacheout MODE, EXPR =item BUGS +=item NOTES + =back =head2 FileHandle - supply object methods for filehandles @@ -13866,9 +14696,14 @@ B<$_>, B<$status>, B and B, B default, posix_default, auto_abbrev, getopt_compat, gnu_compat, gnu_getopt, require_order, permute, bundling (default: disabled), bundling_override (default: disabled), ignore_case (default: enabled), ignore_case_always -(default: disabled), pass_through (default: disabled), prefix, +(default: disabled), auto_version (default:disabled), auto_help +(default:disabled), pass_through (default: disabled), prefix, prefix_pattern, debug (default: disabled) +=item Exportable Methods + +VersionMessage, C<-message>, C<-msg>, C<-exitval>, C<-output>, HelpMessage + =item Return values and Errors =item Legacy @@ -13894,6 +14729,8 @@ supplied =item GetOptions does not split the command line correctly +=item Undefined subroutine &main::GetOptions called + =item How do I put a "-?" option into a Getopt::Long? =back @@ -13913,6 +14750,8 @@ clustering =item DESCRIPTION +=item C<--help> and C<--version> + =back =head2 Hash::Util - A selection of general-utility hash subroutines @@ -13939,6 +14778,8 @@ B, B =over 4 +=item CAVEATS + =item AUTHOR =item SEE ALSO @@ -14013,88 +14854,93 @@ the function @langs = panic_languages(@accept_languages) =item LIST OF LANGUAGES -{ab} : Abkhazian, {ace} : Achinese, {ach} : Acoli, {ada} : Adangme, {aa} : -Afar, {afh} : Afrihili, {af} : Afrikaans, [{afa} : Afro-Asiatic (Other)], -{aka} : Akan, {akk} : Akkadian, {sq} : Albanian, {ale} : Aleut, [{alg} : -Algonquian languages], [{tut} : Altaic (Other)], {am} : Amharic, {i-ami} : -Ami, [{apa} : Apache languages], {ar} : Arabic, {arc} : Aramaic, {arp} : -Arapaho, {arn} : Araucanian, {arw} : Arawak, {hy} : Armenian, [{art} : -Artificial (Other)], {as} : Assamese, [{ath} : Athapascan languages], -[{aus} : Australian languages], [{map} : Austronesian (Other)], {ava} : -Avaric, {ae} : Avestan, {awa} : Awadhi, {ay} : Aymara, {az} : Azerbaijani, -{ban} : Balinese, [{bat} : Baltic (Other)], {bal} : Baluchi, {bam} : -Bambara, [{bai} : Bamileke languages], {bad} : Banda, [{bnt} : Bantu -(Other)], {bas} : Basa, {ba} : Bashkir, {eu} : Basque, {btk} : Batak -(Indonesia), {bej} : Beja, {be} : Belarusian, {bem} : Bemba, {bn} : -Bengali, [{ber} : Berber (Other)], {bho} : Bhojpuri, {bh} : Bihari, {bik} : -Bikol, {bin} : Bini, {bi} : Bislama, {bs} : Bosnian, {bra} : Braj, {br} : -Breton, {bug} : Buginese, {bg} : Bulgarian, {i-bnn} : Bunun, {bua} : -Buriat, {my} : Burmese, {cad} : Caddo, {car} : Carib, {ca} : Catalan, -[{cau} : Caucasian (Other)], {ceb} : Cebuano, [{cel} : Celtic (Other)], -[{cai} : Central American Indian (Other)], {chg} : Chagatai, [{cmc} : -Chamic languages], {ch} : Chamorro, {ce} : Chechen, {chr} : Cherokee, {chy} -: Cheyenne, {chb} : Chibcha, {ny} : Chichewa, {zh} : Chinese, {chn} : -Chinook Jargon, {chp} : Chipewyan, {cho} : Choctaw, {cu} : Church Slavic, -{chk} : Chuukese, {cv} : Chuvash, {cop} : Coptic, {kw} : Cornish, {co} : -Corsican, {cre} : Cree, {mus} : Creek, [{cpe} : English-based Creoles and -pidgins (Other)], [{cpf} : French-based Creoles and pidgins (Other)], -[{cpp} : Portuguese-based Creoles and pidgins (Other)], [{crp} : Creoles -and pidgins (Other)], {hr} : Croatian, [{cus} : Cushitic (Other)], {cs} : -Czech, {dak} : Dakota, {da} : Danish, {day} : Dayak, {i-default} : Default -(Fallthru) Language, {del} : Delaware, {din} : Dinka, {div} : Divehi, {doi} -: Dogri, {dgr} : Dogrib, [{dra} : Dravidian (Other)], {dua} : Duala, {nl} : -Dutch, {dum} : Middle Dutch (ca.1050-1350), {dyu} : Dyula, {dz} : Dzongkha, -{efi} : Efik, {egy} : Ancient Egyptian, {eka} : Ekajuk, {elx} : Elamite, -{en} : English, {enm} : Old English (1100-1500), {ang} : Old English -(ca.450-1100), {eo} : Esperanto, {et} : Estonian, {ewe} : Ewe, {ewo} : -Ewondo, {fan} : Fang, {fat} : Fanti, {fo} : Faroese, {fj} : Fijian, {fi} : -Finnish, [{fiu} : Finno-Ugrian (Other)], {fon} : Fon, {fr} : French, {frm} -: Middle French (ca.1400-1600), {fro} : Old French (842-ca.1400), {fy} : -Frisian, {fur} : Friulian, {ful} : Fulah, {gaa} : Ga, {gd} : Scots Gaelic, -{gl} : Gallegan, {lug} : Ganda, {gay} : Gayo, {gba} : Gbaya, {gez} : Geez, -{ka} : Georgian, {de} : German, {gmh} : Middle High German (ca.1050-1500), -{goh} : Old High German (ca.750-1050), [{gem} : Germanic (Other)], {gil} : -Gilbertese, {gon} : Gondi, {gor} : Gorontalo, {got} : Gothic, {grb} : -Grebo, {grc} : Ancient Greek, {el} : Modern Greek, {gn} : Guarani, {gu} : -Gujarati, {gwi} : Gwich'in, {hai} : Haida, {ha} : Hausa, {haw} : Hawaiian, +{ab} : Abkhazian, {ace} : Achinese, {ach} : Acoli, {ada} : Adangme, {ady} : +Adyghe, {aa} : Afar, {afh} : Afrihili, {af} : Afrikaans, [{afa} : +Afro-Asiatic (Other)], {ak} : Akan, {akk} : Akkadian, {sq} : Albanian, +{ale} : Aleut, [{alg} : Algonquian languages], [{tut} : Altaic (Other)], +{am} : Amharic, {i-ami} : Ami, [{apa} : Apache languages], {ar} : Arabic, +{arc} : Aramaic, {arp} : Arapaho, {arn} : Araucanian, {arw} : Arawak, {hy} +: Armenian, {an} : Aragonese, [{art} : Artificial (Other)], {ast} : +Asturian, {as} : Assamese, [{ath} : Athapascan languages], [{aus} : +Australian languages], [{map} : Austronesian (Other)], {av} : Avaric, {ae} +: Avestan, {awa} : Awadhi, {ay} : Aymara, {az} : Azerbaijani, {ban} : +Balinese, [{bat} : Baltic (Other)], {bal} : Baluchi, {bm} : Bambara, [{bai} +: Bamileke languages], {bad} : Banda, [{bnt} : Bantu (Other)], {bas} : +Basa, {ba} : Bashkir, {eu} : Basque, {btk} : Batak (Indonesia), {bej} : +Beja, {be} : Belarusian, {bem} : Bemba, {bn} : Bengali, [{ber} : Berber +(Other)], {bho} : Bhojpuri, {bh} : Bihari, {bik} : Bikol, {bin} : Bini, +{bi} : Bislama, {bs} : Bosnian, {bra} : Braj, {br} : Breton, {bug} : +Buginese, {bg} : Bulgarian, {i-bnn} : Bunun, {bua} : Buriat, {my} : +Burmese, {cad} : Caddo, {car} : Carib, {ca} : Catalan, [{cau} : Caucasian +(Other)], {ceb} : Cebuano, [{cel} : Celtic (Other)], [{cai} : Central +American Indian (Other)], {chg} : Chagatai, [{cmc} : Chamic languages], +{ch} : Chamorro, {ce} : Chechen, {chr} : Cherokee, {chy} : Cheyenne, {chb} +: Chibcha, {ny} : Chichewa, {zh} : Chinese, {chn} : Chinook Jargon, {chp} : +Chipewyan, {cho} : Choctaw, {cu} : Church Slavic, {chk} : Chuukese, {cv} : +Chuvash, {cop} : Coptic, {kw} : Cornish, {co} : Corsican, {cr} : Cree, +{mus} : Creek, [{cpe} : English-based Creoles and pidgins (Other)], [{cpf} +: French-based Creoles and pidgins (Other)], [{cpp} : Portuguese-based +Creoles and pidgins (Other)], [{crp} : Creoles and pidgins (Other)], {hr} : +Croatian, [{cus} : Cushitic (Other)], {cs} : Czech, {dak} : Dakota, {da} : +Danish, {dar} : Dargwa, {day} : Dayak, {i-default} : Default (Fallthru) +Language, {del} : Delaware, {din} : Dinka, {dv} : Divehi, {doi} : Dogri, +{dgr} : Dogrib, [{dra} : Dravidian (Other)], {dua} : Duala, {nl} : Dutch, +{dum} : Middle Dutch (ca.1050-1350), {dyu} : Dyula, {dz} : Dzongkha, {efi} +: Efik, {egy} : Ancient Egyptian, {eka} : Ekajuk, {elx} : Elamite, {en} : +English, {enm} : Old English (1100-1500), {ang} : Old English +(ca.450-1100), {i-enochian} : Enochian (Artificial), {myv} : Erzya, {eo} : +Esperanto, {et} : Estonian, {ee} : Ewe, {ewo} : Ewondo, {fan} : Fang, {fat} +: Fanti, {fo} : Faroese, {fj} : Fijian, {fi} : Finnish, [{fiu} : +Finno-Ugrian (Other)], {fon} : Fon, {fr} : French, {frm} : Middle French +(ca.1400-1600), {fro} : Old French (842-ca.1400), {fy} : Frisian, {fur} : +Friulian, {ff} : Fulah, {gaa} : Ga, {gd} : Scots Gaelic, {gl} : Gallegan, +{lg} : Ganda, {gay} : Gayo, {gba} : Gbaya, {gez} : Geez, {ka} : Georgian, +{de} : German, {gmh} : Middle High German (ca.1050-1500), {goh} : Old High +German (ca.750-1050), [{gem} : Germanic (Other)], {gil} : Gilbertese, {gon} +: Gondi, {gor} : Gorontalo, {got} : Gothic, {grb} : Grebo, {grc} : Ancient +Greek, {el} : Modern Greek, {gn} : Guarani, {gu} : Gujarati, {gwi} : +Gwich'in, {hai} : Haida, {ht} : Haitian, {ha} : Hausa, {haw} : Hawaiian, {he} : Hebrew, {hz} : Herero, {hil} : Hiligaynon, {him} : Himachali, {hi} : Hindi, {ho} : Hiri Motu, {hit} : Hittite, {hmn} : Hmong, {hu} : Hungarian, -{hup} : Hupa, {iba} : Iban, {is} : Icelandic, {ibo} : Igbo, {ijo} : Ijo, -{ilo} : Iloko, [{inc} : Indic (Other)], [{ine} : Indo-European (Other)], -{id} : Indonesian, {ia} : Interlingua (International Auxiliary Language -Association), {ie} : Interlingue, {iu} : Inuktitut, {ik} : Inupiaq, [{ira} -: Iranian (Other)], {ga} : Irish, {mga} : Middle Irish (900-1200), {sga} : -Old Irish (to 900), [{iro} : Iroquoian languages], {it} : Italian, {ja} : -Japanese, {jw} : Javanese, {jrb} : Judeo-Arabic, {jpr} : Judeo-Persian, -{kab} : Kabyle, {kac} : Kachin, {kl} : Kalaallisut, {kam} : Kamba, {kn} : -Kannada, {kau} : Kanuri, {kaa} : Kara-Kalpak, {kar} : Karen, {ks} : -Kashmiri, {kaw} : Kawi, {kk} : Kazakh, {kha} : Khasi, {km} : Khmer, [{khi} -: Khoisan (Other)], {kho} : Khotanese, {ki} : Kikuyu, {kmb} : Kimbundu, -{rw} : Kinyarwanda, {ky} : Kirghiz, {i-klingon} : Klingon, {kv} : Komi, -{kon} : Kongo, {kok} : Konkani, {ko} : Korean, {kos} : Kosraean, {kpe} : -Kpelle, {kro} : Kru, {kj} : Kuanyama, {kum} : Kumyk, {ku} : Kurdish, {kru} -: Kurukh, {kut} : Kutenai, {lad} : Ladino, {lah} : Lahnda, {lam} : Lamba, -{lo} : Lao, {la} : Latin, {lv} : Latvian, {lb} : Letzeburgesch, {lez} : -Lezghian, {ln} : Lingala, {lt} : Lithuanian, {nds} : Low German, {loz} : -Lozi, {lub} : Luba-Katanga, {lua} : Luba-Lulua, {lui} : Luiseno, {lun} : -Lunda, {luo} : Luo (Kenya and Tanzania), {lus} : Lushai, {mk} : Macedonian, -{mad} : Madurese, {mag} : Magahi, {mai} : Maithili, {mak} : Makasar, {mg} : -Malagasy, {ms} : Malay, {ml} : Malayalam, {mt} : Maltese, {mnc} : Manchu, -{mdr} : Mandar, {man} : Mandingo, {mni} : Manipuri, [{mno} : Manobo -languages], {gv} : Manx, {mi} : Maori, {mr} : Marathi, {chm} : Mari, {mh} : -Marshall, {mwr} : Marwari, {mas} : Masai, [{myn} : Mayan languages], {men} -: Mende, {mic} : Micmac, {min} : Minangkabau, {i-mingo} : Mingo, [{mis} : -Miscellaneous languages], {moh} : Mohawk, {mo} : Moldavian, [{mkh} : -Mon-Khmer (Other)], {lol} : Mongo, {mn} : Mongolian, {mos} : Mossi, [{mul} -: Multiple languages], [{mun} : Munda languages], {nah} : Nahuatl, {na} : -Nauru, {nv} : Navajo, {nd} : North Ndebele, {nr} : South Ndebele, {ng} : -Ndonga, {ne} : Nepali, {new} : Newari, {nia} : Nias, [{nic} : +{hup} : Hupa, {iba} : Iban, {is} : Icelandic, {io} : Ido, {ig} : Igbo, +{ijo} : Ijo, {ilo} : Iloko, [{inc} : Indic (Other)], [{ine} : Indo-European +(Other)], {id} : Indonesian, {inh} : Ingush, {ia} : Interlingua +(International Auxiliary Language Association), {ie} : Interlingue, {iu} : +Inuktitut, {ik} : Inupiaq, [{ira} : Iranian (Other)], {ga} : Irish, {mga} : +Middle Irish (900-1200), {sga} : Old Irish (to 900), [{iro} : Iroquoian +languages], {it} : Italian, {ja} : Japanese, {jv} : Javanese, {jrb} : +Judeo-Arabic, {jpr} : Judeo-Persian, {kbd} : Kabardian, {kab} : Kabyle, +{kac} : Kachin, {kl} : Kalaallisut, {xal} : Kalmyk, {kam} : Kamba, {kn} : +Kannada, {kr} : Kanuri, {krc} : Karachay-Balkar, {kaa} : Kara-Kalpak, {kar} +: Karen, {ks} : Kashmiri, {csb} : Kashubian, {kaw} : Kawi, {kk} : Kazakh, +{kha} : Khasi, {km} : Khmer, [{khi} : Khoisan (Other)], {kho} : Khotanese, +{ki} : Kikuyu, {kmb} : Kimbundu, {rw} : Kinyarwanda, {ky} : Kirghiz, +{i-klingon} : Klingon, {kv} : Komi, {kg} : Kongo, {kok} : Konkani, {ko} : +Korean, {kos} : Kosraean, {kpe} : Kpelle, {kro} : Kru, {kj} : Kuanyama, +{kum} : Kumyk, {ku} : Kurdish, {kru} : Kurukh, {kut} : Kutenai, {lad} : +Ladino, {lah} : Lahnda, {lam} : Lamba, {lo} : Lao, {la} : Latin, {lv} : +Latvian, {lb} : Letzeburgesch, {lez} : Lezghian, {li} : Limburgish, {ln} : +Lingala, {lt} : Lithuanian, {nds} : Low German, {art-lojban} : Lojban +(Artificial), {loz} : Lozi, {lu} : Luba-Katanga, {lua} : Luba-Lulua, {lui} +: Luiseno, {lun} : Lunda, {luo} : Luo (Kenya and Tanzania), {lus} : Lushai, +{mk} : Macedonian, {mad} : Madurese, {mag} : Magahi, {mai} : Maithili, +{mak} : Makasar, {mg} : Malagasy, {ms} : Malay, {ml} : Malayalam, {mt} : +Maltese, {mnc} : Manchu, {mdr} : Mandar, {man} : Mandingo, {mni} : +Manipuri, [{mno} : Manobo languages], {gv} : Manx, {mi} : Maori, {mr} : +Marathi, {chm} : Mari, {mh} : Marshall, {mwr} : Marwari, {mas} : Masai, +[{myn} : Mayan languages], {men} : Mende, {mic} : Micmac, {min} : +Minangkabau, {i-mingo} : Mingo, [{mis} : Miscellaneous languages], {moh} : +Mohawk, {mdf} : Moksha, {mo} : Moldavian, [{mkh} : Mon-Khmer (Other)], +{lol} : Mongo, {mn} : Mongolian, {mos} : Mossi, [{mul} : Multiple +languages], [{mun} : Munda languages], {nah} : Nahuatl, {nap} : Neapolitan, +{na} : Nauru, {nv} : Navajo, {nd} : North Ndebele, {nr} : South Ndebele, +{ng} : Ndonga, {ne} : Nepali, {new} : Newari, {nia} : Nias, [{nic} : Niger-Kordofanian (Other)], [{ssa} : Nilo-Saharan (Other)], {niu} : Niuean, -{non} : Old Norse, [{nai} : North American Indian], {se} : Northern Sami, -{no} : Norwegian, {nb} : Norwegian Bokmal, {nn} : Norwegian Nynorsk, [{nub} -: Nubian languages], {nym} : Nyamwezi, {nyn} : Nyankole, {nyo} : Nyoro, -{nzi} : Nzima, {oc} : Occitan (post 1500), {oji} : Ojibwa, {or} : Oriya, -{om} : Oromo, {osa} : Osage, {os} : Ossetian; Ossetic, [{oto} : Otomian +{nog} : Nogai, {non} : Old Norse, [{nai} : North American Indian], {no} : +Norwegian, {nb} : Norwegian Bokmal, {nn} : Norwegian Nynorsk, [{nub} : +Nubian languages], {nym} : Nyamwezi, {nyn} : Nyankole, {nyo} : Nyoro, {nzi} +: Nzima, {oc} : Occitan (post 1500), {oj} : Ojibwa, {or} : Oriya, {om} : +Oromo, {osa} : Osage, {os} : Ossetian; Ossetic, [{oto} : Otomian languages], {pal} : Pahlavi, {i-pwn} : Paiwan, {pau} : Palauan, {pi} : Pali, {pam} : Pampanga, {pag} : Pangasinan, {pa} : Panjabi, {pap} : Papiamento, [{paa} : Papuan (Other)], {fa} : Persian, {peo} : Old Persian @@ -14104,34 +14950,37 @@ Papiamento, [{paa} : Papuan (Other)], {fa} : Persian, {peo} : Old Persian Raeto-Romance, {raj} : Rajasthani, {rap} : Rapanui, {rar} : Rarotongan, [{qaa - qtz} : Reserved for local use.], [{roa} : Romance (Other)], {ro} : Romanian, {rom} : Romany, {rn} : Rundi, {ru} : Russian, [{sal} : Salishan -languages], {sam} : Samaritan Aramaic, [{smi} : Sami languages (Other)], -{sm} : Samoan, {sad} : Sandawe, {sg} : Sango, {sa} : Sanskrit, {sat} : -Santali, {sc} : Sardinian, {sas} : Sasak, {sco} : Scots, {sel} : Selkup, -[{sem} : Semitic (Other)], {sr} : Serbian, {srr} : Serer, {shn} : Shan, -{sn} : Shona, {sid} : Sidamo, {sgn-...} : Sign Languages, {bla} : Siksika, -{sd} : Sindhi, {si} : Sinhalese, [{sit} : Sino-Tibetan (Other)], [{sio} : -Siouan languages], {den} : Slave (Athapascan), [{sla} : Slavic (Other)], -{sk} : Slovak, {sl} : Slovenian, {sog} : Sogdian, {so} : Somali, {son} : -Songhai, {snk} : Soninke, {wen} : Sorbian languages, {nso} : Northern -Sotho, {st} : Southern Sotho, [{sai} : South American Indian (Other)], {es} -: Spanish, {suk} : Sukuma, {sux} : Sumerian, {su} : Sundanese, {sus} : -Susu, {sw} : Swahili, {ss} : Swati, {sv} : Swedish, {syr} : Syriac, {tl} : -Tagalog, {ty} : Tahitian, [{tai} : Tai (Other)], {tg} : Tajik, {tmh} : -Tamashek, {ta} : Tamil, {i-tao} : Tao, {tt} : Tatar, {i-tay} : Tayal, {te} -: Telugu, {ter} : Tereno, {tet} : Tetum, {th} : Thai, {bo} : Tibetan, {tig} -: Tigre, {ti} : Tigrinya, {tem} : Timne, {tiv} : Tiv, {tli} : Tlingit, -{tpi} : Tok Pisin, {tkl} : Tokelau, {tog} : Tonga (Nyasa), {to} : Tonga -(Tonga Islands), {tsi} : Tsimshian, {ts} : Tsonga, {i-tsu} : Tsou, {tn} : -Tswana, {tum} : Tumbuka, {tr} : Turkish, {ota} : Ottoman Turkish -(1500-1928), {tk} : Turkmen, {tvl} : Tuvalu, {tyv} : Tuvinian, {tw} : Twi, -{uga} : Ugaritic, {ug} : Uighur, {uk} : Ukrainian, {umb} : Umbundu, {und} : -Undetermined, {ur} : Urdu, {uz} : Uzbek, {vai} : Vai, {ven} : Venda, {vi} : -Vietnamese, {vo} : Volapuk, {vot} : Votic, [{wak} : Wakashan languages], -{wal} : Walamo, {war} : Waray, {was} : Washo, {cy} : Welsh, {wo} : Wolof, -{x-...} : Unregistered (Semi-Private Use), {xh} : Xhosa, {sah} : Yakut, -{yao} : Yao, {yap} : Yapese, {yi} : Yiddish, {yo} : Yoruba, [{ypk} : Yupik -languages], {znd} : Zande, [{zap} : Zapotec], {zen} : Zenaga, {za} : -Zhuang, {zu} : Zulu, {zun} : Zuni +languages], {sam} : Samaritan Aramaic, {se} : Northern Sami, {sma} : +Southern Sami, {smn} : Inari Sami, {smj} : Lule Sami, {sms} : Skolt Sami, +[{smi} : Sami languages (Other)], {sm} : Samoan, {sad} : Sandawe, {sg} : +Sango, {sa} : Sanskrit, {sat} : Santali, {sc} : Sardinian, {sas} : Sasak, +{sco} : Scots, {sel} : Selkup, [{sem} : Semitic (Other)], {sr} : Serbian, +{srr} : Serer, {shn} : Shan, {sn} : Shona, {sid} : Sidamo, {sgn-...} : Sign +Languages, {bla} : Siksika, {sd} : Sindhi, {si} : Sinhalese, [{sit} : +Sino-Tibetan (Other)], [{sio} : Siouan languages], {den} : Slave +(Athapascan), [{sla} : Slavic (Other)], {sk} : Slovak, {sl} : Slovenian, +{sog} : Sogdian, {so} : Somali, {son} : Songhai, {snk} : Soninke, {wen} : +Sorbian languages, {nso} : Northern Sotho, {st} : Southern Sotho, [{sai} : +South American Indian (Other)], {es} : Spanish, {suk} : Sukuma, {sux} : +Sumerian, {su} : Sundanese, {sus} : Susu, {sw} : Swahili, {ss} : Swati, +{sv} : Swedish, {syr} : Syriac, {tl} : Tagalog, {ty} : Tahitian, [{tai} : +Tai (Other)], {tg} : Tajik, {tmh} : Tamashek, {ta} : Tamil, {i-tao} : Tao, +{tt} : Tatar, {i-tay} : Tayal, {te} : Telugu, {ter} : Tereno, {tet} : +Tetum, {th} : Thai, {bo} : Tibetan, {tig} : Tigre, {ti} : Tigrinya, {tem} : +Timne, {tiv} : Tiv, {tli} : Tlingit, {tpi} : Tok Pisin, {tkl} : Tokelau, +{tog} : Tonga (Nyasa), {to} : Tonga (Tonga Islands), {tsi} : Tsimshian, +{ts} : Tsonga, {i-tsu} : Tsou, {tn} : Tswana, {tum} : Tumbuka, [{tup} : +Tupi languages], {tr} : Turkish, {ota} : Ottoman Turkish (1500-1928), {crh} +: Crimean Turkish, {tk} : Turkmen, {tvl} : Tuvalu, {tyv} : Tuvinian, {tw} : +Twi, {udm} : Udmurt, {uga} : Ugaritic, {ug} : Uighur, {uk} : Ukrainian, +{umb} : Umbundu, {und} : Undetermined, {ur} : Urdu, {uz} : Uzbek, {vai} : +Vai, {ve} : Venda, {vi} : Vietnamese, {vo} : Volapuk, {vot} : Votic, [{wak} +: Wakashan languages], {wa} : Walloon, {wal} : Walamo, {war} : Waray, {was} +: Washo, {cy} : Welsh, {wo} : Wolof, {x-...} : Unregistered (Semi-Private +Use), {xh} : Xhosa, {sah} : Yakut, {yao} : Yao, {yap} : Yapese, {ii} : +Sichuan Yi, {yi} : Yiddish, {yo} : Yoruba, [{ypk} : Yupik languages], {znd} +: Zande, [{zap} : Zapotec], {zen} : Zenaga, {za} : Zhuang, {zu} : Zulu, +{zun} : Zuni =item SEE ALSO @@ -14171,6 +15020,8 @@ Zhuang, {zu} : Zulu, {zun} : Zuni =item DESCRIPTION +=item DEPRECATED + =back =head2 IO::Dir - supply object methods for directory handles @@ -14206,7 +15057,7 @@ new ( FILENAME [,MODE [,PERMS]] ), new_tmpfile =item METHODS -open( FILENAME [,MODE [,PERMS]] ) +open( FILENAME [,MODE [,PERMS]] ), open( FILENAME, IOLAYERS ) =item SEE ALSO @@ -14322,7 +15173,7 @@ new ( [ HANDLES ] ) add ( HANDLES ), remove ( HANDLES ), exists ( HANDLE ), handles, can_read ( [ TIMEOUT ] ), can_write ( [ TIMEOUT ] ), has_exception ( [ TIMEOUT ] ), -count (), bits(), select ( READ, WRITE, ERROR [, TIMEOUT ] ) +count (), bits(), select ( READ, WRITE, EXCEPTION [, TIMEOUT ] ) =item EXAMPLE @@ -14444,7 +15295,7 @@ new ( FILENAME [,MODE [,PERMS]] ), new_tmpfile =item METHODS -open( FILENAME [,MODE [,PERMS]] ) +open( FILENAME [,MODE [,PERMS]] ), open( FILENAME, IOLAYERS ) =item SEE ALSO @@ -14563,7 +15414,7 @@ new ( [ HANDLES ] ) add ( HANDLES ), remove ( HANDLES ), exists ( HANDLE ), handles, can_read ( [ TIMEOUT ] ), can_write ( [ TIMEOUT ] ), has_exception ( [ TIMEOUT ] ), -count (), bits(), select ( READ, WRITE, ERROR [, TIMEOUT ] ) +count (), bits(), select ( READ, WRITE, EXCEPTION [, TIMEOUT ] ) =item EXAMPLE @@ -14838,8 +15689,9 @@ general-utility scalar subroutines =item DESCRIPTION -blessed EXPR, dualvar NUM, STRING, isweak EXPR, openhandle FH, reftype -EXPR, tainted EXPR, weaken REF +blessed EXPR, dualvar NUM, STRING, isvstring EXPR, isweak EXPR, +looks_like_number EXPR, openhandle FH, refaddr EXPR, reftype EXPR, +set_prototype CODEREF, PROTOTYPE, tainted EXPR, weaken REF =item KNOWN BUGS @@ -14909,7 +15761,7 @@ C, C Locale::Language, Locale::Script, Locale::Currency, Locale::SubCountry, ISO 3166-1, http://www.iso.org/iso/en/prods-services/iso3166ma/index.html, http://www.egt.ie/standards/iso3166/iso3166-1-en.html, -http://www.cia.gov/cia/publications/factbook/docs/app-f.html +http://www.cia.gov/cia/publications/factbook/docs/app-d-1.html =item AUTHOR @@ -14983,7 +15835,7 @@ http://lcweb.loc.gov/standards/iso639-2/langhome.html =back -=head2 Locale::Maketext -- framework for localization +=head2 Locale::Maketext - framework for localization =over 4 @@ -15120,7 +15972,7 @@ http://www.evertype.com/standards/iso15924/ =item DESCRIPTION -encode_base64($str, [$eol]), decode_base64($str) +encode_base64($str), encode_base64($str, $eol);, decode_base64($str) =item DIAGNOSTICS @@ -15141,7 +15993,7 @@ of quoted-printable strings =item DESCRIPTION -encode_qp($str), decode_qp($str); +encode_qp($str), encode_qp($str, $eol), decode_qp($str); =item COPYRIGHT @@ -15156,7 +16008,7 @@ strings =item DESCRIPTION -encode_qp($str), decode_qp($str); +encode_qp($str), encode_qp($str, $eol), decode_qp($str); =item COPYRIGHT @@ -15203,10 +16055,12 @@ ffround ( +$scale ), ffround ( -$scale ), ffround ( 0 ), fround ( +$scale =item BUGS -=item CAVEAT +=item CAVEATS stringify, bstr(), bdiv, Modifying and =, bpow +=item SEE ALSO + =item LICENSE =item AUTHORS @@ -15231,6 +16085,8 @@ Canonical notation, Input, Output =item accuracy +=item precision + =item brsft =item new @@ -15397,7 +16253,8 @@ bsqrt(), div(), blog() =item BUGS -Out of Memory!, Fails to load Calc on Perl prior 5.6.0 +broot() does not work, Out of Memory!, Fails to load Calc on Perl prior +5.6.0 =item CAVEATS @@ -15421,7 +16278,9 @@ types, bsqrt(), brsft() =item DESCRIPTION -=item EXPORT +=item STORAGE + +=item METHODS =item WRAP YOUR OWN @@ -15437,7 +16296,28 @@ the same terms as Perl itself. =back -=head2 Math::BigRat - arbitrarily big rationals +=head2 Math::BigInt::Scalar - Pure Perl module to test Math::BigInt with +scalars + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item LICENSE + +This program is free software; you may redistribute it and/or modify it +under +the same terms as Perl itself. + +=item AUTHOR + +=item SEE ALSO + +=back + +=head2 Math::BigRat - arbitrarily big rationales =over 4 @@ -15461,22 +16341,49 @@ the same terms as Perl itself. =item denominator() - $d = $x->denominator(); + $d = $x->denominator(); + +=item parts() + +=item as_number() + +=item bfac() + +=item blog() + +=item bround()/round()/bfround() + +=item bmod() + +=item is_one() + +=item is_zero() + +=item is_positive() + +=item is_negative() + +=item is_int() + +=item is_odd() -=item parts() +=item is_even() -=item as_number() +=item bceil() -=item bfac() +=item bfloor() -=item blog() + $x->bfloor(); -=item bround()/round()/bfround() +=item config =back =item BUGS +inf handling (partial), NaN handling (partial), rounding (not implemented +except for bceil/bfloor), $x ** $y where $y is not an integer + =item LICENSE =item SEE ALSO @@ -15758,7 +16665,7 @@ dataend () debug_print ( DIR, TEXT ), debug_text ( TEXT ), command ( CMD [, ARGS, ... ]), unsupported (), response (), parse_response ( TEXT ), getline (), -ungetline ( TEXT ), read_until_dot (), tied_fh () +ungetline ( TEXT ), rawdatasend ( DATA ), read_until_dot (), tied_fh () =item EXPORTS @@ -15825,15 +16732,16 @@ login ([LOGIN [,PASSWORD [, ACCOUNT] ] ]), authorize ( [AUTH [, RESP]]), site (ARGS), type (TYPE [, ARGS]), ascii ([ARGS]) binary([ARGS]) ebcdic([ARGS]) byte([ARGS]), rename ( OLDNAME, NEWNAME ), delete ( FILENAME ), cwd ( [ DIR ] ), cdup (), pwd (), restart ( WHERE ), rmdir ( DIR ), -mkdir ( DIR [, RECURSE ]), ls ( [ DIR ] ), dir ( [ DIR ] ), get ( -REMOTE_FILE [, LOCAL_FILE [, WHERE]] ), put ( LOCAL_FILE [, REMOTE_FILE ] -), put_unique ( LOCAL_FILE [, REMOTE_FILE ] ), append ( LOCAL_FILE [, -REMOTE_FILE ] ), unique_name (), mdtm ( FILE ), size ( FILE ), supported ( -CMD ), hash ( [FILEHANDLE_GLOB_REF],[ BYTES_PER_HASH_MARK] ), nlst ( [ DIR -] ), list ( [ DIR ] ), retr ( FILE ), stor ( FILE ), stou ( FILE ), appe ( -FILE ), port ( [ PORT ] ), pasv (), pasv_xfer ( SRC_FILE, DEST_SERVER [, -DEST_FILE ] ), pasv_xfer_unique ( SRC_FILE, DEST_SERVER [, DEST_FILE ] ), -pasv_wait ( NON_PASV_SERVER ), abort (), quit () +mkdir ( DIR [, RECURSE ]), ls ( [ DIR ] ), alloc ( SIZE [, RECORD_SIZE] ), +dir ( [ DIR ] ), get ( REMOTE_FILE [, LOCAL_FILE [, WHERE]] ), put ( +LOCAL_FILE [, REMOTE_FILE ] ), put_unique ( LOCAL_FILE [, REMOTE_FILE ] ), +append ( LOCAL_FILE [, REMOTE_FILE ] ), unique_name (), mdtm ( FILE ), size +( FILE ), supported ( CMD ), hash ( [FILEHANDLE_GLOB_REF],[ +BYTES_PER_HASH_MARK] ), nlst ( [ DIR ] ), list ( [ DIR ] ), retr ( FILE ), +stor ( FILE ), stou ( FILE ), appe ( FILE ), port ( [ PORT ] ), pasv (), +pasv_xfer ( SRC_FILE, DEST_SERVER [, DEST_FILE ] ), pasv_xfer_unique ( +SRC_FILE, DEST_SERVER [, DEST_FILE ] ), pasv_wait ( NON_PASV_SERVER ), +abort (), quit () =over 4 @@ -15850,7 +16758,7 @@ bytes_read (), abort (), close () =item UNIMPLEMENTED -B, B, B, B, B, B, B, B +B, B, B, B, B, B, B =item REPORTING BUGS @@ -15924,8 +16832,6 @@ MESSAGE-SPEC, PATTERN, Examples, C<[^]-]>, C<*bdc>, C<[0-9a-zA-Z]>, C =item DESCRIPTION -=item EXAMPLES - =item CONSTRUCTOR new ( [ HOST, ] [ OPTIONS ] ) @@ -15959,17 +16865,21 @@ MSGNUM ] ), delete ( MSGNUM ), reset (), quit () =item Functions -Net::Ping->new([$proto [, $def_timeout [, $bytes]]]);, $p->source_verify( { -0 | 1 } );, $p->hires( { 0 | 1 } );, $p->bind($local_addr);, $p->ping($host -[, $timeout]);, $p->open($host);, $p->close();, pingecho($host [, -$timeout]); +Net::Ping->new([$proto [, $def_timeout [, $bytes [, $device [, $tos +]]]]]);, $p->ping($host [, $timeout]);, $p->source_verify( { 0 | 1 } );, +$p->service_check( { 0 | 1 } );, $p->tcp_service_check( { 0 | 1 } );, +$p->hires( { 0 | 1 } );, $p->bind($local_addr);, $p->open($host);, $p->ack( +[ $host ] );, $p->nack( $failed_ack_host );, $p->close();, pingecho($host +[, $timeout]); =back -=item WARNING - =item NOTES +=item INSTALL + +=item BUGS + =item AUTHORS =item COPYRIGHT @@ -16376,17 +17286,17 @@ cuserid, difftime, div, dup, dup2, errno, execl, execle, execlp, execv, execve, execvp, exit, exp, fabs, fclose, fcntl, fdopen, feof, ferror, fflush, fgetc, fgetpos, fgets, fileno, floor, fmod, fopen, fork, fpathconf, fprintf, fputc, fputs, fread, free, freopen, frexp, fscanf, fseek, fsetpos, -fstat, ftell, fwrite, getc, getchar, getcwd, getegid, getenv, geteuid, -getgid, getgrgid, getgrnam, getgroups, getlogin, getpgrp, getpid, getppid, -getpwnam, getpwuid, gets, getuid, gmtime, isalnum, isalpha, isatty, -iscntrl, isdigit, isgraph, islower, isprint, ispunct, isspace, isupper, -isxdigit, kill, labs, ldexp, ldiv, link, localeconv, localtime, log, log10, -longjmp, lseek, malloc, mblen, mbstowcs, mbtowc, memchr, memcmp, memcpy, -memmove, memset, mkdir, mkfifo, mktime, modf, nice, offsetof, open, -opendir, pathconf, pause, perror, pipe, pow, printf, putc, putchar, puts, -qsort, raise, rand, read, readdir, realloc, remove, rename, rewind, -rewinddir, rmdir, scanf, setgid, setjmp, setlocale, setpgid, setsid, -setuid, sigaction, siglongjmp, sigpending, sigprocmask, sigsetjmp, +fstat, fsync, ftell, fwrite, getc, getchar, getcwd, getegid, getenv, +geteuid, getgid, getgrgid, getgrnam, getgroups, getlogin, getpgrp, getpid, +getppid, getpwnam, getpwuid, gets, getuid, gmtime, isalnum, isalpha, +isatty, iscntrl, isdigit, isgraph, islower, isprint, ispunct, isspace, +isupper, isxdigit, kill, labs, ldexp, ldiv, link, localeconv, localtime, +log, log10, longjmp, lseek, malloc, mblen, mbstowcs, mbtowc, memchr, +memcmp, memcpy, memmove, memset, mkdir, mkfifo, mktime, modf, nice, +offsetof, open, opendir, pathconf, pause, perror, pipe, pow, printf, putc, +putchar, puts, qsort, raise, rand, read, readdir, realloc, remove, rename, +rewind, rewinddir, rmdir, scanf, setgid, setjmp, setlocale, setpgid, +setsid, setuid, sigaction, siglongjmp, sigpending, sigprocmask, sigsetjmp, sigsuspend, sin, sinh, sleep, sprintf, sqrt, srand, sscanf, stat, strcat, strchr, strcmp, strcoll, strcpy, strcspn, strerror, strftime, strlen, strncat, strncmp, strncpy, strpbrk, strrchr, strspn, strstr, strtod, @@ -16402,7 +17312,7 @@ wctomb, write =item POSIX::SigAction -new +new, handler, mask, flags, safe =item POSIX::SigSet @@ -16498,10 +17408,16 @@ unix, stdio, perlio, crlf, utf8, bytes, raw, pop =over 4 +=item Custom Layers + +:encoding, :via + =item Alternatives to raw =item Defaults and how to override them +=item Querying the layers of filehandle + =back =item AUTHOR @@ -16616,7 +17532,8 @@ whitespace in paragraph, file does not start with =head, previous =item has no contents, preceding non-item paragraph(s), =item type mismatch (I vs. I), I unescaped CE> in paragraph, Unknown entity, No items in =over, No argument for =item, empty section in previous paragraph, -Verbatim paragraph in NAME section +Verbatim paragraph in NAME section, =headI without preceding higher +level =item Hyperlinks @@ -16640,6 +17557,8 @@ C<$checker-Epoderror( @args )>, C<$checker-Epoderror( {%opts}, C<$checker-Enum_errors()> +C<$checker-Enum_warnings()> + C<$checker-Ename()> C<$checker-Enode()> @@ -17110,7 +18029,7 @@ escape EE%sE, %s:%d: Unknown formatting code %s, %s:%d: Unmatched =back -=head2 Pod::ParseLink -- Parse an LEE formatting code in POD text +=head2 Pod::ParseLink - Parse an LEE formatting code in POD text =over 4 @@ -17118,6 +18037,8 @@ escape EE%sE, %s:%d: Unknown formatting code %s, %s:%d: Unmatched =item DESCRIPTION +=item SEE ALSO + =item AUTHOR =item COPYRIGHT AND LICENSE @@ -17467,6 +18388,163 @@ I|I =back +=head2 Pod::Perldoc::ToChecker - let Perldoc check Pod for errors + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item SEE ALSO + +=item COPYRIGHT AND DISCLAIMERS + +=item AUTHOR + +=back + +=head2 Pod::Perldoc::ToMan - let Perldoc render Pod as man pages + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item CAVEAT + +=item SEE ALSO + +=item COPYRIGHT AND DISCLAIMERS + +=item AUTHOR + +=back + +=head2 Pod::Perldoc::ToNroff - let Perldoc convert Pod to nroff + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item CAVEAT + +=item SEE ALSO + +=item COPYRIGHT AND DISCLAIMERS + +=item AUTHOR + +=back + +=head2 Pod::Perldoc::ToPod - let Perldoc render Pod as ... Pod! + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item SEE ALSO + +=item COPYRIGHT AND DISCLAIMERS + +=item AUTHOR + +=back + +=head2 Pod::Perldoc::ToRtf - let Perldoc render Pod as RTF + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item SEE ALSO + +=item COPYRIGHT AND DISCLAIMERS + +=item AUTHOR + +=back + +=head2 Pod::Perldoc::ToText - let Perldoc render Pod as plaintext + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item CAVEAT + +=item SEE ALSO + +=item COPYRIGHT AND DISCLAIMERS + +=item AUTHOR + +=back + +=head2 Pod::Perldoc::ToTk - let Perldoc use Tk::Pod to render Pod + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item SEE ALSO + +=item AUTHOR + +=back + +=head2 Pod::Perldoc::ToXml - let Perldoc render Pod as XML + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item SEE ALSO + +=item COPYRIGHT AND DISCLAIMERS + +=item AUTHOR + +=back + +=head2 Pod::PlainText - Convert POD data to formatted ASCII text + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +alt, indent, loose, sentence, width + +=item DIAGNOSTICS + +Bizarre space in item, Can't open %s for reading: %s, Unknown escape: %s, +Unknown sequence: %s, Unmatched =back + +=item RESTRICTIONS + +=item NOTES + +=item SEE ALSO + +=item AUTHOR + +=back + =head2 Pod::Plainer - Perl extension for converting Pod to old style Pod. =over 4 @@ -17602,7 +18680,7 @@ B<-output>, B<-sections>, B<-ranges> =item DESCRIPTION -alt, code, indent, loose, quotes, sentence, width +alt, code, indent, loose, margin, quotes, sentence, width =item DIAGNOSTICS @@ -17660,8 +18738,8 @@ text =back -=head2 Pod::Text::Termcap, Pod::Text::Color - Convert POD data to ASCII -text with format escapes +=head2 Pod::Text::Termcap - Convert POD data to ASCII text with format +escapes =over 4 @@ -17709,83 +18787,6 @@ C<-pathlist> =back -=head2 Pod::t::basic, basic.pod - Test of various basic POD features in -translators. - -=over 4 - -=item HEADINGS - -=item This C a "level 1" heading - -=over 4 - -=item ``Level'' "2 I - -=back - -=item This C a "level 1" heading - -=over 4 - -=item ``Level'' 2 I - -=back - -=item LINKS - -=item OVER AND ITEMS - -This is a test, a, b, a, b, c, d, "foo", B, C, Some longer item -text - -=item FORMATTING CODES - -E, E, E, E, E, E - -=item VERBATIM - -=item CONCLUSION - -=back - -=head2 Pod::t::htmlescp, Escape Sequences Test - -=over 4 - -=item DESCRIPTION - -=back - -=head2 Pod::t::htmlview, Test HTML Rendering - -=over 4 - -=item SYNOPSIS - -=item DESCRIPTION - -=item METHODS =E OTHER STUFF - -=over 4 - -=item new() - -foo, bar, baz, C Cat, Sat S the>, MatE!E, 1 Cat, 2 -Sat, 3 Mat - -=item old() - -=back - -=item TESTING FOR AND BEGIN - -=item TESTING URLs hyperlinking - -=item SEE ALSO - -=back - =head2 SDBM_File - Tied access to sdbm files =over 4 @@ -17849,8 +18850,9 @@ Memory, CPU, Snooping, Signals, State Changes =item DESCRIPTION -blessed EXPR, dualvar NUM, STRING, isweak EXPR, openhandle FH, reftype -EXPR, tainted EXPR, weaken REF +blessed EXPR, dualvar NUM, STRING, isvstring EXPR, isweak EXPR, +looks_like_number EXPR, openhandle FH, refaddr EXPR, reftype EXPR, +set_prototype CODEREF, PROTOTYPE, tainted EXPR, weaken REF =item KNOWN BUGS @@ -17959,6 +18961,8 @@ SOCKADDR_UN, pack_sockaddr_un PATH, unpack_sockaddr_un SOCKADDR_UN =item CANONICAL REPRESENTATION +=item CODE REFERENCES + =item FORWARD COMPATIBILITY utf8 data, restricted hashes, files from future versions of Storable @@ -18133,7 +19137,7 @@ ANSI_COLORS_DISABLED =item AUTHORS -=item LICENSE +=item COPYRIGHT AND LICENSE =back @@ -18193,8 +19197,8 @@ EtabE, ^D, ^U, EdelE, EbsE =back -=head2 Term::ReadLine - Perl interface to various C packages. If -no real package is found, substitutes stubs instead of basic functions. +=head2 Term::ReadLine - Perl interface to various C packages. +If no real package is found, substitutes stubs instead of basic functions. =over 4 @@ -18204,8 +19208,8 @@ no real package is found, substitutes stubs instead of basic functions. =item Minimal set of supported functions -C, C, C, C, C, $C, -C, C, Attribs, C +C, C, C, C, C, C, C, +C, Attribs, C =item Additional supported functions @@ -18227,11 +19231,14 @@ C, C, C =item DESCRIPTION +=item QUICK START GUIDE + =over 4 =item Functions -B +C, C I>, C [I<1,5,14>]>, +C sub { ... }>, C \&some_sub> =back @@ -18239,7 +19246,9 @@ B B<_to_value> -B +C + +C, I)> =over 4 @@ -18291,6 +19300,8 @@ B B +B + B =over 4 @@ -18353,7 +19364,9 @@ B B -B
I, B +B
+ +B B @@ -18437,7 +19450,7 @@ C, C, C, C, C, C, C, -C, C +C, C, C =item EXAMPLE @@ -18445,6 +19458,8 @@ C, C =item AUTHORS +=item LICENSE + =item TODO =item BUGS @@ -18777,6 +19792,10 @@ L =item C +=item C + +[0], [1], [2] + =item C C $listref>, C $listref>, C $str>, @@ -19021,6 +20040,8 @@ SHIFT this, UNSHIFT this, LIST, SPLICE this, offset, length, LIST =item C, C, C, and C +=item C + =back =item Tying to an already-opened filehandle @@ -19033,6 +20054,8 @@ SHIFT this, UNSHIFT this, LIST, SPLICE this, offset, length, LIST =back +=item CONCURRENT ACCESS TO FILES + =item CAVEATS =item SUBCLASSING @@ -19174,13 +20197,21 @@ getitimer ( $which ) =item C API +=item DIAGNOSTICS + +=over 4 + +=item negative time not invented yet + +=item internal error: useconds < 0 (unsigned ... signed ...) + +=back + =item CAVEATS =item AUTHORS -=item REVISION - -=item COPYRIGHT +=item COPYRIGHT AND LICENSE =back @@ -19196,6 +20227,10 @@ getitimer ( $which ) =item BUGS +=item SUPPORT + +=item AUTHOR + =back =head2 Time::gmtime - by-name interface to Perl's built-in gmtime() @@ -19248,8 +20283,11 @@ function =item DESCRIPTION -$obj->isa( TYPE ), CLASS->isa( TYPE ), isa( VAL, TYPE ), $obj->can( METHOD -), CLASS->can( METHOD ), can( VAL, METHOD ), VERSION ( [ REQUIRE ] ) +C<< $obj->isa( TYPE ) >>, C<< CLASS->isa( TYPE ) >>, C, +C, C<$obj>, C, C, C<< $obj->can( METHOD ) >>, C<< +CLASS->can( METHOD ) >>, C, C + +=item EXPORTS =back @@ -19265,9 +20303,9 @@ $obj->isa( TYPE ), CLASS->isa( TYPE ), isa( VAL, TYPE ), $obj->can( METHOD =item Constructor and Tailoring -alternate, backwards, entry, ignoreName, ignoreChar, level, normalization, -overrideCJK, overrideHangul, preprocess, rearrange, table, undefName, -undefChar, katakana_before_hiragana, upper_before_lower +UCA_Version, alternate, backwards, entry, ignoreName, ignoreChar, level, +normalization, overrideCJK, overrideHangul, preprocess, rearrange, table, +undefName, undefChar, katakana_before_hiragana, upper_before_lower =item Methods for Collation @@ -19277,21 +20315,28 @@ C<$result = $Collator-Ene($a, $b)>, C<$result = $Collator-Elt($a, $b)>, C<$result = $Collator-Ele($a, $b)>, C<$result = $Collator-Egt($a, $b)>, C<$result = $Collator-Ege($a, $b)>, C<$sortKey = $Collator-EgetSortKey($string)>, C<$sortKeyForm = -$Collator-EviewSortKey($string)>, C<$position = -$Collator-Eindex($string, $substring)>, C<($position, $length) = -$Collator-Eindex($string, $substring)> +$Collator-EviewSortKey($string)> + +=item Methods for Searching + +C<$position = $Collator-Eindex($string, $substring[, $position])>, +C<($position, $length) = $Collator-Eindex($string, $substring[, +$position])>, C<$match_ref = $Collator-Ematch($string, $substring)>, +C<($match) = $Collator-Ematch($string, $substring)>, C<@match = +$Collator-Egmatch($string, $substring)>, C<$count = +$Collator-Esubst($string, $substring, $replacement)>, C<$count = +$Collator-Egsubst($string, $substring, $replacement)> =item Other Methods -UCA_Version, Base_Unicode_Version +C<%old_tailoring = $Collator-Echange(%new_tailoring)>, UCA_Version, +Base_Unicode_Version =item EXPORT -=item TODO - =item CAVEAT -=item BUGS +=item Conformance Test =back @@ -19299,10 +20344,11 @@ UCA_Version, Base_Unicode_Version =item SEE ALSO -http://www.unicode.org/unicode/reports/tr10/, -http://www.unicode.org/unicode/reports/tr10/allkeys.txt, -http://www.unicode.org/unicode/reports/tr15/, -http://www.unicode.org/unicode/reports/tr18, L +http://www.unicode.org/reports/tr10/, +http://www.unicode.org/reports/tr10/allkeys.txt, +http://www.unicode.org/reports/tr10/CollationTest.html +http://www.unicode.org/reports/tr10/CollationTest.zip, +http://www.unicode.org/reports/tr15/, L =back @@ -19341,7 +20387,7 @@ C<$compatibility_decomposed = getCompat($codepoint)>, C<$codepoint_composite = getComposite($codepoint_here, $codepoint_next)>, C<$combining_class = getCombinClass($codepoint)>, C<$is_exclusion = isExclusion($codepoint)>, C<$is_singleton = isSingleton($codepoint)>, -C<$is_non_startar_decomposition = isNonStDecomp($codepoint)>, +C<$is_non_starter_decomposition = isNonStDecomp($codepoint)>, C<$may_be_composed_with_prev_char = isComp2nd($codepoint)> =item EXPORT @@ -19501,9 +20547,10 @@ Win32::AbortSystemShutdown(MACHINE), Win32::BuildNumber(), Win32::CopyFile(FROM, TO, OVERWRITE), Win32::DomainName(), Win32::ExpandEnvironmentStrings(STRING), Win32::FormatMessage(ERRORCODE), Win32::FsType(), Win32::FreeLibrary(HANDLE), Win32::GetArchName(), -Win32::GetChipName(), Win32::GetCwd(), Win32::GetFullPathName(FILENAME), -Win32::GetLastError(), Win32::GetLongPathName(PATHNAME), -Win32::GetNextAvailDrive(), Win32::GetOSVersion(), Win32::GetOSName(), +Win32::GetChipName(), Win32::GetCwd(), Win32::GetFolderPath(FOLDER [, +CREATE]), Win32::GetFullPathName(FILENAME), Win32::GetLastError(), +Win32::GetLongPathName(PATHNAME), Win32::GetNextAvailDrive(), +Win32::GetOSVersion(), Win32::GetOSName(), Win32::GetShortPathName(PATHNAME), Win32::GetProcAddress(INSTANCE, PROCNAME), Win32::GetTickCount(), Win32::InitiateSystemShutdown, Win32::IsWinNT(), Win32::IsWin95(), Win32::LoadLibrary(LIBNAME),