[htmltmpl] Re: RFC: template helper module
Brought to you by:
samtregar
|
From: Carl F. <ca...@fi...> - 2004-09-24 08:27:45
|
> 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 Thanks for the good advice Mark. I will change the method names. I also realised yesterday that it would probably be best somewhere under HTML:: I'm toying with HTML::Menu::DateTime I'm also currently adding examples for Template::Toolkit to the POD. Thanks, Carl Franks |