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

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)
      *

openidm-config/src/main/java/org/forgerock/openidm/config/persistence/ConfigPersisterMarker.java

@@ -2,6 +2,7 @@
  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.
  *
  * Copyright 2011-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
@@ -37,7 +38,7 @@ public interface ConfigPersisterMarker {
      * Notifies the extension when the system determined that 
      * all necessary services are ready, and checks if the 
      * extension itself is ready
-     * @throws an exception if the extension could not initiate
+     * @throws BootstrapFailure if the extension could not initiate
      */
     void checkReady() throws BootstrapFailure;
 }

openidm-core/src/main/java/org/forgerock/openidm/internal/metadata/ConfigMeta.java

@@ -12,6 +12,7 @@
  * information: "Portions copyright [year] [name of copyright owner]".
  *
  * Portions copyright 2011-2015 ForgeRock AS.
+ * Portions Copyrighted 2026 3A Systems, LLC.
  */
 package org.forgerock.openidm.internal.metadata;
 
@@ -46,9 +47,6 @@ public class ConfigMeta implements MetaDataProvider {
      * JsonPointer("/")); properties = Collections.unmodifiableList(p); }
      */
 
-    /**
-     * @inheritDoc
-     */
     public List<JsonPointer> getPropertiesToEncrypt(String pidOrFactory, String instanceAlias,
             JsonValue config) throws WaitForMetaData, NotConfiguration {
         if (ManagedObjectService.PID.equalsIgnoreCase(pidOrFactory)) {
@@ -58,9 +56,6 @@ public List<JsonPointer> getPropertiesToEncrypt(String pidOrFactory, String inst
         return null;
     }
 
-    /**
-     * @inheritDoc
-     */
 //    @Override
     public void setCallback(MetaDataProviderCallback callback) {
         // This instance won't be updated

openidm-core/src/main/java/org/forgerock/openidm/managed/RelationshipProvider.java

@@ -12,6 +12,7 @@
  * information: "Portions copyright [year] [name of copyright owner]".
  *
  * Copyright 2015-2016 ForgeRock AS.
+ * Portions Copyrighted 2026 3A Systems, LLC.
  */
 package org.forgerock.openidm.managed;
 
@@ -165,7 +166,7 @@ public ResourceResponse apply(ResourceResponse resourceResponse) throws Resource
      * Returns a Function to format a resource from the repository to that expected by the provider consumer. First
      * object properties are removed and {@code secondId} (or {@code firstId} if it's a reverse relationship)
      * will be converted to {@code _ref}
-     * <p/>
+     * <p>
      * This will convert repo resources in the format of:
      * <pre>
      *     {
@@ -177,7 +178,7 @@ public ResourceResponse apply(ResourceResponse resourceResponse) throws Resource
      *         "properties": { ... }
      *     }
      * </pre>
-     * <p/>
+     * <p>
      * To a provider response format of:
      *
      * <pre>

openidm-core/src/main/java/org/forgerock/openidm/sync/PendingActionContext.java

@@ -12,6 +12,7 @@
  * information: "Portions copyright [year] [name of copyright owner]".
  *
  * Portions copyright 2014-2015 ForgeRock AS.
+ * Portions Copyrighted 2026 3A Systems, LLC.
  */
 package org.forgerock.openidm.sync;
 
@@ -78,8 +79,6 @@ public boolean isPending() {
 
     /**
      * Clears pending link data, sets pending to false.
-     *
-     * @return this object's name
      */
     public void clear() {
         data.remove(ATTR_ACTION_DATA);

openidm-core/src/main/java/org/forgerock/openidm/sync/ReconContext.java

@@ -12,6 +12,7 @@
  * information: "Portions copyright [year] [name of copyright owner]".
  *
  * Copyright 2015 ForgeRock AS.
+ * Portions Copyrighted 2026 3A Systems, LLC.
  */
 
 package org.forgerock.openidm.sync;
@@ -37,7 +38,7 @@ public class ReconContext extends AbstractContext {
      * Create a new recon context from an existing (parent) context.
      *
      * @param parent the parent server context
-     * @param trigger the trigger source
+     * @param mapping the name of the mapping associated with the reconciliation
      */
     public ReconContext(final Context parent, String mapping) {
         super(checkNotNull(parent, "Cannot instantiate ReconContext with null parent Context"), CONTEXT_NAME);

openidm-core/src/main/java/org/forgerock/openidm/sync/impl/ReconTypeBase.java

@@ -12,6 +12,7 @@
  * information: "Portions copyright [year] [name of copyright owner]".
  *
  * Portions copyright 2014-2015 ForgeRock AS.
+ * Portions Copyrighted 2026 3A Systems, LLC.
  */
 package org.forgerock.openidm.sync.impl;
 
@@ -85,7 +86,7 @@ public enum QuerySide {SOURCE, TARGET};
     /**
      * A constructor.
      * 
-     * @param reconContext a {@link RconciliationContext} object.
+     * @param reconContext a {@link ReconciliationContext} object.
      * @param defaultRunTargetPhase a boolean indicating if target phase should be run.
      */
     public ReconTypeBase(ReconciliationContext reconContext, boolean defaultRunTargetPhase) {
@@ -203,7 +204,7 @@ protected boolean specifiesQuery(JsonValue queryCfg) {
      * sensitive fashion, or if false it populates as lower case only
      * @param pageSize the page size if paging
      * @param pagingCookie the cookie to use if paging, null if first page
-     * @param reconContext the {@link RconciliationContext} object associated with this recon
+     * @param reconContext the {@link ReconciliationContext} object associated with this recon
      * @param querySide an indicator for which side of a reconciliation (source or target) a query is for
      * @return a {@link ReconQueryResult} containing the collection of (unqualified) ids
      * @throws SynchronizationException if retrieving or processing the ids failed
@@ -309,21 +310,12 @@ private boolean hasFullEntry(JsonValue entry, QuerySide querySide) {
         }
     }
 
-    /**
-     * @inheritDoc
-     */
     @Override
     public abstract ReconQueryResult querySource(int pageSize, String pagingCookie) throws SynchronizationException;
 
-    /**
-     * @inheritDoc
-     */
     @Override
     public abstract ResultIterable queryTarget() throws SynchronizationException;
 
-    /**
-     * @inheritDoc
-     */
     @Override
     public abstract JsonValue getReconParameters();
 }