From 27c45033fb27d8653309f5c23b88402312d6a29a Mon Sep 17 00:00:00 2001 From: Geert Bevin Date: Sun, 12 Jul 2026 23:05:15 -0400 Subject: [PATCH] Bump @since tags to 2.4.0 for the next release --- src/main/java/rife/bld/BaseProject.java | 2 +- src/main/java/rife/bld/BuildExecutor.java | 2 +- .../dependencies/DependencyTransferBatch.java | 6 +-- .../ParallelDependencyResolver.java | 12 ++--- .../bld/dependencies/ParallelExecution.java | 2 +- .../rife/bld/dependencies/PomPrefetcher.java | 4 +- .../rife/bld/dependencies/TransferOutput.java | 10 ++-- .../bld/dependencies/VersionResolution.java | 8 +-- .../operations/AbstractCreateOperation.java | 4 +- .../bld/operations/AbstractOperation.java | 4 +- .../operations/AbstractProcessOperation.java | 8 +-- .../bld/operations/DownloadOperation.java | 4 +- .../rife/bld/operations/JavacOptions.java | 50 +++++++++---------- 13 files changed, 58 insertions(+), 58 deletions(-) diff --git a/src/main/java/rife/bld/BaseProject.java b/src/main/java/rife/bld/BaseProject.java index 4786eed..e6a8951 100644 --- a/src/main/java/rife/bld/BaseProject.java +++ b/src/main/java/rife/bld/BaseProject.java @@ -29,7 +29,7 @@ public class BaseProject extends BuildExecutor { /** * The CLI option to trigger automatic dependency download and purge. * - * @since 2.3.1 + * @since 2.4.0 */ public static final String AUTO_DOWNLOAD_PURGE_OPTION = "--auto-download-purge"; diff --git a/src/main/java/rife/bld/BuildExecutor.java b/src/main/java/rife/bld/BuildExecutor.java index 7310cfa..95cf98e 100644 --- a/src/main/java/rife/bld/BuildExecutor.java +++ b/src/main/java/rife/bld/BuildExecutor.java @@ -144,7 +144,7 @@ public class BuildExecutor { * * @return {@code true} if the execution is verbose; * or {@code false} otherwise - * @since 2.3.1 + * @since 2.4.0 */ public boolean verbose() { return verbose_; diff --git a/src/main/java/rife/bld/dependencies/DependencyTransferBatch.java b/src/main/java/rife/bld/dependencies/DependencyTransferBatch.java index 7166a0d..dac1470 100644 --- a/src/main/java/rife/bld/dependencies/DependencyTransferBatch.java +++ b/src/main/java/rife/bld/dependencies/DependencyTransferBatch.java @@ -25,7 +25,7 @@ import java.util.function.Supplier; * transfers into the same directory are only performed once. * * @author Geert Bevin (gbevin[remove] at uwyn dot com) - * @since 2.3.1 + * @since 2.4.0 */ public class DependencyTransferBatch { private record TransferRequest(Dependency dependency, File directory, String[] classifiers) { @@ -45,7 +45,7 @@ public class DependencyTransferBatch { * @param classifiers the additional classifiers to transfer * @return this batch instance * @throws DependencyTransferException when the transfer couldn't be prepared - * @since 2.3.1 + * @since 2.4.0 */ public DependencyTransferBatch add(DependencySet dependencies, File directory, File modulesDirectory, String... classifiers) { for (var dependency : dependencies) { @@ -88,7 +88,7 @@ public class DependencyTransferBatch { * @param repositories the repositories to use for the transfer * @return the list of artifacts that were transferred successfully * @throws DependencyTransferException when an error occurred during the transfer - * @since 2.3.1 + * @since 2.4.0 */ public List transfer(VersionResolution resolution, ArtifactRetriever retriever, List repositories) { final var repos = (repositories == null ? List.of() : repositories); diff --git a/src/main/java/rife/bld/dependencies/ParallelDependencyResolver.java b/src/main/java/rife/bld/dependencies/ParallelDependencyResolver.java index 76ee196..ba1a7e2 100644 --- a/src/main/java/rife/bld/dependencies/ParallelDependencyResolver.java +++ b/src/main/java/rife/bld/dependencies/ParallelDependencyResolver.java @@ -19,7 +19,7 @@ import java.util.function.Supplier; * {@link DependencyResolver}, in the same order. * * @author Geert Bevin (gbevin[remove] at uwyn dot com) - * @since 2.3.1 + * @since 2.4.0 */ public class ParallelDependencyResolver { private final VersionResolution resolution_; @@ -34,7 +34,7 @@ public class ParallelDependencyResolver { * @param resolution the version resolution state that can be cached * @param retriever the retriever to use to get artifacts * @param repositories the repositories to use for the resolution - * @since 2.3.1 + * @since 2.4.0 */ public ParallelDependencyResolver(VersionResolution resolution, ArtifactRetriever retriever, List repositories) { resolution_ = resolution; @@ -55,7 +55,7 @@ public class ParallelDependencyResolver { * @param roots the root dependencies to resolve * @param scopes the scopes to return the transitive dependencies for * @return the merged transitive dependencies of all the roots - * @since 2.3.1 + * @since 2.4.0 */ public DependencySet resolveAllDependencies(Collection roots, Scope... scopes) { var result = new DependencySet(); @@ -86,7 +86,7 @@ public class ParallelDependencyResolver { * * @param dependencies the dependencies to resolve the latest versions of * @return the latest versions in the order of the provided dependencies - * @since 2.3.1 + * @since 2.4.0 */ public List resolveLatestVersions(List dependencies) { var resolutions = new ArrayList>(dependencies.size()); @@ -100,7 +100,7 @@ public class ParallelDependencyResolver { * Returns the version resolution state that can be cached. * * @return the version resolution state - * @since 2.3.1 + * @since 2.4.0 */ public VersionResolution resolution() { return resolution_; @@ -110,7 +110,7 @@ public class ParallelDependencyResolver { * Retrieve the repositories that are used by this resolver. * * @return the resolver's repositories - * @since 2.3.1 + * @since 2.4.0 */ public List repositories() { return repositories_; diff --git a/src/main/java/rife/bld/dependencies/ParallelExecution.java b/src/main/java/rife/bld/dependencies/ParallelExecution.java index 86dd7ca..ac18a5f 100644 --- a/src/main/java/rife/bld/dependencies/ParallelExecution.java +++ b/src/main/java/rife/bld/dependencies/ParallelExecution.java @@ -17,7 +17,7 @@ import java.util.function.Supplier; * order will have its exception rethrown. * * @author Geert Bevin (gbevin[remove] at uwyn dot com) - * @since 2.3.1 + * @since 2.4.0 */ final class ParallelExecution { private ParallelExecution() { diff --git a/src/main/java/rife/bld/dependencies/PomPrefetcher.java b/src/main/java/rife/bld/dependencies/PomPrefetcher.java index fabbc45..a0ad475 100644 --- a/src/main/java/rife/bld/dependencies/PomPrefetcher.java +++ b/src/main/java/rife/bld/dependencies/PomPrefetcher.java @@ -20,7 +20,7 @@ import java.util.concurrent.Executors; * POM of each unique dependency will only be prefetched once. * * @author Geert Bevin (gbevin[remove] at uwyn dot com) - * @since 2.3.1 + * @since 2.4.0 */ class PomPrefetcher { private final VersionResolution resolution_; @@ -34,7 +34,7 @@ class PomPrefetcher { * * @return the prefetcher; or {@code null} when the retriever doesn't * cache the retrieved POMs or when the resolution parallelism disables it - * @since 2.3.1 + * @since 2.4.0 */ static PomPrefetcher create(VersionResolution resolution, ArtifactRetriever retriever, List repositories) { // prefetching only has benefits when the retrieved POMs are diff --git a/src/main/java/rife/bld/dependencies/TransferOutput.java b/src/main/java/rife/bld/dependencies/TransferOutput.java index a04d3b4..b24408e 100644 --- a/src/main/java/rife/bld/dependencies/TransferOutput.java +++ b/src/main/java/rife/bld/dependencies/TransferOutput.java @@ -18,7 +18,7 @@ import java.util.List; * interleaving the lines of parallel transfers. * * @author Geert Bevin (gbevin[remove] at uwyn dot com) - * @since 2.3.1 + * @since 2.4.0 */ abstract class TransferOutput { private static final TransferOutput INSTANCE = create(); @@ -39,14 +39,14 @@ abstract class TransferOutput { * * @param location the location of the artifact that is being transferred * @return the transfer to report progress and completion on - * @since 2.3.1 + * @since 2.4.0 */ abstract Transfer start(String location); /** * A single artifact transfer whose progress is being tracked. * - * @since 2.3.1 + * @since 2.4.0 */ abstract static class Transfer { protected final String location_; @@ -60,7 +60,7 @@ abstract class TransferOutput { * * @param transferred the number of bytes transferred so far * @param total the total number of bytes; or {@code -1} when unknown - * @since 2.3.1 + * @since 2.4.0 */ abstract void progress(long transferred, long total); @@ -69,7 +69,7 @@ abstract class TransferOutput { * * @param status the final status of the transfer, like * {@code done}, {@code exists} or {@code not found} - * @since 2.3.1 + * @since 2.4.0 */ abstract void finish(String status); } diff --git a/src/main/java/rife/bld/dependencies/VersionResolution.java b/src/main/java/rife/bld/dependencies/VersionResolution.java index 8dc2de0..998e77a 100644 --- a/src/main/java/rife/bld/dependencies/VersionResolution.java +++ b/src/main/java/rife/bld/dependencies/VersionResolution.java @@ -44,7 +44,7 @@ public class VersionResolution { /** * The property key that determines how many artifact transfers are * performed in parallel, {@code 1} makes them sequential. - * @since 2.3.1 + * @since 2.4.0 */ public static final String PROPERTY_TRANSFER_PARALLELISM = "bld.transferParallelism"; private static final int DEFAULT_TRANSFER_PARALLELISM = 6; @@ -53,7 +53,7 @@ public class VersionResolution { * The property key that determines how many POMs are speculatively * retrieved in parallel during transitive dependency resolution, * {@code 1} disables the parallel retrieval. - * @since 2.3.1 + * @since 2.4.0 */ public static final String PROPERTY_RESOLUTION_PARALLELISM = "bld.resolutionParallelism"; private static final int DEFAULT_RESOLUTION_PARALLELISM = 6; @@ -168,7 +168,7 @@ public class VersionResolution { * {@code 1} means transfers are sequential. * * @return the number of parallel artifact transfers - * @since 2.3.1 + * @since 2.4.0 */ public int transferParallelism() { return transferParallelism_; @@ -180,7 +180,7 @@ public class VersionResolution { * retrieval is disabled. * * @return the number of parallel POM retrievals - * @since 2.3.1 + * @since 2.4.0 */ public int resolutionParallelism() { return resolutionParallelism_; diff --git a/src/main/java/rife/bld/operations/AbstractCreateOperation.java b/src/main/java/rife/bld/operations/AbstractCreateOperation.java index 8758843..eb1dffa 100644 --- a/src/main/java/rife/bld/operations/AbstractCreateOperation.java +++ b/src/main/java/rife/bld/operations/AbstractCreateOperation.java @@ -179,7 +179,7 @@ public abstract class AbstractCreateOperation> { * @param verbose {@code true} if the operation should be verbose; * {@code false} otherwise * @return this operation instance - * @since 2.3.1 + * @since 2.4.0 */ public T verbose(boolean verbose) { verbose_ = verbose; @@ -68,7 +68,7 @@ public abstract class AbstractOperation> { * * @return {@code true} if the operation should be verbose; * {@code false} otherwise - * @since 2.3.1 + * @since 2.4.0 */ public boolean verbose() { return verbose_; diff --git a/src/main/java/rife/bld/operations/AbstractProcessOperation.java b/src/main/java/rife/bld/operations/AbstractProcessOperation.java index c1cfc4e..ad466db 100644 --- a/src/main/java/rife/bld/operations/AbstractProcessOperation.java +++ b/src/main/java/rife/bld/operations/AbstractProcessOperation.java @@ -241,7 +241,7 @@ public abstract class AbstractProcessOperation classpath) { classpath_.addAll(classpath.stream().map(File::getAbsolutePath).toList()); @@ -293,7 +293,7 @@ public abstract class AbstractProcessOperation modulePath) { modulePath_.addAll(modulePath.stream().map(File::getAbsolutePath).toList()); diff --git a/src/main/java/rife/bld/operations/DownloadOperation.java b/src/main/java/rife/bld/operations/DownloadOperation.java index e2034b7..4413ded 100644 --- a/src/main/java/rife/bld/operations/DownloadOperation.java +++ b/src/main/java/rife/bld/operations/DownloadOperation.java @@ -145,7 +145,7 @@ public class DownloadOperation extends AbstractOperation { * artifact transfers of the {@linkplain #transfers() transfer batch} * together in parallel. * - * @since 2.3.1 + * @since 2.4.0 */ protected void executeTransferDependencies() { transfers().transfer(new VersionResolution(properties()), artifactRetriever(), repositories()); @@ -156,7 +156,7 @@ public class DownloadOperation extends AbstractOperation { * operation. * * @return the artifact transfer batch of this operation - * @since 2.3.1 + * @since 2.4.0 */ protected DependencyTransferBatch transfers() { return transfers_; diff --git a/src/main/java/rife/bld/operations/JavacOptions.java b/src/main/java/rife/bld/operations/JavacOptions.java index 064d4fb..abc1329 100644 --- a/src/main/java/rife/bld/operations/JavacOptions.java +++ b/src/main/java/rife/bld/operations/JavacOptions.java @@ -136,7 +136,7 @@ public class JavacOptions extends ArrayList { * of other-module is ALL-UNNAMED * * @return this list of options - * @since 2.3.1 + * @since 2.4.0 */ public JavacOptions addExports(String... modules) { if (isNotEmpty(modules)) { @@ -151,7 +151,7 @@ public class JavacOptions extends ArrayList { * of other-module is ALL-UNNAMED * * @return this list of options - * @since 2.3.1 + * @since 2.4.0 */ public JavacOptions addExports(Collection modules) { return addCommaSeparatedOption("--add-exports", modules); @@ -161,7 +161,7 @@ public class JavacOptions extends ArrayList { * Specifies additional modules to be considered as required by a given module * * @return this list of options - * @since 2.3.1 + * @since 2.4.0 */ public JavacOptions addReads(String... modules) { if (isNotEmpty(modules)) { @@ -174,7 +174,7 @@ public class JavacOptions extends ArrayList { * Specifies additional modules to be considered as required by a given module * * @return this list of options - * @since 2.3.1 + * @since 2.4.0 */ public JavacOptions addReads(Collection modules) { return addCommaSeparatedOption("--add-reads", modules); @@ -222,7 +222,7 @@ public class JavacOptions extends ArrayList { * if none specified or inferred * * @return this list of options - * @since 2.3.1 + * @since 2.4.0 */ public JavacOptions defaultModuleForCreatedFiles(String module) { add("--default-module-for-created-files"); @@ -417,7 +417,7 @@ public class JavacOptions extends ArrayList { * Overrides or augments a module with classes and resources in JAR files or directories * * @return this list of options - * @since 2.3.1 + * @since 2.4.0 */ public JavacOptions patchModule(String module) { add("--patch-module"); @@ -441,7 +441,7 @@ public class JavacOptions extends ArrayList { * Provide source compatibility with the specified Java SE release * * @return this list of options - * @since 2.3.1 + * @since 2.4.0 */ public JavacOptions source(int version) { add("--source"); @@ -453,7 +453,7 @@ public class JavacOptions extends ArrayList { * Generate class files suitable for the specified Java SE release * * @return this list of options - * @since 2.3.1 + * @since 2.4.0 */ public JavacOptions target(int version) { add("--target"); @@ -645,7 +645,7 @@ public class JavacOptions extends ArrayList { * Specify where to find input source files for multiple modules * * @return this list of options - * @since 2.3.1 + * @since 2.4.0 */ public JavacOptions moduleSourcePathStrings(Collection paths) { return addPathOption("--module-source-path", paths); @@ -655,7 +655,7 @@ public class JavacOptions extends ArrayList { * Specify where to find input source files for multiple modules * * @return this list of options - * @since 2.3.1 + * @since 2.4.0 */ public JavacOptions moduleSourcePathPaths(Collection paths) { if (isNotEmpty(paths)) { @@ -668,7 +668,7 @@ public class JavacOptions extends ArrayList { * Specify where to find input source files for multiple modules * * @return this list of options - * @since 2.3.1 + * @since 2.4.0 */ public JavacOptions moduleSourcePath(Collection paths) { if (isNotEmpty(paths)) { @@ -827,7 +827,7 @@ public class JavacOptions extends ArrayList { * Specify a module path where to find annotation processors * * @return this list of options - * @since 2.3.1 + * @since 2.4.0 */ public JavacOptions processorModulePathPaths(Collection paths) { if (isNotEmpty(paths)) { @@ -840,7 +840,7 @@ public class JavacOptions extends ArrayList { * Specify a module path where to find annotation processors * * @return this list of options - * @since 2.3.1 + * @since 2.4.0 */ public JavacOptions processorModulePathStrings(Collection paths) { return addPathOption("--processor-module-path", paths); @@ -850,7 +850,7 @@ public class JavacOptions extends ArrayList { * Specify a module path where to find annotation processors * * @return this list of options - * @since 2.3.1 + * @since 2.4.0 */ public JavacOptions processorModulePath(Collection paths) { if (isNotEmpty(paths)) { @@ -902,7 +902,7 @@ public class JavacOptions extends ArrayList { * Specify where to find annotation processors * * @return this list of options - * @since 2.3.1 + * @since 2.4.0 */ public JavacOptions processorPathStrings(Collection paths) { return addPathOption("--processor-path", paths); @@ -912,7 +912,7 @@ public class JavacOptions extends ArrayList { * Specify where to find annotation processors * * @return this list of options - * @since 2.3.1 + * @since 2.4.0 */ public JavacOptions processorPath(Collection paths) { if (isNotEmpty(paths)) { @@ -925,7 +925,7 @@ public class JavacOptions extends ArrayList { * Specify where to find annotation processors * * @return this list of options - * @since 2.3.1 + * @since 2.4.0 */ public JavacOptions processorPathPaths(Collection paths) { if (isNotEmpty(paths)) { @@ -1036,7 +1036,7 @@ public class JavacOptions extends ArrayList { * Override location of upgradeable modules * * @return this list of options - * @since 2.3.1 + * @since 2.4.0 */ public JavacOptions upgradeModulePathStrings(Collection paths) { return addPathOption("--upgrade-module-path", paths); @@ -1046,7 +1046,7 @@ public class JavacOptions extends ArrayList { * Override location of upgradeable modules * * @return this list of options - * @since 2.3.1 + * @since 2.4.0 */ public JavacOptions upgradeModulePath(Collection paths) { if (isNotEmpty(paths)) { @@ -1059,7 +1059,7 @@ public class JavacOptions extends ArrayList { * Override location of upgradeable modules * * @return this list of options - * @since 2.3.1 + * @since 2.4.0 */ public JavacOptions upgradeModulePathPaths(Collection paths) { if (isNotEmpty(paths)) { @@ -1083,7 +1083,7 @@ public class JavacOptions extends ArrayList { * Enable recommended warning categories * * @return this list of options - * @since 2.3.1 + * @since 2.4.0 */ public JavacOptions xLint() { add("-Xlint"); @@ -1094,7 +1094,7 @@ public class JavacOptions extends ArrayList { * Warning categories to enable * * @return this list of options - * @since 2.3.1 + * @since 2.4.0 */ public JavacOptions xLint(XLintKey... keys) { if (isNotEmpty(keys)) { @@ -1107,7 +1107,7 @@ public class JavacOptions extends ArrayList { * Warning categories to enable * * @return this list of options - * @since 2.3.1 + * @since 2.4.0 */ public JavacOptions xLint(Collection keys) { if (isNotEmpty(keys)) { @@ -1120,7 +1120,7 @@ public class JavacOptions extends ArrayList { * Warning categories to disable * * @return this list of options - * @since 2.3.1 + * @since 2.4.0 */ public JavacOptions xLintDisable(XLintKey... keys) { if (isNotEmpty(keys)) { @@ -1133,7 +1133,7 @@ public class JavacOptions extends ArrayList { * Warning categories to disable * * @return this list of options - * @since 2.3.1 + * @since 2.4.0 */ public JavacOptions xLintDisable(Collection keys) { if (isNotEmpty(keys)) {