# HG changeset patch # User Thomas Wuerthinger # Date 1391694636 -3600 # Node ID 258a09b6449b886c568b94032745982d86f9cd5d # Parent 4c2f5b7deb6c9c36a0e8d423be4afdba8de7b228 Change AUTHORS, CHANGELOG, and README file from HTML to Markdown. diff -r 4c2f5b7deb6c -r 258a09b6449b AUTHORS.html --- a/AUTHORS.html Wed Feb 05 14:59:55 2014 +0100 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,27 +0,0 @@ -

Graal Authors

- -The GraalVM is based on the source code of HotSpot. The following authors have contributed to the Graal-specific part of the source base: - - diff -r 4c2f5b7deb6c -r 258a09b6449b AUTHORS.md --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/AUTHORS.md Thu Feb 06 14:50:36 2014 +0100 @@ -0,0 +1,25 @@ +# Graal Authors + +The GraalVM is based on the source code of HotSpot. The following authors have contributed to the Graal-specific part of the source base: + +* Tom Deneau (tdeneau) +* Gilles Duboscq (gdub) +* Matthias Grimmer (mgrimmer) +* Peter Hofer +* Christian Haeubl (chaeubl) +* Michael Haupt (mhaupt) +* Christian Humer (chumer) +* Morris Meyer (morris) +* Roland Schatz +* Doug Simon (dnsimon) +* Lukas Stadler (lstadler) +* Roland Schatz (rschatz) +* Alexander Stipsits +* Katrin Strassl +* Christian Thalinger (twisti) +* Vasanth Venkatachalam (vvenkat) +* Christian Wimmer (cwimmer) +* Christian Wirth (cwirth) +* Andreas Woess (aw) +* Thomas Wuerthinger (thomaswue) +* Bharadwaj Yadavalli (bharadwaj) diff -r 4c2f5b7deb6c -r 258a09b6449b CHANGELOG.html --- a/CHANGELOG.html Wed Feb 05 14:59:55 2014 +0100 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,34 +0,0 @@ -

GraalVM Changelog

- -

Tip

- -

Version 0.1

- diff -r 4c2f5b7deb6c -r 258a09b6449b CHANGELOG.md --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/CHANGELOG.md Thu Feb 06 14:50:36 2014 +0100 @@ -0,0 +1,19 @@ +# GraalVM Changelog + +## Tip + +* Graal + * ... +* Truffle + * ... + +## Version 0.1 +5-Feb-2014, [Repository Revision](http://hg.openjdk.java.net/graal/graal/rev/b124e22eb772) +* Graal + * Initial version of a dynamic Java compiler written in Java. + * Support for multiple co-existing GPU backends ([GRAAL-1](https://bugs.openjdk.java.net/browse/GRAAL-1)). + * Fixed a compiler bug when running RuneScape ([Graal-7](https://bugs.openjdk.java.net/browse/GRAAL-7)). + * Bug fixes ([GRAAL-4](https://bugs.openjdk.java.net/browse/GRAAL-4), [GRAAL-5](https://bugs.openjdk.java.net/browse/GRAAL-5)). +* Truffle + * Initial version of a multi-language framework on top of Graal. + * Update of the [Truffle inlining API](http://mail.openjdk.java.net/pipermail/graal-dev/2014-January/001516.html). diff -r 4c2f5b7deb6c -r 258a09b6449b README.html --- a/README.html Wed Feb 05 14:59:55 2014 +0100 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,81 +0,0 @@ -

Building Graal

-

There is a Python script in mxtool/mx.py that simplifies working with the code -base. It requires Python 2.7. While you can run this script by using an absolute path, -it's more convenient to add graal/mxtool to your PATH environment variable so that the -'mx' helper script can be used. The following instructions in this file assume this -setup.

- -

Building both the Java and C++ source code comprising the Graal VM -can be done with the following simple command.

- -
-% mx build
-
- -

There are a number of VM configurations supported by mx which can -be explicitly specified using the --vm option. However, you'll typically -want one of these VM configurations:

- -
    -
  1. The 'server' configuration is a standard HotSpot VM that includes the - runtime support for Graal but uses the existing compilers for normal - compilation (e.g., when the interpreter threshold is hit for a method). - Compilation with Graal is only done by explicit requests to the - Graal API. This is how Truffle uses Graal.
    2. - -
  2. The 'graal' configuration is a VM where all compilation is performed - by Graal and no other compilers are built into the VM binary. This - VM will bootstrap Graal itself at startup unless the -XX:-BootstrapGraal - VM option is given.
    3. -
- -

Unless you use the --vm option with the build command, you will be presented -with a dialogue to choose one of the above VM configurations for the build -as well as have the option to make it your default for subsequent commands -that need a VM specified.

- -

To build the debug or fastdebug builds:

- -
-% mx --vmbuild debug build
-% mx --vmbuild fastdebug build
-
- -

Running Graal

- -

To run the VM, use 'mx vm' in place of the standard 'java' command:

- -
-% mx vm ...
-
- -

To select the fastdebug or debug builds of the VM:

- -
-% mx --vmbuild fastdebug vm ...
-% mx --vmbuild debug vm ...
-
- -

Other VM Configurations

- -

In addition to the VM configurations described above, there are -VM configurations that omit all VM support for Graal:

- -
-% mx --vm server-nograal build
-% mx --vm server-nograal vm -version
-java version "1.7.0_25"
-Java(TM) SE Runtime Environment (build 1.7.0_25-b15)
-OpenJDK 64-Bit Server VM (build 25.0-b43-internal, mixed mode)
-
- -
-% mx --vm client-nograal build
-% mx --vm client-nograal vm -version
-java version "1.7.0_25"
-Java(TM) SE Runtime Environment (build 1.7.0_25-b15)
-OpenJDK 64-Bit Cleint VM (build 25.0-b43-internal, mixed mode)
-
- -

These configurations aim to match as closely as possible the -VM(s) included in the OpenJDK binaries one can download.

diff -r 4c2f5b7deb6c -r 258a09b6449b README.md --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/README.md Thu Feb 06 14:50:36 2014 +0100 @@ -0,0 +1,82 @@ +## Building Graal + +There is a Python script in mxtool/mx.py that simplifies working with the code +base. It requires Python 2.7. While you can run this script by using an absolute path, +it's more convenient to add graal/mxtool to your PATH environment variable so that the +'mx' helper script can be used. The following instructions in this file assume this +setup. + +Building both the Java and C++ source code comprising the Graal VM +can be done with the following simple command. + +``` +% mx build +``` + +There are a number of VM configurations supported by mx which can +be explicitly specified using the --vm option. However, you'll typically +want one of these VM configurations: + +1. The 'server' configuration is a standard HotSpot VM that includes the + runtime support for Graal but uses the existing compilers for normal + compilation (e.g., when the interpreter threshold is hit for a method). + Compilation with Graal is only done by explicit requests to the + Graal API. This is how Truffle uses Graal. + +2. The 'graal' configuration is a VM where all compilation is performed + by Graal and no other compilers are built into the VM binary. This + VM will bootstrap Graal itself at startup unless the -XX:-BootstrapGraal + VM option is given. + +Unless you use the --vm option with the build command, you will be presented +with a dialogue to choose one of the above VM configurations for the build +as well as have the option to make it your default for subsequent commands +that need a VM specified. + +To build the debug or fastdebug builds: + +``` +% mx --vmbuild debug build +% mx --vmbuild fastdebug build +``` + +## Running Graal + +To run the VM, use 'mx vm' in place of the standard 'java' command: + +``` +% mx vm ... +``` + +To select the fastdebug or debug builds of the VM: + +``` +% mx --vmbuild fastdebug vm ... +% mx --vmbuild debug vm ... +``` + +## Other VM Configurations + +In addition to the VM configurations described above, there are +VM configurations that omit all VM support for Graal: + +``` +% mx --vm server-nograal build +% mx --vm server-nograal vm -version +java version "1.7.0_25" +Java(TM) SE Runtime Environment (build 1.7.0_25-b15) +OpenJDK 64-Bit Server VM (build 25.0-b43-internal, mixed mode) +``` + +``` +% mx --vm client-nograal build +% mx --vm client-nograal vm -version +java version "1.7.0_25" +Java(TM) SE Runtime Environment (build 1.7.0_25-b15) +OpenJDK 64-Bit Cleint VM (build 25.0-b43-internal, mixed mode) +``` + +These configurations aim to match as closely as possible the +VM(s) included in the OpenJDK binaries one can download. + No newline at end of file +