[jira] [Assigned] (MJAVADOC-658) The fix operation deletes generic functions's generic-class javadoc if exist, and add it if lack, and will not create it if param part of javadoc be empty

["Robert Scholte (Jira)" <ji...@apache.org>]

     [ https://issues.apache.org/jira/browse/MJAVADOC-658?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]

Robert Scholte reassigned MJAVADOC-658:
---------------------------------------

    Assignee: Elliotte Rusty Harold

> The fix operation deletes generic functions's generic-class javadoc if exist, and add it if lack, and will not create it if param part of javadoc be empty
> ----------------------------------------------------------------------------------------------------------------------------------------------------------
>
>                 Key: MJAVADOC-658
>                 URL: https://issues.apache.org/jira/browse/MJAVADOC-658
>             Project: Maven Javadoc Plugin
>          Issue Type: Bug
>          Components: fix
>            Reporter: Jin Xu
>            Assignee: Elliotte Rusty Harold
>            Priority: Major
>             Fix For: 3.2.1
>
>
> fixed in https://github.com/apache/maven-javadoc-plugin/pull/55
> original function:
> {code:java}
>     public <T extends Object> void testGeneric(Class<T> tClass, Object o) {
>         return;
>     }
> {code}
> after running "fix", we get:
> {code:java}
>     /**
>      * <p>testGeneric.</p>
>      *
>      * @param tClass a {@link java.lang.Class} object.
>      * @param o a {@link java.lang.Object} object.
>      * @param <T> a T object.
>      */
>     public <T extends Object> void testGeneric(Class<T> tClass, Object o) {
>         return;
>     }
> {code}
> after running "fix" another time, we get:
> {code:java}
>     /**
>      * <p>testGeneric.</p>
>      *
>      * @param tClass a {@link java.lang.Class} object.
>      * @param o a {@link java.lang.Object} object.
>      */
>     public <T extends Object> void testGeneric(Class<T> tClass, Object o) {
>         return;
>     }
> {code}
> after running "fix" the third time, we get:
> {code:java}
>     /**
>      * <p>testGeneric.</p>
>      *
>      * @param tClass a {@link java.lang.Class} object.
>      * @param o a {@link java.lang.Object} object.
>      * @param <T> a T object.
>      */
>     public <T extends Object> void testGeneric(Class<T> tClass, Object o) {
>         return;
>     }
> {code}
> again.
> and if we run fix for another time, it will continue the loop.
> so do we really need {code:java}@param <T> a T object.{code}?
> If not, then it is wrongly added.
> If so, then it is wrongly deleted.
> Be a bug either way.



--
This message was sent by Atlassian Jira
(v8.3.4#803005)