Hi,
The HTML check from JavadocStyle is buggy. It’ll fail for example on:
/**
* An event triggered when a extension is going to be upgraded.
* <p>
* The event also send the following parameters:
* </p>
* <ul>
* <li>source: the related new {@link org.xwiki.extension.LocalExtension} instance</li>
* <li>data: a {@code java.util.Collection<org.xwiki.extension.InstalledExtension>} containing the previous
* {@link org.xwiki.extension.InstalledExtension} instances</li>
* </ul>
*
* @see ExtensionUpgradedEvent
* @see ExtensionUpgradeFailedEvent
* @version $Id: 4a1dfd82bdb9c4447844fb154cc654343aaf934a $
* @since 9.2RC1
*/
See:
- https://github.com/checkstyle/checkstyle/issues/3351
- https://github.com/checkstyle/checkstyle/issues/1023
Thus I propose to disable this check for now.
See also the discussion at You're invited to talk on Matrix