From 3352f53d7d47ac6c14a6f71789970c2fb5b8f6bf Mon Sep 17 00:00:00 2001 From: Conor MacNeill Date: Sat, 1 Feb 2003 14:21:27 +0000 Subject: [PATCH] Additional info about running under Exec and Win9X/ME systems PR: 13524 git-svn-id: https://svn.apache.org/repos/asf/ant/core/trunk@273949 13f79535-47bb-0310-9956-ffa450edef68 --- docs/manual/CoreTasks/exec.html | 7 +++++++ docs/manual/install.html | 19 ++++++++++++++++--- docs/manual/running.html | 12 ++++++++++++ docs/manual/runninglist.html | 1 + 4 files changed, 36 insertions(+), 3 deletions(-) diff --git a/docs/manual/CoreTasks/exec.html b/docs/manual/CoreTasks/exec.html index 071656a8e..88bd86670 100644 --- a/docs/manual/CoreTasks/exec.html +++ b/docs/manual/CoreTasks/exec.html @@ -12,6 +12,13 @@

Executes a system command. When the os attribute is specified, then the command is only executed when Ant is run on one of the specified operating systems.

+ +

Cygwin Users

+

In general the <exec> task will not userstand paths such as /bin/sh for +the executable parameter. This is because the Java VM in which Ant is running is a +Windows executable and is not aware of Cygwin conventions. +

+

Parameters

diff --git a/docs/manual/install.html b/docs/manual/install.html index 19b4ce4e8..e7eb11dca 100644 --- a/docs/manual/install.html +++ b/docs/manual/install.html @@ -95,21 +95,34 @@ file there. This directory will be known as ANT_HOME.
+ + + +
- Windows 95 and Windows 98 Note: + Windows 95, Windows 98 & Windows ME Note:
  On these systems, the script used to launch Ant will have -problems if ANT_HOME is a long filename. This is due to +problems if ANT_HOME is a long filename (i.e. a filename which is not +of the format known as "8.3"). This is due to limitations in the OS's handling of the "for" batch-file statement. It is recommended, therefore, that Ant be -installed in a short path, such as C:\Ant. +installed in a short, 8.3 path, such as C:\Ant. +
  +

On these systems you will also need to configure more environment + space to cater for the environment variables used in the Ant lauch script. + To do this, you will need to add or update the following line in + the config.sys file +

+

shell=c:\command.com c:\ /p /e:32768
+

Setup

Before you can run ant there is some additional set up you will need to do:

diff --git a/docs/manual/running.html b/docs/manual/running.html index 4886ad3bc..4292fe9e3 100644 --- a/docs/manual/running.html +++ b/docs/manual/running.html @@ -160,6 +160,18 @@ set):

to find, even if the file is called build.xml. +

Cygwin Users

+

The Unix launch script that come with Ant works correctly with Cygwin. You +should not have any problems launching Ant form the Cygwin shell. It is important +to note however, that once Ant is runing it is part of the JDK which operates as +a native Windows application. The JDK is not a Cygwin executable, and it therefore +has no knowledge of the Cygwin paths, etc. In particular when using the <exec> +task, executable names such as "/bin/sh" will not work, even though these +work from the Cygwin shell from which Ant was launched. You can use an executable +name such as "sh" and rely on that command being available in the Windows +path. +

+

Running Ant via Java

If you have installed Ant in the do-it-yourself way, Ant can be started with:

diff --git a/docs/manual/runninglist.html b/docs/manual/runninglist.html index 62fbf5295..e9ad3ec27 100644 --- a/docs/manual/runninglist.html +++ b/docs/manual/runninglist.html @@ -15,6 +15,7 @@   Options
  Files
  Environment Variables
+  Cygwin Users
Running Ant via Java