Value of Comments
12-May-90 15:03:01
Sb: #104043-Value of Comments
Fm: Vic Wagner 76046,3004
To: Mike Spille/Manx 71545,1466
Mike,
I think it's incumbent on all programmers these days to write code (and
the associated comments) as if someone ELSE would be reading it. I've
learned that even _I_ am 'someone else' if enough time has passed
<smmiiille>.
For _me_, the ability to use arbitrarily long 'names' is helpful.
The ability to use the SAME name in multiple places (e.g. struct widget
* next ('next' being the name)) is mandatory (and IMHO one of early C's
largest failings…fortunately I've never been saddled with such a
monstrosity).
Strong type checking (in the compiler) has saved me _many_ hours of
debugging and I'm glad to see it added to ANSI C.
As a general rule, I prefer comments ONLY at the beginning of a
function/procedure/whatever (occasionally also attached to the 'line' which
defines a variable).
Victor A. Wagner, Jr.