1 Mar
2002
1 Mar
'02
1:02 a.m.
What really irks me are comments like this:
--start the loop
while SQL%NOTFOUND LOOP
...
--end the loop
END LOOP;
--assign the value 34 to A
a:=34;
In other words, asanine comments that add no value
whatsoever to an explanation of the purpose of
statements or routines. I would rather have two lines
at the top of a routine explaining what it does and
why than 500 comments like the above. Comments like
these are caused by managers who demand X number of
comments per Y lines of code and/or extremely
egotistical and/or lazy programmers.
As far as write-only code is concerned, I can write
clear, understandable code in many languages; I can
also write absolutely incomprehensible code in those
same languages!
--- Frank McConnell <fmc(a)reanimators.org> wrote:
"R. D. Davis" <rdd(a)rddavis.org>
wrote:
__________________________________________________
Do You Yahoo!?
Yahoo! Greetings - Send FREE e-cards for every occasion!
http://greetings.yahoo.com
Also, remember that obfuscated code is an art
form
that should bring
bonuses and raises to programmers skilled in this
art. Besides, a
programmer who can't read so-called
"difficult to
read code," with no
comments, isn't a real programmer. :-)
No comments? I think you're forgetting the
potential of comments as
things whose maintenance is a lesser priority and
whose relationship
to the code may therefore differ from the reader's
expectations.
-Frank McConnell