From 2bbdaeb3b2296a2910e5d44152a02cc0f098ce59 Mon Sep 17 00:00:00 2001
From: Valery Kharseko <vharseko@3a-systems.ru>
Date: Wed, 15 Jul 2026 06:08:37 +0000
Subject: [PATCH] Enable Javadoc doclint (all,-missing) and fail on warnings (#734)
---
pom.xml | 13 ++++++++++---
1 files changed, 10 insertions(+), 3 deletions(-)
diff --git a/pom.xml b/pom.xml
index 16be739..0d9458d 100644
--- a/pom.xml
+++ b/pom.xml
@@ -35,7 +35,7 @@
<product.locales>ca_ES,es,de,fr,ja,ko,pl,zh_CN,zh_TW</product.locales>
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
<localized.jars.classifier>i18n</localized.jars.classifier>
- <commons.version>3.1.1</commons.version>
+ <commons.version>3.1.2-SNAPSHOT</commons.version>
<freemarker.version>2.3.34</freemarker.version>
<metrics-core.version>4.2.30</metrics-core.version>
<bc.fips.version>2.1.2</bc.fips.version>
@@ -67,6 +67,11 @@
<docGuideRefUrl>https://doc.openidentityplatform.org/opendj/man-pages/</docGuideRefUrl>
<docGuideAdminUrl>https://doc.openidentityplatform.org/opendj/admin-guide/</docGuideAdminUrl>
+ <!-- Javadoc doclint level (single source of truth, inherited by every module).
+ all,-missing = run all checks (html/syntax/reference/accessibility) but do
+ not require missing comments/tags. Read by maven-javadoc-plugin via -Ddoclint. -->
+ <doclint>all,-missing</doclint>
+
</properties>
<inceptionYear>2011</inceptionYear>
@@ -322,8 +327,9 @@
</execution>
</executions>
<configuration>
- <doclint>none</doclint>
+ <doclint>${doclint}</doclint>
<notimestamp>true</notimestamp>
+ <failOnWarnings>true</failOnWarnings>
</configuration>
</plugin>
<plugin>
@@ -423,7 +429,7 @@
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-javadoc-plugin</artifactId>
- <version>3.11.2</version>
+ <version>3.12.0</version>
</plugin>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
@@ -485,6 +491,7 @@
<plugin>
<groupId>org.openidentityplatform.commons.i18n-framework</groupId>
<artifactId>maven-plugin</artifactId>
+ <version>${commons.version}</version>
</plugin>
<plugin>
--
Gitblit v1.10.0