Bill writes:> > I try very hard to put a cogent comment on each machine instruction and all > USINGs and DROPs. And I add a paragraph or two at the beginning of small > subroutines. I do this for two reasons: (1) I have spent a lot of time > studying other people's code with either poor or no comments, and I don't > want to inflict that misery on anyone else; (2) but I especially don't want > to inflict the misery on myself, either, and I know from experience that > within a month or two I will not remember why I coded certain things the way > I did, and the comments help ME understand my own code, too. That's what > enlightened self-interest is all about.
AMEN!!
