[nem-en] Re: Re[2]: Documentation comments clarification and proposals[Long]

[Michal Moskal]

On 11/11/06, Igor Tkachev <it at rsdn.ru> wrote:
> > Otherwise (external) it is harder to check correctness (you will almost always
> > need a good deal of parsing to do that) and it will soon become obsolete.
>
> The correctness should be checked by the compiler. It works like an
> include.

The point is that when you change the semantics of a method and see a
documentation comment stating the old semantics, you're more likely to
change it, than if it hangs around somewhere in external file.

-- 
   Michał