Bug 59960

Summary: Building javadocs with java8 fails
Product: Tomcat 8 Reporter: Coty Sutherland <csutherl>
Component: DocumentationAssignee: Tomcat Developers Mailing List <dev>
Severity: normal    
Priority: P2    
Version: 8.0.36   
Target Milestone: ----   
Hardware: PC   
OS: Linux   
Attachments: patch proposal

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