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

Including
- people who have never seen C before?
- people who have never seen any programming language before?
- people who have never seen english before?
- people who have never seen any human language before?
- 'people' from Tau Ceti who have no experience with any human culture?

I state again: you can't make a sensible comment on commenting (nor on
most other subjects) without stating your point of reference, in this
case the intended audience. And an audience specification that starst
with 'anyone' is highly suspicious :)

When I comment code for my own use my audience is clear: me, but without
recent exposure to the code at hand. In most cases this means commenting
the language consruct itself or even the local function of a statement
is a waste of time (both for the writer and for the reader). Comments
reflect the 'bigger picuture', block comments dominate.

When I comment a 'tutorial' piece of Jal the audience is very different:
just starting to use PICs, some programming experience but probably not
in Jal, probably confused over evry little detail. End-of-line comments
will probably dominate, block comments don't make much sense as the
overall purpose will likely be simple.

Wouter van Ooijen

-- -------------------------------------------
Van Ooijen Technische Informatica: www.voti.nl
consultancy, development, PICmicro products

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