You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@maven.apache.org by vs...@apache.org on 2009/08/08 15:28:08 UTC
svn commit: r802366 - in
/maven/plugins/trunk/maven-toolchains-plugin/src/site: apt/index.apt
apt/toolchains/index.apt apt/usage.apt site.xml
Author: vsiveton
Date: Sat Aug 8 13:28:08 2009
New Revision: 802366
URL: http://svn.apache.org/viewvc?rev=802366&view=rev
Log:
o fixed ambiguous links
o added Doxia xsd
Modified:
maven/plugins/trunk/maven-toolchains-plugin/src/site/apt/index.apt
maven/plugins/trunk/maven-toolchains-plugin/src/site/apt/toolchains/index.apt
maven/plugins/trunk/maven-toolchains-plugin/src/site/apt/usage.apt
maven/plugins/trunk/maven-toolchains-plugin/src/site/site.xml
Modified: maven/plugins/trunk/maven-toolchains-plugin/src/site/apt/index.apt
URL: http://svn.apache.org/viewvc/maven/plugins/trunk/maven-toolchains-plugin/src/site/apt/index.apt?rev=802366&r1=802365&r2=802366&view=diff
==============================================================================
--- maven/plugins/trunk/maven-toolchains-plugin/src/site/apt/index.apt (original)
+++ maven/plugins/trunk/maven-toolchains-plugin/src/site/apt/index.apt Sat Aug 8 13:28:08 2009
@@ -13,8 +13,8 @@
~~ "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.
-
+~~ under the License.
+
------
Introduction
------
@@ -26,33 +26,31 @@
Maven Toolchains Plugin
The Toolchains Plugins allows to share configuration across plugins. For example to make sure the plugins like compiler, surefire, javadoc, webstart etc. all use the same JDK for execution.
-Similarly to maven-enforcer-plugin, it allows to control environmental constraints in the build.
+Similarly to maven-enforcer-plugin, it allows to control environmental constraints in the build.
* Goals Overview
The Toolchains plugin has one goal:
- *{{{toolchain-mojo.html}toolchain:toolchain}} The goal is typically to be attached to the "validate" phase of default lifecycle.
+ *{{{./toolchain-mojo.html}toolchain:toolchain}} The goal is typically to be attached to the "validate" phase of default lifecycle.
* Usage
- General instructions on how to use the Toolchains Plugin can be found on the {{{usage.html}usage page}}.
+ General instructions on how to use the Toolchains Plugin can be found on the {{{./usage.html}usage page}}.
Last but not least, users occasionally contribute
additional examples, tips or errata to the
{{{http://docs.codehaus.org/display/MAVENUSER/Toolchains+Plugin}plugin's wiki page}}.
In case you still have questions regarding the plugin's usage, please feel
- free to contact the {{{mail-lists.html}user mailing list}}. The posts to the mailing list are archived and could
+ free to contact the {{{./mail-lists.html}user mailing list}}. The posts to the mailing list are archived and could
already contain the answer to your question as part of an older thread. Hence, it is also worth browsing/searching
- the {{{mail-lists.html}mail archive}}.
+ the {{{./mail-lists.html}mail archive}}.
If you feel like the plugin is missing a feature or has a defect, you can fill a feature request or bug report in our
- {{{issue-tracking.html}issue tracker}}. When creating a new issue, please provide a comprehensive description of your
+ {{{./issue-tracking.html}issue tracker}}. When creating a new issue, please provide a comprehensive description of your
concern. Especially for fixing bugs it is crucial that the developers can reproduce your problem. For this reason,
entire debug logs, POMs or most preferably little demo projects attached to the issue are very much appreciated.
Of course, patches are welcome, too. Contributors can check out the project from our
- {{{source-repository.html}source repository}} and will find supplementary information in the
+ {{{./source-repository.html}source repository}} and will find supplementary information in the
{{{http://maven.apache.org/guides/development/guide-helping.html}guide to helping with Maven}}.
-
-
Modified: maven/plugins/trunk/maven-toolchains-plugin/src/site/apt/toolchains/index.apt
URL: http://svn.apache.org/viewvc/maven/plugins/trunk/maven-toolchains-plugin/src/site/apt/toolchains/index.apt?rev=802366&r1=802365&r2=802366&view=diff
==============================================================================
--- maven/plugins/trunk/maven-toolchains-plugin/src/site/apt/toolchains/index.apt (original)
+++ maven/plugins/trunk/maven-toolchains-plugin/src/site/apt/toolchains/index.apt Sat Aug 8 13:28:08 2009
@@ -13,8 +13,8 @@
~~ "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.
-
+~~ under the License.
+
------
Standard Toolchains
------
@@ -25,11 +25,10 @@
Standard Toolchains
- The following standard toolchains are included by default with Maven.
-
-
- * {{{jdk.html}JDK}} - Defines the Java Development Kit location and identification
+ The following standard toolchains are included by default with Maven.
+
+ * {{{./jdk.html}JDK}} - Defines the Java Development Kit location and identification
+
+ []
-
- []
You may also create and use your own custom toolchains by following the {{{http://maven.apache.org/}TBD}} instructions.
Modified: maven/plugins/trunk/maven-toolchains-plugin/src/site/apt/usage.apt
URL: http://svn.apache.org/viewvc/maven/plugins/trunk/maven-toolchains-plugin/src/site/apt/usage.apt?rev=802366&r1=802365&r2=802366&view=diff
==============================================================================
--- maven/plugins/trunk/maven-toolchains-plugin/src/site/apt/usage.apt (original)
+++ maven/plugins/trunk/maven-toolchains-plugin/src/site/apt/usage.apt Sat Aug 8 13:28:08 2009
@@ -13,8 +13,8 @@
~~ "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.
-
+~~ under the License.
+
------
Usage
------
@@ -24,39 +24,35 @@
------
Usage
-
+
Brief examples on how to use the toolchains plugin.
-
+
* Generic Plugin configuration information
See the following links for information about including and configuring plugins in your project:
-
+
*{{{http://maven.apache.org/guides/mini/guide-configuring-plugins.html}Configuring Plugins}}
-
+
*{{{http://maven.apache.org/guides/plugin/guide-java-plugin-development.html}Plugin Development}}
*{{{http://maven.apache.org/guides/introduction/introduction-to-plugin-prefix-mapping.html}Plugin Prefix}}
[]
-
+
* What is a toolchain?
Toolchain is a preconfigured object that maven plugins can ask for tool location and other information.
The toolchains-plugin can read the persisted toolchains on the user's computer
and match it against the toolchain requirements of the project (as configured in pom.xml)
If match is found, the toolchain instance is made available to other maven plugins.
-That way all plugins can use the same JDK instance for example without hardcoding absolute paths into the pom.xml
+That way all plugins can use the same JDK instance for example without hardcoding absolute paths into the pom.xml
and without configuring all plugins that require path to JDK tools.
-
+
* The <<<toolchains:toolchain>>> mojo
This goal are meant to be bound to a lifecycle phase and configured in your
<<<pom.xml>>>. In order to function properly it shall be the first phase in the lifecycle, eg. the "validate" phase.
-
- The available standard toolchains are described {{{toolchains/index.html}here}}.
-
-
- []
-
-
\ No newline at end of file
+
+ The available standard toolchains are described {{{./toolchains/index.html}here}}.
+
Modified: maven/plugins/trunk/maven-toolchains-plugin/src/site/site.xml
URL: http://svn.apache.org/viewvc/maven/plugins/trunk/maven-toolchains-plugin/src/site/site.xml?rev=802366&r1=802365&r2=802366&view=diff
==============================================================================
--- maven/plugins/trunk/maven-toolchains-plugin/src/site/site.xml (original)
+++ maven/plugins/trunk/maven-toolchains-plugin/src/site/site.xml Sat Aug 8 13:28:08 2009
@@ -18,8 +18,10 @@
specific language governing permissions and limitations
under the License.
-->
-
-<project>
+<project xmlns="http://maven.apache.org/DECORATION/1.0.0"
+ xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+ xsi:schemaLocation="http://maven.apache.org/DECORATION/1.0.0 http://maven.apache.org/xsd/decoration-1.0.0.xsd"
+ name="Maven Toolchains plugin">
<body>
<menu name="Overview">
<item name="Introduction" href="index.html"/>