On Wed, Sep 07, 2005 at 01:04:00PM -0400, Mark Jason Dominus wrote:
> > I was struck by one of my own: exempli gratia being abbreviated to eg or 
> > eg., rather than e.g.
> 
> I would like to suggest that Latin is obscure, and latin abbreviations
> are doubly obscure.  There is no space constraint that should require
> us to use "e.g." in place of "for example".  Using  "i.e." in place of
> "that is" is even sillier.  (57% sillier, in fact.)  
> 
> If you're going to do the work of locating these locutions, can I
> suggest that you get rid of the unnecessary abbreviations entirely?

I'm going to come at this from a different angle.  One that says "leave it
as ie/eg" or perhaps simply "who cares?" because the effort to correct all
the ie's and eg's and it's and [ae]ffects just doesn't seem worth the effort.

I will quote Donald Norman.

   What about noon: How shall it be labeled, AM or PM?  In a clever essay on
 the topic, the engineer Henry Petroski argues that 12 noon should be labeled
 12M, for after all, the history of AM and PM is that they mean Ante
 Meridiem ("before the middle of the day") and Post Meridiem ("after midday").
 Noon is the meridiem, the midday, so it is neither before nor after.  It
 should be labeled M: 12M.

   Yikes! That is putting principle first, and damn the consequences.  I hate
 to disagree so strongly with one of my favorite authors, but I splutter at
 the thought of using M to mark noon in order to distinguish it from midnight!
 In English, if any letter is to be used to denote noon, it should be N.
 M ought to stand for midnight.

   The mark of "M" for noon makes historical sense, but it makes practical
 sense only if the everyday user of time understands the original meanings
 of the terms AM and PM.

        "How Long Is Noon?" published in "Turn Signals Are The Facial
                                          Expressions Of Automobiles" p 89


The point being, most people don't know that "P.M.", "i.e." and "e.g." are 
abbreviations for Latin phrases so it doesn't matter one bit to the reader
of the Perl documentation whether its "ie" or "i.e.".  While neither option 
causes confusion, as 12M for 12 noon does, neither one adds anything over the
other except perhaps niggling grammatical correctness.

What it does add is MAINTENANCE COST.  Maintaining an extreme level
of grammatical correctness and consistency over a large collection with
multiple authors takes time and effort not just from the person doing the
initial grammar fix but from all the CPAN authors who now have to reapply
that patch and retrain their writing style.  Not to mention all the
mailing list noise it inevitably generates (remember the [ae]ffect thread?)

Effort is spent with a near 0 benefit to the user.

While I thank you very much for the effort to scan the documentation to find
grammar nits, and I realize Open Source is about scratching an itch, software
is about change management.  Which is why I say to stop fiddling with the 
(ie/i.e.)'s, the (eg/e.g.)'s, the (its/it's)'s and the ([ae]ffects).  
There's FAR more important things to be done in the Perl documentation. 


-- 
Michael G Schwern     [EMAIL PROTECTED]     http://www.pobox.com/~schwern
ROCKS FALL! EVERYONE DIES!
        http://www.somethingpositive.net/sp05032002.shtml

Reply via email to