You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@netbeans.apache.org by "Dmitry.Mochalov (Jira)" <ji...@apache.org> on 2020/03/26 08:53:00 UTC
[jira] [Updated] (NETBEANS-4070) JavaDoc in tooltip (clrl+mouse
hover) duplicates the description of parameters of a method when the method
overrides the parent method
[ https://issues.apache.org/jira/browse/NETBEANS-4070?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]
Dmitry.Mochalov updated NETBEANS-4070:
--------------------------------------
Description:
Steps to reproduce:
1) Create a class that extends AbstractList
2) Override the addAll method and add Javadoc like this:
public class ListImpl<E> extends AbstractList<E>
{ /** * Description. 0. ListImpl. * * @return <br> 1. ListImpl. * * @param index 2. ListImpl. * * @throws \\{@inheritDoc}
*/
@Override
public boolean addAll(int index,
Collection<? extends E> c) throws ClassCastException,IndexOutOfBoundsException
{ return true; }
...
... (other methods)...
...
}
The ToolTip shows this (see the first attachment):
but should show this (see the second attachment):
If a parameter has a Javadoc description in the local method Javadoc should use it. If a parameter doesn't have a local description Javadoc should use description inherited from the parent.
was:
Steps to reproduce:
1) Create a class that extends AbstractList
2) Override the addAll method and add Javadoc like this:
public class ListImpl<E> extends AbstractList<E> {
/**
* Description. 0. ListImpl.
*
* @return <br> 1. ListImpl.
*
* @param index 2. ListImpl.
*
* @throws \{@inheritDoc}
*/
@Override
public boolean addAll(int index,
Collection<? extends E> c) throws ClassCastException,IndexOutOfBoundsException {
return true;
}
...
... (other methods)...
...
}
The ToolTip shows this (see the first attachment):
but should show this (see the second attachment):
!image-2020-03-26-11-50-17-037.png!
If a parameter has a Javadoc description in the local method Javadoc should use it. If a parameter doesn't have a local description Javadoc should use description inherited from the parent.
> JavaDoc in tooltip (clrl+mouse hover) duplicates the description of parameters of a method when the method overrides the parent method
> --------------------------------------------------------------------------------------------------------------------------------------
>
> Key: NETBEANS-4070
> URL: https://issues.apache.org/jira/browse/NETBEANS-4070
> Project: NetBeans
> Issue Type: Bug
> Components: java - Javadoc
> Affects Versions: 11.0, 11.2, 11.3
> Reporter: Dmitry.Mochalov
> Priority: Minor
> Attachments: 2020-03-25_22-11-32.png, 2020-03-25_22-13-22.png
>
>
> Steps to reproduce:
> 1) Create a class that extends AbstractList
> 2) Override the addAll method and add Javadoc like this:
> public class ListImpl<E> extends AbstractList<E>
> { /** * Description. 0. ListImpl. * * @return <br> 1. ListImpl. * * @param index 2. ListImpl. * * @throws \\{@inheritDoc}
> */
> @Override
> public boolean addAll(int index,
> Collection<? extends E> c) throws ClassCastException,IndexOutOfBoundsException
> { return true; }
> ...
> ... (other methods)...
> ...
> }
> The ToolTip shows this (see the first attachment):
>
>
> but should show this (see the second attachment):
>
>
> If a parameter has a Javadoc description in the local method Javadoc should use it. If a parameter doesn't have a local description Javadoc should use description inherited from the parent.
--
This message was sent by Atlassian Jira
(v8.3.4#803005)
---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@netbeans.apache.org
For additional commands, e-mail: commits-help@netbeans.apache.org
For further information about the NetBeans mailing lists, visit:
https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists