[jira] [Commented] (MJAVADOC-659) javadoc:fix replaces existing @throws descriptions

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

    [ https://issues.apache.org/jira/browse/MJAVADOC-659?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=17325878#comment-17325878 ] 

Robert Scholte commented on MJAVADOC-659:
-----------------------------------------

Fixed in [74b03f4cb2caa4a0b455971032711de93396af75|https://gitbox.apache.org/repos/asf?p=maven-javadoc-plugin.git;a=commit;h=74b03f4cb2caa4a0b455971032711de93396af75]

> javadoc:fix replaces existing @throws descriptions
> --------------------------------------------------
>
>                 Key: MJAVADOC-659
>                 URL: https://issues.apache.org/jira/browse/MJAVADOC-659
>             Project: Maven Javadoc Plugin
>          Issue Type: Bug
>          Components: fix
>            Reporter: Jin Xu
>            Priority: Major
>             Fix For: 3.2.1
>
>
> original code:
> {code:java}
>     /**
>      * <p>testException.</p>
>      *
>      * @throws java.lang.Exception when reader.read get wrong.
>      */
>     public void testException() throws Exception {
>         throw new Exception();
>     }
> {code}
> after we calling fix, it becomes:
> {code:java}
>     /**
>      * <p>testException.</p>
>      *
>      * @throws java.lang.Exception if any.
>      */
>     public void testException() throws Exception {
>         throw new Exception();
>     }
> {code}
> So why must I use "if any", and must change my original words?
> I think this be a bug, but if it is by design, please tell me the reason.



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