[MJAVADOC-564] Generated javadoc tags in fix goal are not in proper order

• Type: Bug
• Status: Open
• Priority: Major
• Resolution: Unresolved
• Affects Version/s: 2.10.4, 3.0.1
• Component/s: fix
• Assignee: Unassigned
• Reporter: Richard Sand
• Created: 14/Jan/19 22:17
• Updated: 15/Jan/19 03:37

Description

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