[differences between cumulative patch application and perl5.004]
[p5sagit/p5-mst-13.2.git] / pod / perltoc.pod
index a70ed6e..d58f12c 100644 (file)
@@ -38,8 +38,8 @@ expression enhancements, Innumerable Unbundled Modules, Compilability
 
 =item NOTES
 
-=head2 perlfaq - frequently asked questions about Perl ($Date: 1997/04/23
-18:11:06 $)
+=head2 perlfaq - frequently asked questions about Perl ($Date: 1997/04/24
+22:46:06 $)
 
 =item DESCRIPTION
 
@@ -76,11 +76,11 @@ authors
 
 =item Changes
 
-23/April/97, 25/March/97, 18/March/97, 17/March/97 Version, Initial
-Release: 11/March/97
+24/April/97, 23/April/97, 25/March/97, 18/March/97, 17/March/97 Version,
+Initial Release: 11/March/97
 
-=head2 perlfaq1 - General Questions About Perl ($Revision: 1.11 $, $Date:
-1997/03/19 17:23:09 $)
+=head2 perlfaq1 - General Questions About Perl ($Revision: 1.12 $, $Date:
+1997/04/24 22:43:34 $)
 
 =item DESCRIPTION
 
@@ -176,8 +176,8 @@ MacPerl, Perl5-Porters, NTPerl, Perl-Packrats
 
 =item AUTHOR AND COPYRIGHT
 
-=head2 perlfaq3 - Programming Tools ($Revision: 1.21 $, $Date: 1997/04/23
-18:04:23 $)
+=head2 perlfaq3 - Programming Tools ($Revision: 1.22 $, $Date: 1997/04/24
+22:43:42 $)
 
 =item DESCRIPTION
 
@@ -251,8 +251,8 @@ mean?
 
 =item AUTHOR AND COPYRIGHT
 
-=head2 perlfaq4 - Data Manipulation ($Revision: 1.18 $, $Date: 1997/04/23
-18:04:37 $)
+=head2 perlfaq4 - Data Manipulation ($Revision: 1.19 $, $Date: 1997/04/24
+22:43:57 $)
 
 =item DESCRIPTION
 
@@ -418,8 +418,8 @@ it?
 =item Why does passing a subroutine an undefined element in a hash create
 it?
 
-=item How can I make the Perl equivalent of a C structure/C++ class/hash
-or array of hashes or arrays?
+=item How can I make the Perl equivalent of a C structure/C++ class/hash or
+array of hashes or arrays?
 
 =item How can I use a reference as a hash key?
 
@@ -445,8 +445,8 @@ or array of hashes or arrays?
 
 =item AUTHOR AND COPYRIGHT
 
-=head2 perlfaq5 - Files and Formats ($Revision: 1.21 $, $Date: 1997/04/23
-18:05:19 $)
+=head2 perlfaq5 - Files and Formats ($Revision: 1.22 $, $Date: 1997/04/24
+22:44:02 $)
 
 =item DESCRIPTION
 
@@ -488,8 +488,8 @@ filehandles between subroutines?  How do I make an array of filehandles?
 
 =item What can't I just open(FH, ">file.lock")?
 
-=item I still don't get locking.  I just want to increment the number
-in the file.  How can I do this?
+=item I still don't get locking.  I just want to increment the number in
+the file.  How can I do this?
 
 =item How do I randomly update a binary file?
 
@@ -529,7 +529,7 @@ protected files?  Isn't this a bug in Perl?
 
 =item AUTHOR AND COPYRIGHT
 
-=head2 perlfaq6 - Regexps ($Revision: 1.16 $, $Date: 1997/03/25 18:16:56 $)
+=head2 perlfaq6 - Regexps ($Revision: 1.17 $, $Date: 1997/04/24 22:44:10 $)
 
 =item DESCRIPTION
 
@@ -590,8 +590,8 @@ file?
 
 =item AUTHOR AND COPYRIGHT
 
-=head2 perlfaq7 - Perl Language Issues ($Revision: 1.16 $, $Date:
-1997/03/19 17:25:23 $)
+=head2 perlfaq7 - Perl Language Issues ($Revision: 1.18 $, $Date:
+1997/04/24 22:44:14 $)
 
 =item DESCRIPTION
 
@@ -661,8 +661,8 @@ is in scope?
 
 =item AUTHOR AND COPYRIGHT
 
-=head2 perlfaq8 - System Interaction ($Revision: 1.20 $, $Date: 1997/04/23
-18:11:50 $)
+=head2 perlfaq8 - System Interaction ($Revision: 1.21 $, $Date: 1997/04/24
+22:44:19 $)
 
 =item DESCRIPTION
 
@@ -771,6 +771,61 @@ search path?
 
 =back
 
+=item How do I get one key from the terminal at a time, under POSIX?
+
+=item AUTHOR AND COPYRIGHT
+
+=item DESCRIPTION
+
+=over
+
+=item My CGI script runs from the command line but not the browser.  Can
+you help me fix it?
+
+=item How do I remove HTML from a string?
+
+=item How do I extract URLs?
+
+=item How do I download a file from the user's machine?  How do I open a
+file on another machine?
+
+=item How do I make a pop-up menu in HTML?
+
+=item How do I fetch an HTML file?
+
+=item how do I decode or create those %-encodings on the web?
+
+=item How do I redirect to another page?
+
+=item How do I put a password on my web pages?
+
+=item How do I edit my .htpasswd and .htgroup files with Perl?
+
+=item How do I make sure users can't enter values into a form that cause my
+CGI script to do bad things?
+
+=item How do I parse an email header?
+
+=item How do I decode a CGI form?
+
+=item How do I check a valid email address?
+
+=item How do I decode a MIME/BASE64 string?
+
+=item How do I return the user's email address?
+
+=item How do I send/read mail?
+
+=item How do I find out my hostname/domainname/IP address?
+
+=item How do I fetch a news article or the active newsgroups?
+
+=item How do I fetch/put an FTP file?
+
+=item How can I do RPC in Perl?
+
+=back
+
 =item AUTHOR AND COPYRIGHT
 
 =head2 perlfaq9 - Networking ($Revision: 1.16 $, $Date: 1997/04/23 18:12:06
@@ -843,7 +898,7 @@ CGI script to do bad things?
 
 =item $PERL5OPT environment variable
 
-=item Limitations on B<-M>, and C<-m>, and B<-T> options
+=item Limitations on B<-M>, B<-m>, and B<-T> options
 
 =item More precise warnings
 
@@ -861,6 +916,9 @@ CGI script to do bad things?
 
 =item Changes to tainting checks
 
+No glob() or <*>, No spawning if tainted $CDPATH, $ENV, $BASH_ENV, No
+spawning if tainted $TERM doesn't look like a terminal name
+
 =item New Opcode module and revised Safe module
 
 =item Embedding improvements
@@ -869,6 +927,14 @@ CGI script to do bad things?
 
 =item Internal change: PerlIO abstraction interface
 
+=item New and changed syntax
+
+$coderef->(PARAMS)
+
+=item New and changed builtin constants
+
+__PACKAGE__
+
 =item New and changed builtin variables
 
 $^E, $^H, $^M
@@ -877,7 +943,7 @@ $^E, $^H, $^M
 
 delete on slices, flock, printf and sprintf, keys as an lvalue, my() in
 Control Structures, pack() and unpack(), sysseek(), use VERSION, use Module
-VERSION LIST, prototype(FUNCTION), srand, $_ as Default, C<m//g> does not
+VERSION LIST, prototype(FUNCTION), srand, $_ as Default, C<m//gc> does not
 reset search position on failure, C<m//x> ignores whitespace before ?*+{},
 nested C<sub{}> closures work now, formats work right on changing lexicals
 
@@ -898,6 +964,20 @@ LIST, READLINE this, GETC this, DESTROY this
 
 =back
 
+=item Support for More Operating Systems
+
+=over
+
+=item Win32
+
+=item Plan 9
+
+=item QNX
+
+=item AmigaOS
+
+=back
+
 =item Pragmata
 
 use autouse MODULE => qw(sub1 sub2 sub3), use blib, use blib 'dir', use
@@ -933,6 +1013,10 @@ constant NAME => VALUE, use locale, use ops, use vmsish
 
 =over
 
+=item pod2html
+
+Sends converted HTML to standard output
+
 =item xsubpp
 
 C<void> XSUBs now default to returning nothing
@@ -946,8 +1030,8 @@ manipulating hashes
 
 =item Documentation Changes
 
-L<perldelta>, L<perllocale>, L<perltoot>, L<perlapio>, L<perldebug>,
-L<perlsec>
+L<perldelta>, L<perlfaq>, L<perllocale>, L<perltoot>, L<perlapio>,
+L<perlmodlib>, L<perldebug>, L<perlsec>
 
 =item New Diagnostics
 
@@ -955,25 +1039,27 @@ L<perlsec>
 not a HASH element or slice, Allocation too large: %lx, Allocation too
 large, Applying %s to %s will act on scalar(%s), Attempt to free
 nonexistent shared string, Attempt to use reference as lvalue in substr,
-Can't use bareword ("%s") as %s ref while "strict refs" in use, Cannot
-resolve method `%s' overloading `%s' in package `%s', Constant subroutine
-%s redefined, Constant subroutine %s undefined, Copy method did not return
-a reference, Died, Exiting pseudo-block via %s, Identifier too long,
-Illegal character %s (carriage return), Illegal switch in PERL5OPT: %s,
-Integer overflow in hex number, Integer overflow in octal number, internal
-error: glob failed, Invalid type in pack: '%s', Invalid type in unpack:
+Can't redefine active sort subroutine %s, Can't use bareword ("%s") as %s
+ref while "strict refs" in use, Cannot resolve method `%s' overloading `%s'
+in package `%s', Constant subroutine %s redefined, Constant subroutine %s
+undefined, Copy method did not return a reference, Died, Exiting
+pseudo-block via %s, Identifier too long, Illegal character %s (carriage
+return), Illegal switch in PERL5OPT: %s, Integer overflow in hex number,
+Integer overflow in octal number, internal error: glob failed, Invalid
+conversion in %s: "%s", Invalid type in pack: '%s', Invalid type in unpack:
 '%s', Name "%s::%s" used only once: possible typo, Null picture in
 formline, Offset outside string, Out of memory!, Out of memory during
-request for %s, Possible attempt to put comments in qw() list, Possible
-attempt to separate words with commas, Scalar value @%s{%s} better written
-as $%s{%s}, Stub found while resolving method `%s' overloading `%s' in
-package `%s', Too late for "B<-T>" option, untie attempted while %d inner
-references still exist, Unrecognized character %s, Unsupported function
-fork, Use of "$$<digit>" to mean "${$}<digit>" is deprecated, Value of %s
-can be "0"; test with defined(), Variable "%s" may be unavailable, Variable
-"%s" will not stay shared, Warning: something's wrong, Ill-formed logical
-name |%s| in prime_env_iter, Got an error from DosAllocMem, Malformed
-PERLLIB_PREFIX, PERL_SH_DIR too long, Process terminated by SIG%s
+request for %s, panic: frexp, Possible attempt to put comments in qw()
+list, Possible attempt to separate words with commas, Scalar value @%s{%s}
+better written as $%s{%s}, Stub found while resolving method `%s'
+overloading `%s' in package `%s', Too late for "B<-T>" option, untie
+attempted while %d inner references still exist, Unrecognized character %s,
+Unsupported function fork, Use of "$$<digit>" to mean "${$}<digit>" is
+deprecated, Value of %s can be "0"; test with defined(), Variable "%s" may
+be unavailable, Variable "%s" will not stay shared, Warning: something's
+wrong, Ill-formed logical name |%s| in prime_env_iter, Got an error from
+DosAllocMem, Malformed PERLLIB_PREFIX, PERL_SH_DIR too long, Process
+terminated by SIG%s
 
 =item BUGS
 
@@ -1126,6 +1212,8 @@ i, m, s, x
 
 =item WARNING on \1 vs $1
 
+=item SEE ALSO
+
 =back
 
 =head2 perlrun - how to execute the Perl interpreter
@@ -1309,7 +1397,7 @@ $ARGV, @ARGV, @INC, %INC, $ENV{expr}, $SIG{expr}, $^M
 
 =item SEE ALSO
 
-=head2 perlmod - Perl modules (packages)
+=head2 perlmod - Perl modules (packages and symbol tables)
 
 =item DESCRIPTION
 
@@ -1327,7 +1415,11 @@ $ARGV, @ARGV, @INC, %INC, $ENV{expr}, $SIG{expr}, $^M
 
 =back
 
-=item NOTE
+=item SEE ALSO
+
+=head2 perlmodlib - constructing new Perl modules and finding existing ones
+
+=item DESCRIPTION
 
 =item THE PERL MODULE LIBRARY
 
@@ -1335,8 +1427,8 @@ $ARGV, @ARGV, @INC, %INC, $ENV{expr}, $SIG{expr}, $^M
 
 =item Pragmatic Modules
 
-blib, diagnostics, integer, less, lib, locale, ops, overload, sigtrap,
-strict, subs, vmsish, vars
+use autouse MODULE => qw(sub1 sub2 sub3), blib, diagnostics, integer, less,
+lib, locale, ops, overload, sigtrap, strict, subs, vmsish, vars
 
 =item Standard Modules
 
@@ -1350,14 +1442,14 @@ File::Basename, File::CheckTree, File::Compare, File::Copy, File::Find,
 File::Path, File::stat, FileCache, FileHandle, FindBin, GDBM_File,
 Getopt::Long, Getopt::Std, I18N::Collate, IO, IO::File, IO::Handle,
 IO::Pipe, IO::Seekable, IO::Select, IO::Socket, IPC::Open2, IPC::Open3,
-Math::BigFloat, Math::BigInt, Math::Complex, NDBM_File, Net::Ping,
-Net::hostent, Net::netent, Net::protoent, Net::servent, Opcode, Pod::Text,
-POSIX, SDBM_File, Safe, Search::Dict, SelectSaver, SelfLoader, Shell,
-Socket, Symbol, Sys::Hostname, Sys::Syslog, Term::Cap, Term::Complete,
-Term::ReadLine, Test::Harness, Text::Abbrev, Text::ParseWords,
-Text::Soundex, Text::Tabs, Text::Wrap, Tie::Hash, Tie::RefHash,
-Tie::Scalar, Tie::SubstrHash, Time::Local, Time::gmtime, Time::localtime,
-Time::tm, UNIVERSAL, User::grent, User::pwent
+Math::BigFloat, Math::BigInt, Math::Complex, Math::Trig, NDBM_File,
+Net::Ping, Net::hostent, Net::netent, Net::protoent, Net::servent, Opcode,
+Pod::Text, POSIX, SDBM_File, Safe, Search::Dict, SelectSaver, SelfLoader,
+Shell, Socket, Symbol, Sys::Hostname, Sys::Syslog, Term::Cap,
+Term::Complete, Term::ReadLine, Test::Harness, Text::Abbrev,
+Text::ParseWords, Text::Soundex, Text::Tabs, Text::Wrap, Tie::Hash,
+Tie::RefHash, Tie::Scalar, Tie::SubstrHash, Time::Local, Time::gmtime,
+Time::localtime, Time::tm, UNIVERSAL, User::grent, User::pwent
 
 =item Extension Modules
 
@@ -1415,6 +1507,8 @@ can then be reduced to a small
 
 =back
 
+=item NOTE
+
 =head2 perlform - Perl formats
 
 =item DESCRIPTION
@@ -1850,7 +1944,7 @@ safe subprocesses, sockets, and semaphores)
 
 =item Safe Pipe Opens
 
-=item Bidirectional Communication
+=item Bidirectional Communication with Another Process
 
 =back
 
@@ -1862,13 +1956,29 @@ safe subprocesses, sockets, and semaphores)
 
 =item Unix-Domain TCP Clients and Servers
 
-=item UDP: Message Passing
+=back
+
+=item TCP Clients with IO::Socket
+
+=over
+
+=item A Simple Client
+
+C<Proto>, C<PeerAddr>, C<PeerPort>
+
+=item A Webget Client
+
+=item Interactive Client with IO::Socket
 
 =back
 
-=item SysV IPC
+=item TCP Servers with IO::Socket
 
-=item WARNING
+Proto, LocalPort, Listen, Reuse
+
+=item UDP: Message Passing
+
+=item SysV IPC
 
 =item NOTES
 
@@ -1896,13 +2006,13 @@ t, t expr, b [line] [condition], b subname [condition], b postpone subname
 command, A, O [opt[=val]] [opt"val"] [opt?].., C<recallCommand>,
 C<ShellBang>, C<pager>, C<tkRunning>, C<signalLevel>, C<warnLevel>,
 C<dieLevel>, C<AutoTrace>, C<LineInfo>, C<inhibit_exit>, C<PrintRet>,
-C<frame>, C<maxTraceLen>, C<arrayDepth>, C<hashDepth>, C<compactDump>,
-C<veryCompact>, C<globPrint>, C<DumpDBFiles>, C<DumpPackages>, C<quote>,
-C<HighBit>, C<undefPrint>, C<UsageOnly>, C<TTY>, C<noTTY>, C<ReadLine>,
-C<NonStop>, E<lt> [ command ], E<lt>E<lt> command, E<gt> command,
-E<gt>E<gt> command, { [ command ], {{ command, ! number, ! -number, !
-pattern, !! cmd, H -number, q or ^D, R, |dbcmd, ||dbcmd, = [alias value],
-command, m expr, m package
+C<ornaments>, C<frame>, C<maxTraceLen>, C<arrayDepth>, C<hashDepth>,
+C<compactDump>, C<veryCompact>, C<globPrint>, C<DumpDBFiles>,
+C<DumpPackages>, C<quote>, C<HighBit>, C<undefPrint>, C<UsageOnly>, C<TTY>,
+C<noTTY>, C<ReadLine>, C<NonStop>, E<lt> [ command ], E<lt>E<lt> command,
+E<gt> command, E<gt>E<gt> command, { [ command ], {{ command, ! number, !
+-number, ! pattern, !! cmd, H -number, q or ^D, R, |dbcmd, ||dbcmd, =
+[alias value], command, m expr, m package
 
 =item Debugger input/output
 
@@ -2795,7 +2905,7 @@ clearcache ( COUNT ), clearallcache ( ), disablecache ( ), enablecache ( )
 
 =item ABSTRACT
 
-=item INSTALLATION:
+=item INSTALLATION
 
 =item DESCRIPTION
 
@@ -2841,7 +2951,7 @@ B<Parameters:>, 4, 5, 6..
 
 =back
 
-=item CREATING FORMS:
+=item CREATING FORMS
 
 =over
 
@@ -2914,6 +3024,8 @@ B<-name>, B<-value>, B<-path>, B<-domain>, B<-expires>, B<-secure>
 document in the HTTP header, 3. Specify the destination for the document in
 the <FORM> tag
 
+=item LIMITED SUPPORT FOR CASCADING STYLE SHEETS
+
 =item DEBUGGING
 
 =over
@@ -2931,7 +3043,7 @@ scripts, B<referer()>, B<auth_type ()>, B<server_name ()>, B<virtual_host
 ()>, B<server_software ()>, B<remote_user ()>, B<user_name ()>,
 B<request_method()>
 
-=item CREATING HTML ELEMENTS:
+=item CREATING HTML ELEMENTS
 
 =over