--- Andy Lester <[EMAIL PROTECTED]> wrote: > > Hmm ... I like this idea, though I confess that I don't like that > the comment is optional. > > There's no way to not make it optional. If you require that a > comment > be passed, then people will pass "comment" and leave it at that.
Yes, I'm painfully aware of that. As with POD, traditional comments, test comments or anything else that is not absolutely required to get software to function, programmers (including me) will take shortcuts. Even if we don't skimp, they'll get overlooked in maintenance, rush to deadlines, etc. Only when comments *become* the programs they are supposed to document will this problem be solved (and programming will likely be much better for it.) Cheers, Ovid ===== Silence is Evil http://users.easystreet.com/ovid/philosophy/decency.html Ovid http://www.perlmonks.org/index.pl?node_id=17000 Web Programming with Perl http://users.easystreet.com/ovid/cgi_course/
