IBM Mainframe Assembler List <[email protected]> wrote on 02/16/2012 03:41:28 PM:
> From: Chris Craddock <[email protected]> > 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!! DITTO!! ----------------------------------------- The information contained in this communication (including any attachments hereto) is confidential and is intended solely for the personal and confidential use of the individual or entity to whom it is addressed. If the reader of this message is not the intended recipient or an agent responsible for delivering it to the intended recipient, you are hereby notified that you have received this communication in error and that any review, dissemination, copying, or unauthorized use of this information, or the taking of any action in reliance on the contents of this information is strictly prohibited. If you have received this communication in error, please notify us immediately by e-mail, and delete the original message. Thank you
