============================
Installing the ULM Generator						[TOC]
============================

We will generate a ULM (Ulm Lecture Machine) virtual machine from a description
of an ISA (Instruction Set Architecture). For this machine also a debugger can
be generated if a working installation of the __FinalCut library__ is
available.

For WSL Users
=============
First install the packages `autoconf`, `libtool`, `autoconf-archive`, `make`,
`g++`, `pkg-config`, `libncurses5-dev`.


Installing the FinalCut Library
===============================
Install the library with the following commands:

---- CODE (type=txt) --------------------------------------
git clone https://github.com/gansm/finalcut.git
cd finalcut
autoreconf --install --force
./configure --prefix=/usr/local
make
sudo make install
-----------------------------------------------------------


Installing the ULM Generator
============================
Install the generator with the following commands:

---- CODE (type=txt) --------------------------------------
git clone https://github.com/michael-lehn/ulm-generator.git
cd ulm-generator
make
-----------------------------------------------------------


Updating a git Repository in General
====================================
With `git clone ...` you cloned, i.e. downloaded a repository. One for the
`finalcut` library and one for the `ulm-generator`. Often developers make
changes to that repositories and you want to obtain these updates.

There two ways to get the updates:

- Delete the old repository and clone it again.
- Download just the changes the changes with `git pull`. If there are no updates
  available then you get an according message and that's it.

Using the `git pull` alternative is obviously more elegant. You are saving
bandwidth. But there are other (ground shaking and mind blowing) advantages of
using `__git__` that we might discuss a bit in class.


Updating finalcut
-----------------
Change into the `finalcut` directory and run the following commands:

---- CODE (type=txt) --------------------------------------
git pull
make
sudo make install
-----------------------------------------------------------

Updating ulm-generator
----------------------
Change into the `ulm-generator` directory and run the following commands:

---- CODE (type=txt) --------------------------------------
git pull
make
-----------------------------------------------------------


:links: FinalCut library -> https://github.com/gansm/finalcut
	git -> https://en.wikipedia.org/wiki/Git