donaldp 02/03/30 06:25:08
Modified: proposal/myrmidon/docs vfs.html user.html todo.html
task.html librarys.html index.html getinvolved.html
differences.html classloader.html buildfile.html
ant1compat.html
proposal/myrmidon/src/xdocs task.xml
proposal/myrmidon/src/xdocs/stylesheets project.xml
Log:
Change name of task page to "My First Task" so that we can have a taskwriters
howto that lists lifecycle and configuration explanations
Revision Changes Path
1.8 +2 -2 jakarta-ant/proposal/myrmidon/docs/vfs.html
Index: vfs.html
===================================================================
RCS file: /home/cvs/jakarta-ant/proposal/myrmidon/docs/vfs.html,v
retrieving revision 1.7
retrieving revision 1.8
diff -u -r1.7 -r1.8
--- vfs.html 26 Mar 2002 02:40:32 -0000 1.7
+++ vfs.html 30 Mar 2002 14:25:07 -0000 1.8
@@ -54,11 +54,11 @@
</li>
<li> <a href="./differences.html">Differences to Ant1</a>
</li>
+ <li> <a href="./task.html">My First Task</a>
+ </li>
</ul>
<p><strong>Extending Ant</strong></p>
<ul>
- <li> <a href="./task.html">Task Writers HOWTO</a>
- </li>
<li> <a href="./classloader.html">ClassLoader HOWTO</a>
</li>
<li> <a href="./librarys.html">Library HOWTO</a>
1.7 +2 -2 jakarta-ant/proposal/myrmidon/docs/user.html
Index: user.html
===================================================================
RCS file: /home/cvs/jakarta-ant/proposal/myrmidon/docs/user.html,v
retrieving revision 1.6
retrieving revision 1.7
diff -u -r1.6 -r1.7
--- user.html 26 Mar 2002 02:40:32 -0000 1.6
+++ user.html 30 Mar 2002 14:25:07 -0000 1.7
@@ -54,11 +54,11 @@
</li>
<li> <a href="./differences.html">Differences to Ant1</a>
</li>
+ <li> <a href="./task.html">My First Task</a>
+ </li>
</ul>
<p><strong>Extending Ant</strong></p>
<ul>
- <li> <a href="./task.html">Task Writers HOWTO</a>
- </li>
<li> <a href="./classloader.html">ClassLoader HOWTO</a>
</li>
<li> <a href="./librarys.html">Library HOWTO</a>
1.13 +2 -2 jakarta-ant/proposal/myrmidon/docs/todo.html
Index: todo.html
===================================================================
RCS file: /home/cvs/jakarta-ant/proposal/myrmidon/docs/todo.html,v
retrieving revision 1.12
retrieving revision 1.13
diff -u -r1.12 -r1.13
--- todo.html 30 Mar 2002 14:18:22 -0000 1.12
+++ todo.html 30 Mar 2002 14:25:07 -0000 1.13
@@ -54,11 +54,11 @@
</li>
<li> <a href="./differences.html">Differences to Ant1</a>
</li>
+ <li> <a href="./task.html">My First Task</a>
+ </li>
</ul>
<p><strong>Extending Ant</strong></p>
<ul>
- <li> <a href="./task.html">Task Writers HOWTO</a>
- </li>
<li> <a href="./classloader.html">ClassLoader HOWTO</a>
</li>
<li> <a href="./librarys.html">Library HOWTO</a>
1.4 +26 -26 jakarta-ant/proposal/myrmidon/docs/task.html
Index: task.html
===================================================================
RCS file: /home/cvs/jakarta-ant/proposal/myrmidon/docs/task.html,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- task.html 26 Mar 2002 02:40:32 -0000 1.3
+++ task.html 30 Mar 2002 14:25:07 -0000 1.4
@@ -11,7 +11,7 @@
<meta name="author" value="Peter Donald">
<meta name="email" value="[EMAIL PROTECTED]">
- <title>Apache Myrmidon - Writing a task</title>
+ <title>Apache Myrmidon - My First Task</title>
</head>
<body bgcolor="#ffffff" text="#000000" link="#525D76">
@@ -54,11 +54,11 @@
</li>
<li> <a href="./differences.html">Differences to Ant1</a>
</li>
+ <li> <a href="./task.html">My First Task</a>
+ </li>
</ul>
<p><strong>Extending Ant</strong></p>
<ul>
- <li> <a href="./task.html">Task Writers HOWTO</a>
- </li>
<li> <a href="./classloader.html">ClassLoader HOWTO</a>
</li>
<li> <a href="./librarys.html">Library HOWTO</a>
@@ -72,48 +72,48 @@
<table border="0" cellspacing="0" cellpadding="2" width="100%">
<tr><td bgcolor="#525D76">
<font color="#ffffff" face="arial,helvetica,sanserif">
- <a name="Writing a Task"><strong>Writing a Task</strong></a>
+ <a name="My First Task"><strong>My First Task</strong></a>
</font>
</td></tr>
<tr><td>
<blockquote>
- <p>In ant1 it was very easy to write your own task.
In Ant2 we plan
+ <p>In ant1 it was very easy to write your own task.
In Ant2 we plan
to make it even easier. To write a basic task simply follow the following
formula.</p>
<ol>
<li>
- Create a Java class that extends
+ Create a Java class that extends
<code>org.apache.myrmidon.api.AbstractTask</code>
</li>
<li>
- For each attribute, write a setter method. The setter method
- must be a public void method that takes a single argument. The name
- of the method must begin with "set", followed by the attribute name,
with
- the first character of the name in uppercase, and the rest in lowercase.
+ For each attribute, write a setter method. The setter method
+ must be a public void method that takes a single argument. The name
+ of the method must begin with "set", followed by the attribute name, with
+ the first character of the name in uppercase, and the rest in lowercase.
The type of the attribute can be:
<ul>
<li>String</li>
<li>
- Any primitive type - they are converted for you from their
+ Any primitive type - they are converted for you from their
String-representation in the buildfile
</li>
<li>
- File - the string representation will be interpreted relative to
+ File - the string representation will be interpreted relative to
the project's basedir.
</li>
</ul>
</li>
<li>
- For each nested element create a public void method that takes a single
- argument. The name of the method must begin with "add", followed by the
- attribute name, with the first character of the name in uppercase, and
- the rest in lowercase. The type of the parameter is an object with a
- no-arguement constructor. It is configured in exactly the same was a
+ For each nested element create a public void method that takes a single
+ argument. The name of the method must begin with "add", followed by the
+ attribute name, with the first character of the name in uppercase, and
+ the rest in lowercase. The type of the parameter is an object with a
+ no-arguement constructor. It is configured in exactly the same was a
task is configured (via setters and adders) and then added to the task.
</li>
<li>
- Write a public void method named "execute" with no arguments that
- throws a TaskException. This is the method called to do the
+ Write a public void method named "execute" with no arguments that
+ throws a TaskException. This is the method called to do the
actual work of the task.
</li>
</ol>
@@ -125,7 +125,7 @@
</td></tr>
<tr><td>
<blockquote>
- <p>So a basic task that has one attribute named
"message" and just prints
+ <p>So a basic task that has one attribute named
"message" and just prints
out this message is as simple as;</p>
<div align="left">
<table cellspacing="4" cellpadding="0" border="0">
@@ -142,8 +142,8 @@
import org.apache.myrmidon.api.AbstractTask;
import org.apache.myrmidon.api.TaskException;
-public class SystemOutPrinterTask
- extends Task
+public class SystemOutPrinterTask
+ extends Task
{
private String m_message;
@@ -154,8 +154,8 @@
}
// The method executing the task
- public void execute()
- throws TaskException
+ public void execute()
+ throws TaskException
{
System.out.println( m_message );
}
@@ -170,7 +170,7 @@
</tr>
</table>
</div>
- <p>To use this task you <em>could</em>
create a library but instead we will
+ <p>To use this task you <em>could</em>
create a library but instead we will
just use <taskdef> to define the task. An example usage would be;</p>
<div align="left">
<table cellspacing="4" cellpadding="0" border="0">
@@ -189,7 +189,7 @@
<project version="2.0">
<target name="main">
- <taskdef name="printer"
+ <taskdef name="printer"
classname="org.realityforge.tasks.SystemOutPrinterTask"
classpath="build/classes"/>
1.5 +2 -2 jakarta-ant/proposal/myrmidon/docs/librarys.html
Index: librarys.html
===================================================================
RCS file: /home/cvs/jakarta-ant/proposal/myrmidon/docs/librarys.html,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -r1.4 -r1.5
--- librarys.html 30 Mar 2002 03:52:17 -0000 1.4
+++ librarys.html 30 Mar 2002 14:25:07 -0000 1.5
@@ -54,11 +54,11 @@
</li>
<li> <a href="./differences.html">Differences to Ant1</a>
</li>
+ <li> <a href="./task.html">My First Task</a>
+ </li>
</ul>
<p><strong>Extending Ant</strong></p>
<ul>
- <li> <a href="./task.html">Task Writers HOWTO</a>
- </li>
<li> <a href="./classloader.html">ClassLoader HOWTO</a>
</li>
<li> <a href="./librarys.html">Library HOWTO</a>
1.8 +2 -2 jakarta-ant/proposal/myrmidon/docs/index.html
Index: index.html
===================================================================
RCS file: /home/cvs/jakarta-ant/proposal/myrmidon/docs/index.html,v
retrieving revision 1.7
retrieving revision 1.8
diff -u -r1.7 -r1.8
--- index.html 30 Mar 2002 14:20:43 -0000 1.7
+++ index.html 30 Mar 2002 14:25:07 -0000 1.8
@@ -54,11 +54,11 @@
</li>
<li> <a href="./differences.html">Differences to Ant1</a>
</li>
+ <li> <a href="./task.html">My First Task</a>
+ </li>
</ul>
<p><strong>Extending Ant</strong></p>
<ul>
- <li> <a href="./task.html">Task Writers HOWTO</a>
- </li>
<li> <a href="./classloader.html">ClassLoader HOWTO</a>
</li>
<li> <a href="./librarys.html">Library HOWTO</a>
1.4 +2 -2 jakarta-ant/proposal/myrmidon/docs/getinvolved.html
Index: getinvolved.html
===================================================================
RCS file: /home/cvs/jakarta-ant/proposal/myrmidon/docs/getinvolved.html,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- getinvolved.html 26 Mar 2002 02:40:32 -0000 1.3
+++ getinvolved.html 30 Mar 2002 14:25:07 -0000 1.4
@@ -54,11 +54,11 @@
</li>
<li> <a href="./differences.html">Differences to Ant1</a>
</li>
+ <li> <a href="./task.html">My First Task</a>
+ </li>
</ul>
<p><strong>Extending Ant</strong></p>
<ul>
- <li> <a href="./task.html">Task Writers HOWTO</a>
- </li>
<li> <a href="./classloader.html">ClassLoader HOWTO</a>
</li>
<li> <a href="./librarys.html">Library HOWTO</a>
1.2 +2 -2 jakarta-ant/proposal/myrmidon/docs/differences.html
Index: differences.html
===================================================================
RCS file: /home/cvs/jakarta-ant/proposal/myrmidon/docs/differences.html,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- differences.html 26 Mar 2002 02:40:31 -0000 1.1
+++ differences.html 30 Mar 2002 14:25:07 -0000 1.2
@@ -54,11 +54,11 @@
</li>
<li> <a href="./differences.html">Differences to Ant1</a>
</li>
+ <li> <a href="./task.html">My First Task</a>
+ </li>
</ul>
<p><strong>Extending Ant</strong></p>
<ul>
- <li> <a href="./task.html">Task Writers HOWTO</a>
- </li>
<li> <a href="./classloader.html">ClassLoader HOWTO</a>
</li>
<li> <a href="./librarys.html">Library HOWTO</a>
1.5 +2 -2 jakarta-ant/proposal/myrmidon/docs/classloader.html
Index: classloader.html
===================================================================
RCS file: /home/cvs/jakarta-ant/proposal/myrmidon/docs/classloader.html,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -r1.4 -r1.5
--- classloader.html 30 Mar 2002 03:52:17 -0000 1.4
+++ classloader.html 30 Mar 2002 14:25:07 -0000 1.5
@@ -54,11 +54,11 @@
</li>
<li> <a href="./differences.html">Differences to Ant1</a>
</li>
+ <li> <a href="./task.html">My First Task</a>
+ </li>
</ul>
<p><strong>Extending Ant</strong></p>
<ul>
- <li> <a href="./task.html">Task Writers HOWTO</a>
- </li>
<li> <a href="./classloader.html">ClassLoader HOWTO</a>
</li>
<li> <a href="./librarys.html">Library HOWTO</a>
1.7 +2 -2 jakarta-ant/proposal/myrmidon/docs/buildfile.html
Index: buildfile.html
===================================================================
RCS file: /home/cvs/jakarta-ant/proposal/myrmidon/docs/buildfile.html,v
retrieving revision 1.6
retrieving revision 1.7
diff -u -r1.6 -r1.7
--- buildfile.html 26 Mar 2002 02:40:31 -0000 1.6
+++ buildfile.html 30 Mar 2002 14:25:07 -0000 1.7
@@ -54,11 +54,11 @@
</li>
<li> <a href="./differences.html">Differences to Ant1</a>
</li>
+ <li> <a href="./task.html">My First Task</a>
+ </li>
</ul>
<p><strong>Extending Ant</strong></p>
<ul>
- <li> <a href="./task.html">Task Writers HOWTO</a>
- </li>
<li> <a href="./classloader.html">ClassLoader HOWTO</a>
</li>
<li> <a href="./librarys.html">Library HOWTO</a>
1.3 +2 -2 jakarta-ant/proposal/myrmidon/docs/ant1compat.html
Index: ant1compat.html
===================================================================
RCS file: /home/cvs/jakarta-ant/proposal/myrmidon/docs/ant1compat.html,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- ant1compat.html 26 Mar 2002 02:40:31 -0000 1.2
+++ ant1compat.html 30 Mar 2002 14:25:07 -0000 1.3
@@ -54,11 +54,11 @@
</li>
<li> <a href="./differences.html">Differences to Ant1</a>
</li>
+ <li> <a href="./task.html">My First Task</a>
+ </li>
</ul>
<p><strong>Extending Ant</strong></p>
<ul>
- <li> <a href="./task.html">Task Writers HOWTO</a>
- </li>
<li> <a href="./classloader.html">ClassLoader HOWTO</a>
</li>
<li> <a href="./librarys.html">Library HOWTO</a>
1.2 +24 -24 jakarta-ant/proposal/myrmidon/src/xdocs/task.xml
Index: task.xml
===================================================================
RCS file: /home/cvs/jakarta-ant/proposal/myrmidon/src/xdocs/task.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- task.xml 3 Mar 2002 06:45:42 -0000 1.1
+++ task.xml 30 Mar 2002 14:25:08 -0000 1.2
@@ -2,58 +2,58 @@
<properties>
<author email="[EMAIL PROTECTED]">Peter Donald</author>
-<title>Writing a task</title>
+<title>My First Task</title>
</properties>
<body>
-<section name="Writing a Task">
+<section name="My First Task">
-<p>In ant1 it was very easy to write your own task. In Ant2 we plan
+<p>In ant1 it was very easy to write your own task. In Ant2 we plan
to make it even easier. To write a basic task simply follow the following
formula.</p>
<ol>
<li>
- Create a Java class that extends
+ Create a Java class that extends
<code>org.apache.myrmidon.api.AbstractTask</code>
</li>
<li>
- For each attribute, write a setter method. The setter method
- must be a public void method that takes a single argument. The name
- of the method must begin with "set", followed by the attribute name,
with
- the first character of the name in uppercase, and the rest in lowercase.
+ For each attribute, write a setter method. The setter method
+ must be a public void method that takes a single argument. The name
+ of the method must begin with "set", followed by the attribute name, with
+ the first character of the name in uppercase, and the rest in lowercase.
The type of the attribute can be:
<ul>
<li>String</li>
<li>
- Any primitive type - they are converted for you from their
+ Any primitive type - they are converted for you from their
String-representation in the buildfile
</li>
<li>
- File - the string representation will be interpreted relative to
+ File - the string representation will be interpreted relative to
the project's basedir.
</li>
</ul>
</li>
<li>
- For each nested element create a public void method that takes a single
- argument. The name of the method must begin with "add", followed by the
- attribute name, with the first character of the name in uppercase, and
- the rest in lowercase. The type of the parameter is an object with a
- no-arguement constructor. It is configured in exactly the same was a
+ For each nested element create a public void method that takes a single
+ argument. The name of the method must begin with "add", followed by the
+ attribute name, with the first character of the name in uppercase, and
+ the rest in lowercase. The type of the parameter is an object with a
+ no-arguement constructor. It is configured in exactly the same was a
task is configured (via setters and adders) and then added to the task.
</li>
<li>
- Write a public void method named "execute" with no arguments that
- throws a TaskException. This is the method called to do the
+ Write a public void method named "execute" with no arguments that
+ throws a TaskException. This is the method called to do the
actual work of the task.
</li>
</ol>
<subsection name="A Basic Example">
-<p>So a basic task that has one attribute named "message" and just prints
+<p>So a basic task that has one attribute named "message" and just prints
out this message is as simple as;</p>
<source>
@@ -62,8 +62,8 @@
import org.apache.myrmidon.api.AbstractTask;
import org.apache.myrmidon.api.TaskException;
-public class SystemOutPrinterTask
- extends Task
+public class SystemOutPrinterTask
+ extends Task
{
private String m_message;
@@ -74,15 +74,15 @@
}
// The method executing the task
- public void execute()
- throws TaskException
+ public void execute()
+ throws TaskException
{
System.out.println( m_message );
}
}
</source>
-<p>To use this task you <em>could</em> create a library but instead we will
+<p>To use this task you <em>could</em> create a library but instead we will
just use <taskdef> to define the task. An example usage would be;</p>
<source>
@@ -93,7 +93,7 @@
<project version="2.0">
<target name="main">
- <taskdef name="printer"
+ <taskdef name="printer"
classname="org.realityforge.tasks.SystemOutPrinterTask"
classpath="build/classes"/>
1.8 +1 -1
jakarta-ant/proposal/myrmidon/src/xdocs/stylesheets/project.xml
Index: project.xml
===================================================================
RCS file:
/home/cvs/jakarta-ant/proposal/myrmidon/src/xdocs/stylesheets/project.xml,v
retrieving revision 1.7
retrieving revision 1.8
diff -u -r1.7 -r1.8
--- project.xml 25 Mar 2002 11:14:53 -0000 1.7
+++ project.xml 30 Mar 2002 14:25:08 -0000 1.8
@@ -15,10 +15,10 @@
<item name="Virtual File System" href="/vfs.html"/>
<item name="Ant1 Compatibility Layer" href="/ant1compat.html"/>
<item name="Differences to Ant1" href="/differences.html"/>
+ <item name="My First Task" href="/task.html"/>
</menu>
<menu name="Extending Ant">
- <item name="Task Writers HOWTO" href="/task.html"/>
<item name="ClassLoader HOWTO" href="/classloader.html"/>
<item name="Library HOWTO" href="/librarys.html"/>
</menu>
--
To unsubscribe, e-mail: <mailto:[EMAIL PROTECTED]>
For additional commands, e-mail: <mailto:[EMAIL PROTECTED]>
