Change 14083 by jhi@alpha on 2002/01/04 22:56:23
A bit of "perl.com" cleanup.
Affected files ...
.... //depot/perl/pod/perldelta.pod#279 edit
.... //depot/perl/pod/perldiag.pod#259 edit
.... //depot/perl/pod/perlfaq.pod#24 edit
.... //depot/perl/pod/perlfaq1.pod#32 edit
.... //depot/perl/pod/perlfaq2.pod#43 edit
.... //depot/perl/pod/perlfaq3.pod#53 edit
.... //depot/perl/pod/perlfaq4.pod#62 edit
.... //depot/perl/pod/perlfaq5.pod#33 edit
.... //depot/perl/pod/perlfaq8.pod#30 edit
.... //depot/perl/pod/perlmodlib.PL#10 edit
.... //depot/perl/pod/perlmodlib.pod#52 edit
Differences ...
==== //depot/perl/pod/perldelta.pod#279 (text) ====
Index: perl/pod/perldelta.pod
--- perl/pod/perldelta.pod.~1~ Fri Jan 4 16:00:05 2002
+++ perl/pod/perldelta.pod Fri Jan 4 16:00:05 2002
@@ -2595,7 +2595,7 @@
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
==== //depot/perl/pod/perldiag.pod#259 (text) ====
Index: perl/pod/perldiag.pod
--- perl/pod/perldiag.pod.~1~ Fri Jan 4 16:00:05 2002
+++ perl/pod/perldiag.pod Fri Jan 4 16:00:05 2002
@@ -3176,11 +3176,9 @@
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>.
==== //depot/perl/pod/perlfaq.pod#24 (text) ====
Index: perl/pod/perlfaq.pod
--- perl/pod/perlfaq.pod.~1~ Fri Jan 4 16:00:05 2002
+++ perl/pod/perlfaq.pod Fri Jan 4 16:00:05 2002
@@ -1296,14 +1296,13 @@
=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
[EMAIL PROTECTED] . This alias should not be
[EMAIL PROTECTED] . 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 @@
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 [EMAIL PROTECTED] instead.
+to the [EMAIL PROTECTED] 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
==== //depot/perl/pod/perlfaq1.pod#32 (text) ====
Index: perl/pod/perlfaq1.pod
--- perl/pod/perlfaq1.pod.~1~ Fri Jan 4 16:00:05 2002
+++ perl/pod/perlfaq1.pod Fri Jan 4 16:00:05 2002
@@ -35,8 +35,11 @@
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:[EMAIL PROTECTED]/
+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
[EMAIL PROTECTED] a subscription request
(an empty message with no subject is fine).
==== //depot/perl/pod/perlfaq2.pod#43 (text) ====
Index: perl/pod/perlfaq2.pod
--- perl/pod/perlfaq2.pod.~1~ Fri Jan 4 16:00:05 2002
+++ perl/pod/perlfaq2.pod Fri Jan 4 16:00:05 2002
@@ -129,6 +129,7 @@
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 @@
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 @@
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.
==== //depot/perl/pod/perlfaq3.pod#53 (text) ====
Index: perl/pod/perlfaq3.pod
--- perl/pod/perlfaq3.pod.~1~ Fri Jan 4 16:00:05 2002
+++ perl/pod/perlfaq3.pod Fri Jan 4 16:00:05 2002
@@ -22,8 +22,9 @@
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,14 +155,10 @@
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 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/.
-The a2ps at http://www.infres.enst.fr/%7Edemaille/a2ps/ does lots of things
-related to generating nicely printed output of documents.
-
=head2 Is there a ctags for Perl?
Recent versions of ctags do much more than older versions did.
@@ -873,9 +870,13 @@
=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]
==== //depot/perl/pod/perlfaq4.pod#62 (text) ====
Index: perl/pod/perlfaq4.pod
--- perl/pod/perlfaq4.pod.~1~ Fri Jan 4 16:00:05 2002
+++ perl/pod/perlfaq4.pod Fri Jan 4 16:00:05 2002
@@ -333,10 +333,11 @@
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 @@
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.
==== //depot/perl/pod/perlfaq5.pod#33 (text) ====
Index: perl/pod/perlfaq5.pod
--- perl/pod/perlfaq5.pod.~1~ Fri Jan 4 16:00:05 2002
+++ perl/pod/perlfaq5.pod Fri Jan 4 16:00:05 2002
@@ -1128,9 +1128,9 @@
=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.
==== //depot/perl/pod/perlfaq8.pod#30 (text) ====
Index: perl/pod/perlfaq8.pod
--- perl/pod/perlfaq8.pod.~1~ Fri Jan 4 16:00:05 2002
+++ perl/pod/perlfaq8.pod Fri Jan 4 16:00:05 2002
@@ -634,9 +634,10 @@
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
==== //depot/perl/pod/perlmodlib.PL#10 (text) ====
Index: perl/pod/perlmodlib.PL
--- perl/pod/perlmodlib.PL.~1~ Fri Jan 4 16:00:05 2002
+++ perl/pod/perlmodlib.PL Fri Jan 4 16:00:05 2002
@@ -165,8 +165,7 @@
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
==== //depot/perl/pod/perlmodlib.pod#52 (text) ====
Index: perl/pod/perlmodlib.pod
--- perl/pod/perlmodlib.pod.~1~ Fri Jan 4 16:00:05 2002
+++ perl/pod/perlmodlib.pod Fri Jan 4 16:00:05 2002
@@ -53,10 +53,6 @@
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 @@
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 @@
Provide framework for multiple DBMs
+=item Attribute::Handlers
+
+Simpler definition of attribute handlers
+
=item AutoLoader
Load subroutines only on demand
@@ -183,82 +175,10 @@
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 @@
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 @@
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 @@
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 @@
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 @@
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 @@
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 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 @@
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 @@
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 @@
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 @@
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
End of Patch.
