cvs commit: ant/docs/manual platform.html
stevel 2004/11/11 07:49:14 Modified:docs/manual platform.html Log: Comments about Java versions Revision ChangesPath 1.10 +33 -1 ant/docs/manual/platform.html Index: platform.html === RCS file: /home/cvs/ant/docs/manual/platform.html,v retrieving revision 1.9 retrieving revision 1.10 diff -u -r1.9 -r1.10 --- platform.html 3 Aug 2004 23:12:58 - 1.9 +++ platform.html 11 Nov 2004 15:49:14 - 1.10 @@ -7,6 +7,37 @@ h1Platform Issues/h1 +h2Java versions/h2 +h3Java 1.5/h3 + +You may need a bigger stack than default, especially if you are using the built in +XSLT engine. We recommend you use Apache Xalan; indeed, some tasks (JUnit report in XML, +for example) may not work against the shipping XSL engine. + +h3Java 1.2/h3 + + +You may sometimes see messages like +pre +A nonfatal internal JIT (3.10.107(x)) error 'chgTarg: Conditional' has +occurred in : + 'org/apache/tools/ant/Project.addReference +(Ljava/lang/String;Ljava/lang/Object;)V': Interpreting method. + Please report this error in detail to + http://java.sun.com/cgi-bin/bugreport.cgi +/pre +These are caused by subtle incompatibilities between the Java1.4+ compiled +release; bugs in the Java runtime that Sun won't fix. Possible solutions:- +ol +liUpgrade your JVM. +liRecompile Ant on a Java1.2 machine +liAdd tt-Djava.compiler=NONE/tt to +the value of your ANT_OPTS environment variable. This turns the JIT off. +liIgnore the messages. +/ol + + + h2Unix and Linux/h2 @@ -47,7 +78,8 @@ 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. +the shell before deleting directories. +Nor can files that are in use be overwritten. h2Cygwin/h2 - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: ant/docs/manual platform.html
stevel 2004/08/03 16:12:58
Modified:docs/manual platform.html
Log:
little known facts about IA64. 64 bit pointers mean you run out heap twice as
fast.
Revision ChangesPath
1.9 +17 -4 ant/docs/manual/platform.html
Index: platform.html
===
RCS file: /home/cvs/ant/docs/manual/platform.html,v
retrieving revision 1.8
retrieving revision 1.9
diff -u -r1.8 -r1.9
--- platform.html 9 Feb 2004 21:50:05 - 1.8
+++ platform.html 3 Aug 2004 23:12:58 - 1.9
@@ -8,11 +8,12 @@
h1Platform Issues/h1
-h2Unix/h2
+h2Unix and Linux/h2
ul
-li You should use a GNU version of tttar/tt to untar the ant source
tree,
-if you have downloaded this as a tar file.
+li You should use a GNU version of tttar/tt to untar the Apache
+Ant source tree, if you have downloaded this as a tar file. If you get
+wierd errors about missing files, this is the problem.
/li
li Ant does not preserve file permissions when a file is copied, moved or
archived, because Java does not let it read or write the permissions.
@@ -22,6 +23,13 @@
/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.
+
+li 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.
+
+
/ul
h2Microsoft Windows/h2
@@ -43,7 +51,7 @@
h2Cygwin/h2
-Cygwin is not really an operating system; rather it is an application suite
+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
cygwin. See this link :
@@ -65,6 +73,11 @@
lt;/execgt;
lt;echo message=quot;${windows.pathname}quot;/gt;
/pre
+
+We get lots of support calls from Cygwin users. Either it is incredibly
+popular, or it is trouble. If you do use it, remember that Java is a
+Windows application, so Ant is running in a Windows process, not a
+Cygwin one. This will save us having to mark your bug reports as invalid.
h2Apple MacOS X/h2
-
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
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 ChangesPath
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 - 1.6
+++ platform.html 24 May 2003 00:31:49 - 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 ttlt;chmodgt;/tt to set permissions, and when creating a
+archived, because Java does not let it read or write the permissions.
+ Use ttlt;chmodgt;/tt to set permissions, and when creating a
tar archive, use the ttmode/tt attribute of ttlt;tarfilesetgt;/tt
-to set the permissions in the tar file.
+to set the permissions in the tar file, or lt;applygt; 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.
+
+h2Cygwin/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
+lt;property name=quot;some.cygwin.pathquot;
value=quot;/cygdrive/h/somepathquot;/gt;
+lt;exec executable=quot;cygpathquot;
outputproperty=quot;windows.pathnamequot;gt;
+ lt;arg value=quot;--windowsquot;/gt;
+ lt;arg value=quot;${some.cygwin.path}quot;/gt;
+lt;/execgt;
+lt;echo message=quot;${windows.pathname}quot;/gt;
+/pre
h2Apple MacOS X/h2
