-
Bug
-
Resolution: Fixed
-
Minor
-
None
-
java version "1.8.0_102", Maven 3.3.9, maven-javadoc-plugin 2.10.4
Jenkins 2.7.2, Warnings Plug-in 4.56
Enabling doclint with the options -Xdoclint:all -Xdoclint:-missing I get the following output:
. . . truncated . . . [INFO] ------------------------------------------------------------------------ [INFO] BUILD FAILURE [INFO] ------------------------------------------------------------------------ [INFO] Total time: 20.451 s [INFO] Finished at: 2016-09-06T09:36:28+02:00 [INFO] Final Memory: 37M/534M [INFO] ------------------------------------------------------------------------ [ERROR] Failed to execute goal org.apache.maven.plugins:maven-javadoc-plugin:2.10.4:jar (attach-javadocs) on project cache2k-api: MavenReportException: Error while generating Javadoc: [ERROR] Exit code: 1 - /home/jeans/ideaWork/cache2k-internal/cache2k/api/src/main/java/org/cache2k/processor/MutableCacheEntry.java:79: error: malformed HTML [ERROR] * @see <a href="https://github.com/jsr107/jsr107tck/issues/84>JSR107 TCK issue 84</a> [ERROR] ^ [ERROR] /home/jeans/ideaWork/cache2k-internal/cache2k/api/src/main/java/org/cache2k/processor/MutableCacheEntry.java:79: error: bad use of '>' [ERROR] * @see <a href="https://github.com/jsr107/jsr107tck/issues/84>JSR107 TCK issue 84</a> [ERROR] ^ [ERROR] /home/jeans/ideaWork/cache2k-internal/cache2k/api/src/main/java/org/cache2k/processor/MutableCacheEntry.java:79: error: unexpected end tag: </a> [ERROR] * @see <a href="https://github.com/jsr107/jsr107tck/issues/84>JSR107 TCK issue 84</a> [ERROR] ^ . . . truncated . . .
These errors do not get picked up by the plugin.
Side node: IMHO JavaDoc "errors" are no real compile errors, but Java 8 has a different thinking. So what I do is to have a separate lint Jenkins Job that runs with different doclint options.
Code changed in jenkins
User: Ulli Hafner
Path:
src/main/java/hudson/plugins/warnings/parser/JavaDocParser.java
src/test/java/hudson/plugins/warnings/parser/JavaDocParserTest.java
src/test/resources/hudson/plugins/warnings/parser/issue37975.txt
http://jenkins-ci.org/commit/warnings-plugin/01a54cc79a4a52627e1c850b9f1450cbfe2bd97d
Log:
[FIXED JENKINS-37975] Detect JavaDoc errors in 1.8 format.
Compare: https://github.com/jenkinsci/warnings-plugin/compare/f6cd428eb75e...01a54cc79a4a