crc's     _              __            _   _    
 _ __ ___| |_ _ __ ___  / _| ___  _ __| |_| |__
| '__/ _ \ __| '__/ _ \| |_ / _ \| '__| __| '_ \
| | |  __/ |_| | | (_) |  _| (_) | |  | |_| | | |
|_|  \___|\__|_|  \___/|_|  \___/|_|   \__|_| |_|
                                          for ilo

Clone The Repository

fossil clone http://fossils.retroforth.org:8000/ilo retro-ilo.fossil
mkdir retro-ilo
cd retro-ilo
fossil open ../retro-ilo.fossil 

Updates

cd retro-ilo
fossil update

Required Files

RetroForth/ilo has three parts: the ilo virtual machine, an image file containing the actual RetroForth language, and a file containing the data blocks available to the system.

+------------+------------------------+
| file       | contains               |
+============+========================+
| ilo.c      | ilo source code        |
| ilo.rom    | retroforth/ilo image   |
| ilo.blocks | standard set of blocks |
+------------+------------------------+

The ilo.rom and ilo.blocks need to be in the current working directory when you start ilo.

Build ilo

The most commonly used implementation of ilo is written in C.

make ilo

If you would prefer to avoid C, several other options (including C#, Go, Kotlin, Nim, Rust, and Swift) are provided. Look at vm/README.txt for details on these.

Run

./ilo

Build The Image

The standard RetroForth image is provided as ilo.rom. If you want to rebuild it, you can run:

make ilo.rom

This is not necessary in most cases, but can be beneficial if you would like to have a system that has additional functionality built in.