develooper Front page | perl.perl5.porters | Postings from December 2001

[PATCH] Module names and other nits

Thread Next
From:
Autrijus Tang
Date:
December 28, 2001 09:58
Subject:
[PATCH] Module names and other nits
Message ID:
20011229015928.A29712@geb.elixus.org
I just checked the pod/*.pod using cpan+ (http://cpanplus.sf.net/) and the
following script...

#!/usr/local/bin/perl
use CPANPLUS; my %mod; my $cpan = CPANPLUS::Backend->new->{_modtree};
while (<>) { $mod{$&}++ while s/\w+::\w+//; }
(eval "use $_; 1" or exists $cpan->{$_} or print "$_\n") for sort keys %mod;

...and found these questionable items:

Devel::Dprof		=> Devel::DProf 	# various
Class::Eroot		=> (disappeared)	# perlfaq4
Tie::Refhash		=> Tie::RefHash		# perlfaq4
GetOpt::Long		=> Getopt::Long		# perl56delta, perl561delta
Malik::Pod		=> Marek::Pod::HTML 	# perltodo
Net::IPv6		=> Socket6		# perltodo

I'm not sure of the correctness of the alternatives, so I'd post it here with
some more aspell checks for your review.

Thanks,
/Autrijus/

diff -dur perl/lib/Exporter/Heavy.pm perl2/lib/Exporter/Heavy.pm
--- perl/lib/Exporter/Heavy.pm	Mon Dec 10 03:24:46 2001
+++ perl2/lib/Exporter/Heavy.pm	Sat Dec 29 01:14:45 2001
@@ -12,7 +12,7 @@
 
 Exporter::Heavy - Exporter guts
 
-=head1 SYNOPIS
+=head1 SYNOPSIS
 
 (internal use only)
 
diff -dur perl/pod/perl561delta.pod perl2/pod/perl561delta.pod
--- perl/pod/perl561delta.pod	Fri Dec  7 06:25:42 2001
+++ perl2/pod/perl561delta.pod	Sat Dec 29 01:15:04 2001
@@ -1608,7 +1608,7 @@
 
     =head1 NAME
 
-    sample - Using GetOpt::Long and Pod::Usage
+    sample - Using Getopt::Long and Pod::Usage
 
     =head1 SYNOPSIS
 
diff -dur perl/pod/perl56delta.pod perl2/pod/perl56delta.pod
--- perl/pod/perl56delta.pod	Sat Sep 22 02:11:59 2001
+++ perl2/pod/perl56delta.pod	Sat Dec 29 01:15:01 2001
@@ -1011,7 +1011,7 @@
 
     =head1 NAME
 
-    sample - Using GetOpt::Long and Pod::Usage
+    sample - Using Getopt::Long and Pod::Usage
 
     =head1 SYNOPSIS
 
diff -dur perl/pod/perldebguts.pod perl2/pod/perldebguts.pod
--- perl/pod/perldebguts.pod	Mon Nov 12 23:56:58 2001
+++ perl2/pod/perldebguts.pod	Sat Dec 29 01:15:01 2001
@@ -967,4 +967,4 @@
 L<perlrun>
 L<re>,
 and
-L<Devel::Dprof>.
+L<Devel::DProf>.
diff -dur perl/pod/perldebug.pod perl2/pod/perldebug.pod
--- perl/pod/perldebug.pod	Thu Nov  8 17:31:47 2001
+++ perl2/pod/perldebug.pod	Sat Dec 29 01:15:01 2001
@@ -948,7 +948,7 @@
 L<perldebguts>,
 L<re>,
 L<DB>,
-L<Devel::Dprof>,
+L<Devel::DProf>,
 L<dprofpp>,
 L<Dumpvalue>,
 and
diff -dur perl/pod/perlfaq4.pod perl2/pod/perlfaq4.pod
--- perl/pod/perlfaq4.pod	Sun Dec  9 02:48:33 2001
+++ perl2/pod/perlfaq4.pod	Sat Dec 29 01:15:01 2001
@@ -1849,7 +1849,7 @@
 
 =head2 How can I use a reference as a hash key?
 
-You can't do this directly, but you could use the standard Tie::Refhash
+You can't do this directly, but you could use the standard Tie::RefHash
 module distributed with Perl.
 
 =head1 Data: Misc
@@ -1919,10 +1919,10 @@
 =head2 How do I keep persistent data across program calls?
 
 For some specific applications, you can use one of the DBM modules.
-See L<AnyDBM_File>.  More generically, you should consult the FreezeThaw,
-Storable, or Class::Eroot modules from CPAN.  Starting from Perl 5.8
-Storable is part of the standard distribution.  Here's one example using
-Storable's C<store> and C<retrieve> functions:
+See L<AnyDBM_File>.  More generically, you should consult the FreezeThaw
+or Storable modules from CPAN.  Starting from Perl 5.8 Storable is part
+of the standard distribution.  Here's one example using Storable's C<store>
+and C<retrieve> functions:
 
     use Storable; 
     store(\%hash, "filename");
diff -dur perl/pod/perlfaq6.pod perl2/pod/perlfaq6.pod
--- perl/pod/perlfaq6.pod	Sun Dec  9 02:48:33 2001
+++ perl2/pod/perlfaq6.pod	Sat Dec 29 01:15:01 2001
@@ -643,7 +643,7 @@
 
 Starting from Perl 5.6 Perl has had some level of multibyte character
 support.  Perl 5.8 or later is recommended.  Supported multibyte
-character repetoires include Unicode, and legacy encodings
+character repertoires include Unicode, and legacy encodings
 through the Encode module.  See L<perluniintro>, L<perlunicode>,
 and L<Encode>.
 
diff -dur perl/pod/perlfunc.pod perl2/pod/perlfunc.pod
--- perl/pod/perlfunc.pod	Thu Dec 27 23:02:26 2001
+++ perl2/pod/perlfunc.pod	Sat Dec 29 01:15:01 2001
@@ -4236,7 +4236,7 @@
 
 =item send SOCKET,MSG,FLAGS
 
-Sends a message on a socket.  Attemps to send the scalar MSG to the
+Sends a message on a socket.  Attempts to send the scalar MSG to the
 SOCKET filehandle.  Takes the same flags as the system call of the
 same name.  On unconnected sockets you must specify a destination to
 send TO, in which case it does a C C<sendto>.  Returns the number of
diff -dur perl/pod/perlguts.pod perl2/pod/perlguts.pod
--- perl/pod/perlguts.pod	Fri Nov 16 21:18:35 2001
+++ perl2/pod/perlguts.pod	Sat Dec 29 01:15:01 2001
@@ -247,7 +247,7 @@
 shown in parentheses, and the values of C<SvCUR> and C<SvLEN> reflect
 the fake beginning, not the real one.
 
-Something similar to the offset hack is perfomed on AVs to enable
+Something similar to the offset hack is performed on AVs to enable
 efficient shifting and splicing off the beginning of the array; while
 C<AvARRAY> points to the first element in the array that is visible from
 Perl, C<AvALLOC> points to the real start of the C array. These are
diff -dur perl/pod/perlpacktut.pod perl2/pod/perlpacktut.pod
--- perl/pod/perlpacktut.pod	Mon Dec  3 03:44:59 2001
+++ perl2/pod/perlpacktut.pod	Sat Dec 29 01:15:04 2001
@@ -727,7 +727,7 @@
 to each key (in C<$_>) it adds the C<=> separator and the hash entry value.
 Each triplet is packed with the template code sequence C<A*A*Z*> that
 is multiplied with the number of keys. (Yes, that's what the C<keys>
-function resturns in scalar context.) To get the very last null byte,
+function returns in scalar context.) To get the very last null byte,
 we add a C<0> at the end of the C<pack> list, to be packed with C<C>.
 (Attentive readers may have noticed that we could have omitted the 0.)
 
diff -dur perl/pod/perlsub.pod perl2/pod/perlsub.pod
--- perl/pod/perlsub.pod	Tue Dec 18 07:04:34 2001
+++ perl2/pod/perlsub.pod	Sat Dec 29 01:15:02 2001
@@ -1204,7 +1204,7 @@
 prototype (such as C<system> or C<chomp>).  If you override them you won't
 be able to fully mimic their original syntax.
 
-The built-ins C<do>, C<require> and C<glob> can also be overriden, but due
+The built-ins C<do>, C<require> and C<glob> can also be overridden, but due
 to special magic, their original syntax is preserved, and you don't have
 to define a prototype for their replacements.  (You can't override the
 C<do BLOCK> syntax, though).
@@ -1214,9 +1214,9 @@
 the argument C<"Foo/Bar.pm"> in @_.  See L<perlfunc/require>.
 
 And, as you'll have noticed from the previous example, if you override
-C<glob>, the C<E<lt>*E<gt>> glob operator is overriden as well.
+C<glob>, the C<E<lt>*E<gt>> glob operator is overridden as well.
 
-Finally, some built-ins (e.g. C<exists> or C<grep>) can't be overriden.
+Finally, some built-ins (e.g. C<exists> or C<grep>) can't be overridden.
 
 =head2 Autoloading
 
diff -dur perl/pod/perlunicode.pod perl2/pod/perlunicode.pod
--- perl/pod/perlunicode.pod	Wed Dec 19 13:42:37 2001
+++ perl2/pod/perlunicode.pod	Sat Dec 29 01:15:04 2001
@@ -730,9 +730,9 @@
 leading bits of the start byte tells how many bytes the are in the
 encoded character.
 
-=item UTF-EBDIC
+=item UTF-EBCDIC
 
-Like UTF-8, but EBDCIC-safe, as UTF-8 is ASCII-safe.
+Like UTF-8, but EBCDIC-safe, as UTF-8 is ASCII-safe.
 
 =item UTF-16, UTF-16BE, UTF16-LE, Surrogates, and BOMs (Byte Order Marks)
 
diff -dur perl/pod/perlutil.pod perl2/pod/perlutil.pod
--- perl/pod/perlutil.pod	Tue Jun 19 09:53:05 2001
+++ perl2/pod/perlutil.pod	Sat Dec 29 01:15:04 2001
@@ -171,9 +171,9 @@
 
 =item L<dprofpp|dprofpp>
 
-Perl comes with a profiler, the F<Devel::Dprof> module. The
+Perl comes with a profiler, the F<Devel::DProf> module. The
 F<dprofpp> utility analyzes the output of this profiler and tells you
-which subroutines are taking up the most run time. See L<Devel::Dprof>
+which subroutines are taking up the most run time. See L<Devel::DProf>
 for more information.
 
 =item L<perlcc|perlcc>
@@ -190,6 +190,6 @@
 L<roffitall|roffitall>, L<a2p|a2p>, L<s2p|s2p>, L<find2perl|find2perl>,
 L<File::Find|File::Find>, L<pl2pm|pl2pm>, L<perlbug|perlbug>,
 L<h2ph|h2ph>, L<c2ph|c2ph>, L<h2xs|h2xs>, L<dprofpp|dprofpp>,
-L<Devel::Dprof>, L<perlcc|perlcc>
+L<Devel::DProf>, L<perlcc|perlcc>
 
 =cut
diff -dur perl/pod/perltodo.pod perl2/pod/perltodo.pod
--- perl/pod/perltodo.pod	Wed Dec 12 12:16:06 2001
+++ perl2/pod/perltodo.pod	Sat Dec 29 01:28:25 2001
@@ -148,7 +148,7 @@
 
 =head2 IPv6 Support
 
-There are non-core modules, such as C<Net::IPv6>, but these will need
+There are non-core modules, such as C<Socket6>, but these will need
 integrating when IPv6 actually starts to really happen.  See RFC 2292
 and RFC 2553.
 
@@ -223,7 +223,7 @@
 
 =head2 Replace pod2html with something using Pod::Parser
 
-The CPAN module C<Malik::Pod::Html> may be a more suitable basis for a
+The CPAN module C<Marek::Pod::Html> may be a more suitable basis for a
 C<pod2html> convertor; the current one duplicates the functionality
 abstracted in C<Pod::Parser>, which makes updating the POD language
 difficult.
diff -dur perl/pod/perlxs.pod perl2/pod/perlxs.pod
--- perl/pod/perlxs.pod	Fri Nov 16 08:22:39 2001
+++ perl2/pod/perlxs.pod	Sat Dec 29 01:15:04 2001
@@ -1714,7 +1714,7 @@
 It is therefore strongly recommended that these macros be used by all
 XS modules that make use of static data.
 
-The easiest way to get a template set of macros to use is by specifiying
+The easiest way to get a template set of macros to use is by specifying
 the C<-g> (C<--global>) option with h2xs (see L<h2xs>).
 
 Below is an example module that makes use of the macros.

Thread Next


nntp.perl.org: Perl Programming lists via nntp and http.
Comments to Ask Bjørn Hansen at ask@perl.org | Group listing | About