[htmltmpl] Re: RFC: template helper module
Brought to you by:
samtregar
From: Mark S. <ma...@su...> - 2004-09-23 15:55:36
|
On 2004-09-22, Carl Franks <ca...@fi...> wrote: > Hi, > > I've written a module which I propose naming > HTML::Template::Dropdown::Date. > > Please see the POD below for description and usage. The functionality seems useful. I do suggest using underscores to separate words in method names, rather than CamelCaps. I believe the underscore style is more common on CPAN, and is also what's recommended in "perldoc perlstyle": http://www.perldoc.com/perl5.8.0/pod/perlstyle.html While short identifiers like $gotit are probably ok, use underscores to separate words. It is generally easier to read $var_names_like_this than $VarNamesLikeThis, especially for non-native speakers of English. It's also a simple rule that works consistently with VAR_NAMES_LIKE_THIS. Package names are sometimes an exception to this rule. Perl informally reserves lowercase module names for "pragma" modules like integer and strict. Other modules should begin with a capital letter and use mixed case, but probably without underscores due to limitations in primitive file systems' representations of module names as files that must fit into a few sparse bytes. #### Also, if this really does work fine outside of HTML::Template, consider a more generic name, like CGI:: or HTML:: or WWW:: You will more easily attract users and contributors of other templating systems (or no templating system!) this way. Mark -- . . . . . . . . . . . . . . . . . . . . . . . . . . . Mark Stosberg Principal Developer ma...@su... Summersault, LLC 765-939-9301 ext 202 database driven websites . . . . . http://www.summersault.com/ . . . . . . . . |