ABSOLUTELY Agree with David. All those comments around code make it
very hard to read and more importantly understand. Back when I coded a
lot there would be times my brain couldn't filter out the commented code
so understanding it was hard. As Vern pointed out yes RDi can filter
those out but then you also lose the important comments that say: "This
bit of code does this important thing in this particular way...."
I am also a HUGE fan of most RECENT change comment on TOP at the top of
the program always visible upon opening the source. This way the FIRST
thing I see is what changed most recently. In this way when there is an
issue I know the most likely part of the code will be identified right
there. It drives me nuts when vendors require some huge code block
about copyright etc etc etc making me roll down 2, 3, 4 pages to get to
the comments and then another page or two to get to the bottom of the
Noting the change number on the lines affected is fine and that would be
in col 1-5 (RPG) or on the far right (CL) if it were my choice.
- Larry "DrFranken" Bolhuis
On 9/27/2013 12:22 PM, David Gibbs wrote:
On 9/27/2013 10:54 AM, Cyndi Bradberry wrote:
Hi, In the past, we have documented at the top of the program theI don't like that technique ... the code gets WAY too cluttered with a result of being hard to read.
date, ticket # and a description of a change. Now we are being told
to put the ticket number in the first 5 positions, copy the line we
are changing, commenting out the original line and editing the new.
In CLP, /* */ to enclose the ticket number on the line being
Personally, I perfer to have a change control system that does detailed source code archiving ... that way we can compare the various versions and what issue resulted in the change.
(who works for PTC, makers of the Implementerchange control system, in addition to running midrange.com)
This mailing list archive is Copyright 1997-2013 by MIDRANGE dot 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 here. If you have questions about this, please contact