Subj : Re: Is well written code a rare species ?
To   : comp.programming
From : Phlip
Date : Fri Aug 12 2005 11:04 pm

Scott Moore wrote:

> The basic idea here is that people's idea of what is "good" code varies
> quite a bit. I have had it asserted to me, several times in fact, that
> NO comments on a program is Ok if the program is otherwise structured
> correctly and/or has "meaningful" variable/function names.

The better advice is to treat all comments as opportunities to improve 
structure. For example:

 extern int global; // please don't screw with this global variable because 
....

The improvement is to encapsulate that variable and not leave it hanging out 
all over the place. That reduces the burden of reading comments before 
upgrading the code.

-- 
  Phlip
  http://www.greencheese.org/ZeekLand  <-- NOT a blog!!!

.