From: Jarkko Hietaniemi Date: Fri, 4 Jan 2002 22:56:23 +0000 (+0000) Subject: A bit of "perl.com" cleanup. X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=commitdiff_plain;h=06a5f41f0431df02a9cd266d1e2a88d3625b083b;p=p5sagit%2Fp5-mst-13.2.git A bit of "perl.com" cleanup. p4raw-id: //depot/perl@14083 --- diff --git a/pod/perldelta.pod b/pod/perldelta.pod index a074ead..0ae001b 100644 --- a/pod/perldelta.pod +++ b/pod/perldelta.pod @@ -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 program included with your release. Be sure to trim your bug down diff --git a/pod/perldiag.pod b/pod/perldiag.pod index 2c10474..29358ea 100644 --- a/pod/perldiag.pod +++ b/pod/perldiag.pod @@ -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. diff --git a/pod/perlfaq.pod b/pod/perlfaq.pod index e0649fb..2629078 100644 --- a/pod/perlfaq.pod +++ b/pod/perlfaq.pod @@ -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 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 diff --git a/pod/perlfaq1.pod b/pod/perlfaq1.pod index e9b1ef7..682c815 100644 --- a/pod/perlfaq1.pod +++ b/pod/perlfaq1.pod @@ -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). diff --git a/pod/perlfaq2.pod b/pod/perlfaq2.pod index 71be980..b6068fa 100644 --- a/pod/perlfaq2.pod +++ b/pod/perlfaq2.pod @@ -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 question earlier in this document. + =head1 AUTHOR AND COPYRIGHT Copyright (c) 1997-2001 Tom Christiansen and Nathan Torkington. diff --git a/pod/perlfaq3.pod b/pod/perlfaq3.pod index 7e0c193..a592c57 100644 --- a/pod/perlfaq3.pod +++ b/pod/perlfaq3.pod @@ -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. @@ -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 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 or in the CGI MetaFAQ: =head2 Where can I learn about object-oriented Perl programming? A good place to start is L, and you can use L, -L, and L 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, L, L, and L 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] diff --git a/pod/perlfaq4.pod b/pod/perlfaq4.pod index 08c7651..abbb9a0 100644 --- a/pod/perlfaq4.pod +++ b/pod/perlfaq4.pod @@ -333,10 +333,11 @@ call C 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 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 with C @@ -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 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. diff --git a/pod/perlfaq5.pod b/pod/perlfaq5.pod index 80a8fb6..ef7b5cb 100644 --- a/pod/perlfaq5.pod +++ b/pod/perlfaq5.pod @@ -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 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. diff --git a/pod/perlfaq8.pod b/pod/perlfaq8.pod index bf5d7a6..0f65a30 100644 --- a/pod/perlfaq8.pod +++ b/pod/perlfaq8.pod @@ -634,9 +634,10 @@ STDOUT). Note that you I 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 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 diff --git a/pod/perlmodlib.PL b/pod/perlmodlib.PL index 9b3536f..9a62369 100644 --- a/pod/perlmodlib.PL +++ b/pod/perlmodlib.PL @@ -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 diff --git a/pod/perlmodlib.pod b/pod/perlmodlib.pod index 67ea1a3..8ad8072 100644 --- a/pod/perlmodlib.pod +++ b/pod/perlmodlib.pod @@ -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