Community
Participate
Working Groups
Having a code like this in your class /** * * @param <C> bla bla bla */ public abstract class MyWidget<C extends Control> { and hitting CTRL+SHIFT+F results in code like this: /** * * @param < * C> bla bla bla */ public abstract class MyWidget<C extends Control> {
Which build?
I20080502-0100
I confirm this bug. This is very annoying because JavaDoc does not recognize the parameter if a new-line is inserted in the tag. Moreover, this makes the documentation looks ugly. This happens in Eclipse 3.4M7, don't know about previous versions.
This will be partially fixed in RC1 (you can already get it in RC1 candidate build I20080515-2000)... The output for RC1 will be: /** * * @param <C> bla bla bla */ instead of obviously bogus 3.4M7 formatting... However, I keep this bug opened as, with Eclipse built-in settings, the real output should be (as it was in 3.3): /** * * @param <C> * bla bla bla */ The problem comes from the fact that the scribe does not set the parser source level, hence the Javadoc parser does not know that it should accept this generic syntax...
Created attachment 100674 [details] Proposed patch
Jerome, I think this fix could be a good candidate for RC2. There's no regression risk, the change is really small and with it the formatter will accept possible 1.5 syntax in Javadoc comment.
Agreed that it is a good candidate for RC2
Patch looks good: +1
Eric, can you please review?
Released for 3.4RC2 in HEAD stream.
verified for 3.4RC2 using build I20080523-0100