Richard Sand created MJAVADOC-564:
-------------------------------------

             Summary: Generated javadoc tags in fix goal are not in proper order
                 Key: MJAVADOC-564
                 URL: https://issues.apache.org/jira/browse/MJAVADOC-564
             Project: Maven Javadoc Plugin
          Issue Type: Bug
          Components: fix
    Affects Versions: 3.0.1, 2.10.4
            Reporter: Richard Sand


The javadoc:fix goal is placing/moving the @throws tags to the bottom of the 
tags, which isn't the proper order if there is a since tag.

Example: {{}}

{{    /**}}
{{     * <p>initialize.</p>}}
{{     *}}
{{     * @param keyClass a \{@link java.lang.Class} object.}}
{{     * @param valueClass a \{@link java.lang.Class} object.}}
{{     * @throws com.idfconnect.ssorest.cache.CacheException if any.}}
{{     * @since 3.1.4}}
{{     */}}

Get changed to:

{{    /**}}
{{     * <p>initialize.</p>}}
{{     *}}
{{     * @param keyClass a \{@link java.lang.Class} object.}}
{{     * @param valueClass a \{@link java.lang.Class} object.}}
{{     * @since 3.1.4}}
{{     * @throws com.idfconnect.ssorest.cache.CacheException if any.}}

{{*/}}

The exact order of tags is documented here for reference:

[https://www.oracle.com/technetwork/java/javase/documentation/index-137868.html#orderoftags]

 

 

 

 



--
This message was sent by Atlassian JIRA
(v7.6.3#76005)

Reply via email to