PerlFAQ sync.
[p5sagit/p5-mst-13.2.git] / pod / perlfaq2.pod
index 3ef958f..22f7ad7 100644 (file)
@@ -1,6 +1,6 @@
 =head1 NAME
 
-perlfaq2 - Obtaining and Learning about Perl ($Revision: 1.4 $, $Date: 2002/01/11 02:31:20 $)
+perlfaq2 - Obtaining and Learning about Perl ($Revision: 1.18 $, $Date: 2002/12/06 07:40:11 $)
 
 =head1 DESCRIPTION
 
@@ -90,7 +90,7 @@ architecture.
 
 =head2 What modules and extensions are available for Perl?  What is CPAN?  What does CPAN/src/... mean?
 
-CPAN stands for Comprehensive Perl Archive Network, a ~700mb archive
+CPAN stands for Comprehensive Perl Archive Network, a ~1.2Gb archive
 replicated on nearly 200 machines all over the world.  CPAN contains
 source code, non-native ports, documentation, scripts, and many
 third-party modules and extensions, designed for everything from
@@ -167,7 +167,6 @@ assistance:
 
     http://perldoc.cpan.org/
     http://www.perldoc.com/
-    http://reference.perl.com/query.cgi?tutorials
     http://bookmarks.cpan.org/search.cgi?cat=Training%2FTutorials
 
 =head2 What are the Perl newsgroups on Usenet?  Where do I post questions?
@@ -183,10 +182,17 @@ following groups:
 
     comp.infosystems.www.authoring.cgi         Writing CGI scripts for the Web.
 
-There is also Usenet gateway to the mailing list used by the crack
-Perl development team (perl5-porters) at
-news://nntp.perl.org/perl.perl5.porters or its web interface at
-http://nntp.perl.org/group/perl.perl5.porters .
+There is also a Usenet gateway to Perl mailing lists sponsored by perl.org at
+nntp://nntp.perl.org , a web interface to the same lists at
+http://nntp.perl.org/group/ and these lists are also available under the
+C<perl.*> hierarchy at http://groups.google.com . Other groups are listed at
+http://lists.perl.org/ ( also known as http://lists.cpan.org/ ).
+
+A nice place to ask questions is the PerlMonks site, http://www.perlmonks.org/
+
+Note that none of the above are supposed to write your code for you:
+asking questions about particular problems or general advice is fine,
+but asking someone to write your code for free is not very cool.
 
 =head2 Where should I post source code?
 
@@ -194,12 +200,12 @@ You should post source code to whichever group is most appropriate, but
 feel free to cross-post to comp.lang.perl.misc.  If you want to cross-post
 to alt.sources, please make sure it follows their posting standards,
 including setting the Followup-To header line to NOT include alt.sources;
-see their FAQ (http://www.faqs.org/faqs/alt-sources-intro/) for details.
+see their FAQ ( http://www.faqs.org/faqs/alt-sources-intro/ ) for details.
 
 If you're just looking for software, first use Google
-(http://www.google.com), Deja (http://www.deja.com), and
-CPAN Search (http://search.cpan.org).  This is faster and more
-productive than just posting a request.
+( http://www.google.com ), Google's usenet search interface
+( http://groups.google.com ),  and CPAN Search ( http://search.cpan.org ).
+This is faster and more productive than just posting a request.
 
 =head2 Perl Books
 
@@ -255,8 +261,8 @@ If you are more at home in Windows the following is available
        ISBN 1-56592-324-3 [1st edition August 1997]
        http://www.oreilly.com/catalog/lperlwin/
 
-Addison-Wesley (http://www.awlonline.com/) and Manning
-(http://www.manning.com/) are also publishers of some fine Perl books
+Addison-Wesley ( http://www.awlonline.com/ ) and Manning
+( http://www.manning.com/ ) are also publishers of some fine Perl books
 such as I<Object Oriented Programming with Perl> by Damian Conway and
 I<Network Programming with Perl> by Lincoln Stein.
 
@@ -278,12 +284,12 @@ Recommended books on (or mostly on) Perl follow.
        http://www.oreilly.com/catalog/pperl3/
 
     Perl 5 Pocket Reference
-        by Johan Vromans
+    by Johan Vromans
        ISBN 0-596-00032-4 [3rd edition May 2000]
        http://www.oreilly.com/catalog/perlpr3/
 
     Perl in a Nutshell
-        by Ellen Siever, Stephan Spainhour, and Nathan Patwardhan
+    by Ellen Siever, Stephan Spainhour, and Nathan Patwardhan
        ISBN 1-56592-286-7 [1st edition December 1998]
        http://www.oreilly.com/catalog/perlnut/
 
@@ -291,7 +297,7 @@ Recommended books on (or mostly on) Perl follow.
 
     Elements of Programming with Perl
        by Andrew L. Johnson
-       ISBN 1884777805 [1st edition October 1999]
+       ISBN 1-884777-80-5 [1st edition October 1999]
        http://www.manning.com/Johnson/
 
     Learning Perl
@@ -308,8 +314,8 @@ Recommended books on (or mostly on) Perl follow.
     Perl: The Programmer's Companion
        by Nigel Chapman
        ISBN 0-471-97563-X [1997, 3rd printing Spring 1998]
-        http://www.wiley.com/compbooks/catalog/97563-X.htm
-        http://www.wiley.com/compbooks/chapman/perl/perltpc.html (errata etc)
+    http://www.wiley.com/compbooks/catalog/97563-X.htm
+    http://www.wiley.com/compbooks/chapman/perl/perltpc.html (errata etc)
 
     Cross-Platform Perl
        by Eric Foster-Johnson
@@ -351,35 +357,35 @@ Recommended books on (or mostly on) Perl follow.
     Object Oriented Perl
        Damian Conway
            with foreword by Randal L. Schwartz
-       ISBN 1884777791 [1st edition August 1999]
+       ISBN 1-884777-79-1 [1st edition August 1999]
        http://www.manning.com/Conway/
 
     Data Munging with Perl
-        Dave Cross
-        ISBN 1930110006 [1st edition 2001]
-        http://www.manning.com/cross
+       Dave Cross
+       ISBN 1-930110-00-6 [1st edition 2001]
+       http://www.manning.com/cross
 
-    Learning Perl/Tk
-        by Nancy Walsh
-       ISBN 1-56592-314-6 [1st edition January 1999]
-       http://www.oreilly.com/catalog/lperltk/
+    Mastering Perl/Tk
+       by Steve Lidie and Nancy Walsh
+       ISBN 1-56592-716-8 [1st edition January 2002]
+       http://www.oreilly.com/catalog/mastperltk/
 
 =back
 
 =head2 Perl in Magazines
 
-The first and only periodical devoted to All Things Perl,
+The first (and for a long time, only) periodical devoted to All Things Perl,
 I<The Perl Journal> contains tutorials, demonstrations, case studies,
 announcements, contests, and much more.  I<TPJ> has columns on web
 development, databases, Win32 Perl, graphical programming, regular
 expressions, and networking, and sponsors the Obfuscated Perl Contest
 and the Perl Poetry Contests.  As of mid-2001, the dead tree version
 of TPJ will be published as a quarterly supplement of SysAdmin
-magazine ( http://www.sysadmin.com/ ) For more details on TPJ,
+magazine ( http://www.sysadminmag.com/ ) For more details on TPJ,
 see http://www.tpj.com/
 
 Beyond this, magazines that frequently carry quality articles on
-Perl are I<Web Techniques> ( http://www.webtechniques.com/ ),
+Perl are I<The Perl Review> ( http://www.theperlreview.com ),
 I<Unix Review> ( http://www.unixreview.com/ ),
 I<Linux Magazine> ( http://www.linuxmagazine.com/ ),
 and Usenix's newsletter/magazine to its members, I<login:>
@@ -392,27 +398,13 @@ http://www.stonehenge.com/merlyn/LinuxMag/ .
 
 =head2 Perl on the Net: FTP and WWW Access
 
-To get the best performance, pick a site from
-the list below and use it to grab the complete list of mirror sites
-which is at /CPAN/MIRRORED.BY or at http://mirror.cpan.org/.
-From there you can find the quickest site for you.  Remember, the
-following list is I<not> the complete list of CPAN mirrors
-(the complete list contains 165 sites as of January 2001):
-
-  http://www.cpan.org/
-  http://www.perl.com/CPAN/
-  http://download.sourceforge.net/mirrors/CPAN/
-  ftp://ftp.digital.com/pub/plan/perl/CPAN/
-  ftp://ftp.flirble.org/pub/languages/perl/CPAN/
-  ftp://ftp.uvsq.fr/pub/perl/CPAN/
-  ftp://ftp.funet.fi/pub/languages/perl/CPAN/
-  ftp://ftp.dti.ad.jp/pub/lang/CPAN/
-  ftp://mirror.aarnet.edu.au/pub/perl/CPAN/
-  ftp://cpan.if.usp.br/pub/mirror/CPAN/
-
-One may also use xx.cpan.org where "xx" is the 2-letter country code
-for your domain; e.g. Australia would use au.cpan.org.
-[Note: This only applies to countries that host at least one mirror.]
+To get the best performance, pick a site from the list at
+http://www.cpan.org/SITES.html . From there you can find the quickest
+site for you.
+
+You may also use xx.cpan.org where "xx" is the 2-letter country code
+for your domain; e.g. Australia would use au.cpan.org. [Note: This
+only applies to countries that host at least one mirror.]
 
 =head2 What mailing lists are there for Perl?
 
@@ -420,14 +412,16 @@ Most of the major modules (Tk, CGI, libwww-perl) have their own
 mailing lists.  Consult the documentation that came with the module for
 subscription information.
 
-       http://lists.cpan.org/  
+A comprehensive list of Perl related mailing lists can be found at:
+
+       http://lists.perl.org/
 
 =head2 Archives of comp.lang.perl.misc
 
 The Google search engine now carries archived and searchable newsgroup
-content. 
+content.
 
-http://groups.google.com/groups?hl=en&lr=&safe=off&group=comp.lang.perl.misc
+http://groups.google.com/groups?group=comp.lang.perl.misc
 
 If you have a question, you can be sure someone has already asked the
 same question at some point on c.l.p.m. It requires some time and patience
@@ -518,7 +512,6 @@ and there are many other sub-domains for special topics, such as
     http://bugs.perl.org/
     http://history.perl.org/
     http://lists.perl.org/
-    http://news.perl.org/
     http://use.perl.org/
 
 http://www.cpan.org/ is the Comprehensive Perl Archive Network,