💾 Archived View for ilo.retroforth.org › retro-ilo.sh.txt captured on 2023-01-29 at 02:33:10.

View Raw

More Information

-=-=-=-=-=-=-

RetroForth/ilo : Shell Installer / Updater / Launcher
================================================================
This is a small shell script that can setup a local install of
the RetroForth/ilo system. It also handles launching this, and
can update the image and blocks.

Requirements:

- curl
- gunzip
- unix-like host

Obtain:

    curl https://ilo.retroforth.org/retro-ilo.sh -o retro-ilo
    chmod +x retro-ilo

Install the VM, image, and blocks(*):

    ./retro-ilo install

Run:

    ./retro-ilo

Update the image and blocks:

    ./retro-ilo update

Remove:

    ./retro-ilo uninstall

Additional options:

    ./retro-ilo help
================================================================
(*) The default installation uses precompiled binaries for the
    ilo vm. If you prefer to build your own, you can use C or
    Nim. Run one of these instead:

    ./retro-ilo install:c
    ./retro-ilo install:nim

You will need either `nim` or `cc` in your path, along with the
standard headers and development libraries in your system.

You may also need to do this if a precompiled binary is not
available for your system.

The precompiled binaries only use the following system calls or
library functions:

    open
    close
    read
    write
    lseek
    exit

The only files they use are ilo.blocks and ilo.rom in the
current working directory.
================================================================
The installed vm, image, and blocks will be placed in
~/.retro-ilo
================================================================