20 Oct
2005
20 Oct
'05
1:42 p.m.
Grargh! When I wrote our coding guidelines at work, I
made it very
clear that comments shuold describe the algorithm, not just each line of
code. So, for example, instead of "Push R2 onto the stack" it would say
"squirrel R2 away because it's gonna get clobbered in a minute and we'll
I feel it would also be sensible to describe what R2 contains --
something like 'save the disk track number because we're going to have to
clobber that register in a minute'
-tony