[
https://issues.apache.org/jira/browse/MJAVADOC-658?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=17325875#comment-17325875
]
Robert Scholte commented on MJAVADOC-658:
-----------------------------------------
Fixed in
[3dafe0180e5b2fe5103ebd1fcf7d3d9775acb82e|https://gitbox.apache.org/repos/asf?p=maven-javadoc-plugin.git;a=commit;h=3dafe0180e5b2fe5103ebd1fcf7d3d9775acb82e]
> 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
> 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)
