mu/shell/README.md
Kartik K. Agaram e6b42204ef shell: read initial expression from secondary disk
See shell/README.md for (extremely klunky) instructions.
2021-03-21 23:10:55 -07:00

37 lines
943 B
Markdown

### A prototype shell for the Mu computer
Currently runs a tiny subset of Lisp. Steps to run it from the top-level:
1. Build it:
```sh
$ ./translate shell/*.mu # generates disk.img
```
2. Create a data disk:
```sh
$ dd if=/dev/zero of=data.img count=20160
```
3. Optionally load an s-expression into the disk:
```sh
$ echo '(+ 1 1)' |dd of=data.img conv=notrunc
```
4. Run it:
```sh
$ qemu-system-i386 disk.img
```
You can type in expressions, hit `ctrl-s` to see their results, and hit `Tab`
to focus on the `...` below and browse how the results were computed. [Here's
a demo.](https://archive.org/details/akkartik-2min-2021-02-24) The bottom of
the screen shows context-dependent keyboard shortcuts (there's no mouse in the
Mu computer at the moment).
*Known issues*
* There's no way to save to disk.
* Don't press keys too quickly (such as by holding down a key). The Mu
computer will crash (and often Qemu will segfault).