since value of a mojo parameter missing in plugin.xml

[ppalaga]

Given the following Java source of a parameter

    /**
     * If {@code true} the execution of the Mojo will be skipped; otherwise the Mojo will be executed.
     *
     * @since 0.0.1
     */
    @Parameter(property = "editorconfig.skip", defaultValue = "false")
    private boolean skip;

the PluginDescriptorMojo produces the following fragment in plugin.xml:

        <parameter>
          <name>skip</name>
          <type>boolean</type>
          <required>false</required>
          <editable>true</editable>
          <description>If {@code true} the execution of the Mojo will be skipped; otherwise the Mojo will be executed.

 @since 0.0.1</description>
        </parameter>

Note that @since 0.0.1 is a part of <description> (which should not be the case) and <since> tag is missing (expected: present).

I guess the same holds for @deprecated

[ppalaga]

I figured this out after I built a plugin site using maven-plugin-plugin patched with apache/maven-plugin-tools#10

[ifedorenko]

This is a know limitation https://github.com/takari/takari-lifecycle/blob/takari-lifecycle-1.13.3/takari-lifecycle-plugin/src/main/java/io/takari/maven/plugins/plugin/MojoDescriptorGleaner.java#L42 . The fix requires javadoc parsing, something annotation processing API does not support.