X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=pod%2Fperltoc.pod;h=0a7987bb367b41db87912586113b98a4446d329a;hb=9b5c3821be1f2a9a84772171c8bbadbf9cfc4a53;hp=e1e5d495b2a4e6f2b92ddb80122e5aaaffc02f10;hpb=82eec310b600a6d519d9b90c3bf92d52e5977e8c;p=p5sagit%2Fp5-mst-13.2.git diff --git a/pod/perltoc.pod b/pod/perltoc.pod index e1e5d49..0a7987b 100644 --- a/pod/perltoc.pod +++ b/pod/perltoc.pod @@ -765,8 +765,8 @@ LIMIT specified =back -=head2 perlfaq - frequently asked questions about Perl ($Date: 2003/01/31 -17:37:17 $) +=head2 perlfaq - frequently asked questions about Perl ($Date: 2004/10/05 +22:15:44 $) =over 4 @@ -829,8 +829,8 @@ Interaction, perlfaq9 - Networking =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.15 $, $Date: +2004/10/11 05:06:29 $) =over 4 @@ -878,8 +878,8 @@ Scheme, or Tcl? =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.29 $, +$Date: 2004/10/25 18:37:23 $) =over 4 @@ -934,8 +934,8 @@ References, Tutorials, Task-Oriented, Special Topics =back -=head2 perlfaq3 - Programming Tools ($Revision: 1.33 $, $Date: 2003/01/31 -17:34:56 $) +=head2 perlfaq3 - Programming Tools ($Revision: 1.41 $, $Date: 2004/11/03 +22:45:32 $) =over 4 @@ -963,9 +963,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+, OptiPerl, -GNU Emacs, MicroEMACS, XEmacs, Jed, Elvis, Vile, Vim, Codewright, -MultiEdit, SlickEdit, Bash, Ksh, Tcsh, Zsh, BBEdit and BBEdit Lite, Alpha +Eclipse, Komodo, Open Perl IDE, OptiPerl, PerlBuilder, visiPerl+, Visual +Perl, GNU Emacs, MicroEMACS, XEmacs, Jed, Elvis, Vile, Vim, Codewright, +MultiEdit, SlickEdit, Bash, Ksh, Tcsh, Zsh, Affrus, Alpha, BBEdit and +BBEdit Lite =item Where can I get Perl macros for vi? @@ -1021,8 +1022,8 @@ my C program; what am I doing wrong? =back -=head2 perlfaq4 - Data Manipulation ($Revision: 1.44 $, $Date: 2003/07/28 -17:35:21 $) +=head2 perlfaq4 - Data Manipulation ($Revision: 1.56 $, $Date: 2004/11/03 +22:47:56 $) =over 4 @@ -1035,12 +1036,14 @@ my C program; what am I doing wrong? =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 @@ -1238,8 +1241,8 @@ array of hashes or arrays? =back -=head2 perlfaq5 - Files and Formats ($Revision: 1.28 $, $Date: 2003/01/26 -17:45:46 $) +=head2 perlfaq5 - Files and Formats ($Revision: 1.31 $, $Date: 2004/02/07 +04:29:50 $) =over 4 @@ -1334,8 +1337,8 @@ protected files? Isn't this a bug in Perl? =back -=head2 perlfaq6 - Regular Expressions ($Revision: 1.20 $, $Date: 2003/01/03 -20:05:28 $) +=head2 perlfaq6 - Regular Expressions ($Revision: 1.27 $, $Date: 2004/11/03 +22:52:16 $) =over 4 @@ -1389,7 +1392,7 @@ file? =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? @@ -1401,8 +1404,8 @@ file? =back -=head2 perlfaq7 - General Perl Language Issues ($Revision: 1.15 $, $Date: -2003/07/24 02:17:21 $) +=head2 perlfaq7 - General Perl Language Issues ($Revision: 1.18 $, $Date: +2004/11/03 22:54:08 $) =over 4 @@ -1483,8 +1486,8 @@ methods? =back -=head2 perlfaq8 - System Interaction ($Revision: 1.17 $, $Date: 2003/01/26 -17:44:04 $) +=head2 perlfaq8 - System Interaction ($Revision: 1.22 $, $Date: 2004/10/05 +22:13:49 $) =over 4 @@ -1592,6 +1595,8 @@ complete? =item How do I open a file without blocking? +=item How do I tell the difference between errors from the shell and perl? + =item How do I install a module from CPAN? =item What's the difference between require and use? @@ -1601,7 +1606,7 @@ complete? =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? @@ -1611,7 +1616,7 @@ search path? =back -=head2 perlfaq9 - Networking ($Revision: 1.15 $, $Date: 2003/01/31 17:36:57 +=head2 perlfaq9 - Networking ($Revision: 1.16 $, $Date: 2004/10/30 12:20:59 $) =over 4 @@ -1695,6 +1700,10 @@ CGI script to do bad things? =item Simple Statements +=item Truth and Falsehood + +=item Statement Modifiers + =item Compound Statements =item Loop Control @@ -1749,12 +1758,12 @@ CGI script to do bad things? =over 4 -=item SYNOPSIS - =item DESCRIPTION =over 4 +=item Operator Precedence and Associativity + =item Terms and List Operators (Leftward) =item The Arrow Operator @@ -1830,6 +1839,8 @@ regular expressions =item Constant Folding +=item No-ops + =item Bitwise String Operators =item Integer Arithmetic @@ -1973,7 +1984,7 @@ width, size, order of arguments, sqrt EXPR, sqrt, srand EXPR, srand, stat FILEHANDLE, stat EXPR, stat, study SCALAR, study, sub NAME BLOCK, sub NAME (PROTO) BLOCK, sub NAME : ATTRS BLOCK, sub NAME (PROTO) : ATTRS BLOCK, substr EXPR,OFFSET,LENGTH,REPLACEMENT, substr EXPR,OFFSET,LENGTH, substr -EXPR,OFFSET, symlink OLDFILE,NEWFILE, syscall LIST, sysopen +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 @@ -2085,6 +2096,8 @@ PID,FLAGS, wantarray, warn LIST, write FILEHANDLE, write EXPR, write, y/// =item How to Eat an Egg on a Net +=item Byte-order modifiers + =item Floating point Numbers =back @@ -2125,6 +2138,8 @@ PID,FLAGS, wantarray, warn LIST, write FILEHANDLE, write EXPR, write, y/// =item The Alignment Pit +=item Dealing with Endian-ness + =item Alignment, Take 2 =item Alignment, Take 3 @@ -2158,7 +2173,8 @@ PID,FLAGS, wantarray, warn LIST, write FILEHANDLE, write EXPR, write, y/// C<=head1 I>, C<=head2 I>, C<=head3 I>, C<=head4 I>, C<=over I>, C<=item I>, C<=back>, C<=cut>, C<=pod>, C<=begin I>, C<=end -I>, C<=for I I> +I>, C<=for I I>, C<=encoding +I> =item Formatting Codes @@ -2195,7 +2211,8 @@ notes =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 @@ -2241,13 +2258,14 @@ OS/2, MS-DOS, Win95/NT, Macintosh, VMS =item Command Switches B<-0>[I], B<-A [I]>, B<-a>, B<-C -[I]>, B<-c>, B<-d>, B<-d:>I, B<-D>I, -B<-D>I, B<-e> I, B<-F>I, B<-h>, -B<-i>[I], B<-I>I, B<-l>[I], -B<-m>[B<->]I, B<-M>[B<->]I, B<-M>[B<->]I<'module ...'>, +[I]>, B<-c>, B<-d>, B<-dt>, B<-d:>I, +B<-dt:>I, B<-D>I, B<-D>I, B<-e> +I, B<-F>I, B<-h>, B<-i>[I], +B<-I>I, B<-l>[I], B<-m>[B<->]I, +B<-M>[B<->]I, B<-M>[B<->]I<'module ...'>, B<-[mM]>[B<->]I, B<-n>, B<-p>, B<-P>, B<-s>, B<-S>, -B<-t>, B<-T>, B<-u>, B<-U>, B<-v>, B<-V>, B<-V:>I, B<-w>, B<-W>, -B<-X>, B<-x> I +B<-t>, B<-T>, B<-u>, B<-U>, B<-v>, B<-V>, B<-V:>I, B<-w>, B<-W>, +B<-X>, B<-x>, B<-x> I =back @@ -2255,10 +2273,11 @@ B<-X>, B<-x> I 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) +PERL5DB, PERL5DB_THREADED, PERL5SHELL (specific to the Win32 port), +PERL_ALLOW_NON_IFS_LSP (specific to the Win32 port), PERL_DEBUG_MSTATS, +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 @@ -2382,7 +2401,7 @@ IO::Handle->input_record_separator(EXPR), $INPUT_RECORD_SEPARATOR, $RS, $/, 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, @@ -2539,6 +2558,24 @@ C<(?(condition)yes-pattern|no-pattern)> =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 @@ -2618,7 +2655,7 @@ this 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 @@ -3132,22 +3169,21 @@ http://testers.cpan.org/ =item Alphabetical Listing of Perl Functions --I FILEHANDLE, -I EXPR, -I, 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 FILEHANDLE, -I EXPR, -I, 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 @@ -3335,7 +3371,8 @@ LC_NUMERIC, LC_TIME, LANG =item Important Caveats Input and Output Layers, Regular Expressions, C 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 needed to upgrade non-Latin-1 byte strings =item Byte and Character Semantics @@ -3525,6 +3562,8 @@ chcp, dataset access, OS/390, z/OS iconv, locales =item Switches On the "#!" Line +=item Taint mode and @INC + =item Cleaning Up Your Path =item Security Bugs @@ -3553,7 +3592,7 @@ chcp, dataset access, OS/390, z/OS iconv, locales =item Symbol Tables -=item Package Constructors and Destructors +=item BEGIN, CHECK, INIT and END =item Perl Classes @@ -3591,20 +3630,21 @@ B::Deparse, B::Disassembler, B::Lint, B::Showlex, B::Stackobj, B::Stash, B::Terse, B::Xref, Benchmark, ByteLoader, CGI, CGI::Apache, CGI::Carp, CGI::Cookie, CGI::Fast, CGI::Pretty, CGI::Push, CGI::Switch, CGI::Util, CPAN, CPAN::FirstTime, CPAN::Nox, Carp, Carp::Heavy, Class::ISA, -Class::Struct, Config, Cwd, DB, DB_File, 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, @@ -3623,7 +3663,7 @@ IPC::SysV::Semaphore, List::Util, Locale::Constants, Locale::Country, Locale::Currency, Locale::Language, Locale::Maketext, Locale::Maketext::TPJ13, Locale::Script, MIME::Base64, MIME::Base64::QuotedPrint, Math::BigFloat, Math::BigInt, -Math::BigInt::Calc, Math::BigInt::Scalar, Math::BigRat, Math::Complex, +Math::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, @@ -3864,9 +3904,9 @@ Look around, Check it's new, Discuss the need, Choose a name, Check again =item Step-by-step: Making the module -Start with F, Use L and L, Use -L, Use L - wisely!, Use L, Write tests, Write the README +Start with F or F, Use L and +L, Use L, Use L - wisely!, +Use L, Write tests, Write the README =item Step-by-step: Distributing your module @@ -4214,6 +4254,8 @@ C, C, C =item The RETVAL Variable +=item Returning SVs, AVs and HVs through RETVAL + =item The MODULE Keyword =item The PACKAGE Keyword @@ -4465,7 +4507,7 @@ save_hptr(HV **hptr)> =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 @@ -4475,6 +4517,8 @@ A, p, d, s, n, r, f, M, o, j, x =item Source Documentation +=item Backwards compatibility + =back =item Unicode Support @@ -4483,13 +4527,13 @@ A, p, d, s, n, r, f, M, o, j, x =item What B 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? @@ -4603,7 +4647,7 @@ GIMME, GIMME_V, G_ARRAY, G_DISCARD, G_EVAL, G_NOARGS, G_SCALAR, G_VOID 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 @@ -4620,7 +4664,7 @@ perl_clone =item CV Manipulation Functions -CvSTASH, get_cv, Nullcv +CvSTASH, get_cv =item Embedding Functions @@ -4638,36 +4682,38 @@ PL_modglobal, PL_na, PL_sv_no, PL_sv_undef, PL_sv_yes =item GV Functions GvSV, gv_fetchmeth, gv_fetchmethod, gv_fetchmethod_autoload, -gv_fetchmeth_autoload, gv_stashpv, gv_stashsv +gv_fetchmeth_autoload, gv_stashpv, gv_stashpvn, gv_stashsv =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, savesvpv, 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 @@ -4684,11 +4730,13 @@ pad_sv =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 @@ -4696,53 +4744,55 @@ svtype, SVt_IV, SVt_NV, SVt_PV, SVt_PVAV, SVt_PVCV, SVt_PVHV, SVt_PVMG =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, -SvNIOK_off, SvNOK, SvNOKp, SvNOK_off, SvNOK_on, SvNOK_only, SvNV, SvNVX, -SvNVx, SvOK, SvOOK, SvPOK, SvPOKp, SvPOK_off, SvPOK_on, SvPOK_only, +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, -sv_setpvn_mg, sv_setpv_mg, sv_setref_iv, sv_setref_nv, sv_setref_pv, -sv_setref_pvn, sv_setref_uv, sv_setsv, sv_setsv_flags, sv_setsv_mg, -sv_setuv, sv_setuv_mg, sv_taint, sv_tainted, sv_true, sv_unmagic, sv_unref, -sv_unref_flags, sv_untaint, sv_upgrade, sv_usepvn, sv_usepvn_mg, -sv_utf8_decode, sv_utf8_downgrade, sv_utf8_encode, sv_utf8_upgrade, -sv_utf8_upgrade_flags, sv_uv, sv_vcatpvfn, sv_vsetpvfn +SvPVutf8_force, SvPVutf8_nolen, SvPVX, SvPVx, SvPV_force, SvPV_force_nomg, +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_catpvn_nomg, sv_catpv_mg, sv_catsv, sv_catsv_flags, +sv_catsv_mg, sv_catsv_nomg, 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_setsv_nomg, 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_vcatpvf, sv_vcatpvfn, sv_vcatpvf_mg, sv_vsetpvf, sv_vsetpvfn, +sv_vsetpvf_mg =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 and C 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 @@ -4770,8 +4820,8 @@ CvWEAKOUTSIDE 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 @@ -4803,7 +4853,8 @@ djSP, LVRET =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 @@ -4823,6 +4874,8 @@ report_uninit, sv_add_arena, sv_clean_all, sv_clean_objs, sv_free_arenas =item History and Background +=item Basic Structure + =item Layers vs Disciplines =item Data Structures @@ -4848,6 +4901,8 @@ Getarg, Fileno, Dup, Read, Write, Seek, Tell, Close, Flush, Fill, Eof, Error, Clearerr, Setlinebuf, Get_base, Get_bufsiz, Get_ptr, Get_cnt, Set_ptrcnt +=item Utilities + =item Implementing PerlIO Layers C implementations, Perl implementations @@ -4939,6 +4994,8 @@ It's easier to rsync the source tree, It's more reliable It's easier to rsync the patches, It's a good reference, Finding a start point, Finding how to fix a bug, Finding the source of misbehaviour +=item Working with the source + =item Perlbug administration =item Submitting patches @@ -4991,10 +5048,10 @@ t/cmd t/run t/io t/op, t/lib ext lib =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, minitest.utf16 test.utf16, test_harness =item Running tests by hand @@ -5061,417 +5118,717 @@ I =item DESCRIPTION -=item To do during 5.6.x +=item assertions + +=item iCOW + +=item (?{...}) closures in regexps + +=item A re-entrant regexp engine + +=item pragmata =over 4 -=item Support for I/O disciplines +=item lexical pragmas -=item Autoload bytes.pm +=item use less 'memory' -=item Make "\u{XXXX}" et al work +=back -=item Create a char *sv_pvprintify(sv, STRLEN *lenp, UV flags) +=item prototypes and functions -=item Overloadable regex assertions +=over 4 -=item Unicode +=item _ prototype character -=item Work out exit/die semantics for threads +=item inlining autoloaded constants -=item Better support for nonpreemptive threading systems like GNU pth +=item Finish off lvalue functions -=item Typed lexicals for compiler +=back -=item Compiler workarounds for Win32 +=item Unicode and UTF8 -=item AUTOLOADing in the compiler +=over 4 -=item Fixing comppadlist when compiling +=item Implicit Latin 1 => Unicode translation -=item Cleaning up exported namespace +=item UTF8 caching code -=item Complete signal handling +=item Unicode in Filenames -=item Out-of-source builds +=item Unicode in %ENV -=item POSIX realtime support +=back -=item UNIX98 support +=item Regexps -=item IPv6 Support +=over 4 -=item Long double conversion +=item regexp optimiser optional -=item Locales +=item common suffices/prefices in regexps (trie optimization) -=item Arithmetic on non-Arabic numerals +=back -=item POSIX Unicode character classes +=item POD -=item Factoring out common suffices/prefices in regexps (trie optimization) +=over 4 -=item Security audit shipped utilities +=item POD -> HTML conversion still sucks -=item Sort out the uid-setting mess +=back -=item Custom opcodes +=item Misc medium sized projects -=item DLL Versioning +=over 4 -=item Introduce @( and @) +=item UNITCHECK -=item Floating point handling +=item optional optimizer -=item IV/UV preservation +=item You WANT *how* many -=item Replace pod2html with something using Pod::Parser +=item lexical aliases -=item Automate module testing on CPAN +=item no 6 -=item sendmsg and recvmsg +=item IPv6 -=item Rewrite perlre documentation +=item entersub XS vs Perl -=item Convert example code to IO::Handle filehandles +=item @INC source filter to Filter::Simple -=item Document Win32 choices +=item bincompat functions -=item Check new modules +=item Use fchown/fchmod internally -=item Make roffitall find pods and libs itself +=item Constant folding =back -=item To do at some point +=item Tests =over 4 -=item Remove regular expression recursion +=item Make Schwern poorer -=item Memory leaks after failed eval +=item test B -=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 EE +=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 + +=item readpipe(LIST) + +=item Self ties + +=back + +=back + +=head2 perldoc - Look up Perl documentation in Pod format. + +=over 4 + +=item SYNOPSIS -=item Install HTML +=item DESCRIPTION -=item Prototype method calls +=item OPTIONS -=item Return context prototype declarations +B<-h>, B<-v>, B<-t>, B<-u>, B<-m> I, B<-l>, B<-F>, B<-f> +I, B<-q> I, B<-T>, B<-d> +I, B<-o> I, B<-M> I, +B<-w> I or B<-w> I