conor 2003/02/01 06:21:27
Modified: docs/manual install.html running.html runninglist.html
docs/manual/CoreTasks exec.html
Log:
Additional info about running under Exec and Win9X/ME systems
PR: 13524
Revision Changes Path
1.43 +16 -3 jakarta-ant/docs/manual/install.html
Index: install.html
===================================================================
RCS file: /home/cvs/jakarta-ant/docs/manual/install.html,v
retrieving revision 1.42
retrieving revision 1.43
diff -u -w -u -r1.42 -r1.43
--- install.html 28 Jan 2003 09:03:52 -0000 1.42
+++ install.html 1 Feb 2003 14:21:26 -0000 1.43
@@ -95,21 +95,34 @@
<table width="80%">
<tr>
<td colspan="2">
- <b>Windows 95 and Windows 98 Note:</b>
+ <b>Windows 95, Windows 98 & Windows ME Note:</b>
</td>
</tr>
<tr>
<td width="5%"> </td>
<td><i>
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 <code>"for"</code>
batch-file statement. It is recommended, therefore, that Ant be
-installed in a <b>short</b> path, such as C:\Ant.</i>
+installed in a <b>short</b>, 8.3 path, such as C:\Ant. </i>
+ </td>
+</tr>
+<tr>
+ <td width="5%"> </td>
+ <td>
+ <p>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 <code>config.sys</code> file
+ </p>
+ <p><code>shell=c:\command.com c:\ /p /e:32768</code></p>
</td>
</tr>
</table>
+<h3>Setup</h3>
<p>
Before you can run ant there is some additional set up you
will need to do:</p>
1.18 +12 -0 jakarta-ant/docs/manual/running.html
Index: running.html
===================================================================
RCS file: /home/cvs/jakarta-ant/docs/manual/running.html,v
retrieving revision 1.17
retrieving revision 1.18
diff -u -w -u -r1.17 -r1.18
--- running.html 3 Sep 2002 15:24:07 -0000 1.17
+++ running.html 1 Feb 2003 14:21:26 -0000 1.18
@@ -160,6 +160,18 @@
to find, even if the file is called <code>build.xml</code>.
</ul>
+<h2><a name="cygwin">Cygwin Users</a></h2>
+<p>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.
+</p>
+
<h2><a name="viajava">Running Ant via Java</a></h2>
<p>If you have installed Ant in the do-it-yourself way, Ant can be started
with:</p>
1.3 +1 -0 jakarta-ant/docs/manual/runninglist.html
Index: runninglist.html
===================================================================
RCS file: /home/cvs/jakarta-ant/docs/manual/runninglist.html,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -w -u -r1.2 -r1.3
--- runninglist.html 20 Feb 2002 01:16:20 -0000 1.2
+++ runninglist.html 1 Feb 2003 14:21:26 -0000 1.3
@@ -15,6 +15,7 @@
<a href="running.html#options">Options</a><br>
<a href="running.html#files">Files</a><br>
<a href="running.html#envvars">Environment Variables</a><br>
+ <a href="running.html#cygwin">Cygwin Users</a><br>
<a href="running.html#viajava">Running Ant via Java</a><br>
</body>
1.21 +7 -0 jakarta-ant/docs/manual/CoreTasks/exec.html
Index: exec.html
===================================================================
RCS file: /home/cvs/jakarta-ant/docs/manual/CoreTasks/exec.html,v
retrieving revision 1.20
retrieving revision 1.21
diff -u -w -u -r1.20 -r1.21
--- exec.html 30 Jan 2003 09:09:53 -0000 1.20
+++ exec.html 1 Feb 2003 14:21:27 -0000 1.21
@@ -12,6 +12,13 @@
<p>Executes a system command. When the <i>os</i> attribute is specified, then
the command is only executed when Ant is run on one of the specified
operating
systems.</p>
+
+<h4>Cygwin Users</h4>
+<p>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.
+</p>
+
<h3>Parameters</h3>
<table border="1" cellpadding="2" cellspacing="0">
<tr>
