Browse Source

Deleting some obsolete FAQ entries.

git-svn-id: https://svn.apache.org/repos/asf/ant/core/trunk@909835 13f79535-47bb-0310-9956-ffa450edef68
master
Jesse N. Glick 15 years ago
parent
commit
92efb66fc9
2 changed files with 2 additions and 154 deletions
  1. +1
    -10
      docs/manual/OptionalTasks/junit.html
  2. +1
    -144
      xdocs/faq.xml

+ 1
- 10
docs/manual/OptionalTasks/junit.html View File

@@ -183,10 +183,7 @@ elements</a>).</p>
<td valign="top">includeantruntime</td>
<td valign="top">Implicitly add the Ant classes required to run
the tests and JUnit to the classpath in forked mode.
<b>Note:</b> Please read the <a
href="../../faq.html#junit-no-runtime-xml">Ant FAQ</a> if you
want to set this to <code>false</code> and use the XML formatter
at the same time.</td>
</td>
<td align="center" valign="top">No; default is <code>true</code>.</td>
</tr>
<tr>
@@ -379,12 +376,6 @@ failing methods. The name and the location can be specified via Java System prop
<code>ant.junit.failureCollector</code>. The value has to point to the directory and
the name of the resulting class (without suffix). It defaults to <i>java-tmp-dir</i>/FailedTests.</p>

<p><b>Note:</b> Please read the <a
href="../../faq.html#junit-no-runtime-xml">Ant FAQ</a> if you want to
set the fork attribute to <code>true</code>, the includeAntRuntime
attribute to <code>false</code> and use the XML formatter at the same
time.</p>

<table border="1" cellpadding="2" cellspacing="0">
<tr>
<td width="12%" valign="top"><b>Attribute</b></td>


+ 1
- 144
xdocs/faq.xml View File

@@ -1566,16 +1566,6 @@ mv /tmp/foo $ANT_HOME/bin/antRun
</answer>
</faq>

<faq id="javadoc-cannot-execute">
<question>JavaDoc failed: java.io.IOException: javadoc: cannot execute</question>
<answer>
<p>There is a bug in the Solaris reference implementation of
the JDK (see <a href="http://developer.java.sun.com/developer/bugParade/bugs/4230399.html">http://developer.java.sun.com/developer/bugParade/bugs/4230399.html</a>).
This also appears to be true under Linux. Moving the JDK to
the front of the PATH fixes the problem.</p>
</answer>
</faq>

<faq id="delegating-classloader">
<question>&lt;style&gt; or &lt;junit&gt; ignores my
&lt;classpath&gt;</question>
@@ -1823,68 +1813,6 @@ mv /tmp/foo $ANT_HOME/bin/antRun
</answer>
</faq>

<faq id="winxp-jdk14-ant14">
<question>When running Ant 1.4 on Windows XP and JDK 1.4, I get
various errors when trying to <code>&lt;exec&gt;</code>, fork
<code>&lt;java&gt;</code> or access environment
variables.</question>

<answer>

<p>Ant &lt; 1.5 doesn&apos;t recognize Windows XP as a flavor
of Windows that runs <code>CMD.EXE</code> instead of
<code>COMMAND.COM</code>. JDK 1.3 will tell Ant that Windows
XP is Windows 2000 so the problem doesn&apos;t show up
there.</p>

<p>Apart from upgrading to Ant 1.5 or better, setting the
environment variable <code>ANT_OPTS</code> to
<code>-Dos.name=Windows_NT</code> prior to invoking Ant has
been confirmed as a workaround.</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://issues.apache.org/bugzilla/show_bug.cgi?id=10664">Bug
10664</a> and all its duplicates.</p>

<p>A fixed version of the wrapper script can be found <a
href="http://ant.apache.org/old-releases/v1.5/errata/">here</a>.
Simply replace your script with this version.</p>
</answer>
</faq>

<faq id="1.5.2-zip-broken">
<question><code>&lt;zip&gt;</code> is broken in Ant 1.5.2.</question>
<answer>

<p>Yes, it is.</p>

<p>The problem reported by most people - see <a
href="http://issues.apache.org/bugzilla/show_bug.cgi?id=17648">Bug
17648</a> and all its duplicates - is that Ant creates
archives that a partially unreadable by WinZIP. Luckily
<code>jar</code> deals with the archives and so the generated
jars/wars/ears will most likely work for you anyway.</p>

<p>There are additional problems, see bugs <a
href="http://issues.apache.org/bugzilla/show_bug.cgi?id=17780">Bug
17780</a>, <a
href="http://issues.apache.org/bugzilla/show_bug.cgi?id=17871">Bug
17871</a> and <a
href="http://issues.apache.org/bugzilla/show_bug.cgi?id=18403">Bug
18403</a>. All of them are supposed to be fixed with Ant
1.5.3 (and only 18403 should exist in 1.5.3beta1).</p>
</answer>
</faq>

<faq id="unknownelement.taskcontainer">
<question>
Why do my custom task containers see Unknown Elements in Ant 1.6
@@ -1936,80 +1864,9 @@ mv /tmp/foo $ANT_HOME/bin/antRun
</answer>
</faq>

<faq id="java.exception.stacktrace">
<question>
The program I run via &lt;java&gt; throws an exception but I
can't seem to get the full stack trace.
</question>
<answer>
<p>This is a know bug that has been fixed after the release of
Ant 1.6.1.</p>

<p>As a workaround, run your &lt;java&gt; task with
<code>fork="true"</code> and Ant will display the full
trace.</p>
</answer>
</faq>

<faq id="junit-no-runtime-xml">
<question>
Using format=&quot;xml&quot;, &lt;junit&gt; fails with a
<code>NoClassDefFoundError</code> if forked.
</question>
<answer>

<p>The XML formatter needs the <a
href="http://www.w3.org/DOM/">DOM classes</a> to work. If you
are using JDK 1.4 or later they are included with your Java
Runtime and this problem won't occur. If you are running JDK
1.3 or earlier, the DOM classes have to be on your
&lt;junit&gt; task's &lt;classpath&gt;.</p>

<p>Prior to Ant 1.6.0 Ant would include the DOM classes from
the XML parser that is used by Ant itself if you set the
includeAntRuntime attribute to true (the default). With Ant
1.6.0 this has been changed as this behavior made it
impossible to use a different XML parser in your tests.</p>

<p>This means that you have to take care of the DOM classes
explicitly starting with Ant 1.6.0. If you don't need to set
up a different XML parser for your tests, the easiest solution
is to add</p>

<source><![CDATA[
<pathelement path="${ant.home}/lib/xml-apis.jar:${ant.home}/lib/xercesImpl.jar"/>
]]></source>

<p>to your task's &lt;classpath&gt;.</p>

</answer>
</faq>

<faq id="xalan-jdk1.5">
<question>
<code>&lt;junitreport&gt;</code> doesn't work with JDK 1.5 but
worked fine with JDK 1.4.
</question>
<answer>

<p>While JDK 1.4.x contains a version of Xalan-J 2, JDK 1.5
(and later?) have <a
href="http://java.sun.com/j2se/1.5.0/compatibility.html#4959783">moved
to XSLTC</a>. Since this task uses Xalan's redirect
extensions for its internal stylesheet, Ant prior to 1.6.2 didn't support
XSLTC. This means that you have to install <a
href="http://xml.apache.org/xalan-j/">Xalan-J 2</a> in order
to use this task with JDK 1.5 in older versions of Ant.</p>

<p>Starting with Ant 1.6.2 <code>&lt;junitreport&gt;</code>
supports JDK 1.5.</p>

</answer>
</faq>

<faq id="oom-on-mac">
<question>
Ant runs into an infinite loop/throws an OutOufMemoryError
Ant runs into an infinite loop/throws an OutOfMemoryError
when I compile my project under Mac OS X.
</question>



Loading…
Cancel
Save