Let one package-info stand per package, and aggregate Javadoc before the me...

Valery Kharseko

10 hours ago e5733d17b29731299ac9387e70a367802e821cb0

Let one package-info stand per package, and aggregate Javadoc before the merge (#899)

 .github/workflows/build.yml

@@ -96,11 +96,25 @@
      run:   |
        echo "MAVEN_PROFILE_FLAG=-P precommit" >> $GITHUB_OUTPUT

    # The per-module javadoc:jar that runs during verify only ever sees one
    # module's sources, so it cannot report a package declared by two modules
    # at once. Only the aggregate on the root reactor can, and it used to run
    # nowhere but deploy.yml, after the merge and under continue-on-error, so a
    # broken aggregate blocked nothing and went unnoticed. This is the gate for
    # it. Appending the goal to the same Maven invocation keeps it in the
    # reactor that just built; one cell is enough, and this is the platform and
    # Java version deploy.yml aggregates with.
    - name: Set Aggregate Javadoc Goal
      id: javadoc
      if: runner.os == 'Linux' && matrix.java == '11'
      run:   |
        echo "MAVEN_JAVADOC_GOAL=javadoc:aggregate" >> $GITHUB_OUTPUT

    - name: Build with Maven
      timeout-minutes: 180
      env:
        MAVEN_OPTS: -Dhttps.protocols=TLSv1.2 -Dmaven.wagon.httpconnectionManager.ttlSeconds=120 -Dmaven.wagon.http.retryHandler.requestSentEnabled=true -Dmaven.wagon.http.retryHandler.count=10
      run: mvn --batch-mode --errors --update-snapshots verify --file pom.xml ${{ steps.failsafe.outputs.MAVEN_PROFILE_FLAG }}
      run: mvn --batch-mode --errors --update-snapshots verify ${{ steps.javadoc.outputs.MAVEN_JAVADOC_GOAL }} --file pom.xml ${{ steps.failsafe.outputs.MAVEN_PROFILE_FLAG }}
    - name: Test on Unix
      if: runner.os == 'Linux'
      run:   |

 opendj-embedded-server-examples/src/main/java/org/forgerock/opendj/examples/package-info.java

File was deleted

 opendj-ldap-sdk-examples/src/main/java/org/forgerock/opendj/examples/package-info.java

@@ -12,11 +12,12 @@
 * information: "Portions Copyright [year] [name of copyright owner]".
 *
 * Copyright 2012 ForgeRock AS.
 * Portions Copyright 2026 3A Systems, LLC.
 */

/**
 * This package includes examples illustrating various use cases of the
 * OpenDJ LDAP SDK.
 * OpenDJ LDAP SDK, and of the Embedded Server API.
 */
package org.forgerock.opendj.examples;


 opendj-legacy/src/main/java/org/opends/server/api/package-info.java

File was deleted

 opendj-legacy/src/main/java/org/opends/server/backends/jeb/package-info.java

File was deleted

 opendj-legacy/src/main/java/org/opends/server/replication/plugin/package-info.java

File was deleted

 opendj-legacy/src/main/java/org/opends/server/schema/package-info.java

File was deleted

 opendj-server-legacy/src/main/java/org/opends/server/backends/jeb/package-info.java

@@ -20,6 +20,7 @@
/**
 * Contains the code for the Directory Server backend that uses the Berkeley DB
 * Java Edition as the repository for storing entry and index information.
 * These classes are here just to support upgrade and are deprecated.
 * <BR><BR>
 *
 * <H2>On-disk Representation</H2>