bodewig 2002/07/30 07:59:36
Modified: docs Tag: ANT_15_BRANCH faq.html projects.html
docs/manual/CoreTasks Tag: ANT_15_BRANCH javac.html
xdocs Tag: ANT_15_BRANCH faq.xml
Log:
Shell snippet that autodetects Emacs' compile mode and then passes
-emacs as well as build.compiler.emacs to Ant.
PR: 11056, 11057
Submitted by: Ville Skytt� <[EMAIL PROTECTED]>
Revision Changes Path
No revision
No revision
1.30.2.1 +79 -7 jakarta-ant/docs/faq.html
Index: faq.html
===================================================================
RCS file: /home/cvs/jakarta-ant/docs/faq.html,v
retrieving revision 1.30
retrieving revision 1.30.2.1
diff -u -r1.30 -r1.30.2.1
--- faq.html 30 Apr 2002 01:20:31 -0000 1.30
+++ faq.html 30 Jul 2002 14:59:36 -0000 1.30.2.1
@@ -296,6 +296,11 @@
<style> or <junit> ignores my
<classpath>
</a></li>
+ <li><a href="#1.5-cygwin-sh">
+ The <code>ant</code> wrapper script of Ant 1.5 fails
+ for Cygwin if <code>ANT_HOME</code> is set to a Windows style
+ path.
+ </a></li>
</ul>
</blockquote>
</td></tr>
@@ -537,6 +542,20 @@
</font>
</td>
</tr>
+ <tr>
+ <td bgcolor="#a0ddf0" colspan="" rowspan=""
+ valign="top" align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ 1.5
+ </font>
+ </td>
+ <td bgcolor="#a0ddf0" colspan="" rowspan=""
+ valign="top" align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ 10 July 2002
+ </font>
+ </td>
+ </tr>
</table>
</blockquote>
</td></tr>
@@ -752,6 +771,9 @@
</td>
</tr>
</table>
+ <p>With Ant >= 1.5, you can also
use nested
+ <code><compilerarg></code> elements with the
+ <code><javac></code> task.</p>
</blockquote>
</td></tr>
</table>
@@ -1271,8 +1293,8 @@
your build file uses, this is done inside the <a
href="http://www.w3.org/TR/2000/REC-xml-20001006#sec-prolog-dtd";>XML
declaration</a>.</p>
<p>By default the parser assumes you
are using the UTF-8
- encoding instead of your platform's default. For most western
- european contries you should set the encoding to
+ encoding instead of your platform's default. For most Western
+ European countries you should set the encoding to
<code>ISO-8859-1</code>. To do so, make the very first line
of you build file read like</p>
<div align="left">
@@ -1334,9 +1356,37 @@
regular expressions in your editor that would account for
this.</p>
<p>You can disable this banner by
invoking Ant with the
- <code>-emacs</code> switch. Alternatively, you can add the
- following snippet to your <code>.emacs</code> to make Emacs
- understand Ant's output.</p>
+ <code>-emacs</code> switch. To make Ant autodetect
+ Emacs' compile mode, put this into your
+ <code>.antrc</code> (contributed by Ville Skytt�).</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>
+# Detect (X)Emacs compile mode
+if [ "$EMACS" = "t" ] ; then
+ ANT_ARGS="$ANT_ARGS -emacs"
+ ANT_OPTS="$ANT_OPTS -Dbuild.compiler.emacs=true"
+fi
+</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>
+ </div>
+ <p>Alternatively, you can add the
following snippet to your
+ <code>.emacs</code> to make Emacs understand Ant's
+ output.</p>
<div align="left">
<table cellspacing="4" cellpadding="0" border="0">
<tr>
@@ -1619,7 +1669,7 @@
* Determine the status of the build and the actions to follow, now that
* the build has completed.
*
- * @param e Event describing the build tatus.
+ * @param e Event describing the build status.
*/
public void buildFinished(BuildEvent e) {
Throwable th = e.getException();
@@ -1947,7 +1997,7 @@
is in <code>CLASSPATH</code> as well.</p>
<p>To solve this, you have two major
options:</p>
<ol>
- <li>put all external libaries you need in
+ <li>put all external libraries you need in
<code>CLASSPATH</code> as well this is not what you want,
otherwise you wouldn't have found this FAQ entry.</li>
@@ -1984,6 +2034,28 @@
for <code><junit></code>, you still have to use a
<code><taskdef></code> with a nested
<code><classpath></code> to define the junit task.</p>
+ </blockquote>
+ </td></tr>
+ </table>
+ </a>
+ <a name="1.5-cygwin-sh">
+ <table border="0" cellspacing="0" cellpadding="2" width="100%">
+ <tr><td bgcolor="#828DA6">
+ <font color="#ffffff" face="arial,helvetica,sanserif">
+ <strong>
+ The <code>ant</code> wrapper script of Ant 1.5 fails
+ for Cygwin if <code>ANT_HOME</code> is set to a Windows style
+ path.
+ </strong>
+ </font>
+ </td></tr>
+ <tr><td>
+ <blockquote>
+ <p>This problem has been reported only hours
after Ant 1.5 has
+ been released, see <a
href="http://nagoya.apache.org/bugzilla/show_bug.cgi?id=10664";>Bug
+ 10664</a> and all it's duplicates.</p>
+ <p>A fixed version of the wrapper
script can be found <a
href="http://jakarta.apache.org/builds/jakarta-ant/release/v1.5/errata/";>here</a>.
+ Simply replace your script with this version.</p>
</blockquote>
</td></tr>
</table>
1.12.2.2 +5 -5 jakarta-ant/docs/projects.html
Index: projects.html
===================================================================
RCS file: /home/cvs/jakarta-ant/docs/projects.html,v
retrieving revision 1.12.2.1
retrieving revision 1.12.2.2
diff -u -r1.12.2.1 -r1.12.2.2
--- projects.html 23 Jul 2002 07:35:13 -0000 1.12.2.1
+++ projects.html 30 Jul 2002 14:59:36 -0000 1.12.2.2
@@ -188,12 +188,12 @@
<tr><td>
<blockquote>
<p>AntDoc is a tool that generates HTML
documentation from Ant
- buildfiles; the generated HTML is inspired from what javadoc
- yields. It also offers a simple Ant target launcher named
- AntDoc GUI. Ant targets may be launched from the generated
- AntDoc HTML pages.</p>
+ buildfiles; the generated HTML is inspired from what javadoc
+ yields. It also offers a simple Ant target launcher named
+ AntDoc GUI. Ant targets may be launched from the generated
+ AntDoc HTML pages.</p>
<p>AntDoc can be run via an Ant task, AntDoc
GUI can be run
- via an Ant task, or via a JVM launch.</p>
+ via an Ant task, or via a JVM launch.</p>
<table>
<tr>
<td bgcolor="#039acc" colspan="" rowspan=""
No revision
No revision
1.33.2.7 +6 -9 jakarta-ant/docs/manual/CoreTasks/javac.html
Index: javac.html
===================================================================
RCS file: /home/cvs/jakarta-ant/docs/manual/CoreTasks/javac.html,v
retrieving revision 1.33.2.6
retrieving revision 1.33.2.7
diff -u -r1.33.2.6 -r1.33.2.7
--- javac.html 20 Jun 2002 09:40:30 -0000 1.33.2.6
+++ javac.html 30 Jul 2002 14:59:36 -0000 1.33.2.7
@@ -1,4 +1,4 @@
-<html>
+<html lang="en-us">
<head>
<meta http-equiv="Content-Language" content="en-us">
@@ -21,7 +21,7 @@
from the source file, and so on. See the
<a href="../OptionalTasks/depend.html"><code><depend></code></a> task
for dependency checking based on other than just
-existence/modification times.
+existence/modification times.</p>
<p>When the source files are part of a package, the directory structure of
the source tree should follow the package
hierarchy.</p>
@@ -47,7 +47,7 @@
<code><javac></code> task.
<a name="compilervalues">Valid values for either the
<code>build.compiler</code> property or the <code>compiler</code>
-attribute are:</p>
+attribute are:</a></p>
<ul>
<li><code>classic</code> (the standard compiler of JDK 1.1/1.2) –
<code>javac1.1</code> and
@@ -56,7 +56,7 @@
<code>javac1.3</code> and
<code>javac1.4</code> can be used as aliases.</li>
<li><code>jikes</code> (the <a
-
href="http://oss.software.ibm.com/developerworks/opensource/jikes/project";
target="_top">Jikes</a>
+ href="http://oss.software.ibm.com/developerworks/opensource/jikes/";
target="_top">Jikes</a>
compiler).</li>
<li><code>jvc</code> (the Command-Line Compiler from Microsoft's SDK
for Java / Visual J++) – <code>microsoft</code> can be used
@@ -69,7 +69,6 @@
<li><code>extJavac</code> (run either modern or classic in a JVM of
its own).</li>
</ul>
-</a>
<p>The default is <code>javac1.x</code> with <code>x</code> depending
on the JDK version you use while you are running Ant.
If you wish to use a different compiler interface than those
@@ -98,7 +97,6 @@
The side effect of this is that you will not be able to delete or move
those files later on in the build. The workaround is to fork when
invoking the compiler.</p>
-</p>
<h3>Parameters</h3>
<table border="1" cellpadding="2" cellspacing="0">
<tr>
@@ -109,7 +107,7 @@
<tr>
<td valign="top">srcdir</td>
<td valign="top">Location of the java files. (See the
- <a href="#srcdirnote">Note</a> below.)</td>
+ <a href="#srcdirnote">note</a> below.)</td>
<td align="center" valign="top">Yes, unless nested
<code><src></code> elements are present.</td>
</tr>
<tr>
@@ -492,7 +490,7 @@
<h3>Jikes Notes</h3>
-Jikes supports some extra options, which can be set be defining
+<p>Jikes supports some extra options, which can be set be defining
the properties shown below prior to invoking the task. The setting
for each property will be in affect for all <code><javac></code>
tasks throughout the build.
@@ -559,7 +557,6 @@
</td>
</tr>
</table>
-</p>
<hr>
<p align="center">Copyright © 2000-2002 Apache Software Foundation.
No revision
No revision
1.17.2.1 +45 -7 jakarta-ant/xdocs/faq.xml
Index: faq.xml
===================================================================
RCS file: /home/cvs/jakarta-ant/xdocs/faq.xml,v
retrieving revision 1.17
retrieving revision 1.17.2.1
diff -u -r1.17 -r1.17.2.1
--- faq.xml 18 Apr 2002 14:48:13 -0000 1.17
+++ faq.xml 30 Jul 2002 14:59:36 -0000 1.17.2.1
@@ -138,6 +138,11 @@
<td>1.4.1</td>
<td>11 October 2001</td>
</tr>
+
+ <tr>
+ <td>1.5</td>
+ <td>10 July 2002</td>
+ </tr>
</table>
</answer>
</faq>
@@ -265,6 +270,10 @@
</table>
+ <p>With Ant >= 1.5, you can also use nested
+ <code><compilerarg></code> elements with the
+ <code><javac></code> task.</p>
+
</answer>
</faq>
@@ -575,8 +584,8 @@
declaration</a>.</p>
<p>By default the parser assumes you are using the UTF-8
- encoding instead of your platform's default. For most western
- european contries you should set the encoding to
+ encoding instead of your platform's default. For most Western
+ European countries you should set the encoding to
<code>ISO-8859-1</code>. To do so, make the very first line
of you build file read like</p>
@@ -607,9 +616,21 @@
this.</p>
<p>You can disable this banner by invoking Ant with the
- <code>-emacs</code> switch. Alternatively, you can add the
- following snippet to your <code>.emacs</code> to make Emacs
- understand Ant's output.</p>
+ <code>-emacs</code> switch. To make Ant autodetect
+ Emacs' compile mode, put this into your
+ <code>.antrc</code> (contributed by Ville Skyttä).</p>
+
+ <source><![CDATA[
+# Detect (X)Emacs compile mode
+if [ "$EMACS" = "t" ] ; then
+ ANT_ARGS="$ANT_ARGS -emacs"
+ ANT_OPTS="$ANT_OPTS -Dbuild.compiler.emacs=true"
+fi
+]]></source>
+
+ <p>Alternatively, you can add the following snippet to your
+ <code>.emacs</code> to make Emacs understand Ant's
+ output.</p>
<source><![CDATA[
(require 'compile)
@@ -785,7 +806,7 @@
* Determine the status of the build and the actions to follow, now that
* the build has completed.
*
- * @param e Event describing the build tatus.
+ * @param e Event describing the build status.
*/
public void buildFinished(BuildEvent e) {
Throwable th = e.getException();
@@ -1024,7 +1045,7 @@
<p>To solve this, you have two major options:</p>
<ol>
- <li>put all external libaries you need in
+ <li>put all external libraries you need in
<code>CLASSPATH</code> as well this is not what you want,
otherwise you wouldn't have found this FAQ entry.</li>
@@ -1065,6 +1086,23 @@
for <code><junit></code>, you still have to use a
<code><taskdef></code> with a nested
<code><classpath></code> to define the junit task.</p>
+ </answer>
+ </faq>
+
+ <faq id="1.5-cygwin-sh">
+ <question>The <code>ant</code> wrapper script of Ant 1.5 fails
+ for Cygwin if <code>ANT_HOME</code> is set to a Windows style
+ path.</question>
+ <answer>
+
+ <p>This problem has been reported only hours after Ant 1.5 has
+ been released, see <a
+ href="http://nagoya.apache.org/bugzilla/show_bug.cgi?id=10664";>Bug
+ 10664</a> and all it's duplicates.</p>
+
+ <p>A fixed version of the wrapper script can be found <a
+
href="http://jakarta.apache.org/builds/jakarta-ant/release/v1.5/errata/";>here</a>.
+ Simply replace your script with this version.</p>
</answer>
</faq>
</faqsection>
--
To unsubscribe, e-mail: <mailto:[EMAIL PROTECTED]>
For additional commands, e-mail: <mailto:[EMAIL PROTECTED]>
