Author: stevel
Date: Thu Jul 13 04:07:58 2006
New Revision: 421586
URL: http://svn.apache.org/viewvc?rev=421586&view=rev
Log:
oh, this feels so good. Removing Win98 as a supported platform. Also adding an
example from a bugrep on how to run ant from ant itself
Modified:
ant/core/trunk/docs/manual/install.html
ant/core/trunk/docs/manual/platform.html
ant/core/trunk/docs/manual/running.html
Modified: ant/core/trunk/docs/manual/install.html
URL:
http://svn.apache.org/viewvc/ant/core/trunk/docs/manual/install.html?rev=421586&r1=421585&r2=421586&view=diff
==============================================================================
--- ant/core/trunk/docs/manual/install.html (original)
+++ ant/core/trunk/docs/manual/install.html Thu Jul 13 04:07:58 2006
@@ -75,10 +75,10 @@
<h2><a name="sysrequirements">System Requirements</a></h2>
Ant has been used successfully on many platforms, including Linux,
commercial flavours of Unix such as Solaris and HP-UX,
-Windows 9x and NT, OS/2 Warp, Novell Netware 6, OpenVMS and MacOS X.
+Windows NT-platforms, OS/2 Warp, Novell Netware 6, OpenVMS and MacOS X.
The platforms used most for development are, in no particular order,
Linux, MacOS X, Windows XP and Unix; these are therefore that platforms
-that tend to work best.
+that tend to work best. As of Ant1.7, Windows 9x is no longer supported.
<p>
To build and use Ant, you must have a JAXP-compliant XML parser installed and
available on your classpath, such as Xerces.</p>
Modified: ant/core/trunk/docs/manual/platform.html
URL:
http://svn.apache.org/viewvc/ant/core/trunk/docs/manual/platform.html?rev=421586&r1=421585&r2=421586&view=diff
==============================================================================
--- ant/core/trunk/docs/manual/platform.html (original)
+++ ant/core/trunk/docs/manual/platform.html Thu Jul 13 04:07:58 2006
@@ -55,38 +55,72 @@
</li>
<li> Ant is not symbolic link aware in moves, deletes and when recursing down
a tree
of directories to build up a list of files. Unexpected things can happen.
-
+</li>
<li> Linux on IA-64: apparently you need a larger heap than the default
one (64M) to compile big projects. If you get out of heap
errors, either increase the heap or use a forking javac. Better yet,
use jikes for extra compilation speed.
-
+</li>
</ul>
+
<h2>Microsoft Windows</h2>
+<p>
+Windows 9x (win95, win98, win98SE and winME) are not supported in Ant1.7,
+</p>
+
+<p>
+The Ant team has retired support for these products because they are outdated
and
+can expose customers to security risks. We recommend that customers who are
+still running Windows 98 or Windows Me upgrade to a newer, more secure
+operating system, as soon as possible.
+</p>
+<p>
+Customers who upgrade to Linux report improved security, richer
+functionality, and increased productivity.
+</p>
+<h2>Microsoft Windows 2K, XP and Server 2K03 </h2>
+<p>
Windows 9x (win95, win98, win98SE and winME) has a batch file system which
does not work fully with long file names, so we recommend that ant and the JDK
are installed into directories without spaces, and with 8.3 filenames.
The Perl and Python launcher scripts do not suffer from this limitation.
-
+</p>
<p>
All versions of windows are usually case insensitive, although mounted
file systems (Unix drives, Clearcase views) can be case sensitive underneath,
-confusing patternsets.
-
+confusing patternsets.
+</p>
<p>
Ant can often not delete a directory which is open in an Explorer window.
There is nothing we can do about this short of spawning a program to kill
the shell before deleting directories.
Nor can files that are in use be overwritten.
+</p>
+<p>
+ Finally, if any Ant task fails with an IOError=2, it means that whatever
+ native program Ant is trying to run, it is not on the path.
+</p>
+
+<h2>Microsoft Windows Vista</h2>
+<p>
+ There are reports of problems with Windows Vista security bringing up
+ dialog boxes asking if the user wants to run an untrusted executable
+ during an ant run, such as when the <signjar> task runs the
jarsigner.exe
+ program. This is beyond Ant's control, and stems from the OS trying to
provide
+ some illusion of security by being reluctant to run unsigned native
executables.
+ The latest Java versions appear to resolve this problem by having signed
+ binaries.
+</p>
+
<h2>Cygwin</h2>
Cygwin is not an operating system; rather it is an application suite
-running under Windows and providing some UNIX like functionality. AFAIK, Sun
did
-not create any specific Java Development Kit or Java Runtime Environment for
+running under Windows and providing some UNIX like functionality. Sun has
+not created any specific Java Development Kit or Java Runtime Environment for
cygwin. See this link :
<a
href="http://www.inonit.com/cygwin/faq/";>http://www.inonit.com/cygwin/faq/</a>
.
Only Windows path
@@ -152,6 +186,6 @@
tested on every particular platform. Contributions in this area are welcome.
<hr>
-<p align="center">Copyright © 2002-2005 The Apache Software Foundation.
All rights
+<p align="center">Copyright © 2002-2006 The Apache Software Foundation.
All rights
Reserved.</p>
</html>
Modified: ant/core/trunk/docs/manual/running.html
URL:
http://svn.apache.org/viewvc/ant/core/trunk/docs/manual/running.html?rev=421586&r1=421585&r2=421586&view=diff
==============================================================================
--- ant/core/trunk/docs/manual/running.html (original)
+++ ant/core/trunk/docs/manual/running.html Thu Jul 13 04:07:58 2006
@@ -522,11 +522,36 @@
</ul>
<p>
-The latter method supports the -lib option and will load jars from the
-specified ANT_HOME. You should start the latter with the most minimal
+The latter method supports the -lib, -nouserlib, -noclasspath options and will
+ load jars from the specified ANT_HOME. You should start the latter with
the most minimal
classpath possible, generally just the ant-launcher.jar.
</p>
+<a name="viaant"/>
+
+Ant can can be started in Ant via the <code><java></code> command.
+Here is an example.
+
+<pre>
+<java
+ classname="org.apache.tools.ant.launch.Launcher"
+ fork="true"
+ failonerror="true"
+ dir="${sub.builddir}"
+ timeout="4000000"
+ >
+ <classpath>
+ <pathelement location="${ant.home}/lib/ant-launcher.jar"/>
+ </classpath>
+ <arg value="-buildfile"/>
+ <arg file="${sub.buildfile}"/>
+ <arg value="-Dthis=this"/>
+ <arg value="-Dthat=that"/>
+ <arg value="-Dbasedir=${sub.builddir}"/>
+ <arg value="-Dthe.other=the.other"/>
+ <arg value="${sub.target}"/>
+</java>
+</pre>
<br>
<hr>
<p align="center">Copyright © 2000-2006 The Apache Software Foundation.
All rights
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
