From 22fdbdd6c96e2471d55c80ace0670ed77ecd1427 Mon Sep 17 00:00:00 2001 From: Shinsuke Sugaya Date: Mon, 14 Sep 2026 22:43:55 +0900 Subject: [PATCH] fix: stop javadoc from reporting the imported tree's missing comments #44 removed the javadoc errors but left 12,486 warnings, all of them from doclint's `missing` group: 6,744 "no comment", 2,332 "no @return", and @param/@throws gaps throughout the imported OpenSearch tree. That is upstream's documentation coverage, not a defect introduced here, and it buries anything worth reading in the build output. Set `doclint` to `all,-missing`, so the groups that catch real breakage - syntax, HTML, accessibility and references - still fail the build, while completeness is left alone. It also pins behaviour that otherwise depends on the JDK in use. `mvn javadoc:javadoc` and `mvn -Prelease javadoc:jar` now report 0 errors and 0 warnings, and still generate all 4,902 pages. --- pom.xml | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/pom.xml b/pom.xml index bd798610..5199dc80 100644 --- a/pom.xml +++ b/pom.xml @@ -54,6 +54,10 @@ UTF-8 UTF-8 UTF-8 + + all,-missing