> > but also suggest that
> > end of line
> > code should largely NOT require any understanding of what the
> > code does for
> > the comment to make sense.
>
> Like all things, that depends on your intended audience. If that
> audience includes people who don't immediately recognise an if statement
> if they see one you are right.

Target audience was anyone who needs to know what the writer thought the
code was meant to do but at present has no sure knowledge. That may be
someone else now or myself a month, year or decade later..

The idea was that you are not jumping in and out of the code proper to read
the meaning. You can of course do so if you wish. Obviously not an essential
but makes meaning vvv clear long after you've forgotten ever having written
it. Maybe some people never have that problem :-) .


        Russell

--
http://www.piclist.com hint: The PICList is archived three different
ways.  See http://www.piclist.com/#archives for details.