× The internal search function is temporarily non-functional. The current search engine is no longer viable and we are researching alternatives.
As a stop gap measure, we are using Google's custom search engine service.
If you know of an easy to use, open source, search engine ... please contact support@midrange.com.


  1.  Home
  2. RPG400-L
  3. March 2012

Re: commenting sub procedures

I tend to think of comments as historical documents. A snapshot in time of the original programmers intention but not necessarily still a valid representation of the state of the program, especially if other hands have been in the mix.

Joe

Comments lie...

Trust but verify...

Charles

On Mon, Mar 26, 2012 at 10:35 AM, Jerry C. Adams<midrange@xxxxxxxx> wrote:
I can't say that I disagree. However, I have seen the opposite problem;
i.e., the program logic changes, but the documentation isn't changed. More
than once I have tried to make sense of a program in which I could see that
it was doing one thing, but the documentation said something different.



As an Amazon Associate we earn from qualifying purchases.

This thread ...
Replies:
Follow On AppleNews
Return to Archive home page | Return to MIDRANGE.COM home page

This mailing list archive is Copyright 1997-2025 by midrange.com and David Gibbs as a compilation work. Use of the archive is restricted to research of a business or technical nature. Any other uses are prohibited. Full details are available on our policy page. If you have questions about this, please contact [javascript protected email address].

Operating expenses for this site are earned using the Amazon Associate program and Google Adsense.