[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: succinctness = power

kanderson@bbn.com wrote:

> Documentation generators, like javadoc are useful, but sometimes 
> documentation takes on a life of its own.  I once looked at the 73 
> uses of EventListenerList and found 25 cases where the documentation 
> did not match the code. 

My experience with comments is similar.  They lie.  They were probably 
right when they were written, but there is no mechanism to enforce 
keeping them in sync with the code.