In our previous episode, Felipe Monteiro de Carvalho said:
> On Tue, Oct 21, 2008 at 11:28 AM, Marco van de Voort <[EMAIL PROTECTED]>
> wrote:
> > If not, the comments in the sources reduce to warn for gotcha's and other
> > notes, that might not belong in the docs at all. I don't see duplication a
> > problem if they have two separate purposes. Or better: then it is not
> > duplication.
>
> Not all comments are in the documentation. Only those marked to be,
> like {@@ .... }
I know, but they drown out in the noise. And then some bright guy decides to
wrap all comments in code folding directives and doesn't pay attention ot
that, and after that it gets really complicated and confusing :-)
It of course depends on the project, for small trivial stuff managed by one
person it doesn't really matter, as long as you are consequent in either
way.
_______________________________________________
fpc-pascal maillist - fpc-pascal@lists.freepascal.org
http://lists.freepascal.org/mailman/listinfo/fpc-pascal
