CompuServe Messages

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.