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]