[jira] [Assigned] (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:all-tabpanel ]

Robert Scholte reassigned MJAVADOC-659:
---------------------------------------

    Assignee: Elliotte Rusty Harold

> 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
>            Assignee: Elliotte Rusty Harold
>            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)