This is an automated email from the ASF dual-hosted git repository.

davsclaus pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/camel.git


The following commit(s) were added to refs/heads/main by this push:
     new f19760ebbfa5 Fix duplicated words in Javadoc and @param names no 
parameter has (#29647)
f19760ebbfa5 is described below

commit f19760ebbfa5fb76eb0656beb70aa3cf083d6dbc
Author: dhairya05 <[email protected]>
AuthorDate: Thu Nov 12 12:04:04 2026 +0530

    Fix duplicated words in Javadoc and @param names no parameter has (#29647)
    
    * core: fix duplicated words in Javadoc and comments
    
    * camel-core: fix duplicated words in the Threads EIP test comments
    
    * components: fix duplicated words in Javadoc and comments
    
    The gson and jackson entries are constructor Javadoc, not option
    descriptions, so no generated descriptor carries them.
    
    * camel-jbang, camel-tooling-maven: fix Javadoc @param names that no 
parameter has
    
    parseMavenResolverString documented gav for a parameter called gaecv;
    findQuarkusPlatformBom documented a downloader that became a
    mavenResolver function; findPlatformBom documented majorMinor and a
    fieldName that no longer exists, and said it returns a version string
    rather than a platform BOM; distanceTo documented thisVersion and
    otherVersion for a single parameter named other.
    
    * camel-jbang-run, camel-azure-files: re-wrap and complete the Javadoc
    
    Two paragraphs shortened by a duplicate-word fix left room for the next
    word, which the formatter (join_lines_in_comments, comment width 120)
    would have pulled up. Both are re-wrapped as the formatter writes them.
    
    findQuarkusPlatformBom now documents download and fresh, and no longer
    claims it returns a buildTimeQuarkusVersion that does not exist: it
    returns null when the registry has no compatible platform.
    findPlatformBom gets the summary sentence it was missing, an example
    Camel version that is a real one, and a @return saying it picks the
    closest version rather than any match.
    
    * Regen
    
    ---------
    
    Co-authored-by: Guillaume Nodet <[email protected]>
---
 .../component/file/azure/FilesURIStrings.java      |  4 +--
 .../crypto/DigitalSignatureConfiguration.java      |  2 +-
 .../apache/camel/converter/crypto/HexUtils.java    |  2 +-
 .../camel/component/gson/GsonDataFormat.java       |  4 +--
 .../jackson/AbstractJacksonDataFormat.java         |  2 +-
 .../jackson3/AbstractJacksonDataFormat.java        |  2 +-
 .../component/jacksonxml/JacksonXMLDataFormat.java |  2 +-
 .../telemetry/decorators/HttpMethodHelper.java     |  2 +-
 .../support/jsse/BaseSSLContextParameters.java     |  2 +-
 .../impl/cluster/ClusteredRouteController.java     |  2 +-
 .../camel/catalog/impl/AbstractCamelCatalog.java   |  2 +-
 .../errorhandler/RedeliveryErrorHandler.java       |  2 +-
 .../ThreadsCoreAndMaxPoolKeepAliveTimeTest.java    |  2 +-
 .../camel/processor/ThreadsCoreAndMaxPoolTest.java |  2 +-
 .../camel/processor/ThreadsCorePoolTest.java       |  2 +-
 .../processor/ThreadsZeroInCoreAndMaxPoolTest.java |  2 +-
 .../management/JmxManagementLifecycleStrategy.java |  2 +-
 .../scan/DefaultPackageScanClassResolver.java      |  2 +-
 .../camel/dsl/jbang/run/common/QuarkusHelper.java  | 38 +++++++++++++---------
 .../org/apache/camel/tooling/maven/MavenGav.java   |  4 +--
 20 files changed, 44 insertions(+), 38 deletions(-)

diff --git 
a/components/camel-azure/camel-azure-files/src/main/java/org/apache/camel/component/file/azure/FilesURIStrings.java
 
b/components/camel-azure/camel-azure-files/src/main/java/org/apache/camel/component/file/azure/FilesURIStrings.java
index 27cd181a0e73..17cabac2760a 100644
--- 
a/components/camel-azure/camel-azure-files/src/main/java/org/apache/camel/component/file/azure/FilesURIStrings.java
+++ 
b/components/camel-azure/camel-azure-files/src/main/java/org/apache/camel/component/file/azure/FilesURIStrings.java
@@ -38,8 +38,8 @@ final class FilesURIStrings {
 
     /**
      * Get the base uri part before the options as they can be non URI valid 
such as the expression using $ chars and
-     * the URI constructor will regard $ as an illegal character and we don't 
want to enforce end users to to escape the
-     * $ for the expression (file language)
+     * the URI constructor will regard $ as an illegal character and we don't 
want to enforce end users to escape the $
+     * for the expression (file language)
      */
     static URI getBaseURI(String uri) throws URISyntaxException {
         String baseUri = StringHelper.before(uri, QUERY_SEPARATOR, uri);
diff --git 
a/components/camel-crypto/src/main/java/org/apache/camel/component/crypto/DigitalSignatureConfiguration.java
 
b/components/camel-crypto/src/main/java/org/apache/camel/component/crypto/DigitalSignatureConfiguration.java
index 9dd5bf58d496..5a9532b0bde9 100644
--- 
a/components/camel-crypto/src/main/java/org/apache/camel/component/crypto/DigitalSignatureConfiguration.java
+++ 
b/components/camel-crypto/src/main/java/org/apache/camel/component/crypto/DigitalSignatureConfiguration.java
@@ -189,7 +189,7 @@ public class DigitalSignatureConfiguration implements 
Cloneable, CamelContextAwa
     /**
      * Set the PrivateKey that should be used to sign the exchange
      *
-     * @param privateKey the key with with to sign the exchange.
+     * @param privateKey the key with which to sign the exchange.
      */
     public void setPrivateKey(PrivateKey privateKey) {
         this.privateKey = privateKey;
diff --git 
a/components/camel-crypto/src/main/java/org/apache/camel/converter/crypto/HexUtils.java
 
b/components/camel-crypto/src/main/java/org/apache/camel/converter/crypto/HexUtils.java
index 9beabe97f811..05a3e30039c7 100644
--- 
a/components/camel-crypto/src/main/java/org/apache/camel/converter/crypto/HexUtils.java
+++ 
b/components/camel-crypto/src/main/java/org/apache/camel/converter/crypto/HexUtils.java
@@ -61,7 +61,7 @@ public final class HexUtils {
 
     /**
      * Convert a hex string into an array of bytes. The string is expected to 
consist entirely of valid Hex characters
-     * i.e. 0123456789abcdefABCDEF. The array is calculated by traversing the 
string from from left to right, ignoring
+     * i.e. 0123456789abcdefABCDEF. The array is calculated by traversing the 
string from left to right, ignoring
      * whitespace. Every 2 valid hex chars will constitute a new byte for the 
array. If the string is uneven then it the
      * last byte will be padded with a '0'.
      *
diff --git 
a/components/camel-gson/src/main/java/org/apache/camel/component/gson/GsonDataFormat.java
 
b/components/camel-gson/src/main/java/org/apache/camel/component/gson/GsonDataFormat.java
index ec3a44b4ece5..f4e1f2d2fdc8 100644
--- 
a/components/camel-gson/src/main/java/org/apache/camel/component/gson/GsonDataFormat.java
+++ 
b/components/camel-gson/src/main/java/org/apache/camel/component/gson/GsonDataFormat.java
@@ -110,7 +110,7 @@ public class GsonDataFormat extends ServiceSupport
     }
 
     /**
-     * Use a custom Gson mapper and and unmarshal type
+     * Use a custom Gson mapper and unmarshal type
      *
      * @param gson          the custom mapper
      * @param unmarshalType the custom unmarshal type
@@ -130,7 +130,7 @@ public class GsonDataFormat extends ServiceSupport
     }
 
     /**
-     * Use a custom Gson mapper and and unmarshal token type
+     * Use a custom Gson mapper and unmarshal token type
      *
      * @param gson                 the custom mapper
      * @param unmarshalGenericType the custom unmarshal generic type
diff --git 
a/components/camel-jackson/src/main/java/org/apache/camel/component/jackson/AbstractJacksonDataFormat.java
 
b/components/camel-jackson/src/main/java/org/apache/camel/component/jackson/AbstractJacksonDataFormat.java
index 499cbe3ee778..04e490365b09 100644
--- 
a/components/camel-jackson/src/main/java/org/apache/camel/component/jackson/AbstractJacksonDataFormat.java
+++ 
b/components/camel-jackson/src/main/java/org/apache/camel/component/jackson/AbstractJacksonDataFormat.java
@@ -122,7 +122,7 @@ public abstract class AbstractJacksonDataFormat extends 
ServiceSupport
     }
 
     /**
-     * Use a custom Jackson mapper and and unmarshal type
+     * Use a custom Jackson mapper and unmarshal type
      *
      * @param mapper        the custom mapper
      * @param unmarshalType the custom unmarshal type
diff --git 
a/components/camel-jackson3/src/main/java/org/apache/camel/component/jackson3/AbstractJacksonDataFormat.java
 
b/components/camel-jackson3/src/main/java/org/apache/camel/component/jackson3/AbstractJacksonDataFormat.java
index 3735892fee59..defff8bdef4b 100644
--- 
a/components/camel-jackson3/src/main/java/org/apache/camel/component/jackson3/AbstractJacksonDataFormat.java
+++ 
b/components/camel-jackson3/src/main/java/org/apache/camel/component/jackson3/AbstractJacksonDataFormat.java
@@ -129,7 +129,7 @@ public abstract class AbstractJacksonDataFormat extends 
ServiceSupport
     }
 
     /**
-     * Use a custom Jackson mapper and and unmarshal type
+     * Use a custom Jackson mapper and unmarshal type
      *
      * @param mapper        the custom mapper
      * @param unmarshalType the custom unmarshal type
diff --git 
a/components/camel-jacksonxml/src/main/java/org/apache/camel/component/jacksonxml/JacksonXMLDataFormat.java
 
b/components/camel-jacksonxml/src/main/java/org/apache/camel/component/jacksonxml/JacksonXMLDataFormat.java
index 8f51db3f13c1..b084353acc6f 100644
--- 
a/components/camel-jacksonxml/src/main/java/org/apache/camel/component/jacksonxml/JacksonXMLDataFormat.java
+++ 
b/components/camel-jacksonxml/src/main/java/org/apache/camel/component/jacksonxml/JacksonXMLDataFormat.java
@@ -145,7 +145,7 @@ public class JacksonXMLDataFormat extends ServiceSupport
     }
 
     /**
-     * Use a custom Jackson mapper and and unmarshal type
+     * Use a custom Jackson mapper and unmarshal type
      *
      * @param mapper        the custom mapper
      * @param unmarshalType the custom unmarshal type
diff --git 
a/components/camel-telemetry/src/main/java/org/apache/camel/telemetry/decorators/HttpMethodHelper.java
 
b/components/camel-telemetry/src/main/java/org/apache/camel/telemetry/decorators/HttpMethodHelper.java
index e0e6ccc14c39..0d3d9e23d199 100644
--- 
a/components/camel-telemetry/src/main/java/org/apache/camel/telemetry/decorators/HttpMethodHelper.java
+++ 
b/components/camel-telemetry/src/main/java/org/apache/camel/telemetry/decorators/HttpMethodHelper.java
@@ -42,7 +42,7 @@ class HttpMethodHelper {
             }
         }
 
-        // try to get the httpMethod parameter from the the query string in 
the uri
+        // try to get the httpMethod parameter from the query string in the uri
         int queryIndex = endpoint.getEndpointUri().indexOf('?');
         if (queryIndex != -1) {
             String queryString = 
endpoint.getEndpointUri().substring(queryIndex + 1);
diff --git 
a/core/camel-api/src/main/java/org/apache/camel/support/jsse/BaseSSLContextParameters.java
 
b/core/camel-api/src/main/java/org/apache/camel/support/jsse/BaseSSLContextParameters.java
index cb631d24c013..ff2908a32ea4 100644
--- 
a/core/camel-api/src/main/java/org/apache/camel/support/jsse/BaseSSLContextParameters.java
+++ 
b/core/camel-api/src/main/java/org/apache/camel/support/jsse/BaseSSLContextParameters.java
@@ -1115,7 +1115,7 @@ public abstract class BaseSSLContextParameters extends 
JsseParameters {
      * patterns is not {@code null}.</li>
      * <li>Match the include patterns in {@code defaultPatterns} and don't 
match the exclude patterns in
      * {@code defaultPatterns} if patterns is {@code null} and {@code 
applyDefaults} is true.</li>
-     * <li>Are provided in currentValues if if patterns is {@code null} and 
{@code applyDefaults} is false.</li>
+     * <li>Are provided in currentValues if patterns is {@code null} and 
{@code applyDefaults} is false.</li>
      * </ol>
      *
      * @param  explicitValues  the optional explicit values to use
diff --git 
a/core/camel-cluster/src/main/java/org/apache/camel/impl/cluster/ClusteredRouteController.java
 
b/core/camel-cluster/src/main/java/org/apache/camel/impl/cluster/ClusteredRouteController.java
index 62b158581cc8..cd498ca6a86f 100644
--- 
a/core/camel-cluster/src/main/java/org/apache/camel/impl/cluster/ClusteredRouteController.java
+++ 
b/core/camel-cluster/src/main/java/org/apache/camel/impl/cluster/ClusteredRouteController.java
@@ -84,7 +84,7 @@ public class ClusteredRouteController extends 
DefaultRouteController {
     // *******************************
 
     /**
-     * Add a filter used to to filter cluster aware routes.
+     * Add a filter used to filter cluster aware routes.
      */
     public void addFilter(ClusteredRouteFilter filter) {
         this.filters.add(filter);
diff --git 
a/core/camel-core-catalog/src/main/java/org/apache/camel/catalog/impl/AbstractCamelCatalog.java
 
b/core/camel-core-catalog/src/main/java/org/apache/camel/catalog/impl/AbstractCamelCatalog.java
index 48d4c46a0e2b..c33c58ccbacf 100644
--- 
a/core/camel-core-catalog/src/main/java/org/apache/camel/catalog/impl/AbstractCamelCatalog.java
+++ 
b/core/camel-core-catalog/src/main/java/org/apache/camel/catalog/impl/AbstractCamelCatalog.java
@@ -702,7 +702,7 @@ public abstract class AbstractCamelCatalog {
                     options.put(key, word2.get(pos));
                 }
             } else {
-                // we have a little problem as we do not not have all options
+                // we have a little problem as we do not have all options
                 if (!option.isRequired()) {
                     Object value = null;
 
diff --git 
a/core/camel-core-processor/src/main/java/org/apache/camel/processor/errorhandler/RedeliveryErrorHandler.java
 
b/core/camel-core-processor/src/main/java/org/apache/camel/processor/errorhandler/RedeliveryErrorHandler.java
index 6b57ddb71fd7..0246b32f48e9 100644
--- 
a/core/camel-core-processor/src/main/java/org/apache/camel/processor/errorhandler/RedeliveryErrorHandler.java
+++ 
b/core/camel-core-processor/src/main/java/org/apache/camel/processor/errorhandler/RedeliveryErrorHandler.java
@@ -413,7 +413,7 @@ public abstract class RedeliveryErrorHandler extends 
ErrorHandlerSupport
     }
 
     protected Predicate getDefaultHandledPredicate() {
-        // Default is not not handle errors
+        // Default is to not handle errors
         return null;
     }
 
diff --git 
a/core/camel-core/src/test/java/org/apache/camel/processor/ThreadsCoreAndMaxPoolKeepAliveTimeTest.java
 
b/core/camel-core/src/test/java/org/apache/camel/processor/ThreadsCoreAndMaxPoolKeepAliveTimeTest.java
index 90dd4bf5ea86..66eaf7e90bcb 100644
--- 
a/core/camel-core/src/test/java/org/apache/camel/processor/ThreadsCoreAndMaxPoolKeepAliveTimeTest.java
+++ 
b/core/camel-core/src/test/java/org/apache/camel/processor/ThreadsCoreAndMaxPoolKeepAliveTimeTest.java
@@ -39,7 +39,7 @@ public class ThreadsCoreAndMaxPoolKeepAliveTimeTest extends 
ContextTestSupport {
             @Override
             public void configure() {
                 from("direct:start")
-                        // will use a a custom thread pool with 5 in core and 
10 as
+                        // will use a custom thread pool with 5 in core and 10 
as
                         // max
                         .threads(5, 
10).keepAliveTime(10).timeUnit(TimeUnit.SECONDS).to("mock:result");
             }
diff --git 
a/core/camel-core/src/test/java/org/apache/camel/processor/ThreadsCoreAndMaxPoolTest.java
 
b/core/camel-core/src/test/java/org/apache/camel/processor/ThreadsCoreAndMaxPoolTest.java
index a6b84e61ddc6..4219d14fe159 100644
--- 
a/core/camel-core/src/test/java/org/apache/camel/processor/ThreadsCoreAndMaxPoolTest.java
+++ 
b/core/camel-core/src/test/java/org/apache/camel/processor/ThreadsCoreAndMaxPoolTest.java
@@ -46,7 +46,7 @@ public class ThreadsCoreAndMaxPoolTest extends 
ContextTestSupport {
             @Override
             public void configure() {
                 from("direct:start")
-                        // will use a a custom thread pool with 5 in core and 
10 as
+                        // will use a custom thread pool with 5 in core and 10 
as
                         // max
                         .threads(5, 10).to("mock:result");
 
diff --git 
a/core/camel-core/src/test/java/org/apache/camel/processor/ThreadsCorePoolTest.java
 
b/core/camel-core/src/test/java/org/apache/camel/processor/ThreadsCorePoolTest.java
index ff06a5932dc3..c931c98e2fc5 100644
--- 
a/core/camel-core/src/test/java/org/apache/camel/processor/ThreadsCorePoolTest.java
+++ 
b/core/camel-core/src/test/java/org/apache/camel/processor/ThreadsCorePoolTest.java
@@ -68,7 +68,7 @@ public class ThreadsCorePoolTest extends ContextTestSupport {
                         beforeThreadName = Thread.currentThread().getName();
                     }
                 })
-                        // will use a a custom thread pool with 5 in core and 
5 as
+                        // will use a custom thread pool with 5 in core and 5 
as
                         // max
                         .threads(5).process(new Processor() {
                             public void process(Exchange exchange) {
diff --git 
a/core/camel-core/src/test/java/org/apache/camel/processor/ThreadsZeroInCoreAndMaxPoolTest.java
 
b/core/camel-core/src/test/java/org/apache/camel/processor/ThreadsZeroInCoreAndMaxPoolTest.java
index 8daa70441b3e..f89c8524df9b 100644
--- 
a/core/camel-core/src/test/java/org/apache/camel/processor/ThreadsZeroInCoreAndMaxPoolTest.java
+++ 
b/core/camel-core/src/test/java/org/apache/camel/processor/ThreadsZeroInCoreAndMaxPoolTest.java
@@ -40,7 +40,7 @@ public class ThreadsZeroInCoreAndMaxPoolTest extends 
ContextTestSupport {
             @Override
             public void configure() {
                 from("direct:start")
-                        // will use a a custom thread pool with -1 in core and 
2
+                        // will use a custom thread pool with -1 in core and 2
                         // max
                         .threads(-1, 2).to("mock:result");
             }
diff --git 
a/core/camel-management/src/main/java/org/apache/camel/management/JmxManagementLifecycleStrategy.java
 
b/core/camel-management/src/main/java/org/apache/camel/management/JmxManagementLifecycleStrategy.java
index 0ffdd7c879b6..d46bf6d411a6 100644
--- 
a/core/camel-management/src/main/java/org/apache/camel/management/JmxManagementLifecycleStrategy.java
+++ 
b/core/camel-management/src/main/java/org/apache/camel/management/JmxManagementLifecycleStrategy.java
@@ -1184,7 +1184,7 @@ public class JmxManagementLifecycleStrategy extends 
ServiceSupport implements Li
         boolean enabled = 
camelContext.getManagementStrategy().getManagementAgent().getStatisticsLevel().isDefaultOrExtended();
         pc.setStatisticsEnabled(enabled);
 
-        // and add it as a a registered counter that will be used lazy when 
Camel
+        // and add it as a registered counter that will be used lazy when Camel
         // does the instrumentation of the route and adds the 
InstrumentationProcessor
         // that does the actual performance metrics gatherings at runtime
         registeredCounters.put(processor, pc);
diff --git 
a/core/camel-support/src/main/java/org/apache/camel/support/scan/DefaultPackageScanClassResolver.java
 
b/core/camel-support/src/main/java/org/apache/camel/support/scan/DefaultPackageScanClassResolver.java
index bca4676fcc6b..5c3fa10147af 100644
--- 
a/core/camel-support/src/main/java/org/apache/camel/support/scan/DefaultPackageScanClassResolver.java
+++ 
b/core/camel-support/src/main/java/org/apache/camel/support/scan/DefaultPackageScanClassResolver.java
@@ -335,7 +335,7 @@ public class DefaultPackageScanClassResolver extends 
BasePackageScanResolver
     }
 
     /**
-     * Adds all the matching implementations from from the JAR entries to the 
classes.
+     * Adds all the matching implementations from the JAR entries to the 
classes.
      *
      * @param test    a Test used to filter the classes that are discovered
      * @param parent  the parent package under which classes must be in order 
to be considered
diff --git 
a/dsl/camel-jbang/camel-jbang-run/src/main/java/org/apache/camel/dsl/jbang/run/common/QuarkusHelper.java
 
b/dsl/camel-jbang/camel-jbang-run/src/main/java/org/apache/camel/dsl/jbang/run/common/QuarkusHelper.java
index ffb044a7e086..7f076301e336 100644
--- 
a/dsl/camel-jbang/camel-jbang-run/src/main/java/org/apache/camel/dsl/jbang/run/common/QuarkusHelper.java
+++ 
b/dsl/camel-jbang/camel-jbang-run/src/main/java/org/apache/camel/dsl/jbang/run/common/QuarkusHelper.java
@@ -62,7 +62,6 @@ import org.xml.sax.InputSource;
 import org.xml.sax.SAXException;
 
 import org.apache.camel.tooling.maven.MavenArtifact;
-import org.apache.camel.tooling.maven.MavenDownloader;
 import org.apache.camel.tooling.maven.MavenGav;
 import org.apache.camel.util.json.DeserializationException;
 import org.apache.camel.util.json.JsonArray;
@@ -134,8 +133,8 @@ public final class QuarkusHelper {
 
     /**
      * Finds the newest Quarkus platform BOM {@code g:a:v} using the same or 
newer {@code major.minor} Camel version as
-     * the specified {@code camelVersion} by searching in Quarkus platform 
registry or returns the specified
-     * {@code buildTimeQuarkusVersion} if no compatible Platform version can 
be found.
+     * the specified {@code camelVersion} by searching in Quarkus platform 
registry, or {@code null} if no compatible
+     * platform version can be found.
      * <p>
      * This is used by export/run commands to query the registry for the 
correct platform BOM version instead of using
      * the build-time constant. The registry may have a newer compatible 
version.
@@ -146,10 +145,14 @@ public final class QuarkusHelper {
      * @param  camelVersion                    if specified, the value of 
{@code --camel-version} CLI parameter or the
      *                                         Camel version of the currently 
running camel-jbang. Must not be
      *                                         {@code null}
-     * @param  quarkusExtensionRegistryBaseUri
-     * @param  downloader                      A {@link MavenDownloader} to 
use for accessing
-     * @return                                 the resolved platform BOM 
version from the registry, or the original
-     *                                         buildTimeVersion if resolution 
fails
+     * @param  mavenResolver                   resolves a Maven artifact for a 
given GAV
+     * @param  download                        whether the registry may be 
fetched over the network; {@code false} uses
+     *                                         only what is already cached
+     * @param  quarkusExtensionRegistryBaseUri base URI of the Quarkus 
platform registry
+     * @param  fresh                           ignore the cached registry 
response and the remembered Camel version
+     *                                         mapping, and ask the registry 
again
+     * @return                                 the resolved platform BOM, or 
{@code null} when the registry has no
+     *                                         compatible platform
      */
     public static QuarkusPlatformBom findQuarkusPlatformBom(
             String camelVersion,
@@ -416,11 +419,15 @@ public final class QuarkusHelper {
     }
 
     /**
+     * The platform BOM whose Camel version is closest to {@code 
wantedCamelVersion}, an exact match first; the streams
+     * are ordered by {@link MajorMinor#distanceTo} and the first one is taken.
      *
-     * @param  streams    the streams array from the registry
-     * @param  majorMinor the major.minor version to match (e.g., "3.15")
-     * @param  fieldName  the field name to extract from the release 
("version" or "quarkus-core-version")
-     * @return            the version string, or empty if not found
+     * @param  streams                         the streams array from the 
registry
+     * @param  wantedCamelVersion              the major.minor Camel version 
to match (e.g., "4.18")
+     * @param  mavenResolver                   resolves a Maven artifact for a 
given GAV
+     * @param  quarkusExtensionRegistryBaseUri base URI of the Quarkus 
platform registry
+     * @return                                 the platform BOM with the 
closest Camel version, or empty if there is
+     *                                         none
      */
     static Optional<QuarkusPlatformBom> findPlatformBom(
             JsonArray streams, MajorMinor wantedCamelVersion, 
Function<MavenGav, MavenArtifact> mavenResolver,
@@ -693,8 +700,8 @@ public final class QuarkusHelper {
          * <li>other newer major, closer is higher
          * <li>other older major, newer is higher
          * </ol>
-         * Example: for {@code thisVersion} 2.3, the distances computed for 
the following {@code otherVersion} would
-         * give the following ordering:
+         * Example: for this version 2.3, the distances computed for the 
following {@code other} would give the
+         * following ordering:
          * <ul>
          * <li>2.3 (perfect match)
          * <li>2.4 (same major, closest newer minor)
@@ -711,9 +718,8 @@ public final class QuarkusHelper {
          * <li>0.1 (even less close older major)
          * </ul>
          *
-         * @param  thisVersion
-         * @param  otherVersion
-         * @return
+         * @param  other the version to measure the distance to
+         * @return       the distance, usable as an ordering key
          */
         BigInteger distanceTo(MajorMinor other) {
             if (this.equals(other)) {
diff --git 
a/tooling/camel-tooling-maven/src/main/java/org/apache/camel/tooling/maven/MavenGav.java
 
b/tooling/camel-tooling-maven/src/main/java/org/apache/camel/tooling/maven/MavenGav.java
index cb9867b842ed..6e3b977d864d 100644
--- 
a/tooling/camel-tooling-maven/src/main/java/org/apache/camel/tooling/maven/MavenGav.java
+++ 
b/tooling/camel-tooling-maven/src/main/java/org/apache/camel/tooling/maven/MavenGav.java
@@ -172,8 +172,8 @@ public final class MavenGav {
     }
 
     /**
-     * @param  gav {@code 
<groupId>:<artifactId>[:<extension>[:<classifier>]]:<version>}
-     * @return     a new {@link MavenGav}
+     * @param  gaecv {@code 
<groupId>:<artifactId>[:<extension>[:<classifier>]]:<version>}
+     * @return       a new {@link MavenGav}
      */
     public static MavenGav parseMavenResolverString(String gaecv) {
         String[] parts = gaecv.split(":");

Reply via email to