From 15442309bda3e68f9d1cb1fd15c43866c0adae3c Mon Sep 17 00:00:00 2001
From: Jason van Zyl <jvanzyl@apache.org>
Date: Wed, 19 Oct 2005 03:36:51 +0000
Subject: [PATCH] o can't have enough references to the documentation o add a
 guide for using ant tasks within the POM o update the guide toc

git-svn-id: https://svn.apache.org/repos/asf/maven/components/trunk@326355 13f79535-47bb-0310-9956-ffa450edef68
---
 maven-site/src/site/apt/guides/index.apt      |  4 +-
 .../site/apt/guides/mini/guide-using-ant.apt  | 87 +++++++++++++++++++
 maven-site/src/site/xdoc/index.xml            |  5 +-
 3 files changed, 94 insertions(+), 2 deletions(-)
 create mode 100644 maven-site/src/site/apt/guides/mini/guide-using-ant.apt

diff --git a/maven-site/src/site/apt/guides/index.apt b/maven-site/src/site/apt/guides/index.apt
index 988fccefe5..291c6b7715 100644
--- a/maven-site/src/site/apt/guides/index.apt
+++ b/maven-site/src/site/apt/guides/index.apt
@@ -38,7 +38,7 @@ Documentation
 
  * {{{mini/guide-embedding-m2.html}Guide to Embedding Maven 2.x}}
 
- * {{{mini/guide-generating-sources.html}Guide to Generating Sources}}
+ * {{{mini/guide-generating-sources.html}Guide to generating Sources}}
 
  * {{{mini/guide-ibiblio-upload.html}Guide to uploading artifacts to Ibiblio}}
 
@@ -66,6 +66,8 @@ Documentation
 
  * {{{mini/guide-site.html}Guide to creating a site}}
 
+ * {{{mini/guide-using-ant.html}Guide to using Ant with Maven}}
+
  * {{{mini/guide-using-extensions.html}Guide to using Extensions}}
 
  * {{{mini/guide-webapp.html}Guide to Webapps}}
diff --git a/maven-site/src/site/apt/guides/mini/guide-using-ant.apt b/maven-site/src/site/apt/guides/mini/guide-using-ant.apt
new file mode 100644
index 0000000000..03393e9a91
--- /dev/null
+++ b/maven-site/src/site/apt/guides/mini/guide-using-ant.apt
@@ -0,0 +1,87 @@
+ ------
+ Guide to using Ant with Maven
+ ------
+ Jason van Zyl
+ ------
+ 12 October 2005
+ ------
+
+Guide to using Ant with Maven
+
+ The example above illustrates how to bind an ant script to a lifecycle phase. You can add a script to each lifecycle
+ phase, by duplicating the <execution/> section and specifying a new phase.
+
++----+
+
+<project>
+  <modelVersion>4.0.0</modelVersion>
+  <artifactId>my-test-app</artifactId>
+  <groupId>my-test-group</groupId>
+  <version>1.0-SNAPSHOT</version>
+  <build>
+    <plugins>
+      <plugin>
+        <artifactId>maven-antrun-plugin</artifactId>
+        <executions>
+          <execution>
+            <phase>generate-sources</phase>
+            <configuration>
+              <tasks>
+
+                <!--
+                  Place any ant task here. You can add anything
+                  you can add between <target> and </target> in a
+                  build.xml.
+                -->
+
+              </tasks>
+            </configuration>
+            <goals>
+              <goal>run</goal>
+            </goals>
+          </execution>
+        </executions>
+      </plugin>
+    </plugins>
+  </build>
+</project>
+
++----+
+
+ So a concrete example would be something like the following:
+
++----+
+
+<project>
+  <modelVersion>4.0.0</modelVersion>
+  <artifactId>my-test-app</artifactId>
+  <groupId>my-test-group</groupId>
+  <version>1.0-SNAPSHOT</version>
+  <build>
+    <plugins>
+      <plugin>
+        <artifactId>maven-antrun-plugin</artifactId>
+        <executions>
+          <execution>
+            <phase>generate-sources</phase>
+            <configuration>
+              <tasks>
+                <exec
+                  dir="${basedir}"
+                  executable="${basedir}/src/main/sh/do-something.sh"
+                  failonerror="true">
+                  <arg line="arg1 arg2 arg3 arg4" />
+                </exec>
+              </tasks>
+            </configuration>
+            <goals>
+              <goal>run</goal>
+            </goals>
+          </execution>
+        </executions>
+      </plugin>
+    </plugins>
+  </build>
+</project>
+
++----+
\ No newline at end of file
diff --git a/maven-site/src/site/xdoc/index.xml b/maven-site/src/site/xdoc/index.xml
index 770df4f6eb..de276fd2d5 100644
--- a/maven-site/src/site/xdoc/index.xml
+++ b/maven-site/src/site/xdoc/index.xml
@@ -25,8 +25,11 @@
             <a href="download.html#installation">Installation Instructions</a>
           </li>
           <li>
-            <a href="getting-started.html">Getting Started</a>
+            <a href="guides/getting-start/getting-started.html">Getting Started</a>
           </li>
+          <li>
+            <a href="guides/index.html">Documentation</a>
+          </li>          
         </ul>
       </div>
       <p>