Robert,

JavaDoc guide suggest you not to use exact method signatures in @see if
possible. If you need exact signature simply type "(", press Ctrl+Space
and see what happens.

Best regards,
Mike Aizatsky.
------------------------------
IntelliJ Software, "Develop with pleasure!" http://www.intellij.com


> -----Original Message-----
> From: [EMAIL PROTECTED] [mailto:[EMAIL PROTECTED]]
On
> Behalf Of Robert F. Beeger
> Sent: Monday, February 18, 2002 2:01 AM
> To: [EMAIL PROTECTED]
> Subject: [Eap-list] Bug in @see autocompletion
> 
> Hello!
> 
> By coincidence I discovered IDEAs new autocompletion ability in
> see-tags. It's great, but it has a bug
> Say I have three operations
> 
> /**
>  * bla
>  */
> public void bla(String blub);
> 
> /**
>  * blub
>  */
> public void bla(String bla, String blub);
> 
> /**
>  * blablub
>  */
> public void blablub();
> 
> When I go to the javadoc comment of blablub(), type "@see #" and press
> Ctrl-Space, I get a list of all operations and attributes of that
> class. Now lets say I choose bla(String bla, String blub) from the
> list. This leads to the following change
> 
> /**
>  * blablub
>  *
>  * @see #bla
>  */
> public void blablub();
> 
> But it should be
> 
> /**
>  * blablub
>  *
>  * @see #bla(String, String)
>  */
> public void blablub();
> 
> Otherwise javadoc can not decide to which operation this link shall
> point.
> 
> And please do not generate imports for classes that are only
> referenced in the javadoc comments. Add full qualified names in
> javadoc comments for classes that are only referenced in javadoc
> comments. As there will be different opinions about this, having it as
> an option would be fine.
> 
> --
> Greets
>  Robert


_______________________________________________
Eap-list mailing list
[EMAIL PROTECTED]
http://www.intellij.com/mailman/listinfo/eap-list

Reply via email to