X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=pod%2Fperltoc.pod;h=2c00af49ee9c8c415140abb7109af70eb722ab1f;hb=574bacfe464e67c186e160f356e339f5a9faa3e8;hp=9b8654edc1192147fa2e7f71800a87193691e98a;hpb=e42c74e1bbeb8832945ac76bd2905217353ae440;p=p5sagit%2Fp5-mst-13.2.git diff --git a/pod/perltoc.pod b/pod/perltoc.pod index 9b8654e..2c00af4 100644 --- a/pod/perltoc.pod +++ b/pod/perltoc.pod @@ -361,21 +361,22 @@ lock, log EXPR, log, lstat EXPR, lstat, m//, map BLOCK LIST, map EXPR,LIST, mkdir FILENAME,MASK, mkdir FILENAME, msgctl ID,CMD,ARG, msgget KEY,FLAGS, msgrcv ID,VAR,SIZE,TYPE,FLAGS, msgsnd ID,MSG,FLAGS, my EXPR, my EXPR : ATTRIBUTES, next LABEL, next, no Module LIST, oct EXPR, oct, open -FILEHANDLE,MODE,LIST, open FILEHANDLE,EXPR, open FILEHANDLE, opendir -DIRHANDLE,EXPR, ord EXPR, ord, our EXPR, pack TEMPLATE,LIST, package -NAMESPACE, package, pipe READHANDLE,WRITEHANDLE, pop ARRAY, pop, pos -SCALAR, pos, print FILEHANDLE LIST, print LIST, print, printf FILEHANDLE -FORMAT, LIST, printf FORMAT, LIST, prototype FUNCTION, push ARRAY,LIST, -q/STRING/, qq/STRING/, qr/STRING/, qx/STRING/, qw/STRING/, quotemeta EXPR, -quotemeta, rand EXPR, rand, read FILEHANDLE,SCALAR,LENGTH,OFFSET, read -FILEHANDLE,SCALAR,LENGTH, readdir DIRHANDLE, readline EXPR, readlink EXPR, -readlink, readpipe EXPR, recv SOCKET,SCALAR,LENGTH,FLAGS, redo LABEL, redo, -ref EXPR, ref, rename OLDNAME,NEWNAME, require VERSION, require EXPR, -require, reset EXPR, reset, return EXPR, return, reverse LIST, rewinddir -DIRHANDLE, rindex STR,SUBSTR,POSITION, rindex STR,SUBSTR, rmdir FILENAME, -rmdir, s///, scalar EXPR, seek FILEHANDLE,POSITION,WHENCE, seekdir -DIRHANDLE,POS, select FILEHANDLE, select, select RBITS,WBITS,EBITS,TIMEOUT, -semctl ID,SEMNUM,CMD,ARG, semget KEY,NSEMS,FLAGS, semop KEY,OPSTRING, send +FILEHANDLE,EXPR, open FILEHANDLE,MODE,EXPR, open FILEHANDLE,MODE,EXPR,LIST, +open FILEHANDLE, opendir DIRHANDLE,EXPR, ord EXPR, ord, our EXPR, our EXPR +: ATTRIBUTES, pack TEMPLATE,LIST, package NAMESPACE, package, pipe +READHANDLE,WRITEHANDLE, pop ARRAY, pop, pos SCALAR, pos, print FILEHANDLE +LIST, print LIST, print, printf FILEHANDLE FORMAT, LIST, printf FORMAT, +LIST, prototype FUNCTION, push ARRAY,LIST, q/STRING/, qq/STRING/, +qr/STRING/, qx/STRING/, qw/STRING/, quotemeta EXPR, quotemeta, rand EXPR, +rand, read FILEHANDLE,SCALAR,LENGTH,OFFSET, read FILEHANDLE,SCALAR,LENGTH, +readdir DIRHANDLE, readline EXPR, readlink EXPR, readlink, readpipe EXPR, +recv SOCKET,SCALAR,LENGTH,FLAGS, redo LABEL, redo, ref EXPR, ref, rename +OLDNAME,NEWNAME, require VERSION, require EXPR, require, reset EXPR, reset, +return EXPR, return, reverse LIST, rewinddir DIRHANDLE, rindex +STR,SUBSTR,POSITION, rindex STR,SUBSTR, rmdir FILENAME, rmdir, s///, scalar +EXPR, seek FILEHANDLE,POSITION,WHENCE, seekdir DIRHANDLE,POS, select +FILEHANDLE, select, select RBITS,WBITS,EBITS,TIMEOUT, semctl +ID,SEMNUM,CMD,ARG, semget KEY,NSEMS,FLAGS, semop KEY,OPSTRING, send SOCKET,MSG,FLAGS,TO, send SOCKET,MSG,FLAGS, setpgrp PID,PGRP, setpriority WHICH,WHO,PRIORITY, setsockopt SOCKET,LEVEL,OPTNAME,OPTVAL, shift ARRAY, shift, shmctl ID,CMD,ARG, shmget KEY,SIZE,FLAGS, shmread ID,VAR,POS,SIZE, @@ -838,10 +839,10 @@ cmd, H -number, q or ^D, R, |dbcmd, ||dbcmd, command, m expr, man [manpage] C, C, C, C, C, C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, 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 Debugger input/output @@ -880,8 +881,8 @@ listing =item Predefined Names -$ARG, $_, $>, $MATCH, $&, $PREMATCH, $`, $POSTMATCH, $', -$LAST_PAREN_MATCH, $+, @LAST_MATCH_END, @+, $MULTILINE_MATCHING, $*, +$ARG, $_, $a, $b, $>, $MATCH, $&, $PREMATCH, $`, $POSTMATCH, $', +$LAST_PAREN_MATCH, $+, $^N, @LAST_MATCH_END, @+, $MULTILINE_MATCHING, $*, input_line_number HANDLE EXPR, $INPUT_LINE_NUMBER, $NR, $, input_record_separator HANDLE EXPR, $INPUT_RECORD_SEPARATOR, $RS, $/, autoflush HANDLE EXPR, $OUTPUT_AUTOFLUSH, $|, output_field_separator HANDLE @@ -907,8 +908,8 @@ $DEBUGGING, $^D, $SYSTEM_FD_MAX, $^F, $^H, %^H, $INPLACE_EDIT, $^I, $^M, $OSNAME, $^O, $PERLDB, $^P, 0x01, 0x02, 0x04, 0x08, 0x10, 0x20, 0x40, 0x80, 0x100, 0x200, $LAST_REGEXP_CODE_RESULT, $^R, $EXCEPTIONS_BEING_CAUGHT, $^S, $BASETIME, $^T, $PERL_VERSION, $^V, $WARNING, $^W, ${^WARNING_BITS}, -${^WIDE_SYSTEM_CALLS}, $EXECUTABLE_NAME, $^X, $ARGV, @ARGV, @INC, @_, %INC, -%ENV, $ENV{expr}, %SIG, $SIG{expr} +${^WIDE_SYSTEM_CALLS}, $EXECUTABLE_NAME, $^X, $ARGV, @ARGV, @F, @INC, @_, +%INC, %ENV, $ENV{expr}, %SIG, $SIG{expr} =item Error Indicators @@ -1410,7 +1411,7 @@ C<(?(condition)yes-pattern|no-pattern)> =item Method Invocation -=item WARNING +=item Indirect Object Syntax =item Default UNIVERSAL methods @@ -1586,7 +1587,7 @@ Proto, LocalPort, Listen, Reuse =back -=head2 perlfork - Perl's fork() emulation +=head2 perlfork - Perl's fork() emulation (EXPERIMENTAL, subject to change) =over 4 @@ -1869,12 +1870,12 @@ wait, waitpid PID,FLAGS =item CHANGES -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.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 @@ -1917,6 +1918,8 @@ localization) =item The localeconv function +=item I18N::Langinfo + =back =item LOCALE CATEGORIES @@ -1995,6 +1998,10 @@ to enable a few features =item Effects of character semantics +=item Scripts + +=item Blocks + =item Character encodings for input and output =back @@ -2031,11 +2038,13 @@ to enable a few features =item POSIX-BC +=item Unicode and UTF + =back =item SINGLE OCTET TABLES -recipe 0, recipe 1, recipe 2, recipe 3, recipe 4 +recipe 0, recipe 1, recipe 2, recipe 3, recipe 4, recipe 5, recipe 6 =item IDENTIFYING CHARACTER CODE SETS @@ -2075,7 +2084,7 @@ chr(), ord(), pack(), print(), printf(), sort(), sprintf(), unpack() =back -=item TRANFORMATION FORMATS +=item TRANSFORMATION FORMATS =over 4 @@ -2085,7 +2094,7 @@ chr(), ord(), pack(), print(), printf(), sort(), sprintf(), unpack() =item Quoted-Printable encoding and decoding -=item Caesarian cyphers +=item Caesarian ciphers =back @@ -2103,9 +2112,9 @@ chr(), ord(), pack(), print(), printf(), sort(), sprintf(), unpack() IFS access -=item OS/390 +=item OS/390, z/OS -chcp, dataset access, OS/390 iconv, locales +chcp, dataset access, OS/390, z/OS iconv, locales =item VM/ESA? @@ -2119,6 +2128,8 @@ chcp, dataset access, OS/390 iconv, locales =item REFERENCES +=item HISTORY + =item AUTHOR =back @@ -2165,6 +2176,8 @@ chcp, dataset access, OS/390 iconv, locales =item Perl Modules +=item Making your module threadsafe + =back =item SEE ALSO @@ -2185,39 +2198,51 @@ chcp, dataset access, OS/390 iconv, locales attributes, attrs, autouse, base, blib, bytes, charnames, constant, diagnostics, fields, filetest, integer, less, locale, open, ops, overload, -perlio, re, sigtrap, strict, subs, utf8, vars, warnings, warnings::register +re, sigtrap, strict, subs, utf8, vars, warnings, warnings::register =item Standard Modules -AnyDBM_File, AutoLoader, AutoSplit, B, B::Asmdata, B::Assembler, B::Bblock, -B::Bytecode, B::C, B::CC, 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, CPAN, CPAN::FirstTime, CPAN::Nox, -Carp, Class::Struct, Cwd, DB, DB_File, Devel::SelfStubber, DirHandle, -Dumpvalue, Encode, English, Env, Exporter, Exporter::Heavy, -ExtUtils::Command, ExtUtils::Embed, ExtUtils::Install, ExtUtils::Installed, -ExtUtils::Liblist, ExtUtils::MM_Cygwin, ExtUtils::MM_OS2, -ExtUtils::MM_Unix, ExtUtils::MM_VMS, ExtUtils::MM_Win32, -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::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, -I18N::Collate, IO, IPC::Open2, IPC::Open3, Math::BigFloat, Math::BigInt, -Math::Complex, Math::Trig, NDBM_File, Net::Ping, Net::hostent, Net::netent, -Net::protoent, Net::servent, O, ODBM_File, Opcode, Pod::Checker, Pod::Find, -Pod::Html, Pod::InputObjects, Pod::LaTeX, Pod::Man, Pod::ParseUtils, -Pod::Parser, Pod::Plainer, Pod::Select, Pod::Text, Pod::Text::Color, -Pod::Text::Termcap, Pod::Usage, SDBM_File, Safe, Search::Dict, SelectSaver, -SelfLoader, Shell, Socket, Storable, Symbol, Term::ANSIColor, Term::Cap, -Term::Complete, Term::ReadLine, Test, Test::Harness, Text::Abbrev, -Text::ParseWords, Text::Soundex, Text::Wrap, Tie::Array, Tie::Handle, -Tie::Hash, Tie::RefHash, Tie::Scalar, Tie::SubstrHash, Time::Local, -Time::gmtime, Time::localtime, Time::tm, UNIVERSAL, User::grent, -User::pwent +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, Cwd, DB, DB_File, Devel::SelfStubber, Digest, DirHandle, +Dumpvalue, Encode, Encode::EncodeFormat, Encode::Tcl, English, Env, +Exporter, Exporter::Heavy, ExtUtils::Command, ExtUtils::Constant, +ExtUtils::Embed, ExtUtils::Install, ExtUtils::Installed, ExtUtils::Liblist, +ExtUtils::MM_Cygwin, ExtUtils::MM_NW5, ExtUtils::MM_OS2, ExtUtils::MM_Unix, +ExtUtils::MM_VMS, ExtUtils::MM_Win32, 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::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, 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, Math::BigFloat, Math::BigInt, +Math::BigInt::Calc, Math::Complex, Math::Trig, Memoize, +Memoize::AnyDBM_File, Memoize::Expire, Memoize::ExpireFile, +Memoize::ExpireTest, Memoize::NDBM_File, Memoize::SDBM_File, +Memoize::Saves, 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, +Pod::Checker, Pod::Find, Pod::Html, Pod::InputObjects, Pod::LaTeX, +Pod::Man, 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::Harness, Test::More, +Test::Simple, Text::Abbrev, Text::Balanced, Text::ParseWords, +Text::Soundex, Text::Tabs, Text::Wrap, Thread, Thread::Queue, +Thread::Semaphore, Thread::Signal, Thread::Specific, Tie::Array, +Tie::Handle, Tie::Hash, Tie::RefHash, Tie::Scalar, Tie::SubstrHash, +Time::Local, Time::gmtime, Time::localtime, Time::tm, UNIVERSAL, UnicodeCD, +User::grent, User::pwent, Win32 =item Extension Modules @@ -2225,8 +2250,23 @@ User::pwent =item CPAN -Africa, Asia, Australasia, Central America, Europe, North America, South -America +=over 4 + +=item Africa + +=item Asia + +=item Central America + +=item Europe + +=item North America + +=item Oceania + +=item South America + +=back =item Modules: Creation, Use, and Abuse @@ -2234,25 +2274,10 @@ America =item Guidelines for Module Creation -Do similar modules already exist in some form?, Try to design the new -module to be easy to extend and reuse, Some simple style guidelines, Select -what to export, Select a name for the module, Have you got it right?, -README and other Additional Files, A description of the -module/package/extension etc, A copyright notice - see below, Prerequisites -- what else you may need to have, How to build it - possible changes to -Makefile.PL etc, How to install it, Recent changes in this release, -especially incompatibilities, Changes / enhancements you plan to make in -the future, Adding a Copyright Notice, Give the module a -version/issue/release number, How to release and distribute a module, Take -care when changing a released module +Adding a Copyright Notice =item Guidelines for Converting Perl 4 Library Scripts into Modules -There is no requirement to convert anything, Consider the implications, -Make the most of the opportunity, The pl2pm utility will get you started, -Adds the standard Module prologue lines, Converts package specifiers from ' -to ::, Converts die(...) to croak(...), Several other minor changes - =item Guidelines for Reusing Application Code =back @@ -2451,6 +2476,10 @@ References, Tutorials, Task-Oriented, Special Topics =item Is there an IDE or Windows Perl Editor? +Komodo, The Object System, Open Perl IDE, PerlBuilder, visiPerl+, +CodeMagicCD, GNU Emacs, MicroEMACS, XEmacs, Elvis, Vile, Vim, Codewright, +MultiEdit, SlickEdit, Bash, Ksh, Tcsh, Zsh, BBEdit and BBEdit Lite, Alpha + =item Where can I get Perl macros for vi? =item Where can I get perl-mode for emacs? @@ -2622,7 +2651,8 @@ the tag a), b), c), d), e) -=item How can I tell whether a list or array contains a certain element? +=item How can I tell whether a certain element is contained in a list or +array? =item How do I compute the difference of two arrays? How do I compute the intersection of two arrays? @@ -2764,6 +2794,9 @@ filehandles between subroutines? How do I make an array of filehandles? =item I still don't get locking. I just want to increment the number in the file. How can I do this? +=item All I want to do is append a small amount of text to the end of a +file. Do I still have to use locking? + =item How do I randomly update a binary file? =item How do I get a file's timestamp in perl? @@ -3442,7 +3475,7 @@ C, C, C =item The CLEANUP: Keyword -=item The POST_CALL: Keyword +=item The POSTCALL: Keyword =item The BOOT: Keyword @@ -3615,6 +3648,8 @@ save_hptr(HV **hptr)> =item Compile pass 3: peephole optimization +=item Pluggable runops + =back =item Examining internal data structures with the C functions @@ -3778,6 +3813,10 @@ L L, L, L +=item Administration + +L + =item Development L, L, L and L, @@ -3856,55 +3895,67 @@ B AvFILL, av_clear, av_delete, av_exists, av_extend, av_fetch, av_fill, av_len, av_make, av_pop, av_push, av_shift, av_store, av_undef, av_unshift, -bytes_from_utf8, bytes_to_utf8, call_argv, call_method, call_pv, call_sv, -CLASS, Copy, croak, CvSTASH, cv_const_sv, dMARK, dORIGMARK, dSP, dXSARGS, -dXSI32, ENTER, eval_pv, eval_sv, EXTEND, fbm_compile, fbm_instr, FREETMPS, -get_av, get_cv, get_hv, get_sv, GIMME, GIMME_V, GvSV, gv_fetchmeth, -gv_fetchmethod, gv_fetchmethod_autoload, gv_stashpv, gv_stashsv, G_ARRAY, -G_DISCARD, G_EVAL, G_NOARGS, G_SCALAR, G_VOID, HEf_SVKEY, HeHASH, HeKEY, -HeKLEN, HePV, HeSVKEY, HeSVKEY_force, HeSVKEY_set, HeVAL, HvNAME, hv_clear, -hv_delete, hv_delete_ent, hv_exists, hv_exists_ent, hv_fetch, hv_fetch_ent, -hv_iterinit, hv_iterkey, hv_iterkeysv, hv_iternext, hv_iternextsv, -hv_iterval, hv_magic, hv_store, hv_store_ent, hv_undef, isALNUM, isALPHA, -isDIGIT, isLOWER, isSPACE, isUPPER, is_utf8_char, is_utf8_string, items, -ix, LEAVE, load_module, looks_like_number, MARK, mg_clear, mg_copy, -mg_find, mg_free, mg_get, mg_length, mg_magical, mg_set, Move, New, newAV, -Newc, newCONSTSUB, newHV, newRV_inc, newRV_noinc, NEWSV, newSViv, newSVnv, -newSVpv, newSVpvf, newSVpvn, newSVpvn_share, newSVrv, newSVsv, newSVuv, -newXS, newXSproto, Newz, Nullav, Nullch, Nullcv, Nullhv, Nullsv, ORIGMARK, -perl_alloc, perl_construct, perl_destruct, perl_free, perl_parse, perl_run, +ax, bytes_from_utf8, bytes_to_utf8, call_argv, call_method, call_pv, +call_sv, CLASS, Copy, croak, CvSTASH, cv_const_sv, dAX, dITEMS, dMARK, +dORIGMARK, dSP, dXSARGS, dXSI32, ENTER, eval_pv, eval_sv, EXTEND, +fbm_compile, fbm_instr, FREETMPS, getcwd_sv, get_av, get_cv, get_hv, +get_sv, GIMME, GIMME_V, grok_number, grok_numeric_radix, GvSV, +gv_fetchmeth, gv_fetchmethod, gv_fetchmethod_autoload, gv_stashpv, +gv_stashsv, G_ARRAY, G_DISCARD, G_EVAL, G_NOARGS, G_SCALAR, G_VOID, +HEf_SVKEY, HeHASH, HeKEY, HeKLEN, HePV, HeSVKEY, HeSVKEY_force, +HeSVKEY_set, HeVAL, HvNAME, hv_clear, hv_delete, hv_delete_ent, hv_exists, +hv_exists_ent, hv_fetch, hv_fetch_ent, hv_iterinit, hv_iterkey, +hv_iterkeysv, hv_iternext, hv_iternextsv, hv_iterval, hv_magic, hv_store, +hv_store_ent, hv_undef, isALNUM, isALPHA, isDIGIT, isLOWER, isSPACE, +isUPPER, is_utf8_char, is_utf8_string, items, ix, LEAVE, load_module, +looks_like_number, MARK, mg_clear, mg_copy, mg_find, mg_free, mg_get, +mg_length, mg_magical, mg_set, Move, New, newAV, Newc, newCONSTSUB, newHV, +newRV_inc, newRV_noinc, NEWSV, newSV, newSViv, newSVnv, newSVpv, newSVpvf, +newSVpvn, newSVpvn_share, newSVrv, newSVsv, newSVuv, newXS, newXSproto, +Newz, Nullav, Nullch, Nullcv, Nullhv, Nullsv, ORIGMARK, perl_alloc, +perl_clone, perl_construct, perl_destruct, perl_free, perl_parse, perl_run, PL_modglobal, PL_na, PL_sv_no, PL_sv_undef, PL_sv_yes, POPi, POPl, POPn, POPp, POPpbytex, POPpx, POPs, PUSHi, PUSHMARK, PUSHn, PUSHp, PUSHs, PUSHu, PUTBACK, Renew, Renewc, require_pv, RETVAL, Safefree, savepv, savepvn, SAVETMPS, SP, SPAGAIN, ST, strEQ, strGE, strGT, strLE, strLT, strNE, strnEQ, strnNE, StructCopy, SvCUR, SvCUR_set, SvEND, SvGETMAGIC, SvGROW, SvIOK, SvIOKp, SvIOK_notUV, SvIOK_off, SvIOK_on, SvIOK_only, SvIOK_only_UV, -SvIOK_UV, SvIV, SvIVX, SvLEN, SvNIOK, SvNIOKp, SvNIOK_off, SvNOK, SvNOKp, -SvNOK_off, SvNOK_on, SvNOK_only, SvNV, SvNVX, SvOK, SvOOK, SvPOK, SvPOKp, -SvPOK_off, SvPOK_on, SvPOK_only, SvPOK_only_UTF8, SvPV, SvPVX, SvPV_force, -SvPV_nolen, SvREFCNT, SvREFCNT_dec, SvREFCNT_inc, SvROK, SvROK_off, -SvROK_on, SvRV, SvSETMAGIC, SvSetSV, SvSetSV_nosteal, SvSTASH, SvTAINT, -SvTAINTED, SvTAINTED_off, SvTAINTED_on, SvTRUE, SvTYPE, svtype, SVt_IV, -SVt_NV, SVt_PV, SVt_PVAV, SVt_PVCV, SVt_PVHV, SVt_PVMG, SvUOK, SvUPGRADE, -SvUTF8, SvUTF8_off, SvUTF8_on, SvUV, SvUVX, sv_2mortal, sv_bless, sv_catpv, -sv_catpvf, sv_catpvf_mg, sv_catpvn, sv_catpvn_mg, sv_catpv_mg, sv_catsv, -sv_catsv_mg, sv_chop, sv_clear, sv_cmp, sv_cmp_locale, sv_dec, -sv_derived_from, sv_eq, sv_free, sv_gets, sv_grow, sv_inc, sv_insert, -sv_isa, sv_isobject, sv_len, sv_len_utf8, sv_magic, sv_mortalcopy, -sv_newmortal, sv_pvn_force, sv_pvutf8n_force, sv_reftype, sv_replace, +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, SvSETMAGIC, +SvSetMagicSV, SvSetMagicSV_nosteal, SvSetSV, SvSetSV_nosteal, SvSTASH, +SvTAINT, SvTAINTED, SvTAINTED_off, SvTAINTED_on, SvTRUE, SvTYPE, svtype, +SVt_IV, SVt_NV, SVt_PV, SVt_PVAV, SVt_PVCV, SVt_PVHV, SVt_PVMG, 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_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_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_mg, sv_setuv, sv_setuv_mg, -sv_true, sv_unmagic, sv_unref, sv_unref_flags, sv_upgrade, sv_usepvn, -sv_usepvn_mg, sv_utf8_decode, sv_utf8_downgrade, sv_utf8_encode, -sv_utf8_upgrade, sv_vcatpvfn, sv_vsetpvfn, THIS, toLOWER, toUPPER, -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, -warn, XPUSHi, XPUSHn, XPUSHp, XPUSHs, XPUSHu, XS, XSRETURN, XSRETURN_EMPTY, -XSRETURN_IV, XSRETURN_NO, XSRETURN_NV, XSRETURN_PV, XSRETURN_UNDEF, -XSRETURN_YES, XST_mIV, XST_mNO, XST_mNV, XST_mPV, XST_mUNDEF, XST_mYES, -XS_VERSION, XS_VERSION_BOOTCHECK, Zero +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, THIS, toLOWER, +toUPPER, 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, warn, XPUSHi, XPUSHn, XPUSHp, XPUSHs, XPUSHu, XS, XSRETURN, +XSRETURN_EMPTY, XSRETURN_IV, XSRETURN_NO, XSRETURN_NV, XSRETURN_PV, +XSRETURN_UNDEF, XSRETURN_YES, XST_mIV, XST_mNO, XST_mNV, XST_mPV, +XST_mUNDEF, XST_mYES, XS_VERSION, XS_VERSION_BOOTCHECK, Zero =item AUTHORS @@ -3920,7 +3971,8 @@ XS_VERSION, XS_VERSION_BOOTCHECK, Zero =item DESCRIPTION djSP, is_gv_magical, LVRET, PL_DBsingle, PL_DBsub, PL_DBtrace, PL_dowarn, -PL_last_in_gv, PL_ofs_sv, PL_rs, start_glob +PL_last_in_gv, PL_ofs_sv, PL_rs, report_uninit, start_glob, sv_add_arena, +sv_clean_all, sv_clean_objs, sv_free_arenas =item AUTHORS @@ -4038,301 +4090,349 @@ PerlIO_apply_layers(f,mode,layers), PerlIO_binmode(f,ptype,imode,layers), =item DESCRIPTION -=item Infrastructure +=item To do during 5.6.x =over 4 -=item Mailing list archives +=item Support for I/O disciplines -=item Bug tracking system +=item Eliminate need for "use utf8"; -=item Regression Tests +=item Create a char *sv_pvprintify(sv, STRLEN *lenp, UV flags) -Coverage, Regression, __DIE__, suidperl, The 25% slowdown from perl4 to -perl5 +=item Autoload byte.pm -=back +=item Make "\u{XXXX}" et al work -=item Configure +=item Overloadable regex assertions -=over 4 +=item Unicode collation and normalization -=item Install HTML +=item Unicode case mappings -=back +=item Unicode regular expression character classes -=item Perl Language +=item use Thread for iThreads -=over 4 +=item make perl_clone optionally clone ops -=item 64-bit Perl +=item Work out exit/die semantics for threads -=item Prototypes +=item Typed lexicals for compiler -Named prototypes, Indirect objects, Method calls, Context, Scoped subs +=item Compiler workarounds for Win32 -=back +=item AUTOLOADing in the compiler -=item Perl Internals +=item Fixing comppadlist when compiling -=over 4 +=item Cleaning up exported namespace -=item magic_setisa +=item Complete signal handling -=item Garbage Collection +=item Out-of-source builds -=item Reliable signals +=item POSIX realtime support -Alternate runops() for signal despatch, Figure out how to die() in delayed -sighandler, Add tests for Thread::Signal, Automatic tests against CPAN +=item UNIX98 support -=item Interpolated regex performance bugs +=item IPv6 Support -=item Memory leaks from failed eval/regcomp +=item Long double conversion -=item Make XS easier to use +=item Locales + +=item Thread-safe regexes + +=item Arithmetic on non-Arabic numerals + +=item POSIX Unicode character classes + +=item Factoring out common suffices/prefices in regexps (trie optimization) + +=item Security audit shipped utilities + +=item Custom opcodes + +=item spawnvp() on Win32 + +=item DLL Versioning + +=item Introduce @( and @) + +=item Floating point handling + +=item IV/UV preservation -=item Make embedded Perl easier to use +=item Replace pod2html with something using Pod::Parser -=item Namespace cleanup +=item Automate module testing on CPAN -=item MULTIPLICITY +=item sendmsg and recvmsg -=item MacPerl +=item Rewrite perlre documentation + +=item Convert example code to IO::Handle filehandles + +=item Document Win32 choices + +=item Check new modules + +=item Make roffitall find pods and libs itself =back -=item Documentation +=item To do at some point =over 4 -=item A clear division into tutorial and reference +=item Remove regular expression recursion -=item Remove the artificial distinction between operators and functions +=item Memory leaks after failed eval -=item More tutorials +=item pack "(stuff)*" -Regular expressions, I/O, pack/unpack, Debugging +=item bitfields in pack -=item Include a search tool +=item Cross compilation -=item Include a locate tool +=item Perl preprocessor / macros -=item Separate function manpages by default +=item Perl lexer in Perl -=item Users can't find the manpages +=item Using POSIX calls internally -=item Install ALL Documentation +=item -i rename file when changed -=item Outstanding issues to be documented +=item All ARGV input should act like EE -=item Adapt www.linuxhq.com for Perl +=item Support for rerunning debugger -=item Replace man with a perl program +=item Test Suite for the Debugger -=item Unicode tutorial +=item my sub foo { } -=back +=item One-pass global destruction -=item Modules +=item Rewrite regexp parser -=over 4 +=item Cache recently used regexps -=item Update the POSIX extension to conform with the POSIX 1003.1 Edition 2 +=item Re-entrant functions -=item Module versions +=item Cross-compilation support -=item New modules +=item Bit-shifting bitvectors -=item Profiler +=item debugger pragma -=item Tie Modules +=item use less pragma -VecArray, SubstrArray, VirtualArray, ShiftSplice +=item switch structures -=item Procedural options +=item Cache eval tree -=item RPC +=item rcatmaybe -=item y2k localtime/gmtime +=item Shrink opcode tables -=item Export File::Find variables +=item Optimize away @_ -=item Ioctl +=item Prototypes versus indirect objects -=item Debugger attach/detach +=item Install HMTL -=item Regular Expression debugger +=item Prototype method calls -=item Alternative RE Syntax +=item Return context prototype declarations -=item Bundled modules +=item magic_setisa -=item Expect +=item Garbage collection -=item GUI::Native +=item IO tutorial -=item Update semibroken auxiliary tools; h2ph, a2p, etc. +=item pack/unpack tutorial -=item pod2html +=item Rewrite perldoc -=item Podchecker +=item Install .3p manpages -=back +=item Unicode tutorial -=item Tom's Wishes +=item Update POSIX.pm for 1003.1-2 -=over 4 +=item Retargetable installation -=item Webperl +=item POSIX emulation on non-POSIX systems -=item Mobile agents +=item Rename Win32 headers -=item POSIX on non-POSIX +=item Finish off lvalue functions -=item Portable installations +=item Update sprintf documentation + +=item Use fchown/fchmod internally =back -=item Win32 Stuff +=item Vague ideas =over 4 -=item Rename new headers to be consistent with the rest +=item ref() in list context -=item Sort out the spawnvp() mess +=item Make tr/// return histogram -=item Work out DLL versioning +=item Compile to real threaded code -=item Style-check +=item Structured types -=back +=item Modifiable $1 et al. + +=item Procedural interfaces for IO::*, etc. + +=item RPC modules + +=item Attach/detach debugger from running program + +=item Alternative RE syntax module -=item Would be nice to have +=item GUI::Native + +=item foreach(reverse ...) + +=item Constant function cache + +=item Approximate regular expression matching -C, Contiguous bitfields in pack/unpack, lexperl, Bundled -perl preprocessor, Use posix calls internally where possible, format -BOTTOM, -i rename file only when successfully changed, All ARGV input -should act like <>, report HANDLE [formats], support in perlmain to rerun -debugger, lvalue functions +=back -=item Possible pragmas +=item Ongoing =over 4 -=item 'less' +=item Update guts documentation + +=item Add more tests + +=item Update auxiliary tools =back -=item Optimizations +=item Recently done things =over 4 -=item constant function cache +=item Safe signal handling + +=item Tie Modules -=item foreach(reverse...) +=item gettimeofday -=item Cache eval tree +=item setitimer and getimiter -=item rcatmaybe +=item Testing __DIE__ hook -=item Shrink opcode tables +=item CPP equivalent in Perl -=item Cache hash value +=item Explicit switch statements -=item Optimize away @_ where possible +=item autocroak -=item Optimize sort by { $a <=> $b } +=item UTF/EBCDIC -=item Rewrite regexp parser for better integrated optimization +=item UTF Regexes -=back +=item perlcc to produce executable -=item Vague possibilities +=item END blocks saved in compiled output -ref function in list context, make tr/// return histogram in list context?, -Loop control on do{} et al, Explicit switch statements, compile to real -threaded code, structured types, Modifiable $1 et al +=item Secure temporary file module -=item To Do Or Not To Do +=item Integrate Time::HiRes -=over 4 +=item Turn Cwd into XS + +=item Mmap for input -=item Making my() work on "package" variables +=item Byte to/from UTF8 and UTF8 to/from local conversion -=item "or" testing defined not truth +=item Add sockatmark support -=item "dynamic" lexicals +=item Mailing list archives -=item "class"-based, rather than package-based "lexicals" +=item Bug tracking -=back +=item Integrate MacPerl -=item Threading +=item Web "nerve center" for Perl -=over 4 +=item Regular expression tutorial -=item Modules +=item Debugging Tutorial -=item Testing +=item Integrate new modules -=item $AUTOLOAD +=item Integrate profiler -=item exit/die +=item Y2K error detection -=item External threads +=item Regular expression debugger -=item Thread::Pool +=item POD checker -=item thread-safety +=item "Dynamic" lexicals -=item Per-thread GVs +=item Cache precompiled modules =back -=item Compiler +=item Deprecated Wishes =over 4 -=item Optimization +=item Loop control on do{} -=item Byteperl +=item Lexically scoped typeglobs -=item Precompiled modules +=item format BOTTOM -=item Executables +=item report HANDLE -=item Typed lexicals +=item Generalised want()/caller()) -=item Win32 +=item Named prototypes -=item END blocks +=item Built-in globbing -=item _AUTOLOAD +=item Regression tests for suidperl -=item comppadlist +=item Cached hash values -=item Cached compilation +=item Add compression modules -=back +=item Reorganise documentation into tutorials/references -=item Recently Finished Tasks +=item Remove distinction between functions and operators -=over 4 +=item Make XS easier to use -=item Figure a way out of $^(capital letter) +=item Make embedding easier to use -=item Filenames +=item man for perl -=item Foreign lines +=item my $Package::variable -=item Namespace cleanup +=item "or" tests defined, not truth -=item ISA.pm +=item "class"-based lexicals -=item gettimeofday +=item byteperl + +=item Lazy evaluation / tail recursion removal -=item autocroak? +=item Make "use utf8" the default =back @@ -4357,9 +4457,16 @@ work?, Patches speak louder than words =item Keeping in sync rsync'ing the source tree, Using rsync over the LAN, Using pushing over the -NFS, rsync'ing the patches, It's easier, It's more recent, It's more -reliable, It's easier, It's a good reference, Finding a start point, -Finding how to fix a bug, Finding the source of misbehaviour +NFS, rsync'ing the patches + +=item Why rsync the source tree + +It's easier to rsync the source tree, It's more recent, It's more reliable + +=item Why rsync the patches + +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 Submitting patches @@ -4368,7 +4475,7 @@ F, The perl5-porters FAQ =item Finding Your Way Around -Core modules, Documentation, Configure, Interpreter +Core modules, Tests, Documentation, Configure, Interpreter =item Elements of the interpreter @@ -4395,6 +4502,13 @@ finish, 'enter', print =item Patching +=item Patching a core module + +=item Writing a test + +F, F, F, F, F, F, +F, F + =back =item EXTERNAL TOOLS FOR DEBUGGING PERL @@ -4415,9 +4529,18 @@ DEFINES, USE_MULTI = define, #PERL_MALLOC = define, CFG = Debug =item PERL_DESTRUCT_LEVEL +=item Profiling + +=item Gprof Profiling + +-a, -b, -e routine, -f routine, -s, -z + +=item GCC gcov Profiling + =item Pixie Profiling --h, -l, -p, -h, -i, -l, -testcoverage, -zero +-h, -l, -p[rocedures], -h[eavy], -i[nvocations], -l[ines], -testcoverage, +-z[ero] =item CONCLUSION @@ -4459,7 +4582,21 @@ I =back -=head2 perldelta - what's new for perl v5.7.0 +=head2 perldelta - what will be new for perl v5.8.0 + +=over 4 + +=item DESCRIPTION + +=item Reporting Bugs + +=item SEE ALSO + +=item HISTORY + +=back + +=head2 perl572delta - what's new for perl v5.7.2 =over 4 @@ -4469,13 +4606,27 @@ I =item Incompatible Changes +=over 4 + +=item 64-bit platforms and malloc + +=item AIX Dynaloading + +=item Socket Extension Dynamic in VMS + +=item Different Definition of the Unicode Character Classes \p{In...} + +=item Deprecations + +=back + =item Core Enhancements =item Modules and Pragmata =over 4 -=item New Modules +=item New Modules and Distributions =item Updated And Improved Modules and Pragmata @@ -4485,12 +4636,12 @@ I =item New Documentation -=item Performance Enhancements - =item Installation and Configuration Improvements =over 4 +=item New Or Improved Platforms + =item Generic Improvements =back @@ -4505,34 +4656,66 @@ I =item New or Changed Diagnostics -=item Changed Internals +=item Source Code Enhancements + +=over 4 + +=item MAGIC constants + +=item Better commented code + +=item Regex pre-/post-compilation items matched up + +=item gcc -Wall + +=back + +=item New Tests =item Known Problems =over 4 -=item Unicode Support Still Far From Perfect +=item AIX -=item EBCDIC Still A Lost Platform +=item Amiga Perl Invoking Mystery -=item Building Extensions Can Fail Because Of Largefiles +=item lib/ftmp-security tests warn 'system possibly insecure' -=item ftmp-security tests warn 'system possibly insecure' +=item Cygwin intermittent failures of lib/Memoize/t/expire_file 11 and 12 -=item Test lib/posix Subtest 9 Fails In LP64-Configured HP-UX +=item HP-UX lib/io_multihomed Fails When LP64-Configur -=item Long Doubles Still Don't Work In Solaris +=item HP-UX lib/posix Subtest 9 Fails When LP64-Configured =item Linux With Sfio Fails op/misc Test 48 -=item sprintf tests 129 and 130 +=item OS/390 -=item Storable tests fail in some platforms +=item op/sprintf tests 129 and 130 -=item Threads Are Still Experimental +=item Failure of Thread tests + +=item UNICOS + +=item UTS + +=item VMS + +=item Win32 + +=item Localising a Tied Variable Leaks Memory + +=item Self-tying of Arrays and Hashes Is Forbidden + +=item Variable Attributes are not Currently Usable for Tieing + +=item Building Extensions Can Fail Because Of Largefiles =item The Compiler Suite Is Still Experimental +=item The Long Double Support is Still Experimental + =back =item Reporting Bugs @@ -4543,119 +4726,329 @@ I =back -=head2 perl56delta, perldelta - what's new for perl v5.6.0 +=head2 perl571delta - what's new for perl v5.7.1 =over 4 =item DESCRIPTION +=item Security Vulnerability Closed + +=item Incompatible Changes + =item Core Enhancements =over 4 -=item Interpreter cloning, threads, and concurrency +=item AUTOLOAD Is Now Lvaluable -=item Lexically scoped warning categories +=item PerlIO is Now The Default -=item Unicode and UTF-8 support +=item Signals Are Now Safe -=item Support for interpolating named characters +=back -=item "our" declarations +=item Modules and Pragmata -=item Support for strings represented as a vector of ordinals +=over 4 -=item Improved Perl version numbering system +=item New Modules -=item New syntax for declaring subroutine attributes +=item Updated And Improved Modules and Pragmata -=item File and directory handles can be autovivified +=back -=item open() with more than two arguments +=item Performance Enhancements -=item 64-bit support +=item Utility Changes -=item Large file support +=item New Documentation -=item Long doubles +=over 4 -=item "more bits" +=item perlclib -=item Enhanced support for sort() subroutines +=item perliol -=item C allowed +=item README.aix -=item File globbing implemented internally +=item README.bs2000 -=item Support for CHECK blocks +=item README.macos -=item POSIX character class syntax [: :] supported +=item README.mpeix -=item Better pseudo-random number generator +=item README.solaris -=item Improved C operator +=item README.vos -=item Better worst-case behavior of hashes +=item Porting/repository.pod -=item pack() format 'Z' supported +=back -=item pack() format modifier '!' supported +=item Installation and Configuration Improvements -=item pack() and unpack() support counted strings +=over 4 -=item Comments in pack() templates +=item New Or Improved Platforms -=item Weak references +=item Generic Improvements -=item Binary numbers supported +d_cmsghdr, d_fcntl_can_lock, d_fsync, d_getitimer, d_getpagsz, d_msghdr_s, +need_va_copy, d_readv, d_recvmsg, d_sendmsg, sig_size, d_sockatmark, +d_strtoq, d_u32align, d_ualarm, d_usleep -=item Lvalue subroutines +=back -=item Some arrows may be omitted in calls through references +=item Selected Bug Fixes -=item Boolean assignment operators are legal lvalues +=over 4 -=item exists() is supported on subroutine names +=item Platform Specific Changes and Fixes -=item exists() and delete() are supported on array elements +=back -=item Pseudo-hashes work better +=item New or Changed Diagnostics -=item Automatic flushing of output buffers +=item Changed Internals -=item Better diagnostics on meaningless filehandle operations +=item New Tests -=item Where possible, buffered data discarded from duped input filehandle +=item Known Problems -=item eof() has the same old magic as <> +=over 4 -=item binmode() can be used to set :crlf and :raw modes +=item AIX vac 5.0.0.0 May Produce Buggy Code For Perl -=item C<-T> filetest recognizes UTF-8 encoded files as "text" +=item lib/ftmp-security tests warn 'system possibly insecure' -=item system(), backticks and pipe open now reflect exec() failure +=item lib/io_multihomed Fails In LP64-Configured HP-UX -=item Improved diagnostics +=item Test lib/posix Subtest 9 Fails In LP64-Configured HP-UX -=item Diagnostics follow STDERR +=item lib/b test 19 -=item More consistent close-on-exec behavior +=item Linux With Sfio Fails op/misc Test 48 -=item syswrite() ease-of-use +=item sigaction test 13 in VMS -=item Better syntax checks on parenthesized unary operators +=item sprintf tests 129 and 130 -=item Bit operators support full native integer width +=item Failure of Thread tests -=item Improved security features +=item Localising a Tied Variable Leaks Memory -=item More functional bareword prototype (*) +=item Self-tying of Arrays and Hashes Is Forbidden -=item C and C may be overridden +=item Building Extensions Can Fail Because Of Largefiles -=item $^X variables may now have names longer than one character +=item The Compiler Suite Is Still Experimental -=item New variable $^C reflects C<-c> switch +=back + +=item Reporting Bugs + +=item SEE ALSO + +=item HISTORY + +=back + +=head2 perl570delta - what's new for perl v5.7.0 + +=over 4 + +=item DESCRIPTION + +=item Security Vulnerability Closed + +=item Incompatible Changes + +=item Core Enhancements + +=item Modules and Pragmata + +=over 4 + +=item New Modules + +=item Updated And Improved Modules and Pragmata + +=back + +=item Utility Changes + +=item New Documentation + +=item Performance Enhancements + +=item Installation and Configuration Improvements + +=over 4 + +=item Generic Improvements + +=back + +=item Selected Bug Fixes + +=over 4 + +=item Platform Specific Changes and Fixes + +=back + +=item New or Changed Diagnostics + +=item Changed Internals + +=item Known Problems + +=over 4 + +=item Unicode Support Still Far From Perfect + +=item EBCDIC Still A Lost Platform + +=item Building Extensions Can Fail Because Of Largefiles + +=item ftmp-security tests warn 'system possibly insecure' + +=item Test lib/posix Subtest 9 Fails In LP64-Configured HP-UX + +=item Long Doubles Still Don't Work In Solaris + +=item Linux With Sfio Fails op/misc Test 48 + +=item Storable tests fail in some platforms + +=item Threads Are Still Experimental + +=item The Compiler Suite Is Still Experimental + +=back + +=item Reporting Bugs + +=item SEE ALSO + +=item HISTORY + +=back + +=head2 perl56delta, perldelta - what's new for perl v5.6.0 + +=over 4 + +=item DESCRIPTION + +=item Core Enhancements + +=over 4 + +=item Interpreter cloning, threads, and concurrency + +=item Lexically scoped warning categories + +=item Unicode and UTF-8 support + +=item Support for interpolating named characters + +=item "our" declarations + +=item Support for strings represented as a vector of ordinals + +=item Improved Perl version numbering system + +=item New syntax for declaring subroutine attributes + +=item File and directory handles can be autovivified + +=item open() with more than two arguments + +=item 64-bit support + +=item Large file support + +=item Long doubles + +=item "more bits" + +=item Enhanced support for sort() subroutines + +=item C allowed + +=item File globbing implemented internally + +=item Support for CHECK blocks + +=item POSIX character class syntax [: :] supported + +=item Better pseudo-random number generator + +=item Improved C operator + +=item Better worst-case behavior of hashes + +=item pack() format 'Z' supported + +=item pack() format modifier '!' supported + +=item pack() and unpack() support counted strings + +=item Comments in pack() templates + +=item Weak references + +=item Binary numbers supported + +=item Lvalue subroutines + +=item Some arrows may be omitted in calls through references + +=item Boolean assignment operators are legal lvalues + +=item exists() is supported on subroutine names + +=item exists() and delete() are supported on array elements + +=item Pseudo-hashes work better + +=item Automatic flushing of output buffers + +=item Better diagnostics on meaningless filehandle operations + +=item Where possible, buffered data discarded from duped input filehandle + +=item eof() has the same old magic as <> + +=item binmode() can be used to set :crlf and :raw modes + +=item C<-T> filetest recognizes UTF-8 encoded files as "text" + +=item system(), backticks and pipe open now reflect exec() failure + +=item Improved diagnostics + +=item Diagnostics follow STDERR + +=item More consistent close-on-exec behavior + +=item syswrite() ease-of-use + +=item Better syntax checks on parenthesized unary operators + +=item Bit operators support full native integer width + +=item Improved security features + +=item More functional bareword prototype (*) + +=item C and C may be overridden + +=item $^X variables may now have names longer than one character + +=item New variable $^C reflects C<-c> switch =item New variable $^V contains Perl version as a string @@ -5325,9 +5718,7 @@ long, Process terminated by SIG%s =item 64-bit Perl -=item GDBM and Threads - -=item NFS filesystems and utime(2) +=item AIX 4.2 and extensions using C++ with statics =back @@ -5337,6 +5728,16 @@ long, Process terminated by SIG%s =back +=head2 perlapollo, README.apollo - Perl version 5 on Apollo DomainOS + +=over 4 + +=item DESCRIPTION + +=item AUTHOR + +=back + =head2 perlamiga - Perl under Amiga OS =over 4 @@ -5351,7 +5752,7 @@ long, Process terminated by SIG%s =over 4 -=item Prerequisites +=item Prerequisites for Compiling Perl on AmigaOS B, B @@ -5367,31 +5768,29 @@ B, B =over 4 -=item Manpages +=item Manpages for Perl on AmigaOS -=item B +=item Perl HTML Documentation on AmigaOS -=item B C files +=item Perl GNU Info Files on AmigaOS -=item C docs +=item Perl LaTeX Documentation on AmigaOS =back -=item BUILD +=item BUILDING PERL ON AMIGAOS =over 4 -=item Prerequisites - -=item Getting the perl source +=item Build Prerequisites for Perl on AmigaOS -=item Making +=item Getting the Perl Source for AmigaOS -sh Configure -Dprefix=/ade -Dloclibpth=/ade/lib +=item Making Perl on AmigaOS -=item Testing +=item Testing Perl on AmigaOS -=item Installing the built perl +=item Installing the built Perl on AmigaOS =back @@ -5401,6 +5800,26 @@ sh Configure -Dprefix=/ade -Dloclibpth=/ade/lib =back +=head2 perlbeos, README.beos - Perl version 5 on BeOS + +=over 4 + +=item DESCRIPTION + +=over 4 + +=item General Issues with Perl on BeOS + +=item BeOS Release-specific Notes + +R4 x86, R4 PPC + +=item Contact Information + +=back + +=back + =head2 perlbs2000, README.BS2000 - building and installing Perl for BS2000. =over 4 @@ -5411,23 +5830,23 @@ sh Configure -Dprefix=/ade -Dloclibpth=/ade/lib =over 4 -=item gzip +=item gzip on BS2000 -=item bison +=item bison on BS2000 -=item Unpacking +=item Unpacking Perl Distribution on BS2000 -=item Compiling +=item Compiling Perl on BS2000 -=item Testing +=item Testing Perl on BS2000 -=item Install +=item Installing Perl on BS2000 -=item Using Perl in the Posix-Shell +=item Using Perl in the Posix-Shell of BS2000 =item Using Perl in "native" BS2000 -=item Floating point anomalies +=item Floating point anomalies on BS2000 =back @@ -5445,84 +5864,106 @@ sh Configure -Dprefix=/ade -Dloclibpth=/ade/lib =back -=head2 perlcygwin, README.cygwin - Perl for Cygwin - =over 4 -=item SYNOPSIS +=item Name + +=item Description -=item PREREQUISITES +=item Build =over 4 -=item Cygwin = GNU+Cygnus+Windows (Don't leave UNIX without it) +=item Tools & SDK -=item Cygwin Configuration +=item Make -C, I, Permissions +=back + +=item Acknowledgements + +=item Author =back -=item CONFIGURE +=head2 perlcygwin, README.cygwin - Perl for Cygwin =over 4 -=item Strip Binaries +=item SYNOPSIS -=item Optional Libraries +=item PREREQUISITES FOR COMPILING PERL ON CYGWIN -C<-lcrypt>, C<-lgdbm> (C), C<-ldb> (C), -C<-lcygipc> (C) +=over 4 + +=item Cygwin = GNU+Cygnus+Windows (Don't leave UNIX without it) + +=item Cygwin Configuration + +C, I, Permissions + +=back + +=item CONFIGURE PERL ON CYGWIN + +=over 4 + +=item Stripping Perl Binaries on Cygwin + +=item Optional Libraries for Perl on Cygwin + +C<-lcrypt>, C<-lgdbm> (C), C<-ldb> (C), +C<-lcygipc> (C) -=item Configure-time Options +=item Configure-time Options for Perl on Cygwin C<-Uusedl>, C<-Uusemymalloc>, C<-Dusemultiplicity>, C<-Duseperlio>, C<-Duse64bitint>, C<-Duselongdouble>, C<-Dusethreads>, C<-Duselargefiles> -=item Suspicious Warnings +=item Suspicious Warnings on Cygwin I, Win9x and C, Compiler/Preprocessor defines =back -=item MAKE +=item MAKE ON CYGWIN =over 4 -=item Warnings +=item Warnings on Cygwin -=item ld2 +=item ld2 on Cygwin =back -=item TEST +=item TEST ON CYGWIN =over 4 -=item File Permissions +=item File Permissions on Cygwin -=item Hard Links +=item Hard Links on Cygwin -=item Filetime Granularity +=item Filetime Granularity on Cygwin -=item Tainting Checks +=item Tainting Checks on Cygwin -=item /etc/group +=item /etc/group on Cygwin -=item Script Portability +=item Script Portability on Cygwin Pathnames, Text/Binary, F<.exe>, chown(), Miscellaneous =back -=item INSTALL +=item INSTALL PERL ON CYGWIN -=item MANIFEST +=item MANIFEST ON CYGWIN Documentation, Build, Configure, Make, Install, Tests, Compiled Perl Source, Compiled Module Source, Perl Modules/Scripts -=item BUGS +=item BUGS ON CYGWIN =item AUTHORS @@ -5530,6 +5971,38 @@ Source, Compiled Module Source, Perl Modules/Scripts =back +=head2 perldgux - Perl under DG/UX. + +=over 4 + +=item SYNOPSIS + +=back + +=over 4 + +=item DESCRIPTION + +=item BUILDING PERL ON DG/UX + +=over 4 + +=item Non-threaded Perl on DG/UX + +=item Threaded Perl on DG/UX + +=item Testing Perl on DG/UX + +=item Installing the built perl on DG/UX + +=back + +=item AUTHOR + +=item SEE ALSO + +=back + =head2 perldos - Perl under DOS, W31, W95. =over 4 @@ -5540,31 +6013,31 @@ Source, Compiled Module Source, Perl Modules/Scripts =over 4 -=item Prerequisites +=item Prerequisites for Compiling Perl on DOS DJGPP, Pthreads =item Shortcomings of Perl under DOS -=item Building +=item Building Perl on DOS -=item Testing +=item Testing Perl on DOS -=item Installation +=item Installation of Perl on DOS =back -=item BUILDING AND INSTALLING MODULES +=item BUILDING AND INSTALLING MODULES ON DOS =over 4 -=item Prerequisites +=item Building Prerequisites for Perl on DOS -=item Unpacking CPAN Modules +=item Unpacking CPAN Modules on DOS -=item Building Non-XS Modules +=item Building Non-XS Modules on DOS -=item Building XS Modules +=item Building XS Modules on DOS =back @@ -5592,21 +6065,21 @@ DJGPP, Pthreads =over 4 -=item I/O Redirection +=item I/O Redirection on Epoc -=item PATH Names +=item PATH Names on Epoc -=item Editors +=item Editors on Epoc -=item Features +=item Features of Perl on Epoc -=item Restrictions +=item Restrictions of Perl on Epoc =item Compiling Perl 5 on the EPOC cross compiling environment =back -=item SUPPORT STATUS +=item SUPPORT STATUS OF PERL ON EPOC =item AUTHOR @@ -5635,21 +6108,25 @@ DJGPP, Pthreads =item Portability Between PA-RISC Versions +=item Itanium Processor Family and HP-UX + =item Building Dynamic Extensions on HP-UX =item The HP ANSI C Compiler -=item Using Large Files with Perl +=item Using Large Files with Perl on HP-UX -=item Threaded Perl +=item Threaded Perl on HP-UX -=item 64-bit Perl +=item 64-bit Perl on HP-UX -=item GDBM and Threads +=item GDBM and Threads on HP-UX -=item NFS filesystems and utime(2) +=item NFS filesystems and utime(2) on HP-UX -=item perl -P and // +=item perl -P and // and HP-UX + +=item HP-UX Kernel Parameters (maxdsiz) for Compiling Perl =back @@ -5659,6 +6136,22 @@ DJGPP, Pthreads =back +=head2 perlhurd, README.hurd - Perl version 5 on Hurd + +=over 4 + +=item DESCRIPTION + +=over 4 + +=item Known Problems with Perl on Hurd + +=back + +=item AUTHOR + +=back + =head2 perlmachten, README.machten - Perl version 5 on Power MachTen systems @@ -5670,11 +6163,11 @@ systems =item Compiling Perl 5 on MachTen -=item Failures during C +=item Failures during C on MachTen op/lexassign.t, pragma/warnings.t -=item Building external modules +=item Building external modules on MachTen =back @@ -5698,27 +6191,88 @@ op/lexassign.t, pragma/warnings.t =back -=head2 perlmpeix, README.mpeix - Perl/iX for HP e3000 MPE +=head2 perlmint, README.mint - Perl version 5 on Atari MiNT + +=over 4 + +=item DESCRIPTION + +=item Known problems with Perl on MiNT + +=item AUTHOR + +=back -=head1 SYNOPSIS +=head2 perlmpeix, README.mpeix - Perl/iX for HP e3000 MPE =over 4 -=item What's New +=item SYNOPSIS + +=item NOTE + +=item What's New in Perl ffor MPE/iX -=item System Requirements +=item Welcome to Perl/iX + +=item System Requirements for Perl/iX =item How to Obtain Perl/iX -=item Distribution Contents Highlights +=item Perl/iX Distribution Contents Highlights + +README, INSTALL, LIBSHP3K, PERL, .cpan/, lib/, man/, +public_html/feedback.cgi, src/perl-5.6.0-mpe -README, public_html/feedback.cgi, 4, 6 +=item How to Compile Perl/iX + + 4, 6 =item Getting Started with Perl/iX =item MPE/iX Implementation Considerations -=item Change History +=item Known Perl/iX Bugs Under Investigation + +=item Perl/iX To-Do List + +=item Perl/iX Change History + +=item AUTHOR + +=item Name + +=item Description + +=item Build + +=over 4 + +=item Tools & SDK + +=item Setup + +Buildtype.bat, SetNWBld.bat, MPKBuild.bat + +=item Make + +=item Interpreter + +=item Extensions + +=back + +=item Install + +=item Build new extensions + +=item Known Issues + +=item Acknowledgements + +=item Authors + +=item Date =back @@ -5946,7 +6500,14 @@ C, C =item Priorities -=item DLL name mangling +=item DLL name mangling: pre 5.6.2 + +=item DLL name mangling: 5.6.2 and beyond + +Global DLLs, specific DLLs, C and C, F<.> from +C + +=item DLL forwarder generation =item Threading @@ -5960,6 +6521,8 @@ C, F =back +=item BUGS + =back =over 4 @@ -5980,25 +6543,25 @@ C, F =over 4 -=item Unpacking +=item Unpacking Perl distribution on OS/390 -=item Setup and utilities +=item Setup and utilities for Perl on OS/390 -=item Configure +=item Configure Perl on OS/390 -=item Build, test, install +=item Build, Test, Install Perl on OS/390 -=item build anomalies +=item Build Anomalies with Perl on OS/390 -=item testing anomalies +=item Testing Anomalies with Perl on OS/390 -=item installation anomalies +=item Installation Anomalies with Perl on OS/390 -=item Usage Hints +=item Usage Hints for Perl on OS/390 -=item Floating point anomalies +=item Floating Point Anomalies with Perl on OS/390 -=item Modules and Extensions +=item Modules and Extensions for Perl on OS/390 =back @@ -6008,7 +6571,7 @@ C, F =over 4 -=item Mailing list +=item Mailing list for Perl on OS/390 =back @@ -6016,6 +6579,68 @@ C, F =back +=head2 perlqnx, README.qnx - Perl version 5 on QNX + +=over 4 + +=item DESCRIPTION + +=over 4 + +=item Required Software for Compiling Perl on QNX4 + +/bin/sh, ar, nm, cpp, make + +=item Outstanding Issues with Perl on QNX4 + +=item QNX auxiliary files + +qnx/ar, qnx/cpp + +=item Outstanding issues with perl under QNX6 + +=back + +=item AUTHOR + +=back + +=head2 perlplan9 - Plan 9-specific documentation for Perl + +=over 4 + +=item DESCRIPTION + +=over 4 + +=item Invoking Perl + +=item What's in Plan 9 Perl + +=item What's not in Plan 9 Perl + +=item Perl5 Functions not currently supported in Plan 9 Perl + +=item Signals in Plan 9 Perl + +=back + +=item COMPILING AND INSTALLING PERL ON PLAN 9 + +=over 4 + +=item Installing Perl Documentation on Plan 9 + +=back + +=item BUGS + +=item Revision date + +=item AUTHOR + +=back + =head2 perlsolaris, README.solaris - Perl version 5 on Solaris systems =over 4 @@ -6036,11 +6661,11 @@ Solaris FAQ, Precompiled Binaries, Solaris Documentation =over 4 -=item File Extraction Problems. +=item File Extraction Problems on Solaris. -=item Compiler and Related Tools. +=item Compiler and Related Tools on Solaris. -=item Environment +=item Environment for Compiling Perl on Solaris =back @@ -6048,11 +6673,11 @@ Solaris FAQ, Precompiled Binaries, Solaris Documentation =over 4 -=item 64-bit Issues. +=item 64-bit Issues with Perl on Solaris. -=item Threads. +=item Threads in Perl on Solaris. -=item Malloc Issues. +=item Malloc Issues with Perl on Solaris. =back @@ -6066,17 +6691,17 @@ DATAMODEL_NATIVE specified", sh: ar: not found =over 4 -=item op/stat.t test 4 +=item op/stat.t test 4 in Solaris =back -=item PREBUILT BINARIES. +=item PREBUILT BINARIES OF PERL FOR SOLARIS. -=item RUNTIME ISSUES. +=item RUNTIME ISSUES FOR PERL ON SOLARIS. =over 4 -=item Limits on Numbers of Open Files. +=item Limits on Numbers of Open Files on Solaris. =back @@ -6086,11 +6711,11 @@ DATAMODEL_NATIVE specified", sh: ar: not found =over 4 -=item Proc::ProcessTable +=item Proc::ProcessTable on Solaris -=item BSD::Resource +=item BSD::Resource on Solaris -=item Net::SSLeay +=item Net::SSLeay on Solaris =back @@ -6100,7 +6725,36 @@ DATAMODEL_NATIVE specified", sh: ar: not found =back -=head2 perlvmesa, README.vmesa - building and installing Perl for VM/ESA. +=head2 perltru64, README.tru64 - Perl version 5 on Tru64 (formerly known as +Digital UNIX formerly known as DEC OSF/1) systems + +=over 4 + +=item DESCRIPTION + +=over 4 + +=item Compiling Perl 5 on Tru64 + +=item Using Large Files with Perl on Tru64 + +=item Threaded Perl on Tru64 + +=item Long Doubles on Tru64 + +=item 64-bit Perl on Tru64 + +=item Warnings about floating-point overflow when compiling Perl on Tru64 + +=back + +=item Testing Perl on Tru64 + +=item AUTHOR + +=back + +=head2 perluts - Perl under UTS =over 4 @@ -6108,28 +6762,33 @@ DATAMODEL_NATIVE specified", sh: ar: not found =item DESCRIPTION +=item BUILDING PERL ON UTS + +=item Installing the built perl on UTS + +=item AUTHOR + +=back + +=head2 perlvmesa, README.vmesa - building and installing Perl for VM/ESA. + =over 4 -=item Unpacking +=item SYNOPSIS + +=item DESCRIPTION -=item Setup and utilities +=over 4 -=item Configure +=item Unpacking Perl Distribution on VM/ESA -Don't turn on the compiler optimization flag "-O". There's a bug in the -compiler (APAR PQ18812) that generates some bad code the optimizer is on, -As VM/ESA doesn't fully support the fork() API programs relying on this -call will not work. I've replaced fork()/exec() with spawn() and the -standalone exec() with spawn(). This has a side effect when opening unnamed -pipes in a shell script: there is no child process generated under +=item Setup Perl and utilities on VM/ESA -=item testing anomalies +=item Configure Perl on VM/ESA -=item Usage Hints +=item Testing Anomalies of Perl on VM/ESA -When using perl on VM/ESA please keep in mind that the EBCDIC and ASCII -character sets are different. Perl builtin functions that may behave -differently under EBCDIC are mentioned in the perlport.pod document. +=item Usage Hints for Perl on VM/ESA =back @@ -6139,7 +6798,7 @@ differently under EBCDIC are mentioned in the perlport.pod document. =over 4 -=item Mailing list +=item Mailing list for Perl on VM/ESA =back @@ -6202,7 +6861,7 @@ LIST, waitpid PID,FLAGS =item Perl variables -%ENV, CRTL_ENV, CLISYM_[LOCAL], Any other string, $!, $^E, $?, $^S, $| +%ENV, CRTL_ENV, CLISYM_[LOCAL], Any other string, $!, $^E, $?, $| =item Standard modules with VMS-specific differences @@ -6244,9 +6903,9 @@ LIST, waitpid PID,FLAGS =over 4 -=item Unimplemented Features +=item Unimplemented Features of Perl on VOS -=item Restrictions +=item Restrictions of Perl on VOS =back @@ -6268,17 +6927,17 @@ LIST, waitpid PID,FLAGS =over 4 -=item Setting Up +=item Setting Up Perl on Win32 Make, Command Shell, Borland C++, Microsoft Visual C++, Mingw32 with GCC =item Building -=item Testing +=item Testing Perl on Win32 -=item Installation +=item Installation of Perl on Win32 -=item Usage Hints +=item Usage Hints for Perl on Win32 Environment Variables, File Globbing, Using perl from the command line, Building Extensions, Command-line Wildcard Expansion, Win32 Specific @@ -6774,20 +7433,8 @@ C, C, C =back -=head2 unicode::distinct - Perl pragma to strictly distinguish UTF8 data -and non-UTF data. - -=over 4 - -=item SYNOPSIS - -=item DESCRIPTION - -=item SEE ALSO - -=back - -=head2 utf8 - Perl pragma to enable/disable UTF-8 in source code +=head2 utf8 - Perl pragma to enable/disable UTF-8 (or UTF-EBCDIC) in source +code =over 4 @@ -6858,6 +7505,49 @@ warnings::warnif($object, $message) =back +=head2 Attribute::Handlers - Simpler definition of attribute handlers + +=over 4 + +=item VERSION + +=item SYNOPSIS + +=item DESCRIPTION + +[0], [1], [2], [3], [4], [5] + +=over 4 + +=item Typed lexicals + +=item Type-specific attribute handlers + +=item Non-interpretive attribute handlers + +=item Phase-specific attribute handlers + +=item Attributes as C interfaces + +=back + +=item EXAMPLES + +=item DIAGNOSTICS + +C, C, C, C, +C, C + +=item AUTHOR + +=item BUGS + +=item COPYRIGHT + +=back + =head2 AutoLoader - load subroutines only on demand =over 4 @@ -7033,8 +7723,9 @@ label, stash, file, cop_seq, arybase, line main_cv, init_av, main_root, main_start, comppadlist, sv_undef, sv_yes, sv_no, amagic_generation, walkoptree(OP, METHOD), walkoptree_debug(DEBUG), -walksymtable(SYMREF, METHOD, RECURSE), svref_2object(SV), ppname(OPNUM), -hash(STR), cast_I32(I), minus_c, cstring(STR), class(OBJ), threadsv_names +walksymtable(SYMREF, METHOD, RECURSE, PREFIX), svref_2object(SV), +ppname(OPNUM), hash(STR), cast_I32(I), minus_c, cstring(STR), class(OBJ), +threadsv_names =item AUTHOR @@ -7191,6 +7882,8 @@ B<#targ>, B<#targarg>, B<#targarglife>, B<#typenum> =back +=item Using B::Concise outside of the O framework + =item AUTHOR =back @@ -7217,7 +7910,7 @@ B<#targ>, B<#targarg>, B<#targarglife>, B<#typenum> =item OPTIONS -B<-l>, B<-p>, B<-q>, B<-u>I, B<-s>I, B, BI, +B<-l>, B<-p>, B<-q>, B<-f>I, B<-s>I, B, BI, B, BIB<.>, B<-x>I =item USING B::Deparse AS A MODULE @@ -7230,6 +7923,10 @@ B, BIB<.>, B<-x>I =item new +=item ambient_pragmas + +strict, $[, bytes, utf8, integer, re, warnings, hint_bits, warning_bits + =item coderef2text =back @@ -7490,8 +8187,9 @@ B<:standard>, B<:all> =item PRAGMAS --any, -compile, -nosticky, -no_xhtml, -nph, -newstyle_urls, -oldstyle_urls, --autoload, -no_debug, -debug, -private_tempfiles +-any, -compile, -nosticky, -no_undef_params, -no_xhtml, -nph, +-newstyle_urls, -oldstyle_urls, -autoload, -no_debug, -debug, +-private_tempfiles =item SPECIAL FORMS FOR IMPORTING HTML-TAG FUNCTIONS @@ -8108,9 +8806,10 @@ C<_a>, C<_exe>, C<_o> =item a -C, C, C, C, C, -C, C, 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 b @@ -8122,13 +8821,9 @@ C, C C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, -C, C, C - -=item C - -C, C, C, C, C, C, -C, C, C, 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 d @@ -8137,21 +8832,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, C, C, -C, C, C, C, -C, C, C, C, -C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, +C, C, C, C, +C, C, C, C, +C, C, C, C, +C, C, C, C, +C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, @@ -8161,59 +8857,63 @@ C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, -C, C, C, C, C, C, -C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, -C, C, C, -C, C, C, C, -C, C, C, C, C, -C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, -C, C, C, C, -C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, -C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, -C, C, C, C, -C, C, C, C, -C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, +C, C, C, +C, C, C, C, C, +C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, +C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, +C, C, C, C, C, +C, C, C, C, +C, C, C, C, C, +C, C, C, C, +C, C, C, C, C, +C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, +C, C, C, C, +C, C, C, C, +C, C, C, C, +C, C, C, C, C, C, C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, +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 e C, C, C, C, C, C, -C, C, C +C, C, C, C =item f C, C, C, C, C, -C, C, C, C, C, C +C, C, C, C, C, C, +C =item g @@ -8229,9 +8929,9 @@ C, C, C, C C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, @@ -8290,7 +8990,7 @@ C, C, C, C =item p C, C, C, C, C, C, -C +C, C =item P @@ -8306,7 +9006,7 @@ C, C =item r C, C, C, C, C, -C, C, C, C +C, C, C, C, C =item s @@ -8327,26 +9027,27 @@ C, C, C, C, C =item t -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 u C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, C, -C, C, C, C, -C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, -C, C, C, C, C, C, -C, C +C, C, C, C, +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 =item x @@ -8374,6 +9075,8 @@ C, C =item DESCRIPTION +=item NOTES + =back =head2 DB - programmatic interface to the Perl debugging API (draft, @@ -8474,7 +9177,8 @@ B, B, B =item Extra RECNO Methods B<$X-Epush(list) ;>, B<$value = $X-Epop ;>, B<$X-Eshift>, -B<$X-Eunshift(list) ;>, B<$X-Elength> +B<$X-Eunshift(list) ;>, B<$X-Elength>, B<$X-Esplice(offset, +length, elements);> =item Another Example @@ -8738,6 +9442,8 @@ $md5->addfile($io_handle), $md5->digest, $md5->hexdigest, $md5->b64digest =item DESCRIPTION +=item NOTES + =back =head2 Dumpvalue - provides screen dump of Perl data. @@ -8863,7 +9569,7 @@ reference, e.g.: =item Encoding How to ... IO with mixed content (faking iso-2020-*), MIME's Content-Length:, UTF-8 -strings in binary data, perl/Encode wrappers on non-Unicode XS modules +strings in binary data, Perl/Encode wrappers on non-Unicode XS modules =item Messing with Perl's Internals @@ -9041,6 +9747,54 @@ test_f file =back +=head2 ExtUtils::Constant - generate XS code to import C header constants + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item USAGE + +IV, UV, NV, PV, PVN, PVN, YES, NO, UNDEF + +=item FUNCTIONS + +=back + +C_stringify NAME + +constant_types + +memEQ_clause NAME, CHECKED_AT, INDENT + +assign INDENT, TYPE, PRE, POST, VALUE.. + +return_clause + +switch_clause INDENT, NAMELEN, ITEMHASH, ITEM.. + +params WHAT + +dump_names + +C_constant, name, type, value, macro, default, pre, post, def_pre =item +def_post + +XS_constant PACKAGE, TYPES, SUBNAME, C_SUBNAME + +autoload PACKAGE, VERSION, AUTOLOADER + +WriteConstants ATTRIBUTE =E VALUE [, ...], NAME, DEFAULT_TYPE, +BREAKOUT_AT, NAMES, C_FILE, XS_FILE, SUBNAME, C_SUBNAME + +=over 4 + +=item AUTHOR + +=back + =head2 ExtUtils::Embed - Utilities for embedding Perl in C/C++ applications =over 4 @@ -9142,6 +9896,53 @@ canonpath, cflags, manifypods, perl_archive =back +=head2 ExtUtils::MM_NW5 - methods to override UN*X behaviour in +ExtUtils::MakeMaker + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=back + +catfile + +constants (o) + +static_lib (o) + +dynamic_bs (o) + +dynamic_lib (o) + +canonpath + +perl_script + +pm_to_blib + +test_via_harness (o) + +tool_autosplit (override) + +tools_other (o) + +xs_o (o) + +top_targets (o) + +htmlifypods (o) + +manifypods (o) + +dist_ci (o) + +dist_core (o) + +pasthru (o) + =head2 ExtUtils::MM_OS2 - methods to override UN*X behaviour in ExtUtils::MakeMaker @@ -9569,10 +10370,10 @@ INSTALLSCRIPT, INSTALLSITEARCH, INSTALLSITELIB, INST_ARCHLIB, INST_BIN, INST_EXE, INST_HTMLLIBDIR, INST_HTMLSCRIPTDIR, INST_LIB, INST_MAN1DIR, INST_MAN3DIR, INST_SCRIPT, LDFROM, LIB, LIBPERL_A, LIBS, LINKTYPE, MAKEAPERL, MAKEFILE, MAN1PODS, MAN3PODS, MAP_TARGET, MYEXTLIB, NAME, -NEEDS_LINKING, NOECHO, NORECURS, NO_VC, OBJECT, OPTIMIZE, PERL, PERLMAINCC, -PERL_ARCHLIB, PERL_LIB, PERL_MALLOC_OK, PERL_SRC, PERM_RW, PERM_RWX, -PL_FILES, PM, PMLIBDIRS, PM_FILTER, POLLUTE, PPM_INSTALL_EXEC, -PPM_INSTALL_SCRIPT, PREFIX, PREREQ_PM, SKIP, TYPEMAPS, VERSION, +NEEDS_LINKING, NOECHO, NORECURS, NO_VC, OBJECT, OPTIMIZE, PERL, PERL_CORE, +PERLMAINCC, PERL_ARCHLIB, PERL_LIB, PERL_MALLOC_OK, PERLRUN, PERM_RW, +PERM_RWX, PL_FILES, PM, PMLIBDIRS, PM_FILTER, POLLUTE, PPM_INSTALL_EXEC, +PPM_INSTALL_SCRIPT, PREFIX, PREREQ_PM, SKIP, TEST_LIBS, VERSION, VERSION_FROM, XS, XSOPT, XSPROTOARG, XS_VERSION =item Additional lowercase attributes @@ -9786,6 +10587,8 @@ rmscopy($from,$to[,$date_flag]) =item RETURN +=item NOTES + =item AUTHOR =back @@ -9819,11 +10622,15 @@ rmscopy($from,$to[,$date_flag]) =item DESCRIPTION C, C, C, C, C, -C, C, C, C, -C, C +C, C, C, C, +C, C, C =item CAVEAT +=item NOTES + +=item HISTORY + =back =head2 File::Glob - Perl extension for BSD glob routine @@ -9834,9 +10641,9 @@ C, C =item DESCRIPTION -C, C, C, C, C, -C, C, C, C, C, -C +C, C, C, C, C, +C, C, C, C, +C, C, C =item DIAGNOSTICS @@ -10270,6 +11077,10 @@ $fh->print, $fh->printf, $fh->getline, $fh->getlines =item A Solution +=item Disabling or changing behaviour + +=item All-in-one interface + =item How it works =back @@ -10473,6 +11284,213 @@ locale =back +=head2 I18N::LangTags - functions for dealing with RFC3066-style language +tags + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=back + +the function is_language_tag($lang1) + +the function extract_language_tags($whatever) + +the function same_language_tag($lang1, $lang2) + +the function similarity_language_tag($lang1, $lang2) + +the function is_dialect_of($lang1, $lang2) + +the function super_languages($lang1) + +the function locale2language_tag($locale_identifier) + +the function encode_language_tag($lang1) + +the function alternate_language_tags($lang1) + +the function @langs = panic_languages(@accept_languages) + +=over 4 + +=item ABOUT LOWERCASING + +=item ABOUT UNICODE PLAINTEXT LANGUAGE TAGS + +=item SEE ALSO + +=item COPYRIGHT + +=item AUTHOR + +=back + +=head2 I18N::LangTags::List -- tags and names for human languages + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item ABOUT LANGUAGE TAGS + +=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, +{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} : +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 +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 +(ca.600-400 B.C.), [{phi} : Philippine (Other)], {phn} : Phoenician, {pon} +: Pohnpeian, {pl} : Polish, {pt} : Portuguese, [{pra} : Prakrit languages], +{pro} : Old Provencal (to 1500), {ps} : Pushto, {qu} : Quechua, {rm} : +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 + +=item SEE ALSO + +=item COPYRIGHT AND DISCLAIMER + +=item AUTHOR + +=back + +=head2 I18N::Langinfo - query locale information + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=over 4 + +=item EXPORT + +=back + +=item SEE ALSO + +=item AUTHOR + +=item COPYRIGHT AND LICENSE + +=back + =head2 IO - load various IO modules =over 4 @@ -10606,8 +11624,8 @@ IO ), handles( [ EVENT_MASK ] ) =item DESCRIPTION -$io->getpos, $io->setpos, $io->setpos ( POS, WHENCE ), WHENCE=0 (SEEK_SET), -WHENCE=1 (SEEK_CUR), WHENCE=1 (SEEK_END), $io->sysseek( POS, WHENCE ), +$io->getpos, $io->setpos, $io->seek ( POS, WHENCE ), WHENCE=0 (SEEK_SET), +WHENCE=1 (SEEK_CUR), WHENCE=2 (SEEK_END), $io->sysseek( POS, WHENCE ), $io->tell =item SEE ALSO @@ -10846,8 +11864,8 @@ I/O objects =item DESCRIPTION -$io->getpos, $io->setpos, $io->setpos ( POS, WHENCE ), WHENCE=0 (SEEK_SET), -WHENCE=1 (SEEK_CUR), WHENCE=1 (SEEK_END), $io->sysseek( POS, WHENCE ), +$io->getpos, $io->setpos, $io->seek ( POS, WHENCE ), WHENCE=0 (SEEK_SET), +WHENCE=1 (SEEK_CUR), WHENCE=2 (SEEK_END), $io->sysseek( POS, WHENCE ), $io->tell =item SEE ALSO @@ -11100,6 +12118,59 @@ set ( NAME => VALUE [, NAME => VALUE ...] ), setall ( VALUES ), setval ( N =back +=head2 List::Util - A selection of general-utility list subroutines + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +first BLOCK LIST, max LIST, maxstr LIST, min LIST, minstr LIST, reduce +BLOCK LIST, sum LIST + +=item SUGGESTED ADDITIONS + +=item COPYRIGHT + +=back + +=head2 List::Utilib::List::Util, List::Util - A selection of +general-utility list subroutines + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +first BLOCK LIST, max LIST, maxstr LIST, min LIST, minstr LIST, reduce +BLOCK LIST, sum LIST + +=item SUGGESTED ADDITIONS + +=item COPYRIGHT + +=back + +=head2 List::Utilib::Scalar::Util, Scalar::Util - A selection of +general-utility scalar subroutines + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +blessed EXPR, dualvar NUM, STRING, isweak EXPR, readonly SCALAR, reftype +EXPR, tainted EXPR, weaken REF + +=item COPYRIGHT + +=item BLATANT PLUG + +=back + =head2 Locale::Constants - constants for Locale codes =over 4 @@ -11277,7 +12348,7 @@ http://lcweb.loc.gov/standards/iso639-2/langhome.html =back -=head2 MIME::Base64 - Encoding and decoding of base64 strings +=head2 Locale::Maketext -- framework for localization =over 4 @@ -11285,49 +12356,50 @@ http://lcweb.loc.gov/standards/iso639-2/langhome.html =item DESCRIPTION -encode_base64($str, [$eol]), decode_base64($str) +=item QUICK OVERVIEW -=item DIAGNOSTICS +=item METHODS -Premature end of base64 data, Premature padding of base64 data +=over 4 -=item EXAMPLES +=item Construction Methods -=item COPYRIGHT +=item The "maketext" Method -=back +$lh->fail_with I $lh->fail_with(I), $lh->failure_handler_auto -=head2 MIME::Base64::QuotedPrint, MIME::QuotedPrint - Encoding and decoding -of quoted-printable strings +=item Utility Methods -=over 4 +$language->quant($number, $singular), $language->quant($number, $singular, +$plural), $language->quant($number, $singular, $plural, $negative), +$language->numf($number), $language->sprintf($format, @items), +$language->language_tag(), $language->encoding() -=item SYNOPSIS +=item Language Handle Attributes and Internals -=item DESCRIPTION +=back -encode_qp($str), decode_qp($str); +=item LANGUAGE CLASS HIERARCHIES -=item COPYRIGHT +=item ENTRIES IN EACH LEXICON -=back +=item BRACKET NOTATION -=head2 MIME::QuotedPrint - Encoding and decoding of quoted-printable -strings +=item AUTO LEXICONS -=over 4 +=item CONTROLLING LOOKUP FAILURE -=item SYNOPSIS +=item HOW TO USE MAKETEXT -=item DESCRIPTION +=item SEE ALSO -encode_qp($str), decode_qp($str); +=item COPYRIGHT AND DISCLAIMER -=item COPYRIGHT +=item AUTHOR =back -=head2 Math::BigFloat - Arbitrary length float math package +=head2 Locale::Maketext::TPJ13 -- article about software localization =over 4 @@ -11335,37 +12407,37 @@ encode_qp($str), decode_qp($str); =item DESCRIPTION -number format, Error returns 'NaN', Division is computed to, Rounding is -performed +=item Localization and Perl: gettext breaks, Maketext fixes -=item BUGS +=over 4 -=item AUTHOR +=item A Localization Horror Story: It Could Happen To You -=back +=item The Linguistic View -=head2 Math::BigInt - Arbitrary size integer math package +=item Breaking gettext -=over 4 +=item Replacing gettext -=item SYNOPSIS +=item Buzzwords: Abstraction and Encapsulation -=item DESCRIPTION +=item Buzzword: Isomorphism -Canonical notation, Input, Output +=item Buzzword: Inheritance -=item EXAMPLES +=item Buzzword: Concision -=item Autocreating constants +=item The Devil in the Details -=item BUGS +=item The Proof in the Pudding: Localizing Web Sites -=item AUTHOR +=item References =back -=head2 Math::Complex - complex numbers and associated mathematical -functions +=back + +=head2 MIME::Base64 - Encoding and decoding of base64 strings =over 4 @@ -11373,31 +12445,735 @@ functions =item DESCRIPTION -=item OPERATIONS +encode_base64($str, [$eol]), decode_base64($str) -=item CREATION +=item DIAGNOSTICS -=item STRINGIFICATION +Premature end of base64 data, Premature padding of base64 data -=over 4 +=item EXAMPLES -=item CHANGED IN PERL 5.6 +=item COPYRIGHT =back -=item USAGE +=head2 MIME::Base64::QuotedPrint, MIME::QuotedPrint - Encoding and decoding +of quoted-printable strings -=item ERRORS DUE TO DIVISION BY ZERO OR LOGARITHM OF ZERO +=over 4 -=item ERRORS DUE TO INDIGESTIBLE ARGUMENTS +=item SYNOPSIS -=item BUGS +=item DESCRIPTION -=item AUTHORS +encode_qp($str), decode_qp($str); + +=item COPYRIGHT + +=back + +=head2 MIME::QuotedPrint - Encoding and decoding of quoted-printable +strings + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +encode_qp($str), decode_qp($str); + +=item COPYRIGHT + +=back + +=head2 Math::BigFloat - Arbitrary size floating point math package + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=over 4 + +=item Canonical notation + +=item Output + +=item C, C and C + +=item Accuracy vs. Precision + +=item Rounding + +ffround ( +$scale ), ffround ( -$scale ), ffround ( 0 ), fround ( +$scale +), fround ( -$scale ) and fround ( 0 ) + +=back + +=item EXAMPLES + + use Math::BigFloat qw(bstr bint); + # not ready yet + $x = bstr("1234") # string "1234" + $x = "$x"; # same as bstr() + $x = bneg("1234") # BigFloat "-1234" + $x = Math::BigFloat->bneg("1234"); # BigFloat "1234" + $x = Math::BigFloat->babs("-12345"); # BigFloat "12345" + $x = Math::BigFloat->bnorm("-0 00"); # BigFloat "0" + $x = bint(1) + bint(2); # BigFloat "3" + $x = bint(1) + "2"; # ditto (auto-BigFloatify of "2") + $x = bint(1); # BigFloat "1" + $x = $x + 5 / 2; # BigFloat "3" + $x = $x ** 3; # BigFloat "27" + $x *= 2; # BigFloat "54" + $x = new Math::BigFloat; # BigFloat "0" + $x--; # BigFloat "-1" + +=item Autocreating constants + +=item PERFORMANCE + +=item BUGS + +=item CAVEAT + +stringify, bstr(), bdiv, Modifying and =, bpow + +=item LICENSE + +=item AUTHORS + +=back + +=head2 Math::BigInt - Arbitrary size integer math package + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +Canonical notation, Input, Output + +=item ACCURACY and PRECISION + +=over 4 + +=item Precision P + +=item Accuracy A + +=item Fallback F + +=item Rounding mode R + +'trunc', 'even', 'odd', '+inf', '-inf', 'zero', Precision, Accuracy +(significant digits), Setting/Accessing, Creating numbers, Usage, +Precedence, Overriding globals, Local settings, Rounding, Default values, +Remarks + +=back + +=item INTERNALS + +=over 4 + +=item mantissa(), exponent() and parts() + +=back + +=item EXAMPLES + + use Math::BigInt qw(bstr bint); + $x = bstr("1234") # string "1234" + $x = "$x"; # same as bstr() + $x = bneg("1234") # Bigint "-1234" + $x = Math::BigInt->bneg("1234"); # Bigint "-1234" + $x = Math::BigInt->babs("-12345"); # Bigint "12345" + $x = Math::BigInt->bnorm("-0 00"); # BigInt "0" + $x = bint(1) + bint(2); # BigInt "3" + $x = bint(1) + "2"; # ditto (auto-BigIntify of "2") + $x = bint(1); # BigInt "1" + $x = $x + 5 / 2; # BigInt "3" + $x = $x ** 3; # BigInt "27" + $x *= 2; # BigInt "54" + $x = new Math::BigInt; # BigInt "0" + $x--; # BigInt "-1" + $x = Math::BigInt->badd(4,5) # BigInt "9" + $x = Math::BigInt::badd(4,5) # BigInt "9" + print $x->bsstr(); # 9e+0 + +=item Autocreating constants + +=item PERFORMANCE + +=over 4 + +=item Replacing the math library + +=back + +=item BUGS + +:constant and eval() + +=item CAVEATS + +stringify, bstr(), bsstr() and 'cmp', int(), bdiv, Modifying and =, bpow, +Overloading -$x, Mixing different object types, bsqrt() + +=item LICENSE + +=item SEE ALSO + +=item AUTHORS + +=back + +=head2 Math::BigInt::Calc - Pure Perl module to support Math::BigInt + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item EXPORT + +=item LICENSE + +This program is free software; you may redistribute it and/or modify it +under +the same terms as Perl itself. + +=item AUTHORS + +=item SEE ALSO + +=back + +=head2 Math::Complex - complex numbers and associated mathematical +functions + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item OPERATIONS + +=item CREATION + +=item STRINGIFICATION + +=over 4 + +=item CHANGED IN PERL 5.6 + +=back + +=item USAGE + +=item ERRORS DUE TO DIVISION BY ZERO OR LOGARITHM OF ZERO + +=item ERRORS DUE TO INDIGESTIBLE ARGUMENTS + +=item BUGS + +=item AUTHORS + +=back + +=head2 Math::Trig - trigonometric functions + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item TRIGONOMETRIC FUNCTIONS + +B + +=over 4 + +=item ERRORS DUE TO DIVISION BY ZERO + +=item SIMPLE (REAL) ARGUMENTS, COMPLEX RESULTS + +=back + +=item PLANE ANGLE CONVERSIONS + +=item RADIAL COORDINATE CONVERSIONS + +=over 4 + +=item COORDINATE SYSTEMS + +=item 3-D ANGLE CONVERSIONS + +cartesian_to_cylindrical, cartesian_to_spherical, cylindrical_to_cartesian, +cylindrical_to_spherical, spherical_to_cartesian, spherical_to_cylindrical + +=back + +=item GREAT CIRCLE DISTANCES AND DIRECTIONS + +=item EXAMPLES + +=over 4 + +=item CAVEAT FOR GREAT CIRCLE FORMULAS + +=back + +=item BUGS + +=item AUTHORS + +=back + +=head2 Memoize - Make your functions faster by trading space for time + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item DETAILS + +=item OPTIONS + +=over 4 + +=item INSTALL + +=item NORMALIZER + +=item C, C + +C, C, C, C, C + +=back + +=item OTHER FACILITIES + +=over 4 + +=item C + +=item C + +=back + +=item CAVEATS + +=item PERSISTENT CACHE SUPPORT + +=item EXPIRATION SUPPORT + +=item BUGS + +=item MAILING LIST + +=item AUTHOR + +=item COPYRIGHT AND LICENSE + +=item THANK YOU + +=back + +=head2 Memoize::AnyDBM_File - glue to provide EXISTS for AnyDBM_File for +Storable use + +=over 4 + +=item DESCRIPTION + +=back + +=head2 Memoize::Expire - Plug-in module for automatic expiration of +memoized values + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item INTERFACE + + TIEHASH, EXISTS, STORE + +=item ALTERNATIVES + +=item CAVEATS + +=item AUTHOR + +=item SEE ALSO + +=back + +=head2 Memoize::ExpireFile - test for Memoize expiration semantics + +=over 4 + +=item DESCRIPTION + +=back + +=head2 Memoize::ExpireTest - test for Memoize expiration semantics + +=over 4 + +=item DESCRIPTION + +=back + +=head2 Memoize::NDBM_File - glue to provide EXISTS for NDBM_File for +Storable use + +=over 4 + +=item DESCRIPTION + +=back + +=head2 Memoize::SDBM_File - glue to provide EXISTS for SDBM_File for +Storable use + +=over 4 + +=item DESCRIPTION + +=back + +=head2 Memoize::Saves - Plug-in module to specify which return values +should be memoized + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item CAVEATS + +=item AUTHOR + +=item SEE ALSO + +=back + +=head2 Memoize::Storable - store Memoized data in Storable database + +=over 4 + +=item DESCRIPTION + +=back + +=head2 NDBM_File - Tied access to ndbm files + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +C, C, C + +=item DIAGNOSTICS + +=over 4 + +=item C + +=back + +=item BUGS AND WARNINGS + +=back + +=head2 NEXT - Provide a pseudo-class NEXT that allows method redispatch + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item AUTHOR + +=item BUGS AND IRRITATIONS + +=item COPYRIGHT + +=back + +=head2 Net::Cmd - Network Command class (as used by FTP, SMTP etc) + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item USER METHODS + +debug ( VALUE ), message (), code (), ok (), status (), datasend ( DATA ), +dataend () + +=item CLASS METHODS + +debug_print ( DIR, TEXT ), debug_text ( TEXT ), command ( CMD [, ARGS, ... +]), unsupported (), response (), parse_response ( TEXT ), getline (), +ungetline ( TEXT ), read_until_dot () + +=item EXPORTS + +=item AUTHOR + +=item COPYRIGHT + +=back + +=head2 Net::Config - Local configuration data for libnet + +=over 4 + +=item SYNOPSYS + +=item DESCRIPTION + +=item METHODS + +requires_firewall HOST + +=item NetConfig VALUES + +nntp_hosts, snpp_hosts, pop3_hosts, smtp_hosts, ph_hosts, daytime_hosts, +time_hosts, inet_domain, ftp_firewall, ftp_ext_passive, ftp_int_pasive, +local_netmask, test_hosts, test_exists + +=back + +=head2 Net::Domain - Attempt to evaluate the current host's internet name +and domain + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +hostfqdn (), hostname (), hostdomain () + +=item AUTHOR + +=item COPYRIGHT + +=back + +=head2 Net::FTP - FTP Client class + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item OVERVIEW + +=item CONSTRUCTOR + +new (HOST [,OPTIONS]) + +=item METHODS + +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 (), 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 () + +=over 4 + +=item Methods for the adventurous + +quot (CMD [,ARGS]) + +=back + +=item THE dataconn CLASS + +read ( BUFFER, SIZE [, TIMEOUT ] ), write ( BUFFER, SIZE [, TIMEOUT ] ), +abort (), close () + +=item UNIMPLEMENTED + +B, B, B, B, B, B, B, B + +=item REPORTING BUGS + +=item AUTHOR + +=item SEE ALSO + +=item CREDITS + +=item COPYRIGHT + +=back + +=head2 Net::NNTP - NNTP Client class + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item CONSTRUCTOR + +new ( [ HOST ] [, OPTIONS ]) + +=item METHODS + +article ( [ MSGID|MSGNUM ], [FH] ), body ( [ MSGID|MSGNUM ], [FH] ), head ( +[ MSGID|MSGNUM ], [FH] ), nntpstat ( [ MSGID|MSGNUM ] ), group ( [ GROUP ] +), ihave ( MSGID [, MESSAGE ]), last (), date (), postok (), authinfo ( +USER, PASS ), list (), newgroups ( SINCE [, DISTRIBUTIONS ]), newnews ( +SINCE [, GROUPS [, DISTRIBUTIONS ]]), next (), post ( [ MESSAGE ] ), slave +(), quit () + +=over 4 + +=item Extension methods + +newsgroups ( [ PATTERN ] ), distributions (), subscriptions (), +overview_fmt (), active_times (), active ( [ PATTERN ] ), xgtitle ( PATTERN +), xhdr ( HEADER, MESSAGE-SPEC ), xover ( MESSAGE-SPEC ), xpath ( +MESSAGE-ID ), xpat ( HEADER, PATTERN, MESSAGE-SPEC), xrover, listgroup ( [ +GROUP ] ), reader + +=back + +=item UNSUPPORTED + +=item DEFINITIONS + +MESSAGE-SPEC, PATTERN, Examples, C<[^]-]>, C<*bdc>, C<[0-9a-zA-Z]>, C + +=item SEE ALSO + +=item AUTHOR + +=item COPYRIGHT + +=back + +=head2 Net::POP3 - Post Office Protocol 3 Client class (RFC1081) + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item EXAMPLES + +=item CONSTRUCTOR + +new ( [ HOST, ] [ OPTIONS ] ) + +=item METHODS + +user ( USER ), pass ( PASS ), login ( [ USER [, PASS ]] ), apop ( USER, +PASS ), top ( MSGNUM [, NUMLINES ] ), list ( [ MSGNUM ] ), get ( MSGNUM [, +FH ] ), last (), popstat (), ping ( USER ), uidl ( [ MSGNUM ] ), delete ( +MSGNUM ), reset (), quit () + +=item NOTES + +=item SEE ALSO + +=item AUTHOR + +=item COPYRIGHT + +=back + +=head2 Net::Ping - check a remote host for reachability + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +icmp, udp, tcp, stream, external + +=over 4 + +=item Functions + +Net::Ping->new([$proto [, $def_timeout [, $bytes]]]);, $p->ping($host [, +$timeout]);, $p->open($host);, $p->close();, pingecho($host [, $timeout]); + +=back + +=item NOTES + +=back + +=head2 Net::SMTP - Simple Mail Transfer Protocol Client + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item EXAMPLES + +=item CONSTRUCTOR + +new Net::SMTP [ HOST, ] [ OPTIONS ] + +=item METHODS + +banner (), domain (), hello ( DOMAIN ), etrn ( DOMAIN ), mail ( ADDRESS [, +OPTIONS] ), send ( ADDRESS ), send_or_mail ( ADDRESS ), send_and_mail ( +ADDRESS ), reset (), recipient ( ADDRESS [, ADDRESS [ ...]] [, OPTIONS ] ), +to ( ADDRESS [, ADDRESS [...]] ), data ( [ DATA ] ), expand ( ADDRESS ), +verify ( ADDRESS ), help ( [ $subject ] ), quit () + +=item SEE ALSO + +=item AUTHOR + +=item COPYRIGHT =back -=head2 Math::Trig - trigonometric functions +=head2 Net::Time - time and daytime network client interface =over 4 @@ -11405,93 +13181,134 @@ functions =item DESCRIPTION -=item TRIGONOMETRIC FUNCTIONS +inet_time ( [HOST [, PROTOCOL [, TIMEOUT]]]), inet_daytime ( [HOST [, +PROTOCOL [, TIMEOUT]]]) -B +=item AUTHOR + +=item COPYRIGHT + +=back + +=head2 Net::hostent - by-name interface to Perl's built-in gethost*() +functions =over 4 -=item ERRORS DUE TO DIVISION BY ZERO +=item SYNOPSIS -=item SIMPLE (REAL) ARGUMENTS, COMPLEX RESULTS +=item DESCRIPTION -=back +=item EXAMPLES -=item PLANE ANGLE CONVERSIONS +=item NOTE -=item RADIAL COORDINATE CONVERSIONS +=item AUTHOR + +=back + +=head2 Net::libnetFAQ, libnetFAQ - libnet Frequently Asked Questions =over 4 -=item COORDINATE SYSTEMS +=item DESCRIPTION -=item 3-D ANGLE CONVERSIONS +=over 4 -cartesian_to_cylindrical, cartesian_to_spherical, cylindrical_to_cartesian, -cylindrical_to_spherical, spherical_to_cartesian, spherical_to_cylindrical +=item Where to get this document -=back +=item How to contribute to this document -=item GREAT CIRCLE DISTANCES AND DIRECTIONS +=back -=item EXAMPLES +=item Author and Copyright Information =over 4 -=item CAVEAT FOR GREAT CIRCLE FORMULAS +=item Disclaimer =back -=item BUGS +=item Obtaining and installing libnet -=item AUTHORS +=over 4 + +=item What is libnet ? + +=item Which version of perl do I need ? + +=item What other modules do I need ? + +=item What machines support libnet ? + +=item Where can I get the latest libnet release =back -=head2 NDBM_File - Tied access to ndbm files +=item Using Net::FTP =over 4 -=item SYNOPSIS +=item How do I download files from a FTP server ? -=item DESCRIPTION +=item How do I transfer files in binary mode ? -C, C, C +=item How can I get the size of a file on a remote FTP server ? -=item DIAGNOSTICS +=item How can I get the modification time of a file on a remote FTP server +? -=over 4 +=item How can I change the permissions of a file on a remote server ? -=item C +=item Can I do a reget operation like the ftp command ? -=back +=item How do I get a directory listing from a FTP server ? -=item BUGS AND WARNINGS +=item Changeing directory to "" does not fail ? + +=item I am behind a SOCKS firewall, but the Firewall option does not work ? + +=item I am behind a FTP proxy firewall, but cannot access machines outside +? + +=item My ftp proxy firewall does not listen on port 21 + +=item Is it possible to change the file permissions of a file on an FTP +server ? + +=item I have seen scripts call a method message, but cannot find it +documented ? + +=item Why does Net::FTP not implement mput and mget methods =back -=head2 Net::Ping - check a remote host for reachability +=item Using Net::SMTP =over 4 -=item SYNOPSIS +=item Why can't the part of an Email address after the @ be used as the +hostname ? -=item DESCRIPTION +=item Why does Net::SMTP not do DNS MX lookups ? -=over 4 +=item The verify method always returns true ? -=item Functions +=back -Net::Ping->new([$proto [, $def_timeout [, $bytes]]]);, $p->ping($host [, -$timeout]);, $p->close();, pingecho($host [, $timeout]); +=item Debugging scripts + +=over 4 + +=item How can I debug my scripts that use Net::* modules ? =back -=item NOTES +=item AUTHOR AND COPYRIGHT =back -=head2 Net::hostent - by-name interface to Perl's built-in gethost*() +=head2 Net::netent - by-name interface to Perl's built-in getnet*() functions =over 4 @@ -11508,7 +13325,7 @@ functions =back -=head2 Net::netent - by-name interface to Perl's built-in getnet*() +=head2 Net::protoent - by-name interface to Perl's built-in getproto*() functions =over 4 @@ -11517,15 +13334,13 @@ functions =item DESCRIPTION -=item EXAMPLES - =item NOTE =item AUTHOR =back -=head2 Net::protoent - by-name interface to Perl's built-in getproto*() +=head2 Net::servent - by-name interface to Perl's built-in getserv*() functions =over 4 @@ -11534,14 +13349,15 @@ functions =item DESCRIPTION +=item EXAMPLES + =item NOTE =item AUTHOR =back -=head2 Net::servent - by-name interface to Perl's built-in getserv*() -functions +=head2 Netrc, Net::Netrc - OO interface to users netrc file =over 4 @@ -11549,12 +13365,25 @@ functions =item DESCRIPTION -=item EXAMPLES +=item THE .netrc FILE -=item NOTE +machine name, default, login name, password string, account string, macdef +name + +=item CONSTRUCTOR + +lookup ( MACHINE [, LOGIN ]) + +=item METHODS + +login (), password (), account (), lpa () =item AUTHOR +=item SEE ALSO + +=item COPYRIGHT + =back =head2 O - Generic interface to Perl Compiler backends @@ -12004,9 +13833,9 @@ C<-inc =E 1>, C<-dirs =E [ $dir1, $dir2, ... ]>, C<-verbose =E =item ARGUMENTS -backlink, css, flush, header, help, htmldir, htmlroot, index, infile, -libpods, netscape, outfile, podpath, podroot, quiet, recurse, title, -verbose +backlink, cachedir, css, flush, header, help, htmldir, htmlroot, index, +infile, libpods, netscape, outfile, podpath, podroot, quiet, recurse, +title, verbose =item EXAMPLE @@ -12382,9 +14211,8 @@ release, section =item DIAGNOSTICS roff font should be 1 or 2 chars, not "%s", Invalid link %s, Invalid quote -specification "%s", %s:%d: Unknown command paragraph "%s", Unknown escape -EE%sE, Unknown sequence %s, %s: Unknown command paragraph "%s" on -line %d, Unmatched =back +specification "%s", %s:%d: Unknown command paragraph "%s", %s:%d: Unknown +escape EE%sE, %s:%d: Unknown sequence %s, %s:%d: Unmatched =back =item BUGS @@ -12392,6 +14220,8 @@ line %d, Unmatched =back =item AUTHOR +=item COPYRIGHT AND LICENSE + =back =head2 Pod::ParseUtils - helpers for POD parsing and conversion @@ -12888,6 +14718,8 @@ specification "%s", %s:%d: Unknown command paragraph "%s", Unknown escape: =item AUTHOR +=item COPYRIGHT AND LICENSE + =back =head2 Pod::Text::Color - Convert POD data to formatted color ASCII text @@ -12904,6 +14736,8 @@ specification "%s", %s:%d: Unknown command paragraph "%s", Unknown escape: =item AUTHOR +=item COPYRIGHT AND LICENSE + =back =head2 Pod::Text::Overstrike - Convert POD data to formatted overstrike @@ -12921,6 +14755,8 @@ text =item AUTHOR +=item COPYRIGHT AND LICENSE + =back =head2 Pod::Text::Termcap, Pod::Text::Color - Convert POD data to ASCII @@ -12936,6 +14772,8 @@ text with format escapes =item AUTHOR +=item COPYRIGHT AND LICENSE + =back =head2 Pod::Usage, pod2usage() - print a usage message from embedded pod @@ -13023,6 +14861,23 @@ Memory, CPU, Snooping, Signals, State Changes =back +=head2 Scalar::Util - A selection of general-utility scalar subroutines + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +blessed EXPR, dualvar NUM, STRING, isweak EXPR, readonly SCALAR, reftype +EXPR, tainted EXPR, weaken REF + +=item COPYRIGHT + +=item BLATANT PLUG + +=back + =head2 Search::Dict, look - search for key in dictionary file =over 4 @@ -13178,6 +15033,8 @@ C =item Automating fall-through +=item Alternative syntax + =item Higher-order Operations =back @@ -13252,45 +15109,201 @@ closelog =item SEE ALSO -=item AUTHOR +=item AUTHOR + +=back + +=head2 Term::ANSIColor - Color screen output using ANSI escape sequences + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item DIAGNOSTICS + +Bad escape sequence %s, Bareword "%s" not allowed while "strict subs" in +use, Invalid attribute name %s, Name "%s" used only once: possible typo, No +comma allowed after filehandle, No name for escape sequence %s + +=item ENVIRONMENT + +ANSI_COLORS_DISABLED + +=item RESTRICTIONS + +=item NOTES + +=item SEE ALSO + +=item AUTHORS + +=item LICENSE + +=back + +=head2 Term::Cap - Perl termcap interface + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item EXAMPLES + +=back + +=head2 Term::Complete - Perl word completion module + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +EtabE, ^D, ^U, EdelE, EbsE + +=item DIAGNOSTICS + +=item BUGS + +=item AUTHOR + +=back + +=head2 Term::ReadLine - Perl interface to various C packages. If +no real package is found, substitutes stubs instead of basic functions. + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item Minimal set of supported functions + +C, C, C, C, C, $C, +C, C, Attribs, C + +=item Additional supported functions + +C, C, C + +=item EXPORTS + +=item ENVIRONMENT + +=item CAVEATS + +=back + +=head2 Test - provides a simple framework for writing test scripts + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=over 4 + +=item Functions + +B + +=back + +=back + +B<_to_value> + +B + +=over 4 + +=item TEST TYPES + +NORMAL TESTS, SKIPPED TESTS, TODO TESTS + +=item ONFAIL + +=item BUGS and CAVEATS + +=item TODO + +=item SEE ALSO + +=item AUTHOR + +=back + +=head2 Test::Harness - run perl standard test scripts with statistics + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=over 4 + +=item The test script output + +B<'1..M'>, B<'ok', 'not ok'. Ok?>, B, +B<$Test::Harness::verbose>, B<$Test::Harness::switches>, B, +B, B, B, B + +=item Failure + +B, B, B, B, B, B, B + +=item Functions + +B =back -=head2 Term::ANSIColor - Color screen output using ANSI escape sequences +=back -=over 4 +B<_globdir> -=item SYNOPSIS +B<_run_all_tests> -=item DESCRIPTION +B<_mk_leader> -=item DIAGNOSTICS +=over 4 -Invalid attribute name %s, Name "%s" used only once: possible typo, No -comma allowed after filehandle, Bareword "%s" not allowed while "strict -subs" in use +=item EXPORT -=item RESTRICTIONS +=item DIAGNOSTICS -=item NOTES +C, C, C, C, C, C -=item AUTHORS +=item ENVIRONMENT -=back +C, C, C, +C, C, C, +C -=head2 Term::Cap - Perl termcap interface +=item EXAMPLE -=over 4 +=item SEE ALSO -=item SYNOPSIS +=item AUTHORS -=item DESCRIPTION +=item TODO -=item EXAMPLES +=item BUGS =back -=head2 Term::Complete - Perl word completion module +=head2 Test::More - yet another framework for writing test scripts =over 4 @@ -13298,65 +15311,69 @@ subs" in use =item DESCRIPTION -EtabE, ^D, ^U, EdelE, EbsE +=over 4 -=item DIAGNOSTICS +=item I love it when a plan comes together -=item BUGS +=item Test names -=item AUTHOR +=item I'm ok, you're not ok. + +B =back -=head2 Term::ReadLine - Perl interface to various C packages. If -no real package is found, substitutes stubs instead of basic functions. +=back -=over 4 +B, B -=item SYNOPSIS +B -=item DESCRIPTION +B, B -=item Minimal set of supported functions +=over 4 -C, C, C, C, C, $C, -C, C, Attribs, C +=item Module tests -=item Additional supported functions +B, B -C, C, C +=back -=item EXPORTS +=over 4 -=item ENVIRONMENT +=item Conditional tests -=item CAVEATS +B * UNIMPLEMENTED * =back -=head2 Test - provides a simple framework for writing test scripts +B * UNIMPLEMENTED * =over 4 -=item SYNOPSIS +=item Comparision functions -=item DESCRIPTION +B -=item TEST TYPES +=back -NORMAL TESTS, SKIPPED TESTS, TODO TESTS +B -=item RETURN VALUE +B -=item ONFAIL +=over 4 -=item SEE ALSO +=item BUGS and CAVEATS =item AUTHOR +=item HISTORY + +=item SEE ALSO + =back -=head2 Test::Harness - run perl standard test scripts with statistics +=head2 Test::Simple - Basic utilities for writing tests. =over 4 @@ -13364,36 +15381,30 @@ NORMAL TESTS, SKIPPED TESTS, TODO TESTS =item DESCRIPTION -=over 4 +B -=item The test script output +=back -B<'1..M'>, B<'ok', 'not ok'. Ok?>, B, -B<$Test::Harness::verbose>, B<$Test::Harness::switches>, B, -B, B, B +B<_sanity_check> -=back +B<_whoa> -=item EXPORT +B<_my_exit> -=item DIAGNOSTICS +=over 4 -C, C, C, C, C, C +=item EXAMPLE -=item ENVIRONMENT +=item CAVEATS -C, C, C, -C, C, C, -C +=item HISTORY -=item SEE ALSO +=item AUTHOR -=item AUTHORS +=item SEE ALSO -=item BUGS +L, L, L, L, L, +L =back @@ -13544,6 +15555,8 @@ change) =over 4 +=item CAVEAT + =item SYNOPSIS =item DESCRIPTION @@ -13717,6 +15730,33 @@ TIESCALAR classname, LIST, FETCH this, STORE this, value, DESTROY this =back +=head2 Time::HiRes - High resolution ualarm, usleep, and gettimeofday + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +gettimeofday (), usleep ( $useconds ), ualarm ( $useconds [, +$interval_useconds ] ), tv_interval, time (), sleep ( $floating_seconds ), +alarm ( $floating_seconds [, $interval_floating_seconds ] ), setitimer, +getitimer ( $which ) + +=item EXAMPLES + +=item C API + +=item CAVEATS + +=item AUTHORS + +=item REVISION + +=item COPYRIGHT + +=back + =head2 Time::Local - efficiently compute time from local and GMT time =over 4 @@ -13731,6 +15771,90 @@ TIESCALAR classname, LIST, FETCH this, STORE this, value, DESTROY this =back +=head2 Time::Piece - Object Oriented time objects + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item USAGE + +=over 4 + +=item Local Locales + +=item Date Calculations + +=item Date Comparisons + +=item YYYY-MM-DDThh:mm:ss + +=item Week Number + +=item strftime method + +%%, %a, %A, %b, %B, %c, %C, %d, %D, %e, %h, %H, %I, %j, %m, %M, %n, %p, %r, +%R, %S, %t, %T, %u, %U, %V, %w, %W, %x, %y, %Y, %Z + +=item strptime function + +=item Global Overriding + +=back + +=item SEE ALSO + +=item AUTHOR + +=over 4 + +=item License + +=item Bugs + +=back + +=back + +=head2 Time::Piece::Seconds, Time::Seconds - a simple API to convert +seconds to other date values + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item METHODS + +=item AUTHOR + +=item LICENSE + +=item Bugs + +=back + +=head2 Time::Seconds - a simple API to convert seconds to other date values + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item METHODS + +=item AUTHOR + +=item LICENSE + +=item Bugs + +=back + =head2 Time::gmtime - by-name interface to Perl's built-in gmtime() function @@ -13786,6 +15910,94 @@ VAL, TYPE ), UNIVERSAL::can ( VAL, METHOD ) =back +=head2 UnicodeCD - Unicode character database + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=back + +=over 4 + +=item charinfo + +=back + +=over 4 + +=item charblock + +=back + +=over 4 + +=item charscript + +=back + +=over 4 + +=item charblocks + +=back + +=over 4 + +=item charscripts + +=back + +=over 4 + +=item Blocks versus Scripts + +=item Matching Scripts and Blocks + +=item Code Point Arguments + +=item charinrange + +=back + +=over 4 + +=item compexcl + +=back + +=over 4 + +=item casefold + +=back + +=over 4 + +=item casespec + +=back + +=over 4 + +=item UnicodeCD::UnicodeVersion + +=back + +=over 4 + +=item Implementation Note + +=back + +=over 4 + +=item AUTHOR + +=back + =head2 User::grent - by-name interface to Perl's built-in getgr*() functions