[LUCENE-7651] Javadocs build fails with Java 8 update 121

• Type: Bug
• Status: Closed
• Priority: Critical
• Resolution: Fixed
• Affects Version/s: 6.4
• Fix Version/s: 6.4.1, 6.5, 7.0
• Component/s: general/javadocs
• Labels: Java8

Environment

Java 8 update 121

• Lucene Fields: New
• Assignee: Uwe Schindler
• Reporter: Uwe Schindler
• Created: 22/Jan/17 09:11
• Updated: 28/Aug/22 15:09
• Resolved: 22/Jan/17 17:32

Description

Oracle released the recent Java 8 security update (u121). The Jenkins builds fail with the following error while building the Javadocs:

  [javadoc] Constructing Javadoc information...
  [javadoc] javadoc: error - Argument for -bottom contains JavaScript.
  [javadoc] Use --allow-script-in-comments to allow use of JavaScript.
  [javadoc] 1 error

This is caused by the Javascript added to pretty-print code examples. We load this in the page footer "<bottom>" parameter.

Surely, it will be posisble to simply add the mentioned argument, but this will break builds with earlier Java 8 versions.

This is nowhere documented, I haven't seen any documentation about this flag nowhere, so I assume this is a bug in Java. They can't change or add command line parameters in minor updates of Java 8. I will ask on the OpenJDK mailing lists if this is a bug (maybe accidentally backported from Java 9).