[
https://issues.apache.org/jira/browse/MPLUGIN-298?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel
]
Konrad Windszus resolved MPLUGIN-298.
-------------------------------------
Fix Version/s: 3.7.0
Resolution: Fixed
With
https://github.com/apache/maven-plugin-tools/commit/e13cfb8cfdd64df61da90fa307d5ff5b9197e2af
the see taglet is now added to the mojo and parameter description,.
> The plugin descriptor generated by plugin:descriptor does not evaluate
> javadoc block taglets
> --------------------------------------------------------------------------------------------
>
> Key: MPLUGIN-298
> URL: https://issues.apache.org/jira/browse/MPLUGIN-298
> Project: Maven Plugin Tools
> Issue Type: Bug
> Components: Plugin Plugin
> Affects Versions: 3.4
> Reporter: Konrad Windszus
> Priority: Minor
> Fix For: 3.7.0
>
>
> The description element (1) for both the mojo itself as well as for all
> parameters is extracted from the Javadoc (of the class respectively the
> field).
> The block javadoc tags are stripped here while inline javadoc tags are just
> ending up as is in the plugin descriptor.
> E.g. the see tags are completely ignored which means that this won't appear
> in the mojo's description:
> {code}
> /**
> * some text with {@code code-references}
> * @see <a href="http://example.com";>some external source</a>
> */
> {code}
> will be converted to to the following plugin descriptor
> {code}
> <mojos>
> <mojo>
> <goal>...</goal>
> <description>some text with {@code code-references}</description>
> {code}
> Although it is not documented in (1) it seems that all description elements
> can deal with (escaped) html tags as well as certain javadoc tags (because
> those will be automatically stripped from the output being generated by the
> maven-help-plugin or by the Mojo being generated by {{plugin:helpmojo}}) and
> automatically considered when the site is being generated from the plugin
> descriptor. Can you clarify the reference documentation with which tags are
> supported here and also extend the list of javadoc tags which can be put into
> those elements
> (1) - https://maven.apache.org/ref/3.3.9/maven-plugin-api/plugin.html
--
This message was sent by Atlassian Jira
(v8.20.10#820010)
