Re: [JPP-Devel] Question about Javadoc comment commits...

2007-06-25 Thread Larry Becker
Doesn't seem excessive to me. Larry On 6/25/07, Sunburned Surveyor <[EMAIL PROTECTED]> wrote: > Larry wrote: "IMO Javadoc comments should be short statements of > > purpose. They shouldn't talk about algorithms, but should document > > anything unusual about parameters. For example, Object para

Re: [JPP-Devel] Question about Javadoc comment commits...

2007-06-25 Thread Sunburned Surveyor
Larry wrote: "IMO Javadoc comments should be short statements of > purpose. They shouldn't talk about algorithms, but should document > anything unusual about parameters. For example, Object parameters are > used in RenderManager methods, but it isn't documented what Objects > are acceptable." E

Re: [JPP-Devel] Question about Javadoc comment commits...

2007-06-25 Thread Larry Becker
Hi SS, OK by me. IMO Javadoc comments should be short statements of purpose. They shouldn't talk about algorithms, but should document anything unusual about parameters. For example, Object parameters are used in RenderManager methods, but it isn't documented what Objects are acceptable. reg