Disable missing javadoc warnings in docs/

jdk17's javadoc is more strict, hence we need to disable warnings about
missing javadocs for now.

Change-Id: I03270cea43f4a49ce697b917caaeb70559be75d3
Signed-off-by: Robert Varga <robert.varga@pantheon.tech>

diff --git a/bundles-test-lib/src/main/java/org/opendaylight/odlparent/bundlestest/lib/package-info.java b/bundles-test-lib/src/main/java/org/opendaylight/odlparent/bundlestest/lib/package-info.java
index 0f703d15a81cfb0fb80d42f39ec42936cd64916e..6f56702ffc9e86ec266a1bd9b414dadb4df91fd5 100644 (file)
--- a/bundles-test-lib/src/main/java/org/opendaylight/odlparent/bundlestest/lib/package-info.java
+++ b/bundles-test-lib/src/main/java/org/opendaylight/odlparent/bundlestest/lib/package-info.java
@@ -5,6 +5,9 @@
  * terms of the Eclipse Public License v1.0 which accompanies this distribution,
  * and is available at http://www.eclipse.org/legal/epl-v10.html
  */
+/**
+ * Library of various utilies for check bundle state.
+ */
 @org.eclipse.jdt.annotation.NonNullByDefault
 @org.osgi.annotation.bundle.Export
 package org.opendaylight.odlparent.bundlestest.lib;

diff --git a/docs/pom.xml b/docs/pom.xml
index a1b465362d2903880f1580350bbe409169b6fac7..80eedca657a835f945332507b9ee0a6c31c677da 100644 (file)
--- a/docs/pom.xml
+++ b/docs/pom.xml
@@ -217,8 +217,9 @@
                         </goals>
                     </execution>
                 </executions>
-                <!-- FIXME: remove this section once we can activate javadoc-links profile -->
+
                 <configuration combine.children="append">
+                    <!-- FIXME: remove this section once we can activate javadoc-links profile -->
                     <links>
                         <link>https://junit.org/junit4/javadoc/4.13/</link>
                         <link>http://hamcrest.org/JavaHamcrest/javadoc/2.2/</link>
@@ -229,6 +230,9 @@
                         <link>https://commons.apache.org/proper/commons-lang/javadocs/api-3.11/</link>
                         <link>https://commons.apache.org/proper/commons-codec/apidocs/</link>
                     </links>
+
+                    <!-- FIXME: finish up -->
+                    <doclint>all,-missing</doclint>
                     <groups>
                         <group>
                             <title>Bundle Test Library</title>

diff --git a/karaf-plugin/src/main/java/org/opendaylight/odlparent/AetherUtil.java b/karaf-plugin/src/main/java/org/opendaylight/odlparent/AetherUtil.java
index bba2ef550b64cf778cb6c5f25edebe7f1583cb3f..a4682c4587ca2da9290b64d514d3bc337ca6cd96 100644 (file)
--- a/karaf-plugin/src/main/java/org/opendaylight/odlparent/AetherUtil.java
+++ b/karaf-plugin/src/main/java/org/opendaylight/odlparent/AetherUtil.java
@@ -5,7 +5,6 @@
  * terms of the Eclipse Public License v1.0 which accompanies this distribution,
  * and is available at http://www.eclipse.org/legal/epl-v10.html
  */
-
 package org.opendaylight.odlparent;
 
 import java.io.File;
@@ -35,6 +34,9 @@ import org.eclipse.aether.resolution.DependencyResult;
 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
 
+/**
+ * Utilities for resolving maven artifacts and their dependencies.
+ */
 public class AetherUtil {
     private static final Logger LOG = LoggerFactory.getLogger(AetherUtil.class);
     private RepositorySystem repoSystem;
@@ -43,6 +45,9 @@ public class AetherUtil {
 
     private List<RemoteRepository> remoteRepos;
 
+    /**
+     * Local repository path.
+     */
     protected File localRepository;
 
     /**