From 027e67a54beaa4b827776e7a6506d82f9d509758 Mon Sep 17 00:00:00 2001
From: Robert Varga <robert.varga@pantheon.tech>
Date: Wed, 10 Jan 2024 12:55:03 +0100
Subject: [PATCH] Silence javadoc by default

Clean up build by disabling missing documentation linting or switching
enforcement on where we have zero warnings already.

Change-Id: I0da0d630b81d7090383cb608bdca56fb793e1ce4
Signed-off-by: Robert Varga <robert.varga@pantheon.tech>
---
 benchmarks/pom.xml                       |  2 ++
 codec/yang-data-codec-binfmt/pom.xml     |  5 +++
 codec/yang-data-codec-gson/pom.xml       |  5 +++
 codec/yang-data-codec-xml/pom.xml        |  5 +++
 common/concepts/pom.xml                  |  5 +++
 common/testutils/pom.xml                 |  5 +++
 common/util/pom.xml                      |  5 +++
 common/yang-common-netty/pom.xml         |  4 +++
 common/yang-common/pom.xml               |  5 +++
 data/yang-data-api/pom.xml               |  5 +++
 data/yang-data-impl/pom.xml              | 45 +++++++++++++-----------
 data/yang-data-spi/pom.xml               |  5 +++
 data/yang-data-transform/pom.xml         |  5 +++
 data/yang-data-tree-api/pom.xml          |  5 +++
 data/yang-data-tree-ri/pom.xml           |  5 +++
 data/yang-data-tree-spi/pom.xml          |  5 +++
 data/yang-data-util/pom.xml              |  5 +++
 docs/pom.xml                             |  5 +++
 model/odlext-model-api/pom.xml           |  5 +++
 model/openconfig-model-api/pom.xml       |  5 +++
 model/rfc6241-model-api/pom.xml          |  5 +++
 model/rfc6536-model-api/pom.xml          |  5 +++
 model/rfc6643-model-api/pom.xml          |  5 +++
 model/rfc7952-model-api/pom.xml          |  5 +++
 model/rfc8040-model-api/pom.xml          |  5 +++
 model/rfc8528-model-api/pom.xml          |  5 +++
 model/rfc8639-model-api/pom.xml          |  5 +++
 model/rfc8819-model-api/pom.xml          |  5 +++
 model/yang-model-api/pom.xml             |  5 +++
 model/yang-model-export/pom.xml          |  5 +++
 model/yang-model-ri/pom.xml              |  5 +++
 model/yang-model-spi/pom.xml             |  5 +++
 model/yang-model-util/pom.xml            |  5 +++
 parser/odlext-parser-support/pom.xml     |  5 +++
 parser/openconfig-parser-support/pom.xml |  5 +++
 parser/rfc6241-parser-support/pom.xml    |  5 +++
 parser/rfc6536-parser-support/pom.xml    |  5 +++
 parser/rfc6643-parser-support/pom.xml    |  5 +++
 parser/rfc7952-parser-support/pom.xml    |  5 +++
 parser/rfc8040-parser-support/pom.xml    |  5 +++
 parser/rfc8528-parser-support/pom.xml    |  5 +++
 parser/rfc8639-parser-support/pom.xml    |  5 +++
 parser/rfc8819-parser-support/pom.xml    |  5 +++
 parser/yang-ir/pom.xml                   |  5 +++
 parser/yang-parser-api/pom.xml           |  5 +++
 parser/yang-parser-impl/pom.xml          |  5 +++
 parser/yang-parser-reactor/pom.xml       |  5 +++
 parser/yang-parser-rfc7950/pom.xml       |  5 +++
 parser/yang-parser-spi/pom.xml           |  5 +++
 parser/yang-test-util/pom.xml            |  5 +++
 plugin/plugin-generator-api/pom.xml      |  5 +++
 plugin/yang-maven-plugin/pom.xml         |  5 +++
 tools/yang-model-validator/pom.xml       |  5 +++
 tools/yang-validation-tool/pom.xml       |  5 +++
 xpath/yang-xpath-api/pom.xml             |  5 +++
 xpath/yang-xpath-impl/pom.xml            |  5 +++
 yang/yang-repo-api/pom.xml               |  5 +++
 yang/yang-repo-fs/pom.xml                |  5 +++
 yang/yang-repo-spi/pom.xml               |  5 +++
 59 files changed, 311 insertions(+), 20 deletions(-)

diff --git a/benchmarks/pom.xml b/benchmarks/pom.xml
index e6a83f16b3..f251990891 100644
--- a/benchmarks/pom.xml
+++ b/benchmarks/pom.xml
@@ -23,6 +23,8 @@
     <properties>
         <!-- JMH-generated code does not pass SB (very noisily)-->
         <odlparent.spotbugs.skip>true</odlparent.spotbugs.skip>
+        <!-- FIXME: fix these up and set maven.javadoc.failOnWarnings=true -->
+        <doclint>all,-missing</doclint>
     </properties>
 
     <dependencies>
diff --git a/codec/yang-data-codec-binfmt/pom.xml b/codec/yang-data-codec-binfmt/pom.xml
index 303af120c6..50799f232a 100644
--- a/codec/yang-data-codec-binfmt/pom.xml
+++ b/codec/yang-data-codec-binfmt/pom.xml
@@ -21,6 +21,11 @@
     <name>${project.artifactId}</name>
     <description>DataInput/Output for NormalizedNodes</description>
 
+    <properties>
+        <!-- FIXME: fix these up and set maven.javadoc.failOnWarnings=true -->
+        <doclint>all,-missing</doclint>
+    </properties>
+
     <dependencies>
         <dependency>
             <groupId>com.google.guava</groupId>
diff --git a/codec/yang-data-codec-gson/pom.xml b/codec/yang-data-codec-gson/pom.xml
index eb8822f43f..6b019deb98 100644
--- a/codec/yang-data-codec-gson/pom.xml
+++ b/codec/yang-data-codec-gson/pom.xml
@@ -21,6 +21,11 @@
     <name>${project.artifactId}</name>
     <description>JSON (RFC7951) encoding for NormalizedNodes</description>
 
+    <properties>
+        <!-- FIXME: fix these up and set maven.javadoc.failOnWarnings=true -->
+        <doclint>all,-missing</doclint>
+    </properties>
+
     <dependencies>
         <dependency>
             <groupId>com.github.spotbugs</groupId>
diff --git a/codec/yang-data-codec-xml/pom.xml b/codec/yang-data-codec-xml/pom.xml
index 1186a73654..ffa2ce64fc 100644
--- a/codec/yang-data-codec-xml/pom.xml
+++ b/codec/yang-data-codec-xml/pom.xml
@@ -21,6 +21,11 @@
     <name>${project.artifactId}</name>
     <description>XML (RFC7950) encoding for NormalizedNodes</description>
 
+    <properties>
+        <!-- FIXME: fix these up and set maven.javadoc.failOnWarnings=true -->
+        <doclint>all,-missing</doclint>
+    </properties>
+
     <dependencies>
         <dependency>
             <groupId>com.google.guava</groupId>
diff --git a/common/concepts/pom.xml b/common/concepts/pom.xml
index 92baf78997..356d0da433 100644
--- a/common/concepts/pom.xml
+++ b/common/concepts/pom.xml
@@ -21,6 +21,11 @@
     <name>${project.artifactId}</name>
     <description>Common concepts</description>
 
+    <properties>
+        <!-- FIXME: fix these up and set maven.javadoc.failOnWarnings=true -->
+        <doclint>all,-missing</doclint>
+    </properties>
+
     <dependencies>
         <dependency>
             <groupId>com.google.guava</groupId>
diff --git a/common/testutils/pom.xml b/common/testutils/pom.xml
index 98c8258865..ef6d41d4e7 100644
--- a/common/testutils/pom.xml
+++ b/common/testutils/pom.xml
@@ -14,6 +14,11 @@
     <version>13.0.1-SNAPSHOT</version>
     <!-- Currently not needed, maybe later: <packaging>bundle</packaging> -->
 
+    <properties>
+        <!-- FIXME: fix these up and set maven.javadoc.failOnWarnings=true -->
+        <doclint>all,-missing</doclint>
+    </properties>
+
     <dependencyManagement>
         <dependencies>
             <dependency>
diff --git a/common/util/pom.xml b/common/util/pom.xml
index a82701142a..8ca9a5d568 100644
--- a/common/util/pom.xml
+++ b/common/util/pom.xml
@@ -21,6 +21,11 @@
     <name>${project.artifactId}</name>
     <description>Common utilities</description>
 
+    <properties>
+        <!-- FIXME: fix these up and set maven.javadoc.failOnWarnings=true -->
+        <doclint>all,-missing</doclint>
+    </properties>
+
     <dependencies>
         <dependency>
             <groupId>org.opendaylight.yangtools</groupId>
diff --git a/common/yang-common-netty/pom.xml b/common/yang-common-netty/pom.xml
index a67f06815c..a24c7d2274 100644
--- a/common/yang-common-netty/pom.xml
+++ b/common/yang-common-netty/pom.xml
@@ -21,6 +21,10 @@
     <description>Netty utilities for Common YANG definitions</description>
     <url>https://wiki.opendaylight.org/display/ODL/YANG+Tools</url>
 
+    <properties>
+        <maven.javadoc.failOnWarnings>true</maven.javadoc.failOnWarnings>
+    </properties>
+
     <dependencies>
         <dependency>
             <groupId>org.eclipse.jdt</groupId>
diff --git a/common/yang-common/pom.xml b/common/yang-common/pom.xml
index cab315ce28..e6977e2ae5 100644
--- a/common/yang-common/pom.xml
+++ b/common/yang-common/pom.xml
@@ -21,6 +21,11 @@
     <name>${project.artifactId}</name>
     <description>Common YANG definitions</description>
 
+    <properties>
+        <!-- FIXME: fix these up and set maven.javadoc.failOnWarnings=true -->
+        <doclint>all,-missing</doclint>
+    </properties>
+
     <dependencies>
         <dependency>
             <groupId>com.google.guava</groupId>
diff --git a/data/yang-data-api/pom.xml b/data/yang-data-api/pom.xml
index 362c04b143..44344c171f 100644
--- a/data/yang-data-api/pom.xml
+++ b/data/yang-data-api/pom.xml
@@ -21,6 +21,11 @@
     <name>${project.artifactId}</name>
     <description>${project.artifactId}</description>
 
+    <properties>
+        <!-- FIXME: fix these up and set maven.javadoc.failOnWarnings=true -->
+        <doclint>all,-missing</doclint>
+    </properties>
+
     <dependencies>
         <dependency>
             <groupId>com.github.spotbugs</groupId>
diff --git a/data/yang-data-impl/pom.xml b/data/yang-data-impl/pom.xml
index d20a183568..b8ce93d809 100644
--- a/data/yang-data-impl/pom.xml
+++ b/data/yang-data-impl/pom.xml
@@ -18,26 +18,10 @@
     <name>${project.artifactId}</name>
     <description>${project.artifactId}</description>
 
-    <build>
-        <plugins>
-            <plugin>
-                <groupId>org.apache.felix</groupId>
-                <artifactId>maven-bundle-plugin</artifactId>
-                <extensions>true</extensions>
-                <configuration>
-                    <instructions>
-                        <!-- FIXME: do not export data.impl -->
-                        <!-- FIXME: use OSGi annotations when we have R7 -->
-                        <Export-Package>
-                            {local-packages},
-                            org.opendaylight.yangtools.yang.data.impl.*,
-                            ;-split-package:=error
-                        </Export-Package>
-                    </instructions>
-                </configuration>
-            </plugin>
-        </plugins>
-    </build>
+    <properties>
+        <!-- FIXME: fix these up and set maven.javadoc.failOnWarnings=true -->
+        <doclint>all,-missing</doclint>
+    </properties>
 
     <dependencies>
         <dependency>
@@ -102,4 +86,25 @@
             <scope>test</scope>
         </dependency>
     </dependencies>
+
+    <build>
+        <plugins>
+            <plugin>
+                <groupId>org.apache.felix</groupId>
+                <artifactId>maven-bundle-plugin</artifactId>
+                <extensions>true</extensions>
+                <configuration>
+                    <instructions>
+                        <!-- FIXME: do not export data.impl -->
+                        <!-- FIXME: use OSGi annotations when we have R7 -->
+                        <Export-Package>
+                            {local-packages},
+                            org.opendaylight.yangtools.yang.data.impl.*,
+                            ;-split-package:=error
+                        </Export-Package>
+                    </instructions>
+                </configuration>
+            </plugin>
+        </plugins>
+    </build>
 </project>
diff --git a/data/yang-data-spi/pom.xml b/data/yang-data-spi/pom.xml
index 1dd13bb95c..fe2de8cb32 100644
--- a/data/yang-data-spi/pom.xml
+++ b/data/yang-data-spi/pom.xml
@@ -21,6 +21,11 @@
     <name>${project.artifactId}</name>
     <description>${project.artifactId}</description>
 
+    <properties>
+        <!-- FIXME: fix these up and set maven.javadoc.failOnWarnings=true -->
+        <doclint>all,-missing</doclint>
+    </properties>
+
     <dependencies>
         <dependency>
             <groupId>com.github.spotbugs</groupId>
diff --git a/data/yang-data-transform/pom.xml b/data/yang-data-transform/pom.xml
index 5b2c44f999..e81f072864 100644
--- a/data/yang-data-transform/pom.xml
+++ b/data/yang-data-transform/pom.xml
@@ -21,6 +21,11 @@
     <description>${project.artifactId}</description>
     <packaging>bundle</packaging>
 
+    <properties>
+        <!-- FIXME: fix these up and set maven.javadoc.failOnWarnings=true -->
+        <doclint>all,-missing</doclint>
+    </properties>
+
     <dependencies>
         <dependency>
             <groupId>com.google.guava</groupId>
diff --git a/data/yang-data-tree-api/pom.xml b/data/yang-data-tree-api/pom.xml
index 6f60777b88..5264a03c17 100644
--- a/data/yang-data-tree-api/pom.xml
+++ b/data/yang-data-tree-api/pom.xml
@@ -21,6 +21,11 @@
     <name>${project.artifactId}</name>
     <description>${project.artifactId}</description>
 
+    <properties>
+        <!-- FIXME: fix these up and set maven.javadoc.failOnWarnings=true -->
+        <doclint>all,-missing</doclint>
+    </properties>
+
     <dependencies>
         <dependency>
             <groupId>com.github.spotbugs</groupId>
diff --git a/data/yang-data-tree-ri/pom.xml b/data/yang-data-tree-ri/pom.xml
index 8bc1bad75c..02ec38be6f 100644
--- a/data/yang-data-tree-ri/pom.xml
+++ b/data/yang-data-tree-ri/pom.xml
@@ -21,6 +21,11 @@
     <name>${project.artifactId}</name>
     <description>${project.artifactId}</description>
 
+    <properties>
+        <!-- FIXME: fix these up and set maven.javadoc.failOnWarnings=true -->
+        <doclint>all,-missing</doclint>
+    </properties>
+
     <dependencies>
         <dependency>
             <groupId>com.github.spotbugs</groupId>
diff --git a/data/yang-data-tree-spi/pom.xml b/data/yang-data-tree-spi/pom.xml
index ad27971a45..88d99ce90d 100644
--- a/data/yang-data-tree-spi/pom.xml
+++ b/data/yang-data-tree-spi/pom.xml
@@ -21,6 +21,11 @@
     <name>${project.artifactId}</name>
     <description>${project.artifactId}</description>
 
+    <properties>
+        <!-- FIXME: fix these up and set maven.javadoc.failOnWarnings=true -->
+        <doclint>all,-missing</doclint>
+    </properties>
+
     <dependencies>
         <dependency>
             <groupId>com.google.guava</groupId>
diff --git a/data/yang-data-util/pom.xml b/data/yang-data-util/pom.xml
index abc7482564..3b12ba7739 100644
--- a/data/yang-data-util/pom.xml
+++ b/data/yang-data-util/pom.xml
@@ -21,6 +21,11 @@
     <name>${project.artifactId}</name>
     <description>${project.artifactId}</description>
 
+    <properties>
+        <!-- FIXME: fix these up and set maven.javadoc.failOnWarnings=true -->
+        <doclint>all,-missing</doclint>
+    </properties>
+
     <dependencies>
         <dependency>
             <groupId>com.google.guava</groupId>
diff --git a/docs/pom.xml b/docs/pom.xml
index 2492f22461..d6ae966f1e 100644
--- a/docs/pom.xml
+++ b/docs/pom.xml
@@ -21,6 +21,11 @@
     <name>${project.artifactId}</name>
     <description>YANG Tools documentation</description>
 
+    <properties>
+        <!-- FIXME: fix these up and set maven.javadoc.failOnWarnings=true -->
+        <doclint>all,-missing</doclint>
+    </properties>
+
     <dependencies>
         <dependency>
             <groupId>org.opendaylight.yangtools</groupId>
diff --git a/model/odlext-model-api/pom.xml b/model/odlext-model-api/pom.xml
index f81484a8f1..1294cf3c0f 100644
--- a/model/odlext-model-api/pom.xml
+++ b/model/odlext-model-api/pom.xml
@@ -21,6 +21,11 @@
     <name>${project.artifactId}</name>
     <description>OpenDaylight yang-ext metamodel</description>
 
+    <properties>
+        <!-- FIXME: fix these up and set maven.javadoc.failOnWarnings=true -->
+        <doclint>all,-missing</doclint>
+    </properties>
+
     <dependencies>
         <dependency>
             <groupId>com.google.guava</groupId>
diff --git a/model/openconfig-model-api/pom.xml b/model/openconfig-model-api/pom.xml
index 090d3b54dc..107b640a89 100644
--- a/model/openconfig-model-api/pom.xml
+++ b/model/openconfig-model-api/pom.xml
@@ -21,6 +21,11 @@
     <name>${project.artifactId}</name>
     <description>OpenConfig extensions metamodel</description>
 
+    <properties>
+        <!-- FIXME: fix these up and set maven.javadoc.failOnWarnings=true -->
+        <doclint>all,-missing</doclint>
+    </properties>
+
     <dependencies>
         <dependency>
             <groupId>com.github.spotbugs</groupId>
diff --git a/model/rfc6241-model-api/pom.xml b/model/rfc6241-model-api/pom.xml
index fe9f84c2f1..9bcc951c38 100644
--- a/model/rfc6241-model-api/pom.xml
+++ b/model/rfc6241-model-api/pom.xml
@@ -21,6 +21,11 @@
     <name>${project.artifactId}</name>
     <description>RFC6241 extensions for unbound metadata</description>
 
+    <properties>
+        <!-- FIXME: fix these up and set maven.javadoc.failOnWarnings=true -->
+        <doclint>all,-missing</doclint>
+    </properties>
+
     <dependencies>
         <dependency>
             <groupId>org.eclipse.jdt</groupId>
diff --git a/model/rfc6536-model-api/pom.xml b/model/rfc6536-model-api/pom.xml
index 1ecf67b5c9..bde84be123 100644
--- a/model/rfc6536-model-api/pom.xml
+++ b/model/rfc6536-model-api/pom.xml
@@ -21,6 +21,11 @@
     <name>${project.artifactId}</name>
     <description>RFC6536 metamodel</description>
 
+    <properties>
+        <!-- FIXME: fix these up and set maven.javadoc.failOnWarnings=true -->
+        <doclint>all,-missing</doclint>
+    </properties>
+
     <dependencies>
         <dependency>
             <groupId>org.eclipse.jdt</groupId>
diff --git a/model/rfc6643-model-api/pom.xml b/model/rfc6643-model-api/pom.xml
index f1071b22fb..a209b3de77 100644
--- a/model/rfc6643-model-api/pom.xml
+++ b/model/rfc6643-model-api/pom.xml
@@ -21,6 +21,11 @@
     <name>${project.artifactId}</name>
     <description>RFC6643 extensions for SMIv2</description>
 
+    <properties>
+        <!-- FIXME: fix these up and set maven.javadoc.failOnWarnings=true -->
+        <doclint>all,-missing</doclint>
+    </properties>
+
     <dependencies>
         <dependency>
             <groupId>com.google.guava</groupId>
diff --git a/model/rfc7952-model-api/pom.xml b/model/rfc7952-model-api/pom.xml
index a0fcdde569..0e4d3b1e8b 100644
--- a/model/rfc7952-model-api/pom.xml
+++ b/model/rfc7952-model-api/pom.xml
@@ -21,6 +21,11 @@
     <name>${project.artifactId}</name>
     <description>RFC7952 metamodel</description>
 
+    <properties>
+        <!-- FIXME: fix these up and set maven.javadoc.failOnWarnings=true -->
+        <doclint>all,-missing</doclint>
+    </properties>
+
     <dependencies>
         <dependency>
             <groupId>com.google.guava</groupId>
diff --git a/model/rfc8040-model-api/pom.xml b/model/rfc8040-model-api/pom.xml
index 5a5ab830b1..86299c5a3f 100644
--- a/model/rfc8040-model-api/pom.xml
+++ b/model/rfc8040-model-api/pom.xml
@@ -21,6 +21,11 @@
     <name>${project.artifactId}</name>
     <description>RFC8040 model API</description>
 
+    <properties>
+        <!-- FIXME: fix these up and set maven.javadoc.failOnWarnings=true -->
+        <doclint>all,-missing</doclint>
+    </properties>
+
     <dependencies>
         <dependency>
             <groupId>org.eclipse.jdt</groupId>
diff --git a/model/rfc8528-model-api/pom.xml b/model/rfc8528-model-api/pom.xml
index 4e6bfb1ec3..4266908539 100644
--- a/model/rfc8528-model-api/pom.xml
+++ b/model/rfc8528-model-api/pom.xml
@@ -21,6 +21,11 @@
     <name>${project.artifactId}</name>
     <description>RFC8528 model API</description>
 
+    <properties>
+        <!-- FIXME: fix these up and set maven.javadoc.failOnWarnings=true -->
+        <doclint>all,-missing</doclint>
+    </properties>
+
     <dependencies>
         <dependency>
             <groupId>com.google.guava</groupId>
diff --git a/model/rfc8639-model-api/pom.xml b/model/rfc8639-model-api/pom.xml
index 958cf993e0..dafdcc29eb 100644
--- a/model/rfc8639-model-api/pom.xml
+++ b/model/rfc8639-model-api/pom.xml
@@ -21,6 +21,11 @@
     <name>${project.artifactId}</name>
     <description>RFC8639 model API</description>
 
+    <properties>
+        <!-- FIXME: fix these up and set maven.javadoc.failOnWarnings=true -->
+        <doclint>all,-missing</doclint>
+    </properties>
+
     <dependencies>
         <dependency>
             <groupId>org.eclipse.jdt</groupId>
diff --git a/model/rfc8819-model-api/pom.xml b/model/rfc8819-model-api/pom.xml
index 562265eba4..588fd46b0d 100644
--- a/model/rfc8819-model-api/pom.xml
+++ b/model/rfc8819-model-api/pom.xml
@@ -21,6 +21,11 @@
     <name>${project.artifactId}</name>
     <description>RFC8819 model API</description>
 
+    <properties>
+        <!-- FIXME: fix these up and set maven.javadoc.failOnWarnings=true -->
+        <doclint>all,-missing</doclint>
+    </properties>
+
     <dependencies>
         <dependency>
             <groupId>com.google.guava</groupId>
diff --git a/model/yang-model-api/pom.xml b/model/yang-model-api/pom.xml
index b6e88ca360..1388ecc11a 100644
--- a/model/yang-model-api/pom.xml
+++ b/model/yang-model-api/pom.xml
@@ -21,6 +21,11 @@
     <name>${project.artifactId}</name>
     <description>YANG language object model and related interfaces</description>
 
+    <properties>
+        <!-- FIXME: fix these up and set maven.javadoc.failOnWarnings=true -->
+        <doclint>all,-missing</doclint>
+    </properties>
+
     <dependencies>
         <dependency>
             <groupId>com.github.spotbugs</groupId>
diff --git a/model/yang-model-export/pom.xml b/model/yang-model-export/pom.xml
index f7fe7eed56..bf0691cad3 100644
--- a/model/yang-model-export/pom.xml
+++ b/model/yang-model-export/pom.xml
@@ -21,6 +21,11 @@
     <name>${project.artifactId}</name>
     <description>${project.artifactId}</description>
 
+    <properties>
+        <!-- FIXME: fix these up and set maven.javadoc.failOnWarnings=true -->
+        <doclint>all,-missing</doclint>
+    </properties>
+
     <dependencies>
         <dependency>
             <groupId>com.google.guava</groupId>
diff --git a/model/yang-model-ri/pom.xml b/model/yang-model-ri/pom.xml
index f37e131a9a..8203068cf4 100644
--- a/model/yang-model-ri/pom.xml
+++ b/model/yang-model-ri/pom.xml
@@ -21,6 +21,11 @@
     <name>${project.artifactId}</name>
     <description>Reference Implementation of yang.model.api</description>
 
+    <properties>
+        <!-- FIXME: fix these up and set maven.javadoc.failOnWarnings=true -->
+        <doclint>all,-missing</doclint>
+    </properties>
+
     <dependencies>
         <dependency>
             <groupId>com.github.spotbugs</groupId>
diff --git a/model/yang-model-spi/pom.xml b/model/yang-model-spi/pom.xml
index 55d25ed5cc..a697baa01d 100644
--- a/model/yang-model-spi/pom.xml
+++ b/model/yang-model-spi/pom.xml
@@ -21,6 +21,11 @@
     <name>${project.artifactId}</name>
     <description>${project.artifactId}</description>
 
+    <properties>
+        <!-- FIXME: fix these up and set maven.javadoc.failOnWarnings=true -->
+        <doclint>all,-missing</doclint>
+    </properties>
+
     <dependencies>
         <dependency>
             <groupId>com.github.spotbugs</groupId>
diff --git a/model/yang-model-util/pom.xml b/model/yang-model-util/pom.xml
index bec93284ee..d478327186 100644
--- a/model/yang-model-util/pom.xml
+++ b/model/yang-model-util/pom.xml
@@ -21,6 +21,11 @@
     <name>${project.artifactId}</name>
     <description>${project.artifactId}</description>
 
+    <properties>
+        <!-- FIXME: fix these up and set maven.javadoc.failOnWarnings=true -->
+        <doclint>all,-missing</doclint>
+    </properties>
+
     <dependencies>
         <dependency>
             <groupId>com.google.guava</groupId>
diff --git a/parser/odlext-parser-support/pom.xml b/parser/odlext-parser-support/pom.xml
index 7879c019b5..1a28ea9575 100644
--- a/parser/odlext-parser-support/pom.xml
+++ b/parser/odlext-parser-support/pom.xml
@@ -21,6 +21,11 @@
     <name>${project.artifactId}</name>
     <description>OpenDaylight yang-ext parser support</description>
 
+    <properties>
+        <!-- FIXME: fix these up and set maven.javadoc.failOnWarnings=true -->
+        <doclint>all,-missing</doclint>
+    </properties>
+
     <dependencies>
         <dependency>
             <groupId>com.google.guava</groupId>
diff --git a/parser/openconfig-parser-support/pom.xml b/parser/openconfig-parser-support/pom.xml
index 28db4a9be9..19ac8c55b4 100644
--- a/parser/openconfig-parser-support/pom.xml
+++ b/parser/openconfig-parser-support/pom.xml
@@ -21,6 +21,11 @@
     <name>${project.artifactId}</name>
     <description>OpenConfig extensions parser support</description>
 
+    <properties>
+        <!-- FIXME: fix these up and set maven.javadoc.failOnWarnings=true -->
+        <doclint>all,-missing</doclint>
+    </properties>
+
     <dependencies>
         <dependency>
             <groupId>com.google.guava</groupId>
diff --git a/parser/rfc6241-parser-support/pom.xml b/parser/rfc6241-parser-support/pom.xml
index 123489f736..ac69f66ecf 100644
--- a/parser/rfc6241-parser-support/pom.xml
+++ b/parser/rfc6241-parser-support/pom.xml
@@ -21,6 +21,11 @@
     <name>${project.artifactId}</name>
     <description>RFC6241 parser support</description>
 
+    <properties>
+        <!-- FIXME: fix these up and set maven.javadoc.failOnWarnings=true -->
+        <doclint>all,-missing</doclint>
+    </properties>
+
     <dependencies>
         <dependency>
             <groupId>com.google.guava</groupId>
diff --git a/parser/rfc6536-parser-support/pom.xml b/parser/rfc6536-parser-support/pom.xml
index 1cabd8e2c6..83e1ad1ba3 100644
--- a/parser/rfc6536-parser-support/pom.xml
+++ b/parser/rfc6536-parser-support/pom.xml
@@ -21,6 +21,11 @@
     <name>${project.artifactId}</name>
     <description>RFC6536 parser support</description>
 
+    <properties>
+        <!-- FIXME: fix these up and set maven.javadoc.failOnWarnings=true -->
+        <doclint>all,-missing</doclint>
+    </properties>
+
     <dependencies>
         <dependency>
             <groupId>com.google.guava</groupId>
diff --git a/parser/rfc6643-parser-support/pom.xml b/parser/rfc6643-parser-support/pom.xml
index 0d1c8e251b..93078b7109 100644
--- a/parser/rfc6643-parser-support/pom.xml
+++ b/parser/rfc6643-parser-support/pom.xml
@@ -21,6 +21,11 @@
     <name>${project.artifactId}</name>
     <description>RFC6643 parser support</description>
 
+    <properties>
+        <!-- FIXME: fix these up and set maven.javadoc.failOnWarnings=true -->
+        <doclint>all,-missing</doclint>
+    </properties>
+
     <dependencies>
         <dependency>
             <groupId>com.google.guava</groupId>
diff --git a/parser/rfc7952-parser-support/pom.xml b/parser/rfc7952-parser-support/pom.xml
index 9f2c149e45..f86e9cd9ec 100644
--- a/parser/rfc7952-parser-support/pom.xml
+++ b/parser/rfc7952-parser-support/pom.xml
@@ -21,6 +21,11 @@
     <name>${project.artifactId}</name>
     <description>RFC7952 parser support</description>
 
+    <properties>
+        <!-- FIXME: fix these up and set maven.javadoc.failOnWarnings=true -->
+        <doclint>all,-missing</doclint>
+    </properties>
+
     <dependencies>
         <dependency>
             <groupId>com.google.guava</groupId>
diff --git a/parser/rfc8040-parser-support/pom.xml b/parser/rfc8040-parser-support/pom.xml
index e9be31eb36..1d2c3954cf 100644
--- a/parser/rfc8040-parser-support/pom.xml
+++ b/parser/rfc8040-parser-support/pom.xml
@@ -21,6 +21,11 @@
     <name>${project.artifactId}</name>
     <description>RFC8040 parser support</description>
 
+    <properties>
+        <!-- FIXME: fix these up and set maven.javadoc.failOnWarnings=true -->
+        <doclint>all,-missing</doclint>
+    </properties>
+
     <dependencies>
         <dependency>
             <groupId>com.google.guava</groupId>
diff --git a/parser/rfc8528-parser-support/pom.xml b/parser/rfc8528-parser-support/pom.xml
index c9cda22f09..425e7655ca 100644
--- a/parser/rfc8528-parser-support/pom.xml
+++ b/parser/rfc8528-parser-support/pom.xml
@@ -21,6 +21,11 @@
     <name>${project.artifactId}</name>
     <description>RFC8528 parser support</description>
 
+    <properties>
+        <!-- FIXME: fix these up and set maven.javadoc.failOnWarnings=true -->
+        <doclint>all,-missing</doclint>
+    </properties>
+
     <dependencies>
         <dependency>
             <groupId>com.google.guava</groupId>
diff --git a/parser/rfc8639-parser-support/pom.xml b/parser/rfc8639-parser-support/pom.xml
index 530205d58b..5b68981394 100644
--- a/parser/rfc8639-parser-support/pom.xml
+++ b/parser/rfc8639-parser-support/pom.xml
@@ -21,6 +21,11 @@
     <name>${project.artifactId}</name>
     <description>RFC8639 parser support</description>
 
+    <properties>
+        <!-- FIXME: fix these up and set maven.javadoc.failOnWarnings=true -->
+        <doclint>all,-missing</doclint>
+    </properties>
+
     <dependencies>
         <dependency>
             <groupId>com.google.guava</groupId>
diff --git a/parser/rfc8819-parser-support/pom.xml b/parser/rfc8819-parser-support/pom.xml
index 7edf77ee4a..600b8c6732 100644
--- a/parser/rfc8819-parser-support/pom.xml
+++ b/parser/rfc8819-parser-support/pom.xml
@@ -21,6 +21,11 @@
     <name>${project.artifactId}</name>
     <description>RFC8819 parser support</description>
 
+    <properties>
+        <!-- FIXME: fix these up and set maven.javadoc.failOnWarnings=true -->
+        <doclint>all,-missing</doclint>
+    </properties>
+
     <dependencies>
         <dependency>
             <groupId>com.google.guava</groupId>
diff --git a/parser/yang-ir/pom.xml b/parser/yang-ir/pom.xml
index cb50f3c210..35b1594f41 100644
--- a/parser/yang-ir/pom.xml
+++ b/parser/yang-ir/pom.xml
@@ -21,6 +21,11 @@
     <name>${project.artifactId}</name>
     <description>Intermediate YANG parsing representation</description>
 
+    <properties>
+        <!-- FIXME: fix these up and set maven.javadoc.failOnWarnings=true -->
+        <doclint>all,-missing</doclint>
+    </properties>
+
     <dependencies>
         <dependency>
             <groupId>com.google.guava</groupId>
diff --git a/parser/yang-parser-api/pom.xml b/parser/yang-parser-api/pom.xml
index c85ee98fa1..e36c4563f0 100644
--- a/parser/yang-parser-api/pom.xml
+++ b/parser/yang-parser-api/pom.xml
@@ -21,6 +21,11 @@
     <name>${project.artifactId}</name>
     <description>YANG parser API</description>
 
+    <properties>
+        <!-- FIXME: fix these up and set maven.javadoc.failOnWarnings=true -->
+        <doclint>all,-missing</doclint>
+    </properties>
+
     <dependencies>
         <dependency>
             <groupId>com.google.guava</groupId>
diff --git a/parser/yang-parser-impl/pom.xml b/parser/yang-parser-impl/pom.xml
index b14a21a6c8..ea33bcbb1b 100644
--- a/parser/yang-parser-impl/pom.xml
+++ b/parser/yang-parser-impl/pom.xml
@@ -21,6 +21,11 @@
     <name>${project.artifactId}</name>
     <description>YANG parser</description>
 
+    <properties>
+        <!-- FIXME: fix these up and set maven.javadoc.failOnWarnings=true -->
+        <doclint>all,-missing</doclint>
+    </properties>
+
     <dependencies>
         <dependency>
             <groupId>com.github.spotbugs</groupId>
diff --git a/parser/yang-parser-reactor/pom.xml b/parser/yang-parser-reactor/pom.xml
index c6ae46c201..3f67227bf3 100644
--- a/parser/yang-parser-reactor/pom.xml
+++ b/parser/yang-parser-reactor/pom.xml
@@ -21,6 +21,11 @@
     <name>${project.artifactId}</name>
     <description>YANG parser</description>
 
+    <properties>
+        <!-- FIXME: fix these up and set maven.javadoc.failOnWarnings=true -->
+        <doclint>all,-missing</doclint>
+    </properties>
+
     <dependencies>
         <dependency>
             <groupId>com.google.guava</groupId>
diff --git a/parser/yang-parser-rfc7950/pom.xml b/parser/yang-parser-rfc7950/pom.xml
index 35a8d9dc8c..b5d614e55a 100644
--- a/parser/yang-parser-rfc7950/pom.xml
+++ b/parser/yang-parser-rfc7950/pom.xml
@@ -21,6 +21,11 @@
     <name>${project.artifactId}</name>
     <description>RFC6020/RFC7950 parser support</description>
 
+    <properties>
+        <!-- FIXME: fix these up and set maven.javadoc.failOnWarnings=true -->
+        <doclint>all,-missing</doclint>
+    </properties>
+
     <dependencies>
         <dependency>
             <groupId>com.github.spotbugs</groupId>
diff --git a/parser/yang-parser-spi/pom.xml b/parser/yang-parser-spi/pom.xml
index 42640e35c3..88f47aa14f 100644
--- a/parser/yang-parser-spi/pom.xml
+++ b/parser/yang-parser-spi/pom.xml
@@ -21,6 +21,11 @@
     <name>${project.artifactId}</name>
     <description>YANG parser SPI</description>
 
+    <properties>
+        <!-- FIXME: fix these up and set maven.javadoc.failOnWarnings=true -->
+        <doclint>all,-missing</doclint>
+    </properties>
+
     <dependencies>
         <dependency>
             <groupId>com.github.spotbugs</groupId>
diff --git a/parser/yang-test-util/pom.xml b/parser/yang-test-util/pom.xml
index ea0f9f78a0..6baad97544 100644
--- a/parser/yang-test-util/pom.xml
+++ b/parser/yang-test-util/pom.xml
@@ -21,6 +21,11 @@
     <name>${project.artifactId}</name>
     <description>${project.artifactId}</description>
 
+    <properties>
+        <!-- FIXME: fix these up and set maven.javadoc.failOnWarnings=true -->
+        <doclint>all,-missing</doclint>
+    </properties>
+
     <dependencies>
         <dependency>
             <groupId>com.github.spotbugs</groupId>
diff --git a/plugin/plugin-generator-api/pom.xml b/plugin/plugin-generator-api/pom.xml
index c440a6d53f..d1a5e75956 100644
--- a/plugin/plugin-generator-api/pom.xml
+++ b/plugin/plugin-generator-api/pom.xml
@@ -21,6 +21,11 @@
     <name>${project.artifactId}</name>
     <description>YANG Generator Plugin API</description>
 
+    <properties>
+        <!-- FIXME: fix these up and set maven.javadoc.failOnWarnings=true -->
+        <doclint>all,-missing</doclint>
+    </properties>
+
     <dependencies>
         <dependency>
             <groupId>com.google.guava</groupId>
diff --git a/plugin/yang-maven-plugin/pom.xml b/plugin/yang-maven-plugin/pom.xml
index 18b94a2521..2887298c77 100644
--- a/plugin/yang-maven-plugin/pom.xml
+++ b/plugin/yang-maven-plugin/pom.xml
@@ -34,6 +34,11 @@
         <maven>3.8.3</maven>
     </prerequisites>
 
+    <properties>
+        <!-- FIXME: fix these up and set maven.javadoc.failOnWarnings=true -->
+        <doclint>all,-missing</doclint>
+    </properties>
+
     <dependencyManagement>
         <dependencies>
             <dependency>
diff --git a/tools/yang-model-validator/pom.xml b/tools/yang-model-validator/pom.xml
index 9f8f1fde62..f9ee8c0f54 100644
--- a/tools/yang-model-validator/pom.xml
+++ b/tools/yang-model-validator/pom.xml
@@ -14,6 +14,11 @@
     <name>${project.artifactId}</name>
     <description>YANG model validator</description>
 
+    <properties>
+        <!-- FIXME: fix these up and set maven.javadoc.failOnWarnings=true -->
+        <doclint>all,-missing</doclint>
+    </properties>
+
     <dependencyManagement>
         <dependencies>
             <dependency>
diff --git a/tools/yang-validation-tool/pom.xml b/tools/yang-validation-tool/pom.xml
index 324452ebe6..0b5e6f59db 100644
--- a/tools/yang-validation-tool/pom.xml
+++ b/tools/yang-validation-tool/pom.xml
@@ -20,6 +20,11 @@
     <artifactId>yang-validation-tool</artifactId>
     <version>13.0.1-SNAPSHOT</version>
 
+    <properties>
+        <!-- FIXME: fix these up and set maven.javadoc.failOnWarnings=true -->
+        <doclint>all,-missing</doclint>
+    </properties>
+
     <dependencyManagement>
         <dependencies>
             <dependency>
diff --git a/xpath/yang-xpath-api/pom.xml b/xpath/yang-xpath-api/pom.xml
index b652daa101..0ab5071f8b 100644
--- a/xpath/yang-xpath-api/pom.xml
+++ b/xpath/yang-xpath-api/pom.xml
@@ -22,6 +22,11 @@
     <name>${project.artifactId}</name>
     <description>YANG XPath ${project.artifactId}</description>
 
+    <properties>
+        <!-- FIXME: fix these up and set maven.javadoc.failOnWarnings=true -->
+        <doclint>all,-missing</doclint>
+    </properties>
+
     <dependencies>
         <dependency>
             <groupId>com.github.spotbugs</groupId>
diff --git a/xpath/yang-xpath-impl/pom.xml b/xpath/yang-xpath-impl/pom.xml
index 5a76ec3cbb..fa73acac0d 100644
--- a/xpath/yang-xpath-impl/pom.xml
+++ b/xpath/yang-xpath-impl/pom.xml
@@ -21,6 +21,11 @@
     <name>${project.artifactId}</name>
     <description>YANG XPath parser</description>
 
+    <properties>
+        <!-- FIXME: fix these up and set maven.javadoc.failOnWarnings=true -->
+        <doclint>all,-missing</doclint>
+    </properties>
+
     <dependencies>
         <dependency>
             <groupId>com.google.guava</groupId>
diff --git a/yang/yang-repo-api/pom.xml b/yang/yang-repo-api/pom.xml
index e14eac4b3d..b548d0f1b0 100644
--- a/yang/yang-repo-api/pom.xml
+++ b/yang/yang-repo-api/pom.xml
@@ -21,6 +21,11 @@
     <name>${project.artifactId}</name>
     <description>YANG Schema Repository API</description>
 
+    <properties>
+        <!-- FIXME: fix these up and set maven.javadoc.failOnWarnings=true -->
+        <doclint>all,-missing</doclint>
+    </properties>
+
     <dependencies>
         <dependency>
             <groupId>com.google.guava</groupId>
diff --git a/yang/yang-repo-fs/pom.xml b/yang/yang-repo-fs/pom.xml
index a429d829e6..41cbc47b70 100644
--- a/yang/yang-repo-fs/pom.xml
+++ b/yang/yang-repo-fs/pom.xml
@@ -21,6 +21,11 @@
     <name>${project.artifactId}</name>
     <description>${project.artifactId}</description>
 
+    <properties>
+        <!-- FIXME: fix these up and set maven.javadoc.failOnWarnings=true -->
+        <doclint>all,-missing</doclint>
+    </properties>
+
     <dependencies>
         <dependency>
             <groupId>com.google.guava</groupId>
diff --git a/yang/yang-repo-spi/pom.xml b/yang/yang-repo-spi/pom.xml
index b2edc4a2a7..ee11dd800c 100644
--- a/yang/yang-repo-spi/pom.xml
+++ b/yang/yang-repo-spi/pom.xml
@@ -21,6 +21,11 @@
     <name>${project.artifactId}</name>
     <description>YANG Schema Repository SPI</description>
 
+    <properties>
+        <!-- FIXME: fix these up and set maven.javadoc.failOnWarnings=true -->
+        <doclint>all,-missing</doclint>
+    </properties>
+
     <dependencies>
         <dependency>
             <groupId>com.google.guava</groupId>
-- 
2.36.6