[
https://jira.codehaus.org/browse/MPLUGIN-244?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=330466#comment-330466
]
Nicholas Williams commented on MPLUGIN-244:
-------------------------------------------
{quote}Why is this self closing element not allowed?{quote}
Because, unfortunately, the JDK 8 team has decided to enforce HTML validator
_warnings_ in JavaDoc as _errors_ that cause JavaDoc to fail. There was
*significant* discussion [1, 2] on the Java 8 core libs mailing list about
this, and *a lot* of people are complaining about it, but it doesn't look like
they're budging.
It boils down to their desire to generate W3C validator-proof JavaDoc, which
isn't a bad goal in and of itself. In HTML 4, self-closing break tags ({{<br
/>}}) technically aren't supported and trigger a warning in the validator.
However, *every* browser supports them and parses them correctly, and this
change will make *thousands and thousands* of projects fail to generate JavaDoc
on Java 8.
Those of us against the change tried to compromise and say at least make this a
_warning_ instead of an _error_, but it doesn't look like they're budging on
that, either. Feel free to join the list and chime in on the matter. Maybe they
just haven't been annoyed by enough people.
[1] http://mail.openjdk.java.net/pipermail/core-libs-dev/2013-July/019261.html
[2] http://mail.openjdk.java.net/pipermail/core-libs-dev/2013-July/019269.html
> Help mojo generates Javadoc, which is not accepted by JDK 8 doclint
> -------------------------------------------------------------------
>
> Key: MPLUGIN-244
> URL: https://jira.codehaus.org/browse/MPLUGIN-244
> Project: Maven Plugin Tools
> Issue Type: Bug
> Components: Plugin Plugin
> Affects Versions: 3.2
> Reporter: Evgeny Mandrikov
> Assignee: Herve Boutemy
> Fix For: 3.3
>
> Attachments: reproducer.zip
>
>
> "mvn clean package" on [^reproducer.zip] leads to:
> {noformat}
> 00:51:47 [ERROR] Failed to execute goal
> org.apache.maven.plugins:maven-javadoc-plugin:2.9:jar (default) on project
> example: MavenReportException: Error while creating archive:
> 00:51:47 [ERROR] Exit code: 1 -
> /tmp/help/reproducer/target/generated-sources/plugin/example/HelpMojo.java:24:
> error: self-closing element not allowed
> 00:51:47 [ERROR] * Display help information on example.<br/>
> {noformat}
--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators
For more information on JIRA, see: http://www.atlassian.com/software/jira
