tweak the announcement a bit; make the intro to Ant match the user man; add non-break where needed (now that I know the code :) PR: Obtained from: Submitted by: Reviewed by: git-svn-id: https://svn.apache.org/repos/asf/ant/core/trunk@272043 13f79535-47bb-0310-9956-ffa450edef68master
@@ -25,7 +25,7 @@ | |||
<a href="http://jakarta.apache.org"><img src="http://jakarta.apache.org/images/jakarta-logo.gif" border="0"/></a> | |||
</td> | |||
<td align="center"> | |||
<a href="http://www.javaworld.com"><img src="images/jw_ec_logo_finalist2002.gif" border="0"/></a> | |||
<a href="http://www.javaworld.com"><img src="images/jw_ec_logo_winner2002.gif" border="0"/></a> | |||
</td> | |||
<td align="right"> | |||
<a href="http://jakarta.apache.org/ant/"><img src="./images/ant_logo_large.gif" alt="Apache Ant" border="0"/></a> | |||
@@ -103,9 +103,12 @@ | |||
<tr><td> | |||
<blockquote> | |||
<h3>Mar 26, 2002: Ant wins the JavaWorld Editors' Choice | |||
award</h3> | |||
<p>Ant has won the JavaWorld Editors' Choice award for | |||
"Most Useful Java Community-Developed Technology".</p> | |||
Award</h3> | |||
<p>Ant has won the JavaWorld Editors' Choice Award for | |||
<strong>Most Useful Java Community-Developed Technology</strong>. | |||
Read the | |||
<a href="http://www.javaworld.com/javaworld/jw-03-2002/jw-0326-awards.html "> full article</a> -- or jump directly to the bit about | |||
<a href="http://www.javaworld.com/javaworld/jw-03-2002/jw-0326-awards-p3.html"> our award</a> <code>:)</code></p> | |||
</blockquote> | |||
</td></tr> | |||
</table> | |||
@@ -23,7 +23,7 @@ | |||
<a href="http://jakarta.apache.org"><img src="http://jakarta.apache.org/images/jakarta-logo.gif" border="0"/></a> | |||
</td> | |||
<td align="center"> | |||
<a href="http://www.javaworld.com"><img src="images/jw_ec_logo_finalist2002.gif" border="0"/></a> | |||
<a href="http://www.javaworld.com"><img src="images/jw_ec_logo_winner2002.gif" border="0"/></a> | |||
</td> | |||
<td align="right"> | |||
<a href="http://jakarta.apache.org/ant/"><img src="./images/ant_logo_large.gif" alt="Apache Ant" border="0"/></a> | |||
@@ -23,7 +23,7 @@ | |||
<a href="http://jakarta.apache.org"><img src="http://jakarta.apache.org/images/jakarta-logo.gif" border="0"/></a> | |||
</td> | |||
<td align="center"> | |||
<a href="http://www.javaworld.com"><img src="images/jw_ec_logo_finalist2002.gif" border="0"/></a> | |||
<a href="http://www.javaworld.com"><img src="images/jw_ec_logo_winner2002.gif" border="0"/></a> | |||
</td> | |||
<td align="right"> | |||
<a href="http://jakarta.apache.org/ant/"><img src="./images/ant_logo_large.gif" alt="Apache Ant" border="0"/></a> | |||
@@ -25,7 +25,7 @@ | |||
<a href="http://jakarta.apache.org"><img src="http://jakarta.apache.org/images/jakarta-logo.gif" border="0"/></a> | |||
</td> | |||
<td align="center"> | |||
<a href="http://www.javaworld.com"><img src="images/jw_ec_logo_finalist2002.gif" border="0"/></a> | |||
<a href="http://www.javaworld.com"><img src="images/jw_ec_logo_winner2002.gif" border="0"/></a> | |||
</td> | |||
<td align="right"> | |||
<a href="http://jakarta.apache.org/ant/"><img src="./images/ant_logo_large.gif" alt="Apache Ant" border="0"/></a> | |||
@@ -103,8 +103,9 @@ | |||
<tr><td> | |||
<blockquote> | |||
<p>We are proud to announce that Ant has won the JavaWorld | |||
Editors' Choice award for "Most Useful Java | |||
Community-Developed Technology"</p> | |||
Editors' Choice Award for <strong>Most Useful Java | |||
Community-Developed Technology</strong>. Click on the "News" link | |||
to learn more.</p> | |||
</blockquote> | |||
</td></tr> | |||
</table> | |||
@@ -134,15 +135,16 @@ | |||
<tr><td> | |||
<blockquote> | |||
<p> | |||
Apache Ant is a Java based build tool. In theory it is kind of like make without | |||
make's wrinkles. | |||
Apache Ant is a Java-based build tool. In theory, it is kind of like | |||
Make, but without Make's wrinkles. | |||
</p> | |||
<p> | |||
Why another build tool when there is already make, gnumake, nmake, jam, and | |||
others? Because all of those tools have limitations that Ant's original author | |||
Why another build tool when there is already <em>make</em>, <em>gnumake</em>, | |||
<em>nmake</em>, <em>jam</em>, and | |||
others? Because all those tools have limitations that Ant's original author | |||
couldn't live with when developing software across multiple platforms. Make-like | |||
tools are inherently shell based. They evaluate a set of dependencies and then | |||
execute commands not unlike what you would issue on a shell. This means that you | |||
tools are inherently shell-based -- they evaluate a set of dependencies, then | |||
execute commands not unlike what you would issue in a shell. This means that you | |||
can easily extend these tools by using or writing any program for the OS that | |||
you are working on. However, this also means that you limit yourself to the OS, | |||
or at least the OS type such as Unix, that you are working on. | |||
@@ -152,20 +154,22 @@ Makefiles are inherently evil as well. Anybody who has worked on them for any | |||
time has run into the dreaded tab problem. "Is my command not executing | |||
because I have a space in front of my tab!!!" said the original author of | |||
Ant way too many times. Tools like Jam took care of this to a great degree, but | |||
still use yet another format to use and remember. | |||
still have yet another format to use and remember. | |||
</p> | |||
<p> | |||
Ant is different. Instead of a model where it is extended with shell based | |||
commands, it is extended using Java classes. Instead of writing shell commands, | |||
the configuration files are XML based calling out a target tree where various | |||
tasks get executed. Each task is run by an object which implements a particular | |||
Ant is different. Instead of a model where it is extended with shell-based | |||
commands, Ant is extended using Java classes. Instead of writing shell commands, | |||
the configuration files are XML-based, calling out a target tree where various | |||
tasks get executed. Each task is run by an object that implements a particular | |||
Task interface. | |||
</p> | |||
<p> | |||
Granted, this removes some of the expressive power that is inherent by being | |||
able to construct a shell command such as `find . -name foo -exec rm {}` but it | |||
gives you the ability to be cross platform. To work anywhere and everywhere. And | |||
hey, if you really need to execute a shell command, Ant has an exec rule that | |||
able to construct a shell command such as | |||
<code>`find . -name foo -exec rm {}`</code>, but it | |||
gives you the ability to be cross platform -- to work anywhere and everywhere. | |||
And hey, if you really need to execute a shell command, Ant has an | |||
<code><exec></code> task that | |||
allows different commands to be executed based on the OS that it is executing | |||
on. | |||
</p> | |||
@@ -23,7 +23,7 @@ | |||
<a href="http://jakarta.apache.org"><img src="http://jakarta.apache.org/images/jakarta-logo.gif" border="0"/></a> | |||
</td> | |||
<td align="center"> | |||
<a href="http://www.javaworld.com"><img src="images/jw_ec_logo_finalist2002.gif" border="0"/></a> | |||
<a href="http://www.javaworld.com"><img src="images/jw_ec_logo_winner2002.gif" border="0"/></a> | |||
</td> | |||
<td align="right"> | |||
<a href="http://jakarta.apache.org/ant/"><img src="./images/ant_logo_large.gif" alt="Apache Ant" border="0"/></a> | |||
@@ -179,13 +179,13 @@ Complete build sequence is [debug, gensrc, compile, jar, test]<br /> | |||
You should be able to see from the trace more about what Ant | |||
is doing and why it's taking a particular course of action. | |||
If you need even more information, you can use the | |||
<code>-debug</code> flag rather than | |||
<code>-verbose</code>. | |||
<nobr><code>-debug</code></nobr> flag rather than | |||
<nobr><code>-verbose</code></nobr>. | |||
This will generally produce so much | |||
output that you may want to save the output to a file and | |||
analyze it in an editor. You can save the output using the | |||
<code>-logfile <filename></code> flag, or using | |||
redirection. | |||
<nobr><code>-logfile <filename></code></nobr> flag, or | |||
using redirection. | |||
</p> | |||
<p> | |||
Once you have all this debug information, how can you use it | |||
@@ -309,7 +309,8 @@ D:\src\java\Unset.java<br /> | |||
<p> | |||
By this time, you may have decided that there is an unreported | |||
bug in Ant. You have a few choices at this point. You can send | |||
an email to the <code>ant-user</code> mailing list to see if | |||
an email to the <nobr><code>ant-user</code></nobr> mailing list | |||
to see if | |||
others have encountered your issue and find out how they may | |||
have worked around it. If after some discussion, you feel it | |||
is time to create | |||
@@ -385,18 +386,20 @@ D:\src\java\Unset.java<br /> | |||
<a href="http://jakarta.apache.org/builds/jakarta-ant/release/v1.4.1/src/"> | |||
source distributions</a>. If you | |||
are going to tackle the problem at this level, you may want to | |||
discuss some details first on the <code>ant-dev</code> mailing | |||
list. Once you have a fix for the problem, you may submit | |||
the fix as a <i>patch</i> to either the <code>ant-dev</code> mailing | |||
discuss some details first on the <nobr><code>ant-dev</code></nobr> | |||
mailing list. Once you have a fix for the problem, you may submit | |||
the fix as a <i>patch</i> to either the | |||
<nobr><code>ant-dev</code></nobr> mailing | |||
list, or enter the bug database as described above and attach the | |||
patch to the bug report. Using the bug database has the advantage | |||
of being able to track the progress of your patch. | |||
</p> | |||
<p> | |||
If you have a patch to submit and are sending it to the | |||
<code>ant-dev</code> mailing list, prefix "[PATCH]" | |||
<nobr><code>ant-dev</code></nobr> mailing list, | |||
prefix "[PATCH]" | |||
to your message subject. Please include any relevant bug numbers. | |||
Patch files should be created with the <code>-u</code> | |||
Patch files should be created with the <nobr><code>-u</code></nobr> | |||
option of the | |||
<code>diff</code> or <code>cvs diff</code> command. For | |||
example:<br /><br /> | |||
@@ -23,7 +23,7 @@ | |||
<a href="http://jakarta.apache.org"><img src="http://jakarta.apache.org/images/jakarta-logo.gif" border="0"/></a> | |||
</td> | |||
<td align="center"> | |||
<a href="http://www.javaworld.com"><img src="images/jw_ec_logo_finalist2002.gif" border="0"/></a> | |||
<a href="http://www.javaworld.com"><img src="images/jw_ec_logo_winner2002.gif" border="0"/></a> | |||
</td> | |||
<td align="right"> | |||
<a href="http://jakarta.apache.org/ant/"><img src="./images/ant_logo_large.gif" alt="Apache Ant" border="0"/></a> | |||
@@ -23,7 +23,7 @@ | |||
<a href="http://jakarta.apache.org"><img src="http://jakarta.apache.org/images/jakarta-logo.gif" border="0"/></a> | |||
</td> | |||
<td align="center"> | |||
<a href="http://www.javaworld.com"><img src="images/jw_ec_logo_finalist2002.gif" border="0"/></a> | |||
<a href="http://www.javaworld.com"><img src="images/jw_ec_logo_winner2002.gif" border="0"/></a> | |||
</td> | |||
<td align="right"> | |||
<a href="http://jakarta.apache.org/ant/"><img src="./images/ant_logo_large.gif" alt="Apache Ant" border="0"/></a> | |||
@@ -10,10 +10,14 @@ | |||
<body> | |||
<section name="Ant has won!"> | |||
<h3>Mar 26, 2002: Ant wins the JavaWorld Editors' Choice | |||
award</h3> | |||
Award</h3> | |||
<p>Ant has won the JavaWorld Editors' Choice award for | |||
"Most Useful Java Community-Developed Technology".</p> | |||
<p>Ant has won the JavaWorld Editors' Choice Award for | |||
<strong>Most Useful Java Community-Developed Technology</strong>. | |||
Read the | |||
<a href="http://www.javaworld.com/javaworld/jw-03-2002/jw-0326-awards.html | |||
"> full article</a> -- or jump directly to the bit about | |||
<a href="http://www.javaworld.com/javaworld/jw-03-2002/jw-0326-awards-p3.html"> our award</a> <code>:)</code></p> | |||
</section> | |||
<section name="Java 1.4 Support"> | |||
@@ -11,8 +11,9 @@ | |||
<section name="Ant has won!"> | |||
<p>We are proud to announce that Ant has won the JavaWorld | |||
Editors' Choice award for "Most Useful Java | |||
Community-Developed Technology"</p> | |||
Editors' Choice Award for <strong>Most Useful Java | |||
Community-Developed Technology</strong>. Click on the "News" link | |||
to learn more.</p> | |||
</section> | |||
<section name="Ant 1.4.1"> | |||
@@ -27,16 +28,17 @@ | |||
<section name="Apache Ant"> | |||
<p> | |||
Apache Ant is a Java based build tool. In theory it is kind of like make without | |||
make's wrinkles. | |||
Apache Ant is a Java-based build tool. In theory, it is kind of like | |||
Make, but without Make's wrinkles. | |||
</p> | |||
<p> | |||
Why another build tool when there is already make, gnumake, nmake, jam, and | |||
others? Because all of those tools have limitations that Ant's original author | |||
Why another build tool when there is already <em>make</em>, <em>gnumake</em>, | |||
<em>nmake</em>, <em>jam</em>, and | |||
others? Because all those tools have limitations that Ant's original author | |||
couldn't live with when developing software across multiple platforms. Make-like | |||
tools are inherently shell based. They evaluate a set of dependencies and then | |||
execute commands not unlike what you would issue on a shell. This means that you | |||
tools are inherently shell-based -- they evaluate a set of dependencies, then | |||
execute commands not unlike what you would issue in a shell. This means that you | |||
can easily extend these tools by using or writing any program for the OS that | |||
you are working on. However, this also means that you limit yourself to the OS, | |||
or at least the OS type such as Unix, that you are working on. | |||
@@ -47,22 +49,24 @@ Makefiles are inherently evil as well. Anybody who has worked on them for any | |||
time has run into the dreaded tab problem. "Is my command not executing | |||
because I have a space in front of my tab!!!" said the original author of | |||
Ant way too many times. Tools like Jam took care of this to a great degree, but | |||
still use yet another format to use and remember. | |||
still have yet another format to use and remember. | |||
</p> | |||
<p> | |||
Ant is different. Instead of a model where it is extended with shell based | |||
commands, it is extended using Java classes. Instead of writing shell commands, | |||
the configuration files are XML based calling out a target tree where various | |||
tasks get executed. Each task is run by an object which implements a particular | |||
Ant is different. Instead of a model where it is extended with shell-based | |||
commands, Ant is extended using Java classes. Instead of writing shell commands, | |||
the configuration files are XML-based, calling out a target tree where various | |||
tasks get executed. Each task is run by an object that implements a particular | |||
Task interface. | |||
</p> | |||
<p> | |||
Granted, this removes some of the expressive power that is inherent by being | |||
able to construct a shell command such as `find . -name foo -exec rm {}` but it | |||
gives you the ability to be cross platform. To work anywhere and everywhere. And | |||
hey, if you really need to execute a shell command, Ant has an exec rule that | |||
able to construct a shell command such as | |||
<code>`find . -name foo -exec rm {}`</code>, but it | |||
gives you the ability to be cross platform -- to work anywhere and everywhere. | |||
And hey, if you really need to execute a shell command, Ant has an | |||
<code><exec></code> task that | |||
allows different commands to be executed based on the OS that it is executing | |||
on. | |||
</p> | |||
@@ -67,13 +67,13 @@ Complete build sequence is [debug, gensrc, compile, jar, test]<br></br> | |||
You should be able to see from the trace more about what Ant | |||
is doing and why it's taking a particular course of action. | |||
If you need even more information, you can use the | |||
<code>-debug</code> flag rather than | |||
<code>-verbose</code>. | |||
<nobr><code>-debug</code></nobr> flag rather than | |||
<nobr><code>-verbose</code></nobr>. | |||
This will generally produce so much | |||
output that you may want to save the output to a file and | |||
analyze it in an editor. You can save the output using the | |||
<code>-logfile <filename></code> flag, or using | |||
redirection. | |||
<nobr><code>-logfile <filename></code></nobr> flag, or | |||
using redirection. | |||
</p> | |||
<p> | |||
Once you have all this debug information, how can you use it | |||
@@ -169,7 +169,8 @@ D:\src\java\Unset.java<br></br> | |||
<p> | |||
By this time, you may have decided that there is an unreported | |||
bug in Ant. You have a few choices at this point. You can send | |||
an email to the <code>ant-user</code> mailing list to see if | |||
an email to the <nobr><code>ant-user</code></nobr> mailing list | |||
to see if | |||
others have encountered your issue and find out how they may | |||
have worked around it. If after some discussion, you feel it | |||
is time to create | |||
@@ -229,18 +230,20 @@ D:\src\java\Unset.java<br></br> | |||
<a href="http://jakarta.apache.org/builds/jakarta-ant/release/v1.4.1/src/"> | |||
source distributions</a>. If you | |||
are going to tackle the problem at this level, you may want to | |||
discuss some details first on the <code>ant-dev</code> mailing | |||
list. Once you have a fix for the problem, you may submit | |||
the fix as a <i>patch</i> to either the <code>ant-dev</code> mailing | |||
discuss some details first on the <nobr><code>ant-dev</code></nobr> | |||
mailing list. Once you have a fix for the problem, you may submit | |||
the fix as a <i>patch</i> to either the | |||
<nobr><code>ant-dev</code></nobr> mailing | |||
list, or enter the bug database as described above and attach the | |||
patch to the bug report. Using the bug database has the advantage | |||
of being able to track the progress of your patch. | |||
</p> | |||
<p> | |||
If you have a patch to submit and are sending it to the | |||
<code>ant-dev</code> mailing list, prefix "[PATCH]" | |||
<nobr><code>ant-dev</code></nobr> mailing list, | |||
prefix "[PATCH]" | |||
to your message subject. Please include any relevant bug numbers. | |||
Patch files should be created with the <code>-u</code> | |||
Patch files should be created with the <nobr><code>-u</code></nobr> | |||
option of the | |||
<code>diff</code> or <code>cvs diff</code> command. For | |||
example:<br></br><br></br> | |||
@@ -130,7 +130,7 @@ | |||
<a href="http://jakarta.apache.org"><img src="http://jakarta.apache.org/images/jakarta-logo.gif" border="0"/></a> | |||
</td> | |||
<td align="center"> | |||
<a href="http://www.javaworld.com"><img src="images/jw_ec_logo_finalist2002.gif" border="0"/></a> | |||
<a href="http://www.javaworld.com"><img src="images/jw_ec_logo_winner2002.gif" border="0"/></a> | |||
</td> | |||
<td align="right"> | |||
#set ( $logoString = $project.getChild("logo").getAttributeValue("href") ) | |||