about summary refs log tree commit diff stats
path: root/shell/README.md
diff options
context:
space:
mode:
authorKartik Agaram <vc@akkartik.com>2021-06-15 14:46:27 -0700
committerKartik Agaram <vc@akkartik.com>2021-06-15 14:46:27 -0700
commit88378503c457656427b8eba9c6087fe5d9adc5e0 (patch)
tree4f710e18665f66b52ddad4990cb342f836c91fb5 /shell/README.md
parentbc21fe0baf97a188a770944744d2e41975a983f9 (diff)
downloadmu-88378503c457656427b8eba9c6087fe5d9adc5e0.tar.gz
.
Diffstat (limited to 'shell/README.md')
-rw-r--r--shell/README.md67
1 files changed, 34 insertions, 33 deletions
diff --git a/shell/README.md b/shell/README.md
index 12dbdfc4..db38c761 100644
--- a/shell/README.md
+++ b/shell/README.md
@@ -3,54 +3,55 @@
 Currently runs a tiny dialect of Lisp. Steps to run it from the top-level:
 
 1. Build it:
-```sh
-$ ./translate shell/*.mu      # generates code.img
-```
 
-You can now already run it:
-```sh
-$ qemu-system-i386 code.img
-```
+  ```sh
+  $ ./translate shell/*.mu      # generates code.img
+  ```
+
+  You can now already run it:
+  ```sh
+  $ qemu-system-i386 code.img
+  ```
 
-But let's add some more 'meat' to play with.
+  But let's add some more 'meat' to play with.
 
 2. Create a data disk with a library of functions.
 
-```sh
-$ dd if=/dev/zero of=data.img count=20160
-$ cat shell/data.limg |dd of=data.img conv=notrunc
-```
+  ```sh
+  $ dd if=/dev/zero of=data.img count=20160
+  $ cat shell/data.limg |dd of=data.img conv=notrunc
+  ```
 
-Run with data disk (and 2GB of RAM):
-```sh
-$ qemu-system-i386 -m 2G -hda code.img -hdb data.img
-```
+  Run with data disk (and 2GB of RAM):
+  ```sh
+  $ qemu-system-i386 -m 2G -hda code.img -hdb data.img
+  ```
 
-Try typing in some expressions and hitting `ctrl-s` to see their results.
-Hit `ctrl-m` to focus on the `...` after a run, 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.
+  Try typing in some expressions and hitting `ctrl-s` to see their results.
+  Hit `ctrl-m` to focus on the `...` after a run, 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.
 
 3. If your Qemu installation supports them, one of these commandline arguments
    may speed up emulation:
 
-- `-enable-kvm`
-- `-accel ___` (run with `-accel help` for a list of available options)
+  - `-enable-kvm`
+  - `-accel ___` (run with `-accel help` for a list of available options)
 
-If you do this, I recommend also adjusting the `responsiveness` mask in
-shell/evaluate.mu, which controls how frequently the fake screen updates.
-Smaller values will seem more responsive, larger values will leave more time
-to run your programs. I like to see the screen update about once a second.
-Some suggested values depending on how fast your Qemu is running:
+  If you do this, I recommend also adjusting the `responsiveness` mask in
+  shell/evaluate.mu, which controls how frequently the fake screen updates.
+  Smaller values will seem more responsive, larger values will leave more time
+  to run your programs. I like to see the screen update about once a second.
+  Some suggested values depending on how fast your Qemu is running:
 
-- `-enable-kvm` on a T420s running Linux: `0xffff/responsiveness=64k`
-- `-accel tcg` on a 2019 Mac: `0xfff/responsiveness=4k`
+  - `-enable-kvm` on a T420s running Linux: `0xffff/responsiveness=64k`
+  - `-accel tcg` on a 2019 Mac: `0xfff/responsiveness=4k`
 
-Putting it all together, here's the command I typically use on Linux:
+  Putting it all together, here's the command I typically use on Linux:
 
-```
-$ qemu-system-i386 -m 2G -enable-kvm -hda code.img -hdb data.img
-```
+  ```
+  $ qemu-system-i386 -m 2G -enable-kvm -hda code.img -hdb data.img
+  ```
 
 *Known issues*