=back
-=head2 perlfaq1 - General Questions About Perl ($Revision: 1.12 $, $Date:
-2003/07/09 15:47:28 $)
+=head2 perlfaq1 - General Questions About Perl ($Revision: 1.14 $, $Date:
+2003/11/23 08:02:29 $)
=over 4
=back
-=head2 perlfaq2 - Obtaining and Learning about Perl ($Revision: 1.20 $,
-$Date: 2003/01/26 17:50:56 $)
+=head2 perlfaq2 - Obtaining and Learning about Perl ($Revision: 1.25 $,
+$Date: 2003/10/16 04:57:38 $)
=over 4
=back
-=head2 perlfaq3 - Programming Tools ($Revision: 1.33 $, $Date: 2003/01/31
-17:34:56 $)
+=head2 perlfaq3 - Programming Tools ($Revision: 1.37 $, $Date: 2003/11/24
+19:55:50 $)
=over 4
=back
-=head2 perlfaq4 - Data Manipulation ($Revision: 1.44 $, $Date: 2003/07/28
-17:35:21 $)
+=head2 perlfaq4 - Data Manipulation ($Revision: 1.54 $, $Date: 2003/11/30
+00:50:08 $)
=over 4
=item Why am I getting long decimals (eg, 19.9499999999999) instead of the
numbers I should be getting (eg, 19.95)?
+=item Why is int() broken?
+
=item Why isn't my octal data interpreted correctly?
=item Does Perl have a round() function? What about ceil() and floor()?
Trig functions?
-=item How do I convert between numeric representations?
+=item How do I convert between numeric representations/bases/radixes?
How do I convert hexadecimal into decimal, How do I convert from decimal to
hexadecimal, How do I convert from octal to decimal, How do I convert from
=back
-=head2 perlfaq5 - Files and Formats ($Revision: 1.28 $, $Date: 2003/01/26
-17:45:46 $)
+=head2 perlfaq5 - Files and Formats ($Revision: 1.30 $, $Date: 2003/11/23
+08:07:46 $)
=over 4
=item Are Perl regexes DFAs or NFAs? Are they POSIX compliant?
-=item What's wrong with using grep or map in a void context?
+=item What's wrong with using grep in a void context?
=item How can I match strings with multibyte characters?
=item How do I add the directory my program lives in to the module/library
search path?
-=item How do I add a directory to my include path at runtime?
+=item How do I add a directory to my include path (@INC) at runtime?
=item What is socket.ph and where do I get it?
=item Simple Statements
+=item Truth and Falsehood
+
+=item Statement Modifiers
+
=item Compound Statements
=item Loop Control
=over 4
-=item SYNOPSIS
-
=item DESCRIPTION
=over 4
+=item Operator Precedence and Associativity
+
=item Terms and List Operators (Leftward)
=item The Arrow Operator
FILEHANDLE, stat EXPR, stat, study SCALAR, study, sub NAME BLOCK, sub NAME
(PROTO) BLOCK, sub NAME : ATTRS BLOCK, sub NAME (PROTO) : ATTRS BLOCK,
substr EXPR,OFFSET,LENGTH,REPLACEMENT, substr EXPR,OFFSET,LENGTH, substr
-EXPR,OFFSET, symlink OLDFILE,NEWFILE, syscall LIST, sysopen
+EXPR,OFFSET, symlink OLDFILE,NEWFILE, syscall NUMBER, LIST, sysopen
FILEHANDLE,FILENAME,MODE, sysopen FILEHANDLE,FILENAME,MODE,PERMS, sysread
FILEHANDLE,SCALAR,LENGTH,OFFSET, sysread FILEHANDLE,SCALAR,LENGTH, sysseek
FILEHANDLE,POSITION,WHENCE, system LIST, system PROGRAM LIST, syswrite
=item How to Eat an Egg on a Net
+=item Byte-order modifiers
+
=item Floating point Numbers
=back
=item The Alignment Pit
+=item Dealing with Endian-ness
+
=item Alignment, Take 2
=item Alignment, Take 3
C<=head1 I<Heading Text>>, C<=head2 I<Heading Text>>, C<=head3 I<Heading
Text>>, C<=head4 I<Heading Text>>, C<=over I<indentlevel>>, C<=item
I<stuff...>>, C<=back>, C<=cut>, C<=pod>, C<=begin I<formatname>>, C<=end
-I<formatname>>, C<=for I<formatname> I<text...>>
+I<formatname>>, C<=for I<formatname> I<text...>>, C<=encoding
+I<encodingname>>
=item Formatting Codes
=item Pod Commands
"=head1", "=head2", "=head3", "=head4", "=pod", "=cut", "=over", "=item",
-"=back", "=begin formatname", "=end formatname", "=for formatname text..."
+"=back", "=begin formatname", "=end formatname", "=for formatname text...",
+"=encoding encodingname"
=item Pod Formatting Codes
B<-m>[B<->]I<module>, B<-M>[B<->]I<module>, B<-M>[B<->]I<'module ...'>,
B<-[mM]>[B<->]I<module=arg[,arg]...>, B<-n>, B<-p>, B<-P>, B<-s>, B<-S>,
B<-t>, B<-T>, B<-u>, B<-U>, B<-v>, B<-V>, B<-V:>I<name>, B<-w>, B<-W>,
-B<-X>, B<-x> I<directory>
+B<-X>, B<-x>, B<-x> I<directory>
=back
HOME, LOGDIR, PATH, PERL5LIB, PERL5OPT, PERLIO, :bytes, :crlf, :mmap,
:perlio, :pop, :raw, :stdio, :unix, :utf8, :win32, PERLIO_DEBUG, PERLLIB,
PERL5DB, PERL5SHELL (specific to the Win32 port), PERL_DEBUG_MSTATS,
-PERL_DESTRUCT_LEVEL, PERL_ENCODING, PERL_HASH_SEED, PERL_HASH_SEED_DEBUG,
-PERL_ROOT (specific to the VMS port), PERL_SIGNALS, PERL_UNICODE, SYS$LOGIN
-(specific to the VMS port)
+PERL_DESTRUCT_LEVEL, PERL_DL_NONLAZY, PERL_ENCODING, PERL_HASH_SEED,
+PERL_HASH_SEED_DEBUG, PERL_ROOT (specific to the VMS port), PERL_SIGNALS,
+PERL_UNICODE, SYS$LOGIN (specific to the VMS port)
=back
HANDLE->autoflush(EXPR), $OUTPUT_AUTOFLUSH, $|,
IO::Handle->output_field_separator EXPR, $OUTPUT_FIELD_SEPARATOR, $OFS, $,,
IO::Handle->output_record_separator EXPR, $OUTPUT_RECORD_SEPARATOR, $ORS,
-$\, $LIST_SEPARATOR, $", $SUBSCRIPT_SEPARATOR, $SUBSEP, $;, $OFMT, $#,
+$\, $LIST_SEPARATOR, $", $SUBSCRIPT_SEPARATOR, $SUBSEP, $;, $#,
HANDLE->format_page_number(EXPR), $FORMAT_PAGE_NUMBER, $%,
HANDLE->format_lines_per_page(EXPR), $FORMAT_LINES_PER_PAGE, $=,
HANDLE->format_lines_left(EXPR), $FORMAT_LINES_LEFT, $-, @LAST_MATCH_START,
=over 4
+=item Text Fields
+
+=item Numeric Fields
+
+=item The Field @* for Variable Width Multi-Line Text
+
+=item The Field ^* for Variable Width One-line-at-a-time Text
+
+=item Specifying Values
+
+=item Using Fill Mode
+
+=item Suppressing Lines Where All Fields Are Void
+
+=item Repeating Format Lines
+
+=item Top of Form Processing
+
=item Format Variables
=back
USER, HOME, CLOBBER, LIST, TIEHASH classname, LIST, FETCH this, key, STORE
this, key, value, DELETE this, key, CLEAR this, EXISTS this, key, FIRSTKEY
-this, NEXTKEY this, lastkey, UNTIE this, DESTROY this
+this, NEXTKEY this, lastkey, SCALAR this, UNTIE this, DESTROY this
=item Tying FileHandles
=item Alphabetical Listing of Perl Functions
--I<X> FILEHANDLE, -I<X> EXPR, -I<X>, alarm SECONDS, alarm, binmode
-FILEHANDLE, chmod LIST, chown LIST, chroot FILENAME, chroot, crypt
-PLAINTEXT,SALT, dbmclose HASH, dbmopen HASH,DBNAME,MODE, dump LABEL, exec
-LIST, exit EXPR, exit, fcntl FILEHANDLE,FUNCTION,SCALAR, flock
-FILEHANDLE,OPERATION, fork, getlogin, getpgrp PID, getppid, getpriority
-WHICH,WHO, getpwnam NAME, getgrnam NAME, getnetbyname NAME, getpwuid UID,
-getgrgid GID, getnetbyaddr ADDR,ADDRTYPE, getprotobynumber NUMBER,
-getservbyport PORT,PROTO, getpwent, getgrent, gethostbyname, gethostent,
-getnetent, getprotoent, getservent, sethostent STAYOPEN, setnetent
-STAYOPEN, setprotoent STAYOPEN, setservent STAYOPEN, endpwent, endgrent,
-endhostent, endnetent, endprotoent, endservent, getsockopt
-SOCKET,LEVEL,OPTNAME, glob EXPR, glob, ioctl FILEHANDLE,FUNCTION,SCALAR,
-kill SIGNAL, LIST, link OLDFILE,NEWFILE, lstat FILEHANDLE, lstat EXPR,
-lstat, msgctl ID,CMD,ARG, msgget KEY,FLAGS, msgsnd ID,MSG,FLAGS, msgrcv
-ID,VAR,SIZE,TYPE,FLAGS, open FILEHANDLE,EXPR, open FILEHANDLE, pipe
-READHANDLE,WRITEHANDLE, readlink EXPR, readlink, select
+-I<X> FILEHANDLE, -I<X> EXPR, -I<X>, binmode FILEHANDLE, chmod LIST, chown
+LIST, chroot FILENAME, chroot, crypt PLAINTEXT,SALT, dbmclose HASH, dbmopen
+HASH,DBNAME,MODE, dump LABEL, exec LIST, exit EXPR, exit, fcntl
+FILEHANDLE,FUNCTION,SCALAR, flock FILEHANDLE,OPERATION, fork, getlogin,
+getpgrp PID, getppid, getpriority WHICH,WHO, getpwnam NAME, getgrnam NAME,
+getnetbyname NAME, getpwuid UID, getgrgid GID, getnetbyaddr ADDR,ADDRTYPE,
+getprotobynumber NUMBER, getservbyport PORT,PROTO, getpwent, getgrent,
+gethostbyname, gethostent, getnetent, getprotoent, getservent, sethostent
+STAYOPEN, setnetent STAYOPEN, setprotoent STAYOPEN, setservent STAYOPEN,
+endpwent, endgrent, endhostent, endnetent, endprotoent, endservent,
+getsockopt SOCKET,LEVEL,OPTNAME, glob EXPR, glob, ioctl
+FILEHANDLE,FUNCTION,SCALAR, kill SIGNAL, LIST, link OLDFILE,NEWFILE, lstat
+FILEHANDLE, lstat EXPR, lstat, msgctl ID,CMD,ARG, msgget KEY,FLAGS, msgsnd
+ID,MSG,FLAGS, msgrcv ID,VAR,SIZE,TYPE,FLAGS, open FILEHANDLE,EXPR, open
+FILEHANDLE, pipe READHANDLE,WRITEHANDLE, readlink EXPR, readlink, select
RBITS,WBITS,EBITS,TIMEOUT, semctl ID,SEMNUM,CMD,ARG, semget
KEY,NSEMS,FLAGS, semop KEY,OPSTRING, setgrent, setpgrp PID,PGRP,
setpriority WHICH,WHO,PRIORITY, setpwent, setsockopt
=item Important Caveats
Input and Output Layers, Regular Expressions, C<use utf8> still needed to
-enable UTF-8/UTF-EBCDIC in scripts
+enable UTF-8/UTF-EBCDIC in scripts, BOM-marked scripts and UTF-16 scripts
+autodetected, C<use encoding> needed to upgrade non-Latin-1 byte strings
=item Byte and Character Semantics
=item Switches On the "#!" Line
+=item Taint mode and @INC
+
=item Cleaning Up Your Path
=item Security Bugs
=item Symbol Tables
-=item Package Constructors and Destructors
+=item BEGIN, CHECK, INIT and END
=item Perl Classes
B::Terse, B::Xref, Benchmark, ByteLoader, CGI, CGI::Apache, CGI::Carp,
CGI::Cookie, CGI::Fast, CGI::Pretty, CGI::Push, CGI::Switch, CGI::Util,
CPAN, CPAN::FirstTime, CPAN::Nox, Carp, Carp::Heavy, Class::ISA,
-Class::Struct, Config, Cwd, DB, DB_File, Data::Dumper, Devel::DProf,
-Devel::PPPort, Devel::Peek, Devel::SelfStubber, Digest, Digest::MD5,
-DirHandle, Dumpvalue, DynaLoader, Encode, Encode::Alias, Encode::Byte,
-Encode::CJKConstants, Encode::CN, Encode::CN::HZ, Encode::Config,
-Encode::EBCDIC, Encode::Encoder, Encode::Encoding, Encode::Guess,
-Encode::JP, Encode::JP::H2Z, Encode::JP::JIS7, Encode::KR,
-Encode::KR::2022_KR, Encode::MIME::Header, Encode::PerlIO,
-Encode::Supported, Encode::Symbol, Encode::TW, Encode::Unicode,
-Encode::Unicode::UTF7, English, Env, Errno, Exporter, Exporter::Heavy,
-ExtUtils::Command, ExtUtils::Command::MM, ExtUtils::Constant,
-ExtUtils::Embed, ExtUtils::Install, ExtUtils::Installed, ExtUtils::Liblist,
-ExtUtils::MM, ExtUtils::MM_Any, ExtUtils::MM_BeOS, ExtUtils::MM_Cygwin,
-ExtUtils::MM_DOS, ExtUtils::MM_MacOS, ExtUtils::MM_NW5, ExtUtils::MM_OS2,
-ExtUtils::MM_UWIN, ExtUtils::MM_Unix, ExtUtils::MM_VMS, ExtUtils::MM_Win32,
+Class::Struct, Config, Cwd, DB, DBM_Filter, DB_File, Data::Dumper,
+Devel::DProf, Devel::PPPort, Devel::Peek, Devel::SelfStubber, Digest,
+Digest::MD5, Digest::base, DirHandle, Dumpvalue, DynaLoader, Encode,
+Encode::Alias, Encode::Byte, Encode::CJKConstants, Encode::CN,
+Encode::CN::HZ, Encode::Config, Encode::EBCDIC, Encode::Encoder,
+Encode::Encoding, Encode::Guess, Encode::JP, Encode::JP::H2Z,
+Encode::JP::JIS7, Encode::KR, Encode::KR::2022_KR, Encode::MIME::Header,
+Encode::PerlIO, Encode::Supported, Encode::Symbol, Encode::TW,
+Encode::Unicode, Encode::Unicode::UTF7, English, Env, Errno, Exporter,
+Exporter::Heavy, ExtUtils::Command, ExtUtils::Command::MM,
+ExtUtils::Constant, ExtUtils::Embed, ExtUtils::Install,
+ExtUtils::Installed, ExtUtils::Liblist, ExtUtils::MM, ExtUtils::MM_Any,
+ExtUtils::MM_BeOS, ExtUtils::MM_Cygwin, ExtUtils::MM_DOS,
+ExtUtils::MM_MacOS, ExtUtils::MM_NW5, ExtUtils::MM_OS2, ExtUtils::MM_UWIN,
+ExtUtils::MM_Unix, ExtUtils::MM_VMS, ExtUtils::MM_Win32,
ExtUtils::MM_Win95, ExtUtils::MY, ExtUtils::MakeMaker,
ExtUtils::MakeMaker::FAQ, ExtUtils::MakeMaker::Tutorial,
ExtUtils::MakeMaker::bytes, ExtUtils::MakeMaker::vmsish,
Locale::Currency, Locale::Language, Locale::Maketext,
Locale::Maketext::TPJ13, Locale::Script, MIME::Base64,
MIME::Base64::QuotedPrint, Math::BigFloat, Math::BigInt,
-Math::BigInt::Calc, Math::BigInt::Scalar, Math::BigRat, Math::Complex,
+Math::BigInt::Calc, Math::BigInt::CalcEmu, Math::BigRat, Math::Complex,
Math::Trig, Memoize, Memoize::AnyDBM_File, Memoize::Expire,
Memoize::ExpireFile, Memoize::ExpireTest, Memoize::NDBM_File,
Memoize::SDBM_File, Memoize::Storable, NDBM_File, NEXT, Net::Cmd,
=item Asia
China, Indonesia, Israel, Japan, Malaysia, Russian Federation, Saudi
-Arabia, Singapore, South Korea, Taiwan
+Arabia, Singapore, South Korea, Taiwan, Thailand
=item Central America
=item Europe
-Austria, Belgium, Bulgaria, Croatia, Czech Republic, Denmark, Estonia,
-Finland, France, Germany, Greece, Hungary, Iceland, Ireland, Italy, Latvia,
-Lithuania, Netherlands, Norway, Poland, Portugal, Romania, Russia,
-Slovakia, Slovenia, Spain, Sweden, Switzerland, Turkey, Ukraine, United
-Kingdom
+Austria, Belgium, Bosnia and Herzegovina, Bulgaria, Croatia, Czech
+Republic, Denmark, Estonia, Finland, France, Germany, Greece, Hungary,
+Iceland, Ireland, Italy, Latvia, Lithuania, Netherlands, Norway, Poland,
+Portugal, Romania, Russia, Slovakia, Slovenia, Spain, Sweden, Switzerland,
+Turkey, Ukraine, United Kingdom
=item North America
Canada, Alberta, Manitoba, Nova Scotia, Ontario, Mexico, United States,
Alabama, California, Colorado, Delaware, District of Columbia, Florida,
-Illinois, Indiana, Kentucky, Massachusetts, Michigan, Nevada, New Jersey,
-New York, North Carolina, Oklahoma, Oregon, Pennsylvania, Tennessee, Texas,
-Utah, Virginia, Washington, Wisconsin
+Indiana, Kentucky, Massachusetts, Michigan, Nevada, New Jersey, New York,
+North Carolina, Oklahoma, Oregon, Pennsylvania, Tennessee, Texas, Utah,
+Virginia, Washington, Wisconsin
=item Oceania
=item The RETVAL Variable
+=item Returning SVs, AVs and HVs through RETVAL
+
=item The MODULE Keyword
=item The PACKAGE Keyword
=item Internal Functions
-A, p, d, s, n, r, f, M, o, j, x
+A, p, d, s, n, r, f, M, o, x, m, X, E, b
=over 4
=item What B<is> Unicode, anyway?
-=item How can I recognise a UTF8 string?
+=item How can I recognise a UTF-8 string?
-=item How does UTF8 represent Unicode characters?
+=item How does UTF-8 represent Unicode characters?
-=item How does Perl store UTF8 strings?
+=item How does Perl store UTF-8 strings?
-=item How do I convert a string to UTF8?
+=item How do I convert a string to UTF-8?
=item Is there anything else I need to know?
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,
-get_av, newAV, Nullav, sortsv
+get_av, newAV, sortsv
=item Callback Functions
=item CV Manipulation Functions
-CvSTASH, get_cv, Nullcv
+CvSTASH, get_cv
=item Embedding Functions
=item Handy Values
-HEf_SVKEY, Nullch, Nullsv
+Nullav, Nullch, Nullcv, Nullhv, Nullsv
=item Hash Manipulation Functions
-get_hv, 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_iternext_flags, hv_iterval,
-hv_magic, hv_store, hv_store_ent, hv_undef, newHV, Nullhv
+get_hv, HEf_SVKEY, HeHASH, HeKEY, HeKLEN, HePV, HeSVKEY, HeSVKEY_force,
+HeSVKEY_set, HeVAL, HvNAME, hv_assert, hv_clear, hv_clear_placeholders,
+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_iternext_flags, hv_iterval, hv_magic, hv_scalar, hv_store, hv_store_ent,
+hv_undef, newHV
=item Magical Functions
mg_clear, mg_copy, mg_find, mg_free, mg_get, mg_length, mg_magical, mg_set,
SvGETMAGIC, SvLOCK, SvSETMAGIC, SvSetMagicSV, SvSetMagicSV_nosteal,
-SvSetSV, SvSetSV_nosteal, SvSHARE
+SvSetSV, SvSetSV_nosteal, SvSHARE, SvUNLOCK
=item Memory Management
-Copy, Move, New, Newc, NEWSV, Newz, Poison, Renew, Renewc, Safefree,
-savepv, savepvn, savesharedpv, StructCopy, Zero
+Copy, CopyD, Move, MoveD, New, Newc, Newz, Poison, Renew, Renewc, Safefree,
+savepv, savepvn, savesharedpv, StructCopy, Zero, ZeroD
=item Miscellaneous Functions
fbm_compile, fbm_instr, form, getcwd_sv, new_version, scan_version, strEQ,
strGE, strGT, strLE, strLT, strNE, strnEQ, strnNE, sv_nolocking,
-sv_nosharing, sv_nounlocking, upg_version, vcmp, vnumify, vstringify
+sv_nosharing, sv_nounlocking, upg_version, vcmp, vnormal, vnumify,
+vstringify
=item Numeric functions
=item Stack Manipulation Macros
-dMARK, dORIGMARK, dSP, EXTEND, MARK, ORIGMARK, POPi, POPl, POPn, POPp,
-POPpbytex, POPpx, POPs, PUSHi, PUSHMARK, PUSHn, PUSHp, PUSHs, PUSHu,
-PUTBACK, SP, SPAGAIN, XPUSHi, XPUSHn, XPUSHp, XPUSHs, XPUSHu, XSRETURN,
-XSRETURN_IV, XSRETURN_NO, XSRETURN_NV, XSRETURN_PV, XSRETURN_UNDEF,
-XSRETURN_YES, XST_mIV, XST_mNO, XST_mNV, XST_mPV, XST_mUNDEF, XST_mYES
+dMARK, dORIGMARK, dSP, EXTEND, MARK, mPUSHi, mPUSHn, mPUSHp, mPUSHu,
+mXPUSHi, mXPUSHn, mXPUSHp, mXPUSHu, ORIGMARK, POPi, POPl, POPn, POPp,
+POPpbytex, POPpx, POPs, PUSHi, PUSHMARK, PUSHmortal, PUSHn, PUSHp, PUSHs,
+PUSHu, PUTBACK, SP, SPAGAIN, XPUSHi, XPUSHmortal, XPUSHn, XPUSHp, XPUSHs,
+XPUSHu, XSRETURN, XSRETURN_EMPTY, XSRETURN_IV, XSRETURN_NO, XSRETURN_NV,
+XSRETURN_PV, XSRETURN_UNDEF, XSRETURN_UV, XSRETURN_YES, XST_mIV, XST_mNO,
+XST_mNV, XST_mPV, XST_mUNDEF, XST_mYES
=item SV Flags
=item SV Manipulation Functions
-get_sv, looks_like_number, newRV_inc, newRV_noinc, newSV, newSViv, newSVnv,
-newSVpv, newSVpvf, newSVpvn, newSVpvn_share, newSVrv, newSVsv, newSVuv,
-SvCUR, SvCUR_set, SvEND, SvGROW, SvIOK, SvIOKp, SvIOK_notUV, SvIOK_off,
-SvIOK_on, SvIOK_only, SvIOK_only_UV, SvIOK_UV, SvIsCOW,
-SvIsCOW_shared_hash, SvIV, SvIVx, SvIVX, SvLEN, SvNIOK, SvNIOKp,
+get_sv, looks_like_number, newRV_inc, newRV_noinc, NEWSV, newSV, newSViv,
+newSVnv, newSVpv, newSVpvf, newSVpvn, newSVpvn_share, newSVrv, newSVsv,
+newSVuv, SvCUR, SvCUR_set, SvEND, SvGROW, SvIOK, SvIOKp, SvIOK_notUV,
+SvIOK_off, SvIOK_on, SvIOK_only, SvIOK_only_UV, SvIOK_UV, SvIsCOW,
+SvIsCOW_shared_hash, SvIV, SvIVx, SvIVX, SvIV_nomg, SvLEN, SvNIOK, SvNIOKp,
SvNIOK_off, SvNOK, SvNOKp, SvNOK_off, SvNOK_on, SvNOK_only, SvNV, SvNVX,
SvNVx, SvOK, SvOOK, SvPOK, SvPOKp, SvPOK_off, SvPOK_on, SvPOK_only,
SvPOK_only_UTF8, SvPV, SvPVbyte, SvPVbytex, SvPVbytex_force,
SvPVbyte_force, SvPVbyte_nolen, SvPVutf8, SvPVutf8x, SvPVutf8x_force,
SvPVutf8_force, SvPVutf8_nolen, SvPVx, SvPVX, SvPV_force, SvPV_force_nomg,
-SvPV_nolen, SvREFCNT, SvREFCNT_dec, SvREFCNT_inc, SvROK, SvROK_off,
-SvROK_on, SvRV, SvSTASH, SvTAINT, SvTAINTED, SvTAINTED_off, SvTAINTED_on,
-SvTRUE, SvTYPE, SvUNLOCK, SvUOK, SvUPGRADE, SvUTF8, SvUTF8_off, SvUTF8_on,
-SvUV, SvUVX, SvUVx, SvVOK, sv_2bool, sv_2cv, sv_2io, sv_2iv, sv_2mortal,
-sv_2nv, sv_2pvbyte, sv_2pvbyte_nolen, sv_2pvutf8, sv_2pvutf8_nolen,
-sv_2pv_flags, sv_2pv_nolen, sv_2uv, sv_backoff, sv_bless, sv_catpv,
-sv_catpvf, sv_catpvf_mg, sv_catpvn, sv_catpvn_flags, sv_catpvn_mg,
-sv_catpv_mg, sv_catsv, sv_catsv_flags, sv_catsv_mg, sv_chop, sv_clear,
-sv_cmp, sv_cmp_locale, sv_collxfrm, sv_copypv, sv_dec, sv_derived_from,
-sv_eq, sv_force_normal, sv_force_normal_flags, sv_free, sv_gets, sv_grow,
-sv_inc, sv_insert, sv_isa, sv_isobject, sv_iv, sv_len, sv_len_utf8,
-sv_magic, sv_magicext, sv_mortalcopy, sv_newmortal, sv_newref, sv_nv,
-sv_pos_b2u, sv_pos_u2b, sv_pv, sv_pvbyte, sv_pvbyten, sv_pvbyten_force,
-sv_pvn, sv_pvn_force, sv_pvn_force_flags, sv_pvutf8, sv_pvutf8n,
-sv_pvutf8n_force, sv_reftype, sv_replace, sv_report_used, sv_reset,
-sv_rvweaken, sv_setiv, sv_setiv_mg, sv_setnv, sv_setnv_mg, sv_setpv,
-sv_setpvf, sv_setpvf_mg, sv_setpviv, sv_setpviv_mg, sv_setpvn,
+SvPV_nolen, SvPV_nomg, SvREFCNT, SvREFCNT_dec, SvREFCNT_inc, SvROK,
+SvROK_off, SvROK_on, SvRV, SvSTASH, SvTAINT, SvTAINTED, SvTAINTED_off,
+SvTAINTED_on, SvTRUE, SvTYPE, SvUOK, SvUPGRADE, SvUTF8, SvUTF8_off,
+SvUTF8_on, SvUV, SvUVX, SvUVx, SvUV_nomg, SvVOK, sv_2bool, sv_2cv, sv_2io,
+sv_2iv_flags, sv_2mortal, sv_2nv, sv_2pvbyte, sv_2pvbyte_nolen, sv_2pvutf8,
+sv_2pvutf8_nolen, sv_2pv_flags, sv_2pv_nolen, sv_2uv_flags, sv_backoff,
+sv_bless, sv_catpv, sv_catpvf, sv_catpvf_mg, sv_catpvn, sv_catpvn_flags,
+sv_catpvn_mg, sv_catpv_mg, sv_catsv, sv_catsv_flags, sv_catsv_mg, sv_chop,
+sv_clear, sv_cmp, sv_cmp_locale, sv_collxfrm, sv_copypv, sv_dec,
+sv_derived_from, sv_eq, sv_force_normal, sv_force_normal_flags, sv_free,
+sv_gets, sv_grow, sv_inc, sv_insert, sv_isa, sv_isobject, sv_iv, sv_len,
+sv_len_utf8, sv_magic, sv_magicext, sv_mortalcopy, sv_newmortal, sv_newref,
+sv_nv, sv_pos_b2u, sv_pos_u2b, sv_pv, sv_pvbyte, sv_pvbyten,
+sv_pvbyten_force, sv_pvn, sv_pvn_force, sv_pvn_force_flags, sv_pvutf8,
+sv_pvutf8n, sv_pvutf8n_force, sv_reftype, sv_replace, sv_report_used,
+sv_reset, sv_rvweaken, sv_setiv, sv_setiv_mg, sv_setnv, sv_setnv_mg,
+sv_setpv, sv_setpvf, sv_setpvf_mg, sv_setpviv, sv_setpviv_mg, sv_setpvn,
sv_setpvn_mg, sv_setpv_mg, sv_setref_iv, sv_setref_nv, sv_setref_pv,
sv_setref_pvn, sv_setref_uv, sv_setsv, sv_setsv_flags, sv_setsv_mg,
sv_setuv, sv_setuv_mg, sv_taint, sv_tainted, sv_true, sv_unmagic, sv_unref,
=item Unicode Support
bytes_from_utf8, bytes_to_utf8, ibcmp_utf8, is_utf8_char, is_utf8_string,
-pv_uni_display, sv_cat_decode, sv_recode_to_utf8, sv_uni_display,
-to_utf8_case, to_utf8_fold, to_utf8_lower, to_utf8_title, to_utf8_upper,
-utf8n_to_uvchr, utf8n_to_uvuni, utf8_distance, utf8_hop, utf8_length,
-utf8_to_bytes, utf8_to_uvchr, utf8_to_uvuni, uvchr_to_utf8,
+is_utf8_string_loc, pv_uni_display, sv_cat_decode, sv_recode_to_utf8,
+sv_uni_display, to_utf8_case, to_utf8_fold, to_utf8_lower, to_utf8_title,
+to_utf8_upper, utf8n_to_uvchr, utf8n_to_uvuni, utf8_distance, utf8_hop,
+utf8_length, utf8_to_bytes, utf8_to_uvchr, utf8_to_uvuni, uvchr_to_utf8,
uvuni_to_utf8_flags
=item Variables created by C<xsubpp> and C<xsubpp> internal functions
-ax, CLASS, dAX, dITEMS, dXSARGS, dXSI32, items, ix, newXSproto, RETVAL, ST,
-THIS, XS, XSRETURN_EMPTY, XS_VERSION, XS_VERSION_BOOTCHECK
+ax, CLASS, dAX, dITEMS, dUNDERBAR, dXSARGS, dXSI32, items, ix, newXSproto,
+RETVAL, ST, THIS, UNDERBAR, XS, XS_VERSION, XS_VERSION_BOOTCHECK
=item Warning and Dieing
CX_CURPAD_SAVE, CX_CURPAD_SV, PAD_BASE_SV, PAD_CLONE_VARS,
PAD_COMPNAME_FLAGS, PAD_COMPNAME_GEN, PAD_COMPNAME_OURSTASH,
PAD_COMPNAME_PV, PAD_COMPNAME_TYPE, PAD_DUP, PAD_RESTORE_LOCAL,
-PAD_SAVE_LOCAL, PAD_SAVE_SETNULLPAD, PAD_SETSV, PAD_SET_CUR, PAD_SV,
-PAD_SVl, SAVECLEARSV, SAVECOMPPAD, SAVEPADSV
+PAD_SAVE_LOCAL, PAD_SAVE_SETNULLPAD, PAD_SETSV, PAD_SET_CUR,
+PAD_SET_CUR_NOSAVE, PAD_SV, PAD_SVl, SAVECLEARSV, SAVECOMPPAD, SAVEPADSV
=item Functions in file pp_ctl.c
=item SV Manipulation Functions
-report_uninit, sv_add_arena, sv_clean_all, sv_clean_objs, sv_free_arenas
+find_uninit_var, report_uninit, sv_add_arena, sv_clean_all, sv_clean_objs,
+sv_free_arenas
=item AUTHORS
=item History and Background
+=item Basic Structure
+
=item Layers vs Disciplines
=item Data Structures
Error, Clearerr, Setlinebuf, Get_base, Get_bufsiz, Get_ptr, Get_cnt,
Set_ptrcnt
+=item Utilities
+
=item Implementing PerlIO Layers
C implementations, Perl implementations
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 Working with the source
+
=item Perlbug administration
=item Submitting patches
=item Special Make Test Targets
-coretest, test.deparse, minitest, test.valgrind check.valgrind
-utest.valgrind ucheck.valgrind, test.third check.third utest.third
-ucheck.third, test.torture torturetest, utest ucheck test.utf8 check.utf8,
-test_harness
+coretest, test.deparse, test.taintwarn, minitest, test.valgrind
+check.valgrind utest.valgrind ucheck.valgrind, test.third check.third
+utest.third ucheck.third, test.torture torturetest, utest ucheck test.utf8
+check.utf8, test_harness
=item Running tests by hand
=item DESCRIPTION
-=item To do during 5.6.x
+=item assertions
-=over 4
+=item iCOW
-=item Support for I/O disciplines
+=item (?{...}) closures in regexps
-=item Autoload bytes.pm
+=item A re-entrant regexp engine
-=item Make "\u{XXXX}" et al work
+=item pragmata
-=item Create a char *sv_pvprintify(sv, STRLEN *lenp, UV flags)
+=over 4
-=item Overloadable regex assertions
+=item lexical pragmas
-=item Unicode
+=item use less 'memory'
-=item Work out exit/die semantics for threads
+=back
-=item Better support for nonpreemptive threading systems like GNU pth
+=item prototypes and functions
-=item Typed lexicals for compiler
+=over 4
-=item Compiler workarounds for Win32
+=item _ prototype character
-=item AUTOLOADing in the compiler
+=item inlining autoloaded constants
-=item Fixing comppadlist when compiling
+=item Finish off lvalue functions
-=item Cleaning up exported namespace
+=back
-=item Complete signal handling
+=item Unicode and UTF8
-=item Out-of-source builds
+=over 4
-=item POSIX realtime support
+=item Implicit Latin 1 => Unicode translation
-=item UNIX98 support
+=item UTF8 caching code
-=item IPv6 Support
+=item Unicode in Filenames
-=item Long double conversion
+=item Unicode in %ENV
-=item Locales
+=back
-=item Arithmetic on non-Arabic numerals
+=item Regexps
-=item POSIX Unicode character classes
+=over 4
-=item Factoring out common suffices/prefices in regexps (trie optimization)
+=item regexp optimiser optional
-=item Security audit shipped utilities
+=item common suffices/prefices in regexps (trie optimization)
-=item Sort out the uid-setting mess
+=back
-=item Custom opcodes
+=item POD
-=item DLL Versioning
+=over 4
-=item Introduce @( and @)
+=item POD -> HTML conversion still sucks
-=item Floating point handling
+=back
+
+=item Misc medium sized projects
+
+=over 4
-=item IV/UV preservation
+=item UNITCHECK
-=item Replace pod2html with something using Pod::Parser
+=item optional optimizer
-=item Automate module testing on CPAN
+=item You WANT *how* many
-=item sendmsg and recvmsg
+=item lexical aliases
-=item Rewrite perlre documentation
+=item no 6
-=item Convert example code to IO::Handle filehandles
+=item IPv6
-=item Document Win32 choices
+=item entersub XS vs Perl
-=item Check new modules
+=item @INC source filter to Filter::Simple
-=item Make roffitall find pods and libs itself
+=item bincompat functions
+
+=item Use fchown/fchmod internally
=back
-=item To do at some point
+=item Tests
=over 4
-=item Remove regular expression recursion
+=item Make Schwern poorer
+
+=item test B
-=item Memory leaks after failed eval
+=item Improve tests for Config.pm
-=item bitfields in pack
+=item common test code for timed bailout
-=item Cross compilation
+=back
-=item Perl preprocessor / macros
+=item Installation
-=item Perl lexer in Perl
+=over 4
-=item Using POSIX calls internally
+=item compressed man pages
-=item -i rename file when changed
+=item Make Config.pm cope with differences between build and installed perl
-=item All ARGV input should act like E<lt>E<gt>
+=item Relocatable perl
-=item Support for rerunning debugger
+=item make HTML install work
-=item Test Suite for the Debugger
+=item put patchlevel in -v
-=item my sub foo { }
+=back
-=item One-pass global destruction
+=item Incremental things
-=item Rewrite regexp parser
+=over 4
-=item Cache recently used regexps
+=item autovivification
-=item Cross-compilation support
+=item fix tainting bugs
-=item Bit-shifting bitvectors
+=item Make tainting consistent
-=item debugger pragma
+=item Dual life everything
-=item use less pragma
+=back
-=item switch structures
+=item Vague things
-=item Cache eval tree
+=over 4
-=item rcatmaybe
+=item threads
-=item Shrink opcode tables
+=item POSIX memory footprint
=item Optimize away @_
-=item Prototypes versus indirect objects
+=item switch ops
+
+=item Attach/detach debugger from running program
+
+=item A decent benchmark
+
+=back
+
+=back
+
+=head2 perldoc - Look up Perl documentation in Pod format.
-=item Install HTML
+=over 4
-=item Prototype method calls
+=item SYNOPSIS
-=item Return context prototype declarations
+=item DESCRIPTION
-=item magic_setisa
+=item OPTIONS
-=item Garbage collection
+B<-h>, B<-v>, B<-t>, B<-u>, B<-m> I<module>, B<-l>, B<-F>, B<-f>
+I<perlfunc>, B<-q> I<perlfaq-search-regexp>, B<-T>, B<-d>
+I<destination-filename>, B<-o> I<output-formatname>, B<-M> I<module-name>,
+B<-w> I<option:value> or B<-w> I<option>, B<-X>,
+B<PageName|ModuleName|ProgramName>, B<-n> I<some-formatter>, B<-r>, B<-i>,
+B<-V>
-=item IO tutorial
+=item SECURITY
-=item Rewrite perldoc
+=item ENVIRONMENT
-=item Install .3p manpages
+=item AUTHOR
-=item Unicode tutorial
+=back
-=item Update POSIX.pm for 1003.1-2
+=head2 perlhist - the Perl history records
-=item Retargetable installation
+=over 4
-=item POSIX emulation on non-POSIX systems
+=item DESCRIPTION
-=item Rename Win32 headers
+=item INTRODUCTION
-=item Finish off lvalue functions
+=item THE KEEPERS OF THE PUMPKIN
-=item Update sprintf documentation
+=over 4
-=item Use fchown/fchmod internally
+=item PUMPKIN?
-=item Make v-strings overloaded objects
+=back
-=item Allow restricted hash assignment
+=item THE RECORDS
-=item Should overload be inheritable?
+=over 4
-=item Taint rethink
+=item SELECTED RELEASE SIZES
-=item Perform correctly when XSUBs call subroutines that exit via
-goto(LABEL) and friends
+=item SELECTED PATCH SIZES
=back
-=item Vague ideas
+=item THE KEEPERS OF THE RECORDS
+
+=back
+
+=head2 perldelta - what is new for perl v5.9.2
=over 4
-=item ref() in list context
+=item DESCRIPTION
-=item Make tr/// return histogram of characters in list context
+=item Incompatible Changes
-=item Compile to real threaded code
+=item Core Enhancements
-=item Structured types
+=item Modules and Pragmata
-=item Modifiable $1 et al.
+=item Utility Changes
-=item Procedural interfaces for IO::*, etc.
+=item Documentation
-=item RPC modules
+=item Performance Enhancements
-=item Attach/detach debugger from running program
+=item Installation and Configuration Improvements
+
+=item Selected Bug Fixes
+
+=item New or Changed Diagnostics
+
+=item Changed Internals
+
+=item Known Problems
+
+=over 4
+
+=item Platform Specific Problems
+
+=back
+
+=item Reporting Bugs
+
+=item SEE ALSO
+
+=back
+
+=head2 perl592delta, perldelta - what is new for perl v5.9.2
+
+=over 4
+
+=item DESCRIPTION
+
+=item Incompatible Changes
-=item GUI::Native
+=item Core Enhancements
+
+=item Modules and Pragmata
+
+=item Utility Changes
-=item foreach(reverse ...)
+=item Documentation
-=item Constant function cache
+=item Performance Enhancements
-=item Approximate regular expression matching
+=item Installation and Configuration Improvements
+
+=item Selected Bug Fixes
+
+=item New or Changed Diagnostics
+
+=item Changed Internals
+
+=item Known Problems
+
+=over 4
+
+=item Platform Specific Problems
=back
-=item Ongoing
+=item Reporting Bugs
+
+=item SEE ALSO
+
+=back
+
+=head2 perl591delta, perldelta - what is new for perl v5.9.1
=over 4
-=item Update guts documentation
+=item DESCRIPTION
-=item Add more tests
+=item Incompatible Changes
-=item Update auxiliary tools
+=over 4
-=item Create debugging macros
+=item substr() lvalues are no longer fixed-length
-=item truncate to the people
+=item The C<:unique> attribute is only meaningful for globals
-=item Unicode in Filenames
+=back
+
+=item Core Enhancements
+
+=over 4
+
+=item Lexical C<$_>
+
+=item Tied hashes in scalar context
+
+=item Formats
+
+=item Stacked filetest operators
=back
-=item Unicode in %ENV
+=item Modules and Pragmata
+
+Benchmark, Carp, Exporter, FindBin, List::Util, threads::shared
+
+=item Utility Changes
+
+=item Documentation
+
+=item Performance Enhancements
+
+=item Selected Bug Fixes
+
+=over 4
+
+=item UTF-8 bugs
-=item Recently done things
+=item Threading bugs
+
+=item More bugs
+
+=back
+
+=item New or Changed Diagnostics
+
+=item Changed Internals
=over 4
-=item Alternative RE syntax module
+=item Reordering of SVt_* constants
-=item Safe signal handling
+=item Removal of CPP symbols
-=item Tie Modules
+=item Less space is used by ops
-=item gettimeofday
+=item New parser
-=item setitimer and getimiter
+=back
-=item Testing __DIE__ hook
+=item Configuration and Building
-=item CPP equivalent in Perl
+=item Known Problems
-=item Explicit switch statements
+=over 4
-=item autocroak
+=item Platform Specific Problems
-=item UTF/EBCDIC
+=back
-=item UTF Regexes
+=item To-do for perl 5.10.0
-=item perlcc to produce executable
+=item Reporting Bugs
-=item END blocks saved in compiled output
+=item SEE ALSO
-=item Secure temporary file module
+=back
-=item Integrate Time::HiRes
+=head2 perl590delta, perldelta - what is new for perl v5.9.0
-=item Turn Cwd into XS
+=over 4
-=item Mmap for input
+=item DESCRIPTION
-=item Byte to/from UTF8 and UTF8 to/from local conversion
+=item Incompatible Changes
-=item Add sockatmark support
+=over 4
-=item Mailing list archives
+=item Hash Randomisation
-=item Bug tracking
+=item UTF-8 On Filehandles No Longer Activated By Locale
-=item Integrate MacPerl
+=item Single-number v-strings are no longer v-strings before "=>"
-=item Web "nerve center" for Perl
+=item (Win32) The -C Switch Has Been Repurposed
-=item Regular expression tutorial
+=item (Win32) The /d Switch Of cmd.exe
-=item Debugging Tutorial
+=item The C<$*> variable has been removed
-=item Integrate new modules
+=back
-=item Integrate profiler
+=item Core Enhancements
-=item Y2K error detection
+=over 4
-=item Regular expression debugger
+=item Assertions
-=item POD checker
+=item Defined-or operators
-=item "Dynamic" lexicals
+=item UTF-8 no longer default under UTF-8 locales
-=item Cache precompiled modules
+=item Unsafe signals again available
+
+=item Tied Arrays with Negative Array Indices
+
+=item local ${$x}
+
+=item Unicode Character Database 4.0.0
+
+=item Miscellaneous Enhancements
=back
-=item Deprecated Wishes
+=item Modules and Pragmata
=over 4
-=item Loop control on do{}
+=item Updated Modules And Pragmata
-=item Lexically scoped typeglobs
+base, B::Bytecode, B::Concise, B::Deparse, Benchmark, ByteLoader, bytes,
+CGI, charnames, CPAN, Data::Dumper, DB_File, Devel::PPPort, Digest::MD5,
+Encode, fields, libnet, Math::BigInt, MIME::Base64, NEXT, Net::Ping,
+PerlIO::scalar, podlators, Pod::LaTeX, PodParsers, Pod::Perldoc,
+Scalar::Util, Storable, strict, Term::ANSIcolor, Test::Harness, Test::More,
+Test::Simple, Text::Balanced, Time::HiRes, threads, threads::shared,
+Unicode::Collate, Unicode::Normalize, Win32::GetFolderPath,
+Win32::GetOSVersion
-=item format BOTTOM
+=back
-=item report HANDLE
+=item Utility Changes
-=item Generalised want()/caller())
+=item New Documentation
+
+=item Performance Enhancements
-=item Named prototypes
+=item Installation and Configuration Improvements
-=item Built-in globbing
+=over 4
-=item Regression tests for suidperl
+=item Platform-specific enhancements
-=item Cached hash values
+=back
-=item Add compression modules
+=item Selected Bug Fixes
-=item Reorganise documentation into tutorials/references
+=over 4
+
+=item Closures, eval and lexicals
+
+=item Generic fixes
+
+=item Platform-specific fixes
+
+=back
+
+=item New or Changed Diagnostics
-=item Remove distinction between functions and operators
+=over 4
-=item Make XS easier to use
+=item Changed "A thread exited while %d threads were running"
-=item Make embedding easier to use
+=item Removed "Attempt to clear a restricted hash"
-=item man for perl
+=item New "Illegal declaration of anonymous subroutine"
-=item my $Package::variable
+=item Changed "Invalid range "%s" in transliteration operator"
-=item "or" tests defined, not truth
+=item New "Missing control char name in \c"
-=item "class"-based lexicals
+=item New "Newline in left-justified string for %s"
-=item byteperl
+=item New "Possible precedence problem on bitwise %c operator"
-=item Lazy evaluation / tail recursion removal
+=item New "read() on %s filehandle %s"
-=item Make "use utf8" the default
+=item New "Tied variable freed while still in use"
-=item Unicode collation and normalization
+=item New "To%s: illegal mapping '%s'"
-=item pack/unpack tutorial
+=item New "Use of freed value in iteration"
=back
+=item Changed Internals
+
+=item New Tests
+
+=item Known Problems
+
+=over 4
+
+=item Tied hashes in scalar context
+
+=item Net::Ping 450_service and 510_ping_udp failures
+
+=item B::C
+
=back
-=head2 perldoc - Look up Perl documentation in Pod format.
+=item Platform Specific Problems
=over 4
-=item SYNOPSIS
+=item EBCDIC Platforms
+
+=item Cygwin 1.5 problems
+
+=item HP-UX: HP cc warnings about sendfile and sendpath
+
+=item IRIX: t/uni/tr_7jis.t falsely failing
+
+=item Mac OS X: no usemymalloc
+
+=item Tru64: No threaded builds with GNU cc (gcc)
+
+=item Win32: sysopen, sysread, syswrite
+
+=back
+
+=item TODO
+
+=item Reporting Bugs
+
+=item SEE ALSO
+
+=back
+
+=head2 perl585delta - what is new for perl v5.8.5
+
+=over 4
=item DESCRIPTION
-=item OPTIONS
+=item Incompatible Changes
-B<-h>, B<-v>, B<-t>, B<-u>, B<-m> I<module>, B<-l>, B<-F>, B<-f>
-I<perlfunc>, B<-q> I<perlfaq-search-regexp>, B<-T>, B<-d>
-I<destination-filename>, B<-o> I<output-formatname>, B<-M> I<module-name>,
-B<-w> I<option:value> or B<-w> I<option>, B<-X>,
-B<PageName|ModuleName|ProgramName>, B<-n> I<some-formatter>, B<-r>, B<-i>,
-B<-V>
+=item Core Enhancements
-=item SECURITY
+=item Modules and Pragmata
-=item ENVIRONMENT
+=item Utility Changes
-=item AUTHOR
+=over 4
+
+=item Perl's debugger
+
+=item h2ph
=back
-=head2 perlhist - the Perl history records
+=item Installation and Configuration Improvements
+
+=item Selected Bug Fixes
+
+=item New or Changed Diagnostics
+
+=item Changed Internals
+
+=item Known Problems
+
+=item Platform Specific Problems
+
+=item Reporting Bugs
+
+=item SEE ALSO
+
+=back
+
+=head2 perl584delta - what is new for perl v5.8.4
=over 4
=item DESCRIPTION
-=item INTRODUCTION
+=item Incompatible Changes
-=item THE KEEPERS OF THE PUMPKIN
+=item Core Enhancements
=over 4
-=item PUMPKIN?
+=item Malloc wrapping
+
+=item Unicode Character Database 4.0.1
+
+=item suidperl less insecure
+
+=item format
=back
-=item THE RECORDS
+=item Modules and Pragmata
=over 4
-=item SELECTED RELEASE SIZES
+=item Updated modules
-=item SELECTED PATCH SIZES
+Attribute::Handlers, B, Benchmark, CGI, Carp, Cwd, Exporter, File::Find,
+IO, IPC::Open3, Local::Maketext, Math::BigFloat, Math::BigInt,
+Math::BigRat, MIME::Base64, ODBM_File, POSIX, Shell, Socket, Storable,
+Switch, Sys::Syslog, Term::ANSIColor, Time::HiRes, Unicode::UCD, Win32,
+base, open, threads, utf8
=back
-=item THE KEEPERS OF THE RECORDS
+=item Performance Enhancements
+
+=item Utility Changes
+
+=item Installation and Configuration Improvements
+
+=item Selected Bug Fixes
+
+=item New or Changed Diagnostics
+
+=item Changed Internals
+
+=item Future Directions
+
+=item Platform Specific Problems
+
+=item Reporting Bugs
+
+=item SEE ALSO
=back
-=head2 perldelta - what is new for perl v5.9.0
+=head2 perl583delta - what is new for perl v5.8.3
=over 4
=item Incompatible Changes
+=item Core Enhancements
+
+=item Modules and Pragmata
+
+CGI, Cwd, Digest, Digest::MD5, Encode, File::Spec, FindBin, List::Util,
+Math::BigInt, PodParser, Pod::Perldoc, POSIX, Unicode::Collate,
+Unicode::Normalize, Test::Harness, threads::shared
+
+=item Utility Changes
+
+=item New Documentation
+
+=item Installation and Configuration Improvements
+
+=item Selected Bug Fixes
+
+=item New or Changed Diagnostics
+
+=item Changed Internals
+
+=item Configuration and Building
+
+=item Platform Specific Problems
+
+=item Known Problems
+
+=item Future Directions
+
+=item Obituary
+
+=item Reporting Bugs
+
+=item SEE ALSO
+
+=back
+
+=head2 perl582delta - what is new for perl v5.8.2
+
=over 4
-=item The C<$*> variable has been removed
+=item DESCRIPTION
+
+=item Incompatible Changes
+
+=item Core Enhancements
+
+=over 4
+
+=item Hash Randomisation
+
+=item Threading
+
+=back
+
+=item Modules and Pragmata
+
+=over 4
+
+=item Updated Modules And Pragmata
+
+Devel::PPPort, Digest::MD5, I18N::LangTags, libnet, MIME::Base64,
+Pod::Perldoc, strict, Tie::Hash, Time::HiRes, Unicode::Collate,
+Unicode::Normalize, UNIVERSAL
+
+=back
+
+=item Selected Bug Fixes
+
+=item Changed Internals
+
+=item Platform Specific Problems
+
+=item Future Directions
+
+=item Reporting Bugs
+
+=item SEE ALSO
+
+=back
+
+=head2 perl581delta - what is new for perl v5.8.1
+
+=over 4
+
+=item DESCRIPTION
+
+=item Incompatible Changes
+
+=over 4
+
+=item Hash Randomisation
+
+=item UTF-8 On Filehandles No Longer Activated By Locale
+
+=item Single-number v-strings are no longer v-strings before "=>"
+
+=item (Win32) The -C Switch Has Been Repurposed
+
+=item (Win32) The /d Switch Of cmd.exe
=back
=over 4
+=item UTF-8 no longer default under UTF-8 locales
+
+=item Unsafe signals again available
+
=item Tied Arrays with Negative Array Indices
+=item local ${$x}
+
+=item Unicode Character Database 4.0.0
+
+=item Deprecation Warnings
+
+=item Miscellaneous Enhancements
+
=back
=item Modules and Pragmata
+=over 4
+
+=item Updated Modules And Pragmata
+
+base, B::Bytecode, B::Concise, B::Deparse, Benchmark, ByteLoader, bytes,
+CGI, charnames, CPAN, Data::Dumper, DB_File, Devel::PPPort, Digest::MD5,
+Encode, fields, libnet, Math::BigInt, MIME::Base64, NEXT, Net::Ping,
+PerlIO::scalar, podlators, Pod::LaTeX, PodParsers, Pod::Perldoc,
+Scalar::Util, Storable, strict, Term::ANSIcolor, Test::Harness, Test::More,
+Test::Simple, Text::Balanced, Time::HiRes, threads, threads::shared,
+Unicode::Collate, Unicode::Normalize, Win32::GetFolderPath,
+Win32::GetOSVersion
+
+=back
+
=item Utility Changes
=item New Documentation
-=item Performance Enhancements
-
=item Installation and Configuration Improvements
+=over 4
+
+=item Platform-specific enhancements
+
+=back
+
=item Selected Bug Fixes
+=over 4
+
+=item Closures, eval and lexicals
+
+=item Generic fixes
+
+=item Platform-specific fixes
+
+=back
+
=item New or Changed Diagnostics
+=over 4
+
+=item Changed "A thread exited while %d threads were running"
+
+=item Removed "Attempt to clear a restricted hash"
+
+=item New "Illegal declaration of anonymous subroutine"
+
+=item Changed "Invalid range "%s" in transliteration operator"
+
+=item New "Missing control char name in \c"
+
+=item New "Newline in left-justified string for %s"
+
+=item New "Possible precedence problem on bitwise %c operator"
+
+=item New "Pseudo-hashes are deprecated"
+
+=item New "read() on %s filehandle %s"
+
+=item New "5.005 threads are deprecated"
+
+=item New "Tied variable freed while still in use"
+
+=item New "To%s: illegal mapping '%s'"
+
+=item New "Use of freed value in iteration"
+
+=back
+
=item Changed Internals
=item New Tests
=item Known Problems
+=over 4
+
+=item Tied hashes in scalar context
+
+=item Net::Ping 450_service and 510_ping_udp failures
+
+=item B::C
+
+=back
+
=item Platform Specific Problems
+=over 4
+
+=item EBCDIC Platforms
+
+=item Cygwin 1.5 problems
+
+=item HP-UX: HP cc warnings about sendfile and sendpath
+
+=item IRIX: t/uni/tr_7jis.t falsely failing
+
+=item Mac OS X: no usemymalloc
+
+=item Tru64: No threaded builds with GNU cc (gcc)
+
+=item Win32: sysopen, sysread, syswrite
+
+=back
+
+=item Future Directions
+
=item Reporting Bugs
=item SEE ALSO
=back
-=head2 perl58delta, perldelta - what is new for perl v5.8.0
+=head2 perl58delta - what is new for perl v5.8.0
=over 4
=item The IBM ANSI C Compiler
+=item The usenm option
+
=item Using GNU's gcc for building perl
=item Using Large Files with Perl
=item Floating point anomalies on BS2000
+=item Using PerlIO and different encodings on ASCII and EBCDIC partitions
+
=back
=item AUTHORS
=back
-=over 4
+=head2 perlce - Perl for WinCE
-=item Name
+=over 4
-=item Description
+=item DESCRIPTION
-=item Build
+=item BUILD
=over 4
=back
-=item Acknowledgements
+=item ACKNOWLEDGEMENTS
=item AUTHORS
=item PA-RISC 2.0
-=item Itanium
+=item Itanium & Itanium 2
=item Portability Between PA-RISC Versions
=over 4
-=item Compiling Perl 5 on MachTen
+=item Perl version 5.8.x and greater not supported
+
+=item Compiling Perl 5.6.x on MachTen
=item Failures during C<make test> on MachTen
=back
+=item Starting From Scratch
+
=item AUTHOR
=item DATE
=item AUTHOR
-=item Name
+=back
+
+=head2 perlnetware - Perl for NetWare
+
+=over 4
-=item Description
+=item DESCRIPTION
-=item Build
+=item BUILD
=over 4
=back
-=item Install
+=item INSTALL
-=item Build new extensions
+=item BUILD NEW EXTENSIONS
-=item Acknowledgements
+=item ACKNOWLEDGEMENTS
-=item Authors
+=item AUTHORS
-=item Date
+=item DATE
=back
=back
+=item Building a binary distribution
+
+=item Building custom F<.EXE> files
+
+=over 4
+
+=item Making executables with a custom collection of statically loaded
+extensions
+
+=item Making executables with a custom search-paths
+
+=back
+
=item Build FAQ
=over 4
=back
+=item SunOS 4.x
+
=item AUTHOR
=item LAST MODIFIED
=item Setting Up Perl on Win32
Make, Command Shell, Borland C++, Microsoft Visual C++, Microsoft Platform
-SDK 64-bit Compiler, MinGW32 with gcc, MinGW release 1
+SDK 64-bit Compiler, MinGW release 3 with gcc, MinGW release 1 with gcc
=item Building
=item BUGS AND CAVEATS
+=item ACKNOWLEDGEMENTS
+
=item AUTHORS
Gary Ng E<lt>71564.1743@CompuServe.COME<gt>, Gurusamy Sarathy
=item FUNCTIONS
-share VARIABLE, lock VARIABLE, cond_wait VARIABLE, cond_signal VARIABLE,
-cond_broadcast VARIABLE
+share VARIABLE, lock VARIABLE, cond_wait VARIABLE, cond_wait CONDVAR,
+LOCKVAR, cond_timedwait VARIABLE, ABS_TIMEOUT, cond_timedwait CONDVAR,
+ABS_TIMEOUT, LOCKVAR, cond_signal VARIABLE, cond_broadcast VARIABLE
=item NOTES
=back
-=head2 base - Establish IS-A relationship with base class at compile time
+=head2 base - Establish IS-A relationship with base classes at compile time
=over 4
=item DESCRIPTION
+=item DIAGNOSTICS
+
+Base class package "%s" is empty
+
=item HISTORY
+=item CAVEATS
+
=item SEE ALSO
=back
=back
-=head2 bigrat - Transparent BigNumber/BigRationale support for Perl
+=head2 bigrat - Transparent BigNumber/BigRational support for Perl
=over 4
=item DESCRIPTION
+=item LIMITATIONS
+
=item SEE ALSO
=back
=back
-=head2 diagnostics - Perl compiler pragma to force verbose warning
-diagnostics
+=head2 diagnostics, splain - produce verbose warning diagnostics
=over 4
=item PerlIO layers for C<STD(IN|OUT)>
+=item Implicit upgrading for byte strings
+
=back
=item FEATURES THAT REQUIRE 5.8.1
=item FUNCTIONS
-share VARIABLE, lock VARIABLE, cond_wait VARIABLE, cond_signal VARIABLE,
-cond_broadcast VARIABLE
+share VARIABLE, lock VARIABLE, cond_wait VARIABLE, cond_wait CONDVAR,
+LOCKVAR, cond_timedwait VARIABLE, ABS_TIMEOUT, cond_timedwait CONDVAR,
+ABS_TIMEOUT, LOCKVAR, cond_signal VARIABLE, cond_broadcast VARIABLE
=item NOTES
=item What IS a version
-Numeric Versions, V-String Versions
+Numeric Versions, Quoted Versions
+
+=item What about v-strings?
=item Numeric Versions
-=item V-String Versions
+=item Quoted Versions
=item Object Methods
-New Operator, Stringification, Numification, Comparison operators, Logical
-Operators
+New Operator, qv(), Normal Form, Numification, Stringification, Comparison
+operators, Logical Operators
=item Quoting
=item Types of Versions Objects
-Ordinary versions, alpha versions
+Ordinary versions, Alpha versions
=item Replacement UNIVERSAL::VERSION
=item OPTIONS
-B<-basic>, B<-exec>, B<-tree>, B<-compact>, B<-loose>, B<-vt>, B<-ascii>,
-B<-main>, B<-base>I<n>, B<-bigendian>, B<-littleendian>, B<-concise>,
-B<-terse>, B<-linenoise>, B<-debug>, B<-env>
+=over 4
+
+=item Options for Opcode Ordering
+
+B<-basic>, B<-exec>, B<-tree>
+
+=item Options for Line-Style
+
+B<-concise>, B<-terse>, B<-linenoise>, B<-debug>, B<-env>
+
+=item Options for tree-specific formatting
+
+B<-compact>, B<-loose>, B<-vt>, B<-ascii>
+
+=item Options controlling sequence numbering
+
+B<-base>I<n>, B<-bigendian>, B<-littleendian>
+
+=item Other options
+
+B<-main>, B<-nomain>, B<-nobanner>, B<-banner>, B<-banneris> => subref
+
+=item Option Stickiness
+
+=back
+
+=item ABBREVIATIONS
+
+=over 4
+
+=item OP class abbreviations
+
+=item OP flags abbreviations
+
+=back
=item FORMATTING SPECIFICATIONS
+=over 4
+
+=item Special Patterns
+
B<(x(>I<exec_text>B<;>I<basic_text>B<)x)>, B<(*(>I<text>B<)*)>,
B<(*(>I<text1>B<;>I<text2>B<)*)>, B<(?(>I<text1>B<#>I<var>I<Text2>B<)?)>,
-B<#>I<var>, B<#>I<var>I<N>, B<~>, B<#addr>, B<#arg>, B<#class>,
+B<~>
+
+=item # Variables
+
+B<#>I<var>, B<#>I<var>I<N>, B<#>I<Var>, B<#addr>, B<#arg>, B<#class>,
B<#classsym>, B<#coplabel>, B<#exname>, B<#extarg>, B<#firstaddr>,
B<#flags>, B<#flagval>, B<#hyphseq>, B<#label>, B<#lastaddr>, B<#name>,
B<#NAME>, B<#next>, B<#nextaddr>, B<#noise>, B<#private>, B<#privval>,
-B<#seq>, B<#seqnum>, B<#sibaddr>, B<#svaddr>, B<#svclass>, B<#svval>,
-B<#targ>, B<#targarg>, B<#targarglife>, B<#typenum>
+B<#seq>, B<#opt>, B<#static>, B<#sibaddr>, B<#svaddr>, B<#svclass>,
+B<#svval>, B<#targ>, B<#targarg>, B<#targarglife>, B<#typenum>
-=item ABBREVIATIONS
+=back
+
+=item Using B::Concise outside of the O framework
=over 4
-=item OP flags abbreviations
+=item Example: Altering Concise Renderings
-=item OP class abbreviations
+=item set_style()
-=back
+=item set_style_standard($name)
-=item Using B::Concise outside of the O framework
+=item add_style()
+
+=item add_callback()
+
+=item Running B::Concise::compile()
+
+=item B::Concise::reset_sequence()
+
+=item Errors
+
+=back
=item AUTHOR
B<path_translated()>, B<remote_host()>, B<script_name()> Return the script
name as a partial URL, for self-refering scripts, B<referer()>, B<auth_type
()>, B<server_name ()>, B<virtual_host ()>, B<server_port ()>,
-B<server_software ()>, B<remote_user ()>, B<user_name ()>,
-B<request_method()>, B<content_type()>, B<http()>, B<https()>
+B<virtual_port ()>, B<server_software ()>, B<remote_user ()>, B<user_name
+()>, B<request_method()>, B<content_type()>, B<http()>, B<https()>
=item USING NPH SCRIPTS
=back
-=head2 Carp::Heavy, Carp heavy machinery - no user serviceable parts inside
+=head2 Carp::Heavy - heavy machinery, no user serviceable parts inside
=head2 Class::ISA -- report the search path for a class's ISA tree
C<PERL_REVISION>, C<PERL_SUBVERSION>, C<PERL_VERSION>, C<perladmin>,
C<perllibs>, C<perlpath>, C<pg>, C<phostname>, C<pidtype>, C<plibpth>,
-C<pm_apiversion>, C<pmake>, C<pr>, C<prefix>, C<prefixexp>, C<privlib>,
-C<privlibexp>, C<procselfexe>, C<prototype>, C<ptrsize>
+C<pmake>, C<pr>, C<prefix>, C<prefixexp>, C<privlib>, C<privlibexp>,
+C<procselfexe>, C<prototype>, C<ptrsize>
=item q
=item x
-C<xlibpth>, C<xs_apiversion>
+C<xlibpth>
=item y
=item getcwd and friends
-getcwd, cwd, fastcwd, fastgetcwd
+getcwd, cwd, fastcwd, fastgetcwd, getdcwd
=item abs_path and friends
=item NOTES
+=item AUTHOR
+
=item SEE ALSO
=back
=back
+=head2 DBM_Filter -- Filter DBM keys/values
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item What is a DBM Filter?
+
+=over 4
+
+=item So what's new?
+
+=back
+
+=item METHODS
+
+=over 4
+
+=item $db->Filter_Push()
+
+=item $db->Filter_Key_Push()
+
+=item $db->Filter_Value_Push()
+
+Filter_Push, Filter_Key_Push, Filter_Value_Push
+
+=item $db->Filter_Pop()
+
+=item $db->Filtered()
+
+=back
+
+=item Writing a Filter
+
+=over 4
+
+=item Immediate Filters
+
+=item Canned Filters
+
+"name", params
+
+=back
+
+=item Filters Included
+
+utf8, encode, compress, int32, null
+
+=item NOTES
+
+=over 4
+
+=item Maintain Round Trip Integrity
+
+=item Don't mix filtered & non-filtered data in the same database file.
+
+=back
+
+=item EXAMPLE
+
+=item SEE ALSO
+
+=item AUTHOR
+
+=back
+
=head2 DB_File - Perl5 access to Berkeley DB version 1.x
=over 4
=back
-=head2 Digest:: - Modules that calculate message digests
+=head2 Digest - Modules that calculate message digests
=over 4
$ctx = Digest->XXX($arg,...), $ctx = Digest->new(XXX => $arg,...), $ctx =
Digest::XXX->new($arg,...), $other_ctx = $ctx->clone, $ctx->reset,
-$ctx->add($data,...), $ctx->addfile($io_handle), $ctx->digest,
+$ctx->add( $data, ... ), $ctx->addfile( $io_handle ), $ctx->add_bits(
+$data, $nbits ), $ctx->add_bits( $bitstring ), $ctx->digest,
$ctx->hexdigest, $ctx->b64digest
+=item Digest speed
+
=item SEE ALSO
=item AUTHOR
=item METHODS
$md5 = Digest::MD5->new, $md5->reset, $md5->clone, $md5->add($data,...),
-$md5->addfile($io_handle), $md5->digest, $md5->hexdigest, $md5->b64digest
+$md5->addfile($io_handle), $md5->add_bits($data, $nbits),
+$md5->add_bits($bitstring), $md5->digest, $md5->hexdigest, $md5->b64digest
=item EXAMPLES
=back
+=head2 Digest::base - Digest base class
+
+=over 4
+
+=item SYNPOSIS
+
+=item DESCRIPTION
+
+=item SEE ALSO
+
+=back
+
=head2 DirHandle - supply object methods for directory handles
=over 4
=item DESCRIPTION
@dl_library_path, @dl_resolve_using, @dl_require_symbols, @dl_librefs,
-@dl_modules, dl_error(), $dl_debug, dl_findfile(), dl_expandspec(),
-dl_load_file(), dl_unload_file(), dl_load_flags(), dl_find_symbol(),
-dl_find_symbol_anywhere(), dl_undef_symbols(), dl_install_xsub(),
-bootstrap()
+@dl_modules, @dl_shared_objects, dl_error(), $dl_debug, dl_findfile(),
+dl_expandspec(), dl_load_file(), dl_unload_file(), dl_load_flags(),
+dl_find_symbol(), dl_find_symbol_anywhere(), dl_undef_symbols(),
+dl_install_xsub(), bootstrap()
=item AUTHOR
=item PerlIO layers for C<STD(IN|OUT)>
+=item Implicit upgrading for byte strings
+
=back
=item FEATURES THAT REQUIRE 5.8.1
=item Exporting without using Exporter's import method
+=item Exporting without inheriting from Exporter
+
=item Module Version Checking
=item Managing Unknown Symbols
test_f file
+dos2unix
+
=over 4
=item BUGS
=back
-=head2 ExtUtils::MM_Any - Platform agnostic MM methods
+=head2 ExtUtils::MM_Any - Platform-agnostic MM methods
=over 4
os_flavor_is
+blibdirs_target (o)
+
=over 4
=item File::Spec wrappers
metafile_target
+signature_target
+
metafile_addtomanifest_target
+signature_addtomanifest_target
+
=over 4
=item Abstract methods
depend (o)
-dir_target (o)
+dir_target B<DEPRECATED>
init_DEST
os_flavor
+blibdirs_target (override)
+
=head2 ExtUtils::MM_Win32 - methods to override UN*X behaviour in
ExtUtils::MakeMaker
realclean_subdirs_target
+max_exec_len
+
os_flavor
=over 4
PERL_MALLOC_OK, PERLPREFIX, PERLRUN, PERLRUNINST, PERL_SRC, PERM_RW,
PERM_RWX, PL_FILES, PM, PMLIBDIRS, PM_FILTER, POLLUTE, PPM_INSTALL_EXEC,
PPM_INSTALL_SCRIPT, PREFIX, PREREQ_FATAL, PREREQ_PM, PREREQ_PRINT,
-PRINT_PREREQ, SITEPREFIX, SKIP, TYPEMAPS, VENDORPREFIX, VERBINST, VERSION,
-VERSION_FROM, VERSION_SYM, XS, XSOPT, XSPROTOARG, XS_VERSION
+PRINT_PREREQ, SITEPREFIX, SIGN, SKIP, TYPEMAPS, VENDORPREFIX, VERBINST,
+VERSION, VERSION_FROM, VERSION_SYM, XS, XSOPT, XSPROTOARG, XS_VERSION
=item Additional lowercase attributes
=over 4
+=item Module Installation
+
+How do I keep from installing man pages?, How do I use a module without
+installing it?
+
=item Philosophy and History
-Why not just use <insert other build config tool here>?, What's
+Why not just use <insert other build config tool here>?, What is
Module::Build and how does it relate to MakeMaker?, pure perl. no make, no
shell commands, easier to customize, cleaner internals, less cruft
=back
-=head2 ExtUtils::MakeMaker::bytes - Version agnostic bytes.pm
+=head2 ExtUtils::MakeMaker::bytes - Version-agnostic bytes.pm
=over 4
=back
-=head2 ExtUtils::MakeMaker::vmsish - Platform agnostic vmsish.pm
+=head2 ExtUtils::MakeMaker::vmsish - Platform-agnostic vmsish.pm
=over 4
=item NOTES
+=item BUGS AND CAVEATS
+
=item HISTORY
=back
=item BUGS
-=item NOTES
-
=back
=head2 FileHandle - supply object methods for filehandles
=over 4
-=item Warning: Ignoring '!' modifier for short option
-
=item GetOptions does not return a false result when an option is not
supplied
=back
-=head2 Getopt::Std, getopt - Process single-character switches with switch
-clustering
+=head2 Getopt::Std, getopt, getopts - Process single-character switches
+with switch clustering
=over 4
B<lock_hash>, B<unlock_hash>
+B<hash_seed>
+
=over 4
=item CAVEATS
the function @langs = panic_languages(@accept_languages)
+the function implicate_supers( ...languages... ), the function
+implicate_supers_strictly( ...languages... )
+
=over 4
=item ABOUT LOWERCASING
=back
+=head2 I18N::LangTags::Detect - detect the user's language preferences
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item FUNCTIONS
+
+=item ENVIRONMENT
+
+=item SEE ALSO
+
+=item COPYRIGHT
+
+=item AUTHOR
+
+=back
+
=head2 I18N::LangTags::List -- tags and names for human languages
=over 4
=item COPYRIGHT
+=item SEE ALSO
+
=back
=head2 MIME::Base64::QuotedPrint, MIME::QuotedPrint - Encoding and decoding
=item COPYRIGHT
+=item SEE ALSO
+
=back
=head2 MIME::QuotedPrint - Encoding and decoding of quoted-printable
=item COPYRIGHT
+=item SEE ALSO
+
=back
=head2 Math::BigFloat - Arbitrary size floating point math package
=item DESCRIPTION
-Canonical notation, Input, Output
+Input, Output
=item METHODS
=item is_one()/is_zero()/is_nan()/is_inf()
-=item is_positive()/is_negative()
+=item is_pos()/is_neg()
- $x->is_positive(); # true if >= 0
- $x->is_negative(); # true if < 0
+ $x->is_pos(); # true if >= 0
+ $x->is_neg(); # true if < 0
=item is_odd()/is_even()/is_int()
=item sign
-=item bcmp
+=item digit
=item bneg
=item copy
-=item as_number
+=item as_int
=item bsstr
=item CAVEATS
-stringify, bstr(), bsstr() and 'cmp', int(), length, bdiv, infinity
-handling, Modifying and =, bpow, Overloading -$x, Mixing different object
-types, bsqrt(), brsft()
+bstr(), bsstr() and 'cmp', int(), length, bdiv, infinity handling,
+Modifying and =, bpow, Overloading -$x, Mixing different object types,
+bsqrt(), brsft()
=item LICENSE
=back
-=head2 Math::BigInt::Scalar - Pure Perl module to test Math::BigInt with
-scalars
+=head2 Math::BigInt::CalcEmu - Emulate low-level math with BigInt code
=over 4
=item DESCRIPTION
+=item METHODS
+
=item LICENSE
This program is free software; you may redistribute it and/or modify it
under
the same terms as Perl itself.
-=item AUTHOR
+=item AUTHORS
=item SEE ALSO
=back
-=head2 Math::BigRat - arbitrarily big rationales
+=head2 Math::BigRat - arbitrarily big rational numbers
=over 4
$x->bfloor();
+=item bsqrt()
+
+ $x->bsqrt();
+
=item config
=back
=item BUGS
inf handling (partial), NaN handling (partial), rounding (not implemented
-except for bceil/bfloor), $x ** $y where $y is not an integer
+except for bceil/bfloor), $x ** $y where $y is not an integer, bmod(),
+blog(), bmodinv() and bmodpow() (partial)
=item LICENSE
=item CONSTRUCTOR
-new (HOST [,OPTIONS])
+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 (), restart ( WHERE ), rmdir ( DIR ),
-mkdir ( DIR [, RECURSE ]), ls ( [ DIR ] ), alloc ( SIZE [, RECORD_SIZE] ),
-dir ( [ DIR ] ), get ( REMOTE_FILE [, LOCAL_FILE [, WHERE]] ), put (
-LOCAL_FILE [, REMOTE_FILE ] ), put_unique ( LOCAL_FILE [, REMOTE_FILE ] ),
-append ( LOCAL_FILE [, REMOTE_FILE ] ), unique_name (), mdtm ( FILE ), size
-( FILE ), supported ( CMD ), hash ( [FILEHANDLE_GLOB_REF],[
+site (ARGS), ascii, binary, rename ( OLDNAME, NEWNAME ), delete ( FILENAME
+), cwd ( [ DIR ] ), cdup (), pwd (), restart ( WHERE ), rmdir ( DIR [,
+RECURSE ]), mkdir ( DIR [, RECURSE ]), alloc ( SIZE [, RECORD_SIZE] ), 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 (
=item USE EXAMPLES
-http://www.csh.rit.edu/~adam/Progs/autoftp-2.0.tar.gz
+http://www.csh.rit.edu/~adam/Progs/
=item CREDITS
=item CONSTRUCTOR
-new ( [ HOST, ] [ OPTIONS ] )
+new ( [ HOST ] [, OPTIONS ] 0
=item METHODS
-user ( USER ), pass ( PASS ), login ( [ USER [, PASS ]] ), apop ( [ USER [,
-PASS ]] ), top ( MSGNUM [, NUMLINES ] ), list ( [ MSGNUM ] ), get ( MSGNUM
-[, FH ] ), getfh ( MSGNUM ), last (), popstat (), ping ( USER ), uidl ( [
-MSGNUM ] ), delete ( MSGNUM ), reset (), quit ()
+auth ( USERNAME, PASSWORD ), user ( USER ), pass ( PASS ), login ( [ USER
+[, PASS ]] ), apop ( [ USER [, PASS ]] ), banner (), capa (), capabilities
+(), top ( MSGNUM [, NUMLINES ] ), list ( [ MSGNUM ] ), get ( MSGNUM [, FH ]
+), getfh ( MSGNUM ), last (), popstat (), ping ( USER ), uidl ( [ MSGNUM ]
+), delete ( MSGNUM ), reset (), quit ()
=item NOTES
=item CONSTRUCTOR
-new Net::SMTP [ HOST, ] [ OPTIONS ]
+new ( [ HOST ] [, OPTIONS ] )
=item METHODS
-banner (), domain (), hello ( DOMAIN ), etrn ( DOMAIN ), auth ( USERNAME,
-PASSWORD ), mail ( ADDRESS [, OPTIONS] ), send ( ADDRESS ), send_or_mail (
-ADDRESS ), send_and_mail ( ADDRESS ), reset (), recipient ( ADDRESS [,
-ADDRESS [ ...]] [, OPTIONS ] ), to ( ADDRESS [, ADDRESS [...]] ), cc (
-ADDRESS [, ADDRESS [...]] ), bcc ( ADDRESS [, ADDRESS [...]] ), data ( [
-DATA ] ), expand ( ADDRESS ), verify ( ADDRESS ), help ( [ $subject ] ),
-quit ()
+banner (), domain (), hello ( DOMAIN ), host (), etrn ( DOMAIN ), auth (
+USERNAME, PASSWORD ), mail ( ADDRESS [, OPTIONS] ), send ( ADDRESS ),
+send_or_mail ( ADDRESS ), send_and_mail ( ADDRESS ), reset (), recipient (
+ADDRESS [, ADDRESS, [...]] [, OPTIONS ] ), to ( ADDRESS [, ADDRESS [...]]
+), cc ( ADDRESS [, ADDRESS [...]] ), bcc ( ADDRESS [, ADDRESS [...]] ),
+data ( [ DATA ] ), expand ( ADDRESS ), verify ( ADDRESS ), help ( [
+$subject ] ), quit ()
=item ADDRESSES
=item DESCRIPTION
-unix, stdio, perlio, crlf, utf8, bytes, raw, pop
+:unix, :stdio, :perlio, :crlf, :mmap, :utf8, :bytes, :raw, :pop, :win32
=over 4
=item Defaults and how to override them
-=item Querying the layers of filehandle
+=item Querying the layers of filehandles
=back
=back
-=head2 PerlIO::scalar - support module for in-memory IO.
+=head2 PerlIO::scalar - in-memory IO, scalar IO
=over 4
=item DESCRIPTION
+=item IMPLEMENTATION NOTE
+
=back
=head2 PerlIO::via - Helper class for PerlIO layers implemented in perl
=item DESCRIPTION
+=item REQUIRED MODULES
+
=item SEE ALSO
=item ACKNOWLEDGEMENTS
=item ARGUMENTS
-backlink, cachedir, css, flush, header, help, htmldir, htmlroot, index,
-infile, libpods, netscape, outfile, podpath, podroot, quiet, recurse,
-title, verbose
+backlink, cachedir, css, flush, header, help, hiddendirs, htmldir,
+htmlroot, index, infile, libpods, netscape, outfile, podpath, podroot,
+quiet, recurse, title, verbose
=item EXAMPLE
=over 4
-=item OBJECT ORIENTED SYNTAX
+=item Caveats
+
+=item Escaping Magic Characters
+
+=item Configuration
=back
+=item BUGS
+
=item AUTHOR
=back
=item BUGS
-=item LIMITATION
+=item LIMITATIONS
=item COPYRIGHT
=item DESCRIPTION
+=item BUGS
+
=back
=head2 Sys::Hostname - Try every conceivable way to get hostname
=item BUGS and CAVEATS
+=item ENVIRONMENT
+
=item NOTE
=item SEE ALSO
=back
-=head2 Test::Harness - run perl standard test scripts with statistics
+=head2 Test::Harness - Run Perl standard test scripts with statistics
+
+=over 4
+
+=item VERSION
+
+=back
=over 4
=item Configuration variables.
-B<$Test::Harness::verbose>, B<$Test::Harness::switches>
+B<$Test::Harness::Verbose>, B<$Test::Harness::switches>
=item Failure
=item ENVIRONMENT
C<HARNESS_ACTIVE>, C<HARNESS_COLUMNS>, C<HARNESS_COMPILE_TEST>,
-C<HARNESS_FILELEAK_IN_DIR>, C<HARNESS_IGNORE_EXITCODE>, C<HARNESS_NOTTY>,
-C<HARNESS_OK_SLOW>, C<HARNESS_PERL_SWITCHES>, C<HARNESS_VERBOSE>
+C<HARNESS_DEBUG>, C<HARNESS_FILELEAK_IN_DIR>, C<HARNESS_IGNORE_EXITCODE>,
+C<HARNESS_NOTTY>, C<HARNESS_OK_SLOW>, C<HARNESS_PERL>,
+C<HARNESS_PERL_SWITCHES>, C<HARNESS_VERBOSE>
=item EXAMPLE
=item BUGS
+=item AUTHORS
+
+=item COPYRIGHT
+
=back
=head2 Test::Harness::Assert - simple assert
=item DESCRIPTION
-=over 4
+=item FUNCTIONS
-=item Functions
+=over 4
-B<assert>
+=item C<assert()>
=back
=item DESCRIPTION
+=over 4
+
+=item new()
+
+=item next()
+
+=back
+
=back
=head2 Test::Harness::Straps - detailed analysis of test results
=over 4
+=item C<_command_line( $file )>
+
+=back
+
+=over 4
+
+=item C<_command>
+
+=back
+
+=over 4
+
=item C<_switches>
=back
=over 4
+=item C<_cleaned_switches>
+
+=back
+
+=over 4
+
=item C<_INC2PERL5LIB>
=back
=item DESCRIPTION
TIEHASH classname, LIST, STORE this, key, value, FETCH this, key, FIRSTKEY
-this, NEXTKEY this, lastkey, EXISTS this, key, DELETE this, key, CLEAR this
+this, NEXTKEY this, lastkey, EXISTS this, key, DELETE this, key, CLEAR
+this, SCALAR this
=item Inheriting from B<Tie::StdHash>
=item Inheriting from B<Tie::ExtraHash>
-=item C<UNTIE> and C<DESTROY>
+=item C<SCALAR>, C<UNTIE> and C<DESTROY>
=item MORE INFORMATION
=item DESCRIPTION
+=over 4
+
+=item Ambiguous Local Times (DST)
+
+=item Non-Existent Local Times (DST)
+
+=item Negative Epoch Values
+
+=back
+
=item IMPLEMENTATION
=item BUGS
=item Constructor and Tailoring
-UCA_Version, alternate, backwards, entry, ignoreName, ignoreChar, level,
-normalization, overrideCJK, overrideHangul, preprocess, rearrange, table,
-undefName, undefChar, katakana_before_hiragana, upper_before_lower
+UCA_Version, backwards, entry, hangul_terminator, ignoreName, ignoreChar,
+level, normalization, overrideCJK, overrideHangul, preprocess, rearrange,
+table, undefName, undefChar, katakana_before_hiragana, upper_before_lower,
+variable, alternate
=item Methods for Collation
=item Other Methods
-C<%old_tailoring = $Collator-E<gt>change(%new_tailoring)>, UCA_Version,
-Base_Unicode_Version
+C<%old_tailoring = $Collator-E<gt>change(%new_tailoring)>, C<$version =
+$Collator-E<gt>version()>, C<UCA_Version()>, C<Base_Unicode_Version()>
=item EXPORT
=item SEE ALSO
-http://www.unicode.org/reports/tr10/,
-http://www.unicode.org/reports/tr10/allkeys.txt,
-http://www.unicode.org/reports/tr10/CollationTest.html
-http://www.unicode.org/reports/tr10/CollationTest.zip,
-http://www.unicode.org/reports/tr15/, L<Unicode::Normalize>
+Unicode Collation Algorithm - UTS #10, The Default Unicode Collation
+Element Table (DUCET), The conformance test for the UCA, Hangul Syllable
+Type, Unicode Normalization Forms - UAX #15, L<Unicode::Normalize>
=back
C<$NFD_string = NFD($string)>, C<$NFC_string = NFC($string)>,
C<$NFKD_string = NFKD($string)>, C<$NFKC_string = NFKC($string)>,
+C<$FCD_string = FCD($string)>, C<$FCC_string = FCC($string)>,
C<$normalized_string = normalize($form_name, $string)>
=item Decomposition and Composition
C<$result = checkNFD($string)>, C<$result = checkNFC($string)>, C<$result =
checkNFKD($string)>, C<$result = checkNFKC($string)>, C<$result =
+checkFCD($string)>, C<$result = checkFCC($string)>, C<$result =
check($form_name, $string)>
=item Character Data
=item SEE ALSO
-http://www.unicode.org/unicode/reports/tr15/,
-http://www.unicode.org/Public/UNIDATA/DerivedNormalizationProps.txt
+http://www.unicode.org/reports/tr15/,
+http://www.unicode.org/Public/UNIDATA/DerivedNormalizationProps.txt,
+http://www.unicode.org/notes/tn5/
=back
=back
-=head2 Win32 - Interfaces to some Win32 API Functions
-
-=over 4
-
-=item DESCRIPTION
-
-=over 4
-
-=item Alphabetical Listing of Win32 Functions
-
-Win32::AbortSystemShutdown(MACHINE), Win32::BuildNumber(),
-Win32::CopyFile(FROM, TO, OVERWRITE), Win32::DomainName(),
-Win32::ExpandEnvironmentStrings(STRING), Win32::FormatMessage(ERRORCODE),
-Win32::FsType(), Win32::FreeLibrary(HANDLE), Win32::GetArchName(),
-Win32::GetChipName(), Win32::GetCwd(), Win32::GetFolderPath(FOLDER [,
-CREATE]), Win32::GetFullPathName(FILENAME), Win32::GetLastError(),
-Win32::GetLongPathName(PATHNAME), Win32::GetNextAvailDrive(),
-Win32::GetOSVersion(), Win32::GetOSName(),
-Win32::GetShortPathName(PATHNAME), Win32::GetProcAddress(INSTANCE,
-PROCNAME), Win32::GetTickCount(), Win32::InitiateSystemShutdown,
-Win32::IsWinNT(), Win32::IsWin95(), Win32::LoadLibrary(LIBNAME),
-Win32::LoginName(), Win32::LookupAccountName(SYSTEM, ACCOUNT, DOMAIN, SID,
-SIDTYPE), Win32::LookupAccountSID(SYSTEM, SID, ACCOUNT, DOMAIN, SIDTYPE),
-Win32::MsgBox(MESSAGE [, FLAGS [, TITLE]]), Win32::NodeName(),
-Win32::RegisterServer(LIBRARYNAME), Win32::SetChildShowWindow(SHOWWINDOW),
-Win32::SetCwd(NEWDIRECTORY), Win32::SetLastError(ERROR),
-Win32::Sleep(TIME), Win32::Spawn(COMMAND, ARGS, PID),
-Win32::UnregisterServer(LIBRARYNAME)
-
-=back
-
-=back
-
=head2 XSLoader - Dynamically load C libraries into Perl code
=over 4