× 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.



Alan,

I think you may have misunderstood me.

I agree with you if you're talking about inline comments - when I delete
code, I delete it and when I change it, I don't just comment out the old
code (as you say, that's what CMPSRC is for). However, how does having
single-line comments at the top of the source make reading the source a
nightmare?

/*M:-----------------------------------------------------------------*/
/*M: 14Jun06 HEWRO01 M10945 *NONE Binder source created. */
/*M: 27Jun07 HEWRO01 M10985 *NONE Add GetProcName(). */
/*M: 29Jun07 HEWRO01 M10986 *NONE Add GetProcName2(). */
/*M:-----------------------------------------------------------------*/

Rory

On Tue, Oct 13, 2009 at 1:30 PM, Alan Campin <alan0307d@xxxxxxxxx> wrote:

I hate code with modification comments. Makes the code an absolute
nightmare
to read.

That is what CMPSRC is for.

Years ago I read an article on code readability. They had programs that
rated programs on readability and the number one thing that reduced the
score is dead code in the program.

The only exception I have to that rule is when I am making a mod to a
vendor
program and I will have to incorporate changes into a new version.

IMO.


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-2024 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.