[Coco] Bill Gates and CoCo BASIC assembly book

[Phill Harvey-Smith]

On 09/11/2012 11:49, John Donaldson wrote:
> Gene, It the same today. The other day I was putting comments into a program
> that I was making a enhancement to and another programmer wander by and wanted
> to know what I was doing. I told him I was adding some comment lines so that the
> next programmer that looked at this section would know what was done.

I'm currently doing that with the DragonDOS / SuperDOS disassembilies, 
so that once I've figured out the hoops that have been jumped through 
the next person looking at the code won't have too.

>									He looked
> at me a little confused and wander off. I have only worked at two companies
> where the Software/Engineering Manager dictated that we were to document our
> code via inline comments. Every place else I have worked including here (DEA)
> you only find occasional comments in a program.

If you have used reasonable structure and meaningfull variable / 
procedure / function names then this isn't too bad but there's a awfull 
lot of code out there with 1 letter variable names (perticually C in my 
experience) & bad structure that actually make the code harder to 
understand. This is when comments are essential.

Cheers.

Phill.

-- 
Phill Harvey-Smith, Programmer, Hardware hacker, and general eccentric !

"You can twist perceptions, but reality won't budge" -- Rush.