adammurdoch 2002/06/06 05:54:29
Modified: site build.xml
site/docs ant1compat.html buildfile.html building.html
classloader.html configuring.html differences.html
getinvolved.html index.html librarys.html
project-descriptor.html running.html
subprojects.html task.html todo.html vfs.html
Added: site/docs/css ns4_only.css print.css site.css tigris.css
site/docs/images nw_min.gif strich.gif sw_min.gif
Log:
Regen docs.
Revision Changes Path
1.2 +4 -0 jakarta-ant-myrmidon/site/build.xml
Index: build.xml
===================================================================
RCS file: /home/cvs/jakarta-ant-myrmidon/site/build.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- build.xml 10 Apr 2002 23:43:46 -0000 1.1
+++ build.xml 6 Jun 2002 12:54:28 -0000 1.2
@@ -34,6 +34,10 @@
excludes="stylesheets/**"
velocitypropertiesfile="${xdocs.dir}/velocity.properties"
/>
+
+ <copy todir="${docs.dir}">
+ <fileset dir="src" includes="css/**, images/**"/>
+ </copy>
</target>
<!-- Cleans up build and distribution directories -->
1.6 +117 -149 jakarta-ant-myrmidon/site/docs/ant1compat.html
Index: ant1compat.html
===================================================================
RCS file: /home/cvs/jakarta-ant-myrmidon/site/docs/ant1compat.html,v
retrieving revision 1.5
retrieving revision 1.6
diff -u -r1.5 -r1.6
--- ant1compat.html 19 May 2002 13:37:50 -0000 1.5
+++ ant1compat.html 6 Jun 2002 12:54:28 -0000 1.6
@@ -6,90 +6,92 @@
<!-- start the processing -->
<html>
<head>
+ <style type="text/css">
+ @import url("./css/tigris.css");
+ @import url("./css/site.css");
+ </style>
<meta http-equiv="Content-Type" content="text/html;
charset=iso-8859-1"/>
-
+
<meta name="author" value="Darrell DeBoer">
<meta name="email" value="darrell at apache dot org">
-
+
<title>Apache Myrmidon - Ant 1 Compatibitlity Layer</title>
</head>
-
- <body bgcolor="#ffffff" text="#000000" link="#525D76">
- <table border="0" width="100%" cellspacing="0">
- <!-- TOP IMAGE -->
- <tr>
- <td> <td colspan="2">
+
+ <body marginwidth="0" marginheight="0" class="composite">
+
+ <div id="banner">
+ <table border="0" cellspacing="0" cellpadding="8" width="100%">
+ <!-- TOP IMAGE -->
+ <tr>
+ <td> <td colspan="2">
<a href="http://jakarta.apache.org"><img
src="http://jakarta.apache.org/images/jakarta-logo.gif" align="left"
border="0"/></a>
</td>
</td>
- <td valign="bottom"><div align="right"><b><font size="+3"
color="#525D76">Apache Myrmidon</font></b></div></td>
- </tr>
- </table>
- <table border="0" width="100%" cellspacing="4">
- <tr><td colspan="2">
- <hr noshade="" size="1"/>
- </td></tr>
-
- <tr>
+ <td><div align="right" valign="bottom"><b><font size="+3">Apache
Myrmidon</font></b></div></td>
+ </tr>
+ </table>
+ </div>
+
+ <table border="0" cellspacing="0" cellpadding="8" width="100%"
id="main">
+ <tr valign="top">
<!-- LEFT SIDE NAVIGATION -->
- <td valign="top" nowrap="true">
- <p><strong>Myrmidon</strong></p>
- <ul>
- <li> <a href="./index.html">Introduction</a>
- </li>
- <li> <a href="./getinvolved.html">Get Involved</a>
- </li>
- <li> <a href="./building.html">Building Myrmidon</a>
- </li>
- <li> <a href="./todo.html">Todo List</a>
- </li>
- </ul>
- <p><strong>User Guide</strong></p>
- <ul>
- <li> <a href="./running.html">Installing and Running</a>
- </li>
- <li> <a href="./buildfile.html">Project File</a>
- </li>
- <li> <a href="./vfs.html">Virtual File System</a>
- </li>
- <li> <a href="./ant1compat.html">Ant 1 Compatibility Layer</a>
- </li>
- <li> <a href="./differences.html">Differences to Ant 1</a>
- </li>
- <li> <a href="./task.html">My First Task</a>
- </li>
- </ul>
- <p><strong>Extending Myrmidon</strong></p>
- <ul>
- <li> <a href="./configuring.html">Configuration HOWTO</a>
- </li>
- <li> <a href="./converter.html">Converter HOWTO</a>
- </li>
- <li> <a href="./type.html">Type HOWTO</a>
- </li>
- <li> <a href="./classloader.html">ClassLoader HOWTO</a>
- </li>
- <li> <a href="./librarys.html">Library HOWTO</a>
- </li>
- </ul>
- <p><strong>Developers Guide</strong></p>
- <ul>
- <li> <a href="./subprojects.html">Sub Projects</a>
- </li>
- <li> <a href="./project-descriptor.html">The Build System</a>
- </li>
- </ul>
- </td>
- <td align="left" valign="top">
- <table border="0" cellspacing="0" cellpadding="2" width="100%">
- <tr><td bgcolor="#525D76">
- <font color="#ffffff" face="arial,helvetica,sanserif">
- <a name="Overview"><strong>Overview</strong></a>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <p>
+ <td id="leftcol" width="20%">
+ <div id="navcolumn">
+ <div>
+ <strong>Myrmidon</strong>
+ <div><small> <a href="./index.html">Introduction</a>
+ </small></div>
+ <div><small> <a href="./getinvolved.html">Get Involved</a>
+ </small></div>
+ <div><small> <a href="./building.html">Building
Myrmidon</a>
+ </small></div>
+ <div><small> <a href="./todo.html">Todo List</a>
+ </small></div>
+ </div>
+ <div>
+ <strong>User Guide</strong>
+ <div><small> <a href="./running.html">Installing and
Running</a>
+ </small></div>
+ <div><small> <a href="./buildfile.html">Project File</a>
+ </small></div>
+ <div><small> <a href="./properties.html">Properties</a>
+ </small></div>
+ <div><small> <a href="./vfs.html">Virtual File System</a>
+ </small></div>
+ <div><small> <a href="./ant1compat.html">Ant 1
Compatibility Layer</a>
+ </small></div>
+ <div><small> <a href="./differences.html">Differences to
Ant 1</a>
+ </small></div>
+ <div><small> <a href="./task.html">My First Task</a>
+ </small></div>
+ </div>
+ <div>
+ <strong>Extending Myrmidon</strong>
+ <div><small> <a href="./configuring.html">Configuration
HOWTO</a>
+ </small></div>
+ <div><small> <a href="./converter.html">Converter
HOWTO</a>
+ </small></div>
+ <div><small> <a href="./type.html">Type HOWTO</a>
+ </small></div>
+ <div><small> <a href="./classloader.html">ClassLoader
HOWTO</a>
+ </small></div>
+ <div><small> <a href="./librarys.html">Library HOWTO</a>
+ </small></div>
+ </div>
+ <div>
+ <strong>Developers Guide</strong>
+ <div><small> <a href="./subprojects.html">Sub Projects</a>
+ </small></div>
+ <div><small> <a href="./project-descriptor.html">The
Build System</a>
+ </small></div>
+ </div>
+ </div>
+ </td>
+ <td><div id="bodycol"><div class="app">
+ <div class="h3">
+ <h3><a name="Overview">Overview</a></h3>
+ <p>
The Myrmidon-Ant1 Compatibility layer works by reusing most of
the Ant 1 code,
with tasks and datatypes
being prefixed with "ant1." in build files. Almost all of the
main Ant 1 tree
@@ -97,137 +99,103 @@
the Ant 1 tree, Ant 1 class files are extracted from a jar,
rather than
being compiled from scratch.
</p>
- <p>
+ <p>
Here's how it works: The first time an Ant 1 task is
encountered, an Ant 1
project is created, and stored in the TaskContext under the name
"ant1.project".
The Ant 1 versions of Task and Project have been extended,
overriding core behaviour,
with Myrmidon-specific behaviour.
</p>
- <p>
+ <p>
The updated version of Task implements Configurable, receiving
it's
complete Task Model, and actually setting/adding/creating
attributes
with the help of the IntrospectionHelper. This process is
designed to
mimic the Ant 1 configuration policy, although not <i>all</i> of
the
subtle variations of configuration present in Ant 1 are handled.
</p>
- <p>
+ <p>
The updated version of Project will provide hooks into the
Myrmidon TaskContext,
such as:</p>
- <ul>
+ <ul>
<li>logging (done)</li>
<li>properties (done)</li>
<li>references (not yet done)</li>
<li>Task defined by <taskdef> (done)</li>
</ul>
- <p>
+ <p>
So at present, properties declared in Ant 2 tasks are available
to all Ant 1 tasks,
and vice-versa. However, while a <code><ant1.path></code>
reference works fine
in other <code><ant1.XXX></code>
tasks, it's not visible to Ant 2 tasks in the same build, and
vice-versa.
</p>
- <p>
+ <p>
The <code><taskdef></code> task works ok, registering the
task with the TypeManager using the
"ant1." prefix. Only a couple of DataTypes (Path and Patternset)
are working
as top-level types, but this should be just a matter of adding
references to
the Ant 1 version of TypeInstanceTask in the descriptor.
</p>
- <p>
+ <p>
The TransformingProjectBuilder (which is now the default builder
for files
of type ".xml", applies a transformation stylesheet to the file,
prefixing select
tasks (all at present) with "ant.". If a version attribute is
encountered, the
file is not transformed
</p>
- </blockquote>
- </td></tr>
- </table>
- <table border="0" cellspacing="0" cellpadding="2" width="100%">
- <tr><td bgcolor="#525D76">
- <font color="#ffffff" face="arial,helvetica,sanserif">
- <a name="Using the compatibility layer"><strong>Using
the compatibility layer</strong></a>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <table border="0" cellspacing="0" cellpadding="2"
width="100%">
- <tr><td bgcolor="#828DA6">
- <font color="#ffffff" face="arial,helvetica,sanserif">
- <a name="Using Ant 1 tasks in a Myrmidon build
file"><strong>Using Ant 1 tasks in a Myrmidon build file</strong></a>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <p>
+ </div>
+ <div class="h3">
+ <h3><a name="Using the compatibility layer">Using the
compatibility layer</a></h3>
+ <div class="h4">
+ <h4><a name="Using Ant 1 tasks in a Myrmidon build file">Using
Ant 1 tasks in a Myrmidon build file</a></h4>
+ <p>
If you have a Myrmidon build file (eg with
<code>version="2.0"</code>
on the project element, you can use Ant 1 tasks and
datatypes by using
the "ant1." suffix on the regular element name.
Virtually <i>all</i> tasks and datatypes from Ant 1.4.1 are
available
in this way.
</p>
- <p>
+ <p>
When declaring a new task using the
<code><ant1.taskdef></code>
task, <i>don't</i> prepend "ant1." to the taskname. This
will be
done automatically by the taskdef task. However, you will
need
to use the "ant1." prefix in all uses of that task.
</p>
- </blockquote>
- </td></tr>
- </table>
- <table border="0" cellspacing="0"
cellpadding="2" width="100%">
- <tr><td bgcolor="#828DA6">
- <font color="#ffffff" face="arial,helvetica,sanserif">
- <a name="Using an existing Ant 1 build
file"><strong>Using an existing Ant 1 build file</strong></a>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <p>
+ </div>
+ <div class="h4">
+ <h4><a name="Using an existing Ant 1 build file">Using an
existing Ant 1 build file</a></h4>
+ <p>
Myrmidon will automatically handle Ant 1 build files using
the
Ant 1 Compatibility layer. So, using an Ant 1 build
file with Myrmidon should be as simple as:</p>
- <pre>[myrmidon-command] -f
ant1-build-file.xml</pre>
- <p>
+ <pre>[myrmidon-command] -f ant1-build-file.xml</pre>
+ <p>
This works as follows: When Myrmidon encounters a ".xml"
build file which does not have a
<code>version</code> attribute on the top-level
<code>project</code>
element, it assumes that it is an Ant 1 build file. So all
tasks are
interpreted as though they are prefixed with the "ant." name
prefix.
</p>
- </blockquote>
- </td></tr>
- </table>
- </blockquote>
- </td></tr>
- </table>
- <table border="0" cellspacing="0" cellpadding="2" width="100%">
- <tr><td bgcolor="#525D76">
- <font color="#ffffff" face="arial,helvetica,sanserif">
- <a name="Building the compatibility
layer"><strong>Building the compatibility layer</strong></a>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <p>Before building the Ant 1 Compatibility layer,
you need to build
+ </div>
+ </div>
+ <div class="h3">
+ <h3><a name="Building the compatibility layer">Building the
compatibility layer</a></h3>
+ <p>Before building the Ant 1 Compatibility layer, you need
to build
Myrmidon, running the <code>dist-lite</code> target of the main
build.
See <a href="user.html#Building Myrmidon">the build
instructions</a>
for more details.</p>
- <p>To build the compatibility layer, simply
execute:</p>
- <pre>ant -f ant1compat.xml</pre>
- <p>from within the root directory of the
Myrmidon source tree.</p>
- </blockquote>
- </td></tr>
- </table>
- </td>
+ <p>To build the compatibility layer, simply
execute:</p>
+ <pre>ant -f ant1compat.xml</pre>
+ <p>from within the root directory of the Myrmidon
source tree.</p>
+ </div>
+ </div></div></td>
</tr>
-
- <!-- FOOTER -->
- <tr><td colspan="2">
- <hr noshade="" size="1"/>
- </td></tr>
- <tr><td colspan="2">
- <div align="center"><font color="#525D76" size="-1"><em>
- Copyright © 2000-2002, Apache Software Foundation
- </em></font></div>
- </td></tr>
</table>
+
+ <!-- FOOTER -->
+ <div id="footer">
+ <table border="0" cellspacing="0" cellpadding="4">
+ <tr>
+ <td>Copyright © 2000-2002, Apache Software Foundation</td>
+ </tr>
+ </table>
+ </div>
+
</body>
</html>
<!-- end the processing -->
1.7 +381 -496 jakarta-ant-myrmidon/site/docs/buildfile.html
Index: buildfile.html
===================================================================
RCS file: /home/cvs/jakarta-ant-myrmidon/site/docs/buildfile.html,v
retrieving revision 1.6
retrieving revision 1.7
diff -u -r1.6 -r1.7
--- buildfile.html 2 Jun 2002 14:05:55 -0000 1.6
+++ buildfile.html 6 Jun 2002 12:54:28 -0000 1.7
@@ -6,325 +6,301 @@
<!-- start the processing -->
<html>
<head>
+ <style type="text/css">
+ @import url("./css/tigris.css");
+ @import url("./css/site.css");
+ </style>
<meta http-equiv="Content-Type" content="text/html;
charset=iso-8859-1"/>
-
+
<meta name="author" value="Adam Murdoch">
<meta name="email" value="[EMAIL PROTECTED]">
-
+
<title>Apache Myrmidon - Using Myrmidon</title>
</head>
-
- <body bgcolor="#ffffff" text="#000000" link="#525D76">
- <table border="0" width="100%" cellspacing="0">
- <!-- TOP IMAGE -->
- <tr>
- <td> <td colspan="2">
+
+ <body marginwidth="0" marginheight="0" class="composite">
+
+ <div id="banner">
+ <table border="0" cellspacing="0" cellpadding="8" width="100%">
+ <!-- TOP IMAGE -->
+ <tr>
+ <td> <td colspan="2">
<a href="http://jakarta.apache.org"><img
src="http://jakarta.apache.org/images/jakarta-logo.gif" align="left"
border="0"/></a>
</td>
</td>
- <td valign="bottom"><div align="right"><b><font size="+3"
color="#525D76">Apache Myrmidon</font></b></div></td>
- </tr>
- </table>
- <table border="0" width="100%" cellspacing="4">
- <tr><td colspan="2">
- <hr noshade="" size="1"/>
- </td></tr>
-
- <tr>
+ <td><div align="right" valign="bottom"><b><font size="+3">Apache
Myrmidon</font></b></div></td>
+ </tr>
+ </table>
+ </div>
+
+ <table border="0" cellspacing="0" cellpadding="8" width="100%"
id="main">
+ <tr valign="top">
<!-- LEFT SIDE NAVIGATION -->
- <td valign="top" nowrap="true">
- <p><strong>Myrmidon</strong></p>
- <ul>
- <li> <a href="./index.html">Introduction</a>
- </li>
- <li> <a href="./getinvolved.html">Get Involved</a>
- </li>
- <li> <a href="./building.html">Building Myrmidon</a>
- </li>
- <li> <a href="./todo.html">Todo List</a>
- </li>
- </ul>
- <p><strong>User Guide</strong></p>
- <ul>
- <li> <a href="./running.html">Installing and Running</a>
- </li>
- <li> <a href="./buildfile.html">Project File</a>
- </li>
- <li> <a href="./vfs.html">Virtual File System</a>
- </li>
- <li> <a href="./ant1compat.html">Ant 1 Compatibility Layer</a>
- </li>
- <li> <a href="./differences.html">Differences to Ant 1</a>
- </li>
- <li> <a href="./task.html">My First Task</a>
- </li>
- </ul>
- <p><strong>Extending Myrmidon</strong></p>
- <ul>
- <li> <a href="./configuring.html">Configuration HOWTO</a>
- </li>
- <li> <a href="./converter.html">Converter HOWTO</a>
- </li>
- <li> <a href="./type.html">Type HOWTO</a>
- </li>
- <li> <a href="./classloader.html">ClassLoader HOWTO</a>
- </li>
- <li> <a href="./librarys.html">Library HOWTO</a>
- </li>
- </ul>
- <p><strong>Developers Guide</strong></p>
- <ul>
- <li> <a href="./subprojects.html">Sub Projects</a>
- </li>
- <li> <a href="./project-descriptor.html">The Build System</a>
- </li>
- </ul>
- </td>
- <td align="left" valign="top">
- <table border="0" cellspacing="0" cellpadding="2" width="100%">
- <tr><td bgcolor="#525D76">
- <font color="#ffffff" face="arial,helvetica,sanserif">
- <a name="Overview"><strong>Overview</strong></a>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
+ <td id="leftcol" width="20%">
+ <div id="navcolumn">
+ <div>
+ <strong>Myrmidon</strong>
+ <div><small> <a href="./index.html">Introduction</a>
+ </small></div>
+ <div><small> <a href="./getinvolved.html">Get Involved</a>
+ </small></div>
+ <div><small> <a href="./building.html">Building
Myrmidon</a>
+ </small></div>
+ <div><small> <a href="./todo.html">Todo List</a>
+ </small></div>
+ </div>
+ <div>
+ <strong>User Guide</strong>
+ <div><small> <a href="./running.html">Installing and
Running</a>
+ </small></div>
+ <div><small> <a href="./buildfile.html">Project File</a>
+ </small></div>
+ <div><small> <a href="./properties.html">Properties</a>
+ </small></div>
+ <div><small> <a href="./vfs.html">Virtual File System</a>
+ </small></div>
+ <div><small> <a href="./ant1compat.html">Ant 1
Compatibility Layer</a>
+ </small></div>
+ <div><small> <a href="./differences.html">Differences to
Ant 1</a>
+ </small></div>
+ <div><small> <a href="./task.html">My First Task</a>
+ </small></div>
+ </div>
+ <div>
+ <strong>Extending Myrmidon</strong>
+ <div><small> <a href="./configuring.html">Configuration
HOWTO</a>
+ </small></div>
+ <div><small> <a href="./converter.html">Converter
HOWTO</a>
+ </small></div>
+ <div><small> <a href="./type.html">Type HOWTO</a>
+ </small></div>
+ <div><small> <a href="./classloader.html">ClassLoader
HOWTO</a>
+ </small></div>
+ <div><small> <a href="./librarys.html">Library HOWTO</a>
+ </small></div>
+ </div>
+ <div>
+ <strong>Developers Guide</strong>
+ <div><small> <a href="./subprojects.html">Sub Projects</a>
+ </small></div>
+ <div><small> <a href="./project-descriptor.html">The
Build System</a>
+ </small></div>
+ </div>
+ </div>
+ </td>
+ <td><div id="bodycol"><div class="app">
+ <div class="h3">
+ <h3><a name="Overview">Overview</a></h3>
+ <p>
+ You define a build process using a <a href="#project">project</a> file.
A
+ project file is an XML file, which describes what needs to be done to
+ perform the build. A project is usually made up of several stages,
+ or <a href="#targets">targets</a>. For example, a project might be made
up
+ of a target that compiles the Java source files, another target that runs
+ unit tests, and a third target that assembles a distribution.
+ </p>
+ <p>
+ A target may <b>depend on</b> other targets. For example, a target that
+ builds a distribution, cannot do its work until the source files have
been
+ compiled. Myrmidon makes sure that targets are executed in the correct
order,
+ so that a target is executed before the targets that depend on it.
Target
+ are only executed once.
+ </p>
<p>
-You define a build process using a <a href="#project">project</a>. A project
-describes what needs to be done to perform the build. You define a project
-by breaking it up into several smaller steps, or <b>targets</b>. Targets
-represent the main stages of your build. For example, a project might have
-a target that compiles the Java source files, another target that runs unit
-tests, and a third target that assembles a distribution.
-</p>
- <p>
-A <a href="#targets">target</a> may <b>depend on</b> other targets. For
example,
-a target that builds a distribution, cannot do its work until the source
files
-have been compiled. Myrmidon makes sure that targets are executed in the
-correct order, so that a target is executed before the targets that depend
on it.
-</p>
- <p>
-You define a target using basic units of work called <a
href="#tasks">tasks</a>.
-Tasks can range from the most simple operations, such as copying a file, or
-setting a property, up to complex operations like compiling Java source, or
-running a test suite.
-</p>
- </blockquote>
- </td></tr>
- </table>
- <table border="0" cellspacing="0" cellpadding="2" width="100%">
- <tr><td bgcolor="#525D76">
- <font color="#ffffff" face="arial,helvetica,sanserif">
- <a name="project"><strong>The Project File</strong></a>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
+ You define a target using basic units of work called <a
href="#tasks">tasks</a>.
+ Tasks can range from simple operations, such as copying a file, or
setting a
+ property, up to complex operations like compiling Java source, or
running a
+ test suite.
+ </p>
<p>
-A project file is an XML file that defines a single project. The root
element
-of a project file must be a <code><project></code> element.
-It can take the following attributes:
-</p>
- <table>
- <tr>
- <td bgcolor="#039acc" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ Let's look at a simple example. The project below contains two targets,
+ called <code>compile</code> and <code>build-jar</code>. The
<code>compile</code>
+ target executes the <code>javac</code> task, which, as you probably
+ guessed, compiles up a bunch of Java source files.
+ The <code>build-jar</code> target depends on the <code>compile</code>
target,
+ which means that it will only ever get executed <i>after</i> the
+ <code>compile</code> target has been executed. The
<code>build-jar</code>
+ target executes the <code>jar</code> task, which assembles the compiled
+ class files into a Jar file.
+ </p>
+ <div id="source">
+ <pre>
+<project version="2.0" default="build-jar">
+
+ <!-- Compile the Java source -->
+ <target name="compile">
+ <javac src-dir="src/java"
dest-dir="build/classes"/>
+ </target>
+
+ <!-- Assemble a Jar file -->
+ <target name="build-jar" depends="compile">
+ <jar dest-file="build/myproject.jar">
+ <fileset dir="build/classes"/>
+ </jar>
+ </target>
+</project>
+</pre>
+ </div>
+ </div>
+ <div class="h3">
+ <h3><a name="project">The Project File</a></h3>
+ <p>
+ A project file is an XML file that defines a single project. The root
element
+ of a project file must be a <code><project></code> element.
+ It can take the following attributes:
+ </p>
+ <table cellpadding="3" cellspacing="2" border="1"
width="100%">
+ <tr class="a">
+ <th
+ >
Attribute
- </font>
- </td>
- <td bgcolor="#039acc" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </th>
+ <th
+ >
Description
- </font>
- </td>
- <td bgcolor="#039acc" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </th>
+ <th
+ >
Default Value
- </font>
- </td>
- </tr>
- <tr>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </th>
+ </tr>
+ <tr class="b">
+ <td
+ >
name
- </font>
- </td>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </td>
+ <td
+ >
The project name.
- </font>
- </td>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </td>
+ <td
+ >
The name of the project file, with the extension removed.
- </font>
- </td>
- </tr>
- <tr>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </td>
+ </tr>
+ <tr class="a">
+ <td
+ >
basedir
- </font>
- </td>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </td>
+ <td
+ >
The base directory for the project. The base directory is used
- to resolve all relative file names used in the project file.
-
- </font>
- </td>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ to resolve all relative file names used in the project file.
+
+ </td>
+ <td
+ >
The directory containing the project file.
- </font>
- </td>
- </tr>
- <tr>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </td>
+ </tr>
+ <tr class="b">
+ <td
+ >
default
- </font>
- </td>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </td>
+ <td
+ >
The name of the default target.
- </font>
- </td>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </td>
+ <td
+ >
<code>main</code>
- </font>
- </td>
- </tr>
- <tr>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </td>
+ </tr>
+ <tr class="a">
+ <td
+ >
version
- </font>
- </td>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </td>
+ <td
+ >
The project file format version that the project is written for.
- </font>
- </td>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </td>
+ <td
+ >
None, must be <code>2.0</code>
- </font>
- </td>
- </tr>
+ </td>
+ </tr>
</table>
- <p>
-A <code><project></code> element can contain the following elements,
-in the order given below:
-</p>
- <ul>
-<li><a href="#project-refs">Project references</a></li>
-<li><a href="#init-tasks">Initialization tasks</a></li>
-<li><a href="#targets">Targets</a></li>
-</ul>
- <table border="0" cellspacing="0"
cellpadding="2" width="100%">
- <tr><td bgcolor="#828DA6">
- <font color="#ffffff" face="arial,helvetica,sanserif">
- <a name="project-refs"><strong>Project
References</strong></a>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <p>Project references allow the project to import,
or reference, other projects.
+ <p>
+ A <code><project></code> element can contain the following
elements,
+ in the order given below:
+ </p>
+ <ul>
+ <li><a href="#project-refs">Project references</a></li>
+ <li><a href="#init-tasks">Initialization tasks</a></li>
+ <li><a href="#targets">Targets</a></li>
+ </ul>
+ <p>Below is a simple example, which contains two
targets:</p>
+ <div id="source">
+ <pre>
+<project version="2.0" name="some-project"
basedir="..">
+
+ <target name="compile">
+ ...
+ </target>
+
+ <target name="tests">
+ ...
+ </target>
+</project>
+</pre>
+ </div>
+ <div class="h4">
+ <h4><a name="project-refs">Project References</a></h4>
+ <p>Project references allow the project to import, or
reference, other projects.
A <code><projectref></code> element takes the following attributes:</p>
- <table>
- <tr>
- <td bgcolor="#039acc" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ <table cellpadding="3" cellspacing="2" border="1"
width="100%">
+ <tr class="a">
+ <th
+ >
Attribute
- </font>
- </td>
- <td bgcolor="#039acc" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </th>
+ <th
+ >
Description
- </font>
- </td>
- <td bgcolor="#039acc" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </th>
+ <th
+ >
Default Value
- </font>
- </td>
- </tr>
- <tr>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </th>
+ </tr>
+ <tr class="b">
+ <td
+ >
name
- </font>
- </td>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </td>
+ <td
+ >
The name to use to identify the referenced project.
- </font>
- </td>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </td>
+ <td
+ >
Required
- </font>
- </td>
- </tr>
- <tr>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </td>
+ </tr>
+ <tr class="a">
+ <td
+ >
location
- </font>
- </td>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </td>
+ <td
+ >
The path to the project file to reference.
- </font>
- </td>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </td>
+ <td
+ >
Required
- </font>
- </td>
- </tr>
+ </td>
+ </tr>
</table>
- <p>
+ <p>
The targets of a referenced project can be used in the <code>depends</code>
list
of a target in the referencing project, using the syntax
<code><i>project-name</i>-><i>target-name</i></code>. Here is a simple
example:</p>
- <div align="left">
- <table cellspacing="4" cellpadding="0" border="0">
- <tr>
- <td bgcolor="#023264" width="1" height="1"><img
src="/images/void.gif" width="1" height="1" vspace="0" hspace="0"
border="0"/></td>
- <td bgcolor="#023264" height="1"><img src="/images/void.gif"
width="1" height="1" vspace="0" hspace="0" border="0"/></td>
- <td bgcolor="#023264" width="1" height="1"><img
src="/images/void.gif" width="1" height="1" vspace="0" hspace="0"
border="0"/></td>
- </tr>
- <tr>
- <td bgcolor="#023264" width="1"><img src="/images/void.gif"
width="1" height="1" vspace="0" hspace="0" border="0"/></td>
- <td bgcolor="#ffffff"><pre>
-
+ <div id="source">
+ <pre>
<project version="2.0">
<!-- Reference another project -->
<projectref name="subproject"
location="subproject/build.xml"/>
@@ -334,245 +310,154 @@
.. do some stuff ..
</target>
</project>
-</pre></td>
- <td bgcolor="#023264" width="1"><img src="/images/void.gif"
width="1" height="1" vspace="0" hspace="0" border="0"/></td>
- </tr>
- <tr>
- <td bgcolor="#023264" width="1" height="1"><img
src="/images/void.gif" width="1" height="1" vspace="0" hspace="0"
border="0"/></td>
- <td bgcolor="#023264" height="1"><img src="/images/void.gif"
width="1" height="1" vspace="0" hspace="0" border="0"/></td>
- <td bgcolor="#023264" width="1" height="1"><img
src="/images/void.gif" width="1" height="1" vspace="0" hspace="0"
border="0"/></td>
- </tr>
- </table>
+</pre>
</div>
- </blockquote>
- </td></tr>
- </table>
- <table border="0" cellspacing="0"
cellpadding="2" width="100%">
- <tr><td bgcolor="#828DA6">
- <font color="#ffffff" face="arial,helvetica,sanserif">
- <a name="init-tasks"><strong>Initialization
Tasks</strong></a>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <p>Initialization tasks are run before any of the
project's targets are run, and
-are used to initialize the project. Any task can be used as an
initialization
-task, including <code><property></code> and data-type instances. An
example:</p>
- <div align="left">
- <table cellspacing="4" cellpadding="0" border="0">
- <tr>
- <td bgcolor="#023264" width="1" height="1"><img
src="/images/void.gif" width="1" height="1" vspace="0" hspace="0"
border="0"/></td>
- <td bgcolor="#023264" height="1"><img src="/images/void.gif"
width="1" height="1" vspace="0" hspace="0" border="0"/></td>
- <td bgcolor="#023264" width="1" height="1"><img
src="/images/void.gif" width="1" height="1" vspace="0" hspace="0"
border="0"/></td>
- </tr>
- <tr>
- <td bgcolor="#023264" width="1"><img src="/images/void.gif"
width="1" height="1" vspace="0" hspace="0" border="0"/></td>
- <td bgcolor="#ffffff"><pre>
-
+ </div>
+ <div class="h4">
+ <h4><a name="init-tasks">Initialization Tasks</a></h4>
+ <p>
+ Initialization <a href="#tasks">tasks</a> are executed before any of the
+ project's targets are executed, and are used to initialize the project.
+ Any task can be used as an initialization task, including
+ <code><property></code> and data-type instances. The
initialization
+ tasks are executed in the order they appear in the project file.
+ </p>
+ <p>Below is an example:</p>
+ <div id="source">
+ <pre>
<project version="2.0">
+ <!-- Initialization tasks -->
<property name="some-property" value="some
value"/>
- <path id="classpath">
- <fileset dir="lib"/>
- </path>
+ <path id="classpath" ... />
<log>Set classpath to ${classpath}</log>
+ <!-- Targets -->
<target name="main">
- .. do some stuff ..
+ ...
</target>
</project>
-</pre></td>
- <td bgcolor="#023264" width="1"><img src="/images/void.gif"
width="1" height="1" vspace="0" hspace="0" border="0"/></td>
- </tr>
- <tr>
- <td bgcolor="#023264" width="1" height="1"><img
src="/images/void.gif" width="1" height="1" vspace="0" hspace="0"
border="0"/></td>
- <td bgcolor="#023264" height="1"><img src="/images/void.gif"
width="1" height="1" vspace="0" hspace="0" border="0"/></td>
- <td bgcolor="#023264" width="1" height="1"><img
src="/images/void.gif" width="1" height="1" vspace="0" hspace="0"
border="0"/></td>
- </tr>
- </table>
+</pre>
</div>
- </blockquote>
- </td></tr>
- </table>
- <table border="0" cellspacing="0"
cellpadding="2" width="100%">
- <tr><td bgcolor="#828DA6">
- <font color="#ffffff" face="arial,helvetica,sanserif">
- <a name="targets"><strong>Targets</strong></a>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <p>Targets have a similar format to targets in Ant
1.x, though some of the
-behaviour is different. A <code><target></code> element takes the
-following attributes:</p>
- <table>
- <tr>
- <td bgcolor="#039acc" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </div>
+ </div>
+ <div class="h3">
+ <h3><a name="targets">Targets</a></h3>
+ <p>
+ A target is a list of tasks, contained in a <code><target></code>
+ element. When the target is executed, the tasks are executed in the
order
+ they appear in the project file. A target may also have a list of
dependencies.
+ These are targets that must be executed before the target is executed.
+ </p>
+ <p>A <code><target></code> element takes the
following attributes:</p>
+ <table cellpadding="3" cellspacing="2" border="1"
width="100%">
+ <tr class="a">
+ <th
+ >
Attribute
- </font>
- </td>
- <td bgcolor="#039acc" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </th>
+ <th
+ >
Description
- </font>
- </td>
- <td bgcolor="#039acc" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </th>
+ <th
+ >
Default Value
- </font>
- </td>
- </tr>
- <tr>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
- name
- </font>
- </td>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
- The name of the target.
- </font>
- </td>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
- Required
- </font>
- </td>
- </tr>
- <tr>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </th>
+ </tr>
+ <tr class="b">
+ <td
+ >
+ description
+ </td>
+ <td
+ >
+ A description of the target.
+ </td>
+ <td
+ >
+ None
+ </td>
+ </tr>
+ <tr class="a">
+ <td
+ >
depends
- </font>
- </td>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </td>
+ <td
+ >
A comma-separated list of targets that this target depends on.
- This list can contain targets from referenced projects.
- </font>
- </td>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ This list can contain targets from referenced projects.
+ </td>
+ <td
+ >
None
- </font>
- </td>
- </tr>
+ </td>
+ </tr>
+ <tr class="b">
+ <td
+ >
+ name
+ </td>
+ <td
+ >
+ The name of the target.
+ </td>
+ <td
+ >
+ Required
+ </td>
+ </tr>
</table>
- </blockquote>
- </td></tr>
- </table>
- </blockquote>
- </td></tr>
- </table>
- <table border="0" cellspacing="0" cellpadding="2" width="100%">
- <tr><td bgcolor="#525D76">
- <font color="#ffffff" face="arial,helvetica,sanserif">
- <a name="Tasks"><strong>Tasks</strong></a>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
+ <p>An example project, with two targets:</p>
+ <div id="source">
+ <pre>
+<project version="2.0" default="jars">
+
+ <target name="compile" description="Compiles the Java
source">
+ <javac ... />
+ </target>
+
+ <target name="jars" depends="compile"
description="Builds the Jar file">
+ <jar ... />
+ </target>
+
+</project>
+</pre>
+ </div>
+ </div>
+ <div class="h3">
+ <h3><a name="tasks">Tasks</a></h3>
+ <p>
+ A task is represented as an XML element, where the name of the task is
used
+ as the element name. The attributes and nested elements that a task
allows
+ depend on the task. Below are two example tasks:
+ </p>
+ <div id="source">
+ <pre>
+<property name="a-prop" value="some value"/>
+<log>This is a log message.</log>
+</pre>
+ </div>
<p>
- Listed below are some of the current set of tasks. You can find example
- usages of these tasks in the sample project file
<code>src/make/sample.ant</code>.
+ Some tasks may contain other tasks. You can find out about how to write
+ your own tasks <a href="task.html">here</a>.
</p>
- <h3><code><condition></code></h3>
- <p>Sets a property if a particular condition
is true. See
- <a href="#Conditions">Conditions</a> for a list of available
conditions.</p>
- <h3><code><fail></code></h3>
- <p>Causes the build to fail.</p>
- <h3><code><if></code></h3>
- <p>Conditionally executes a set of tasks.</p>
- <h3><code><load-properties></code></h3>
- <p>Loads a set of properties from a file.</p>
- <h3><code><log></code></h3>
- <p>Writes a log message.</p>
- <h3><code><property></code></h3>
- <p>Sets a property.</p>
- <h3><code><try-catch></code></h3>
- <p>Runs a set of tasks, with a provided
error and clean-up handler.</p>
- <h3><code><converter-def></code></h3>
- <p>Register a type converter. These are
used when configuring a task
- or data-type from attributes.</p>
- <h3><code><type-def></code></h3>
- <p>Register a task or data-type.</p>
- <h3><code><import></code></h3>
- <p>Register the contents of an antlib.</p>
- </blockquote>
- </td></tr>
- </table>
- <table border="0" cellspacing="0" cellpadding="2" width="100%">
- <tr><td bgcolor="#525D76">
- <font color="#ffffff" face="arial,helvetica,sanserif">
- <a name="Conditions"><strong>Conditions</strong></a>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <p>The following conditions are available </p>
- <h3><code><and></code></h3>
- <p>Evaluates a set of nested conditions, and
AND them together. Evaluation is
- lazy. An empty <code><and></code> condition evaluates to true.</p>
- <h3><code><available></code></h3>
- <p>Tests if a particular class or resource
is available.</p>
- <h3><code><file-test></code></h3>
- <p>Tests a file against a set of <a
href="vfs.html#File Selectors">file selectors</a>.</p>
- <h3><code><is-set></code></h3>
- <p>Tests whether a proeprty is set, and not
set to 'false'.</p>
- <h3><code><or></code></h3>
- <p>Evaluates a set of nested conditions, and
OR them together. Evaluation is
- lazy. An empty <code><or></code> evaluates to true.</p>
- <h3><code><os></code></h3>
- <p>Tests which operating system the build is
running on.</p>
- <h3><code><not></code></h3>
- <p>Negates a nested condition.</p>
- </blockquote>
- </td></tr>
- </table>
- <table border="0" cellspacing="0" cellpadding="2" width="100%">
- <tr><td bgcolor="#525D76">
- <font color="#ffffff" face="arial,helvetica,sanserif">
- <a name="File Name Mappers"><strong>File Name
Mappers</strong></a>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <p>The following file name mappers are available:</p>
- <h3><code><chain></code></h3>
- <p>Applies a set of nested file name mappers
to file names.</p>
- <h3><code><flatten></code></h3>
- <p>Maps all file names to a single
directory.</p>
- <h3><code><prefix></code></h3>
- <p>Adds a prefix to the front of each file
name.</p>
- <h3><code><map-extension></code></h3>
- <p>Changes the extension of file names.</p>
- </blockquote>
- </td></tr>
- </table>
- </td>
- </tr>
-
- <!-- FOOTER -->
- <tr><td colspan="2">
- <hr noshade="" size="1"/>
- </td></tr>
- <tr><td colspan="2">
- <div align="center"><font color="#525D76" size="-1"><em>
- Copyright © 2000-2002, Apache Software Foundation
- </em></font></div>
- </td></tr>
+ </div>
+ </div></div></td>
+ </tr>
</table>
+
+ <!-- FOOTER -->
+ <div id="footer">
+ <table border="0" cellspacing="0" cellpadding="4">
+ <tr>
+ <td>Copyright © 2000-2002, Apache Software Foundation</td>
+ </tr>
+ </table>
+ </div>
+
</body>
</html>
<!-- end the processing -->
1.3 +125 -143 jakarta-ant-myrmidon/site/docs/building.html
Index: building.html
===================================================================
RCS file: /home/cvs/jakarta-ant-myrmidon/site/docs/building.html,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- building.html 19 May 2002 13:37:50 -0000 1.2
+++ building.html 6 Jun 2002 12:54:28 -0000 1.3
@@ -6,95 +6,97 @@
<!-- start the processing -->
<html>
<head>
+ <style type="text/css">
+ @import url("./css/tigris.css");
+ @import url("./css/site.css");
+ </style>
<meta http-equiv="Content-Type" content="text/html;
charset=iso-8859-1"/>
-
+
<meta name="author" value="Adam Murdoch">
<meta name="email" value="[EMAIL PROTECTED]">
-
+
<title>Apache Myrmidon - Building Myrmidon</title>
</head>
-
- <body bgcolor="#ffffff" text="#000000" link="#525D76">
- <table border="0" width="100%" cellspacing="0">
- <!-- TOP IMAGE -->
- <tr>
- <td> <td colspan="2">
+
+ <body marginwidth="0" marginheight="0" class="composite">
+
+ <div id="banner">
+ <table border="0" cellspacing="0" cellpadding="8" width="100%">
+ <!-- TOP IMAGE -->
+ <tr>
+ <td> <td colspan="2">
<a href="http://jakarta.apache.org"><img
src="http://jakarta.apache.org/images/jakarta-logo.gif" align="left"
border="0"/></a>
</td>
</td>
- <td valign="bottom"><div align="right"><b><font size="+3"
color="#525D76">Apache Myrmidon</font></b></div></td>
- </tr>
- </table>
- <table border="0" width="100%" cellspacing="4">
- <tr><td colspan="2">
- <hr noshade="" size="1"/>
- </td></tr>
-
- <tr>
+ <td><div align="right" valign="bottom"><b><font size="+3">Apache
Myrmidon</font></b></div></td>
+ </tr>
+ </table>
+ </div>
+
+ <table border="0" cellspacing="0" cellpadding="8" width="100%"
id="main">
+ <tr valign="top">
<!-- LEFT SIDE NAVIGATION -->
- <td valign="top" nowrap="true">
- <p><strong>Myrmidon</strong></p>
- <ul>
- <li> <a href="./index.html">Introduction</a>
- </li>
- <li> <a href="./getinvolved.html">Get Involved</a>
- </li>
- <li> <a href="./building.html">Building Myrmidon</a>
- </li>
- <li> <a href="./todo.html">Todo List</a>
- </li>
- </ul>
- <p><strong>User Guide</strong></p>
- <ul>
- <li> <a href="./running.html">Installing and Running</a>
- </li>
- <li> <a href="./buildfile.html">Project File</a>
- </li>
- <li> <a href="./vfs.html">Virtual File System</a>
- </li>
- <li> <a href="./ant1compat.html">Ant 1 Compatibility Layer</a>
- </li>
- <li> <a href="./differences.html">Differences to Ant 1</a>
- </li>
- <li> <a href="./task.html">My First Task</a>
- </li>
- </ul>
- <p><strong>Extending Myrmidon</strong></p>
- <ul>
- <li> <a href="./configuring.html">Configuration HOWTO</a>
- </li>
- <li> <a href="./converter.html">Converter HOWTO</a>
- </li>
- <li> <a href="./type.html">Type HOWTO</a>
- </li>
- <li> <a href="./classloader.html">ClassLoader HOWTO</a>
- </li>
- <li> <a href="./librarys.html">Library HOWTO</a>
- </li>
- </ul>
- <p><strong>Developers Guide</strong></p>
- <ul>
- <li> <a href="./subprojects.html">Sub Projects</a>
- </li>
- <li> <a href="./project-descriptor.html">The Build System</a>
- </li>
- </ul>
- </td>
- <td align="left" valign="top">
- <table border="0" cellspacing="0" cellpadding="2" width="100%">
- <tr><td bgcolor="#525D76">
- <font color="#ffffff" face="arial,helvetica,sanserif">
- <a name="Building Myrmidon"><strong>Building
Myrmidon</strong></a>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <p>
+ <td id="leftcol" width="20%">
+ <div id="navcolumn">
+ <div>
+ <strong>Myrmidon</strong>
+ <div><small> <a href="./index.html">Introduction</a>
+ </small></div>
+ <div><small> <a href="./getinvolved.html">Get Involved</a>
+ </small></div>
+ <div><small> <a href="./building.html">Building
Myrmidon</a>
+ </small></div>
+ <div><small> <a href="./todo.html">Todo List</a>
+ </small></div>
+ </div>
+ <div>
+ <strong>User Guide</strong>
+ <div><small> <a href="./running.html">Installing and
Running</a>
+ </small></div>
+ <div><small> <a href="./buildfile.html">Project File</a>
+ </small></div>
+ <div><small> <a href="./properties.html">Properties</a>
+ </small></div>
+ <div><small> <a href="./vfs.html">Virtual File System</a>
+ </small></div>
+ <div><small> <a href="./ant1compat.html">Ant 1
Compatibility Layer</a>
+ </small></div>
+ <div><small> <a href="./differences.html">Differences to
Ant 1</a>
+ </small></div>
+ <div><small> <a href="./task.html">My First Task</a>
+ </small></div>
+ </div>
+ <div>
+ <strong>Extending Myrmidon</strong>
+ <div><small> <a href="./configuring.html">Configuration
HOWTO</a>
+ </small></div>
+ <div><small> <a href="./converter.html">Converter
HOWTO</a>
+ </small></div>
+ <div><small> <a href="./type.html">Type HOWTO</a>
+ </small></div>
+ <div><small> <a href="./classloader.html">ClassLoader
HOWTO</a>
+ </small></div>
+ <div><small> <a href="./librarys.html">Library HOWTO</a>
+ </small></div>
+ </div>
+ <div>
+ <strong>Developers Guide</strong>
+ <div><small> <a href="./subprojects.html">Sub Projects</a>
+ </small></div>
+ <div><small> <a href="./project-descriptor.html">The
Build System</a>
+ </small></div>
+ </div>
+ </div>
+ </td>
+ <td><div id="bodycol"><div class="app">
+ <div class="h3">
+ <h3><a name="Building Myrmidon">Building Myrmidon</a></h3>
+ <p>
First, you will need to fetch the Myrmidon source from CVS. The source
can be found in the <code>jakarta-ant-myrmidon</code> CVS module. Details
can
be found <a href="http://jakarta.apache.org/site/cvsindex.html">here</a>.
</p>
- <p>
+ <p>
To build Myrmidon, use the <code>build.xml</code> file in the root of the
source
tree. You will need to use Ant 1.5 or later, and you will need to include
junit
and xalan in your CLASSPATH. The default target builds a minimal Myrmidon
@@ -103,87 +105,67 @@
build a full Myrmidon distribution, including all documentation, into the
<code>myrmidon/distributions</code> directory.
</p>
- <p>There are a number features that are not
built unless the appropriate optional Jar
+ <p>There are a number features that are not built
unless the appropriate optional Jar
files are found in the <code>lib</code> directory:</p>
- <table>
- <tr>
- <td bgcolor="#039acc" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ <table cellpadding="3" cellspacing="2" border="1"
width="100%">
+ <tr class="a">
+ <th
+ >
Feature
- </font>
- </td>
- <td bgcolor="#039acc" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </th>
+ <th
+ >
Jar File
- </font>
- </td>
- <td bgcolor="#039acc" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </th>
+ <th
+ >
Download From
- </font>
- </td>
- </tr>
- <tr>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </th>
+ </tr>
+ <tr class="b">
+ <td
+ >
SMB VFS support (Samba, Windows shares)
- </font>
- </td>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </td>
+ <td
+ >
jcifs.jar
- </font>
- </td>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </td>
+ <td
+ >
<a href="http://jcifs.samba.org">jcifs.samba.org</a>.
<p>Note: there are problems using the 0.6.1 release. Try 0.6.0
instead.</p>
- </font>
- </td>
- </tr>
- <tr>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </td>
+ </tr>
+ <tr class="a">
+ <td
+ >
FTP VFS support
- </font>
- </td>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </td>
+ <td
+ >
netcomponents.jar
- </font>
- </td>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </td>
+ <td
+ >
<a
href="http://www.savarese.org/oro/software/NetComponents.html">www.savarese.org</a>
- </font>
- </td>
- </tr>
+ </td>
+ </tr>
</table>
- </blockquote>
- </td></tr>
- </table>
- </td>
+ </div>
+ </div></div></td>
</tr>
-
- <!-- FOOTER -->
- <tr><td colspan="2">
- <hr noshade="" size="1"/>
- </td></tr>
- <tr><td colspan="2">
- <div align="center"><font color="#525D76" size="-1"><em>
- Copyright © 2000-2002, Apache Software Foundation
- </em></font></div>
- </td></tr>
</table>
+
+ <!-- FOOTER -->
+ <div id="footer">
+ <table border="0" cellspacing="0" cellpadding="4">
+ <tr>
+ <td>Copyright © 2000-2002, Apache Software Foundation</td>
+ </tr>
+ </table>
+ </div>
+
</body>
</html>
<!-- end the processing -->
1.6 +95 -111 jakarta-ant-myrmidon/site/docs/classloader.html
Index: classloader.html
===================================================================
RCS file: /home/cvs/jakarta-ant-myrmidon/site/docs/classloader.html,v
retrieving revision 1.5
retrieving revision 1.6
diff -u -r1.5 -r1.6
--- classloader.html 19 May 2002 13:37:50 -0000 1.5
+++ classloader.html 6 Jun 2002 12:54:28 -0000 1.6
@@ -6,115 +6,109 @@
<!-- start the processing -->
<html>
<head>
+ <style type="text/css">
+ @import url("./css/tigris.css");
+ @import url("./css/site.css");
+ </style>
<meta http-equiv="Content-Type" content="text/html;
charset=iso-8859-1"/>
-
+
<meta name="author" value="Peter Donald">
<meta name="email" value="[EMAIL PROTECTED]">
-
+
<title>Apache Myrmidon - On ClassLoaders in Ant 2</title>
</head>
-
- <body bgcolor="#ffffff" text="#000000" link="#525D76">
- <table border="0" width="100%" cellspacing="0">
- <!-- TOP IMAGE -->
- <tr>
- <td> <td colspan="2">
+
+ <body marginwidth="0" marginheight="0" class="composite">
+
+ <div id="banner">
+ <table border="0" cellspacing="0" cellpadding="8" width="100%">
+ <!-- TOP IMAGE -->
+ <tr>
+ <td> <td colspan="2">
<a href="http://jakarta.apache.org"><img
src="http://jakarta.apache.org/images/jakarta-logo.gif" align="left"
border="0"/></a>
</td>
</td>
- <td valign="bottom"><div align="right"><b><font size="+3"
color="#525D76">Apache Myrmidon</font></b></div></td>
- </tr>
- </table>
- <table border="0" width="100%" cellspacing="4">
- <tr><td colspan="2">
- <hr noshade="" size="1"/>
- </td></tr>
-
- <tr>
+ <td><div align="right" valign="bottom"><b><font size="+3">Apache
Myrmidon</font></b></div></td>
+ </tr>
+ </table>
+ </div>
+
+ <table border="0" cellspacing="0" cellpadding="8" width="100%"
id="main">
+ <tr valign="top">
<!-- LEFT SIDE NAVIGATION -->
- <td valign="top" nowrap="true">
- <p><strong>Myrmidon</strong></p>
- <ul>
- <li> <a href="./index.html">Introduction</a>
- </li>
- <li> <a href="./getinvolved.html">Get Involved</a>
- </li>
- <li> <a href="./building.html">Building Myrmidon</a>
- </li>
- <li> <a href="./todo.html">Todo List</a>
- </li>
- </ul>
- <p><strong>User Guide</strong></p>
- <ul>
- <li> <a href="./running.html">Installing and Running</a>
- </li>
- <li> <a href="./buildfile.html">Project File</a>
- </li>
- <li> <a href="./vfs.html">Virtual File System</a>
- </li>
- <li> <a href="./ant1compat.html">Ant 1 Compatibility Layer</a>
- </li>
- <li> <a href="./differences.html">Differences to Ant 1</a>
- </li>
- <li> <a href="./task.html">My First Task</a>
- </li>
- </ul>
- <p><strong>Extending Myrmidon</strong></p>
- <ul>
- <li> <a href="./configuring.html">Configuration HOWTO</a>
- </li>
- <li> <a href="./converter.html">Converter HOWTO</a>
- </li>
- <li> <a href="./type.html">Type HOWTO</a>
- </li>
- <li> <a href="./classloader.html">ClassLoader HOWTO</a>
- </li>
- <li> <a href="./librarys.html">Library HOWTO</a>
- </li>
- </ul>
- <p><strong>Developers Guide</strong></p>
- <ul>
- <li> <a href="./subprojects.html">Sub Projects</a>
- </li>
- <li> <a href="./project-descriptor.html">The Build System</a>
- </li>
- </ul>
- </td>
- <td align="left" valign="top">
- <table border="0" cellspacing="0" cellpadding="2" width="100%">
- <tr><td bgcolor="#525D76">
- <font color="#ffffff" face="arial,helvetica,sanserif">
- <a name="ClassLoader Management"><strong>ClassLoader
Management</strong></a>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <p>In many ways Ant 2 needs to follow rules similar
to a number of
+ <td id="leftcol" width="20%">
+ <div id="navcolumn">
+ <div>
+ <strong>Myrmidon</strong>
+ <div><small> <a href="./index.html">Introduction</a>
+ </small></div>
+ <div><small> <a href="./getinvolved.html">Get Involved</a>
+ </small></div>
+ <div><small> <a href="./building.html">Building
Myrmidon</a>
+ </small></div>
+ <div><small> <a href="./todo.html">Todo List</a>
+ </small></div>
+ </div>
+ <div>
+ <strong>User Guide</strong>
+ <div><small> <a href="./running.html">Installing and
Running</a>
+ </small></div>
+ <div><small> <a href="./buildfile.html">Project File</a>
+ </small></div>
+ <div><small> <a href="./properties.html">Properties</a>
+ </small></div>
+ <div><small> <a href="./vfs.html">Virtual File System</a>
+ </small></div>
+ <div><small> <a href="./ant1compat.html">Ant 1
Compatibility Layer</a>
+ </small></div>
+ <div><small> <a href="./differences.html">Differences to
Ant 1</a>
+ </small></div>
+ <div><small> <a href="./task.html">My First Task</a>
+ </small></div>
+ </div>
+ <div>
+ <strong>Extending Myrmidon</strong>
+ <div><small> <a href="./configuring.html">Configuration
HOWTO</a>
+ </small></div>
+ <div><small> <a href="./converter.html">Converter
HOWTO</a>
+ </small></div>
+ <div><small> <a href="./type.html">Type HOWTO</a>
+ </small></div>
+ <div><small> <a href="./classloader.html">ClassLoader
HOWTO</a>
+ </small></div>
+ <div><small> <a href="./librarys.html">Library HOWTO</a>
+ </small></div>
+ </div>
+ <div>
+ <strong>Developers Guide</strong>
+ <div><small> <a href="./subprojects.html">Sub Projects</a>
+ </small></div>
+ <div><small> <a href="./project-descriptor.html">The
Build System</a>
+ </small></div>
+ </div>
+ </div>
+ </td>
+ <td><div id="bodycol"><div class="app">
+ <div class="h3">
+ <h3><a name="ClassLoader Management">ClassLoader
Management</a></h3>
+ <p>In many ways Ant 2 needs to follow rules similar to a
number of
different application servers with respect to ClassLoader
management.
Ant 2 will create a number of different ClassLoaders that have
access
to different sets of resources (and thus Classes). The main
reason
for this arrangment is to partition different sections of the
application such as the Container, the Task API, task/type
libraries
and support libraries.</p>
- <p>The recomended structure for ClassLoader
relationships is a hierarchy.
+ <p>The recomended structure for ClassLoader
relationships is a hierarchy.
When a ClassLoader is asked for a resource (or a class) it first
delegates
to it's parent to ask for the resource. If the resource is not
present in
its parent ClassLoader then the ClassLoader attempts to locate
the resource
in it's own store. In practice this means that all the classes
(and static
variables defined by said classes) in a parent ClassLoader are
shared with
the child ClassLoaders.</p>
- <p>Using kooky ascii art, the specific
ClassLoader structure for Ant 2 is as
+ <p>Using kooky ascii art, the specific ClassLoader
structure for Ant 2 is as
follows:</p>
- <div align="left">
- <table cellspacing="4" cellpadding="0" border="0">
- <tr>
- <td bgcolor="#023264" width="1" height="1"><img
src="/images/void.gif" width="1" height="1" vspace="0" hspace="0"
border="0"/></td>
- <td bgcolor="#023264" height="1"><img src="/images/void.gif"
width="1" height="1" vspace="0" hspace="0" border="0"/></td>
- <td bgcolor="#023264" width="1" height="1"><img
src="/images/void.gif" width="1" height="1" vspace="0" hspace="0"
border="0"/></td>
- </tr>
- <tr>
- <td bgcolor="#023264" width="1"><img src="/images/void.gif"
width="1" height="1" vspace="0" hspace="0" border="0"/></td>
- <td bgcolor="#ffffff"><pre>
+ <div id="source">
+ <pre>
Bootstrap
|
System
@@ -124,17 +118,9 @@
Container Shared
/ \
Antlib1 Antlib2 ...
- </pre></td>
- <td bgcolor="#023264" width="1"><img src="/images/void.gif"
width="1" height="1" vspace="0" hspace="0" border="0"/></td>
- </tr>
- <tr>
- <td bgcolor="#023264" width="1" height="1"><img
src="/images/void.gif" width="1" height="1" vspace="0" hspace="0"
border="0"/></td>
- <td bgcolor="#023264" height="1"><img src="/images/void.gif"
width="1" height="1" vspace="0" hspace="0" border="0"/></td>
- <td bgcolor="#023264" width="1" height="1"><img
src="/images/void.gif" width="1" height="1" vspace="0" hspace="0"
border="0"/></td>
- </tr>
- </table>
+ </pre>
</div>
- <ul>
+ <ul>
<li>
The
<strong>Bootstrap</strong> ClassLoader contains the
classes and resources
@@ -222,22 +208,20 @@
</li>
</ul>
- </blockquote>
- </td></tr>
- </table>
- </td>
+ </div>
+ </div></div></td>
</tr>
-
- <!-- FOOTER -->
- <tr><td colspan="2">
- <hr noshade="" size="1"/>
- </td></tr>
- <tr><td colspan="2">
- <div align="center"><font color="#525D76" size="-1"><em>
- Copyright © 2000-2002, Apache Software Foundation
- </em></font></div>
- </td></tr>
</table>
+
+ <!-- FOOTER -->
+ <div id="footer">
+ <table border="0" cellspacing="0" cellpadding="4">
+ <tr>
+ <td>Copyright © 2000-2002, Apache Software Foundation</td>
+ </tr>
+ </table>
+ </div>
+
</body>
</html>
<!-- end the processing -->
1.6 +158 -278 jakarta-ant-myrmidon/site/docs/configuring.html
Index: configuring.html
===================================================================
RCS file: /home/cvs/jakarta-ant-myrmidon/site/docs/configuring.html,v
retrieving revision 1.5
retrieving revision 1.6
diff -u -r1.5 -r1.6
--- configuring.html 19 May 2002 13:37:50 -0000 1.5
+++ configuring.html 6 Jun 2002 12:54:28 -0000 1.6
@@ -6,234 +6,172 @@
<!-- start the processing -->
<html>
<head>
+ <style type="text/css">
+ @import url("./css/tigris.css");
+ @import url("./css/site.css");
+ </style>
<meta http-equiv="Content-Type" content="text/html;
charset=iso-8859-1"/>
-
+
<meta name="author" value="Peter Donald">
<meta name="email" value="[EMAIL PROTECTED]">
-
+
<title>Apache Myrmidon - On Task Configuring in Ant 2</title>
</head>
-
- <body bgcolor="#ffffff" text="#000000" link="#525D76">
- <table border="0" width="100%" cellspacing="0">
- <!-- TOP IMAGE -->
- <tr>
- <td> <td colspan="2">
+
+ <body marginwidth="0" marginheight="0" class="composite">
+
+ <div id="banner">
+ <table border="0" cellspacing="0" cellpadding="8" width="100%">
+ <!-- TOP IMAGE -->
+ <tr>
+ <td> <td colspan="2">
<a href="http://jakarta.apache.org"><img
src="http://jakarta.apache.org/images/jakarta-logo.gif" align="left"
border="0"/></a>
</td>
</td>
- <td valign="bottom"><div align="right"><b><font size="+3"
color="#525D76">Apache Myrmidon</font></b></div></td>
- </tr>
- </table>
- <table border="0" width="100%" cellspacing="4">
- <tr><td colspan="2">
- <hr noshade="" size="1"/>
- </td></tr>
-
- <tr>
+ <td><div align="right" valign="bottom"><b><font size="+3">Apache
Myrmidon</font></b></div></td>
+ </tr>
+ </table>
+ </div>
+
+ <table border="0" cellspacing="0" cellpadding="8" width="100%"
id="main">
+ <tr valign="top">
<!-- LEFT SIDE NAVIGATION -->
- <td valign="top" nowrap="true">
- <p><strong>Myrmidon</strong></p>
- <ul>
- <li> <a href="./index.html">Introduction</a>
- </li>
- <li> <a href="./getinvolved.html">Get Involved</a>
- </li>
- <li> <a href="./building.html">Building Myrmidon</a>
- </li>
- <li> <a href="./todo.html">Todo List</a>
- </li>
- </ul>
- <p><strong>User Guide</strong></p>
- <ul>
- <li> <a href="./running.html">Installing and Running</a>
- </li>
- <li> <a href="./buildfile.html">Project File</a>
- </li>
- <li> <a href="./vfs.html">Virtual File System</a>
- </li>
- <li> <a href="./ant1compat.html">Ant 1 Compatibility Layer</a>
- </li>
- <li> <a href="./differences.html">Differences to Ant 1</a>
- </li>
- <li> <a href="./task.html">My First Task</a>
- </li>
- </ul>
- <p><strong>Extending Myrmidon</strong></p>
- <ul>
- <li> <a href="./configuring.html">Configuration HOWTO</a>
- </li>
- <li> <a href="./converter.html">Converter HOWTO</a>
- </li>
- <li> <a href="./type.html">Type HOWTO</a>
- </li>
- <li> <a href="./classloader.html">ClassLoader HOWTO</a>
- </li>
- <li> <a href="./librarys.html">Library HOWTO</a>
- </li>
- </ul>
- <p><strong>Developers Guide</strong></p>
- <ul>
- <li> <a href="./subprojects.html">Sub Projects</a>
- </li>
- <li> <a href="./project-descriptor.html">The Build System</a>
- </li>
- </ul>
- </td>
- <td align="left" valign="top">
- <table border="0" cellspacing="0" cellpadding="2" width="100%">
- <tr><td bgcolor="#525D76">
- <font color="#ffffff" face="arial,helvetica,sanserif">
- <a name="Introduction"><strong>Introduction</strong></a>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <p>This section will describe in detail the
mechanism via which tasks are
+ <td id="leftcol" width="20%">
+ <div id="navcolumn">
+ <div>
+ <strong>Myrmidon</strong>
+ <div><small> <a href="./index.html">Introduction</a>
+ </small></div>
+ <div><small> <a href="./getinvolved.html">Get Involved</a>
+ </small></div>
+ <div><small> <a href="./building.html">Building
Myrmidon</a>
+ </small></div>
+ <div><small> <a href="./todo.html">Todo List</a>
+ </small></div>
+ </div>
+ <div>
+ <strong>User Guide</strong>
+ <div><small> <a href="./running.html">Installing and
Running</a>
+ </small></div>
+ <div><small> <a href="./buildfile.html">Project File</a>
+ </small></div>
+ <div><small> <a href="./properties.html">Properties</a>
+ </small></div>
+ <div><small> <a href="./vfs.html">Virtual File System</a>
+ </small></div>
+ <div><small> <a href="./ant1compat.html">Ant 1
Compatibility Layer</a>
+ </small></div>
+ <div><small> <a href="./differences.html">Differences to
Ant 1</a>
+ </small></div>
+ <div><small> <a href="./task.html">My First Task</a>
+ </small></div>
+ </div>
+ <div>
+ <strong>Extending Myrmidon</strong>
+ <div><small> <a href="./configuring.html">Configuration
HOWTO</a>
+ </small></div>
+ <div><small> <a href="./converter.html">Converter
HOWTO</a>
+ </small></div>
+ <div><small> <a href="./type.html">Type HOWTO</a>
+ </small></div>
+ <div><small> <a href="./classloader.html">ClassLoader
HOWTO</a>
+ </small></div>
+ <div><small> <a href="./librarys.html">Library HOWTO</a>
+ </small></div>
+ </div>
+ <div>
+ <strong>Developers Guide</strong>
+ <div><small> <a href="./subprojects.html">Sub Projects</a>
+ </small></div>
+ <div><small> <a href="./project-descriptor.html">The
Build System</a>
+ </small></div>
+ </div>
+ </div>
+ </td>
+ <td><div id="bodycol"><div class="app">
+ <div class="h3">
+ <h3><a name="Introduction">Introduction</a></h3>
+ <p>This section will describe in detail the mechanism via
which tasks are
configured. Configuration is the name given to the stage in tasks
lifecycle via which the XML representation is mapped onto the
task
object.</p>
- </blockquote>
- </td></tr>
- </table>
- <table border="0" cellspacing="0" cellpadding="2" width="100%">
- <tr><td bgcolor="#525D76">
- <font color="#ffffff" face="arial,helvetica,sanserif">
- <a name="Names"><strong>Names</strong></a>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <p>When mapping the XML representation on to the
task object you
+ </div>
+ <div class="h3">
+ <h3><a name="Names">Names</a></h3>
+ <p>When mapping the XML representation on to the task
object you
need to be able map the names as they appear in the XML to the
names as they appear in the Java code. The process is for
generating
a java name from the xml name is as follows.</p>
- <ol>
+ <ol>
<li>Capitalize the first character of name.</li>
<li>Find any '-' characters in XML name and remove character
and
capitalize the following letter. (And there must be a
following
letter)</li>
</ol>
- <p>Some example mappings;</p>
- <div align="left">
- <table cellspacing="4" cellpadding="0" border="0">
- <tr>
- <td bgcolor="#023264" width="1" height="1"><img
src="/images/void.gif" width="1" height="1" vspace="0" hspace="0"
border="0"/></td>
- <td bgcolor="#023264" height="1"><img src="/images/void.gif"
width="1" height="1" vspace="0" hspace="0" border="0"/></td>
- <td bgcolor="#023264" width="1" height="1"><img
src="/images/void.gif" width="1" height="1" vspace="0" hspace="0"
border="0"/></td>
- </tr>
- <tr>
- <td bgcolor="#023264" width="1"><img src="/images/void.gif"
width="1" height="1" vspace="0" hspace="0" border="0"/></td>
- <td bgcolor="#ffffff"><pre>
+ <p>Some example mappings;</p>
+ <div id="source">
+ <pre>
my-name ===> MyName
aString ===> AString
Basedir ===> Basedir
baseDir ===> BaseDir
-url ===> Url</pre></td>
- <td bgcolor="#023264" width="1"><img src="/images/void.gif"
width="1" height="1" vspace="0" hspace="0" border="0"/></td>
- </tr>
- <tr>
- <td bgcolor="#023264" width="1" height="1"><img
src="/images/void.gif" width="1" height="1" vspace="0" hspace="0"
border="0"/></td>
- <td bgcolor="#023264" height="1"><img src="/images/void.gif"
width="1" height="1" vspace="0" hspace="0" border="0"/></td>
- <td bgcolor="#023264" width="1" height="1"><img
src="/images/void.gif" width="1" height="1" vspace="0" hspace="0"
border="0"/></td>
- </tr>
- </table>
+url ===> Url</pre>
</div>
- <p>Note that the above transformation is
lossy and as such the
+ <p>Note that the above transformation is lossy and
as such the
following XML names all map to the same Java name. The ant1.x
mapping
is similarly lossy and in practice this has not been an
issue.</p>
- <div align="left">
- <table cellspacing="4" cellpadding="0" border="0">
- <tr>
- <td bgcolor="#023264" width="1" height="1"><img
src="/images/void.gif" width="1" height="1" vspace="0" hspace="0"
border="0"/></td>
- <td bgcolor="#023264" height="1"><img src="/images/void.gif"
width="1" height="1" vspace="0" hspace="0" border="0"/></td>
- <td bgcolor="#023264" width="1" height="1"><img
src="/images/void.gif" width="1" height="1" vspace="0" hspace="0"
border="0"/></td>
- </tr>
- <tr>
- <td bgcolor="#023264" width="1"><img src="/images/void.gif"
width="1" height="1" vspace="0" hspace="0" border="0"/></td>
- <td bgcolor="#ffffff"><pre>
+ <div id="source">
+ <pre>
base-dir ===> BaseDir
Base-dir ===> BaseDir
baseDir ===> BaseDir
-BaseDir ===> BaseDir</pre></td>
- <td bgcolor="#023264" width="1"><img src="/images/void.gif"
width="1" height="1" vspace="0" hspace="0" border="0"/></td>
- </tr>
- <tr>
- <td bgcolor="#023264" width="1" height="1"><img
src="/images/void.gif" width="1" height="1" vspace="0" hspace="0"
border="0"/></td>
- <td bgcolor="#023264" height="1"><img src="/images/void.gif"
width="1" height="1" vspace="0" hspace="0" border="0"/></td>
- <td bgcolor="#023264" width="1" height="1"><img
src="/images/void.gif" width="1" height="1" vspace="0" hspace="0"
border="0"/></td>
- </tr>
- </table>
+BaseDir ===> BaseDir</pre>
</div>
- <p><i>NOTE: We should really resolve this
and either disallow '-' characters
+ <p><i>NOTE: We should really resolve this and either
disallow '-' characters
or disallow uppercase or something. (PD)</i></p>
- </blockquote>
- </td></tr>
- </table>
- <table border="0" cellspacing="0" cellpadding="2" width="100%">
- <tr><td bgcolor="#525D76">
- <font color="#ffffff" face="arial,helvetica,sanserif">
- <a name="Resolving Values"><strong>Resolving
Values</strong></a>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <p>The first stage of mapping the XML representation
to the task
+ </div>
+ <div class="h3">
+ <h3><a name="Resolving Values">Resolving Values</a></h3>
+ <p>The first stage of mapping the XML representation to
the task
is resolving all text data. The text data that needs to be
resolved
include the values of attributes and the content.</p>
- <p>Resolution consists of expanding any
property references in the text
+ <p>Resolution consists of expanding any property
references in the text
data. Property references are identified as starting with the
token
"${" and finishing with another "}" token. The text
in between is the name of a property. The value of the property
replaces
the sequence of text starting with the "${" token and finishing
with the "}" token.</p>
- <p>Note that the value of the property may
not be a string. If the text data
+ <p>Note that the value of the property may not be a
string. If the text data
contains text (or other property references) to either side of
the property
reference then it must be <a href="converter.html">converted</a>
to a
String.</p>
- </blockquote>
- </td></tr>
- </table>
- <table border="0" cellspacing="0" cellpadding="2" width="100%">
- <tr><td bgcolor="#525D76">
- <font color="#ffffff" face="arial,helvetica,sanserif">
- <a name="Modeller"><strong>Modeller</strong></a>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <p>Currently the representation of object are stored
in a hierarchial
+ </div>
+ <div class="h3">
+ <h3><a name="Modeller">Modeller</a></h3>
+ <p>Currently the representation of object are stored in a
hierarchial
tree of
<code>org.apache.myrmidon.api.metadata.ModelElement</code>
objects. Each ModelElement has a number of attributes and can
have
either content or sub-elements.</p>
- <p>In most cases it is the responsibility of
the runtime to map
+ <p>In most cases it is the responsibility of the
runtime to map
the ModelElement onto an object. However in some cases it may be
useful
for the object to get access to it's own model and for it to
explicitly
manage it's own configuration. In this case the object should
implement
the <code>org.apache.myrmidon.api.metadata.Modeller</code>
interface
which will provide the mechanism for the object to receive its
own
representation and configure itself.</p>
- <p>Note that the Modeller mechanism should
be avoided if possible
+ <p>Note that the Modeller mechanism should be
avoided if possible
as it adds considerable complexity to the implementing
object.</p>
- </blockquote>
- </td></tr>
- </table>
- <table border="0" cellspacing="0" cellpadding="2" width="100%">
- <tr><td bgcolor="#525D76">
- <font color="#ffffff" face="arial,helvetica,sanserif">
- <a name="Attributes"><strong>Attributes</strong></a>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <p>To map an XML attribute on to a Java object, the
name of the
+ </div>
+ <div class="h3">
+ <h3><a name="Attributes">Attributes</a></h3>
+ <p>To map an XML attribute on to a Java object, the name
of the
attribute is mapped to a java name and prefixed with the string
"set". The resulting string is then used to look up a
method with a single parameter.</p>
- <p>For example, for the attribute "world"
would result
+ <p>For example, for the attribute "world" would
result
in a lookup of a method named "setWorld" with a single
parameter.</p>
- <p>If multiple methods were matched during
the lookup then an
+ <p>If multiple methods were matched during the
lookup then an
exception is thrown indicating ambiguity. Theres is an exception
to this rule that allows 2 methods to be matched if one of the
methods takes a <code>java.lang.String</code> parameter. The
method
@@ -241,144 +179,90 @@
the other method would be chosen. This exception is allowed as
it is
common practice for a task to evolve from String parameters to
more
strongly typed parameters.</p>
- <p>The resolved text data of the attribute
must be
+ <p>The resolved text data of the attribute must be
<a href="converter.html">converted</a> to the type of the
matched
methods parameter. For example, if the "setWorld" method
took a parameter of type <code>java.io.File</code> then the
resolved
text data must be converted into a <code>java.io.File</code>. The
conversion is done by the Converter architecture that is more
fully
described in the <a href="converter.html">Converter
HOWTO</a>.</p>
- <p>After the value is converted to the
correct type the method is
+ <p>After the value is converted to the correct type
the method is
invoked with the converted value.</p>
- </blockquote>
- </td></tr>
- </table>
- <table border="0" cellspacing="0" cellpadding="2" width="100%">
- <tr><td bgcolor="#525D76">
- <font color="#ffffff" face="arial,helvetica,sanserif">
- <a name="Content"><strong>Content</strong></a>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <p>The XML representation of object can have either
have nested
+ </div>
+ <div class="h3">
+ <h3><a name="Content">Content</a></h3>
+ <p>The XML representation of object can have either have
nested
elements or nested text (content) but not both. To add the
content
to an object a method named "content" with one parameter is
looked
up. The resolved text data for content is then
<a href="converter.html">converted</a> to the type of the
parameter
and passed in via the method.</p>
- </blockquote>
- </td></tr>
- </table>
- <table border="0" cellspacing="0" cellpadding="2" width="100%">
- <tr><td bgcolor="#525D76">
- <font color="#ffffff" face="arial,helvetica,sanserif">
- <a name="Element"><strong>Element</strong></a>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <p>Mapping an ModelElement onto a java object is a
series of steps.
+ </div>
+ <div class="h3">
+ <h3><a name="Element">Element</a></h3>
+ <p>Mapping an ModelElement onto a java object is a series
of steps.
If the ModelElement name ends with the string "-ref" then
it is treated as a reference element - see the <em>Referrenced
Elements</em> section. Otherwise, the element is first attempted
to
be mapped as a <em>Named Element</em> and if no match is found
via
that method it tries to treat the element as a <em>Typed
Element</em>.</p>
- <table border="0" cellspacing="0"
cellpadding="2" width="100%">
- <tr><td bgcolor="#828DA6">
- <font color="#ffffff" face="arial,helvetica,sanserif">
- <a name="Named Elements"><strong>Named
Elements</strong></a>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <p>To map a named ModelElement on to a Java object,
the name of
+ <div class="h4">
+ <h4><a name="Named Elements">Named Elements</a></h4>
+ <p>To map a named ModelElement on to a Java object, the
name of
the element is mapped to a java name and prefixed with the string
"add". The resulting string is then used to look up a
method with a single parameter.</p>
- <p>For example, for the attribute "geometry"
would result
+ <p>For example, for the attribute "geometry" would
result
in a lookup of a method named "addGeometry" with a single
parameter. If multiple methods were matched during the lookup
then an
exception is thrown indicating ambiguity. If no methods were
found that
match name then skip down to configuring "typed" elements.</p>
- <p>The type of the methods single parameter
is then examined to determine
+ <p>The type of the methods single parameter is then
examined to determine
what happens next. There are two valid situations, if neither of
these are
satisfied, then an exception is thrown.</p>
- <ul>
+ <ul>
<li>The parameters type is
<code>org.apache.myrmidon.api.metadata.ModelElement</code></li>
<li>The parameters type is a concrete class</li>
</ul>
- <p>1. If the parameter has a type of
<code>org.apache.myrmidon.api.metadata.ModelElement</code>
+ <p>1. If the parameter has a type of
<code>org.apache.myrmidon.api.metadata.ModelElement</code>
then the un-modified model representation of element is passed
to object by invoking
the adder method.</p>
- <p>2. If the parameters type is concrete
then an instance of the parameter is
+ <p>2. If the parameters type is concrete then an
instance of the parameter is
instantiated using the default constructor. This created object
is then configured
in the same manner as task using the elements representation as
the model. After
the object is configured it is passed into object by invoking
the adder method.</p>
- </blockquote>
- </td></tr>
- </table>
- <table border="0" cellspacing="0"
cellpadding="2" width="100%">
- <tr><td bgcolor="#828DA6">
- <font color="#ffffff" face="arial,helvetica,sanserif">
- <a name="Referrenced Elements"><strong>Referrenced
Elements</strong></a>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <p>A referenced element is one that has a name
ending in
+ </div>
+ <div class="h4">
+ <h4><a name="Referrenced Elements">Referrenced Elements</a></h4>
+ <p>A referenced element is one that has a name ending in
"-ref" and has a single attribute "name"
and no content or child elements.</p>
- <p>The value of the "name" attribute is the
name of a property.
+ <p>The value of the "name" attribute is the name of
a property.
The value of this property is retrieved from the TaskContext.</p>
- <p>Like with <em>Named Elements</em> the
name of the element (minus
+ <p>Like with <em>Named Elements</em> the name of the
element (minus
the "-ref" part) is mapped to a java name and prefixed with the
string
"add". The resulting string is then used to look up a
method with a single parameter. If multiple methods were matched
during the lookup then an
exception is thrown indicating ambiguity.</p>
- <p>The value retrieved from the TaskContext
is then converted to the type
+ <p>The value retrieved from the TaskContext is then
converted to the type
of the methods parameter and the add method is invoked with the
converted value.</p>
- <p>An example usage is the following;</p>
- <div align="left">
- <table cellspacing="4" cellpadding="0" border="0">
- <tr>
- <td bgcolor="#023264" width="1" height="1"><img
src="/images/void.gif" width="1" height="1" vspace="0" hspace="0"
border="0"/></td>
- <td bgcolor="#023264" height="1"><img src="/images/void.gif"
width="1" height="1" vspace="0" hspace="0" border="0"/></td>
- <td bgcolor="#023264" width="1" height="1"><img
src="/images/void.gif" width="1" height="1" vspace="0" hspace="0"
border="0"/></td>
- </tr>
- <tr>
- <td bgcolor="#023264" width="1"><img src="/images/void.gif"
width="1" height="1" vspace="0" hspace="0" border="0"/></td>
- <td bgcolor="#ffffff"><pre>
+ <p>An example usage is the following;</p>
+ <div id="source">
+ <pre>
<my-task ...>
<classpath-ref name="project.class.path"/>
</my-task>
-</pre></td>
- <td bgcolor="#023264" width="1"><img src="/images/void.gif"
width="1" height="1" vspace="0" hspace="0" border="0"/></td>
- </tr>
- <tr>
- <td bgcolor="#023264" width="1" height="1"><img
src="/images/void.gif" width="1" height="1" vspace="0" hspace="0"
border="0"/></td>
- <td bgcolor="#023264" height="1"><img src="/images/void.gif"
width="1" height="1" vspace="0" hspace="0" border="0"/></td>
- <td bgcolor="#023264" width="1" height="1"><img
src="/images/void.gif" width="1" height="1" vspace="0" hspace="0"
border="0"/></td>
- </tr>
- </table>
+</pre>
</div>
- </blockquote>
- </td></tr>
- </table>
- <table border="0" cellspacing="0"
cellpadding="2" width="100%">
- <tr><td bgcolor="#828DA6">
- <font color="#ffffff" face="arial,helvetica,sanserif">
- <a name="Typed Elements"><strong>Typed
Elements</strong></a>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <p>"Typed" elements can also be added to an object.
A typed element
+ </div>
+ <div class="h4">
+ <h4><a name="Typed Elements">Typed Elements</a></h4>
+ <p>"Typed" elements can also be added to an object. A
typed element
is one in which the name of the element actually refers to a
type rather than the
name of the adder to call.</p>
- <p>For example, you may wish to allow a task
to add arbitrary instances of the
+ <p>For example, you may wish to allow a task to add
arbitrary instances of the
Condition role to a task. So instead of adding methods such as
<code>addAnd(AndCondition)</code>,
<code>addOr(OrCondition)</code> and
<code>addXor(XorCondition)</code> you can instead add a single
method
@@ -388,34 +272,30 @@
a "nand" condition they could write the Nand type use it in
their build
file. For a discussion on roles and types see the <a
href="types.html">Types
HOWTO</a>.</p>
- <p>To use a Typed adder there must be a
single method named "add" that
+ <p>To use a Typed adder there must be a single
method named "add" that
has a single parameter. The parameter <em>MUST</em> be an
abstract interface and
must be registered as a role. The name of the element is then
used to lookup the
a type in the TypeManager with a role matching the interface
name.</p>
- <p>For example if an element named "nand"
was added to an object that had
+ <p>For example if an element named "nand" was added
to an object that had
an adder with the signature <code>void add( Condition condition
)</code> then
the type named "nand" in the role "Condition" would be looked up.
An instance of the type would then be created using the default
constructor and the
created object would be configured and then adder to object
using adder.</p>
- </blockquote>
- </td></tr>
- </table>
- </blockquote>
- </td></tr>
- </table>
- </td>
+ </div>
+ </div>
+ </div></div></td>
</tr>
-
- <!-- FOOTER -->
- <tr><td colspan="2">
- <hr noshade="" size="1"/>
- </td></tr>
- <tr><td colspan="2">
- <div align="center"><font color="#525D76" size="-1"><em>
- Copyright © 2000-2002, Apache Software Foundation
- </em></font></div>
- </td></tr>
</table>
+
+ <!-- FOOTER -->
+ <div id="footer">
+ <table border="0" cellspacing="0" cellpadding="4">
+ <tr>
+ <td>Copyright © 2000-2002, Apache Software Foundation</td>
+ </tr>
+ </table>
+ </div>
+
</body>
</html>
<!-- end the processing -->
1.9 +91 -91 jakarta-ant-myrmidon/site/docs/differences.html
Index: differences.html
===================================================================
RCS file: /home/cvs/jakarta-ant-myrmidon/site/docs/differences.html,v
retrieving revision 1.8
retrieving revision 1.9
diff -u -r1.8 -r1.9
--- differences.html 24 May 2002 06:39:41 -0000 1.8
+++ differences.html 6 Jun 2002 12:54:28 -0000 1.9
@@ -6,91 +6,93 @@
<!-- start the processing -->
<html>
<head>
+ <style type="text/css">
+ @import url("./css/tigris.css");
+ @import url("./css/site.css");
+ </style>
<meta http-equiv="Content-Type" content="text/html;
charset=iso-8859-1"/>
-
+
<meta name="author" value="Adam Murdoch">
<meta name="email" value="[EMAIL PROTECTED]">
-
+
<title>Apache Myrmidon - Differences to Ant 1</title>
</head>
-
- <body bgcolor="#ffffff" text="#000000" link="#525D76">
- <table border="0" width="100%" cellspacing="0">
- <!-- TOP IMAGE -->
- <tr>
- <td> <td colspan="2">
+
+ <body marginwidth="0" marginheight="0" class="composite">
+
+ <div id="banner">
+ <table border="0" cellspacing="0" cellpadding="8" width="100%">
+ <!-- TOP IMAGE -->
+ <tr>
+ <td> <td colspan="2">
<a href="http://jakarta.apache.org"><img
src="http://jakarta.apache.org/images/jakarta-logo.gif" align="left"
border="0"/></a>
</td>
</td>
- <td valign="bottom"><div align="right"><b><font size="+3"
color="#525D76">Apache Myrmidon</font></b></div></td>
- </tr>
- </table>
- <table border="0" width="100%" cellspacing="4">
- <tr><td colspan="2">
- <hr noshade="" size="1"/>
- </td></tr>
-
- <tr>
+ <td><div align="right" valign="bottom"><b><font size="+3">Apache
Myrmidon</font></b></div></td>
+ </tr>
+ </table>
+ </div>
+
+ <table border="0" cellspacing="0" cellpadding="8" width="100%"
id="main">
+ <tr valign="top">
<!-- LEFT SIDE NAVIGATION -->
- <td valign="top" nowrap="true">
- <p><strong>Myrmidon</strong></p>
- <ul>
- <li> <a href="./index.html">Introduction</a>
- </li>
- <li> <a href="./getinvolved.html">Get Involved</a>
- </li>
- <li> <a href="./building.html">Building Myrmidon</a>
- </li>
- <li> <a href="./todo.html">Todo List</a>
- </li>
- </ul>
- <p><strong>User Guide</strong></p>
- <ul>
- <li> <a href="./running.html">Installing and Running</a>
- </li>
- <li> <a href="./buildfile.html">Project File</a>
- </li>
- <li> <a href="./vfs.html">Virtual File System</a>
- </li>
- <li> <a href="./ant1compat.html">Ant 1 Compatibility Layer</a>
- </li>
- <li> <a href="./differences.html">Differences to Ant 1</a>
- </li>
- <li> <a href="./task.html">My First Task</a>
- </li>
- </ul>
- <p><strong>Extending Myrmidon</strong></p>
- <ul>
- <li> <a href="./configuring.html">Configuration HOWTO</a>
- </li>
- <li> <a href="./converter.html">Converter HOWTO</a>
- </li>
- <li> <a href="./type.html">Type HOWTO</a>
- </li>
- <li> <a href="./classloader.html">ClassLoader HOWTO</a>
- </li>
- <li> <a href="./librarys.html">Library HOWTO</a>
- </li>
- </ul>
- <p><strong>Developers Guide</strong></p>
- <ul>
- <li> <a href="./subprojects.html">Sub Projects</a>
- </li>
- <li> <a href="./project-descriptor.html">The Build System</a>
- </li>
- </ul>
- </td>
- <td align="left" valign="top">
- <table border="0" cellspacing="0" cellpadding="2" width="100%">
- <tr><td bgcolor="#525D76">
- <font color="#ffffff" face="arial,helvetica,sanserif">
- <a name="Differences to Ant 1.x"><strong>Differences to
Ant 1.x</strong></a>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <p>Some of the differences between Ant 1.x and
Myrmidon:</p>
- <ul>
+ <td id="leftcol" width="20%">
+ <div id="navcolumn">
+ <div>
+ <strong>Myrmidon</strong>
+ <div><small> <a href="./index.html">Introduction</a>
+ </small></div>
+ <div><small> <a href="./getinvolved.html">Get Involved</a>
+ </small></div>
+ <div><small> <a href="./building.html">Building
Myrmidon</a>
+ </small></div>
+ <div><small> <a href="./todo.html">Todo List</a>
+ </small></div>
+ </div>
+ <div>
+ <strong>User Guide</strong>
+ <div><small> <a href="./running.html">Installing and
Running</a>
+ </small></div>
+ <div><small> <a href="./buildfile.html">Project File</a>
+ </small></div>
+ <div><small> <a href="./properties.html">Properties</a>
+ </small></div>
+ <div><small> <a href="./vfs.html">Virtual File System</a>
+ </small></div>
+ <div><small> <a href="./ant1compat.html">Ant 1
Compatibility Layer</a>
+ </small></div>
+ <div><small> <a href="./differences.html">Differences to
Ant 1</a>
+ </small></div>
+ <div><small> <a href="./task.html">My First Task</a>
+ </small></div>
+ </div>
+ <div>
+ <strong>Extending Myrmidon</strong>
+ <div><small> <a href="./configuring.html">Configuration
HOWTO</a>
+ </small></div>
+ <div><small> <a href="./converter.html">Converter
HOWTO</a>
+ </small></div>
+ <div><small> <a href="./type.html">Type HOWTO</a>
+ </small></div>
+ <div><small> <a href="./classloader.html">ClassLoader
HOWTO</a>
+ </small></div>
+ <div><small> <a href="./librarys.html">Library HOWTO</a>
+ </small></div>
+ </div>
+ <div>
+ <strong>Developers Guide</strong>
+ <div><small> <a href="./subprojects.html">Sub Projects</a>
+ </small></div>
+ <div><small> <a href="./project-descriptor.html">The
Build System</a>
+ </small></div>
+ </div>
+ </div>
+ </td>
+ <td><div id="bodycol"><div class="app">
+ <div class="h3">
+ <h3><a name="Differences to Ant 1.x">Differences to Ant
1.x</a></h3>
+ <p>Some of the differences between Ant 1.x and
Myrmidon:</p>
+ <ul>
<li>
Dependencies on targets in other build files are now
possible. The user first places a
@@ -150,25 +152,23 @@
</ul>
</li>
</ul>
- <p>There are plenty more features planned.
You can read about them
+ <p>There are plenty more features planned. You can
read about them
<a href="todo.html">here</a>.
</p>
- </blockquote>
- </td></tr>
- </table>
- </td>
+ </div>
+ </div></div></td>
</tr>
-
- <!-- FOOTER -->
- <tr><td colspan="2">
- <hr noshade="" size="1"/>
- </td></tr>
- <tr><td colspan="2">
- <div align="center"><font color="#525D76" size="-1"><em>
- Copyright © 2000-2002, Apache Software Foundation
- </em></font></div>
- </td></tr>
</table>
+
+ <!-- FOOTER -->
+ <div id="footer">
+ <table border="0" cellspacing="0" cellpadding="4">
+ <tr>
+ <td>Copyright © 2000-2002, Apache Software Foundation</td>
+ </tr>
+ </table>
+ </div>
+
</body>
</html>
<!-- end the processing -->
1.6 +92 -92 jakarta-ant-myrmidon/site/docs/getinvolved.html
Index: getinvolved.html
===================================================================
RCS file: /home/cvs/jakarta-ant-myrmidon/site/docs/getinvolved.html,v
retrieving revision 1.5
retrieving revision 1.6
diff -u -r1.5 -r1.6
--- getinvolved.html 19 May 2002 13:37:50 -0000 1.5
+++ getinvolved.html 6 Jun 2002 12:54:28 -0000 1.6
@@ -6,118 +6,118 @@
<!-- start the processing -->
<html>
<head>
+ <style type="text/css">
+ @import url("./css/tigris.css");
+ @import url("./css/site.css");
+ </style>
<meta http-equiv="Content-Type" content="text/html;
charset=iso-8859-1"/>
-
+
<meta name="author" value="Adam Murdoch">
<meta name="email" value="[EMAIL PROTECTED]">
-
+
<title>Apache Myrmidon - Get Involved</title>
</head>
-
- <body bgcolor="#ffffff" text="#000000" link="#525D76">
- <table border="0" width="100%" cellspacing="0">
- <!-- TOP IMAGE -->
- <tr>
- <td> <td colspan="2">
+
+ <body marginwidth="0" marginheight="0" class="composite">
+
+ <div id="banner">
+ <table border="0" cellspacing="0" cellpadding="8" width="100%">
+ <!-- TOP IMAGE -->
+ <tr>
+ <td> <td colspan="2">
<a href="http://jakarta.apache.org"><img
src="http://jakarta.apache.org/images/jakarta-logo.gif" align="left"
border="0"/></a>
</td>
</td>
- <td valign="bottom"><div align="right"><b><font size="+3"
color="#525D76">Apache Myrmidon</font></b></div></td>
- </tr>
- </table>
- <table border="0" width="100%" cellspacing="4">
- <tr><td colspan="2">
- <hr noshade="" size="1"/>
- </td></tr>
-
- <tr>
+ <td><div align="right" valign="bottom"><b><font size="+3">Apache
Myrmidon</font></b></div></td>
+ </tr>
+ </table>
+ </div>
+
+ <table border="0" cellspacing="0" cellpadding="8" width="100%"
id="main">
+ <tr valign="top">
<!-- LEFT SIDE NAVIGATION -->
- <td valign="top" nowrap="true">
- <p><strong>Myrmidon</strong></p>
- <ul>
- <li> <a href="./index.html">Introduction</a>
- </li>
- <li> <a href="./getinvolved.html">Get Involved</a>
- </li>
- <li> <a href="./building.html">Building Myrmidon</a>
- </li>
- <li> <a href="./todo.html">Todo List</a>
- </li>
- </ul>
- <p><strong>User Guide</strong></p>
- <ul>
- <li> <a href="./running.html">Installing and Running</a>
- </li>
- <li> <a href="./buildfile.html">Project File</a>
- </li>
- <li> <a href="./vfs.html">Virtual File System</a>
- </li>
- <li> <a href="./ant1compat.html">Ant 1 Compatibility Layer</a>
- </li>
- <li> <a href="./differences.html">Differences to Ant 1</a>
- </li>
- <li> <a href="./task.html">My First Task</a>
- </li>
- </ul>
- <p><strong>Extending Myrmidon</strong></p>
- <ul>
- <li> <a href="./configuring.html">Configuration HOWTO</a>
- </li>
- <li> <a href="./converter.html">Converter HOWTO</a>
- </li>
- <li> <a href="./type.html">Type HOWTO</a>
- </li>
- <li> <a href="./classloader.html">ClassLoader HOWTO</a>
- </li>
- <li> <a href="./librarys.html">Library HOWTO</a>
- </li>
- </ul>
- <p><strong>Developers Guide</strong></p>
- <ul>
- <li> <a href="./subprojects.html">Sub Projects</a>
- </li>
- <li> <a href="./project-descriptor.html">The Build System</a>
- </li>
- </ul>
- </td>
- <td align="left" valign="top">
- <table border="0" cellspacing="0" cellpadding="2" width="100%">
- <tr><td bgcolor="#525D76">
- <font color="#ffffff" face="arial,helvetica,sanserif">
- <a name="Get Involved"><strong>Get Involved</strong></a>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <p>There are plenty of things you can do to help out
with Myrmidon. The
+ <td id="leftcol" width="20%">
+ <div id="navcolumn">
+ <div>
+ <strong>Myrmidon</strong>
+ <div><small> <a href="./index.html">Introduction</a>
+ </small></div>
+ <div><small> <a href="./getinvolved.html">Get Involved</a>
+ </small></div>
+ <div><small> <a href="./building.html">Building
Myrmidon</a>
+ </small></div>
+ <div><small> <a href="./todo.html">Todo List</a>
+ </small></div>
+ </div>
+ <div>
+ <strong>User Guide</strong>
+ <div><small> <a href="./running.html">Installing and
Running</a>
+ </small></div>
+ <div><small> <a href="./buildfile.html">Project File</a>
+ </small></div>
+ <div><small> <a href="./properties.html">Properties</a>
+ </small></div>
+ <div><small> <a href="./vfs.html">Virtual File System</a>
+ </small></div>
+ <div><small> <a href="./ant1compat.html">Ant 1
Compatibility Layer</a>
+ </small></div>
+ <div><small> <a href="./differences.html">Differences to
Ant 1</a>
+ </small></div>
+ <div><small> <a href="./task.html">My First Task</a>
+ </small></div>
+ </div>
+ <div>
+ <strong>Extending Myrmidon</strong>
+ <div><small> <a href="./configuring.html">Configuration
HOWTO</a>
+ </small></div>
+ <div><small> <a href="./converter.html">Converter
HOWTO</a>
+ </small></div>
+ <div><small> <a href="./type.html">Type HOWTO</a>
+ </small></div>
+ <div><small> <a href="./classloader.html">ClassLoader
HOWTO</a>
+ </small></div>
+ <div><small> <a href="./librarys.html">Library HOWTO</a>
+ </small></div>
+ </div>
+ <div>
+ <strong>Developers Guide</strong>
+ <div><small> <a href="./subprojects.html">Sub Projects</a>
+ </small></div>
+ <div><small> <a href="./project-descriptor.html">The
Build System</a>
+ </small></div>
+ </div>
+ </div>
+ </td>
+ <td><div id="bodycol"><div class="app">
+ <div class="h3">
+ <h3><a name="Get Involved">Get Involved</a></h3>
+ <p>There are plenty of things you can do to help out with
Myrmidon. The
<a href="todo.html">Todo list </a> describes items which still
need to
be done. Of course, since this is an open-source project,
there's
plenty of scope for experimentation, and you can pretty much
make up
your own items to work on.</p>
- <p>Some things that are worth reading if you
do want to get involved:</p>
- <ul>
+ <p>Some things that are worth reading if you do want
to get involved:</p>
+ <ul>
<li>The <a href="http://jakarta.apache.org/ant/ant2/">Ant
2</a> goals and requirements.</li>
<li>The <a
href="http://jakarta.apache.org/ant/ant2/actionlist.html">Ant 1.9 Action
List</a>.</li>
<li>The Jakarta Project's <a
href="http://jakarta.apache.org/site/getinvolved.html">Get Involved</a>
page.</li>
</ul>
- <p>There is no Ant 2 or Myrmidon mailing
list yet, so direct any questions
+ <p>There is no Ant 2 or Myrmidon mailing list yet,
so direct any questions
or comments you have to the ant-dev mailing list.</p>
- </blockquote>
- </td></tr>
- </table>
- </td>
+ </div>
+ </div></div></td>
</tr>
-
- <!-- FOOTER -->
- <tr><td colspan="2">
- <hr noshade="" size="1"/>
- </td></tr>
- <tr><td colspan="2">
- <div align="center"><font color="#525D76" size="-1"><em>
- Copyright © 2000-2002, Apache Software Foundation
- </em></font></div>
- </td></tr>
</table>
+
+ <!-- FOOTER -->
+ <div id="footer">
+ <table border="0" cellspacing="0" cellpadding="4">
+ <tr>
+ <td>Copyright © 2000-2002, Apache Software Foundation</td>
+ </tr>
+ </table>
+ </div>
+
</body>
</html>
<!-- end the processing -->
1.6 +103 -119 jakarta-ant-myrmidon/site/docs/index.html
Index: index.html
===================================================================
RCS file: /home/cvs/jakarta-ant-myrmidon/site/docs/index.html,v
retrieving revision 1.5
retrieving revision 1.6
diff -u -r1.5 -r1.6
--- index.html 19 May 2002 13:37:50 -0000 1.5
+++ index.html 6 Jun 2002 12:54:28 -0000 1.6
@@ -6,117 +6,111 @@
<!-- start the processing -->
<html>
<head>
+ <style type="text/css">
+ @import url("./css/tigris.css");
+ @import url("./css/site.css");
+ </style>
<meta http-equiv="Content-Type" content="text/html;
charset=iso-8859-1"/>
-
+
<meta name="author" value="Peter Donald">
<meta name="email" value="[EMAIL PROTECTED]">
-
+
<title>Apache Myrmidon - Myrmidon</title>
</head>
-
- <body bgcolor="#ffffff" text="#000000" link="#525D76">
- <table border="0" width="100%" cellspacing="0">
- <!-- TOP IMAGE -->
- <tr>
- <td> <td colspan="2">
+
+ <body marginwidth="0" marginheight="0" class="composite">
+
+ <div id="banner">
+ <table border="0" cellspacing="0" cellpadding="8" width="100%">
+ <!-- TOP IMAGE -->
+ <tr>
+ <td> <td colspan="2">
<a href="http://jakarta.apache.org"><img
src="http://jakarta.apache.org/images/jakarta-logo.gif" align="left"
border="0"/></a>
</td>
</td>
- <td valign="bottom"><div align="right"><b><font size="+3"
color="#525D76">Apache Myrmidon</font></b></div></td>
- </tr>
- </table>
- <table border="0" width="100%" cellspacing="4">
- <tr><td colspan="2">
- <hr noshade="" size="1"/>
- </td></tr>
-
- <tr>
+ <td><div align="right" valign="bottom"><b><font size="+3">Apache
Myrmidon</font></b></div></td>
+ </tr>
+ </table>
+ </div>
+
+ <table border="0" cellspacing="0" cellpadding="8" width="100%"
id="main">
+ <tr valign="top">
<!-- LEFT SIDE NAVIGATION -->
- <td valign="top" nowrap="true">
- <p><strong>Myrmidon</strong></p>
- <ul>
- <li> <a href="./index.html">Introduction</a>
- </li>
- <li> <a href="./getinvolved.html">Get Involved</a>
- </li>
- <li> <a href="./building.html">Building Myrmidon</a>
- </li>
- <li> <a href="./todo.html">Todo List</a>
- </li>
- </ul>
- <p><strong>User Guide</strong></p>
- <ul>
- <li> <a href="./running.html">Installing and Running</a>
- </li>
- <li> <a href="./buildfile.html">Project File</a>
- </li>
- <li> <a href="./vfs.html">Virtual File System</a>
- </li>
- <li> <a href="./ant1compat.html">Ant 1 Compatibility Layer</a>
- </li>
- <li> <a href="./differences.html">Differences to Ant 1</a>
- </li>
- <li> <a href="./task.html">My First Task</a>
- </li>
- </ul>
- <p><strong>Extending Myrmidon</strong></p>
- <ul>
- <li> <a href="./configuring.html">Configuration HOWTO</a>
- </li>
- <li> <a href="./converter.html">Converter HOWTO</a>
- </li>
- <li> <a href="./type.html">Type HOWTO</a>
- </li>
- <li> <a href="./classloader.html">ClassLoader HOWTO</a>
- </li>
- <li> <a href="./librarys.html">Library HOWTO</a>
- </li>
- </ul>
- <p><strong>Developers Guide</strong></p>
- <ul>
- <li> <a href="./subprojects.html">Sub Projects</a>
- </li>
- <li> <a href="./project-descriptor.html">The Build System</a>
- </li>
- </ul>
- </td>
- <td align="left" valign="top">
- <table border="0" cellspacing="0" cellpadding="2" width="100%">
- <tr><td bgcolor="#525D76">
- <font color="#ffffff" face="arial,helvetica,sanserif">
- <a name="What is Ant?"><strong>What is Ant?</strong></a>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <p>Ant is a cross-platform build tool that features
ease of
+ <td id="leftcol" width="20%">
+ <div id="navcolumn">
+ <div>
+ <strong>Myrmidon</strong>
+ <div><small> <a href="./index.html">Introduction</a>
+ </small></div>
+ <div><small> <a href="./getinvolved.html">Get Involved</a>
+ </small></div>
+ <div><small> <a href="./building.html">Building
Myrmidon</a>
+ </small></div>
+ <div><small> <a href="./todo.html">Todo List</a>
+ </small></div>
+ </div>
+ <div>
+ <strong>User Guide</strong>
+ <div><small> <a href="./running.html">Installing and
Running</a>
+ </small></div>
+ <div><small> <a href="./buildfile.html">Project File</a>
+ </small></div>
+ <div><small> <a href="./properties.html">Properties</a>
+ </small></div>
+ <div><small> <a href="./vfs.html">Virtual File System</a>
+ </small></div>
+ <div><small> <a href="./ant1compat.html">Ant 1
Compatibility Layer</a>
+ </small></div>
+ <div><small> <a href="./differences.html">Differences to
Ant 1</a>
+ </small></div>
+ <div><small> <a href="./task.html">My First Task</a>
+ </small></div>
+ </div>
+ <div>
+ <strong>Extending Myrmidon</strong>
+ <div><small> <a href="./configuring.html">Configuration
HOWTO</a>
+ </small></div>
+ <div><small> <a href="./converter.html">Converter
HOWTO</a>
+ </small></div>
+ <div><small> <a href="./type.html">Type HOWTO</a>
+ </small></div>
+ <div><small> <a href="./classloader.html">ClassLoader
HOWTO</a>
+ </small></div>
+ <div><small> <a href="./librarys.html">Library HOWTO</a>
+ </small></div>
+ </div>
+ <div>
+ <strong>Developers Guide</strong>
+ <div><small> <a href="./subprojects.html">Sub Projects</a>
+ </small></div>
+ <div><small> <a href="./project-descriptor.html">The
Build System</a>
+ </small></div>
+ </div>
+ </div>
+ </td>
+ <td><div id="bodycol"><div class="app">
+ <div class="h3">
+ <h3><a name="What is Ant?">What is Ant?</a></h3>
+ <p>Ant is a cross-platform build tool that features ease of
use and extensibility as it's primary goal.</p>
- <p>Why another build tool when there is
already make, gnumake,
+ <p>Why another build tool when there is already
make, gnumake,
nmake, jam, and others? Make-like tools are inherently
shell-based;
they execute native commands and shell scripts to perform the
work
associated with the build process. So to extend the the tool by
writing a program or script executable by the OS you are on. This
makes it difficult to achieve portability between platforms.</p>
- <p>Ant is a different beast. Instead of
using OS-specific commands
+ <p>Ant is a different beast. Instead of using
OS-specific commands
to extend the build process, you leverage the cross-platform
features
of Java to write "tasks". This makes it much easier to achieve
a portal build process between platforms. Ant also differs in
that it uses
XML to describe the build process.</p>
- </blockquote>
- </td></tr>
- </table>
- <table border="0" cellspacing="0" cellpadding="2" width="100%">
- <tr><td bgcolor="#525D76">
- <font color="#ffffff" face="arial,helvetica,sanserif">
- <a name="What is Myrmidon?"><strong>What is
Myrmidon?</strong></a>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <p>Myrmidon is a proposal for Ant 2. Ant 2 is the
next evolution of the
+ </div>
+ <div class="h3">
+ <h3><a name="What is Myrmidon?">What is Myrmidon?</a></h3>
+ <p>Myrmidon is a proposal for Ant 2. Ant 2 is the next
evolution of the
Ant build tool aimed at removing many of the limitations of the
Ant 1.x
product. In particular it aims to;</p>
- <ul>
+ <ul>
<li>Remove ambiguities and points of confusion for build file
writers.</li>
<li>Ease deployment and management of 3rd party tasks and
@@ -128,28 +122,20 @@
<li>Integrate templating technologies such as XSLT, velocity
etc
to enable development of reusable build file elements.</li>
</ul>
- <p> You can read more about the goals of Ant
2
+ <p> You can read more about the goals of Ant 2
<a href="http://jakarta.apache.org/ant/ant2/">here</a>.
</p>
- <p>Myrmidon was specifically designed as
both a tool and as
+ <p>Myrmidon was specifically designed as both a tool
and as
an API library that can be reused in other products. It contains
the
basic building blocks for assembling any sort of task-based
tool. Ant 2
is an example of such a tool, which could be assembled using the
Myrmidon
task container, and a library of build related tasks. In the
future expect
to see Testing frameworks, Job Schedulers (ie Cron managers),
shells
and install tools based on the Myrmidon base.</p>
- </blockquote>
- </td></tr>
- </table>
- <table border="0" cellspacing="0" cellpadding="2" width="100%">
- <tr><td bgcolor="#525D76">
- <font color="#ffffff" face="arial,helvetica,sanserif">
- <a name="A Rose by any other name ..."><strong>A Rose by
any other name ...</strong></a>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <p>
+ </div>
+ <div class="h3">
+ <h3><a name="A Rose by any other name ...">A Rose by any other
name ...</a></h3>
+ <p>
The name Myrmidon is a derivation of a mythological name for
some ants that were turned
into soldiers by the god Zeus. It came to mean "a subordinate
who executes orders
unquestioningly" which seemed suitable for a task
execution/build tool. A more complete
@@ -157,7 +143,7 @@
<a
href="http://bondi-blue.parlez.com/previous_words/myrmidon.txt">
http://bondi-blue.parlez.com/previous_words/myrmidon.txt</a>.
</p>
- <quote>
+ <quote>
<i>The appellation Myrmidon was derived from the Greek word
"myrmex",
meaning ant. According to Greek mythology, the Myrmidons
were
transformed into humans by the god Zeus as an act of
kindness to his
@@ -168,22 +154,20 @@
Myrmidons. See "The Iliad" for Homers' account of the
Myrmidons
during the Trojan War.</i>
</quote>
- </blockquote>
- </td></tr>
- </table>
- </td>
+ </div>
+ </div></div></td>
</tr>
-
- <!-- FOOTER -->
- <tr><td colspan="2">
- <hr noshade="" size="1"/>
- </td></tr>
- <tr><td colspan="2">
- <div align="center"><font color="#525D76" size="-1"><em>
- Copyright © 2000-2002, Apache Software Foundation
- </em></font></div>
- </td></tr>
</table>
+
+ <!-- FOOTER -->
+ <div id="footer">
+ <table border="0" cellspacing="0" cellpadding="4">
+ <tr>
+ <td>Copyright © 2000-2002, Apache Software Foundation</td>
+ </tr>
+ </table>
+ </div>
+
</body>
</html>
<!-- end the processing -->
1.6 +131 -227 jakarta-ant-myrmidon/site/docs/librarys.html
Index: librarys.html
===================================================================
RCS file: /home/cvs/jakarta-ant-myrmidon/site/docs/librarys.html,v
retrieving revision 1.5
retrieving revision 1.6
diff -u -r1.5 -r1.6
--- librarys.html 19 May 2002 13:37:50 -0000 1.5
+++ librarys.html 6 Jun 2002 12:54:28 -0000 1.6
@@ -6,102 +6,104 @@
<!-- start the processing -->
<html>
<head>
+ <style type="text/css">
+ @import url("./css/tigris.css");
+ @import url("./css/site.css");
+ </style>
<meta http-equiv="Content-Type" content="text/html;
charset=iso-8859-1"/>
-
+
<meta name="author" value="Peter Donald">
<meta name="email" value="[EMAIL PROTECTED]">
-
+
<title>Apache Myrmidon - On Libraries in Ant 2</title>
</head>
-
- <body bgcolor="#ffffff" text="#000000" link="#525D76">
- <table border="0" width="100%" cellspacing="0">
- <!-- TOP IMAGE -->
- <tr>
- <td> <td colspan="2">
+
+ <body marginwidth="0" marginheight="0" class="composite">
+
+ <div id="banner">
+ <table border="0" cellspacing="0" cellpadding="8" width="100%">
+ <!-- TOP IMAGE -->
+ <tr>
+ <td> <td colspan="2">
<a href="http://jakarta.apache.org"><img
src="http://jakarta.apache.org/images/jakarta-logo.gif" align="left"
border="0"/></a>
</td>
</td>
- <td valign="bottom"><div align="right"><b><font size="+3"
color="#525D76">Apache Myrmidon</font></b></div></td>
- </tr>
- </table>
- <table border="0" width="100%" cellspacing="4">
- <tr><td colspan="2">
- <hr noshade="" size="1"/>
- </td></tr>
-
- <tr>
+ <td><div align="right" valign="bottom"><b><font size="+3">Apache
Myrmidon</font></b></div></td>
+ </tr>
+ </table>
+ </div>
+
+ <table border="0" cellspacing="0" cellpadding="8" width="100%"
id="main">
+ <tr valign="top">
<!-- LEFT SIDE NAVIGATION -->
- <td valign="top" nowrap="true">
- <p><strong>Myrmidon</strong></p>
- <ul>
- <li> <a href="./index.html">Introduction</a>
- </li>
- <li> <a href="./getinvolved.html">Get Involved</a>
- </li>
- <li> <a href="./building.html">Building Myrmidon</a>
- </li>
- <li> <a href="./todo.html">Todo List</a>
- </li>
- </ul>
- <p><strong>User Guide</strong></p>
- <ul>
- <li> <a href="./running.html">Installing and Running</a>
- </li>
- <li> <a href="./buildfile.html">Project File</a>
- </li>
- <li> <a href="./vfs.html">Virtual File System</a>
- </li>
- <li> <a href="./ant1compat.html">Ant 1 Compatibility Layer</a>
- </li>
- <li> <a href="./differences.html">Differences to Ant 1</a>
- </li>
- <li> <a href="./task.html">My First Task</a>
- </li>
- </ul>
- <p><strong>Extending Myrmidon</strong></p>
- <ul>
- <li> <a href="./configuring.html">Configuration HOWTO</a>
- </li>
- <li> <a href="./converter.html">Converter HOWTO</a>
- </li>
- <li> <a href="./type.html">Type HOWTO</a>
- </li>
- <li> <a href="./classloader.html">ClassLoader HOWTO</a>
- </li>
- <li> <a href="./librarys.html">Library HOWTO</a>
- </li>
- </ul>
- <p><strong>Developers Guide</strong></p>
- <ul>
- <li> <a href="./subprojects.html">Sub Projects</a>
- </li>
- <li> <a href="./project-descriptor.html">The Build System</a>
- </li>
- </ul>
- </td>
- <td align="left" valign="top">
- <table border="0" cellspacing="0" cellpadding="2" width="100%">
- <tr><td bgcolor="#525D76">
- <font color="#ffffff" face="arial,helvetica,sanserif">
- <a name="Library Management"><strong>Library
Management</strong></a>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <p>Long ago there was identified the need for
libraries that contain
+ <td id="leftcol" width="20%">
+ <div id="navcolumn">
+ <div>
+ <strong>Myrmidon</strong>
+ <div><small> <a href="./index.html">Introduction</a>
+ </small></div>
+ <div><small> <a href="./getinvolved.html">Get Involved</a>
+ </small></div>
+ <div><small> <a href="./building.html">Building
Myrmidon</a>
+ </small></div>
+ <div><small> <a href="./todo.html">Todo List</a>
+ </small></div>
+ </div>
+ <div>
+ <strong>User Guide</strong>
+ <div><small> <a href="./running.html">Installing and
Running</a>
+ </small></div>
+ <div><small> <a href="./buildfile.html">Project File</a>
+ </small></div>
+ <div><small> <a href="./properties.html">Properties</a>
+ </small></div>
+ <div><small> <a href="./vfs.html">Virtual File System</a>
+ </small></div>
+ <div><small> <a href="./ant1compat.html">Ant 1
Compatibility Layer</a>
+ </small></div>
+ <div><small> <a href="./differences.html">Differences to
Ant 1</a>
+ </small></div>
+ <div><small> <a href="./task.html">My First Task</a>
+ </small></div>
+ </div>
+ <div>
+ <strong>Extending Myrmidon</strong>
+ <div><small> <a href="./configuring.html">Configuration
HOWTO</a>
+ </small></div>
+ <div><small> <a href="./converter.html">Converter
HOWTO</a>
+ </small></div>
+ <div><small> <a href="./type.html">Type HOWTO</a>
+ </small></div>
+ <div><small> <a href="./classloader.html">ClassLoader
HOWTO</a>
+ </small></div>
+ <div><small> <a href="./librarys.html">Library HOWTO</a>
+ </small></div>
+ </div>
+ <div>
+ <strong>Developers Guide</strong>
+ <div><small> <a href="./subprojects.html">Sub Projects</a>
+ </small></div>
+ <div><small> <a href="./project-descriptor.html">The
Build System</a>
+ </small></div>
+ </div>
+ </div>
+ </td>
+ <td><div id="bodycol"><div class="app">
+ <div class="h3">
+ <h3><a name="Library Management">Library Management</a></h3>
+ <p>Long ago there was identified the need for libraries
that contain
tasks and other elements present in the build file. This document
attempts to describe the mechanism via which these libraries
will be
defined and used in Ant 2. The libraries (also referred to as
deployments) will be termed antlibs.</p>
- <p>Ant libraries can be packaged and signed
into a ANt Type Library
+ <p>Ant libraries can be packaged and signed into a
ANt Type Library
format (.atl) using the standard Java Archive tools. (For
details on
the .jar file format see the
<a
href="http://java.sun.com/j2se/1.3/docs/guide/jar/index.html">
Jar Specification</a>.
</p>
- <p>When packaged into such a form the
META-INF/ directory contains
+ <p>When packaged into such a form the META-INF/
directory contains
ant specific descriptors in addition to the standard Jar manifest
and other descriptor files. The archive will also contain the
@@ -109,7 +111,7 @@
library defines. It may also contain additional resources that
can
be referenced in the build file (an example being DTDs).
</p>
- <p>The library may also need access to other
libraries or resources
+ <p>The library may also need access to other
libraries or resources
to perform its job. For instance, if the task loaded an XML
document
and then processed said document using the
<em>Trax API</em> then
@@ -119,34 +121,20 @@
"Optional Package" Specification to declare dependencies on other
libraries.
</p>
- <p>The libraries will usually be installed
in standard locations that
+ <p>The libraries will usually be installed in
standard locations that
make it possible for the Ant container to automatically locate
and scan
the libraries. It will also be possible for the users to specify
additional search locations or even the specific location of ant
libraries.</p>
- <p>The following sections will describe each
of these different facets
+ <p>The following sections will describe each of
these different facets
in greater detail.</p>
- <table border="0" cellspacing="0"
cellpadding="2" width="100%">
- <tr><td bgcolor="#828DA6">
- <font color="#ffffff" face="arial,helvetica,sanserif">
- <a
name="Descriptors"><strong>Descriptors</strong></a>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <p>FIXME: Import this part from other doco</p>
- </blockquote>
- </td></tr>
- </table>
- <table border="0" cellspacing="0"
cellpadding="2" width="100%">
- <tr><td bgcolor="#828DA6">
- <font color="#ffffff" face="arial,helvetica,sanserif">
- <a name="Class and Resource Files"><strong>Class and
Resource Files</strong></a>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <p>The class and resources files should be stored as
in standard jars. The
+ <div class="h4">
+ <h4><a name="Descriptors">Descriptors</a></h4>
+ <p>FIXME: Import this part from other doco</p>
+ </div>
+ <div class="h4">
+ <h4><a name="Class and Resource Files">Class and Resource
Files</a></h4>
+ <p>The class and resources files should be stored as in
standard jars. The
root directory being the base via which code and resources
are loaded. So
the
<code>.class</code> file for the Java class
@@ -154,22 +142,14 @@
would be stored in
<code>/com/biz/tasks/Mytask.class</code>
</p>
- </blockquote>
- </td></tr>
- </table>
- <table border="0" cellspacing="0"
cellpadding="2" width="100%">
- <tr><td bgcolor="#828DA6">
- <font color="#ffffff" face="arial,helvetica,sanserif">
- <a
name="Dependencies"><strong>Dependencies</strong></a>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <p>It is often the case that a library will need
external resources. The
+ </div>
+ <div class="h4">
+ <h4><a name="Dependencies">Dependencies</a></h4>
+ <p>It is often the case that a library will need external
resources. The
example given above described dependence on an external XML
library. The
ant library thus needs a mechanism via which to declare
dependencies on
external libraries.</p>
- <p>Ant 2 uses the "Optional Package"
mechanism. Prior to JDK1.3, an "Optional
+ <p>Ant 2 uses the "Optional Package" mechanism.
Prior to JDK1.3, an "Optional
Package" was known as an
<em>Extension</em>. The specification for this
mechanism is available in the JDK1.3 documentation in the
directory
@@ -180,83 +160,43 @@
<a
href="http://java.sun.com/j2se/1.3/docs/guide/extensions/versioning.html">
http://java.sun.com/j2se/1.3/docs/guide/extensions/versioning.html</a>.
</p>
- <p>This mechanism was adopted as it is an
established standard. The standard
+ <p>This mechanism was adopted as it is an
established standard. The standard
is also begining to be adopted by other specifications such
as the
<em>Servlet
2.3 API</em>. Thus we are likely to see
an increase of jars using this mechanism
to specify dependencies.
</p>
- <p>The "Optional Package" mechanism allows
jars to specify dependencies on other
+ <p>The "Optional Package" mechanism allows jars to
specify dependencies on other
jars that implement a particular specification at particular
version levels. For
example you could specify a dependency on the Trax 1.1 API
by adding the following
to the manifest of your jar.</p>
- <div align="left">
- <table cellspacing="4" cellpadding="0" border="0">
- <tr>
- <td bgcolor="#023264" width="1" height="1"><img
src="/images/void.gif" width="1" height="1" vspace="0" hspace="0"
border="0"/></td>
- <td bgcolor="#023264" height="1"><img src="/images/void.gif"
width="1" height="1" vspace="0" hspace="0" border="0"/></td>
- <td bgcolor="#023264" width="1" height="1"><img
src="/images/void.gif" width="1" height="1" vspace="0" hspace="0"
border="0"/></td>
- </tr>
- <tr>
- <td bgcolor="#023264" width="1"><img src="/images/void.gif"
width="1" height="1" vspace="0" hspace="0" border="0"/></td>
- <td bgcolor="#ffffff"><pre>
+ <div id="source">
+ <pre>
Extension-List: trax
trax-Extension-Name: Java API for XML Parsing
trax-Specification-Version: 1.1
- </pre></td>
- <td bgcolor="#023264" width="1"><img src="/images/void.gif"
width="1" height="1" vspace="0" hspace="0" border="0"/></td>
- </tr>
- <tr>
- <td bgcolor="#023264" width="1" height="1"><img
src="/images/void.gif" width="1" height="1" vspace="0" hspace="0"
border="0"/></td>
- <td bgcolor="#023264" height="1"><img src="/images/void.gif"
width="1" height="1" vspace="0" hspace="0" border="0"/></td>
- <td bgcolor="#023264" width="1" height="1"><img
src="/images/void.gif" width="1" height="1" vspace="0" hspace="0"
border="0"/></td>
- </tr>
- </table>
+ </pre>
</div>
- <p>In some cases you may also wish to
specify a dependency on a specific vendors
+ <p>In some cases you may also wish to specify a
dependency on a specific vendors
implementation. For instance you may need to use xalan due
to it implementing a
particular extension you need. In that case you manifest may
contain;</p>
- <div align="left">
- <table cellspacing="4" cellpadding="0" border="0">
- <tr>
- <td bgcolor="#023264" width="1" height="1"><img
src="/images/void.gif" width="1" height="1" vspace="0" hspace="0"
border="0"/></td>
- <td bgcolor="#023264" height="1"><img src="/images/void.gif"
width="1" height="1" vspace="0" hspace="0" border="0"/></td>
- <td bgcolor="#023264" width="1" height="1"><img
src="/images/void.gif" width="1" height="1" vspace="0" hspace="0"
border="0"/></td>
- </tr>
- <tr>
- <td bgcolor="#023264" width="1"><img src="/images/void.gif"
width="1" height="1" vspace="0" hspace="0" border="0"/></td>
- <td bgcolor="#ffffff"><pre>
+ <div id="source">
+ <pre>
Extension-List: trax
trax-Extension-Name: Java API for XML Parsing
trax-Specification-Version: 1.1
trax-Implementation-Title: org.apache.xalan.xslt
trax-Implementation-Version: 2.1.0
trax-Implementation-Vendor: Apache Software Foundation
- </pre></td>
- <td bgcolor="#023264" width="1"><img src="/images/void.gif"
width="1" height="1" vspace="0" hspace="0" border="0"/></td>
- </tr>
- <tr>
- <td bgcolor="#023264" width="1" height="1"><img
src="/images/void.gif" width="1" height="1" vspace="0" hspace="0"
border="0"/></td>
- <td bgcolor="#023264" height="1"><img src="/images/void.gif"
width="1" height="1" vspace="0" hspace="0" border="0"/></td>
- <td bgcolor="#023264" width="1" height="1"><img
src="/images/void.gif" width="1" height="1" vspace="0" hspace="0"
border="0"/></td>
- </tr>
- </table>
+ </pre>
</div>
- <p>In many cases there will be no
distinction between the specification and
+ <p>In many cases there will be no distinction
between the specification and
the implementation of a library. For instance the Velocity
project only has
one implementation and one specification. In which case it
is sufficient to
just declare a dependency on the Velocity "Specification". A
library that uses
both the Trax API and the Velocity project may look like;</p>
- <div align="left">
- <table cellspacing="4" cellpadding="0" border="0">
- <tr>
- <td bgcolor="#023264" width="1" height="1"><img
src="/images/void.gif" width="1" height="1" vspace="0" hspace="0"
border="0"/></td>
- <td bgcolor="#023264" height="1"><img src="/images/void.gif"
width="1" height="1" vspace="0" hspace="0" border="0"/></td>
- <td bgcolor="#023264" width="1" height="1"><img
src="/images/void.gif" width="1" height="1" vspace="0" hspace="0"
border="0"/></td>
- </tr>
- <tr>
- <td bgcolor="#023264" width="1"><img src="/images/void.gif"
width="1" height="1" vspace="0" hspace="0" border="0"/></td>
- <td bgcolor="#ffffff"><pre>
+ <div id="source">
+ <pre>
Extension-List: trax velocity
velocity-Extension-Name: org.apache.velocity
velocity-Specification-Version: 1.0
@@ -265,62 +205,30 @@
trax-Implementation-Title: org.apache.xalan.xslt
trax-Implementation-Version: 2.1.0
trax-Implementation-Vendor: Apache Software Foundation
- </pre></td>
- <td bgcolor="#023264" width="1"><img src="/images/void.gif"
width="1" height="1" vspace="0" hspace="0" border="0"/></td>
- </tr>
- <tr>
- <td bgcolor="#023264" width="1" height="1"><img
src="/images/void.gif" width="1" height="1" vspace="0" hspace="0"
border="0"/></td>
- <td bgcolor="#023264" height="1"><img src="/images/void.gif"
width="1" height="1" vspace="0" hspace="0" border="0"/></td>
- <td bgcolor="#023264" width="1" height="1"><img
src="/images/void.gif" width="1" height="1" vspace="0" hspace="0"
border="0"/></td>
- </tr>
- </table>
+ </pre>
</div>
- <p>To make other jars available to Ant
libraries as "Optional Packages"
+ <p>To make other jars available to Ant libraries as
"Optional Packages"
or Extensions then you need to add a few lines to the
manifest of the
other jar. The minimal manifest is the following;</p>
- <div align="left">
- <table cellspacing="4" cellpadding="0" border="0">
- <tr>
- <td bgcolor="#023264" width="1" height="1"><img
src="/images/void.gif" width="1" height="1" vspace="0" hspace="0"
border="0"/></td>
- <td bgcolor="#023264" height="1"><img src="/images/void.gif"
width="1" height="1" vspace="0" hspace="0" border="0"/></td>
- <td bgcolor="#023264" width="1" height="1"><img
src="/images/void.gif" width="1" height="1" vspace="0" hspace="0"
border="0"/></td>
- </tr>
- <tr>
- <td bgcolor="#023264" width="1"><img src="/images/void.gif"
width="1" height="1" vspace="0" hspace="0" border="0"/></td>
- <td bgcolor="#ffffff"><pre>
+ <div id="source">
+ <pre>
Extension-Name: org.realityforge.dve
Specification-Vendor: Peter Donald
Specification-Version: 1.0
- </pre></td>
- <td bgcolor="#023264" width="1"><img src="/images/void.gif"
width="1" height="1" vspace="0" hspace="0" border="0"/></td>
- </tr>
- <tr>
- <td bgcolor="#023264" width="1" height="1"><img
src="/images/void.gif" width="1" height="1" vspace="0" hspace="0"
border="0"/></td>
- <td bgcolor="#023264" height="1"><img src="/images/void.gif"
width="1" height="1" vspace="0" hspace="0" border="0"/></td>
- <td bgcolor="#023264" width="1" height="1"><img
src="/images/void.gif" width="1" height="1" vspace="0" hspace="0"
border="0"/></td>
- </tr>
- </table>
+ </pre>
</div>
- <p>It is important to note that looking for
dependencies is recursive. For example,
+ <p>It is important to note that looking for
dependencies is recursive. For example,
if the ant library depends upon jar A and and A depends on B
then both A and B will
need to be loaded by the container.</p>
- </blockquote>
- </td></tr>
- </table>
- <table border="0" cellspacing="0"
cellpadding="2" width="100%">
- <tr><td bgcolor="#828DA6">
- <font color="#ffffff" face="arial,helvetica,sanserif">
- <a name="Implementation
Notes"><strong>Implementation Notes</strong></a>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <p>So far there has been no mention of
implementation strategies for
+ </div>
+ <div class="h4">
+ <h4><a name="Implementation Notes">Implementation Notes</a></h4>
+ <p>So far there has been no mention of implementation
strategies for
managing ClassLoaders and other details about where the
"Optional Packages"
are stored. This section will outline such details but they
could change
in the future. The above specification will still be
accurate but the approach
to implementing specification will be different.</p>
- <p>In the current architecture all of the
"Optional Packages" are assumed to
+ <p>In the current architecture all of the "Optional
Packages" are assumed to
be stored in the
<code>$ANT_HOME/ext</code> directory. The runtime will
scan
this directory for jars and add all the "optional Packages"
found into a
@@ -328,31 +236,27 @@
all the "Optional Packages". The user is able to specify an
alternative directory
or add a new directory to search on the commandline.
</p>
- <p>When the container attempts to load an
ant library it will also try to load
+ <p>When the container attempts to load an ant
library it will also try to load
any needed dependencies. First it will check the parent
ClassLoaders to see if any
of them contain the required dependencies. If not then it
will search the
"Optional Packages" registry. If the dependency is not found
then a error will be
signaled. If the dependency is found in the "Optional
Packages" registry then it is
loaded by the same ClassLoader that is used to load the Ant
library.</p>
- </blockquote>
- </td></tr>
- </table>
- </blockquote>
- </td></tr>
- </table>
- </td>
+ </div>
+ </div>
+ </div></div></td>
</tr>
-
- <!-- FOOTER -->
- <tr><td colspan="2">
- <hr noshade="" size="1"/>
- </td></tr>
- <tr><td colspan="2">
- <div align="center"><font color="#525D76" size="-1"><em>
- Copyright © 2000-2002, Apache Software Foundation
- </em></font></div>
- </td></tr>
</table>
+
+ <!-- FOOTER -->
+ <div id="footer">
+ <table border="0" cellspacing="0" cellpadding="4">
+ <tr>
+ <td>Copyright © 2000-2002, Apache Software Foundation</td>
+ </tr>
+ </table>
+ </div>
+
</body>
</html>
<!-- end the processing -->
1.5 +513 -759 jakarta-ant-myrmidon/site/docs/project-descriptor.html
Index: project-descriptor.html
===================================================================
RCS file: /home/cvs/jakarta-ant-myrmidon/site/docs/project-descriptor.html,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -r1.4 -r1.5
--- project-descriptor.html 19 May 2002 13:37:50 -0000 1.4
+++ project-descriptor.html 6 Jun 2002 12:54:28 -0000 1.5
@@ -6,423 +6,332 @@
<!-- start the processing -->
<html>
<head>
+ <style type="text/css">
+ @import url("./css/tigris.css");
+ @import url("./css/site.css");
+ </style>
<meta http-equiv="Content-Type" content="text/html;
charset=iso-8859-1"/>
-
+
<meta name="author" value="Adam Murdoch">
<meta name="email" value="[EMAIL PROTECTED]">
-
+
<title>Apache Myrmidon - Project Descriptor</title>
</head>
-
- <body bgcolor="#ffffff" text="#000000" link="#525D76">
- <table border="0" width="100%" cellspacing="0">
- <!-- TOP IMAGE -->
- <tr>
- <td> <td colspan="2">
+
+ <body marginwidth="0" marginheight="0" class="composite">
+
+ <div id="banner">
+ <table border="0" cellspacing="0" cellpadding="8" width="100%">
+ <!-- TOP IMAGE -->
+ <tr>
+ <td> <td colspan="2">
<a href="http://jakarta.apache.org"><img
src="http://jakarta.apache.org/images/jakarta-logo.gif" align="left"
border="0"/></a>
</td>
</td>
- <td valign="bottom"><div align="right"><b><font size="+3"
color="#525D76">Apache Myrmidon</font></b></div></td>
- </tr>
- </table>
- <table border="0" width="100%" cellspacing="4">
- <tr><td colspan="2">
- <hr noshade="" size="1"/>
- </td></tr>
-
- <tr>
+ <td><div align="right" valign="bottom"><b><font size="+3">Apache
Myrmidon</font></b></div></td>
+ </tr>
+ </table>
+ </div>
+
+ <table border="0" cellspacing="0" cellpadding="8" width="100%"
id="main">
+ <tr valign="top">
<!-- LEFT SIDE NAVIGATION -->
- <td valign="top" nowrap="true">
- <p><strong>Myrmidon</strong></p>
- <ul>
- <li> <a href="./index.html">Introduction</a>
- </li>
- <li> <a href="./getinvolved.html">Get Involved</a>
- </li>
- <li> <a href="./building.html">Building Myrmidon</a>
- </li>
- <li> <a href="./todo.html">Todo List</a>
- </li>
- </ul>
- <p><strong>User Guide</strong></p>
- <ul>
- <li> <a href="./running.html">Installing and Running</a>
- </li>
- <li> <a href="./buildfile.html">Project File</a>
- </li>
- <li> <a href="./vfs.html">Virtual File System</a>
- </li>
- <li> <a href="./ant1compat.html">Ant 1 Compatibility Layer</a>
- </li>
- <li> <a href="./differences.html">Differences to Ant 1</a>
- </li>
- <li> <a href="./task.html">My First Task</a>
- </li>
- </ul>
- <p><strong>Extending Myrmidon</strong></p>
- <ul>
- <li> <a href="./configuring.html">Configuration HOWTO</a>
- </li>
- <li> <a href="./converter.html">Converter HOWTO</a>
- </li>
- <li> <a href="./type.html">Type HOWTO</a>
- </li>
- <li> <a href="./classloader.html">ClassLoader HOWTO</a>
- </li>
- <li> <a href="./librarys.html">Library HOWTO</a>
- </li>
- </ul>
- <p><strong>Developers Guide</strong></p>
- <ul>
- <li> <a href="./subprojects.html">Sub Projects</a>
- </li>
- <li> <a href="./project-descriptor.html">The Build System</a>
- </li>
- </ul>
- </td>
- <td align="left" valign="top">
- <table border="0" cellspacing="0" cellpadding="2" width="100%">
- <tr><td bgcolor="#525D76">
- <font color="#ffffff" face="arial,helvetica,sanserif">
- <a name="Project Descriptor"><strong>Project
Descriptor</strong></a>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <p>Each Myrmidon sub-project has a project
descriptor associated with it.
+ <td id="leftcol" width="20%">
+ <div id="navcolumn">
+ <div>
+ <strong>Myrmidon</strong>
+ <div><small> <a href="./index.html">Introduction</a>
+ </small></div>
+ <div><small> <a href="./getinvolved.html">Get Involved</a>
+ </small></div>
+ <div><small> <a href="./building.html">Building
Myrmidon</a>
+ </small></div>
+ <div><small> <a href="./todo.html">Todo List</a>
+ </small></div>
+ </div>
+ <div>
+ <strong>User Guide</strong>
+ <div><small> <a href="./running.html">Installing and
Running</a>
+ </small></div>
+ <div><small> <a href="./buildfile.html">Project File</a>
+ </small></div>
+ <div><small> <a href="./properties.html">Properties</a>
+ </small></div>
+ <div><small> <a href="./vfs.html">Virtual File System</a>
+ </small></div>
+ <div><small> <a href="./ant1compat.html">Ant 1
Compatibility Layer</a>
+ </small></div>
+ <div><small> <a href="./differences.html">Differences to
Ant 1</a>
+ </small></div>
+ <div><small> <a href="./task.html">My First Task</a>
+ </small></div>
+ </div>
+ <div>
+ <strong>Extending Myrmidon</strong>
+ <div><small> <a href="./configuring.html">Configuration
HOWTO</a>
+ </small></div>
+ <div><small> <a href="./converter.html">Converter
HOWTO</a>
+ </small></div>
+ <div><small> <a href="./type.html">Type HOWTO</a>
+ </small></div>
+ <div><small> <a href="./classloader.html">ClassLoader
HOWTO</a>
+ </small></div>
+ <div><small> <a href="./librarys.html">Library HOWTO</a>
+ </small></div>
+ </div>
+ <div>
+ <strong>Developers Guide</strong>
+ <div><small> <a href="./subprojects.html">Sub Projects</a>
+ </small></div>
+ <div><small> <a href="./project-descriptor.html">The
Build System</a>
+ </small></div>
+ </div>
+ </div>
+ </td>
+ <td><div id="bodycol"><div class="app">
+ <div class="h3">
+ <h3><a name="Project Descriptor">Project Descriptor</a></h3>
+ <p>Each Myrmidon sub-project has a project descriptor
associated with it.
This is an xml file that provides meta-information about the
project,
such as the name of the project, its current version, where the
source can be found, and so on. The descriptor is used to
generate
the project's build file.
</p>
- <p>The root element of the project
descriptor must be a
+ <p>The root element of the project descriptor must
be a
<code><project></code> element. The
<code><project></code>
element may contain the following elements:
</p>
- <table>
- <tr>
- <td bgcolor="#039acc" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ <table cellpadding="3" cellspacing="2" border="1"
width="100%">
+ <tr class="a">
+ <th
+ >
Element
- </font>
- </td>
- <td bgcolor="#039acc" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </th>
+ <th
+ >
Description
- </font>
- </td>
- <td bgcolor="#039acc" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </th>
+ <th
+ >
Multivalued
- </font>
- </td>
- </tr>
- <tr>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </th>
+ </tr>
+ <tr class="b">
+ <td
+ >
<a href="#build">additional-build</a>
- </font>
- </td>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </td>
+ <td
+ >
The details of how to compile and assemble the project's
additional Jars. These are Jar files that are assembled as
part of the build, but not included as part of the project
output. For example, test Jar files.
- </font>
- </td>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </td>
+ <td
+ >
yes
- </font>
- </td>
- </tr>
- <tr>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </td>
+ </tr>
+ <tr class="a">
+ <td
+ >
<a href="#build">build</a>
- </font>
- </td>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </td>
+ <td
+ >
The details of how to compile the project and assemble it
into jar files.
- </font>
- </td>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </td>
+ <td
+ >
no
- </font>
- </td>
- </tr>
- <tr>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </td>
+ </tr>
+ <tr class="b">
+ <td
+ >
classpath
- </font>
- </td>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </td>
+ <td
+ >
The project classpath, used for compiling the project
Jars, unit tests, and additional Jars. This is an Ant
<code><path></code> data-type.
- </font>
- </td>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </td>
+ <td
+ >
no
- </font>
- </td>
- </tr>
- <tr>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </td>
+ </tr>
+ <tr class="a">
+ <td
+ >
compilePatterns
- </font>
- </td>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </td>
+ <td
+ >
The include and exclude patterns to use when compiling the
project Jars, unit tests, and additional Jars. This is an
Ant <code><patternset></code> data-type.
- </font>
- </td>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </td>
+ <td
+ >
no
- </font>
- </td>
- </tr>
- <tr>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </td>
+ </tr>
+ <tr class="b">
+ <td
+ >
copyrightYear
- </font>
- </td>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </td>
+ <td
+ >
The year(s) that the project was copyrighted in.
- </font>
- </td>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </td>
+ <td
+ >
no
- </font>
- </td>
- </tr>
- <tr>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </td>
+ </tr>
+ <tr class="a">
+ <td
+ >
currentVersion
- </font>
- </td>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </td>
+ <td
+ >
The version number for the project.
- </font>
- </td>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </td>
+ <td
+ >
no
- </font>
- </td>
- </tr>
- <tr>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </td>
+ </tr>
+ <tr class="b">
+ <td
+ >
dist
- </font>
- </td>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </td>
+ <td
+ >
The additional Ant tasks for preparing the distribution.
By default, the project's jar files and Javadocs are copied
into the distribution directory. Use this element to perform
extra tasks to assemble the distribution.
- </font>
- </td>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </td>
+ <td
+ >
no
- </font>
- </td>
- </tr>
- <tr>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </td>
+ </tr>
+ <tr class="a">
+ <td
+ >
id
- </font>
- </td>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </td>
+ <td
+ >
The identifier for the project. Used in generated file
and directory names.
- </font>
- </td>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </td>
+ <td
+ >
no
- </font>
- </td>
- </tr>
- <tr>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </td>
+ </tr>
+ <tr class="b">
+ <td
+ >
name
- </font>
- </td>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </td>
+ <td
+ >
The descriptive name of the project. Used as the title
for the project's Javadocs.
- </font>
- </td>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </td>
+ <td
+ >
no
- </font>
- </td>
- </tr>
- <tr>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </td>
+ </tr>
+ <tr class="a">
+ <td
+ >
property
- </font>
- </td>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </td>
+ <td
+ >
A global build property. This is an Ant
<code><property></code> task.
- </font>
- </td>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </td>
+ <td
+ >
yes
- </font>
- </td>
- </tr>
- <tr>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </td>
+ </tr>
+ <tr class="b">
+ <td
+ >
target
- </font>
- </td>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </td>
+ <td
+ >
An additional target to add to the build file. This is
an Ant target, and is copied directly into the generated
build
file.
- </font>
- </td>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </td>
+ <td
+ >
yes
- </font>
- </td>
- </tr>
- <tr>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </td>
+ </tr>
+ <tr class="a">
+ <td
+ >
<a href="#unittest">unitTest</a>
- </font>
- </td>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </td>
+ <td
+ >
The details of how to compile and execute the unit tests.
- </font>
- </td>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </td>
+ <td
+ >
no
- </font>
- </td>
- </tr>
+ </td>
+ </tr>
</table>
- <table border="0" cellspacing="0"
cellpadding="2" width="100%">
- <tr><td bgcolor="#828DA6">
- <font color="#ffffff" face="arial,helvetica,sanserif">
- <a name="build"><strong>Build Definition</strong></a>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <p>The <code><build></code> and
<code><additional-build></code>
+ <div class="h4">
+ <h4><a name="build">Build Definition</a></h4>
+ <p>The <code><build></code> and
<code><additional-build></code>
elements describes how to compile and assemble a set of Jar
files.
The <code><build></code> element describes the Jar files
included as part of the project's output. The
<code><additional-build></code> describes Jar files that
are
not included in the project's output, such as test files.
These elements may contain the following nested elements:</p>
- <table>
- <tr>
- <td bgcolor="#039acc" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ <table cellpadding="3" cellspacing="2" border="1"
width="100%">
+ <tr class="a">
+ <th
+ >
Element
- </font>
- </td>
- <td bgcolor="#039acc" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </th>
+ <th
+ >
Description
- </font>
- </td>
- <td bgcolor="#039acc" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </th>
+ <th
+ >
Multivalued
- </font>
- </td>
- </tr>
- <tr>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </th>
+ </tr>
+ <tr class="b">
+ <td
+ >
classpath
- </font>
- </td>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </td>
+ <td
+ >
The classpath to use for compiling the Jars. This is
an Ant <code><path></code> data-type. This
classpath
is appended to the project classpath. Note that the Ant
@@ -430,527 +339,372 @@
include the Ant runtime, add an empty
<code><ant-runtime></code> element to this
<code><classpath></code> element.
- </font>
- </td>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </td>
+ <td
+ >
no
- </font>
- </td>
- </tr>
- <tr>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </td>
+ </tr>
+ <tr class="a">
+ <td
+ >
compilePatterns
- </font>
- </td>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </td>
+ <td
+ >
The patternset to use when compiling the project source.
This is an Ant <code><patternset></code> data-type.
This patternset is added to the project compile
patternset.
- </font>
- </td>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </td>
+ <td
+ >
yes
- </font>
- </td>
- </tr>
- <tr>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </td>
+ </tr>
+ <tr class="b">
+ <td
+ >
<a href="#jar">jar</a>
- </font>
- </td>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </td>
+ <td
+ >
Defines a Jar output file.
- </font>
- </td>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </td>
+ <td
+ >
yes
- </font>
- </td>
- </tr>
- <tr>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </td>
+ </tr>
+ <tr class="a">
+ <td
+ >
lib-path
- </font>
- </td>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </td>
+ <td
+ >
Defines the directory to place the assembled Jar files
(<code><additional-build></code> only).
- </font>
- </td>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </td>
+ <td
+ >
no
- </font>
- </td>
- </tr>
- <tr>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </td>
+ </tr>
+ <tr class="b">
+ <td
+ >
prepare
- </font>
- </td>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </td>
+ <td
+ >
Additional Ant tasks to perform before compiling
the source. This can be used, for example, to check for
the availability of various libraries
(<code><build></code>
only).
- </font>
- </td>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </td>
+ <td
+ >
no
- </font>
- </td>
- </tr>
- <tr>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </td>
+ </tr>
+ <tr class="a">
+ <td
+ >
sourceDirectory
- </font>
- </td>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </td>
+ <td
+ >
The directory containing the project's Java source files.
- </font>
- </td>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </td>
+ <td
+ >
yes
- </font>
- </td>
- </tr>
+ </td>
+ </tr>
</table>
- </blockquote>
- </td></tr>
- </table>
- <table border="0" cellspacing="0"
cellpadding="2" width="100%">
- <tr><td bgcolor="#828DA6">
- <font color="#ffffff" face="arial,helvetica,sanserif">
- <a name="unittest"><strong>Unit Test
Definition</strong></a>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <p>The <code><unitTest></code> element defines
how to compile
+ </div>
+ <div class="h4">
+ <h4><a name="unittest">Unit Test Definition</a></h4>
+ <p>The <code><unitTest></code> element defines how
to compile
and execute the project's unit tests. The
<code><unitTest></code>
element may contain the following nested elements:</p>
- <table>
- <tr>
- <td bgcolor="#039acc" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ <table cellpadding="3" cellspacing="2" border="1"
width="100%">
+ <tr class="a">
+ <th
+ >
Element
- </font>
- </td>
- <td bgcolor="#039acc" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </th>
+ <th
+ >
Description
- </font>
- </td>
- <td bgcolor="#039acc" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </th>
+ <th
+ >
Multivalued
- </font>
- </td>
- </tr>
- <tr>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </th>
+ </tr>
+ <tr class="b">
+ <td
+ >
classpath
- </font>
- </td>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </td>
+ <td
+ >
The classpath to use for compiling and executing the
project unit tests. This is appended to the project
classpath. This is an Ant <code><path></code>
data-type.
- </font>
- </td>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </td>
+ <td
+ >
no
- </font>
- </td>
- </tr>
- <tr>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </td>
+ </tr>
+ <tr class="a">
+ <td
+ >
compilePatterns
- </font>
- </td>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </td>
+ <td
+ >
The patternset to use when compiling the unit tests.
This is an Ant <code><patternset></code>. This
is combined with the compile patternset.
- </font>
- </td>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </td>
+ <td
+ >
yes
- </font>
- </td>
- </tr>
- <tr>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </td>
+ </tr>
+ <tr class="b">
+ <td
+ >
includeDescriptors
- </font>
- </td>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </td>
+ <td
+ >
Controls whether antlib descriptors are generated for
the unit tests. Descriptors are generated by default.
- </font>
- </td>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </td>
+ <td
+ >
no
- </font>
- </td>
- </tr>
- <tr>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </td>
+ </tr>
+ <tr class="a">
+ <td
+ >
prepare
- </font>
- </td>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </td>
+ <td
+ >
Additional Ant tasks to perform before executing the
unit tests.
- </font>
- </td>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </td>
+ <td
+ >
no
- </font>
- </td>
- </tr>
- <tr>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </td>
+ </tr>
+ <tr class="b">
+ <td
+ >
sourceDirectory
- </font>
- </td>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </td>
+ <td
+ >
The directory containing the project's unit test source files.
- </font>
- </td>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </td>
+ <td
+ >
no
- </font>
- </td>
- </tr>
- <tr>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </td>
+ </tr>
+ <tr class="a">
+ <td
+ >
unitTestPatterns
- </font>
- </td>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </td>
+ <td
+ >
The patternset to use to select the unit tests to execute.
This is an Ant <code><patternset></code> datatype.
- </font>
- </td>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </td>
+ <td
+ >
no
- </font>
- </td>
- </tr>
+ </td>
+ </tr>
</table>
- </blockquote>
- </td></tr>
- </table>
- <table border="0" cellspacing="0"
cellpadding="2" width="100%">
- <tr><td bgcolor="#828DA6">
- <font color="#ffffff" face="arial,helvetica,sanserif">
- <a name="jar"><strong>Jar Definition</strong></a>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <p>A <code><jar></code> element defines a jar
file produced by
+ </div>
+ <div class="h4">
+ <h4><a name="jar">Jar Definition</a></h4>
+ <p>A <code><jar></code> element defines a jar file
produced by
the build. A manifest and antlib descriptors are generated for
the Jar.
A <code><jar></code> element may take the following nested
elements:</p>
- <table>
- <tr>
- <td bgcolor="#039acc" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ <table cellpadding="3" cellspacing="2" border="1"
width="100%">
+ <tr class="a">
+ <th
+ >
Element
- </font>
- </td>
- <td bgcolor="#039acc" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </th>
+ <th
+ >
Description
- </font>
- </td>
- <td bgcolor="#039acc" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </th>
+ <th
+ >
Multivalued
- </font>
- </td>
- </tr>
- <tr>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </th>
+ </tr>
+ <tr class="b">
+ <td
+ >
attribute
- </font>
- </td>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </td>
+ <td
+ >
Defines an attribute to add to the main section of
the manifest.
- </font>
- </td>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </td>
+ <td
+ >
yes
- </font>
- </td>
- </tr>
- <tr>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </td>
+ </tr>
+ <tr class="a">
+ <td
+ >
depends
- </font>
- </td>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </td>
+ <td
+ >
Defines the extensions which the output file depends on.
Used to generate the manifest.
- </font>
- </td>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </td>
+ <td
+ >
no
- </font>
- </td>
- </tr>
- <tr>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </td>
+ </tr>
+ <tr class="b">
+ <td
+ >
extension
- </font>
- </td>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </td>
+ <td
+ >
Defines an extension. Used to generate the manifest.
- </font>
- </td>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </td>
+ <td
+ >
no
- </font>
- </td>
- </tr>
- <tr>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </td>
+ </tr>
+ <tr class="a">
+ <td
+ >
fileset
- </font>
- </td>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </td>
+ <td
+ >
Additional files to include in the Jar. This
is an Ant <code><fileset></code> datatype.
- </font>
- </td>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </td>
+ <td
+ >
yes
- </font>
- </td>
- </tr>
- <tr>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </td>
+ </tr>
+ <tr class="b">
+ <td
+ >
id
- </font>
- </td>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </td>
+ <td
+ >
A unique short name for the Jar. This is used
in the file name, and the names of generated files.
- </font>
- </td>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </td>
+ <td
+ >
no
- </font>
- </td>
- </tr>
- <tr>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </td>
+ </tr>
+ <tr class="a">
+ <td
+ >
includeDescriptors
- </font>
- </td>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </td>
+ <td
+ >
Controls whether antlib descriptors are generated for
the Jar. Descriptors are generated by default.
- </font>
- </td>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </td>
+ <td
+ >
no
- </font>
- </td>
- </tr>
- <tr>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </td>
+ </tr>
+ <tr class="b">
+ <td
+ >
metainf
- </font>
- </td>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </td>
+ <td
+ >
See the Ant <code><jar></code> task.
- </font>
- </td>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </td>
+ <td
+ >
yes
- </font>
- </td>
- </tr>
- <tr>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </td>
+ </tr>
+ <tr class="a">
+ <td
+ >
name
- </font>
- </td>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </td>
+ <td
+ >
Specifies the name of the Jar. By default, the
name is generated from the Jar Id and current project
version.
- </font>
- </td>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </td>
+ <td
+ >
no
- </font>
- </td>
- </tr>
- <tr>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </td>
+ </tr>
+ <tr class="b">
+ <td
+ >
patternset
- </font>
- </td>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </td>
+ <td
+ >
Specifies which classes to include in the Jar.
This is an Ant <code><patternset></code>.
- </font>
- </td>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </td>
+ <td
+ >
no
- </font>
- </td>
- </tr>
+ </td>
+ </tr>
</table>
- </blockquote>
- </td></tr>
- </table>
- </blockquote>
- </td></tr>
- </table>
- </td>
+ </div>
+ </div>
+ </div></div></td>
</tr>
-
- <!-- FOOTER -->
- <tr><td colspan="2">
- <hr noshade="" size="1"/>
- </td></tr>
- <tr><td colspan="2">
- <div align="center"><font color="#525D76" size="-1"><em>
- Copyright © 2000-2002, Apache Software Foundation
- </em></font></div>
- </td></tr>
</table>
+
+ <!-- FOOTER -->
+ <div id="footer">
+ <table border="0" cellspacing="0" cellpadding="4">
+ <tr>
+ <td>Copyright © 2000-2002, Apache Software Foundation</td>
+ </tr>
+ </table>
+ </div>
+
</body>
</html>
<!-- end the processing -->
1.4 +139 -179 jakarta-ant-myrmidon/site/docs/running.html
Index: running.html
===================================================================
RCS file: /home/cvs/jakarta-ant-myrmidon/site/docs/running.html,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- running.html 2 Jun 2002 14:05:55 -0000 1.3
+++ running.html 6 Jun 2002 12:54:28 -0000 1.4
@@ -6,234 +6,194 @@
<!-- start the processing -->
<html>
<head>
+ <style type="text/css">
+ @import url("./css/tigris.css");
+ @import url("./css/site.css");
+ </style>
<meta http-equiv="Content-Type" content="text/html;
charset=iso-8859-1"/>
-
+
<meta name="author" value="Adam Murdoch">
<meta name="email" value="[EMAIL PROTECTED]">
-
+
<title>Apache Myrmidon - Running Myrmidon</title>
</head>
-
- <body bgcolor="#ffffff" text="#000000" link="#525D76">
- <table border="0" width="100%" cellspacing="0">
- <!-- TOP IMAGE -->
- <tr>
- <td> <td colspan="2">
+
+ <body marginwidth="0" marginheight="0" class="composite">
+
+ <div id="banner">
+ <table border="0" cellspacing="0" cellpadding="8" width="100%">
+ <!-- TOP IMAGE -->
+ <tr>
+ <td> <td colspan="2">
<a href="http://jakarta.apache.org"><img
src="http://jakarta.apache.org/images/jakarta-logo.gif" align="left"
border="0"/></a>
</td>
</td>
- <td valign="bottom"><div align="right"><b><font size="+3"
color="#525D76">Apache Myrmidon</font></b></div></td>
- </tr>
- </table>
- <table border="0" width="100%" cellspacing="4">
- <tr><td colspan="2">
- <hr noshade="" size="1"/>
- </td></tr>
-
- <tr>
+ <td><div align="right" valign="bottom"><b><font size="+3">Apache
Myrmidon</font></b></div></td>
+ </tr>
+ </table>
+ </div>
+
+ <table border="0" cellspacing="0" cellpadding="8" width="100%"
id="main">
+ <tr valign="top">
<!-- LEFT SIDE NAVIGATION -->
- <td valign="top" nowrap="true">
- <p><strong>Myrmidon</strong></p>
- <ul>
- <li> <a href="./index.html">Introduction</a>
- </li>
- <li> <a href="./getinvolved.html">Get Involved</a>
- </li>
- <li> <a href="./building.html">Building Myrmidon</a>
- </li>
- <li> <a href="./todo.html">Todo List</a>
- </li>
- </ul>
- <p><strong>User Guide</strong></p>
- <ul>
- <li> <a href="./running.html">Installing and Running</a>
- </li>
- <li> <a href="./buildfile.html">Project File</a>
- </li>
- <li> <a href="./vfs.html">Virtual File System</a>
- </li>
- <li> <a href="./ant1compat.html">Ant 1 Compatibility Layer</a>
- </li>
- <li> <a href="./differences.html">Differences to Ant 1</a>
- </li>
- <li> <a href="./task.html">My First Task</a>
- </li>
- </ul>
- <p><strong>Extending Myrmidon</strong></p>
- <ul>
- <li> <a href="./configuring.html">Configuration HOWTO</a>
- </li>
- <li> <a href="./converter.html">Converter HOWTO</a>
- </li>
- <li> <a href="./type.html">Type HOWTO</a>
- </li>
- <li> <a href="./classloader.html">ClassLoader HOWTO</a>
- </li>
- <li> <a href="./librarys.html">Library HOWTO</a>
- </li>
- </ul>
- <p><strong>Developers Guide</strong></p>
- <ul>
- <li> <a href="./subprojects.html">Sub Projects</a>
- </li>
- <li> <a href="./project-descriptor.html">The Build System</a>
- </li>
- </ul>
- </td>
- <td align="left" valign="top">
- <table border="0" cellspacing="0" cellpadding="2" width="100%">
- <tr><td bgcolor="#525D76">
- <font color="#ffffff" face="arial,helvetica,sanserif">
- <a name="Installing Myrmidon"><strong>Installing
Myrmidon</strong></a>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <p>Installing Myrmidon is easy. Simply extract the
contents of the
+ <td id="leftcol" width="20%">
+ <div id="navcolumn">
+ <div>
+ <strong>Myrmidon</strong>
+ <div><small> <a href="./index.html">Introduction</a>
+ </small></div>
+ <div><small> <a href="./getinvolved.html">Get Involved</a>
+ </small></div>
+ <div><small> <a href="./building.html">Building
Myrmidon</a>
+ </small></div>
+ <div><small> <a href="./todo.html">Todo List</a>
+ </small></div>
+ </div>
+ <div>
+ <strong>User Guide</strong>
+ <div><small> <a href="./running.html">Installing and
Running</a>
+ </small></div>
+ <div><small> <a href="./buildfile.html">Project File</a>
+ </small></div>
+ <div><small> <a href="./properties.html">Properties</a>
+ </small></div>
+ <div><small> <a href="./vfs.html">Virtual File System</a>
+ </small></div>
+ <div><small> <a href="./ant1compat.html">Ant 1
Compatibility Layer</a>
+ </small></div>
+ <div><small> <a href="./differences.html">Differences to
Ant 1</a>
+ </small></div>
+ <div><small> <a href="./task.html">My First Task</a>
+ </small></div>
+ </div>
+ <div>
+ <strong>Extending Myrmidon</strong>
+ <div><small> <a href="./configuring.html">Configuration
HOWTO</a>
+ </small></div>
+ <div><small> <a href="./converter.html">Converter
HOWTO</a>
+ </small></div>
+ <div><small> <a href="./type.html">Type HOWTO</a>
+ </small></div>
+ <div><small> <a href="./classloader.html">ClassLoader
HOWTO</a>
+ </small></div>
+ <div><small> <a href="./librarys.html">Library HOWTO</a>
+ </small></div>
+ </div>
+ <div>
+ <strong>Developers Guide</strong>
+ <div><small> <a href="./subprojects.html">Sub Projects</a>
+ </small></div>
+ <div><small> <a href="./project-descriptor.html">The
Build System</a>
+ </small></div>
+ </div>
+ </div>
+ </td>
+ <td><div id="bodycol"><div class="app">
+ <div class="h3">
+ <h3><a name="Installing Myrmidon">Installing Myrmidon</a></h3>
+ <p>Installing Myrmidon is easy. Simply extract the
contents of the
distribution zip or tar file, to whichever install directory you like.
You
should also add the distribution's <code>bin</code> directory to the
<code>PATH</code> environment variable.</p>
- </blockquote>
- </td></tr>
- </table>
- <table border="0" cellspacing="0" cellpadding="2" width="100%">
- <tr><td bgcolor="#525D76">
- <font color="#ffffff" face="arial,helvetica,sanserif">
- <a name="Running Myrmidon"><strong>Running
Myrmidon</strong></a>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <p>
+ </div>
+ <div class="h3">
+ <h3><a name="Running Myrmidon">Running Myrmidon</a></h3>
+ <p>
To run Myrmidon, use one of the following methods:
</p>
- <table border="0" cellspacing="0"
cellpadding="2" width="100%">
- <tr><td bgcolor="#828DA6">
- <font color="#ffffff" face="arial,helvetica,sanserif">
- <a name="Launcher Script"><strong>Launcher
Script</strong></a>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <p>
+ <div class="h4">
+ <h4><a name="Launcher Script">Launcher Script</a></h4>
+ <p>
On Windows and Unix platforms, you can use the <code>ant</code> script
in the distribution's <code>bin</code> directory. The following
environment
variables can be used, but are not required (except on Windows 9x - see
below).
</p>
- <p>
+ <p>
</p>
- <table>
- <tr>
- <td bgcolor="#039acc" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ <table cellpadding="3" cellspacing="2" border="1"
width="100%">
+ <tr class="a">
+ <th
+ >
Variable
- </font>
- </td>
- <td bgcolor="#039acc" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </th>
+ <th
+ >
Description
- </font>
- </td>
- </tr>
- <tr>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </th>
+ </tr>
+ <tr class="b">
+ <td
+ >
JAVA_HOME
- </font>
- </td>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </td>
+ <td
+ >
The directory that the JDK is installed in.
- </font>
- </td>
- </tr>
- <tr>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </td>
+ </tr>
+ <tr class="a">
+ <td
+ >
JAVACMD
- </font>
- </td>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </td>
+ <td
+ >
The command to use to start the JVM. Defaults to
<code>java</code>.
- </font>
- </td>
- </tr>
- <tr>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </td>
+ </tr>
+ <tr class="b">
+ <td
+ >
ANT_HOME
- </font>
- </td>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </td>
+ <td
+ >
The directory containing the Myrmidon distribution. This
must be
set when running on Windows 95, 98 or Me.
- </font>
- </td>
- </tr>
+ </td>
+ </tr>
</table>
- </blockquote>
- </td></tr>
- </table>
- <table border="0" cellspacing="0"
cellpadding="2" width="100%">
- <tr><td bgcolor="#828DA6">
- <font color="#ffffff" face="arial,helvetica,sanserif">
- <a name="Executable Jar File"><strong>Executable Jar
File</strong></a>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <p>
+ </div>
+ <div class="h4">
+ <h4><a name="Executable Jar File">Executable Jar File</a></h4>
+ <p>
The Myrmidon distribution includes an executable Jar file, which can be
used
to run Myrmidon. Use the following command:
</p>
- <pre>
+ <pre>
prompt> <i>java</i> -jar <i>ant-home</i>/bin/myrmidon-launcher.jar
<i>options</i>
</pre>
- </blockquote>
- </td></tr>
- </table>
- <p>When started, Myrmidon looks for a
project file called <code>build.ant</code>
+ </div>
+ <p>When started, Myrmidon looks for a project file
called <code>build.ant</code>
in the current directory. A different project file can be specified
using the
<code>-f</code> command-line option. Myrmidon executes the targets that
are
listed on the command-line, or the default target if none is given. For
example, the following command executes targets <code>clean</code> and
<code>build</code> from project file <code>my-project.xml</code>:</p>
- <pre>
+ <pre>
prompt> ant -f my-project.xml clean build
</pre>
- <p>
+ <p>
Run Myrmidon with the <code>-h</code> command-line option for a list of
the command-line options that are available.
</p>
- </blockquote>
- </td></tr>
- </table>
- </td>
+ </div>
+ </div></div></td>
</tr>
-
- <!-- FOOTER -->
- <tr><td colspan="2">
- <hr noshade="" size="1"/>
- </td></tr>
- <tr><td colspan="2">
- <div align="center"><font color="#525D76" size="-1"><em>
- Copyright © 2000-2002, Apache Software Foundation
- </em></font></div>
- </td></tr>
</table>
+
+ <!-- FOOTER -->
+ <div id="footer">
+ <table border="0" cellspacing="0" cellpadding="4">
+ <tr>
+ <td>Copyright © 2000-2002, Apache Software Foundation</td>
+ </tr>
+ </table>
+ </div>
+
</body>
</html>
<!-- end the processing -->
1.5 +171 -211 jakarta-ant-myrmidon/site/docs/subprojects.html
Index: subprojects.html
===================================================================
RCS file: /home/cvs/jakarta-ant-myrmidon/site/docs/subprojects.html,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -r1.4 -r1.5
--- subprojects.html 19 May 2002 13:37:50 -0000 1.4
+++ subprojects.html 6 Jun 2002 12:54:28 -0000 1.5
@@ -6,272 +6,232 @@
<!-- start the processing -->
<html>
<head>
+ <style type="text/css">
+ @import url("./css/tigris.css");
+ @import url("./css/site.css");
+ </style>
<meta http-equiv="Content-Type" content="text/html;
charset=iso-8859-1"/>
-
+
<meta name="author" value="Adam Murdoch">
<meta name="email" value="[EMAIL PROTECTED]">
-
+
<title>Apache Myrmidon - Myrmidon Subprojects</title>
</head>
-
- <body bgcolor="#ffffff" text="#000000" link="#525D76">
- <table border="0" width="100%" cellspacing="0">
- <!-- TOP IMAGE -->
- <tr>
- <td> <td colspan="2">
+
+ <body marginwidth="0" marginheight="0" class="composite">
+
+ <div id="banner">
+ <table border="0" cellspacing="0" cellpadding="8" width="100%">
+ <!-- TOP IMAGE -->
+ <tr>
+ <td> <td colspan="2">
<a href="http://jakarta.apache.org"><img
src="http://jakarta.apache.org/images/jakarta-logo.gif" align="left"
border="0"/></a>
</td>
</td>
- <td valign="bottom"><div align="right"><b><font size="+3"
color="#525D76">Apache Myrmidon</font></b></div></td>
- </tr>
- </table>
- <table border="0" width="100%" cellspacing="4">
- <tr><td colspan="2">
- <hr noshade="" size="1"/>
- </td></tr>
-
- <tr>
+ <td><div align="right" valign="bottom"><b><font size="+3">Apache
Myrmidon</font></b></div></td>
+ </tr>
+ </table>
+ </div>
+
+ <table border="0" cellspacing="0" cellpadding="8" width="100%"
id="main">
+ <tr valign="top">
<!-- LEFT SIDE NAVIGATION -->
- <td valign="top" nowrap="true">
- <p><strong>Myrmidon</strong></p>
- <ul>
- <li> <a href="./index.html">Introduction</a>
- </li>
- <li> <a href="./getinvolved.html">Get Involved</a>
- </li>
- <li> <a href="./building.html">Building Myrmidon</a>
- </li>
- <li> <a href="./todo.html">Todo List</a>
- </li>
- </ul>
- <p><strong>User Guide</strong></p>
- <ul>
- <li> <a href="./running.html">Installing and Running</a>
- </li>
- <li> <a href="./buildfile.html">Project File</a>
- </li>
- <li> <a href="./vfs.html">Virtual File System</a>
- </li>
- <li> <a href="./ant1compat.html">Ant 1 Compatibility Layer</a>
- </li>
- <li> <a href="./differences.html">Differences to Ant 1</a>
- </li>
- <li> <a href="./task.html">My First Task</a>
- </li>
- </ul>
- <p><strong>Extending Myrmidon</strong></p>
- <ul>
- <li> <a href="./configuring.html">Configuration HOWTO</a>
- </li>
- <li> <a href="./converter.html">Converter HOWTO</a>
- </li>
- <li> <a href="./type.html">Type HOWTO</a>
- </li>
- <li> <a href="./classloader.html">ClassLoader HOWTO</a>
- </li>
- <li> <a href="./librarys.html">Library HOWTO</a>
- </li>
- </ul>
- <p><strong>Developers Guide</strong></p>
- <ul>
- <li> <a href="./subprojects.html">Sub Projects</a>
- </li>
- <li> <a href="./project-descriptor.html">The Build System</a>
- </li>
- </ul>
- </td>
- <td align="left" valign="top">
- <table border="0" cellspacing="0" cellpadding="2" width="100%">
- <tr><td bgcolor="#525D76">
- <font color="#ffffff" face="arial,helvetica,sanserif">
- <a name="Myrmidon Subprojects"><strong>Myrmidon
Subprojects</strong></a>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <p>Myrmidon is made up of several sub-projects. The
projects are described below,
+ <td id="leftcol" width="20%">
+ <div id="navcolumn">
+ <div>
+ <strong>Myrmidon</strong>
+ <div><small> <a href="./index.html">Introduction</a>
+ </small></div>
+ <div><small> <a href="./getinvolved.html">Get Involved</a>
+ </small></div>
+ <div><small> <a href="./building.html">Building
Myrmidon</a>
+ </small></div>
+ <div><small> <a href="./todo.html">Todo List</a>
+ </small></div>
+ </div>
+ <div>
+ <strong>User Guide</strong>
+ <div><small> <a href="./running.html">Installing and
Running</a>
+ </small></div>
+ <div><small> <a href="./buildfile.html">Project File</a>
+ </small></div>
+ <div><small> <a href="./properties.html">Properties</a>
+ </small></div>
+ <div><small> <a href="./vfs.html">Virtual File System</a>
+ </small></div>
+ <div><small> <a href="./ant1compat.html">Ant 1
Compatibility Layer</a>
+ </small></div>
+ <div><small> <a href="./differences.html">Differences to
Ant 1</a>
+ </small></div>
+ <div><small> <a href="./task.html">My First Task</a>
+ </small></div>
+ </div>
+ <div>
+ <strong>Extending Myrmidon</strong>
+ <div><small> <a href="./configuring.html">Configuration
HOWTO</a>
+ </small></div>
+ <div><small> <a href="./converter.html">Converter
HOWTO</a>
+ </small></div>
+ <div><small> <a href="./type.html">Type HOWTO</a>
+ </small></div>
+ <div><small> <a href="./classloader.html">ClassLoader
HOWTO</a>
+ </small></div>
+ <div><small> <a href="./librarys.html">Library HOWTO</a>
+ </small></div>
+ </div>
+ <div>
+ <strong>Developers Guide</strong>
+ <div><small> <a href="./subprojects.html">Sub Projects</a>
+ </small></div>
+ <div><small> <a href="./project-descriptor.html">The
Build System</a>
+ </small></div>
+ </div>
+ </div>
+ </td>
+ <td><div id="bodycol"><div class="app">
+ <div class="h3">
+ <h3><a name="Myrmidon Subprojects">Myrmidon Subprojects</a></h3>
+ <p>Myrmidon is made up of several sub-projects. The
projects are described below,
in rough order of dependency. Most of these projects are intended to be
reusable outside Myrmidon. Each project is contained in its own
subdirectory of the source tree. The directory layout for each project
is the same.</p>
- <p>The projects are:</p>
- <table>
- <tr>
- <td bgcolor="#039acc" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ <p>The projects are:</p>
+ <table cellpadding="3" cellspacing="2" border="1"
width="100%">
+ <tr class="a">
+ <th
+ >
Project
- </font>
- </td>
- <td bgcolor="#039acc" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </th>
+ <th
+ >
Description
- </font>
- </td>
- </tr>
- <tr>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </th>
+ </tr>
+ <tr class="b">
+ <td
+ >
buildtools
- </font>
- </td>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </td>
+ <td
+ >
Utilities used to build Myrmidon.
- </font>
- </td>
- </tr>
- <tr>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </td>
+ </tr>
+ <tr class="a">
+ <td
+ >
aut
- </font>
- </td>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </td>
+ <td
+ >
A library of reusable system level components. These components
provide low-level services, such as managing the execution of
native commands, or providing a Virtual File System.
- </font>
- </td>
- </tr>
- <tr>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </td>
+ </tr>
+ <tr class="b">
+ <td
+ >
api
- </font>
- </td>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </td>
+ <td
+ >
This project defines the task API. This is the API which the
tasks use to communicate with the task container that they are
executing in.
- </font>
- </td>
- </tr>
- <tr>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </td>
+ </tr>
+ <tr class="a">
+ <td
+ >
container
- </font>
- </td>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </td>
+ <td
+ >
The implementation of the task container. This project can be
split into two broad parts: The container API, which defines the
set of services that are assembled together to form the
container,
and the standard implementations of those services. This project
also contains front-ends for embedding Myrmidon, or running it
from the command-line.
- </font>
- </td>
- </tr>
- <tr>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </td>
+ </tr>
+ <tr class="b">
+ <td
+ >
framework
- </font>
- </td>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </td>
+ <td
+ >
A collection of general purpose classes which can be used as the
starting point for writing tasks. This includes general purpose
data types, utility classes, and a handful of abstract task
implementations.
- </font>
- </td>
- </tr>
- <tr>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </td>
+ </tr>
+ <tr class="a">
+ <td
+ >
antlib
- </font>
- </td>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </td>
+ <td
+ >
The tasks libraries, or <i>antlibs</i>, which contain the
standard tasks and data-types for the Myrmidon distribution.
- </font>
- </td>
- </tr>
- <tr>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </td>
+ </tr>
+ <tr class="b">
+ <td
+ >
ant1compat
- </font>
- </td>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </td>
+ <td
+ >
The Ant 1 compatibility library. This is an antlib which provides
an adaptor between the Ant 1 classes, and the Myrmidon task and
container APIs. It allows tasks compiled for Ant 1 to execute in
Myrmidon without modification. The ant1compat antlib also
includes
all of the Ant 1 tasks, which makes them available for use in
Myrmidon projects.
- </font>
- </td>
- </tr>
- <tr>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </td>
+ </tr>
+ <tr class="a">
+ <td
+ >
myrmidon
- </font>
- </td>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </td>
+ <td
+ >
This project assembles the output from the other projects into
the final Myrmidon distribution.
- </font>
- </td>
- </tr>
- <tr>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </td>
+ </tr>
+ <tr class="b">
+ <td
+ >
site
- </font>
- </td>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </td>
+ <td
+ >
The documentation and web site for Myrmidon.
- </font>
- </td>
- </tr>
+ </td>
+ </tr>
</table>
- </blockquote>
- </td></tr>
- </table>
- </td>
+ </div>
+ </div></div></td>
</tr>
-
- <!-- FOOTER -->
- <tr><td colspan="2">
- <hr noshade="" size="1"/>
- </td></tr>
- <tr><td colspan="2">
- <div align="center"><font color="#525D76" size="-1"><em>
- Copyright © 2000-2002, Apache Software Foundation
- </em></font></div>
- </td></tr>
</table>
+
+ <!-- FOOTER -->
+ <div id="footer">
+ <table border="0" cellspacing="0" cellpadding="4">
+ <tr>
+ <td>Copyright © 2000-2002, Apache Software Foundation</td>
+ </tr>
+ </table>
+ </div>
+
</body>
</html>
<!-- end the processing -->
1.6 +101 -141 jakarta-ant-myrmidon/site/docs/task.html
Index: task.html
===================================================================
RCS file: /home/cvs/jakarta-ant-myrmidon/site/docs/task.html,v
retrieving revision 1.5
retrieving revision 1.6
diff -u -r1.5 -r1.6
--- task.html 19 May 2002 13:37:50 -0000 1.5
+++ task.html 6 Jun 2002 12:54:29 -0000 1.6
@@ -6,93 +6,95 @@
<!-- start the processing -->
<html>
<head>
+ <style type="text/css">
+ @import url("./css/tigris.css");
+ @import url("./css/site.css");
+ </style>
<meta http-equiv="Content-Type" content="text/html;
charset=iso-8859-1"/>
-
+
<meta name="author" value="Peter Donald">
<meta name="email" value="[EMAIL PROTECTED]">
-
+
<title>Apache Myrmidon - My First Task</title>
</head>
-
- <body bgcolor="#ffffff" text="#000000" link="#525D76">
- <table border="0" width="100%" cellspacing="0">
- <!-- TOP IMAGE -->
- <tr>
- <td> <td colspan="2">
+
+ <body marginwidth="0" marginheight="0" class="composite">
+
+ <div id="banner">
+ <table border="0" cellspacing="0" cellpadding="8" width="100%">
+ <!-- TOP IMAGE -->
+ <tr>
+ <td> <td colspan="2">
<a href="http://jakarta.apache.org"><img
src="http://jakarta.apache.org/images/jakarta-logo.gif" align="left"
border="0"/></a>
</td>
</td>
- <td valign="bottom"><div align="right"><b><font size="+3"
color="#525D76">Apache Myrmidon</font></b></div></td>
- </tr>
- </table>
- <table border="0" width="100%" cellspacing="4">
- <tr><td colspan="2">
- <hr noshade="" size="1"/>
- </td></tr>
-
- <tr>
+ <td><div align="right" valign="bottom"><b><font size="+3">Apache
Myrmidon</font></b></div></td>
+ </tr>
+ </table>
+ </div>
+
+ <table border="0" cellspacing="0" cellpadding="8" width="100%"
id="main">
+ <tr valign="top">
<!-- LEFT SIDE NAVIGATION -->
- <td valign="top" nowrap="true">
- <p><strong>Myrmidon</strong></p>
- <ul>
- <li> <a href="./index.html">Introduction</a>
- </li>
- <li> <a href="./getinvolved.html">Get Involved</a>
- </li>
- <li> <a href="./building.html">Building Myrmidon</a>
- </li>
- <li> <a href="./todo.html">Todo List</a>
- </li>
- </ul>
- <p><strong>User Guide</strong></p>
- <ul>
- <li> <a href="./running.html">Installing and Running</a>
- </li>
- <li> <a href="./buildfile.html">Project File</a>
- </li>
- <li> <a href="./vfs.html">Virtual File System</a>
- </li>
- <li> <a href="./ant1compat.html">Ant 1 Compatibility Layer</a>
- </li>
- <li> <a href="./differences.html">Differences to Ant 1</a>
- </li>
- <li> <a href="./task.html">My First Task</a>
- </li>
- </ul>
- <p><strong>Extending Myrmidon</strong></p>
- <ul>
- <li> <a href="./configuring.html">Configuration HOWTO</a>
- </li>
- <li> <a href="./converter.html">Converter HOWTO</a>
- </li>
- <li> <a href="./type.html">Type HOWTO</a>
- </li>
- <li> <a href="./classloader.html">ClassLoader HOWTO</a>
- </li>
- <li> <a href="./librarys.html">Library HOWTO</a>
- </li>
- </ul>
- <p><strong>Developers Guide</strong></p>
- <ul>
- <li> <a href="./subprojects.html">Sub Projects</a>
- </li>
- <li> <a href="./project-descriptor.html">The Build System</a>
- </li>
- </ul>
- </td>
- <td align="left" valign="top">
- <table border="0" cellspacing="0" cellpadding="2" width="100%">
- <tr><td bgcolor="#525D76">
- <font color="#ffffff" face="arial,helvetica,sanserif">
- <a name="My First Task"><strong>My First
Task</strong></a>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <p>In Ant 1 it was very easy to write your own task.
In Ant 2 we plan
+ <td id="leftcol" width="20%">
+ <div id="navcolumn">
+ <div>
+ <strong>Myrmidon</strong>
+ <div><small> <a href="./index.html">Introduction</a>
+ </small></div>
+ <div><small> <a href="./getinvolved.html">Get Involved</a>
+ </small></div>
+ <div><small> <a href="./building.html">Building
Myrmidon</a>
+ </small></div>
+ <div><small> <a href="./todo.html">Todo List</a>
+ </small></div>
+ </div>
+ <div>
+ <strong>User Guide</strong>
+ <div><small> <a href="./running.html">Installing and
Running</a>
+ </small></div>
+ <div><small> <a href="./buildfile.html">Project File</a>
+ </small></div>
+ <div><small> <a href="./properties.html">Properties</a>
+ </small></div>
+ <div><small> <a href="./vfs.html">Virtual File System</a>
+ </small></div>
+ <div><small> <a href="./ant1compat.html">Ant 1
Compatibility Layer</a>
+ </small></div>
+ <div><small> <a href="./differences.html">Differences to
Ant 1</a>
+ </small></div>
+ <div><small> <a href="./task.html">My First Task</a>
+ </small></div>
+ </div>
+ <div>
+ <strong>Extending Myrmidon</strong>
+ <div><small> <a href="./configuring.html">Configuration
HOWTO</a>
+ </small></div>
+ <div><small> <a href="./converter.html">Converter
HOWTO</a>
+ </small></div>
+ <div><small> <a href="./type.html">Type HOWTO</a>
+ </small></div>
+ <div><small> <a href="./classloader.html">ClassLoader
HOWTO</a>
+ </small></div>
+ <div><small> <a href="./librarys.html">Library HOWTO</a>
+ </small></div>
+ </div>
+ <div>
+ <strong>Developers Guide</strong>
+ <div><small> <a href="./subprojects.html">Sub Projects</a>
+ </small></div>
+ <div><small> <a href="./project-descriptor.html">The
Build System</a>
+ </small></div>
+ </div>
+ </div>
+ </td>
+ <td><div id="bodycol"><div class="app">
+ <div class="h3">
+ <h3><a name="My First Task">My First Task</a></h3>
+ <p>In Ant 1 it was very easy to write your own task. In
Ant 2 we plan
to make it even easier. To write a basic task simply follow the following
formula.</p>
- <ol>
+ <ol>
<li>
Create a Java class that extends
<code>org.apache.myrmidon.api.AbstractTask</code>
@@ -129,26 +131,12 @@
actual work of the task.
</li>
</ol>
- <table border="0" cellspacing="0"
cellpadding="2" width="100%">
- <tr><td bgcolor="#828DA6">
- <font color="#ffffff" face="arial,helvetica,sanserif">
- <a name="A Basic Example"><strong>A Basic
Example</strong></a>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <p>So a basic task that has one attribute named
"message" and just prints
+ <div class="h4">
+ <h4><a name="A Basic Example">A Basic Example</a></h4>
+ <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">
- <tr>
- <td bgcolor="#023264" width="1" height="1"><img
src="/images/void.gif" width="1" height="1" vspace="0" hspace="0"
border="0"/></td>
- <td bgcolor="#023264" height="1"><img src="/images/void.gif"
width="1" height="1" vspace="0" hspace="0" border="0"/></td>
- <td bgcolor="#023264" width="1" height="1"><img
src="/images/void.gif" width="1" height="1" vspace="0" hspace="0"
border="0"/></td>
- </tr>
- <tr>
- <td bgcolor="#023264" width="1"><img src="/images/void.gif"
width="1" height="1" vspace="0" hspace="0" border="0"/></td>
- <td bgcolor="#ffffff"><pre>
+ <div id="source">
+ <pre>
package org.realityforge.tasks;
import org.apache.myrmidon.api.AbstractTask;
@@ -172,28 +160,12 @@
System.out.println( m_message );
}
}
-</pre></td>
- <td bgcolor="#023264" width="1"><img src="/images/void.gif"
width="1" height="1" vspace="0" hspace="0" border="0"/></td>
- </tr>
- <tr>
- <td bgcolor="#023264" width="1" height="1"><img
src="/images/void.gif" width="1" height="1" vspace="0" hspace="0"
border="0"/></td>
- <td bgcolor="#023264" height="1"><img src="/images/void.gif"
width="1" height="1" vspace="0" hspace="0" border="0"/></td>
- <td bgcolor="#023264" width="1" height="1"><img
src="/images/void.gif" width="1" height="1" vspace="0" hspace="0"
border="0"/></td>
- </tr>
- </table>
+</pre>
</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">
- <tr>
- <td bgcolor="#023264" width="1" height="1"><img
src="/images/void.gif" width="1" height="1" vspace="0" hspace="0"
border="0"/></td>
- <td bgcolor="#023264" height="1"><img src="/images/void.gif"
width="1" height="1" vspace="0" hspace="0" border="0"/></td>
- <td bgcolor="#023264" width="1" height="1"><img
src="/images/void.gif" width="1" height="1" vspace="0" hspace="0"
border="0"/></td>
- </tr>
- <tr>
- <td bgcolor="#023264" width="1"><img src="/images/void.gif"
width="1" height="1" vspace="0" hspace="0" border="0"/></td>
- <td bgcolor="#ffffff"><pre>
+ <div id="source">
+ <pre>
<?xml version="1.0"?>
@@ -210,35 +182,23 @@
</project>
-</pre></td>
- <td bgcolor="#023264" width="1"><img src="/images/void.gif"
width="1" height="1" vspace="0" hspace="0" border="0"/></td>
- </tr>
- <tr>
- <td bgcolor="#023264" width="1" height="1"><img
src="/images/void.gif" width="1" height="1" vspace="0" hspace="0"
border="0"/></td>
- <td bgcolor="#023264" height="1"><img src="/images/void.gif"
width="1" height="1" vspace="0" hspace="0" border="0"/></td>
- <td bgcolor="#023264" width="1" height="1"><img
src="/images/void.gif" width="1" height="1" vspace="0" hspace="0"
border="0"/></td>
- </tr>
- </table>
+</pre>
</div>
- </blockquote>
- </td></tr>
- </table>
- </blockquote>
- </td></tr>
- </table>
- </td>
+ </div>
+ </div>
+ </div></div></td>
</tr>
-
- <!-- FOOTER -->
- <tr><td colspan="2">
- <hr noshade="" size="1"/>
- </td></tr>
- <tr><td colspan="2">
- <div align="center"><font color="#525D76" size="-1"><em>
- Copyright © 2000-2002, Apache Software Foundation
- </em></font></div>
- </td></tr>
</table>
+
+ <!-- FOOTER -->
+ <div id="footer">
+ <table border="0" cellspacing="0" cellpadding="4">
+ <tr>
+ <td>Copyright © 2000-2002, Apache Software Foundation</td>
+ </tr>
+ </table>
+ </div>
+
</body>
</html>
<!-- end the processing -->
1.7 +225 -497 jakarta-ant-myrmidon/site/docs/todo.html
Index: todo.html
===================================================================
RCS file: /home/cvs/jakarta-ant-myrmidon/site/docs/todo.html,v
retrieving revision 1.6
retrieving revision 1.7
diff -u -r1.6 -r1.7
--- todo.html 19 May 2002 13:37:50 -0000 1.6
+++ todo.html 6 Jun 2002 12:54:29 -0000 1.7
@@ -6,171 +6,135 @@
<!-- start the processing -->
<html>
<head>
+ <style type="text/css">
+ @import url("./css/tigris.css");
+ @import url("./css/site.css");
+ </style>
<meta http-equiv="Content-Type" content="text/html;
charset=iso-8859-1"/>
-
+
<meta name="author" value="Adam Murdoch">
<meta name="email" value="[EMAIL PROTECTED]">
<meta name="author" value="Peter Donald">
<meta name="email" value="[EMAIL PROTECTED]">
-
+
<title>Apache Myrmidon - Get Involved</title>
</head>
-
- <body bgcolor="#ffffff" text="#000000" link="#525D76">
- <table border="0" width="100%" cellspacing="0">
- <!-- TOP IMAGE -->
- <tr>
- <td> <td colspan="2">
+
+ <body marginwidth="0" marginheight="0" class="composite">
+
+ <div id="banner">
+ <table border="0" cellspacing="0" cellpadding="8" width="100%">
+ <!-- TOP IMAGE -->
+ <tr>
+ <td> <td colspan="2">
<a href="http://jakarta.apache.org"><img
src="http://jakarta.apache.org/images/jakarta-logo.gif" align="left"
border="0"/></a>
</td>
</td>
- <td valign="bottom"><div align="right"><b><font size="+3"
color="#525D76">Apache Myrmidon</font></b></div></td>
- </tr>
- </table>
- <table border="0" width="100%" cellspacing="4">
- <tr><td colspan="2">
- <hr noshade="" size="1"/>
- </td></tr>
-
- <tr>
+ <td><div align="right" valign="bottom"><b><font size="+3">Apache
Myrmidon</font></b></div></td>
+ </tr>
+ </table>
+ </div>
+
+ <table border="0" cellspacing="0" cellpadding="8" width="100%"
id="main">
+ <tr valign="top">
<!-- LEFT SIDE NAVIGATION -->
- <td valign="top" nowrap="true">
- <p><strong>Myrmidon</strong></p>
- <ul>
- <li> <a href="./index.html">Introduction</a>
- </li>
- <li> <a href="./getinvolved.html">Get Involved</a>
- </li>
- <li> <a href="./building.html">Building Myrmidon</a>
- </li>
- <li> <a href="./todo.html">Todo List</a>
- </li>
- </ul>
- <p><strong>User Guide</strong></p>
- <ul>
- <li> <a href="./running.html">Installing and Running</a>
- </li>
- <li> <a href="./buildfile.html">Project File</a>
- </li>
- <li> <a href="./vfs.html">Virtual File System</a>
- </li>
- <li> <a href="./ant1compat.html">Ant 1 Compatibility Layer</a>
- </li>
- <li> <a href="./differences.html">Differences to Ant 1</a>
- </li>
- <li> <a href="./task.html">My First Task</a>
- </li>
- </ul>
- <p><strong>Extending Myrmidon</strong></p>
- <ul>
- <li> <a href="./configuring.html">Configuration HOWTO</a>
- </li>
- <li> <a href="./converter.html">Converter HOWTO</a>
- </li>
- <li> <a href="./type.html">Type HOWTO</a>
- </li>
- <li> <a href="./classloader.html">ClassLoader HOWTO</a>
- </li>
- <li> <a href="./librarys.html">Library HOWTO</a>
- </li>
- </ul>
- <p><strong>Developers Guide</strong></p>
- <ul>
- <li> <a href="./subprojects.html">Sub Projects</a>
- </li>
- <li> <a href="./project-descriptor.html">The Build System</a>
- </li>
- </ul>
- </td>
- <td align="left" valign="top">
- <table border="0" cellspacing="0" cellpadding="2" width="100%">
- <tr><td bgcolor="#525D76">
- <font color="#ffffff" face="arial,helvetica,sanserif">
- <a name="Todo List"><strong>Todo List</strong></a>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <p>The broad goal is to grow Myrmidon from a
prototype task engine into a fully
+ <td id="leftcol" width="20%">
+ <div id="navcolumn">
+ <div>
+ <strong>Myrmidon</strong>
+ <div><small> <a href="./index.html">Introduction</a>
+ </small></div>
+ <div><small> <a href="./getinvolved.html">Get Involved</a>
+ </small></div>
+ <div><small> <a href="./building.html">Building
Myrmidon</a>
+ </small></div>
+ <div><small> <a href="./todo.html">Todo List</a>
+ </small></div>
+ </div>
+ <div>
+ <strong>User Guide</strong>
+ <div><small> <a href="./running.html">Installing and
Running</a>
+ </small></div>
+ <div><small> <a href="./buildfile.html">Project File</a>
+ </small></div>
+ <div><small> <a href="./properties.html">Properties</a>
+ </small></div>
+ <div><small> <a href="./vfs.html">Virtual File System</a>
+ </small></div>
+ <div><small> <a href="./ant1compat.html">Ant 1
Compatibility Layer</a>
+ </small></div>
+ <div><small> <a href="./differences.html">Differences to
Ant 1</a>
+ </small></div>
+ <div><small> <a href="./task.html">My First Task</a>
+ </small></div>
+ </div>
+ <div>
+ <strong>Extending Myrmidon</strong>
+ <div><small> <a href="./configuring.html">Configuration
HOWTO</a>
+ </small></div>
+ <div><small> <a href="./converter.html">Converter
HOWTO</a>
+ </small></div>
+ <div><small> <a href="./type.html">Type HOWTO</a>
+ </small></div>
+ <div><small> <a href="./classloader.html">ClassLoader
HOWTO</a>
+ </small></div>
+ <div><small> <a href="./librarys.html">Library HOWTO</a>
+ </small></div>
+ </div>
+ <div>
+ <strong>Developers Guide</strong>
+ <div><small> <a href="./subprojects.html">Sub Projects</a>
+ </small></div>
+ <div><small> <a href="./project-descriptor.html">The
Build System</a>
+ </small></div>
+ </div>
+ </div>
+ </td>
+ <td><div id="bodycol"><div class="app">
+ <div class="h3">
+ <h3><a name="Todo List">Todo List</a></h3>
+ <p>The broad goal is to grow Myrmidon from a prototype
task engine into a fully
fledged build system, that can serve as the basis for Ant 2.
The following
sections describe some of the many things which still need to be
done to
achieve that goal. This list is currently under
construction.</p>
- <table border="0" cellspacing="0"
cellpadding="2" width="100%">
- <tr><td bgcolor="#828DA6">
- <font color="#ffffff" face="arial,helvetica,sanserif">
- <a name="Integrate XDocs proposal"><strong>Integrate
XDocs proposal</strong></a>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <p>Integrate with the XDocs proposal that generates
XML documentation for
+ <div class="h4">
+ <h4><a name="Integrate XDocs proposal">Integrate XDocs
proposal</a></h4>
+ <p>Integrate with the XDocs proposal that generates XML
documentation for
tasks. Rework that proposal so that it knows about the
Myrmidon specific
patterns and features. Also rework it so that it can support
reading
documentation and examples from side-by-side the task.</p>
- </blockquote>
- </td></tr>
- </table>
- <table border="0" cellspacing="0"
cellpadding="2" width="100%">
- <tr><td bgcolor="#828DA6">
- <font color="#ffffff" face="arial,helvetica,sanserif">
- <a name="TaskInfo"><strong>TaskInfo</strong></a>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <p>Consider allowing task writers to write their own
TaskInfo objects
+ </div>
+ <div class="h4">
+ <h4><a name="TaskInfo">TaskInfo</a></h4>
+ <p>Consider allowing task writers to write their own
TaskInfo objects
(or at least have them generated from XDoclet directives).
This would
encompass both documentation and perhaps introspection of
the types.</p>
- </blockquote>
- </td></tr>
- </table>
- <table border="0" cellspacing="0"
cellpadding="2" width="100%">
- <tr><td bgcolor="#828DA6">
- <font color="#ffffff" face="arial,helvetica,sanserif">
- <a name="XML Catalog to load XML
Fragments"><strong>XML Catalog to load XML Fragments</strong></a>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <p>
+ </div>
+ <div class="h4">
+ <h4><a name="XML Catalog to load XML Fragments">XML Catalog to
load XML Fragments</a></h4>
+ <p>
When including fragments of XML we are currently forced to
use relative paths.
However this is sometimes undesirable when a single
fragment needs to be used
across several projects in several different locations.
Instead we could use
a Catalog to name the fragment and then each developer
would only need to install
the fragment once and it would be accessible from all the
projects.
</p>
- </blockquote>
- </td></tr>
- </table>
- <table border="0" cellspacing="0"
cellpadding="2" width="100%">
- <tr><td bgcolor="#828DA6">
- <font color="#ffffff" face="arial,helvetica,sanserif">
- <a name="Refactor Java Infrastructure into a
Service"><strong>Refactor Java Infrastructure into a Service</strong></a>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <p>Much like Exec should be decoupled from Ant
runtime, so should classes
+ </div>
+ <div class="h4">
+ <h4><a name="Refactor Java Infrastructure into a
Service">Refactor Java Infrastructure into a Service</a></h4>
+ <p>Much like Exec should be decoupled from Ant runtime, so
should classes
to implement java task for the same benefits.</p>
- </blockquote>
- </td></tr>
- </table>
- <table border="0" cellspacing="0"
cellpadding="2" width="100%">
- <tr><td bgcolor="#828DA6">
- <font color="#ffffff" face="arial,helvetica,sanserif">
- <a name="Structural Dependency
Utils"><strong>Structural Dependency Utils</strong></a>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <p>
+ </div>
+ <div class="h4">
+ <h4><a name="Structural Dependency Utils">Structural Dependency
Utils</a></h4>
+ <p>
In the present ant, it is required that each task manage
dependency separately.
This makes it a lot of work to implement even simple
dependency checking. To this
day many of the core tasks do not implement it correctly.
I am specifically
talking about "structural" dependency information. The
main reason is that it is
painful to implement.
</p>
- <p>
+ <p>
Some tasks do no dependency checking and will
recompile/transform/etc everytime.
Others may perform a simple dependency checking (ie if
source file is newer than
destination file then recompile). Ideally a dependency
system would actually
@@ -180,31 +144,15 @@
we need to allow tasks to implement this behaviour.
Possibly by supplying an interface
of the form;
</p>
- <div align="left">
- <table cellspacing="4" cellpadding="0" border="0">
- <tr>
- <td bgcolor="#023264" width="1" height="1"><img
src="/images/void.gif" width="1" height="1" vspace="0" hspace="0"
border="0"/></td>
- <td bgcolor="#023264" height="1"><img src="/images/void.gif"
width="1" height="1" vspace="0" hspace="0" border="0"/></td>
- <td bgcolor="#023264" width="1" height="1"><img
src="/images/void.gif" width="1" height="1" vspace="0" hspace="0"
border="0"/></td>
- </tr>
- <tr>
- <td bgcolor="#023264" width="1"><img src="/images/void.gif"
width="1" height="1" vspace="0" hspace="0" border="0"/></td>
- <td bgcolor="#ffffff"><pre>
+ <div id="source">
+ <pre>
public interface DependencyGenerator
{
File[] generateDependencies( File file );
}
-</pre></td>
- <td bgcolor="#023264" width="1"><img src="/images/void.gif"
width="1" height="1" vspace="0" hspace="0" border="0"/></td>
- </tr>
- <tr>
- <td bgcolor="#023264" width="1" height="1"><img
src="/images/void.gif" width="1" height="1" vspace="0" hspace="0"
border="0"/></td>
- <td bgcolor="#023264" height="1"><img src="/images/void.gif"
width="1" height="1" vspace="0" hspace="0" border="0"/></td>
- <td bgcolor="#023264" width="1" height="1"><img
src="/images/void.gif" width="1" height="1" vspace="0" hspace="0"
border="0"/></td>
- </tr>
- </table>
+</pre>
</div>
- <p>
+ <p>
Generating the dependency information is a costly
operation and thus we do not want to
be doing it everytime you run ant. We want to generate it
on the initial build and then
persist somewhere. Everytime a file is out of date, it's
dependency information would
@@ -214,76 +162,36 @@
as being compiled with -O2 flag. If any of the
dependencies have changed or are out of date
then foo.c would need to be recompiled.
</p>
- <p>
+ <p>
A possible API would be
</p>
- <div align="left">
- <table cellspacing="4" cellpadding="0" border="0">
- <tr>
- <td bgcolor="#023264" width="1" height="1"><img
src="/images/void.gif" width="1" height="1" vspace="0" hspace="0"
border="0"/></td>
- <td bgcolor="#023264" height="1"><img src="/images/void.gif"
width="1" height="1" vspace="0" hspace="0" border="0"/></td>
- <td bgcolor="#023264" width="1" height="1"><img
src="/images/void.gif" width="1" height="1" vspace="0" hspace="0"
border="0"/></td>
- </tr>
- <tr>
- <td bgcolor="#023264" width="1"><img src="/images/void.gif"
width="1" height="1" vspace="0" hspace="0" border="0"/></td>
- <td bgcolor="#ffffff"><pre>
+ <div id="source">
+ <pre>
DependencyManager dm = ...;
dm.setFileSet( myFileSet );
dm.setDependencyCache( myDependencyCacheFile );
File[] files = cm.getOutOfDate();
-</pre></td>
- <td bgcolor="#023264" width="1"><img src="/images/void.gif"
width="1" height="1" vspace="0" hspace="0" border="0"/></td>
- </tr>
- <tr>
- <td bgcolor="#023264" width="1" height="1"><img
src="/images/void.gif" width="1" height="1" vspace="0" hspace="0"
border="0"/></td>
- <td bgcolor="#023264" height="1"><img src="/images/void.gif"
width="1" height="1" vspace="0" hspace="0" border="0"/></td>
- <td bgcolor="#023264" width="1" height="1"><img
src="/images/void.gif" width="1" height="1" vspace="0" hspace="0"
border="0"/></td>
- </tr>
- </table>
+</pre>
</div>
- </blockquote>
- </td></tr>
- </table>
- <table border="0" cellspacing="0"
cellpadding="2" width="100%">
- <tr><td bgcolor="#828DA6">
- <font color="#ffffff" face="arial,helvetica,sanserif">
- <a name="Antlibs storing templates"><strong>Antlibs
storing templates</strong></a>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <p>After a templating system is formalized it would
useful to define
+ </div>
+ <div class="h4">
+ <h4><a name="Antlibs storing templates">Antlibs storing
templates</a></h4>
+ <p>After a templating system is formalized it would useful
to define
a mechanism via which you can store templates in an antlib.
These
templates could then be loaded and used by build files
through a
"standard" mechanism. This may need to be merged with the
XML catalog
system.</p>
- </blockquote>
- </td></tr>
- </table>
- <table border="0" cellspacing="0"
cellpadding="2" width="100%">
- <tr><td bgcolor="#828DA6">
- <font color="#ffffff" face="arial,helvetica,sanserif">
- <a name="Antlibs Storing General
Resources"><strong>Antlibs Storing General Resources</strong></a>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <p>Add a system via which ant libs can store general
resources for
+ </div>
+ <div class="h4">
+ <h4><a name="Antlibs Storing General Resources">Antlibs Storing
General Resources</a></h4>
+ <p>Add a system via which ant libs can store general
resources for
consumption by build users. This could be used to store the
XML fragments
for the XML catalog, the template fragments for templates,
images for
documentation system and so forth.</p>
- </blockquote>
- </td></tr>
- </table>
- <table border="0" cellspacing="0"
cellpadding="2" width="100%">
- <tr><td bgcolor="#828DA6">
- <font color="#ffffff" face="arial,helvetica,sanserif">
- <a name="Coloring API"><strong>Coloring
API</strong></a>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <p>
+ </div>
+ <div class="h4">
+ <h4><a name="Coloring API">Coloring API</a></h4>
+ <p>
When you execute a task such as "javac" there is two types
of dependency information
that is important to analyze before we determine if we
need to recompile a file. Say
we are compiling <code>Foo.java</code>, it may depend on
the <code>Bar.java</code>
@@ -294,94 +202,54 @@
<code>debug="false"</code> then it is out of date and
needs to be recompiled. We call this
"environmental" dependency information "coloring".
</p>
- <p>
+ <p>
So we need to create an infrastructure that allows tasks
to manage "coloring". So a task
should be able to add coloring information for each
resource processed. When the task
comes to process the resource again it will detect if the
coloring has changed and if it
has will force a recompile.
</p>
- <p>
+ <p>
An API for such a bean has yet to be established but an
example API would be.
</p>
- <div align="left">
- <table cellspacing="4" cellpadding="0" border="0">
- <tr>
- <td bgcolor="#023264" width="1" height="1"><img
src="/images/void.gif" width="1" height="1" vspace="0" hspace="0"
border="0"/></td>
- <td bgcolor="#023264" height="1"><img src="/images/void.gif"
width="1" height="1" vspace="0" hspace="0" border="0"/></td>
- <td bgcolor="#023264" width="1" height="1"><img
src="/images/void.gif" width="1" height="1" vspace="0" hspace="0"
border="0"/></td>
- </tr>
- <tr>
- <td bgcolor="#023264" width="1"><img src="/images/void.gif"
width="1" height="1" vspace="0" hspace="0" border="0"/></td>
- <td bgcolor="#ffffff"><pre>
+ <div id="source">
+ <pre>
ColoringManager cm = ...;
cm.addColor( "debug", "true" );
cm.addColor( "optimize", "false" );
cm.setFileSet( myFileSet );
File[] files = cm.getOutOfDate();
-</pre></td>
- <td bgcolor="#023264" width="1"><img src="/images/void.gif"
width="1" height="1" vspace="0" hspace="0" border="0"/></td>
- </tr>
- <tr>
- <td bgcolor="#023264" width="1" height="1"><img
src="/images/void.gif" width="1" height="1" vspace="0" hspace="0"
border="0"/></td>
- <td bgcolor="#023264" height="1"><img src="/images/void.gif"
width="1" height="1" vspace="0" hspace="0" border="0"/></td>
- <td bgcolor="#023264" width="1" height="1"><img
src="/images/void.gif" width="1" height="1" vspace="0" hspace="0"
border="0"/></td>
- </tr>
- </table>
+</pre>
</div>
- </blockquote>
- </td></tr>
- </table>
- <table border="0" cellspacing="0"
cellpadding="2" width="100%">
- <tr><td bgcolor="#828DA6">
- <font color="#ffffff" face="arial,helvetica,sanserif">
- <a name="Create Task/Element/Attribute Naming
guidelines"><strong>Create Task/Element/Attribute Naming guidelines</strong></a>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <p> Currently Ant has a mixture of tasks from
various stages it's evolution, with different
+ </div>
+ <div class="h4">
+ <h4><a name="Create Task/Element/Attribute Naming
guidelines">Create Task/Element/Attribute Naming guidelines</a></h4>
+ <p> Currently Ant has a mixture of tasks from various
stages it's evolution, with different
authors and each utilizing different naming patterns. Some
tasks use names such as
"src" and "dest" while others use "file" and "tofile". It
would be preferrable if
consistent naming patterns were used. It is recomended that
we come up with a "best
practices" document to document our recomended naming
patterns.</p>
- <p>Before we can come up with such a
document we need to identify common patterns through
+ <p>Before we can come up with such a document we
need to identify common patterns through
out the tasks. Several tasks have the notion of transforming
input from a "source"
to a "destination". So we should have consistent naming
schemes for these attributes and
elements. Analysis of existing tasks will likely bring out
other similar patterns. Once
we have identified and documented these similarities then we
can establish conventions.</p>
- </blockquote>
- </td></tr>
- </table>
- <table border="0" cellspacing="0"
cellpadding="2" width="100%">
- <tr><td bgcolor="#828DA6">
- <font color="#ffffff" face="arial,helvetica,sanserif">
- <a name="Rethink Notification/Event
scheme"><strong>Rethink Notification/Event scheme</strong></a>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <p>We need to rethink the whole notificaiton scheme.
Should tasks be able to
+ </div>
+ <div class="h4">
+ <h4><a name="Rethink Notification/Event scheme">Rethink
Notification/Event scheme</a></h4>
+ <p>We need to rethink the whole notificaiton scheme.
Should tasks be able to
raise events? Probably as long as we have
<em>ContainerTasks</em>. Should tasks
be able to query state of run? ie Can a task request "are we
paused?" or "are we
stopped?" ? Probably as that way long running tasks are
given the opportunity
to be gracefully halted by the end users (primarily aimed at
IDE vendors here).</p>
- <ul>
+ <ul>
<li>Add verbosity level to TaskEvent.</li>
<li>Fire taskFinished() events on task failure.</li>
<li>Get target finished and project finished events
working.</li>
</ul>
- </blockquote>
- </td></tr>
- </table>
- <table border="0" cellspacing="0"
cellpadding="2" width="100%">
- <tr><td bgcolor="#828DA6">
- <font color="#ffffff" face="arial,helvetica,sanserif">
- <a name="XPath-like Locators for
tasks"><strong>XPath-like Locators for tasks</strong></a>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <p>Most tasks are grouped into some sort of task
container. The task containers
+ </div>
+ <div class="h4">
+ <h4><a name="XPath-like Locators for tasks">XPath-like Locators
for tasks</a></h4>
+ <p>Most tasks are grouped into some sort of task
container. The task containers
can be things like workspaces, projects, targets or other
tasks. Each of these
containers usually has a name. Thus we could refer to tasks
via a path such as
"/avalon/compile/javac" would refer to the task "javac" in
the target "compile"
@@ -389,91 +257,43 @@
to this path programatically - other people have also asked
for access to things
like the currently running target. We need to assess this
and decide whether we
wish to support it.</p>
- <p>Another point to think about is that we
could use XPath-like string to designate
+ <p>Another point to think about is that we could use
XPath-like string to designate
to other tasks to execute. ie antcall would refer to a path
rather than a target name</p>
- </blockquote>
- </td></tr>
- </table>
- <table border="0" cellspacing="0"
cellpadding="2" width="100%">
- <tr><td bgcolor="#828DA6">
- <font color="#ffffff" face="arial,helvetica,sanserif">
- <a name="Embeddor HOWTO"><strong>Embeddor
HOWTO</strong></a>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <p>Assigned To: Peter</p>
- <p>Write a HOWTO describing how to embed
Myrmidon into other
+ </div>
+ <div class="h4">
+ <h4><a name="Embeddor HOWTO">Embeddor HOWTO</a></h4>
+ <p>Assigned To: Peter</p>
+ <p>Write a HOWTO describing how to embed Myrmidon
into other
applications.</p>
- </blockquote>
- </td></tr>
- </table>
- <table border="0" cellspacing="0"
cellpadding="2" width="100%">
- <tr><td bgcolor="#828DA6">
- <font color="#ffffff" face="arial,helvetica,sanserif">
- <a name="Optional Dependencies"><strong>Optional
Dependencies</strong></a>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <p>Assigned To: Peter</p>
- <p>Extend Myrmidons library management
facilities so that optional
+ </div>
+ <div class="h4">
+ <h4><a name="Optional Dependencies">Optional
Dependencies</a></h4>
+ <p>Assigned To: Peter</p>
+ <p>Extend Myrmidons library management facilities so
that optional
dependencies may be declared for a library. ie The library
will still
operate in absence of such libraries but can provide further
features
if these libraries are present. Most likely this will be
done via a
new manifest entry "Optional-Extension-List:" that behaves
similar
to "Extension-List:" except that the extensions are
optional.</p>
- </blockquote>
- </td></tr>
- </table>
- <table border="0" cellspacing="0"
cellpadding="2" width="100%">
- <tr><td bgcolor="#828DA6">
- <font color="#ffffff" face="arial,helvetica,sanserif">
- <a name="Facade task HOWTO"><strong>Facade task
HOWTO</strong></a>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <p>Currently we have a few tasks that have multiple
implementations. For instance
+ </div>
+ <div class="h4">
+ <h4><a name="Facade task HOWTO">Facade task HOWTO</a></h4>
+ <p>Currently we have a few tasks that have multiple
implementations. For instance
Javac task can actually call jikes, jvc, classic javac or
modern javac. Similar things
will be seen with the jspc task and the cc task (if it ever
gets written). We have a base
class that is meant to facilitate this sort of task and make
it easy to develope. See
AbstractFacadeTask. However we need to write up a HOWTO so
people can use it.</p>
- </blockquote>
- </td></tr>
- </table>
- <table border="0" cellspacing="0"
cellpadding="2" width="100%">
- <tr><td bgcolor="#828DA6">
- <font color="#ffffff" face="arial,helvetica,sanserif">
- <a name="Mail tasks"><strong>Mail tasks</strong></a>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <p>Convert the Ant 1.x Mail tasks to Myrmidon.</p>
- </blockquote>
- </td></tr>
- </table>
- <table border="0" cellspacing="0"
cellpadding="2" width="100%">
- <tr><td bgcolor="#828DA6">
- <font color="#ffffff" face="arial,helvetica,sanserif">
- <a name="Security Manager"><strong>Security
Manager</strong></a>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <p>Add the ability to run java programs that call
System.exit() by adding a
+ </div>
+ <div class="h4">
+ <h4><a name="Mail tasks">Mail tasks</a></h4>
+ <p>Convert the Ant 1.x Mail tasks to Myrmidon.</p>
+ </div>
+ <div class="h4">
+ <h4><a name="Security Manager">Security Manager</a></h4>
+ <p>Add the ability to run java programs that call
System.exit() by adding a
security manager. Should look something like:</p>
- <div align="left">
- <table cellspacing="4" cellpadding="0" border="0">
- <tr>
- <td bgcolor="#023264" width="1" height="1"><img
src="/images/void.gif" width="1" height="1" vspace="0" hspace="0"
border="0"/></td>
- <td bgcolor="#023264" height="1"><img src="/images/void.gif"
width="1" height="1" vspace="0" hspace="0" border="0"/></td>
- <td bgcolor="#023264" width="1" height="1"><img
src="/images/void.gif" width="1" height="1" vspace="0" hspace="0"
border="0"/></td>
- </tr>
- <tr>
- <td bgcolor="#023264" width="1"><img src="/images/void.gif"
width="1" height="1" vspace="0" hspace="0" border="0"/></td>
- <td bgcolor="#ffffff"><pre>
+ <div id="source">
+ <pre>
public class MyrmidonSecurityManager
extends SecurityManager
{
@@ -486,70 +306,38 @@
{
}
}
- </pre></td>
- <td bgcolor="#023264" width="1"><img src="/images/void.gif"
width="1" height="1" vspace="0" hspace="0" border="0"/></td>
- </tr>
- <tr>
- <td bgcolor="#023264" width="1" height="1"><img
src="/images/void.gif" width="1" height="1" vspace="0" hspace="0"
border="0"/></td>
- <td bgcolor="#023264" height="1"><img src="/images/void.gif"
width="1" height="1" vspace="0" hspace="0" border="0"/></td>
- <td bgcolor="#023264" width="1" height="1"><img
src="/images/void.gif" width="1" height="1" vspace="0" hspace="0"
border="0"/></td>
- </tr>
- </table>
+ </pre>
</div>
- </blockquote>
- </td></tr>
- </table>
- <table border="0" cellspacing="0"
cellpadding="2" width="100%">
- <tr><td bgcolor="#828DA6">
- <font color="#ffffff" face="arial,helvetica,sanserif">
- <a name="Self Hosting"><strong>Self
Hosting</strong></a>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <p>Myrmidon must be able to build itself.
Currently, it is built using
+ </div>
+ <div class="h4">
+ <h4><a name="Self Hosting">Self Hosting</a></h4>
+ <p>Myrmidon must be able to build itself. Currently, it
is built using
Ant 1.x. Ultimately, Myrmidon should be able to build
itself from exactly the
same build file. To start with, however, there is no need
for Myrmidon to be
able to do this. Myrmidon should also be able to be
bootstrapped (that is, be
able to be built from scratch, without using Ant 1.x at
all).</p>
- </blockquote>
- </td></tr>
- </table>
- <table border="0" cellspacing="0"
cellpadding="2" width="100%">
- <tr><td bgcolor="#828DA6">
- <font color="#ffffff" face="arial,helvetica,sanserif">
- <a name="Validation Pass"><strong>Validation
Pass</strong></a>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <p>Consider calling validate() on task prior to
execute(). This would allow
+ </div>
+ <div class="h4">
+ <h4><a name="Validation Pass">Validation Pass</a></h4>
+ <p>Consider calling validate() on task prior to execute().
This would allow
us to have a "make -k" mode that actually did basic
validation and would also
encourage task writers to do validation properly.</p>
- </blockquote>
- </td></tr>
- </table>
- <table border="0" cellspacing="0"
cellpadding="2" width="100%">
- <tr><td bgcolor="#828DA6">
- <font color="#ffffff" face="arial,helvetica,sanserif">
- <a name="Paths"><strong>Paths</strong></a>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <p>Consider allowing the user to configure the ant
system by setting the
+ </div>
+ <div class="h4">
+ <h4><a name="Paths">Paths</a></h4>
+ <p>Consider allowing the user to configure the ant system
by setting the
following path types.</p>
- <ul>
+ <ul>
<li>ant.type.path: path that is used to search for the
type libraries</li>
<li>ant.ext.path: path that is used to search for
"Optional Packages"
or extensions.</li>
</ul>
- <p>
+ <p>
The default search path will probably include a per-user
path element,
a workspace path element and a system path elemtn that are
searched in
that order. Some possible defaults;
</p>
- <ul>
+ <ul>
<li>Unix Per-user: ${user.home}/.ant/lib,
${user.home}/.ant/ext</li>
<li>Windows Per-user: ${user.home}/ant/lib,
${user.home}/ant/ext</li>
<li>MacOSX Per-user: ${user.home}/Library/Ant/lib,
@@ -560,20 +348,12 @@
%SYS_DRIVE%/Program Files/ant/ext</li>
<li>MacOSX System-wide: /Library/Ant/lib,
/Library/Ant/ant/ext</li>
</ul>
- </blockquote>
- </td></tr>
- </table>
- <table border="0" cellspacing="0"
cellpadding="2" width="100%">
- <tr><td bgcolor="#828DA6">
- <font color="#ffffff" face="arial,helvetica,sanserif">
- <a name="Ant 1.x Compatibility"><strong>Ant 1.x
Compatibility</strong></a>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <p>The Ant 1 Compatibility layer is still in early
stages of development.
+ </div>
+ <div class="h4">
+ <h4><a name="Ant 1.x Compatibility">Ant 1.x
Compatibility</a></h4>
+ <p>The Ant 1 Compatibility layer is still in early stages
of development.
</p>
- <ul>
+ <ul>
<li>Update ant.jar and optional.jar to ant1.5 beta.</li>
<li>Get a version of <code><antcall></code>
working.</li>
<li>
@@ -595,19 +375,11 @@
Ant 1 Project, to minimise the amount of code
duplication in
Ant1CompatProject.</li>
</ul>
- </blockquote>
- </td></tr>
- </table>
- <table border="0" cellspacing="0"
cellpadding="2" width="100%">
- <tr><td bgcolor="#828DA6">
- <font color="#ffffff" face="arial,helvetica,sanserif">
- <a name="Virtual File System"><strong>Virtual File
System</strong></a>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <p>The VFS needs plenty of work:</p>
- <ul>
+ </div>
+ <div class="h4">
+ <h4><a name="Virtual File System">Virtual File System</a></h4>
+ <p>The VFS needs plenty of work:</p>
+ <ul>
<li>Move files/folders.</li>
<li>Recursive folders copy.</li>
<li>Search through a file hierarchy, using Ant-style
wildcards.</li>
@@ -630,24 +402,16 @@
systems).
</li>
</ul>
- </blockquote>
- </td></tr>
- </table>
- <table border="0" cellspacing="0"
cellpadding="2" width="100%">
- <tr><td bgcolor="#828DA6">
- <font color="#ffffff" face="arial,helvetica,sanserif">
- <a name="File Data-Types and Tasks"><strong>File
Data-Types and Tasks</strong></a>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <p>The file data-types, such as
+ </div>
+ <div class="h4">
+ <h4><a name="File Data-Types and Tasks">File Data-Types and
Tasks</a></h4>
+ <p>The file data-types, such as
<code><fileset></code> and
<code><path></code>, are some of the most widely
used parts of Ant 1.x.
Unfortunately, they aren't particularly extensible.
</p>
- <ul>
+ <ul>
<li>Redesign the file data-types, replacing them with an
interface-based
API, plus a set of implementations. The API should use
the VFS file
@@ -732,22 +496,14 @@
'touch' and 'mkdir' into a single task.
</li>
</ul>
- </blockquote>
- </td></tr>
- </table>
- <table border="0" cellspacing="0"
cellpadding="2" width="100%">
- <tr><td bgcolor="#828DA6">
- <font color="#ffffff" face="arial,helvetica,sanserif">
- <a name="Command-line and Configuration
Files"><strong>Command-line and Configuration Files</strong></a>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <p>One of the goals of Ant 2 is to allow the user to
easily customise and
+ </div>
+ <div class="h4">
+ <h4><a name="Command-line and Configuration Files">Command-line
and Configuration Files</a></h4>
+ <p>One of the goals of Ant 2 is to allow the user to
easily customise and
extend Ant. The command-line and local configuration files,
are two places
where this would be done. Currently, Myrmidon some
customisation from the
command-line, but does not support configuration files.</p>
- <ul>
+ <ul>
<li>Load configuration from system (from $ANT_HOME) and
user (from $HOME)
configuration files.</li>
@@ -768,20 +524,12 @@
</li>
</ul>
- </blockquote>
- </td></tr>
- </table>
- <table border="0" cellspacing="0"
cellpadding="2" width="100%">
- <tr><td bgcolor="#828DA6">
- <font color="#ffffff" face="arial,helvetica,sanserif">
- <a name="Scripting"><strong>Scripting</strong></a>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <p>Add the ability to extend Ant using languages
other than
+ </div>
+ <div class="h4">
+ <h4><a name="Scripting">Scripting</a></h4>
+ <p>Add the ability to extend Ant using languages other than
Java:</p>
- <ul>
+ <ul>
<li>Define a task using a scripting language such as
Javascript.</li>
<li>Use Rhino's ability to implement Java interfaces, to
implement and define types, such as FileSelector, or
@@ -789,22 +537,14 @@
<li>Define a task using template.</li>
<li>Add some lightweight scripting tasks.</li>
</ul>
- </blockquote>
- </td></tr>
- </table>
- <table border="0" cellspacing="0"
cellpadding="2" width="100%">
- <tr><td bgcolor="#828DA6">
- <font color="#ffffff" face="arial,helvetica,sanserif">
- <a
name="Documentation"><strong>Documentation</strong></a>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <p>Everyone loves writing documentation, and so a
goal for Ant 2 is to
+ </div>
+ <div class="h4">
+ <h4><a name="Documentation">Documentation</a></h4>
+ <p>Everyone loves writing documentation, and so a goal for
Ant 2 is to
generate a lot of reference documentation for tasks and
other types directly
from the source. Unfortunately, there's still plenty of
tutorial material
to write. In particular we need these:</p>
- <ul>
+ <ul>
<li>User documentation - describing things like the
build file format,
how properties work, how to use references, how
sub-builds work, how to customise
Myrmidon, and so on.</li>
@@ -818,19 +558,11 @@
of filling out.</li>
</ul>
- </blockquote>
- </td></tr>
- </table>
- <table border="0" cellspacing="0"
cellpadding="2" width="100%">
- <tr><td bgcolor="#828DA6">
- <font color="#ffffff" face="arial,helvetica,sanserif">
- <a
name="Miscellaneous"><strong>Miscellaneous</strong></a>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <p>A completely unordered list of items, big and
small:</p>
- <ul>
+ </div>
+ <div class="h4">
+ <h4><a name="Miscellaneous">Miscellaneous</a></h4>
+ <p>A completely unordered list of items, big and small:</p>
+ <ul>
<li>Search through the code for 'TODO' items and fix
them.</li>
<li>Detect duplicate type names.</li>
<li>Validate type and role names.</li>
@@ -875,25 +607,21 @@
TypeManager.createChildTypeManager(),
Deployer.createChildDeployer, etc.</li>
<li>Configurer needs to be scoped. RoleManager probably
does too.</li>
</ul>
- </blockquote>
- </td></tr>
- </table>
- </blockquote>
- </td></tr>
- </table>
- </td>
+ </div>
+ </div>
+ </div></div></td>
</tr>
-
- <!-- FOOTER -->
- <tr><td colspan="2">
- <hr noshade="" size="1"/>
- </td></tr>
- <tr><td colspan="2">
- <div align="center"><font color="#525D76" size="-1"><em>
- Copyright © 2000-2002, Apache Software Foundation
- </em></font></div>
- </td></tr>
</table>
+
+ <!-- FOOTER -->
+ <div id="footer">
+ <table border="0" cellspacing="0" cellpadding="4">
+ <tr>
+ <td>Copyright © 2000-2002, Apache Software Foundation</td>
+ </tr>
+ </table>
+ </div>
+
</body>
</html>
<!-- end the processing -->
1.6 +228 -326 jakarta-ant-myrmidon/site/docs/vfs.html
Index: vfs.html
===================================================================
RCS file: /home/cvs/jakarta-ant-myrmidon/site/docs/vfs.html,v
retrieving revision 1.5
retrieving revision 1.6
diff -u -r1.5 -r1.6
--- vfs.html 19 May 2002 13:37:50 -0000 1.5
+++ vfs.html 6 Jun 2002 12:54:29 -0000 1.6
@@ -6,129 +6,120 @@
<!-- start the processing -->
<html>
<head>
+ <style type="text/css">
+ @import url("./css/tigris.css");
+ @import url("./css/site.css");
+ </style>
<meta http-equiv="Content-Type" content="text/html;
charset=iso-8859-1"/>
-
+
<meta name="author" value="Adam Murdoch">
<meta name="email" value="[EMAIL PROTECTED]">
-
+
<title>Apache Myrmidon - VFS User Guide</title>
</head>
-
- <body bgcolor="#ffffff" text="#000000" link="#525D76">
- <table border="0" width="100%" cellspacing="0">
- <!-- TOP IMAGE -->
- <tr>
- <td> <td colspan="2">
+
+ <body marginwidth="0" marginheight="0" class="composite">
+
+ <div id="banner">
+ <table border="0" cellspacing="0" cellpadding="8" width="100%">
+ <!-- TOP IMAGE -->
+ <tr>
+ <td> <td colspan="2">
<a href="http://jakarta.apache.org"><img
src="http://jakarta.apache.org/images/jakarta-logo.gif" align="left"
border="0"/></a>
</td>
</td>
- <td valign="bottom"><div align="right"><b><font size="+3"
color="#525D76">Apache Myrmidon</font></b></div></td>
- </tr>
- </table>
- <table border="0" width="100%" cellspacing="4">
- <tr><td colspan="2">
- <hr noshade="" size="1"/>
- </td></tr>
-
- <tr>
+ <td><div align="right" valign="bottom"><b><font size="+3">Apache
Myrmidon</font></b></div></td>
+ </tr>
+ </table>
+ </div>
+
+ <table border="0" cellspacing="0" cellpadding="8" width="100%"
id="main">
+ <tr valign="top">
<!-- LEFT SIDE NAVIGATION -->
- <td valign="top" nowrap="true">
- <p><strong>Myrmidon</strong></p>
- <ul>
- <li> <a href="./index.html">Introduction</a>
- </li>
- <li> <a href="./getinvolved.html">Get Involved</a>
- </li>
- <li> <a href="./building.html">Building Myrmidon</a>
- </li>
- <li> <a href="./todo.html">Todo List</a>
- </li>
- </ul>
- <p><strong>User Guide</strong></p>
- <ul>
- <li> <a href="./running.html">Installing and Running</a>
- </li>
- <li> <a href="./buildfile.html">Project File</a>
- </li>
- <li> <a href="./vfs.html">Virtual File System</a>
- </li>
- <li> <a href="./ant1compat.html">Ant 1 Compatibility Layer</a>
- </li>
- <li> <a href="./differences.html">Differences to Ant 1</a>
- </li>
- <li> <a href="./task.html">My First Task</a>
- </li>
- </ul>
- <p><strong>Extending Myrmidon</strong></p>
- <ul>
- <li> <a href="./configuring.html">Configuration HOWTO</a>
- </li>
- <li> <a href="./converter.html">Converter HOWTO</a>
- </li>
- <li> <a href="./type.html">Type HOWTO</a>
- </li>
- <li> <a href="./classloader.html">ClassLoader HOWTO</a>
- </li>
- <li> <a href="./librarys.html">Library HOWTO</a>
- </li>
- </ul>
- <p><strong>Developers Guide</strong></p>
- <ul>
- <li> <a href="./subprojects.html">Sub Projects</a>
- </li>
- <li> <a href="./project-descriptor.html">The Build System</a>
- </li>
- </ul>
- </td>
- <td align="left" valign="top">
- <table border="0" cellspacing="0" cellpadding="2" width="100%">
- <tr><td bgcolor="#525D76">
- <font color="#ffffff" face="arial,helvetica,sanserif">
- <a name="Handling Files"><strong>Handling
Files</strong></a>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <p>Myrmidon includes a Virtual File System (VFS),
which allows files from
+ <td id="leftcol" width="20%">
+ <div id="navcolumn">
+ <div>
+ <strong>Myrmidon</strong>
+ <div><small> <a href="./index.html">Introduction</a>
+ </small></div>
+ <div><small> <a href="./getinvolved.html">Get Involved</a>
+ </small></div>
+ <div><small> <a href="./building.html">Building
Myrmidon</a>
+ </small></div>
+ <div><small> <a href="./todo.html">Todo List</a>
+ </small></div>
+ </div>
+ <div>
+ <strong>User Guide</strong>
+ <div><small> <a href="./running.html">Installing and
Running</a>
+ </small></div>
+ <div><small> <a href="./buildfile.html">Project File</a>
+ </small></div>
+ <div><small> <a href="./properties.html">Properties</a>
+ </small></div>
+ <div><small> <a href="./vfs.html">Virtual File System</a>
+ </small></div>
+ <div><small> <a href="./ant1compat.html">Ant 1
Compatibility Layer</a>
+ </small></div>
+ <div><small> <a href="./differences.html">Differences to
Ant 1</a>
+ </small></div>
+ <div><small> <a href="./task.html">My First Task</a>
+ </small></div>
+ </div>
+ <div>
+ <strong>Extending Myrmidon</strong>
+ <div><small> <a href="./configuring.html">Configuration
HOWTO</a>
+ </small></div>
+ <div><small> <a href="./converter.html">Converter
HOWTO</a>
+ </small></div>
+ <div><small> <a href="./type.html">Type HOWTO</a>
+ </small></div>
+ <div><small> <a href="./classloader.html">ClassLoader
HOWTO</a>
+ </small></div>
+ <div><small> <a href="./librarys.html">Library HOWTO</a>
+ </small></div>
+ </div>
+ <div>
+ <strong>Developers Guide</strong>
+ <div><small> <a href="./subprojects.html">Sub Projects</a>
+ </small></div>
+ <div><small> <a href="./project-descriptor.html">The
Build System</a>
+ </small></div>
+ </div>
+ </div>
+ </td>
+ <td><div id="bodycol"><div class="app">
+ <div class="h3">
+ <h3><a name="Handling Files">Handling Files</a></h3>
+ <p>Myrmidon includes a Virtual File System (VFS), which
allows files from
different sources to be treated identically. The VFS currently
supports
the following file types:</p>
- <table>
- <tr>
- <td bgcolor="#039acc" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ <table cellpadding="3" cellspacing="2" border="1"
width="100%">
+ <tr class="a">
+ <th
+ >
File System
- </font>
- </td>
- <td bgcolor="#039acc" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </th>
+ <th
+ >
Description
- </font>
- </td>
- <td bgcolor="#039acc" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </th>
+ <th
+ >
URL Format
- </font>
- </td>
- </tr>
- <tr>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </th>
+ </tr>
+ <tr class="b">
+ <td
+ >
Local Files
- </font>
- </td>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </td>
+ <td
+ >
Files on the local file system.
- </font>
- </td>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </td>
+ <td
+ >
Three different formats are currently supported for local file
names:
<ul>
<li><code>file://</code>
<i>absolute-file-name</i></li>
@@ -138,75 +129,56 @@
</li>
</ul>
- </font>
- </td>
- </tr>
- <tr>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </td>
+ </tr>
+ <tr class="a">
+ <td
+ >
Zip Files
- </font>
- </td>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </td>
+ <td
+ >
The contents of Zip files (and Jar, War, and Ear files).
Currently, the VFS supports read-only access to Zip file
contents.
- </font>
- </td>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </td>
+ <td
+ >
<code>zip:</code> <i>zip-file-uri</i>
[<code>!</code><i>absolute-path</i>]
- </font>
- </td>
- </tr>
- <tr>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </td>
+ </tr>
+ <tr class="b">
+ <td
+ >
FTP
- </font>
- </td>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </td>
+ <td
+ >
Files on an FTP server.
- </font>
- </td>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </td>
+ <td
+ >
<code>ftp://</code> [[<i>password</i><code>:</code>]
<i>username</i><code>@</code>] <i>hostname</i> [<code>:</code><i>port</i>]
[<i>absolute-path</i>]
- </font>
- </td>
- </tr>
- <tr>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </td>
+ </tr>
+ <tr class="a">
+ <td
+ >
SMB
- </font>
- </td>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </td>
+ <td
+ >
Files on a CFIS server, such as Samba or Windows shares.
- </font>
- </td>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </td>
+ <td
+ >
<code>smb://</code> [[<i>password</i><code>:</code>]
<i>username</i><code>@</code>] <i>hostname</i> [<code>:</code><i>port</i>]
[<i>absolute-path</i>]
- </font>
- </td>
- </tr>
+ </td>
+ </tr>
</table>
- <p>Both forward or backward slashes can be
used to separate the elements of
+ <p>Both forward or backward slashes can be used to
separate the elements of
a URL.</p>
- <p>Here are some example URLs:</p>
- <ul>
+ <p>Here are some example URLs:</p>
+ <ul>
<li><code>build/classes</code></li>
<li><code>c:\program files\ant\bin</code></li>
<li><code>file://C:/program files/ant</code></li>
@@ -214,123 +186,81 @@
<li><code>ftp://[EMAIL PROTECTED]/pub/downloads</code></li>
<li><code>smb://password:[EMAIL
PROTECTED]/home/adam</code></li>
</ul>
- <p>Currently, there are only a handful of
VFS aware tasks. This will grow
+ <p>Currently, there are only a handful of VFS aware
tasks. This will grow
as more tasks are ported to the new API, and data types.</p>
- <table border="0" cellspacing="0"
cellpadding="2" width="100%">
- <tr><td bgcolor="#828DA6">
- <font color="#ffffff" face="arial,helvetica,sanserif">
- <a name="File Sets"><strong>File Sets</strong></a>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <p>A file set in Myrmidon is more general than Ant
1's concept of a file set.
+ <div class="h4">
+ <h4><a name="File Sets">File Sets</a></h4>
+ <p>A file set in Myrmidon is more general than Ant 1's
concept of a file set.
Firstly, there is more than one type of file set. Secondly,
they are VFS enabled.
File sets are automatically converted to a <a
href="#Paths">path</a>, and so
can be used anywhere that a path can.</p>
- <h3><code><v-fileset></code></h3>
- <p>This is the equivalent of Ant 1's
<code><fileset></code> (The name
+ <h3><code><v-fileset></code></h3>
+ <p>This is the equivalent of Ant 1's
<code><fileset></code> (The name
is temporary, it will be changed to
<code><fileset></code> once more
porting work as been completed).</p>
- <p>Rather than use a set of include and
exclude patterns to choose the files
+ <p>Rather than use a set of include and exclude
patterns to choose the files
that make up the file set, <code><v-fileset></code>
takes zero or more
<a href="#File Selectors">file selectors</a>. File
selectors can be used to
select files based on any attribute of the file, rather than
just the name.
You can use <code><name></code> selectors to achieve
the same result
as using includes or excludes.</p>
- <p>A <code><v-fileset></code> element
takes the following attributes:</p>
- <table>
- <tr>
- <td bgcolor="#039acc" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ <p>A <code><v-fileset></code> element takes
the following attributes:</p>
+ <table cellpadding="3" cellspacing="2" border="1"
width="100%">
+ <tr class="a">
+ <th
+ >
Attribute
- </font>
- </td>
- <td bgcolor="#039acc" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </th>
+ <th
+ >
Description
- </font>
- </td>
- <td bgcolor="#039acc" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </th>
+ <th
+ >
Default Value
- </font>
- </td>
- </tr>
- <tr>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </th>
+ </tr>
+ <tr class="b">
+ <td
+ >
dir
- </font>
- </td>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </td>
+ <td
+ >
The base directory for the file set. This can be any URL that the
VFS supports.
- </font>
- </td>
- <td bgcolor="#a0ddf0" colspan="" rowspan=""
- valign="top" align="left">
- <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ </td>
+ <td
+ >
Required
- </font>
- </td>
- </tr>
+ </td>
+ </tr>
</table>
- <p>A <code><v-fileset></code> element
takes any number of nested
+ <p>A <code><v-fileset></code> element takes
any number of nested
<a href="#File Selectors">file selector</a> elements. To be
included in the
file set, a file must be selected by all the file selectors.
That is, the
file selectors are implicitly AND-ed together. If no file
selector is provided,
all the files and directories are included in the set.</p>
- <p>An example:</p>
- <div align="left">
- <table cellspacing="4" cellpadding="0" border="0">
- <tr>
- <td bgcolor="#023264" width="1" height="1"><img
src="/images/void.gif" width="1" height="1" vspace="0" hspace="0"
border="0"/></td>
- <td bgcolor="#023264" height="1"><img src="/images/void.gif"
width="1" height="1" vspace="0" hspace="0" border="0"/></td>
- <td bgcolor="#023264" width="1" height="1"><img
src="/images/void.gif" width="1" height="1" vspace="0" hspace="0"
border="0"/></td>
- </tr>
- <tr>
- <td bgcolor="#023264" width="1"><img src="/images/void.gif"
width="1" height="1" vspace="0" hspace="0" border="0"/></td>
- <td bgcolor="#ffffff"><pre>
+ <p>An example:</p>
+ <div id="source">
+ <pre>
<v-fileset dir="src">
<name pattern="org/apache/tools/ant/**"/>
<is-file/>
</v-fileset>
-</pre></td>
- <td bgcolor="#023264" width="1"><img src="/images/void.gif"
width="1" height="1" vspace="0" hspace="0" border="0"/></td>
- </tr>
- <tr>
- <td bgcolor="#023264" width="1" height="1"><img
src="/images/void.gif" width="1" height="1" vspace="0" hspace="0"
border="0"/></td>
- <td bgcolor="#023264" height="1"><img src="/images/void.gif"
width="1" height="1" vspace="0" hspace="0" border="0"/></td>
- <td bgcolor="#023264" width="1" height="1"><img
src="/images/void.gif" width="1" height="1" vspace="0" hspace="0"
border="0"/></td>
- </tr>
- </table>
+</pre>
</div>
- <h3><code><flat-fileset></code></h3>
- <p>This file set takes a set of nested file
sets and paths, and flattens them
+ <h3><code><flat-fileset></code></h3>
+ <p>This file set takes a set of nested file sets and
paths, and flattens them
into a single directory. It can be used as a way of
converting a path into a
file set. It can also be used as a replacement for the
<code>flatten</code>
attribute for the copy and move tasks.</p>
- <p>A <code><flat-fileset></code>
element takes no attributes, and a set
+ <p>A <code><flat-fileset></code> element takes
no attributes, and a set
of nested paths or file sets.</p>
- <p>An example:</p>
- <div align="left">
- <table cellspacing="4" cellpadding="0" border="0">
- <tr>
- <td bgcolor="#023264" width="1" height="1"><img
src="/images/void.gif" width="1" height="1" vspace="0" hspace="0"
border="0"/></td>
- <td bgcolor="#023264" height="1"><img src="/images/void.gif"
width="1" height="1" vspace="0" hspace="0" border="0"/></td>
- <td bgcolor="#023264" width="1" height="1"><img
src="/images/void.gif" width="1" height="1" vspace="0" hspace="0"
border="0"/></td>
- </tr>
- <tr>
- <td bgcolor="#023264" width="1"><img src="/images/void.gif"
width="1" height="1" vspace="0" hspace="0" border="0"/></td>
- <td bgcolor="#ffffff"><pre>
+ <p>An example:</p>
+ <div id="source">
+ <pre>
<v-copy todir="dist/lib">
<flat-fileset>
@@ -340,95 +270,67 @@
<v-path path="${classpath}"/>
</flat-fileset>
</v-copy>
-</pre></td>
- <td bgcolor="#023264" width="1"><img src="/images/void.gif"
width="1" height="1" vspace="0" hspace="0" border="0"/></td>
- </tr>
- <tr>
- <td bgcolor="#023264" width="1" height="1"><img
src="/images/void.gif" width="1" height="1" vspace="0" hspace="0"
border="0"/></td>
- <td bgcolor="#023264" height="1"><img src="/images/void.gif"
width="1" height="1" vspace="0" hspace="0" border="0"/></td>
- <td bgcolor="#023264" width="1" height="1"><img
src="/images/void.gif" width="1" height="1" vspace="0" hspace="0"
border="0"/></td>
- </tr>
- </table>
+</pre>
</div>
- <h3><code><mapped-fileset></code></h3>
- <p>A fileset that applies a <a
href="buildfile.html#File Name Mappers">file name mapper</a>
+ <h3><code><mapped-fileset></code></h3>
+ <p>A fileset that applies a <a
href="buildfile.html#File Name Mappers">file name mapper</a>
to a nested fileset.
</p>
- </blockquote>
- </td></tr>
- </table>
- <table border="0" cellspacing="0"
cellpadding="2" width="100%">
- <tr><td bgcolor="#828DA6">
- <font color="#ffffff" face="arial,helvetica,sanserif">
- <a name="Paths"><strong>Paths</strong></a>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <p>Paths are an ordered list of files.</p>
- <h3><code><v-path></code></h3>
- <p>This is the equivalent of Ant 1's
<code><path></code>.</p>
- <h3><code><filtered-path></code></h3>
- <p>A path that applies file selectors to a
set of nested file sets and paths.</p>
- </blockquote>
- </td></tr>
- </table>
- <table border="0" cellspacing="0"
cellpadding="2" width="100%">
- <tr><td bgcolor="#828DA6">
- <font color="#ffffff" face="arial,helvetica,sanserif">
- <a name="File Selectors"><strong>File
Selectors</strong></a>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <p>File selectors are used to select files from file
sets and paths.</p>
- <h3><code><and></code></h3>
- <p>Combines zero or more file selectors,
using AND. An empty <code><and></code>
+ </div>
+ <div class="h4">
+ <h4><a name="Paths">Paths</a></h4>
+ <p>Paths are an ordered list of files.</p>
+ <h3><code><v-path></code></h3>
+ <p>This is the equivalent of Ant 1's
<code><path></code>.</p>
+ <h3><code><filtered-path></code></h3>
+ <p>A path that applies file selectors to a set of
nested file sets and paths.</p>
+ </div>
+ <div class="h4">
+ <h4><a name="File Selectors">File Selectors</a></h4>
+ <p>File selectors are used to select files from file sets
and paths.</p>
+ <h3><code><and></code></h3>
+ <p>Combines zero or more file selectors, using AND.
An empty <code><and></code>
selector accepts all files.</p>
- <h3><code><basename></code></h3>
- <p>Selects files whose base name matches an
Ant 1 style pattern, or a regular
+ <h3><code><basename></code></h3>
+ <p>Selects files whose base name matches an Ant 1
style pattern, or a regular
expression.</p>
- <h3><code><condition></code></h3>
- <p>Takes a set of <a
href="buildfile.html#Conditions">conditions</a>. If
+ <h3><code><condition></code></h3>
+ <p>Takes a set of <a
href="buildfile.html#Conditions">conditions</a>. If
the conditions evaluate to true, then select every file.
Otherwise,
select no files.</p>
- <h3><code><exists></code></h3>
- <p>Selects files that exist.</p>
- <h3><code><is-empty-folder></code></h3>
- <p>Selects empty folders, that is, folders
that have no children.</p>
- <h3><code><is-folder></code></h3>
- <p>Selects folders, does not select regular
files.</p>
- <h3><code><is-file></code></h3>
- <p>Selects regular files, does not select
folders.</p>
- <h3><code><name></code></h3>
- <p>Selects files whose path in a file set
matches an Ant 1 style pattern, or
+ <h3><code><exists></code></h3>
+ <p>Selects files that exist.</p>
+ <h3><code><is-empty-folder></code></h3>
+ <p>Selects empty folders, that is, folders that have
no children.</p>
+ <h3><code><is-folder></code></h3>
+ <p>Selects folders, does not select regular
files.</p>
+ <h3><code><is-file></code></h3>
+ <p>Selects regular files, does not select
folders.</p>
+ <h3><code><name></code></h3>
+ <p>Selects files whose path in a file set matches an
Ant 1 style pattern, or
a regular expression.</p>
- <h3><code><not></code></h3>
- <p>Selects files that are not selected by a
nested file selector.</p>
- <h3><code><or></code></h3>
- <p>Combines zero or more file selectors,
using OR. An empty <code><or></code>
+ <h3><code><not></code></h3>
+ <p>Selects files that are not selected by a nested
file selector.</p>
+ <h3><code><or></code></h3>
+ <p>Combines zero or more file selectors, using OR.
An empty <code><or></code>
selector accepts all files.</p>
- <h3><code><url></code></h3>
- <p>Selects files whose URL matches an Ant 1
style pattern, or a regular expression.</p>
- </blockquote>
- </td></tr>
- </table>
- </blockquote>
- </td></tr>
- </table>
- </td>
+ <h3><code><url></code></h3>
+ <p>Selects files whose URL matches an Ant 1 style
pattern, or a regular expression.</p>
+ </div>
+ </div>
+ </div></div></td>
</tr>
-
- <!-- FOOTER -->
- <tr><td colspan="2">
- <hr noshade="" size="1"/>
- </td></tr>
- <tr><td colspan="2">
- <div align="center"><font color="#525D76" size="-1"><em>
- Copyright © 2000-2002, Apache Software Foundation
- </em></font></div>
- </td></tr>
</table>
+
+ <!-- FOOTER -->
+ <div id="footer">
+ <table border="0" cellspacing="0" cellpadding="4">
+ <tr>
+ <td>Copyright © 2000-2002, Apache Software Foundation</td>
+ </tr>
+ </table>
+ </div>
+
</body>
</html>
<!-- end the processing -->
1.1 jakarta-ant-myrmidon/site/docs/css/ns4_only.css
Index: ns4_only.css
===================================================================
/* simple rules suitable for Netscape 4.x only; richer rules are in
tigris.css. see <http://style.tigris.org/> */
/* colors, backgrounds, borders, link indication */
body {
background: #fff;
color: #000;
}
#leftcol a:link, #leftcol a:visited {
color: blue;
}
a:active, a:hover, #leftcol a:active, #leftcol a:hover {
color: #f30;
}
#login a:link, #login a:visited {
color: white;
text-decoration: underline;
}
#banner a:active, #banner a:hover {
color: #f90;
}
#leftcol a, #breadcrumbs a {
text-decoration: none;
}
h2 .lastchild {
color: #777
}
.a td {
background: #ddd;
}
.b td {
background: #efefef;
}
.tabs td, .tabs th {
background-color: #ddd;
}
body .app th {
background-color: #bbb;
}
body .tabs th {
background-color: #888;
color: #fff;
}
body .app .axial th {
background-color: #ddd;
color: black
}
.tabs td {
background-color: #ddd;
}
.alert {
color: #c00;
}
.confirm {
color: green;
}
.info {
color: blue;
}
.selection {
background: #ffc;
}
#login {
color: #fff;
}
#helptext th {
background: #cc9;
}
#helptext td {
background: #ffc;
}
.tabs a {
text-decoration: none;
}
#navcolumn div strong {
color: #555;
}
#banner, #banner td {
background: #036;
color: #fff;
}
body #banner #login a {
color: white;
}
/* font and text properties, exclusive of link indication, alignment,
text-indent */
body, div, p, th, td, li, dl, dd {
font-family: Lucida, Arial, Helvetica, sans-serif;
}
code, pre {
font-family: 'Andale Mono', Courier, monospace;
}
h2, h3, h4 {
font-family: Tahoma, Verdana, Helvetica, Arial, sans-serif;
}
.selection {
font-weight: bold
}
#login .username {
font-weight: bold;
}
/* box properties (exclusive of borders), positioning, alignments, list
types, text-indent */
th, td {
text-align: left;
vertical-align: top
}
.right {
text-align: right;
}
.center {
text-align: center;
}
body .app .axial th {
text-align: right;
}
.app .axial td th {
text-align: left;
}
body td .stb {
margin-top: 1em;
text-indent: 0;
}
body td .mtb {
margin-top: 2em;
text-indent: 0;
}
dd {
margin-bottom: .67em;
}
#footer {
margin: 4px
}
#helptext {
margin-top: 1em
}
#helptext td div {
margin: .5em
}
.courtesylinks {
margin-top: 1em;
padding-top: 1em
}
#navcolumn div {
margin-bottom: .5em;
}
#navcolumn div div {
margin-top: .3em
}
#navcolumn div div {
padding-left: 1em;
}
#banner, #banner td {
vertical-align: middle;
}
body.docs, body.nonav {
margin: 1em
}
1.1 jakarta-ant-myrmidon/site/docs/css/print.css
Index: print.css
===================================================================
#banner, #footer, #leftcol, #breadcrumbs, .docs #toc, .docs .courtesylinks
{
display: none;
}
body.docs div.docs {
margin: 0 !important;
border: none !important
}
1.1 jakarta-ant-myrmidon/site/docs/css/site.css
Index: site.css
===================================================================
div#banner {
border-top: 1px solid #fff;
border-bottom: 1px solid #aaa;
}
#banner, #banner td {
background: #fff;
color: #036;
}
#source {
background-color: #fff;
color: #000;
border-right: 1px solid #888;
border-left: 1px solid #888;
border-top: 1px solid #888;
border-bottom: 1px solid #888;
margin-right: 7px;
margin-left: 7px;
margin-top: 1em;
}
#source pre {
margin-right: 7px;
margin-left: 7px;
}
1.1 jakarta-ant-myrmidon/site/docs/css/tigris.css
Index: tigris.css
===================================================================
/* contains rules unsuitable for Netscape 4.x; simpler rules are in
ns4_only.css. see <http://style.tigris.org/> */
/* colors, backgrounds, borders, link indication */
body {
background: #fff;
color: #000;
}
.app h3, .app h4, .tabs td, .tabs th, .functnbar {
background-image: url(../images/nw_min.gif);
background-repeat: no-repeat;
}
#navcolumn div div, body.docs #toc li li {
background-image: url(../images/strich.gif);
background-repeat: no-repeat;
background-position: .5em .5em;
}
#navcolumn div div.heading {
background-image: none;
}
.app h3, .app h4 {
color: #fff;
}
.app h3 {
background-color: #036;
}
.app h4 {
background-color: #888;
}
.a td {
background: #ddd;
}
.b td {
background: #efefef;
}
table, th, td {
border: none
}
.mtb {
border-top: solid 1px #ddd;
}
div.colbar {
background: #bbb;
}
#banner {
border-top: 1px solid #369;
border-bottom: 1px solid #003;
}
div#helptext th {
border-bottom: 1px solid #996;
border-right: 1px solid #996;
}
div#helptext td {
border-bottom: 1px solid #cc9;
border-right: 1px solid #cc9;
}
.tabs th {
border-right: 1px solid #333;
background-color: #ddd;
color: #fff;
}
.tabs td {
background-color: #999;
border-bottom: 1px solid #fff;
border-right: 1px solid #fff;
}
.tabs {
border-bottom: 6px #ddd solid;
}
.tabs th, .tabs th a:link, .tabs th a:visited {
color: #555;
}
.tabs td, .tabs td a:link, .tabs td a:visited {
color: #fff;
}
.tabs a {
text-decoration: none;
}
#navcolumn {
background: #eee;
border-right: 1px solid #aaa;
border-bottom: 1px solid #aaa;
}
#breadcrumbs {
border-bottom: 1px solid #aaa;
background-color: #ddd
}
#navcolumn, #breadcrumbs {
border-top: 1px solid #fff;
}
#rightcol div.www, #rightcol div.help {
border: 1px solid #ddd;
}
div#navcolumn div.focus {
border-top: 1px solid #aaa;
border-left: 1px solid #aaa;
background-color: #fff;
}
body.docs div.docs {
background: #fff;
border-left: 1px solid #ddd;
border-top: 1px solid #ddd;
}
body.docs {
background: #eee url(../images/help_logo.gif) top right no-repeat !important;
}
.docs h3, .docs h4 {
border-top: solid 1px #000;
}
#alerterrormessage {
background: url(../images/icon_alert.gif) top left no-repeat !important;
}
.functnbar {
background-color: #aaa;
}
.functnbar2, .functnbar3 {
background: #aaa url(../images/sw_min.gif) no-repeat bottom left;
}
.functnbar3 {
background-color: #ddd;
}
.functnbar, .functnbar2, .functnbar3 {
color: #000;
}
.functnbar a, .functnbar2 a, .functnbar3 a {
color: #000;
text-decoration: underline;
}
#topmodule {
background: #ddd;
border-top: 1px solid #fff;
border-bottom: 1px solid #aaa;
border-right: 1px solid #aaa;
}
#topmodule #issueid {
border-right: 1px solid #aaa;
}
a:link, #navcolumn a:visited, .app a:visited, .tasknav a:visited {
color: blue;
}
a:link.selfref, a:visited.selfref {
color: #555 !important;
text-decoration: none;
}
a:active, a:hover, #leftcol a:active, #leftcol a:hover {
color: #f30 !important;
}
#login a:link, #login a:visited {
color: white;
text-decoration: underline;
}
#banner a:active, #banner a:hover {
color: #f90 !important;
}
#leftcol a, #breadcrumbs a {
text-decoration: none;
}
#apphead h2 em {
color: #777;
}
a:link.selfref, a:visited.selfref {
color: #555 !important;
text-decoration: none;
}
.app th {
background-color: #bbb;
}
.axial th {
background-color: #ddd;
color: black
}
.alert {
color: #c00;
}
.confirm {
color: green;
}
.info {
color: blue;
}
.selection {
background: #ffc;
}
#login {
color: #fff;
}
#helptext th {
background: #cc9;
}
#helptext td {
background: #ffc;
}
#navcolumn div strong {
color: #000;
}
#banner, #banner td {
background: #036;
color: #fff;
}
body #banner #login a {
color: #fff;
}
h4 a:link, h4 a:visited {
text-decoration: underline;
color: #fff;
}
/* font and text properties, exclusive of link indication, alignment,
text-indent */
body, th, td, input, select, textarea, h2 small {
font-family: Verdana, Helvetica, Arial, sans-serif;
}
code, pre {
font-family: 'Andale Mono', Courier, monospace;
}
html body, body th, body td, textarea, h2 small, .app h3, .app h4, #rightcol
h3, #bodycol pre, #bodycol code {
font-size: x-small;
voice-family: "\"}\"";
voice-family: inherit;
font-size: small
}
html>body, html>body th, html>body td, html>body input, html>body select,
html>body textarea, html>body h2 small, html>body .app h3, html>body .app h4,
html>body #rightcol h3, html>body #bodycol pre, html>body #bodycol code {
font-size: small
}
small, div#footer td, div#login, div.tabs th, div.tabs td, input, select,
.paginate, .functnbar, .functnbar2, .functnbar3, #breadcrumbs td,
.courtesylinks, #rightcol div.help, .colbar, .tasknav, body.docs div#toc,
#leftcol {
font-size: xx-small;
voice-family: "\"}\"";
voice-family: inherit;
font-size: x-small
}
html>body small, html>body div#footer td, html>body div#login, html>body
div.tabs th, html>body div.tabs td, html>body input, html>body select,
html>body .paginate, html>body .functnbar, html>body .functnbar2, html>body
.functnbar3, html>body #breadcrumbs td, html>body .courtesylinks, html>body
#rightcol div.help, html>body .colbar, html>body .tasknav, html>body.docs #toc,
html>body #leftcol {
font-size: x-small
}
#bodycol h2 {
font-family: Tahoma, Verdana, Helvetica, Arial, sans-serif;
font-size: 1.5em;
font-weight: normal;
}
.tabs td, .tabs th, dt, .tasknav .selfref, #login .username, .selection {
font-weight: bold
}
h4 {
font-size: 1em;
}
#apphead h2 em {
font-style: normal;
}
/* box properties (exclusive of borders), positioning, alignments, list
types, text-indent */
#bodycol h2 {
margin-top: .3em;
margin-bottom: .5em;
}
p, ul, ol, dl {
margin-top: .67em;
margin-bottom: .67em;
}
h3, h4 {
margin-bottom: 0;
}
form {
margin-top: 0;
margin-bottom: 0;
}
#bodycol {
padding-left: 12px;
padding-right: 12px;
width: 100%;
voice-family: "\"}\"";
voice-family: inherit;
width: auto;
}
html>body #bodycol {
width: auto;
}
.docs {
line-height: 1.4;
}
.app h3, .app h4 {
padding: 5px;
margin-right: 2px;
margin-left: 2px;
}
.h3 p, .h4 p, .h3 dt, .h4 dt {
margin-right: 7px;
margin-left: 7px;
}
.tasknav {
margin-bottom: 1.33em
}
div.colbar {
padding: 3px;
margin: 2px 2px 0;
}
.tabs {
margin-top: .67em;
margin-right: 2px;
margin-left: 2px;
}
#leftcol {
padding-bottom: .5em;
}
#breadcrumbs td {
vertical-align: middle;
padding: 2px 8px;
}
.tabs td, .tabs th {
padding: 3px 9px;
}
#rightcol div.www, #rightcol div.help {
padding: 0 .5em
}
#navcolumn {
margin: -8px -8px 0 -8px;
padding: 4px;
}
#navcolumn div {
padding-left: 5px
}
div#navcolumn div div {
margin-top: .3em;
margin-bottom: .3em;
}
div#navcolumn div.focus {
margin-top: -.1em;
padding: .2em 4px;
}
body.docs #toc {
position: absolute;
top: 15px;
left: 0px;
width: 120px;
padding: 0 20px 0 0
}
body.docs #toc ul, #toc ol {
margin-left: 0;
padding-left: 0;
}
body.docs #toc li {
margin-top: 7px;
padding-left: 10px;
list-style-type: none;
}
body.docs div.docs {
margin: 61px 0 0 150px;
padding: 1em 2em 1em 1em !important;
}
.docs p+p {
text-indent: 5%;
margin-top: -.67em
}
.docs h3, .docs h4 {
margin-bottom: .1em;
padding-top: .3em;
}
#alerterrormessage {
padding-left: 100px;
}
.functnbar, .functnbar2, .functnbar3 {
padding: 5px;
margin: .67em 2px;
}
#topmodule td {
vertical-align: middle;
padding: 2px 8px
}
body {
padding: 1em;
}
body.composite, body.docs {
margin: 0;
padding: 0;
}
th, td {
text-align: left;
vertical-align: top
}
.right {
text-align: right !important;
}
.center {
text-align: center !important;
}
.axial th {
text-align: right;
}
.app .axial td th {
text-align: left;
}
body td .stb {
margin-top: 1em;
text-indent: 0;
}
body td .mtb {
margin-top: 2em;
text-indent: 0;
}
dd {
margin-bottom: .67em;
}
#footer {
margin: 4px
}
#helptext {
margin-top: 1em
}
#helptext td div {
margin: .5em
}
.courtesylinks {
margin-top: 1em;
padding-top: 1em
}
#navcolumn div {
margin-bottom: .5em;
}
#navcolumn div div {
margin-top: .3em
}
#navcolumn div div {
padding-left: 1em;
}
#banner, #banner td {
vertical-align: middle;
}
1.1 jakarta-ant-myrmidon/site/docs/images/nw_min.gif
<<Binary file>>
1.1 jakarta-ant-myrmidon/site/docs/images/strich.gif
<<Binary file>>
1.1 jakarta-ant-myrmidon/site/docs/images/sw_min.gif
<<Binary file>>
--
To unsubscribe, e-mail: <mailto:[EMAIL PROTECTED]>
For additional commands, e-mail: <mailto:[EMAIL PROTECTED]>