Author: hboutemy
Date: Sat Mar 2 16:47:43 2024
New Revision: 1916080
Log:
Site checkin for project Apache Maven Toolchains Plugin
Modified:
maven/website/components/plugins-archives/maven-toolchains-plugin-LATEST/apidocs/member-search-index.zip
maven/website/components/plugins-archives/maven-toolchains-plugin-LATEST/apidocs/package-search-index.zip
maven/website/components/plugins-archives/maven-toolchains-plugin-LATEST/apidocs/type-search-index.zip
maven/website/components/plugins-archives/maven-toolchains-plugin-LATEST/toolchains/jdk.html
Modified:
maven/website/components/plugins-archives/maven-toolchains-plugin-LATEST/apidocs/member-search-index.zip
==============================================================================
Binary files - no diff available.
Modified:
maven/website/components/plugins-archives/maven-toolchains-plugin-LATEST/apidocs/package-search-index.zip
==============================================================================
Binary files - no diff available.
Modified:
maven/website/components/plugins-archives/maven-toolchains-plugin-LATEST/apidocs/type-search-index.zip
==============================================================================
Binary files - no diff available.
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:47:43 2024
@@ -141,8 +141,8 @@
</configuration>
</toolchain>
[...]
-</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>
+</toolchains></pre></div>
+<p>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".</p></section><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>
@@ -171,8 +171,8 @@
</plugins>
</build>
[...]
-</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>
+</project></pre></div>
+<p>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:</p>
<div class="source"><pre class="prettyprint linenums">
<configuration>
<toolchains>
<jdk>
@@ -180,9 +180,9 @@
<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>
+ </configuration></pre></div>
+<p>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.</p>
+<p>All conditions need to be satisfied to find a toolchain.</p></section>
</main>
</div>
</div>