[Date Prev][Date Next][Thread Prev][Thread Next] [Search] [Date Index] [Thread Index]

Re: [MacPerl] Coding style



At 12.51 -0500 1999.02.04, Raffael Cavallaro wrote:
>Sometimes this is unavoidable, and sometimes, as you pointed out, in a
>language like Perl,designed to take advantage of side effects, it's
>desirable. It can make code difficult to follow, however, so it's a good
>idea to give a heads-up in a comment if the side effect is particularly out
>of left field.

Absolutely.  In formal Perl code (public modules, code on contract or as an
employee), it is best to comment anything that is not immediately apparent
(which can be hard to determine, since because you are doing it, it is
probably apparent to you).

Of course, I am one of the world's worst commenters, but I try to make up
for it with nice interfaces, readable code, and good documentation.  :)

--
Chris Nandor          mailto:pudge@pobox.com         http://pudge.net/
%PGPKey = ('B76E72AD', [1024, '0824090B CE73CA10  1FF77F13 8180B6B6'])

***** Want to unsubscribe from this list?
***** Send mail with body "unsubscribe" to mac-perl-request@iis.ee.ethz.ch