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

slachiewicz pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/maven-site.git


The following commit(s) were added to refs/heads/master by this push:
     new 3fa0d011 Say how setup-java and generate-jdk-toolchains-xml label JDK 
toolchains
3fa0d011 is described below

commit 3fa0d01154c8ed36413ec800f331ab81ccc5760d
Author: Sylwester Lachiewicz <[email protected]>
AuthorDate: Wed Nov 4 12:42:24 2026 +0000

    Say how setup-java and generate-jdk-toolchains-xml label JDK toolchains
    
    actions/setup-java writes the java-version input (17, 8) and the
    distribution as vendor; generate-jdk-toolchains-xml writes java.version
    and java.vendor. Vendor matching ignores case.
---
 content/markdown/guides/mini/guide-using-toolchains.md | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/content/markdown/guides/mini/guide-using-toolchains.md 
b/content/markdown/guides/mini/guide-using-toolchains.md
index 9b34b934..864382ac 100644
--- a/content/markdown/guides/mini/guide-using-toolchains.md
+++ b/content/markdown/guides/mini/guide-using-toolchains.md
@@ -153,7 +153,8 @@ Predefined `<provides>` identification tokens, for 
requirement matching in plugi
 
 - `version` marks the version of the JDK in `toolchains.xml`. In the plugin 
configuration, this can be either a single version or a [version 
range](/enforcer/enforcer-rules/versionRanges.html).
   A single version must equal the one in `toolchains.xml`: `17` does not match 
a toolchain that provides `17.0.20`, and neither `8` nor `1.8` matches 
`1.8.0_504`. To accept such toolchains, use a range like `[17,18)` or 
`[1.8,1.9)`.
-- Other tokens, such as `vendor`, are accepted, but only exact matches are 
supported.
+  How the version is written depends on what wrote the entry: 
`toolchains:generate-jdk-toolchains-xml` writes the JDK's full version, such as 
`17.0.20` or `1.8.0_504`, while `actions/setup-java` on GitHub Actions writes 
its `java-version` input as given, such as `17` or `8`. `[17,18)` matches both 
`17` and `17.0.20`; for Java 8, `[8,9)` matches `8` and `[1.8,1.9)` matches 
`1.8.0_504`.
+- Other tokens, such as `vendor`, are accepted, but only exact matches are 
supported; case is ignored. `actions/setup-java` writes the distribution name, 
such as `temurin`, as the vendor, and `toolchains:generate-jdk-toolchains-xml` 
writes the JDK's `java.vendor` property.
 
 In `toolchains.xml`, the only child of the `<configuration>` element is 
`jdkHome`. It designates the root directory of a JDK installation.
 

Reply via email to