inferno: setup purgatorio on debian

Achtung

This page assumes you are on Debian. You may have luck with other distributions, but installing the i386 dependencies is likely to be a different process. It is assumed you already have a basic development environment (e.g. apt install build-essential on Debian).

Enable i386 architecture and install dependencies

dpkg --add-architecture i386
apt update
apt install libx11-dev:i386
apt install libxext-dev:i386

Grab a copy of purgatorio

Git
- git clone https://github.com/9mirrors/purgatorio
Mercurial
- hg clone http://code.9front.org/hg/purgatorio
After cloning, cd purgatorio.

Setup `mkconfig`

Change ROOT to where you have purgatorio cloned.
- In my case, I have purgatorio in ~/.local, so ROOT is set to $HOME/.local/purgatorio.

Set PATH

export PATH=$PATH:$(pwd)/Linux/386/bin

Make mk and install

./makemk.sh
mkdirs
mk nuke
mk install

./makemk.sh builds mk, needed to actually build purgatorio.
mkdirs creates necessary directories.
mk nuke cleans everything up first.
mk install builds and installs purgatorio.

Create home folder

cp -r usr/inferno usr/$USER

`emu` alias

In your shell's profile/rc, it might be a good idea to add an alias to run emu as your user with the options you'd like.
- Example: alias purg='PATH=$HOME/.local/purgatorio/Linux/386/bin emu -r$HOME/.local/purgatorio -c1 /dis/sh.dis -c "wm/wm wm/logon -u $USER"'.
- -c1 enables the JIT.
- You can add options such as -g1366x768 after emu to change the resolution.

`emu` script

You may also wish to use a script instead of an alais so you can pass options to emu at runtime.
- Example: echo PATH=\$HOME/Projects/purgatorio/Linux/386/bin emu \$* -r\$HOME/Projects/purgatorio -c1 /dis/sh.dis -c "wm/wm wm/logon -u \$USER" > purg && chmod +x purg.
  - This way, you could run ./purg -g1024x768 in order to run purgatorio at 1024x768.

`wmsetup`

When emu immediately runs wm/wm in this way, the global profile /lib/sh/profile isn't run. It might be a good idea to run it within your user's wmsetup file (/usr/$USER/lib/wmsetup).
You may also wish to start factotum (the authentication agent).

Example:

run /lib/sh/profile
auth/factotum
auth/feedkey

rqsall