A bit of "perl.com" cleanup.
Jarkko Hietaniemi [Fri, 4 Jan 2002 22:56:23 +0000 (22:56 +0000)]
p4raw-id: //depot/perl@14083

pod/perldelta.pod
pod/perldiag.pod
pod/perlfaq.pod
pod/perlfaq1.pod
pod/perlfaq2.pod
pod/perlfaq3.pod
pod/perlfaq4.pod
pod/perlfaq5.pod
pod/perlfaq8.pod
pod/perlmodlib.PL
pod/perlmodlib.pod

index a074ead..0ae001b 100644 (file)
@@ -2595,7 +2595,7 @@ from the CPAN.
 If you find what you think is a bug, you might check the articles
 recently posted to the comp.lang.perl.misc newsgroup and the perl
 bug database at http://bugs.perl.org.  There may also be
-information at http://www.perl.com/perl/, the Perl Home Page.
+information at http://www.perl.com/, the Perl Home Page.
 
 If you believe you have an unreported bug, please run the B<perlbug>
 program included with your release.  Be sure to trim your bug down
index 2c10474..29358ea 100644 (file)
@@ -3176,11 +3176,9 @@ account you tested it under), does not rely on any environment variables
 location where the CGI server can't find it, basically, more or less.
 Please see the following for more information:
 
-       http://www.cpan.org/doc/FAQs/cgi/idiots-guide.html
-       http://www.cpan.org/doc/FAQs/cgi/perl-cgi-faq.html
-       ftp://rtfm.mit.edu/pub/usenet/news.answers/www/cgi-faq
-       http://hoohoo.ncsa.uiuc.edu/cgi/interface.html
-       http://www-genome.wi.mit.edu/WWW/faqs/www-security-faq.html
+       http://www.perl.org/CGI_MetaFAQ.html
+       http://www.htmlhelp.org/faq/cgifaq.html
+       http://www.w3.org/Security/Faq/
 
 You should also look at L<perlfaq9>.
 
index e0649fb..2629078 100644 (file)
@@ -1296,14 +1296,13 @@ How can I do RPC in Perl?
 =head2 Where to get the perlfaq
 
 This document is posted regularly to comp.lang.perl.announce and
-several other related newsgroups.  It is available in a variety of
-formats from CPAN in the /CPAN/doc/FAQs/FAQ/ directory or on the web
-at http://www.perl.com/perl/faq/ .
+several other related newsgroups.  It is available on many
+web sites: http://www.perldoc.com/ and http://perlfaq.cpan.org/ .
 
 =head2 How to contribute to the perlfaq
 
 You may mail corrections, additions, and suggestions to
-perlfaq-suggestions@perl.com .  This alias should not be 
+perlfaq-workers@perl.org .  This alias should not be 
 used to I<ask> FAQs.  It's for fixing the current FAQ.
 Send questions to the comp.lang.perl.misc newsgroup.
 
@@ -1311,7 +1310,7 @@ Send questions to the comp.lang.perl.misc newsgroup.
 
 Your questions will probably go unread, unless they're suggestions of
 new questions to add to the FAQ, in which case they should have gone
-to the perlfaq-suggestions@perl.com instead.
+to the perlfaq-workers@perl.org instead.
 
 You should have read section 2 of this faq.  There you would have
 learned that comp.lang.perl.misc is the appropriate place to go for
index e9b1ef7..682c815 100644 (file)
@@ -35,8 +35,11 @@ for Perl's milestone releases.
 In particular, the core development team (known as the Perl Porters)
 are a rag-tag band of highly altruistic individuals committed to
 producing better software for free than you could hope to purchase for
-money.  You may snoop on pending developments via
-nntp://news.perl.com/perl.porters-gw/
+money.  You may snoop on pending developments via the archives at
+http://www.xray.mpe.mpg.de/mailing-lists/perl5-porters/ 
+and http://archive.develooper.com/perl5-porters@perl.org/ 
+or the news gateway news://news.perl.com/perl.porters-gw/ ,
+or read the faq at http://perlhacker.org/p5p-faq,
 or you can subscribe to the mailing list by sending
 perl5-porters-request@perl.org a subscription request
 (an empty message with no subject is fine).
index 71be980..b6068fa 100644 (file)
@@ -129,6 +129,7 @@ miscellaneous modules.
 See http://www.cpan.org/modules/00modlist.long.html or
 http://search.cpan.org/ for a more complete list of modules by category.
 
+CPAN is not affiliated with O'Reilly and Associates.
 
 =head2 Is there an ISO or ANSI certified version of Perl?
 
@@ -493,7 +494,7 @@ bugs.
 
 Read the perlbug(1) man page (perl5.004 or later) for more information.
 
-=head2 What is perl.com? Perl Mongers? pm.org? perl.org?
+=head2 What is perl.com? Perl Mongers? pm.org? perl.org? cpan.org?
 
 The Perl Home Page at http://www.perl.com/ is currently hosted by
 The O'Reilly Network, a subsidiary of O'Reilly and Associates.
@@ -519,6 +520,10 @@ and there are many other sub-domains for special topics, such as
     http://news.perl.org/
     http://use.perl.org/
 
+http://www.cpan.org/ is the Comprehensive Perl Archive Network,
+a replicated worlwide repository of Perl software, see
+the I<What is CPAN?> question earlier in this document.
+
 =head1 AUTHOR AND COPYRIGHT
 
 Copyright (c) 1997-2001 Tom Christiansen and Nathan Torkington.
index 7e0c193..a592c57 100644 (file)
@@ -22,8 +22,9 @@ Have you read the appropriate manpages?  Here's a brief index:
        Regexes         perlre, perlfunc, perlop, perllocale
        Moving to perl5 perltrap, perl
        Linking w/C     perlxstut, perlxs, perlcall, perlguts, perlembed
-       Various         http://www.cpan.org/doc/FMTEYEWTK/index.html
-                       (not a man-page but still useful)
+       Various         http://www.cpan.org/misc/olddoc/FMTEYEWTK.tgz
+                       (not a man-page but still useful, a collection
+                        of various essays on Perl techniques)
 
 A crude table of contents for the Perl manpage set is found in L<perltoc>.
 
@@ -154,13 +155,9 @@ for indenting, ^D is for undenting, and ^O is for blockdenting--
 as it were.  A more complete example, with comments, can be found at
 http://www.cpan.org/authors/id/TOMC/scripts/toms.exrc.gz
 
-If you are used to using the I<vgrind> program for printing out nice code
-to a laser printer, you can take a stab at this using
-http://www.cpan.org/doc/misc/tips/working.vgrind.entry, but the
-results are not particularly satisfying for sophisticated code.
-
-The a2ps at http://www.infres.enst.fr/%7Edemaille/a2ps/ does lots of things
-related to generating nicely printed output of documents.
+The a2ps http://www-inf.enst.fr/%7Edemaille/a2ps/black+white.ps does
+lots of things related to generating nicely printed output of
+documents, as does enscript at http://people.ssh.fi/mtr/genscript/.
 
 =head2 Is there a ctags for Perl?
 
@@ -873,9 +870,13 @@ guides and references in L<perlfaq9> or in the CGI MetaFAQ:
 =head2 Where can I learn about object-oriented Perl programming?
 
 A good place to start is L<perltoot>, and you can use L<perlobj>,
-L<perlboot>, and L<perlbot> for reference.  Perltoot didn't come out
-until the 5.004 release; you can get a copy (in pod, html, or
-postscript) from http://www.cpan.org/doc/FMTEYEWTK/ .
+L<perlboot>, L<perltoot>, L<perltooc>, and L<perlbot> for reference.
+(If you are using really old Perl, you may not have all of these,
+try http://www.perldoc.com/ , but consider upgrading your perl.)
+
+A good book on OO on Perl is the "Object-Oriented Perl"
+by Damian Conway from Manning Publications, 
+http://www.manning.com/Conway/index.html
 
 =head2 Where can I learn about linking C with Perl? [h2xs, xsubpp]
 
index 08c7651..abbb9a0 100644 (file)
@@ -333,10 +333,11 @@ call C<srand> more than once--you make your numbers less random, rather
 than more.
 
 Computers are good at being predictable and bad at being random
-(despite appearances caused by bugs in your programs :-).
-http://www.cpan.org/doc/FMTEYEWTK/random , courtesy of Tom
-Phoenix, talks more about this.  John von Neumann said, ``Anyone who
-attempts to generate random numbers by deterministic means is, of
+(despite appearances caused by bugs in your programs :-).  see the
+F<random> artitcle in the "Far More Than You Ever Wanted To Know"
+collection in http://www.cpan.org/olddoc/FMTEYEWTK.tgz , courtesy of
+Tom Phoenix, talks more about this.  John von Neumann said, ``Anyone
+who attempts to generate random numbers by deterministic means is, of
 course, living in a state of sin.''
 
 If you want numbers that are more random than C<rand> with C<srand>
@@ -1473,8 +1474,9 @@ If you need to sort on several fields, the following paradigm is useful.
 This can be conveniently combined with precalculation of keys as given
 above.
 
-See http://www.cpan.org/doc/FMTEYEWTK/sort.html for more about
-this approach.
+See the F<sort> artitcle article in the "Far More Than You Ever Wanted
+To Know" collection in http://www.cpan.org/olddoc/FMTEYEWTK.tgz for
+more about this approach.
 
 See also the question below on sorting hashes.
 
index 80a8fb6..ef7b5cb 100644 (file)
@@ -1128,9 +1128,9 @@ documentation for details.
 
 =head2 Why does Perl let me delete read-only files?  Why does C<-i> clobber protected files?  Isn't this a bug in Perl?
 
-This is elaborately and painstakingly described in the "Far More Than
-You Ever Wanted To Know" in
-http://www.cpan.org/doc/FMTEYEWTK/file-dir-perms .
+This is elaborately and painstakingly described in the
+F<file-dir-perms> article in the "Far More Than You Ever Wanted To
+Know" collection in http://www.cpan.org/olddoc/FMTEYEWTK.tgz .
 
 The executive summary: learn how your filesystem works.  The
 permissions on a file say what can happen to the data in that file.
index bf5d7a6..0f65a30 100644 (file)
@@ -634,9 +634,10 @@ STDOUT).
 
 Note that you I<must> use Bourne shell (sh(1)) redirection syntax in
 backticks, not csh(1)!  Details on why Perl's system() and backtick
-and pipe opens all use the Bourne shell are in
-http://www.cpan.org/doc/FMTEYEWTK/versus/csh.whynot .
-To capture a command's STDERR and STDOUT together:
+and pipe opens all use the Bourne shell are in the
+F<versus/csh.whynot> article in the "Far More Than You Ever Wanted To
+Know" collection in http://www.cpan.org/olddoc/FMTEYEWTK.tgz .  To
+capture a command's STDERR and STDOUT together:
 
     $output = `cmd 2>&1`;                       # either with backticks
     $pid = open(PH, "cmd 2>&1 |");              # or with an open pipe
index 9b3536f..9a62369 100644 (file)
@@ -165,8 +165,7 @@ CPAN stands for Comprehensive Perl Archive Network; it's a globally
 replicated trove of Perl materials, including documentation, style
 guides, tricks and traps, alternate ports to non-Unix systems and
 occasional binary distributions for these.   Search engines for
-CPAN can be found at http://cpan.perl.com/ and at
-http://theory.uwinnipeg.ca/mod_perl/cpan-search.pl .
+CPAN can be found at http://www.cpan.org/.
 
 Most importantly, CPAN includes around a thousand unbundled modules,
 some of which require a C compiler to build.  Major categories of
index 67ea1a3..8ad8072 100644 (file)
@@ -53,10 +53,6 @@ The following pragmas are defined (and have their own documentation).
 
 Get/set subroutine or variable attributes
 
-=item attrs
-
-Set/get attributes of a subroutine (deprecated)
-
 =item autouse
 
 Postpone load of modules until a function is used
@@ -113,18 +109,10 @@ Use and avoid POSIX locales for built-in operations
 
 Set default disciplines for input and output
 
-=item ops
-
-Restrict unsafe operations when compiling
-
 =item overload
 
 Package for overloading perl operations
 
-=item re
-
-Alter regular expression behaviour
-
 =item sigtrap
 
 Enable simple signal handling
@@ -175,6 +163,10 @@ Exporter module.  See their own documentation for details.
 
 Provide framework for multiple DBMs
 
+=item Attribute::Handlers
+
+Simpler definition of attribute handlers
+
 =item AutoLoader
 
 Load subroutines only on demand
@@ -183,82 +175,10 @@ Load subroutines only on demand
 
 Split a package for autoloading
 
-=item B
-
-The Perl Compiler
-
-=item B::Asmdata
-
-Autogenerated data about Perl ops, used to generate bytecode
-
-=item B::Assembler
-
-Assemble Perl bytecode
-
-=item B::Bblock
-
-Walk basic blocks
-
-=item B::Bytecode
-
-Perl compiler's bytecode backend
-
-=item B::C
-
-Perl compiler's C backend
-
-=item B::CC
-
-Perl compiler's optimized C translation backend
-
-=item B::Concise
-
-Walk Perl syntax tree, printing concise info about ops
-
-=item B::Debug
-
-Walk Perl syntax tree, printing debug info about ops
-
-=item B::Deparse
-
-Perl compiler backend to produce perl code
-
-=item B::Disassembler
-
-Disassemble Perl bytecode
-
-=item B::Lint
-
-Perl lint
-
-=item B::Showlex
-
-Show lexical variables used in functions or files
-
-=item B::Stackobj
-
-Helper module for CC backend
-
-=item B::Stash
-
-Show what stashes are loaded
-
-=item B::Terse
-
-Walk Perl syntax tree, printing terse info about ops
-
-=item B::Xref
-
-Generates cross reference reports for Perl programs
-
 =item Benchmark
 
 Benchmark running times of Perl code
 
-=item ByteLoader
-
-Load byte compiled perl code
-
 =item CGI
 
 Simple Common Gateway Interface Class
@@ -331,10 +251,6 @@ Get pathname of current working directory
 
 Programmatic interface to the Perl debugging API (draft, subject to
 
-=item DB_File
-
-Perl5 access to Berkeley DB version 1.x
-
 =item Devel::SelfStubber
 
 Generate stubs for a SelfLoading module
@@ -351,18 +267,6 @@ Supply object methods for directory handles
 
 Provides screen dump of Perl data.
 
-=item Encode
-
-Character encodings
-
-=item Encode::EncodeFormat
-
-The format of encoding tables of the Encode extension
-
-=item Encode::Tcl
-
-Tcl encodings
-
 =item English
 
 Use nice English (or awk) names for ugly punctuation variables
@@ -455,10 +359,6 @@ Add blib/* directories to @INC
 
 Replace functions with equivalents which succeed or die
 
-=item Fcntl
-
-Load the C Fcntl.h defines
-
 =item File::Basename
 
 Split a pathname into pieces
@@ -491,6 +391,10 @@ Create or remove directory trees
 
 Portably perform operations on file names
 
+=item File::Spec::Cygwin
+
+Methods for Cygwin file specs
+
 =item File::Spec::Epoc
 
 Methods for Epoc file specs
@@ -563,10 +467,6 @@ Functions for dealing with RFC3066-style language tags
 
 Tags and names for human languages
 
-=item IO
-
-Load various IO modules
-
 =item IPC::Open2
 
 Open a process for both reading and writing
@@ -651,10 +551,6 @@ Glue to provide EXISTS for SDBM_File for Storable use
 
 Store Memoized data in Storable database
 
-=item NDBM_File
-
-Tied access to ndbm files
-
 =item NEXT
 
 Provide a pseudo-class NEXT that allows method redispatch
@@ -719,22 +615,6 @@ By-name interface to Perl's built-in getproto*() functions
 
 By-name interface to Perl's built-in getserv*() functions
 
-=item O
-
-Generic interface to Perl Compiler backends
-
-=item ODBM_File
-
-Tied access to odbm files
-
-=item Opcode
-
-Disable named opcodes when compiling perl code
-
-=item POSIX
-
-Perl interface to IEEE Std 1003.1
-
 =item PerlIO
 
 On demand loader for PerlIO layers and root of PerlIO::* name space
@@ -747,6 +627,10 @@ Check pod documents for syntax errors
 
 Find POD documents in directory trees
 
+=item Pod::Functions
+
+Group Perl's functions a la perlfunc.pod
+
 =item Pod::Html
 
 Module to convert pod files to HTML
@@ -807,14 +691,6 @@ Print a usage message from embedded pod documentation
 
 Test of various basic POD features in translators.
 
-=item SDBM_File
-
-Tied access to sdbm files
-
-=item Safe
-
-Compile and execute code in restricted compartments
-
 =item Search::Dict
 
 Search for key in dictionary file
@@ -831,14 +707,6 @@ Load functions only on demand
 
 Run shell commands transparently within perl
 
-=item Socket
-
-Load the C socket.h defines and structure manipulators 
-
-=item Storable
-
-Persistency for perl data structures
-
 =item Switch
 
 A switch statement for Perl
@@ -1015,8 +883,7 @@ CPAN stands for Comprehensive Perl Archive Network; it's a globally
 replicated trove of Perl materials, including documentation, style
 guides, tricks and traps, alternate ports to non-Unix systems and
 occasional binary distributions for these.   Search engines for
-CPAN can be found at http://cpan.perl.com/ and at
-http://theory.uwinnipeg.ca/mod_perl/cpan-search.pl .
+CPAN can be found at http://www.cpan.org/.
 
 Most importantly, CPAN includes around a thousand unbundled modules,
 some of which require a C compiler to build.  Major categories of