develooper Front page | perl.datetime | Postings from January 2003

Some brief API requests

Thread Next
From:
John Siracusa
Date:
January 18, 2003 07:46
Subject:
Some brief API requests
Message ID:
BA4EE0D7.58819%siracusa@mindspring.com
(...while I'm catching up on the archives; forgive me if this has been
covered already)

Please, for the love of all that is good and holy, just say NO to method or
function names that begins with: "strf", "strp", or any variation thereof.

Also, please name the functions and methods in all lowercase, with words
separated by underscores--and name them after what they actually do!  Yes,
years of writing UnixDate() to format dates and str2time() to parse dates
has made me quite bitter... ;)

From my reading so far, things seem to be on the right track, more or less.
But as someone else has already pointed out, try to keep the "date/time guru
vocabulary" out of the APIs to the extent that it is possible.  If I don't
know what the "Gregorian" calendar is, I should never see that word in my
code.  Ditto for (and this may be more controversial) the word "epoch."

(now back to my archive reading... :)
-John


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