Index: quickhelp_contributors.xml =================================================================== --- quickhelp_contributors.xml (revision 674706) +++ quickhelp_contributors.xml (working copy) @@ -78,11 +78,24 @@ Subversion version 1.3 or higher
Note
+ You need to set the following environment variables before building:
+
+
+ JAVA_HOME = your JDK installation directory
+ and add following to PATH
+ ANT_HOME = your Ant installation directory
+ ANT_OPTS = -Xmx256m -Xms512m
+
+
+ %JAVA_HOME%\bin;%ANT_HOME%\bin
+
+
If you are working from behind a firewall, you may need to configure
the proxy setting for ant and svn tools.
For the ant tool, set the ANT_OPTS environment
@@ -93,16 +106,18 @@
For the svn tool, follow the instructions appropriate to
the version of the tool you use. For example, edit ~/.subversion/servers
- file for console version of svn.
+ file for console version of svn. On Windows, you can use TortoiseSVN,
+ which is a subversion GUI client, to change the configuration such as proxy settings
Optional (but recommended) prerequisite is an Eclipse Java Compiler (ECJ), version 3.2 or higher. + +
Optional (but recommended) prerequisite is an Eclipse Java Compiler (ECJ), version 3.2 or higher.
You need to download
standalone ecj.jar and put it to ANT_HOME/lib directory.
Alternatively, you can switch to any other Java 1.5 compiler supported by Ant
via overriding hy.javac.compiler property.
+ +
The other prerequisites for building Harmony differ by platform. For examples of platform-specific setup instructions, please see these community maintained @@ -110,27 +125,31 @@ To learn which platforms are currently supported, see the Porting Matrix.
++ Platform Prerequisites +
+| On Windows | -+ | On Linux - | +
|---|---|---|
|
- + |
|
Note:
You have to ensure you properly configured the tools in the user environment,
@@ -173,9 +193,17 @@
contains all of the directories where the executables of the tools
are located and that all of those executables can be successfully invoked
from the command line.
- For example, for using a C++ compiler on Windows you'd typically need to
- launch a specific batch script, such as
- "Visual Studio .NET 2003 Command Prompt", prior to building.
+ For example, for using a C++ compiler of Microsoft Visual Studio.NET on Windows,
+ you should set several user environment variables:
+
+ COMPILER_CFG_SCRIPT = %VS.NET_HOME%\Common7\Tools\vsvars32.bat
+ and add following to PATH environment variable:
+ INCLUDE = %VS.NET_HOME%\SDK\v1.1\include\;%VS.NET_HOME%\Vc7\include;%VS.NET_HOME%\Vc7\PlatformSDK\Include;%VS.NET_HOME%\Vc7\atlmfc\include
+ LIB = %VS.NET_HOME%\SDK\v1.1\Lib\;%VS.NET_HOME%\Vc7\lib;%VS.NET_HOME%\Vc7\PlatformSDK\Lib;%VS.NET_HOME%\Vc7\atlmfc\lib
+
+
+ %VS.NET_HOME%\Vc7\bin;%VS.NET_HOME%\Common7\IDE
+
@@ -272,6 +300,11 @@
operating system.
This recommendation is especially actual if you're building on Windows:
otherwise Ant can crash in obscure way (e.g. with a mysterious InvocationTargetException).
+
+ If you want to build a full debug version Harmony, trunk/build.xml should be modified :
+ line 30 : value='release' to value='debug'
+ alternatively, if you only want to get a debug version DRLVM, only set user environment variable:
+ BUILD_CFG=debug
Because running Ant in the root directory builds the full JDK, it can be inconvenient