On 30 Apr 2007 08:00:17 -0700, [EMAIL PROTECTED] (Thomas H Puddicombe)
wrote:

>>Unless you have gotten so old you can't remember what your own code does.
> 
>I have had that problem since way before I got old (or at least  older). 
>The 
>two main reasons why I write lots of comments in my  code:
>(1) so others can understand the code;
>(2) so I can understand the code 6 months later after having worked on 
>other 
>tasks for the previous 6 months.

So I can remember the code immediately after I write it.   

Also - many times I document the code to show that I *meant* the code
to do what I wrote - and who decided that a particular calculation
should be as stated.    

Some documentation should assist in midnight abort analysis as well -
indicating where a problem occurred (might not even be the program's
fault).

----------------------------------------------------------------------
For IBM-MAIN subscribe / signoff / archive access instructions,
send email to [EMAIL PROTECTED] with the message: GET IBM-MAIN INFO
Search the archives at http://bama.ua.edu/archives/ibm-main.html

Reply via email to