This tutorial will introduce you to the reproducible computing tool Lir. Before starting, please make sure you have installed all prerequisites and Lir itself.
Clone this repository to your computer, and change to the working directory:
$ git clone https://github.com/borisvassilev/lir-tutorial.git
$ cd lir-tutorial
Now, open the tutorial anagrams.lir.
You must read the literate source file. If you try to read the generated final document, you will not be able to follow.
Read the literate source file provided!
Use Lir to generate the final document!
Run all examples!
(You could, in parallel, open the final document, to be able to see what you should get without actually running Lir on the source file. This is the best way to skim through this tutorial and be left with a faint feeling of dissatisfaction.)
The aim of this tutorial is to introduce you to the Lir syntax, the Lir tools, and best practices for using Lir.
This work was done at the University of Helsinki.
Erkka Valo and Amjad Alkodsi have contributed many suggestions that have considerably improved this tutorial.
The main text of this tutorial a program that can be interpreted by Lir; it is licenced under the terms of the GPL (see COPYING).
Copyright 2016 Boris Vassilev