[LUCENE-9912] Disable HTML doclint in Lucene/Solr 8

• Type: Task
• Status: Resolved
• Priority: Blocker
• Resolution: Fixed
• Affects Version/s: 8.x, 8.8.1
• Fix Version/s: 8.x, 8.8.3
• Component/s: general/build
• Labels: Java17

Environment

openjdk version "17-ea" 2021-09-14
OpenJDK Runtime Environment (build 17-ea+16-1315)
OpenJDK 64-Bit Server VM (build 17-ea+16-1315, mixed mode, sharing)

• Lucene Fields: New
• Assignee: Uwe Schindler
• Reporter: Uwe Schindler
• Created: 07/Apr/21 11:45
• Updated: 28/Aug/22 16:20
• Resolved: 07/Apr/21 13:43

Description

Due to LUCENE-9209 we fixed most of the Javadocs in Lucene / Solr master/main.

But we did not do that in Lucene 8. Unfortunetaly later Java versions (JDK 17) now fail to compile or run javadoc, because the later java versions apply very strict HTML5 checks.

The main problem again is thet we unconditinally enable -Werror at the same time with -Xdoclint:all (as said hundreds of times by me, we should really only enable warnings we know of!).

To allow compilation with JDK-17 or later I will remove the HTML warnings from the config

Issue Links

• links to: GitHub Pull Request #2480
• links to: JDK-8264843