Guilhem, guys,
I'd say, enough theoretical talk. Could each proponent
of a specific method of commenting pick some class, and
send to the list a sample with comments for both the
interface and implementation of few class members.
Such an example should contain a complete meaningful
description, not just a formal description of parameters
and results.
Having such examples would make it much clearer to everyone
who means what, and will hopefully make it easier to conclude
what are the pros and cons of each approach and come to a
decision.
Also, it would be great if someone could summarize what are
the suggestions, and what are the pros an cons. (Tor?) Otherwise
this discussion can go on forever.
Timour
