Index: quickhelp_contributors.xml =================================================================== --- quickhelp_contributors.xml (revision 698811) +++ quickhelp_contributors.xml (working copy) @@ -78,11 +78,24 @@ Subversion version 1.3 or higher
  • - Java SE 5 JDK + Java SE 5 JDK or + Java SE 6 JDK
  • Note

    + You need to set the following environment variables before building: +
    + + JAVA_HOME = your JDK installation directory
    + ANT_HOME = your Ant installation directory
    + ANT_OPTS = -Xmx256m -Xms512m
    +
    + and add following to PATH
    + + %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 -
    +
    • gcc compiler, version 3.3.3 or higher
      @@ -165,6 +184,7 @@
    +

    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
    + 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
    +
    + and add following to PATH environment variable:
    + + %VS.NET_HOME%\Vc7\bin;%VS.NET_HOME%\Common7\IDE
    +

    @@ -278,6 +306,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