Language for the ages

[Tony Duell]

> 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