From 40e8eeaa4f59dd0219a157d4edb1590700cefe3d Mon Sep 17 00:00:00 2001 From: bharathappali Date: Thu, 21 Mar 2019 12:56:03 +0530 Subject: [PATCH] Building.md updated to reflect new changes in build process As the recent changes in OMR made the build process move to `cmake` usage, the current website shows the older build process which uses `run_configure.mk` which might not be valid in future. It would also be useful to have detailed process of Cmake which is documented in this [file] (https://github.com/eclipse/omr/blob/master/doc/BuildingWithCMake.md) Signed-off-by: bharathappali --- guide/building.md | 40 +++++++++++++++++++++++++++++----------- 1 file changed, 29 insertions(+), 11 deletions(-) diff --git a/guide/building.md b/guide/building.md index 4a82474..d0bc2ef 100755 --- a/guide/building.md +++ b/guide/building.md @@ -29,23 +29,41 @@ lang: en # Building -### How to build a standalone Eclipse OMR with a basic configuration +### How to Build a Standalone Eclipse OMR with a basic configuration -To build a standalone Eclipse OMR, run the following commands from the top of the source tree. The top of the Eclipe OMR source tree is the directory that contains `run_configure.mk`. Note that on Windows systems, you must use a shell script interpreter such as bash to run the configure command. +To build standalone Eclipse OMR, run the following commands from the root of the +source tree. - # Generate autotools makefiles with SPEC-specific presets - make -f run_configure.mk SPEC=linux_x86-64 OMRGLUE=./example/glue + # Create a build directory and cd into it + mkdir build + cd build - # Build + #generate the build system using cmake + cmake .. + + # Build (you can optionally compile in parallel by adding -j to the make command) make - # Run tests (note that no contribution should cause new test failures in "make test") - make test + # Run tests (note that no contribution should cause new test failures in testing). + # Use the `-V` option to see verbose output from the tests. + ctest [-V] + +### Building Eclipse OMR on Windows using Visual Studio -Run the following command for a list of configure makefile targets: +The following instructions below demonstrate the steps to build Eclipse OMR on Windows +using Visual Studios. In the example Visual Studio 11 2012 Win64 is being used. +You can easily switch this to the version of Visual Studio you would like to use. - make -f run_configure.mk help + # Create a build directory and cd into it + mkdir build + cd build -Run the following command for a list of build targets: + #generate the build system using cmake + cmake -G "Visual Studio 11 2012 Win64" .. + + # Build + cmake --build . + + # Run tests (note that no contribution should cause new test failures in "make test") + ctest - make help