You are viewing a plain text version of this content. The canonical link for it is here.
Posted to site-commits@maven.apache.org by hb...@apache.org on 2024/03/02 16:38:15 UTC
svn commit: r1916078 [2/2] - in /maven/website/components/plugins-archives/maven-toolchains-plugin-LATEST: ./ apidocs/ toolchains/
Modified: maven/website/components/plugins-archives/maven-toolchains-plugin-LATEST/team.html
==============================================================================
--- maven/website/components/plugins-archives/maven-toolchains-plugin-LATEST/team.html (original)
+++ maven/website/components/plugins-archives/maven-toolchains-plugin-LATEST/team.html Sat Mar 2 16:38:15 2024
@@ -2,7 +2,7 @@
<!--
- | Generated by Apache Maven Doxia Site Renderer 1.11.1 from org.apache.maven.plugins:maven-project-info-reports-plugin:3.4.5:team at 2024-02-29
+ | Generated by Apache Maven Doxia Site Renderer 1.11.1 from org.apache.maven.plugins:maven-project-info-reports-plugin:3.4.5:team at 2024-03-02
| Rendered using Apache Maven Fluido Skin 1.11.2
-->
<html xmlns="http://www.w3.org/1999/xhtml" lang="en">
@@ -49,7 +49,7 @@
<li><a href="../index.html" title="Plugins">Plugins</a><span class="divider">/</span></li>
<li><a href="index.html" title="Apache Maven Toolchains Plugin">Apache Maven Toolchains Plugin</a><span class="divider">/</span></li>
<li class="active ">Project Team</li>
- <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2024-02-29</li>
+ <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2024-03-02</li>
<li id="projectVersion" class="pull-right">Version: 3.1.1-SNAPSHOT</li>
</ul>
</div>
@@ -60,14 +60,18 @@
<ul class="nav nav-list">
<li class="nav-header">Overview</li>
<li><a href="index.html" title="Introduction"><span class="none"></span>Introduction</a></li>
- <li><a href="plugin-info.html" title="Goals"><span class="none"></span>Goals</a></li>
- <li><a href="usage.html" title="Usage"><span class="none"></span>Usage</a></li>
- <li><a href="http://www.apache.org/licenses/" class="externalLink" title="License"><span class="none"></span>License</a></li>
+ <li><a href="plugin-info.html" title="Goals"><span class="icon-chevron-down"></span>Goals</a>
+ <ul class="nav nav-list">
+ <li><a href="toolchain-mojo.html" title="toolchains:toolchain"><span class="none"></span>toolchains:toolchain</a></li>
+ </ul></li>
+ <li><a href="usage.html" title="Usage"><span class="icon-chevron-down"></span>Usage</a>
+ <ul class="nav nav-list">
+ <li><a href="toolchains/index.html" title="Standard Toolchains"><span class="none"></span>Standard Toolchains</a></li>
+ <li><a href="toolchains/jdk.html" title="JDK Standard Toolchain"><span class="none"></span>JDK Standard Toolchain</a></li>
+ <li><a href="toolchains/custom.html" title="Custom Toolchains"><span class="none"></span>Custom Toolchains</a></li>
+ </ul></li>
+ <li><a href="https://www.apache.org/licenses/" class="externalLink" title="License"><span class="none"></span>License</a></li>
<li><a href="download.html" title="Download"><span class="none"></span>Download</a></li>
- <li class="nav-header">Toolchains</li>
- <li><a href="toolchains/index.html" title="Standard Toolchains"><span class="none"></span>Standard Toolchains</a></li>
- <li><a href="toolchains/jdk.html" title="JDK Standard Toolchain"><span class="none"></span>JDK Standard Toolchain</a></li>
- <li><a href="toolchains/custom.html" title="Custom Toolchains"><span class="none"></span>Custom Toolchains</a></li>
<li class="nav-header">Project Documentation</li>
<li><a href="project-info.html" title="Project Information"><span class="icon-chevron-down"></span>Project Information</a>
<ul class="nav nav-list">
Modified: maven/website/components/plugins-archives/maven-toolchains-plugin-LATEST/toolchain-mojo.html
==============================================================================
--- maven/website/components/plugins-archives/maven-toolchains-plugin-LATEST/toolchain-mojo.html (original)
+++ maven/website/components/plugins-archives/maven-toolchains-plugin-LATEST/toolchain-mojo.html Sat Mar 2 16:38:15 2024
@@ -2,7 +2,7 @@
<!--
- | Generated by Apache Maven Doxia Site Renderer 1.11.1 from org.apache.maven.plugins:maven-plugin-report-plugin:3.10.2:report at 2024-02-29
+ | Generated by Apache Maven Doxia Site Renderer 1.11.1 from org.apache.maven.plugins:maven-plugin-report-plugin:3.10.2:report at 2024-03-02
| Rendered using Apache Maven Fluido Skin 1.11.2
-->
<html xmlns="http://www.w3.org/1999/xhtml" lang="en">
@@ -49,7 +49,7 @@
<li><a href="../index.html" title="Plugins">Plugins</a><span class="divider">/</span></li>
<li><a href="index.html" title="Apache Maven Toolchains Plugin">Apache Maven Toolchains Plugin</a><span class="divider">/</span></li>
<li class="active ">toolchains:toolchain</li>
- <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2024-02-29</li>
+ <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2024-03-02</li>
<li id="projectVersion" class="pull-right">Version: 3.1.1-SNAPSHOT</li>
</ul>
</div>
@@ -60,14 +60,18 @@
<ul class="nav nav-list">
<li class="nav-header">Overview</li>
<li><a href="index.html" title="Introduction"><span class="none"></span>Introduction</a></li>
- <li><a href="plugin-info.html" title="Goals"><span class="none"></span>Goals</a></li>
- <li><a href="usage.html" title="Usage"><span class="none"></span>Usage</a></li>
- <li><a href="http://www.apache.org/licenses/" class="externalLink" title="License"><span class="none"></span>License</a></li>
+ <li><a href="plugin-info.html" title="Goals"><span class="icon-chevron-down"></span>Goals</a>
+ <ul class="nav nav-list">
+ <li class="active"><a><span class="none"></span>toolchains:toolchain</a></li>
+ </ul></li>
+ <li><a href="usage.html" title="Usage"><span class="icon-chevron-down"></span>Usage</a>
+ <ul class="nav nav-list">
+ <li><a href="toolchains/index.html" title="Standard Toolchains"><span class="none"></span>Standard Toolchains</a></li>
+ <li><a href="toolchains/jdk.html" title="JDK Standard Toolchain"><span class="none"></span>JDK Standard Toolchain</a></li>
+ <li><a href="toolchains/custom.html" title="Custom Toolchains"><span class="none"></span>Custom Toolchains</a></li>
+ </ul></li>
+ <li><a href="https://www.apache.org/licenses/" class="externalLink" title="License"><span class="none"></span>License</a></li>
<li><a href="download.html" title="Download"><span class="none"></span>Download</a></li>
- <li class="nav-header">Toolchains</li>
- <li><a href="toolchains/index.html" title="Standard Toolchains"><span class="none"></span>Standard Toolchains</a></li>
- <li><a href="toolchains/jdk.html" title="JDK Standard Toolchain"><span class="none"></span>JDK Standard Toolchain</a></li>
- <li><a href="toolchains/custom.html" title="Custom Toolchains"><span class="none"></span>Custom Toolchains</a></li>
<li class="nav-header">Project Documentation</li>
<li><a href="project-info.html" title="Project Information"><span class="icon-chevron-right"></span>Project Information</a></li>
<li><a href="project-reports.html" title="Project Reports"><span class="icon-chevron-right"></span>Project Reports</a></li>
Modified: maven/website/components/plugins-archives/maven-toolchains-plugin-LATEST/toolchains/custom.html
==============================================================================
--- maven/website/components/plugins-archives/maven-toolchains-plugin-LATEST/toolchains/custom.html (original)
+++ maven/website/components/plugins-archives/maven-toolchains-plugin-LATEST/toolchains/custom.html Sat Mar 2 16:38:15 2024
@@ -2,7 +2,7 @@
<!--
- | Generated by Apache Maven Doxia Site Renderer 1.11.1 from src/site/apt/toolchains/custom.apt at 2024-02-29
+ | Generated by Apache Maven Doxia Site Renderer 1.11.1 from src/site/apt/toolchains/custom.apt at 2024-03-02
| Rendered using Apache Maven Fluido Skin 1.11.2
-->
<html xmlns="http://www.w3.org/1999/xhtml" lang="en">
@@ -51,7 +51,7 @@
<li><a href="../../index.html" title="Plugins">Plugins</a><span class="divider">/</span></li>
<li><a href="../index.html" title="Apache Maven Toolchains Plugin">Apache Maven Toolchains Plugin</a><span class="divider">/</span></li>
<li class="active ">Custom Toolchains <a href="https://github.com/apache/maven-toolchains-plugin/tree/HEAD/src/site/apt/toolchains/custom.apt"><img src="../images/accessories-text-editor.png" title="Edit" /></a></li>
- <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2024-02-29</li>
+ <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2024-03-02</li>
<li id="projectVersion" class="pull-right">Version: 3.1.1-SNAPSHOT</li>
</ul>
</div>
@@ -62,14 +62,18 @@
<ul class="nav nav-list">
<li class="nav-header">Overview</li>
<li><a href="../index.html" title="Introduction"><span class="none"></span>Introduction</a></li>
- <li><a href="../plugin-info.html" title="Goals"><span class="none"></span>Goals</a></li>
- <li><a href="../usage.html" title="Usage"><span class="none"></span>Usage</a></li>
- <li><a href="http://www.apache.org/licenses/" class="externalLink" title="License"><span class="none"></span>License</a></li>
+ <li><a href="../plugin-info.html" title="Goals"><span class="icon-chevron-down"></span>Goals</a>
+ <ul class="nav nav-list">
+ <li><a href="../toolchain-mojo.html" title="toolchains:toolchain"><span class="none"></span>toolchains:toolchain</a></li>
+ </ul></li>
+ <li><a href="../usage.html" title="Usage"><span class="icon-chevron-down"></span>Usage</a>
+ <ul class="nav nav-list">
+ <li><a href="../toolchains/index.html" title="Standard Toolchains"><span class="none"></span>Standard Toolchains</a></li>
+ <li><a href="../toolchains/jdk.html" title="JDK Standard Toolchain"><span class="none"></span>JDK Standard Toolchain</a></li>
+ <li class="active"><a><span class="none"></span>Custom Toolchains</a></li>
+ </ul></li>
+ <li><a href="https://www.apache.org/licenses/" class="externalLink" title="License"><span class="none"></span>License</a></li>
<li><a href="../download.html" title="Download"><span class="none"></span>Download</a></li>
- <li class="nav-header">Toolchains</li>
- <li><a href="../toolchains/index.html" title="Standard Toolchains"><span class="none"></span>Standard Toolchains</a></li>
- <li><a href="../toolchains/jdk.html" title="JDK Standard Toolchain"><span class="none"></span>JDK Standard Toolchain</a></li>
- <li class="active"><a><span class="none"></span>Custom Toolchains</a></li>
<li class="nav-header">Project Documentation</li>
<li><a href="../project-info.html" title="Project Information"><span class="icon-chevron-right"></span>Project Information</a></li>
<li><a href="../project-reports.html" title="Project Reports"><span class="icon-chevron-right"></span>Project Reports</a></li>
@@ -121,7 +125,7 @@
<li>see <code>src/it/setup-custom-toolchain</code> for the custom toolchain and plugin,</li>
<li>see <code>src/it/use-custom-toolchain</code> for a sample project using the toolchain through its plugin.</li></ul>
<p>Following instructions are explanations of key points of the sample.</p><section>
-<h3><a name="Creating_Custom_Toolchain"></a>Creating Custom Toolchain</h3>
+<h3><a name="Creating_a_Custom_Toolchain"></a>Creating a Custom Toolchain</h3>
<p>A toolchain consists in:</p>
<ul>
<li>an interface extending <a href="/ref/current/maven-core/apidocs/org/apache/maven/toolchain/Toolchain.html"><code>org.apache.maven.toolchain.Toolchain</code></a>,</li>
@@ -132,7 +136,7 @@
<div class="source"><pre class="prettyprint linenums"> @Component
private ToolchainManager toolchainManager;
- @Parameter( defaultValue = "${session}", required = true, readonly = true )
+ @Component
private MavenSession session;
public void execute()
Modified: maven/website/components/plugins-archives/maven-toolchains-plugin-LATEST/toolchains/index.html
==============================================================================
--- maven/website/components/plugins-archives/maven-toolchains-plugin-LATEST/toolchains/index.html (original)
+++ maven/website/components/plugins-archives/maven-toolchains-plugin-LATEST/toolchains/index.html Sat Mar 2 16:38:15 2024
@@ -2,7 +2,7 @@
<!--
- | Generated by Apache Maven Doxia Site Renderer 1.11.1 from src/site/apt/toolchains/index.apt at 2024-02-29
+ | Generated by Apache Maven Doxia Site Renderer 1.11.1 from src/site/apt/toolchains/index.apt at 2024-03-02
| Rendered using Apache Maven Fluido Skin 1.11.2
-->
<html xmlns="http://www.w3.org/1999/xhtml" lang="en">
@@ -51,7 +51,7 @@
<li><a href="../../index.html" title="Plugins">Plugins</a><span class="divider">/</span></li>
<li><a href="../index.html" title="Apache Maven Toolchains Plugin">Apache Maven Toolchains Plugin</a><span class="divider">/</span></li>
<li class="active ">Standard Toolchains <a href="https://github.com/apache/maven-toolchains-plugin/tree/HEAD/src/site/apt/toolchains/index.apt"><img src="../images/accessories-text-editor.png" title="Edit" /></a></li>
- <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2024-02-29</li>
+ <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2024-03-02</li>
<li id="projectVersion" class="pull-right">Version: 3.1.1-SNAPSHOT</li>
</ul>
</div>
@@ -62,14 +62,18 @@
<ul class="nav nav-list">
<li class="nav-header">Overview</li>
<li><a href="../index.html" title="Introduction"><span class="none"></span>Introduction</a></li>
- <li><a href="../plugin-info.html" title="Goals"><span class="none"></span>Goals</a></li>
- <li><a href="../usage.html" title="Usage"><span class="none"></span>Usage</a></li>
- <li><a href="http://www.apache.org/licenses/" class="externalLink" title="License"><span class="none"></span>License</a></li>
+ <li><a href="../plugin-info.html" title="Goals"><span class="icon-chevron-down"></span>Goals</a>
+ <ul class="nav nav-list">
+ <li><a href="../toolchain-mojo.html" title="toolchains:toolchain"><span class="none"></span>toolchains:toolchain</a></li>
+ </ul></li>
+ <li><a href="../usage.html" title="Usage"><span class="icon-chevron-down"></span>Usage</a>
+ <ul class="nav nav-list">
+ <li class="active"><a><span class="none"></span>Standard Toolchains</a></li>
+ <li><a href="../toolchains/jdk.html" title="JDK Standard Toolchain"><span class="none"></span>JDK Standard Toolchain</a></li>
+ <li><a href="../toolchains/custom.html" title="Custom Toolchains"><span class="none"></span>Custom Toolchains</a></li>
+ </ul></li>
+ <li><a href="https://www.apache.org/licenses/" class="externalLink" title="License"><span class="none"></span>License</a></li>
<li><a href="../download.html" title="Download"><span class="none"></span>Download</a></li>
- <li class="nav-header">Toolchains</li>
- <li class="active"><a><span class="none"></span>Standard Toolchains</a></li>
- <li><a href="../toolchains/jdk.html" title="JDK Standard Toolchain"><span class="none"></span>JDK Standard Toolchain</a></li>
- <li><a href="../toolchains/custom.html" title="Custom Toolchains"><span class="none"></span>Custom Toolchains</a></li>
<li class="nav-header">Project Documentation</li>
<li><a href="../project-info.html" title="Project Information"><span class="icon-chevron-right"></span>Project Information</a></li>
<li><a href="../project-reports.html" title="Project Reports"><span class="icon-chevron-right"></span>Project Reports</a></li>
Modified: maven/website/components/plugins-archives/maven-toolchains-plugin-LATEST/toolchains/jdk.html
==============================================================================
--- maven/website/components/plugins-archives/maven-toolchains-plugin-LATEST/toolchains/jdk.html (original)
+++ maven/website/components/plugins-archives/maven-toolchains-plugin-LATEST/toolchains/jdk.html Sat Mar 2 16:38:15 2024
@@ -2,7 +2,7 @@
<!--
- | Generated by Apache Maven Doxia Site Renderer 1.11.1 from src/site/apt/toolchains/jdk.apt.vm at 2024-02-29
+ | Generated by Apache Maven Doxia Site Renderer 1.11.1 from src/site/apt/toolchains/jdk.apt.vm at 2024-03-02
| Rendered using Apache Maven Fluido Skin 1.11.2
-->
<html xmlns="http://www.w3.org/1999/xhtml" lang="en">
@@ -51,7 +51,7 @@
<li><a href="../../index.html" title="Plugins">Plugins</a><span class="divider">/</span></li>
<li><a href="../index.html" title="Apache Maven Toolchains Plugin">Apache Maven Toolchains Plugin</a><span class="divider">/</span></li>
<li class="active ">JDK Toolchain <a href="https://github.com/apache/maven-toolchains-plugin/tree/HEAD/src/site/apt/toolchains/jdk.apt.vm"><img src="../images/accessories-text-editor.png" title="Edit" /></a></li>
- <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2024-02-29</li>
+ <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2024-03-02</li>
<li id="projectVersion" class="pull-right">Version: 3.1.1-SNAPSHOT</li>
</ul>
</div>
@@ -62,14 +62,18 @@
<ul class="nav nav-list">
<li class="nav-header">Overview</li>
<li><a href="../index.html" title="Introduction"><span class="none"></span>Introduction</a></li>
- <li><a href="../plugin-info.html" title="Goals"><span class="none"></span>Goals</a></li>
- <li><a href="../usage.html" title="Usage"><span class="none"></span>Usage</a></li>
- <li><a href="http://www.apache.org/licenses/" class="externalLink" title="License"><span class="none"></span>License</a></li>
+ <li><a href="../plugin-info.html" title="Goals"><span class="icon-chevron-down"></span>Goals</a>
+ <ul class="nav nav-list">
+ <li><a href="../toolchain-mojo.html" title="toolchains:toolchain"><span class="none"></span>toolchains:toolchain</a></li>
+ </ul></li>
+ <li><a href="../usage.html" title="Usage"><span class="icon-chevron-down"></span>Usage</a>
+ <ul class="nav nav-list">
+ <li><a href="../toolchains/index.html" title="Standard Toolchains"><span class="none"></span>Standard Toolchains</a></li>
+ <li class="active"><a><span class="none"></span>JDK Standard Toolchain</a></li>
+ <li><a href="../toolchains/custom.html" title="Custom Toolchains"><span class="none"></span>Custom Toolchains</a></li>
+ </ul></li>
+ <li><a href="https://www.apache.org/licenses/" class="externalLink" title="License"><span class="none"></span>License</a></li>
<li><a href="../download.html" title="Download"><span class="none"></span>Download</a></li>
- <li class="nav-header">Toolchains</li>
- <li><a href="../toolchains/index.html" title="Standard Toolchains"><span class="none"></span>Standard Toolchains</a></li>
- <li class="active"><a><span class="none"></span>JDK Standard Toolchain</a></li>
- <li><a href="../toolchains/custom.html" title="Custom Toolchains"><span class="none"></span>Custom Toolchains</a></li>
<li class="nav-header">Project Documentation</li>
<li><a href="../project-info.html" title="Project Information"><span class="icon-chevron-right"></span>Project Information</a></li>
<li><a href="../project-reports.html" title="Project Reports"><span class="icon-chevron-right"></span>Project Reports</a></li>
@@ -119,32 +123,28 @@
<p>The toolchain type id for JDK is "<code>jdk</code>".</p>
<p>Predefined identification tokens, for requirement matching, are:</p>
<ul>
-<li>"<code>version</code>" marks the version of the jdk. Maven Toolchains Plugin can match against a single version or any version ranges,</li>
-<li>any other tokens will be accepted, but only exact matches are supported.</li></ul></section><section>
+<li>"<code>version</code>" marks the version of the JDK. This can be either a single version or a version range.</li>
+<li>Other tokens are accepted, but only exact matches are supported.</li></ul></section><section>
<h3><a name="Toolchain_Configuration"></a>Toolchain Configuration</h3>
-<p>There is only one configuration element named "<code>jdkHome</code>". It designates the root directory of JDK installation.</p></section><section>
+<p>There is only one configuration element named "<code>jdkHome</code>". It designates the root directory of a JDK installation.</p></section><section>
<h3><a name="Sample_toolchains.xml_setup"></a>Sample <code>toolchains.xml</code> setup</h3>
<div class="source"><pre class="prettyprint linenums"><toolchains>
<toolchain>
<type>jdk</type>
<provides>
- <version>1.5</version>
- <vendor>sun</vendor>
- <id>for_mevenide</id>
+ <version>11</version>
+ <vendor>temurin</vendor>
+ <purpose>for_mevenide</purpose>
</provides>
<configuration>
- <jdkHome>/home/mkleint/javatools/jdk</jdkHome>
+ <jdkHome>/Library/Java/JavaVirtualMachines/temurin-11.jdk/Contents/Home</jdkHome>
</configuration>
</toolchain>
[...]
-</toolchains></pre></div></section><section>
-<h3><a name="Toolchains_Plugin_Configuration"></a>Toolchains Plugin Configuration</h3>
-<p>For selection of toolchain for use by the project, the following conditions are matched against the definitions in the <code>toolchains.xml</code> file:</p>
-<ul>
-<li>"<code>version</code>" which accepts any <a href="/enforcer/enforcer-rules/versionRanges.html">version range definitions</a>. Version declared by the toolchain needs to fit into the range,</li>
-<li>any other tokens needs exact match. Toolchain not providing such token will not be selected.</li></ul>
-<p>All conditions need to be satisfied in a sucessfully matched toolchain.</p></section><section>
-<h3><a name="Sample_Plugin_Configuration"></a>Sample Plugin Configuration</h3>
+</toolchains></pre></div></section></section><section>
+<h2><a name="This_defines_a_toolchain_with_version_11.2C_vendor_.22temurin.22.2C_and_purpose_.22for_mevenide.22._A_project_can_request_this_toolchain_by_specifying_the_type_.22jdk.22_and_the_version_.2211.22._It_can_also_use_a_version_range_that_includes_11_like_.5B8.2C_17.5D._It_can_also_ask_for_the_vendor_temurin.2C_with_or_without_version.2C_or_the_purpose_.22for_mevenide.22."></a>This defines a toolchain with version 11, vendor "temurin", and purpose "for_mevenide". A project can request this toolchain by specifying the type "jdk" and the version "11". It can also use a version range that includes 11 like [8, 17]. It can also ask for the vendor temurin, with or without version, or the purpose "for_mevenide". </h2><section>
+<h3><a name="Toolchains_Plugin_Configuration"></a>Toolchains Plugin Configuration</h3></section></section><section>
+<h2><a name="A_project_specifies_a_toolchain_in_the_configuraiton_of_the_maven-toolchains-plugin_like_so:"></a>A project specifies a toolchain in the configuraiton of the maven-toolchains-plugin like so: </h2>
<div class="source"><pre class="prettyprint linenums"><project>
[...]
<build>
@@ -163,7 +163,7 @@
<configuration>
<toolchains>
<jdk>
- <version>[1.5,)</version>
+ <version>[1.8,)</version>
</jdk>
</toolchains>
</configuration>
@@ -171,7 +171,18 @@
</plugins>
</build>
[...]
-</project></pre></div></section></section>
+</project></pre></div></section><section>
+<h2><a name="In_this_example.2C_the_project_is_requesting_any_toolchain_with_type_jdk_that_has_a_version_of_1.8_or_greater._.22version.22_accepts_any_version_range_definitions._If_you_want_exactly_JDK_1.8_from_the_vendor_temurin.2C_the_plugin_would_be_configured_like_this:"></a>In this example, the project is requesting any toolchain with type jdk that has a version of 1.8 or greater. "<code>version</code>" accepts any <a href="/enforcer/enforcer-rules/versionRanges.html">version range definitions</a>. If you want exactly JDK 1.8 from the vendor temurin, the plugin would be configured like this:</h2>
+<div class="source"><pre class="prettyprint linenums"> <configuration>
+ <toolchains>
+ <jdk>
+ <version>1.8</version>
+ <vendor>temurin</vendor>
+ </jdk>
+ </toolchains>
+ </configuration></pre></div></section><section>
+<h2><a name="Aside_from_version.2C_the_definitions_are_opaque_strings._Maven_looks_in_toolchains.xml_for_a_toolchain_that_provides_version.3D.3D.221.8.22_and_vendor.3D.3D.22temurin.22._It_does_not_know_or_care_what_these_strings_mean._It_does_not.2C_for_instance.2C_concern_itself_with_whether_the_jdkHome_configured_by_the_toolchain_that_satisfies_version.3D.3D.221.8.22_and_vendor.3D.3D.22temurin.22_is_JDK_8_from_the_Temurin_project.2C_or_JDK_21_from_Oracle._It_might_not_even_exist."></a>Aside from version, the definitions are opaque strings. Maven looks in toolchains.xml for a toolchain that provides version=="1.8" and vendor=="temurin". It does not know or care what these strings mean. It does not, for instance, concern itself with whether the jdkHome configured by the toolchain that satisfies version=="1.8" and vendor=="temurin" is JDK 8 from the Temurin project, or JDK 21 from Oracle. It might not even exist.</h2></section><section>
+<h2><a name="All_conditions_need_to_be_satisfied_to_find_a_toolchain."></a>All conditions need to be satisfied to find a toolchain.</h2></section>
</main>
</div>
</div>
Modified: maven/website/components/plugins-archives/maven-toolchains-plugin-LATEST/usage.html
==============================================================================
--- maven/website/components/plugins-archives/maven-toolchains-plugin-LATEST/usage.html (original)
+++ maven/website/components/plugins-archives/maven-toolchains-plugin-LATEST/usage.html Sat Mar 2 16:38:15 2024
@@ -2,7 +2,7 @@
<!--
- | Generated by Apache Maven Doxia Site Renderer 1.11.1 from src/site/apt/usage.apt.vm at 2024-02-29
+ | Generated by Apache Maven Doxia Site Renderer 1.11.1 from src/site/apt/usage.apt.vm at 2024-03-02
| Rendered using Apache Maven Fluido Skin 1.11.2
-->
<html xmlns="http://www.w3.org/1999/xhtml" lang="en">
@@ -52,7 +52,7 @@ Dennis Lundberg" />
<li><a href="../index.html" title="Plugins">Plugins</a><span class="divider">/</span></li>
<li><a href="index.html" title="Apache Maven Toolchains Plugin">Apache Maven Toolchains Plugin</a><span class="divider">/</span></li>
<li class="active ">Usage <a href="https://github.com/apache/maven-toolchains-plugin/tree/HEAD/src/site/apt/usage.apt.vm"><img src="./images/accessories-text-editor.png" title="Edit" /></a></li>
- <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2024-02-29</li>
+ <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2024-03-02</li>
<li id="projectVersion" class="pull-right">Version: 3.1.1-SNAPSHOT</li>
</ul>
</div>
@@ -63,14 +63,18 @@ Dennis Lundberg" />
<ul class="nav nav-list">
<li class="nav-header">Overview</li>
<li><a href="index.html" title="Introduction"><span class="none"></span>Introduction</a></li>
- <li><a href="plugin-info.html" title="Goals"><span class="none"></span>Goals</a></li>
- <li class="active"><a><span class="none"></span>Usage</a></li>
- <li><a href="http://www.apache.org/licenses/" class="externalLink" title="License"><span class="none"></span>License</a></li>
+ <li><a href="plugin-info.html" title="Goals"><span class="icon-chevron-down"></span>Goals</a>
+ <ul class="nav nav-list">
+ <li><a href="toolchain-mojo.html" title="toolchains:toolchain"><span class="none"></span>toolchains:toolchain</a></li>
+ </ul></li>
+ <li class="active"><a><span class="icon-chevron-down"></span>Usage</a>
+ <ul class="nav nav-list">
+ <li><a href="toolchains/index.html" title="Standard Toolchains"><span class="none"></span>Standard Toolchains</a></li>
+ <li><a href="toolchains/jdk.html" title="JDK Standard Toolchain"><span class="none"></span>JDK Standard Toolchain</a></li>
+ <li><a href="toolchains/custom.html" title="Custom Toolchains"><span class="none"></span>Custom Toolchains</a></li>
+ </ul></li>
+ <li><a href="https://www.apache.org/licenses/" class="externalLink" title="License"><span class="none"></span>License</a></li>
<li><a href="download.html" title="Download"><span class="none"></span>Download</a></li>
- <li class="nav-header">Toolchains</li>
- <li><a href="toolchains/index.html" title="Standard Toolchains"><span class="none"></span>Standard Toolchains</a></li>
- <li><a href="toolchains/jdk.html" title="JDK Standard Toolchain"><span class="none"></span>JDK Standard Toolchain</a></li>
- <li><a href="toolchains/custom.html" title="Custom Toolchains"><span class="none"></span>Custom Toolchains</a></li>
<li class="nav-header">Project Documentation</li>
<li><a href="project-info.html" title="Project Information"><span class="icon-chevron-right"></span>Project Information</a></li>
<li><a href="project-reports.html" title="Project Reports"><span class="icon-chevron-right"></span>Project Reports</a></li>