| <html> |
| |
| <head> |
| <meta http-equiv="Content-Language" content="en-us"> |
| <title>Platform Issues</title> |
| </head> |
| |
| <h1>Platform Issues</h1> |
| |
| |
| <h2>Unix</h2> |
| |
| <ul> |
| <li> You should use a GNU version of <tt>tar</tt> to untar the ant source tree, |
| 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 |
| tar archive, use the <tt>mode</tt> attribute of <tt><tarfileset></tt> |
| to set the permissions in the tar file. |
| </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. |
| </ul> |
| |
| <h2>Microsoft Windows</h2> |
| |
| 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> |
| All versions of windows are usually case insensitive, although mounted |
| file systems (Unix drives, Clearcase views) can be case sensitive underneath, |
| confusing patternsets. |
| |
| <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. |
| |
| <h2>Apple MacOS X</h2> |
| |
| MacOS X is the first of the Apple platforms that Ant supports completely; |
| it is treated like any other Unix. |
| |
| <h2>Novell Netware</h2> |
| |
| <h2>Other platforms</h2> |
| Support for other platforms is not guaranteed to be complete, as certain |
| techniques to hide platform details from build files need to be written and |
| tested on every particular platform. Contributions in this area are welcome. |
| |
| <hr> |
| <p align="center">Copyright © 2002 Apache Software Foundation. All rights |
| Reserved.</p> |
| </html> |