Value of Comments
11-May-90 18:59:19
Sb: #104043-Value of Comments
Fm: Bob Rakosky 75156,336
To: Mike Spille/Manx 71545,1466
Even when comments aren't totally, 100% accurate, they are still better
than no comments at all. At least one can discern the programmer's state
of mind (what he was trying to do in the section of code), even if the
actual execution differs somewhat. To rely solely on the comments would be
a mistake, but they are of significant value regardless.
I'm still recovering from the last game conversion that I did, where the
original code was written in 68K assembly for the ST. Not a single comment
in the entire source code! Argh! I ended up totally rewriting the sucker
(in C) and used extensive comments (of course). The end result: my
version of the game hit the market just before last XMAS (barely) — the
original version has yet to be published. The author is still trying to
figure out his own code and kill the bugs!
…BobR