Stories
Slash Boxes
Comments
NOTE: use Perl; is on undef hiatus. You can read content, but you can't post it. More info will be forthcoming forthcomingly.

All the Perl that's Practical to Extract and Report

use Perl Log In

Log In

[ Create a new account ]

mr_bean (3802)

mr_bean
  (email not shown publicly)

Journal of mr_bean (3802)

Tuesday September 25, 2007
06:14 PM

grammar police check List::Util man page

[ #34545 ]

--- List/Util.pm 2007-09-26 06:41:03.996285608 +0800
+++ List/Utils.pm 2007-09-26 06:49:42.086523920 +0800
@@ -113,10 +113,11 @@

  =head1 DESCRIPTION

-C contains a selection of subroutines that people have
-expressed would be nice to have in the perl core, but the usage would
-not really be high enough to warrant the use of a keyword, and the size
-so small such that being individual extensions would be wasteful.
+C contains a selection of subroutines that
+people wanted to put in the perl core, but which are not
+really used enough to warrant them having their own keyword,
+and which are so small that making them individual
+extensions would be wasteful.

  By default C does not export any subroutines. The
  subroutines defined are
@@ -241,8 +242,9 @@

  =head1 SUGGESTED ADDITIONS

-The following are additions that have been requested, but I have been reluctant
-to add due to them being very simple to implement in perl
+The following are additions that have been requested, but
+which I have been reluctant to add because they are very
+simple to implement in perl.

      # One argument is true
 

The Fine Print: The following comments are owned by whoever posted them. We are not responsible for them in any way.
 Full
 Abbreviated
 Hidden
More | Login | Reply
Loading... please wait.
  • Or even several:
    - the RT queue for List::Util (http://rt.cpan.org/NoAuth/Bugs.html?Dist=Scalar-List-Utils)
    - Graham, directly
    - perl5-porters, since it's a core module
    • I don't think the man page should be changed. I would oppose the real application of this patch. I like it the way it is expressed as it is. I don't even feel the grammatically correct version is more understandable by people whose first language isn't English.

      I am an English teacher. I just found myself thinking how to reformulate the thing.

      I am beginning to think my joke has backfired.
    1. C<List::Util> contains a selection of subroutines that people have wanted in the Perl core, but whose usage and size wouldn’t justify a keyword or an individual extension.

      This strays quite a bit from the original wording, but conserves all its meaning while being shorter and much simpler.

    2. The following additions have been requested but are so simple to implement in Perl that I have been reluctant to add them.

      This the exactly same as the original, except that I s