Bug 59960 - Building javadocs with java8 fails
Summary: Building javadocs with java8 fails
Alias: None
Product: Tomcat 8
Classification: Unclassified
Component: Documentation (show other bugs)
Version: 8.0.36
Hardware: PC Linux
: P2 normal (vote)
Target Milestone: ----
Assignee: Tomcat Developers Mailing List
Depends on:
Reported: 2016-08-08 21:26 UTC by Coty Sutherland
Modified: 2016-08-09 16:24 UTC (History)
0 users

patch proposal (821 bytes, patch)
2016-08-08 21:29 UTC, Coty Sutherland
Details | Diff

Note You need to log in before you can comment on or make changes to this bug.
Description Coty Sutherland 2016-08-08 21:26:20 UTC
Building javadocs with java7 works fine, but if you try and use java8 it fails with the following error:

  [javadoc] ~/apache-tomcat-8.0.36-src/output/dist/src/java/org/apache/catalina/tribes/group/interceptors/MessageDispatch15Interceptor.java:21: error: bad use of '>'
  [javadoc]  *             features. Now the minimum Java version is >=5, those features
  [javadoc]                                                          ^
  [javadoc] Building index for all the packages and classes...
  [javadoc] Building index for all classes...
  [javadoc] Generating /builddir/build/BUILD/apache-tomcat-8.0.36-src/output/dist/webapps/docs/api/help-doc.html...
  [javadoc] 1 error
  [javadoc] 100 warnings
Comment 1 Coty Sutherland 2016-08-08 21:27:11 UTC
I accidentally submitted that before I was done...

To reproduce the issue, use java8 and execute `ant javadoc`, then observe the failure.
Comment 2 Coty Sutherland 2016-08-08 21:29:53 UTC
Created attachment 34112 [details]
patch proposal

This patch resolves the error by using the greater-than HTML entity instead of the '>' character which allows me to build javadocs using java8 successfully.
Comment 3 Mark Thomas 2016-08-09 16:24:15 UTC
Patch applied to 8.0.x for 8.0.37 onwards