You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@ant.apache.org by st...@apache.org on 2003/05/24 02:31:49 UTC
cvs commit: ant/docs/manual platform.html
stevel 2003/05/23 17:31:49
Modified: docs/manual platform.html
Log:
pull in Antoine's comments on cygwin from 20144 as they were too profound to not add to the docs :)
Note also this is my first commit from my new Linux box and SmartCVS, so it may not work first time.
Revision Changes Path
1.7 +28 -2 ant/docs/manual/platform.html
Index: platform.html
===================================================================
RCS file: /home/cvs/ant/docs/manual/platform.html,v
retrieving revision 1.6
retrieving revision 1.7
diff -u -r1.6 -r1.7
--- platform.html 19 Feb 2003 09:23:19 -0000 1.6
+++ platform.html 24 May 2003 00:31:49 -0000 1.7
@@ -15,9 +15,10 @@
if you have downloaded this as a tar file.
</li>
<li> Ant does not preserve file permissions when a file is copied, moved or
-archived. Use <tt><chmod></tt> to set permissions, and when creating a
+archived, because Java does not let it read or write the permissions.
+ Use <tt><chmod></tt> to set permissions, and when creating a
tar archive, use the <tt>mode</tt> attribute of <tt><tarfileset></tt>
-to set the permissions in the tar file.
+to set the permissions in the tar file, or <apply> the real tar program.
</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.
@@ -39,6 +40,31 @@
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.
+
+<h2>Cygwin</h2>
+
+Cygwin is not really 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
+cygwin. See this link :
+<a href="http://www.inonit.com/cygwin/faq/">http://www.inonit.com/cygwin/faq/</a> .
+Only Windows path
+names are supported by JDK and JRE tools under Windows or cygwin. Relative path
+names such as "src/org/apache/tools" are supported, but Java tools do not
+understand /cygdrive/c to mean c:\.
+<p>
+The utility cygpath (used industrially in the ant script to support cygwin) can
+convert cygwin path names to Windows.
+You can use the <exec/> task in ant to convert cygwin paths to Windows path, for
+instance like that :
+<pre>
+<property name="some.cygwin.path" value="/cygdrive/h/somepath"/>
+<exec executable="cygpath" outputproperty="windows.pathname">
+ <arg value="--windows"/>
+ <arg value="${some.cygwin.path}"/>
+</exec>
+<echo message="${windows.pathname}"/>
+</pre>
<h2>Apple MacOS X</h2>