summaryrefslogtreecommitdiffstats
path: root/docs/manual/index.html
blob: a5ab02232bdb6045d450f8ab80c4a42f2dafda25 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
  <head>
    <title>Ant-Contrib Tasks</title>
  </head>

  <body>
    <h1>Ant-Contrib Tasks</h1>

    <h2>Contents</h2>

    <ul>
      <li><a href="#intro">What's this?</a></li>
      <li><a href="#install">Installation</a></li>
      <li><a href="tasks/index.html">Tasks</a></li>
    </ul>

    <h2><a name="intro">What's this?</a></h2>

    <p>The Ant-Contrib project is a collection of tasks (and at one
    point maybe types and other tools) for <a
    href="http://ant.apache.org/">Apache Ant</a>.</p>

    <p>This Software is distributed under the <a
    href="LICENSE.txt">Apache Software License</a>.</p>

    <h2><a name="install">Installation</a></h2>

    <p>First you must install Apache Ant itself, most of the
    Ant-Contrib tasks require Ant 1.5 or higher to work properly,
    however, there are some tasks, specifically &lt;for&gt; which
    require Ant 1.6.  You can download Ant <a
    href="http://ant.apache.org/bindownload.cgi">from
    Apache</a>.</p>

    <p>Then you need the Ant-Contrib tasks themselves.  As there is no
    release of these tasks yet, you have to build them from sources.
    Fortunately this is easy, check out the sources (grab the
    <code>ant-contrib</code> module from <a
    href="http://sourceforge.net/cvs/?group_id=36177">CVS</a>), change
    into the source directory of ant-contrib and type
    <code>ant</code>.  After Ant has completed, you'll find
    <code>ant-contrib-version.jar</code> in the <code>lib</code>
    subdirectory.</p>

    <p>You now have the choice:</p>

    <ol>
      <li>Copy <code>ant-contrib-version.jar</code> to the
      <code>lib</code> directory of your Ant installation, or on
      your CLASSPATH environment variable.  If you
      want to use one of the tasks in your project, add the line
<pre>
&lt;taskdef resource=&quot;net/sf/antcontrib/antlib.xml&quot;/&gt;
</pre>
        to your build file.</li>

<br />
<br />

      <li>Keep <code>ant-contrib-version.jar</code> in a separate
      location.  You now have to tell Ant explicitly where to find it
      (say in <code>/usr/share/java/lib</code>):
<pre>
&lt;taskdef resource=&quot;net/sf/antcontrib/antlib.xml&quot;&gt;
  &lt;classpath&gt;
    &lt;pathelement location=&quot;/usr/share/java/lib/ant-contrib-version.jar&quot;/&gt;
  &lt;/classpath&gt;
&lt;/taskdef&gt;
</pre>
        </li>

        <li>If you would like to use run with Ant Version 1.5 you must use the
            the .properties file instead.  Keep in mind that some tasks will not
            be available to you , such as the &lt;for&gt; task:

<pre>
&lt;taskdef resource=&quot;net/sf/antcontrib/antcontrib.properties&quot;&gt;
  &lt;classpath&gt;
    &lt;pathelement location=&quot;/usr/share/java/lib/ant-contrib-version.jar&quot;/&gt;
  &lt;/classpath&gt;
&lt;/taskdef&gt;
</pre>


    <hr>
    <p align="center">Copyright &copy; 2002-2004 Ant-Contrib Project. All
    rights Reserved.</p>

  </body>
</html>