Linux

This page provides a tutorial on how to build the LLVM frontend for the Oberon programming language on Linux. Since this project uses CMake to manage its build process, it is recommended to use the CLion IDE under Linux, which uses CMakeLists.txt natively as its project model. Furthermore, the GNU Compiler Collection (GCC) is assumed to be used to compile the frontend.

[[TOC]]

Prerequisites

Before the Oberon LLVM frontend can be built, the Boost libraries (algorithm, convert, filesystem, and program-options components) and the LLVM Compiler Infrastructure (core libraries and tools) need to be installed. It is recommended to use the Advanced Package Tool (APT) to accomplish this. Note that this tutorial assumes that standard build tools such as git, make, and cmake are available on the system used to build the frontend. Otherwise, these tools can also be installed using APT.

Installing Boost

sudo apt install libboost-all-dev

Installing LLVM

sudo apt install llvm-dev

Building the Frontend

The LLVM frontend for the Oberon programming language on Linux can be built from the command line or using an IDE that supports CMake projects such as CLion.

Begin by cloning the project repository from GitLab.

git clone https://gitlab.inf.uni-konstanz.de/michael.grossniklaus/oberon-lang.git

Command Line

1. Navigate to the oberon-lang directory and create a new build directory. Then, navigate to the newly created build directory.

   cd oberon-lang
   

   mkdir build
   

   cd build
   

2. Invoke CMake to set up the build toolchain and generate the required build files.

   cmake .. -G "Unix Makefiles"
   

3. As a result, CMake will generate Makefiles that can be used to build the frontend.

   make
   

After the build successfully terminates, the oberon-lang binary can be found in the oberon-lang/build/src subdirectory.

CLion

1. Start CLion and select Open in the welcome dialog.

2. Navigate to the oberon-lang folder to which you cloned the project repository and click Open.

3. Once the project is open, build it using the Build → Build Project menu.

Once the build successfully terminates, the oberon-lang executable can be found in the oberon-lang/cmake-build-debug/src or oberon-lang/cmake-build-release/src subdirectory.