Author: hboutemy
Date: Sun Nov 9 13:41:01 2014
New Revision: 928497
Log:
Site checkin for project Apache Maven Toolchains Plugin
Modified:
websites/production/maven/content/plugins-archives/maven-toolchains-plugin-LATEST/invoker-report.html
websites/production/maven/content/plugins-archives/maven-toolchains-plugin-LATEST/toolchains/custom.html
Modified:
websites/production/maven/content/plugins-archives/maven-toolchains-plugin-LATEST/invoker-report.html
==============================================================================
---
websites/production/maven/content/plugins-archives/maven-toolchains-plugin-LATEST/invoker-report.html
(original)
+++
websites/production/maven/content/plugins-archives/maven-toolchains-plugin-LATEST/invoker-report.html
Sun Nov 9 13:41:01 2014
@@ -209,8 +209,8 @@
<td>0</td>
<td>0</td>
<td>100.0%</td>
-<td>12.2 s</td>
-<td>4.1 s</td></tr></table>
+<td>11.7 s</td>
+<td>3.9 s</td></tr></table>
<div class="section">
<h3><a name="Build_Details"></a>Build Details</h3></div>
<table border="0" class="bodyTable">
@@ -222,17 +222,17 @@
<tr class="b">
<td>custom-toolchain-plugin/pom.xml</td>
<td>success</td>
-<td>7.1 s</td>
+<td>6.4 s</td>
<td></td></tr>
<tr class="a">
<td>missing-toolchain/pom.xml</td>
<td>success</td>
-<td>2.5 s</td>
+<td>2.4 s</td>
<td></td></tr>
<tr class="b">
<td>use-custom-toolchain/pom.xml</td>
<td>success</td>
-<td>2.7 s</td>
+<td>2.8 s</td>
<td></td></tr></table>
</div>
</div>
Modified:
websites/production/maven/content/plugins-archives/maven-toolchains-plugin-LATEST/toolchains/custom.html
==============================================================================
---
websites/production/maven/content/plugins-archives/maven-toolchains-plugin-LATEST/toolchains/custom.html
(original)
+++
websites/production/maven/content/plugins-archives/maven-toolchains-plugin-LATEST/toolchains/custom.html
Sun Nov 9 13:41:01 2014
@@ -162,7 +162,7 @@
<!-- Licensed to the Apache Software Foundation (ASF) under one
--><!-- or more contributor license agreements. See the NOTICE file --><!--
distributed with this work for additional information --><!-- regarding
copyright ownership. The ASF licenses this file --><!-- to you under the
Apache License, Version 2.0 (the --><!-- "License"); you may not use this file
except in compliance --><!-- with the License. You may obtain a copy of the
License at --><!-- --><!-- http://www.apache.org/licenses/LICENSE-2.0 --><!--
--><!-- Unless required by applicable law or agreed to in writing, --><!--
software distributed under the License is distributed on an --><!-- "AS IS"
BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY --><!-- KIND, either express or
implied. See the License for the --><!-- specific language governing
permissions and limitations --><!-- under the License. --><div class="section">
<h2><a name="Custom_Toolchains"></a>Custom Toolchains</h2>
<p>You can create your own custom toolchains with plugins using them.</p>
-<p>A full working sample is included in <tt>maven-toolchains-plugin</tt>
ITs:</p>
+<p>A full working sample is included in <tt>maven-toolchains-plugin</tt> ITs,
which are part of <a href="../source-repository.html">the plugin source
tree</a>:</p>
<ul>
<li>see <tt>src/it/custom-toolchain-plugin</tt> for the custom toolchain and
plugin,</li>
<li>see <tt>src/it/use-custom-toolchain</tt> for a sample project using the
toolchain through its plugin.</li></ul>
@@ -172,11 +172,11 @@
<p>A toolchain consists in:</p>
<ul>
<li>an interface extending <a
href="/ref/current/maven-core/apidocs/org/apache/maven/toolchain/Toolchain.html"><tt>org.apache.maven.toolchain.Toolchain</tt></a>,</li>
-<li>an implementation of this interface, extending <a
href="/ref/current/maven-core/apidocs/org/apache/maven/toolchain/DefaultToolchain.html"><tt>org.apache.maven.toolchain.DefaultToolchain</tt></a>
and implementing previous interface,</li>
+<li>an implementation of this interface. Extending <a
href="/ref/current/maven-core/apidocs/org/apache/maven/toolchain/DefaultToolchain.html"><tt>org.apache.maven.toolchain.DefaultToolchain</tt></a>
is strongly encouraged, since its provides <a
href="/ref/current/maven-core/apidocs/org/apache/maven/toolchain/ToolchainPrivate.html"><tt>org.apache.maven.toolchain.ToolchainPrivate</tt></a>,
which is an internal requirement,</li>
<li>a <a
href="/ref/current/maven-core/apidocs/org/apache/maven/toolchain/ToolchainFactory.html"><tt>org.apache.maven.toolchain.ToolchainFactory</tt></a>,
provided as Plexus component: Plexus <a class="externalLink"
href="http://plexus.codehaus.org/plexus-containers/plexus-component-annotations/";><tt>@Component</tt></a>
annotation in the class is extracted by <a class="externalLink"
href="http://plexus.codehaus.org/plexus-containers/plexus-component-metadata/";><tt>plexus-component-metadata</tt></a>
plugin.</li></ul></div>
<div class="section">
<h3><a name="Creating_a_Plugin_Using_a_Toolchain"></a>Creating a Plugin Using
a Toolchain</h3>
-<p>To get a configured toolchain, a plugin uses <a
href="/ref/current/maven-core/apidocs/org/apache/maven/toolchain/ToolchainManager.html"><tt>ToolchainManager</tt></a>
API to get epxected toolchain, then tool in the toolchain:</p>
+<p>To get a configured toolchain, a plugin uses <a
href="/ref/current/maven-core/apidocs/org/apache/maven/toolchain/ToolchainManager.html"><tt>ToolchainManager</tt></a>
API to get expected toolchain, then some tool in the toolchain:</p>
<div class="source">
<pre> @Component
private ToolchainManager toolchainManager;
@@ -227,7 +227,8 @@
</extension>
</extensions>
</build>
-</project></pre></div></li></ul></div></div>
+</project></pre></div></li></ul>
+<p>Notice that packaging a toolchain in its own artifact separate from plugin
is only useful when there are multiple plugins using the toolchain. As it is
expected in general that a custom toolchain will be used by only one plugin
(eventually providing multiple goals), it is simpler to package the toolchain
with the plugin in only one artifact.</p></div></div>
</div>
</div>
<div class="clear">
