about summary refs log tree commit diff stats
diff options
context:
space:
mode:
authorKartik Agaram <vc@akkartik.com>2020-11-17 13:10:02 -0800
committerKartik Agaram <vc@akkartik.com>2020-11-17 13:12:36 -0800
commit1eb1cade71439c9641a79594ea9ff4fc63975ecc (patch)
tree1d6c6a31a1d1973e675f330be576b18c9c7a5254
parent98399a621fa8143a7f1a6d13450514664ac8582b (diff)
downloadmu-1eb1cade71439c9641a79594ea9ff4fc63975ecc.tar.gz
7259
-rw-r--r--README.md11
-rw-r--r--html/20201114-qemu.pngbin0 -> 121443 bytes
2 files changed, 6 insertions, 5 deletions
diff --git a/README.md b/README.md
index 5e8f9a0b..6d331b57 100644
--- a/README.md
+++ b/README.md
@@ -62,6 +62,7 @@ In priority order:
 ## Toolchain
 
 The Mu stack consists of:
+- a prototype Mu shell, a postfix language with a dynamically updating environment
 - the Mu type-safe language;
 - SubX, an unsafe notation for a subset of x86 machine code; and
 - _bare_ SubX, a more rudimentary form of SubX without certain syntax sugar.
@@ -76,20 +77,20 @@ debugging. ([More details.](subx_debugging.md))
 
 ### incomplete tools
 
-The Mu translator is still a work in progress; not all incorrect programs
-result in good error messages.
-
 Once generated, ELF binaries can be packaged up with a Linux kernel into a
-bootable disk image:
+bootable disk image. Here's how you can run the current prototype of the Mu
+shell:
 
 ```sh
-$ ./translate_mu apps/ex2.mu  # emit a.elf
+$ ./translate_mu apps/tile/*.mu  # emit a.elf
 # dependencies
 $ sudo apt install build-essential flex bison wget libelf-dev libssl-dev xorriso
 $ tools/iso/linux a.elf
 $ qemu-system-x86_64 -m 256M -cdrom mu_linux.iso -boot d
 ```
 
+<img alt='screenshot of Mu running on Qemu' src='html/20201114-qemu.png'>
+
 The disk image also runs on [any cloud server that supports custom images](http://akkartik.name/post/iso-on-linode).
 
 Mu also runs on the minimal hobbyist OS [Soso](https://github.com/ozkl/soso).
diff --git a/html/20201114-qemu.png b/html/20201114-qemu.png
new file mode 100644
index 00000000..041ab4e9
--- /dev/null
+++ b/html/20201114-qemu.png
Binary files differ