[
https://issues.apache.org/jira/browse/MJAVADOC-658?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=17958049#comment-17958049
]
Olivier Lamy commented on MJAVADOC-658:
---------------------------------------
This project has moved from Jira to GitHub Issues. This issue was migrated to
[apache/maven-javadoc-plugin#1035|https://github.com/apache/maven-javadoc-plugin/issues/1035].
> 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 (Moved to GitHub Issues)
> Issue Type: Bug
> Components: fix
> Reporter: Jin Xu
> Assignee: Elliotte Rusty Harold
> Priority: Major
> Fix For: 3.3.0
>
>
> 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.20.10#820010)
