Enable Javadoc doclint (all,-missing) and fail on warnings

.gitattributes

@@ -0,0 +1,3 @@
+# Keep HTML checked out with LF on all platforms so javadoc doclint
+# (JDK 25/26) does not treat CR (from CRLF) as part of a multi-line tag name.
+*.html text eol=lf

opendj-cli/src/main/java/com/forgerock/opendj/cli/CommonArguments.java

@@ -12,6 +12,7 @@
  * information: "Portions Copyright [year] [name of copyright owner]".
  *
  * Copyright 2014-2016 ForgeRock AS.
+ * Portions Copyright 2026 3A Systems, LLC.
  */
 package com.forgerock.opendj.cli;
 
@@ -391,7 +392,7 @@ public static StringArgument baseDNArgument() throws ArgumentException {
     }
 
     /**
-     * Returns the "bindDN" string argument. <br/>
+     * Returns the "bindDN" string argument. <br>
      * <i> N.B : the 'D' short option is also used by rootUserDN.</i>
      *
      * @param defaultBindDN
@@ -406,7 +407,7 @@ public static StringArgument bindDNArgument(final String defaultBindDN) throws A
 
 
     /**
-     * Returns the "bindDN" string argument. <br/>
+     * Returns the "bindDN" string argument. <br>
      * <i> N.B : the 'D' short option is also used by rootUserDN.</i>
      *
      * @param defaultBindDN

opendj-cli/src/main/java/com/forgerock/opendj/cli/ConnectionFactoryProvider.java

@@ -13,6 +13,7 @@
  *
  * Copyright 2010 Sun Microsystems, Inc.
  * Portions copyright 2011-2016 ForgeRock AS.
+ * Portions Copyright 2026 3A Systems, LLC.
  */
 package com.forgerock.opendj.cli;
 
@@ -702,7 +703,8 @@ public String toString() {
      *             If a problem occurs while loading with the key store.
      * @throws CertificateException
      *             If a problem occurs while loading with the key store.
-     * @throws UnrecoverableKeyException 
+     * @throws UnrecoverableKeyException
+     *             If a problem occurs while recovering a key from the key store.
      */
     public X509KeyManager getKeyManager(String keyStoreFile) throws KeyStoreException,
             IOException, NoSuchAlgorithmException, CertificateException, UnrecoverableKeyException {
@@ -898,15 +900,15 @@ private String parseSASLOptionValue(final String option) throws ArgumentExceptio
      * user will be different as a normal connection. E.g if set :
      *
      * <pre>
-     * >>>> Specify OpenDJ LDAP connection parameters
+     * &gt;&gt;&gt;&gt; Specify OpenDJ LDAP connection parameters
      *
      * Directory server administration port number [4444]:
      * </pre>
      *
      * vs normal mode
      *
      * <pre>
-     * >>>> Specify OpenDJ LDAP connection parameters
+     * &gt;&gt;&gt;&gt; Specify OpenDJ LDAP connection parameters
      *
      * Directory server port number [1389]:
      * </pre>

opendj-cli/src/main/java/com/forgerock/opendj/cli/MultiChoiceArgument.java

@@ -13,6 +13,7 @@
  *
  * Copyright 2006-2008 Sun Microsystems, Inc.
  * Portions copyright 2014-2016 ForgeRock AS.
+ * Portions Copyright 2026 3A Systems, LLC.
  */
 package com.forgerock.opendj.cli;
 
@@ -36,7 +37,7 @@ public final class MultiChoiceArgument<V> extends Argument {
 
     /**
      * Returns a builder which can be used for incrementally constructing a new
-     * {@link MultiChoiceArgument<V>}.
+     * {@link MultiChoiceArgument}.
      *
      * @param <V>
      *         The type of values returned by this argument.
@@ -48,7 +49,7 @@ public static <V> Builder<V> builder(final String longIdentifier) {
         return new Builder<>(longIdentifier);
     }
 
-    /** A fluent API for incrementally constructing {@link MultiChoiceArgument<V>}. */
+    /** A fluent API for incrementally constructing {@link MultiChoiceArgument}. */
     public static final class Builder<V> extends ArgumentBuilder<Builder<V>, V, MultiChoiceArgument<V>> {
         private final List<V> allowedValues = new LinkedList<>();
 
@@ -62,10 +63,10 @@ Builder<V> getThis() {
         }
 
         /**
-         * Specifies the set of values that are allowed for the {@link MultiChoiceArgument<V>}.
+         * Specifies the set of values that are allowed for the {@link MultiChoiceArgument}.
          *
          * @param allowedValues
-         *         The {@link MultiChoiceArgument<V>} allowed values.
+         *         The {@link MultiChoiceArgument} allowed values.
          * @return This builder.
          */
         public Builder<V> allowedValues(final Collection<V> allowedValues) {
@@ -74,10 +75,10 @@ public Builder<V> allowedValues(final Collection<V> allowedValues) {
         }
 
         /**
-         * Specifies the set of values that are allowed for the {@link MultiChoiceArgument<V>}.
+         * Specifies the set of values that are allowed for the {@link MultiChoiceArgument}.
          *
          * @param allowedValues
-         *         The {@link MultiChoiceArgument<V>} allowed values.
+         *         The {@link MultiChoiceArgument} allowed values.
          * @return This builder.
          */
         @SuppressWarnings("unchecked")

opendj-cli/src/main/java/com/forgerock/opendj/cli/MultiColumnPrinter.java

@@ -13,6 +13,7 @@
  *
  * Copyright 2010 Sun Microsystems, Inc.
  * Portions copyright 2012-2016 ForgeRock AS.
+ * Portions Copyright 2026 3A Systems, LLC.
  */
 package com.forgerock.opendj.cli;
 
@@ -62,7 +63,7 @@
  * <p>
  * The following code sample presents how to create a {@link MultiColumnPrinter} to write CSV data:
  * <pre>
- * final List<MultiColumnPrinter.Column> columns = new ArrayList&lt;&gt;();
+ * final List&lt;MultiColumnPrinter.Column&gt; columns = new ArrayList&lt;&gt;();
  * columns.add(MultiColumnPrinter.column("CountryNameColumnId", "country_name", 0));
  * columns.add(MultiColumnPrinter.column("populationDensityId", "population_density", 1));
  * columns.add(MultiColumnPrinter.column("GiniId", "gini", 1));
@@ -84,7 +85,7 @@
  * The following code sample presents how to configure a {@link MultiColumnPrinter}
  * to print the same data on console with some title headers.
  * <pre>
- *     final List<MultiColumnPrinter.Column> columns = new ArrayList&lt;&gt;();
+ *     final List&lt;MultiColumnPrinter.Column&gt; columns = new ArrayList&lt;&gt;();
  *     columns.add(MultiColumnPrinter.separatorColumn());
  *     columns.add(MultiColumnPrinter.column("CountryNameColumnId", "Country Name", 15, 0));
  *     columns.add(MultiColumnPrinter.column("populationDensityId", "Density", 10, 1));

opendj-cli/src/main/java/com/forgerock/opendj/cli/Utils.java

@@ -13,6 +13,7 @@
  *
  * Copyright 2006-2010 Sun Microsystems, Inc.
  * Portions copyright 2014-2016 ForgeRock AS.
+ * Portions Copyright 2026 3A Systems, LLC.
  */
 package com.forgerock.opendj.cli;
 
@@ -612,10 +613,10 @@ public static void printWrappedText(final PrintStream stream, final LocalizableM
      * Repeats the given {@code char} n times.
      *
      * @param charToRepeat
-     *      The {code char} to repeat.
+     *      The {@code char} to repeat.
      * @param length
      *      The repetition count.
-     * @return The given {code char} n times.
+     * @return The given {@code char} n times.
      */
     public static String repeat(final char charToRepeat, final int length) {
         final char[] str = new char[length];
@@ -624,11 +625,11 @@ public static String repeat(final char charToRepeat, final int length) {
     }
 
     /**
-     * Return a {code ValidationCallback<Integer>} which can be used to validate a port number.
+     * Return a {@code ValidationCallback<Integer>} which can be used to validate a port number.
      *
      * @param defaultPort
      *        The default value to suggest to the user.
-     * @return a {code ValidationCallback<Integer>} which can be used to validate a port number.
+     * @return a {@code ValidationCallback<Integer>} which can be used to validate a port number.
      */
     public static ValidationCallback<Integer> portValidationCallback(final int defaultPort) {
         return new ValidationCallback<Integer>() {
@@ -673,7 +674,7 @@ public static void throwIfArgumentsConflict(final Argument arg1, final Argument
     }
 
     /**
-     * Adds a {@link LocalizableMessage} to the provided {@link Collection<LocalizableMessage>}
+     * Adds a {@link LocalizableMessage} to the provided {@link Collection}
      * if both provided {@link Argument} are presents in the command line arguments.
      *
      * @param errors

opendj-config/pom.xml

@@ -13,6 +13,7 @@
   information: "Portions Copyright [year] [name of copyright owner]".
 
   Copyright 2013-2016 ForgeRock AS.
+  Portions Copyright 2026 3A Systems, LLC.
 -->
 <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
   <modelVersion>4.0.0</modelVersion>
@@ -66,7 +67,6 @@
     <opendj.osgi.import.additional>
       org.forgerock.opendj.*;provide:=true
     </opendj.osgi.import.additional>
-    <doclint>none</doclint>
   </properties>
 
   <build><finalName>${project.groupId}.${project.artifactId}</finalName>

opendj-config/src/main/java/org/forgerock/opendj/config/DurationPropertyDefinition.java

@@ -13,6 +13,7 @@
  *
  * Copyright 2008 Sun Microsystems, Inc.
  * Portions Copyright 2016 ForgeRock AS.
+ * Portions Copyright 2026 3A Systems, LLC.
  */
 
 package org.forgerock.opendj.config;
@@ -179,7 +180,7 @@ public final void setMaximumUnit(DurationUnit unit) {
          * Set the lower limit in milli-seconds.
          *
          * @param lowerLimit
-         *            The new lower limit (must be >= 0) in milli-seconds.
+         *            The new lower limit (must be >= 0) in milli-seconds.
          * @throws IllegalArgumentException
          *             If a negative lower limit was specified, or the lower
          *             limit is greater than the upper limit.

opendj-config/src/main/java/org/forgerock/opendj/config/IntegerPropertyDefinition.java

@@ -13,6 +13,7 @@
  *
  * Copyright 2008 Sun Microsystems, Inc.
  * Portions Copyright 2016 ForgeRock AS.
+ * Portions Copyright 2026 3A Systems, LLC.
  */
 
 package org.forgerock.opendj.config;
@@ -73,7 +74,7 @@ private Builder(AbstractManagedObjectDefinition<?, ?> d, String propertyName) {
          * Set the lower limit.
          *
          * @param lowerLimit
-         *            The new lower limit (must be >= 0).
+         *            The new lower limit (must be &gt;= 0).
          * @throws IllegalArgumentException
          *             If a negative lower limit was specified or the lower
          *             limit is greater than the upper limit.

opendj-config/src/main/java/org/forgerock/opendj/config/PropertyDefinition.java

@@ -13,6 +13,7 @@
  *
  * Copyright 2008 Sun Microsystems, Inc.
  * Portions Copyright 2015-2016 ForgeRock AS.
+ * Portions Copyright 2026 3A Systems, LLC.
  */
 
 package org.forgerock.opendj.config;
@@ -338,8 +339,8 @@ public String encodeValue(T value) {
     /**
      * Indicates whether some other object is "equal to" this property
      * definition. This method must obey the general contract of
-     * <tt>Object.equals(Object)</tt>. Additionally, this method can return
-     * <tt>true</tt> <i>only</i> if the specified Object is also a property
+     * <code>Object.equals(Object)</code>. Additionally, this method can return
+     * <code>true</code> <i>only</i> if the specified Object is also a property
      * definition and it has the same name, as returned by {@link #getName()},
      * and also is deemed to be &quot;compatible&quot; with this property
      * definition. Compatibility means that the two property definitions share

opendj-config/src/main/java/org/forgerock/opendj/config/SizePropertyDefinition.java

@@ -13,6 +13,7 @@
  *
  * Copyright 2008 Sun Microsystems, Inc.
  * Portions Copyright 2016 ForgeRock AS.
+ * Portions Copyright 2026 3A Systems, LLC.
  */
 package org.forgerock.opendj.config;
 
@@ -71,7 +72,7 @@ private Builder(AbstractManagedObjectDefinition<?, ?> d, String propertyName) {
          * Set the lower limit in bytes.
          *
          * @param lowerLimit
-         *            The new lower limit (must be >= 0) in bytes.
+         *            The new lower limit (must be &gt;= 0) in bytes.
          * @throws IllegalArgumentException
          *             If a negative lower limit was specified, or if the lower
          *             limit is greater than the upper limit.

opendj-core/pom.xml

@@ -13,7 +13,7 @@
   information: "Portions Copyright [year] [name of copyright owner]".
 
   Copyright 2011-2016 ForgeRock AS.
-  Portions Copyright 2025 3A Systems LLC.
+  Portions Copyright 2025-2026 3A Systems LLC.
 -->
 <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
     <modelVersion>4.0.0</modelVersion>
@@ -120,7 +120,6 @@
             com.sun.security.auth*;resolution:=optional
         </opendj.osgi.import.additional>
         <maven.build.timestamp.format>yyyy-MM-dd'T'HH:mm:ss'Z'</maven.build.timestamp.format>
-        <doclint>none</doclint>
     </properties>
 
 

opendj-core/src/main/java/com/forgerock/reactive/ReactiveFilter.java

@@ -12,6 +12,7 @@
  * information: "Portions Copyright [year] [name of copyright owner]".
  *
  * Copyright 2016 ForgeRock AS.
+ * Portions Copyright 2026 3A Systems, LLC.
  */
 package com.forgerock.reactive;
 
@@ -21,6 +22,7 @@
 /**
  * Filters and/or transforms the request and/or response of an exchange.
  *
+ * <pre>{@code
  *                +--------+              +---------+
  *   ---> I1 ---> |        | ---> I2 ---> |         |
  *                | Filter |              | Handler |
@@ -32,6 +34,7 @@
  *                | Filter |              | Filter  |              | Handler |
  *   <--- O1 --<  |        | <--- O2 <--- |         | <--- O3 ---< |         |
  *                +--------+              +---------+              +---------+
+ * }</pre>
  *
  * @param <C>
  *            Context in which the filter will be evaluated

opendj-core/src/main/java/org/forgerock/opendj/ldap/ByteSequenceReader.java

@@ -13,6 +13,7 @@
  *
  * Copyright 2009 Sun Microsystems, Inc.
  * Portions copyright 2012-2016 ForgeRock AS.
+ * Portions Copyright 2026 3A Systems, LLC.
  */
 package org.forgerock.opendj.ldap;
 
@@ -299,7 +300,7 @@ public long readLong() {
     /**
      * Relative read method for reading a compacted long value.
      * Compaction allows to reduce number of bytes needed to hold long types
-     * depending on its value (i.e: if value < 128, value will be encoded using one byte only).
+     * depending on its value (i.e: if value &lt; 128, value will be encoded using one byte only).
      * Reads the next bytes at this reader's current position, composing them into a long value
      * according to big-endian byte order, and then increments the position by the size of the
      * encoded long.
@@ -321,7 +322,7 @@ public long readCompactUnsignedLong() {
     /**
      * Relative read method for reading a compacted int value.
      * Compaction allows to reduce number of bytes needed to hold int types
-     * depending on its value (i.e: if value < 128, value will be encoded using one byte only).
+     * depending on its value (i.e: if value &lt; 128, value will be encoded using one byte only).
      * Reads the next bytes at this reader's current position, composing them into an int value
      * according to big-endian byte order, and then increments the position by the size of the
      * encoded int.

opendj-core/src/main/java/org/forgerock/opendj/ldap/ByteStringBuilder.java

@@ -13,6 +13,7 @@
  *
  * Copyright 2009 Sun Microsystems, Inc.
  * Portions copyright 2011-2015 ForgeRock AS.
+ * Portions Copyright 2026 3A Systems, LLC.
  */
 package org.forgerock.opendj.ldap;
 
@@ -300,7 +301,7 @@ public ByteStringBuilder(final ByteSequence bs) {
      *
      * <pre>
      * int i = ...;
-     * int i8bits = i & 0xFF;
+     * int i8bits = i &amp; 0xFF;
      * // only use "i8bits"
      * </pre>
      * OR
@@ -643,7 +644,7 @@ public ByteStringBuilder appendObject(final Object o) {
      *
      * <pre>
      * int i = ...;
-     * int i16bits = i & 0xFFFF;
+     * int i16bits = i &amp; 0xFFFF;
      * // only use "i16bits"
      * </pre>
      * OR