diff --git a/build-tools/build-infra/src/main/groovy/lucene.java.core.mrjar.gradle b/build-tools/build-infra/src/main/groovy/lucene.java.core.mrjar.gradle index 2bf5bc129543..c6623860de8d 100644 --- a/build-tools/build-infra/src/main/groovy/lucene.java.core.mrjar.gradle +++ b/build-tools/build-infra/src/main/groovy/lucene.java.core.mrjar.gradle @@ -30,7 +30,7 @@ configure(project(":lucene:core")) { dependencies.add("main${jdkVersion}Implementation", sourceSets.main.output) tasks.named("compileMain${jdkVersion}Java").configure { - def apijar = apijars.file("jdk${jdkVersion}.apijar") + def apijar = apijars.file("jdk${jdkVersion}-api.jar") // TODO: this depends on the order of argument configuration... int releaseIndex = options.compilerArgs.indexOf("--release") diff --git a/build-tools/build-infra/src/main/groovy/lucene.regenerate.extract-jdk-apis.gradle b/build-tools/build-infra/src/main/groovy/lucene.regenerate.extract-jdk-apis.gradle index 05d2a692ce5a..5bb519ffb8ac 100644 --- a/build-tools/build-infra/src/main/groovy/lucene.regenerate.extract-jdk-apis.gradle +++ b/build-tools/build-infra/src/main/groovy/lucene.regenerate.extract-jdk-apis.gradle @@ -48,7 +48,7 @@ configure(project(":lucene:core")) { args = [ rootProject.minJavaVersion.toString(), jdkVersion, - apijars.file("jdk${jdkVersion}.apijar"), + apijars.file("jdk${jdkVersion}-api.jar"), ] } diff --git a/lucene/core/src/generated/jdk/README.md b/lucene/core/src/generated/jdk/README.md index f454b2c54315..3fbb074b0058 100644 --- a/lucene/core/src/generated/jdk/README.md +++ b/lucene/core/src/generated/jdk/README.md @@ -17,13 +17,13 @@ # Generated Java API signatures files -This directory contains generated `.apijar` files. Those are special JAR files containing +This directory contains generated `*-api.jar` files. Those are special JAR files containing class files that only have public signatures of certain packages of the Java class library, but no bytecode at all. Those files are only used to compile the MR-JAR of Apache Lucene while allowing to link against APIs only provided as preview or incubating APIs in future JDK versions. -`.apijar` files are provided for developer's convenience in the Lucene source tree. +These API jar files are provided for developer's convenience in the Lucene source tree. They are not part of Lucene's APIs or source code and are not part of binary releases. See them as binary blobs with encoded information also provided through the public [Javadocs](https://docs.oracle.com/en/java/javase/) of the corresponding Java diff --git a/lucene/core/src/generated/jdk/jdk24.apijar b/lucene/core/src/generated/jdk/jdk24-api.jar similarity index 100% rename from lucene/core/src/generated/jdk/jdk24.apijar rename to lucene/core/src/generated/jdk/jdk24-api.jar