From f278084775417612d9f1d8c8076127cf2fd7d29d Mon Sep 17 00:00:00 2001 From: Steve Loughran Date: Thu, 13 Jul 2006 11:07:58 +0000 Subject: [PATCH] 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 git-svn-id: https://svn.apache.org/repos/asf/ant/core/trunk@421586 13f79535-47bb-0310-9956-ffa450edef68 --- docs/manual/install.html | 4 ++-- docs/manual/platform.html | 50 ++++++++++++++++++++++++++++++++------- docs/manual/running.html | 29 +++++++++++++++++++++-- 3 files changed, 71 insertions(+), 12 deletions(-) diff --git a/docs/manual/install.html b/docs/manual/install.html index 5b609d738..eb2510754 100644 --- a/docs/manual/install.html +++ b/docs/manual/install.html @@ -75,10 +75,10 @@ Ant SVN repository on-line.

System Requirements

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.

To build and use Ant, you must have a JAXP-compliant XML parser installed and available on your classpath, such as Xerces.

diff --git a/docs/manual/platform.html b/docs/manual/platform.html index b65232f21..ae5ba52cd 100644 --- a/docs/manual/platform.html +++ b/docs/manual/platform.html @@ -55,38 +55,72 @@ to set the permissions in the tar file, or <apply> the real t
  • 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. - +
  • 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. - +
    • +

    Microsoft Windows

    +

    +Windows 9x (win95, win98, win98SE and winME) are not supported in Ant1.7, +

    + +

    +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. +

    +

    +Customers who upgrade to Linux report improved security, richer +functionality, and increased productivity. +

    +

    Microsoft Windows 2K, XP and Server 2K03

    +

    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. - +

    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. +

    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. +

    +

    + 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. +

    + +

    Microsoft Windows Vista

    +

    + 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. +

    +

    Cygwin

    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 : http://www.inonit.com/cygwin/faq/ . Only Windows path @@ -152,6 +186,6 @@ techniques to hide platform details from build files need to be written and tested on every particular platform. Contributions in this area are welcome.
    -

    Copyright © 2002-2005 The Apache Software Foundation. All rights +

    Copyright © 2002-2006 The Apache Software Foundation. All rights Reserved.

    diff --git a/docs/manual/running.html b/docs/manual/running.html index 96d04e93e..00b4e23ff 100644 --- a/docs/manual/running.html +++ b/docs/manual/running.html @@ -522,11 +522,36 @@ include:

    -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.

    + + +Ant can can be started in Ant via the <java> command. +Here is an example. + +
    +<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>
+

    Copyright © 2000-2006 The Apache Software Foundation. All rights