jkf 2004/12/13 14:51:19
Modified: xdocs faq.xml
docs faq.html
Log:
PR: 32640
Updated FAQ with a reference to the manual for developing new tasks (and some
more).
Bonus: some typo fixes.
Revision Changes Path
1.65 +19 -3 ant/xdocs/faq.xml
Index: faq.xml
===================================================================
RCS file: /home/cvs/ant/xdocs/faq.xml,v
retrieving revision 1.64
retrieving revision 1.65
diff -u -r1.64 -r1.65
--- faq.xml 21 Sep 2004 12:07:11 -0000 1.64
+++ faq.xml 13 Dec 2004 22:51:19 -0000 1.65
@@ -247,7 +247,7 @@
<faq id="adding-external-tasks">
<question>How do I add an external task that I've written to the
- page "External Tools and Task"?</question>
+ page "External Tools and Tasks"?</question>
<answer>
<p>Join and post a message to the dev or user mailing
@@ -279,6 +279,22 @@
The procedure to add it is the same. The file to patch is <a
href="http://cvs.apache.org/viewcvs.cgi/~checkout~/ant/xdocs/projects.xml">this</a>
document. The syntax of that file is the same.</p>
+
+ </answer>
+ </faq>
+
+ <faq id="create-extensions">
+ <question>How do I create new tasks?</question>
+ <answer>
+ <p>Apart from a lot of information on using Ant, the
+ <a href="manual/index.html">Manual</a> also contains information
+ on how to extend Ant with new tasks. This information
+ can be found under "Developing with Ant".</p>
+
+ <p>Chances are that someone else already created the task you
+ want to create, it may be wise to see
+ <a href="external.html">External Tools and Tasks</a> and
+ <a href="projects.html">Related Projects</a> first.</p>
</answer>
</faq>
@@ -473,7 +489,7 @@
<p>Note: <code><antcall></code> tasks do <em>not</em> pass
property changes back up to the environment they were called
- from, so you would'nt be able to, for example, set a
+ from, so you wouldn't be able to, for example, set a
<code>result</code> property in the <code>cond-if-3</code> target,
then do
<code><echo message="result is ${result}"/></code>
@@ -770,7 +786,7 @@
<answer>
<p>When <code>ant</code> loads properties from an external
- file it dosn't touch the value of properties, trailing blanks
+ file it doesn't touch the value of properties, trailing blanks
will not be trimmed for example.</p>
<p>If the value represents a file path, like a jar needed to
1.112 +19 -4 ant/docs/faq.html
Index: faq.html
===================================================================
RCS file: /home/cvs/ant/docs/faq.html,v
retrieving revision 1.111
retrieving revision 1.112
diff -u -r1.111 -r1.112
--- faq.html 18 Nov 2004 12:22:19 -0000 1.111
+++ faq.html 13 Dec 2004 22:51:19 -0000 1.112
@@ -212,7 +212,10 @@
</a></li>
<li><a href="#adding-external-tasks">
How do I add an external task that I've written to the
- page "External Tools and Task"?
+ page "External Tools and Tasks"?
+ </a></li>
+ <li><a href="#create-extensions">
+ How do I create new tasks?
</a></li>
<li><a href="#passing-cli-args">
How do I pass parameters from the command line to my
@@ -646,7 +649,7 @@
<p class="faq">
<a name="adding-external-tasks"></a>
How do I add an external task that I've written to the
- page "External Tools and Task"?
+ page "External Tools and Tasks"?
</p>
<p>Join and post a message to the dev or user mailing
list (one list is enough), including the following
@@ -673,6 +676,18 @@
The procedure to add it is the same. The file to patch is <a
href="http://cvs.apache.org/viewcvs.cgi/~checkout~/ant/xdocs/projects.xml">this</a>
document. The syntax of that file is the same.</p>
<p class="faq">
+ <a name="create-extensions"></a>
+ How do I create new tasks?
+ </p>
+ <p>Apart from a lot of information on using Ant, the
+ <a href="manual/index.html">Manual</a> also contains information
+ on how to extend Ant with new tasks. This information
+ can be found under "Developing with Ant".</p>
+ <p>Chances are that someone else already created the
task you
+ want to create, it may be wise to see
+ <a href="external.html">External Tools and Tasks</a> and
+ <a href="projects.html">Related Projects</a> first.</p>
+ <p class="faq">
<a name="passing-cli-args"></a>
How do I pass parameters from the command line to my
build file?
@@ -869,7 +884,7 @@
</pre>
<p>Note: <code><antcall></code> tasks do
<em>not</em> pass
property changes back up to the environment they were called
- from, so you would'nt be able to, for example, set a
+ from, so you wouldn't be able to, for example, set a
<code>result</code> property in the <code>cond-if-3</code> target,
then do
<code><echo message="result is ${result}"/></code>
@@ -1108,7 +1123,7 @@
<code>pathelement</code> or <code>classpath refid</code>.
</p>
<p>When <code>ant</code> loads properties from an external
- file it dosn't touch the value of properties, trailing blanks
+ file it doesn't touch the value of properties, trailing blanks
will not be trimmed for example.</p>
<p>If the value represents a file path, like a jar
needed to
compile, the task which requires the value, javac for example
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]