Enable strict Javadoc doclint (all,-missing) and fix all doclint issues (#197)

Author: vharseko

custom-scripted-connector-bundler/src/main/java/org/forgerock/openidm/tools/scriptedbundler/CustomObjectType.java

@@ -2,6 +2,7 @@
  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.
  *
  * Copyright (c) 2015 ForgeRock AS. All Rights Reserved
+ * Portions Copyrighted 2026 3A Systems, LLC.
  *
  * The contents of this file are subject to the terms
  * of the Common Development and Distribution License
@@ -32,7 +33,7 @@
  * A single connector configuration objectType, contained in {@link CustomConfiguration}.
  *
  * Given a JSON configuration such as:
- * <pre><blockquote>
+ * <pre>
  *      "objectTypes" : [
  *          {
  *              "name" : "group",
@@ -66,7 +67,7 @@
  *              ]
  *          }
  *      ]
- * </blockquote></pre>
+ * </pre>
  * this object represents a single objectType array element.
  */
 public class CustomObjectType extends CustomBaseObject {

custom-scripted-connector-bundler/src/main/java/org/forgerock/openidm/tools/scriptedbundler/CustomObjectTypeProperty.java

@@ -2,6 +2,7 @@
  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.
  *
  * Copyright (c) 2015 ForgeRock AS. All Rights Reserved
+ * Portions Copyrighted 2026 3A Systems, LLC.
  *
  * The contents of this file are subject to the terms
  * of the Common Development and Distribution License
@@ -32,7 +33,7 @@
  * A single connector objectType property, contained in {@link CustomObjectType}.
  *
  * Given a JSON configuration such as:
- * <pre><blockquote>
+ * <pre>
  *      "properties" : [
  *          {
  *              "name" : "name",
@@ -57,7 +58,7 @@
  *              ...
  *          }
  *      ]
- * </blockquote></pre>
+ * </pre>
  * this object represents a single properties array element.
  */
 public class CustomObjectTypeProperty extends CustomBaseObject {

custom-scripted-connector-bundler/src/main/java/org/forgerock/openidm/tools/scriptedbundler/CustomObjectTypePropertyFlag.java

@@ -2,6 +2,7 @@
  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.
  *
  * Copyright (c) 2015 ForgeRock AS. All Rights Reserved
+ * Portions Copyrighted 2026 3A Systems, LLC.
  *
  * The contents of this file are subject to the terms
  * of the Common Development and Distribution License
@@ -31,12 +32,12 @@
  * A single objectType property flag, contained in {@link CustomObjectTypeProperty}.
  *
  * Represented in a JSON configuration list as:
- * <pre><blockquote>
+ * <pre>
  *      "flags" : [
  *          "NOT_READABLE",
  *          "NOT_RETURNED_BY_DEFAULT"
  *      ],
- * </blockquote></pre>
+ * </pre>
  */
 public class CustomObjectTypePropertyFlag extends CustomBaseObject {
     /**

custom-scripted-connector-bundler/src/main/java/org/forgerock/openidm/tools/scriptedbundler/CustomObjectTypePropertyItemProperty.java

@@ -2,6 +2,7 @@
  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.
  *
  * Copyright (c) 2015 ForgeRock AS. All Rights Reserved
+ * Portions Copyrighted 2026 3A Systems, LLC.
  *
  * The contents of this file are subject to the terms
  * of the Common Development and Distribution License
@@ -31,12 +32,12 @@
  * A single property of an objectType item, contained in {@link CustomObjectTypePropertyItems}.
  *
  * Represented in JSON as:
- * <pre><blockquote>
+ * <pre>
  *      {
  *          "name" : "uid",
  *          "type" : "string"
  *      }
- * </blockquote></pre>
+ * </pre>
  */
 public class CustomObjectTypePropertyItemProperty extends CustomBaseObject {
     /**

custom-scripted-connector-bundler/src/main/java/org/forgerock/openidm/tools/scriptedbundler/CustomObjectTypePropertyItems.java

@@ -2,6 +2,7 @@
  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.
  *
  * Copyright (c) 2015 ForgeRock AS. All Rights Reserved
+ * Portions Copyrighted 2026 3A Systems, LLC.
  *
  * The contents of this file are subject to the terms
  * of the Common Development and Distribution License
@@ -33,7 +34,7 @@
  * A single connector configuration objectType, contained in {@link CustomObjectTypeProperty}.
  *
  * Represented in a JSON configuration as:
- * <pre><blockquote>
+ * <pre>
  *      {
  *          "type" : "object",
  *          "nativeType" : "object",
@@ -42,7 +43,7 @@
  *              "type" : "string"
  *          }]
  *      }
- * </blockquote></pre>
+ * </pre>
  */
 public class CustomObjectTypePropertyItems extends CustomBaseObject {
 

custom-scripted-connector-bundler/src/main/java/org/forgerock/openidm/tools/scriptedbundler/CustomProperty.java

@@ -2,6 +2,7 @@
  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.
  *
  * Copyright (c) 2015 ForgeRock AS. All Rights Reserved
+ * Portions Copyrighted 2026 3A Systems, LLC.
  *
  * The contents of this file are subject to the terms
  * of the Common Development and Distribution License
@@ -34,7 +35,7 @@
  * A single connector configuration property, contained in {@link CustomConfiguration}.
  *
  * The JSON configuration might contain something like the following:
- * <pre><blockquote>
+ * <pre>
  * "properties" : [
  *      {
  *          "order" : 0,
@@ -58,7 +59,7 @@
  *          "group" : "default"
  *      }
  *  ]
- * </blockquote></pre>
+ * </pre>
  *
  * This object represents a single property in the list above.  These properties define the connector's
  * configuration properties and are the data source for generating the code to support connector metadata

custom-scripted-connector-bundler/src/main/java/org/forgerock/openidm/tools/scriptedbundler/ProvidedProperty.java

@@ -2,6 +2,7 @@
  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.
  *
  * Copyright (c) 2015 ForgeRock AS. All Rights Reserved
+ * Portions Copyrighted 2026 3A Systems, LLC.
  *
  * The contents of this file are subject to the terms
  * of the Common Development and Distribution License
@@ -34,7 +35,7 @@
  * A single connector configuration property, contained in {@link org.forgerock.openidm.tools.scriptedbundler.CustomConfiguration}.
  *
  * The JSON configuration might contain something like the following:
- * <pre><blockquote>
+ * <pre>
  * "providedProperties" : [
  *      {
  *          "name" : "FirstProperty",
@@ -46,7 +47,7 @@
  *          "type" : "Float"
  *      }
  *  ]
- * </blockquote></pre>
+ * </pre>
  *
  * This object represents a single property in the list above.  These properties populate values for the properties
  * defined by default in the connector's base configuration class.  For example, the ScriptedSQLConfiguration class

openidm-audit/src/main/java/org/forgerock/openidm/audit/impl/AuditLogger.java

@@ -2,6 +2,7 @@
  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.
  *
  * Copyright 2011-2015 ForgeRock AS.
+ * Portions Copyrighted 2026 3A Systems, LLC.
  *
  * The contents of this file are subject to the terms
  * of the Common Development and Distribution License
@@ -109,7 +110,6 @@ public interface AuditLogger {
      * @param handler the {@link QueryResourceHandler} object.
      * @param type the type of audit log entries to query
      * @param formatted whether to format the results.
-     * @return the query result object.
      * @throws NotFoundException if the specified object could not be found.
      * @throws ForbiddenException if access to the object or the specified query is forbidden.
      */

openidm-authnfilter/src/main/java/org/forgerock/openidm/auth/modules/oauth/OAuthModule.java

@@ -12,6 +12,7 @@
  * information: "Portions copyright [year] [name of copyright owner]".
  *
  * Copyright 2016 ForgeRock AS.
+ * Portions Copyrighted 2026 3A Systems, LLC.
  */
 package org.forgerock.openidm.auth.modules.oauth;
 
@@ -190,7 +191,6 @@ public Promise<AuthStatus, AuthenticationException> validateRequest(MessageInfoC
      * @param messageInfo {@inheritDoc}
      * @param subject {@inheritDoc}
      * @return {@inheritDoc}
-     * @throws AuthException {@inheritDoc}
      */
     @Override
     public Promise<AuthStatus, AuthenticationException> secureResponse(MessageInfoContext messageInfo,
@@ -203,7 +203,6 @@ public Promise<AuthStatus, AuthenticationException> secureResponse(MessageInfoCo
      *
      * @param messageInfo {@inheritDoc}
      * @param subject {@inheritDoc}
-     * @throws AuthException {@inheritDoc}
      */
     @Override
     public Promise<Void, AuthenticationException> cleanSubject(MessageInfoContext messageInfo, Subject subject) {

openidm-config/src/main/java/org/forgerock/openidm/config/manage/ConfigObjectService.java

@@ -12,7 +12,7 @@
  * information: "Portions copyright [year] [name of copyright owner]".
  *
  * Copyright 2011-2016 ForgeRock AS.
- * Portions Copyrighted 2024 3A Systems LLC.
+ * Portions Copyrighted 2024-2026 3A Systems LLC.
  */
 
 
@@ -313,7 +313,7 @@ public Promise<ResourceResponse, ResourceException> apply(
 
     /**
      * Creates a new object in the object set.
-     * <p/>
+     * <p>
      * This method sets the {@code _id} property to the assigned identifier for the object,
      * and the {@code _rev} property to the revised object version (For optimistic concurrency)
      *