6695

3 files changed, 13 insertions, 11 deletions

diff --git a/prototypes/README.md b/prototypes/README.md
index 28d3b298..bc7cf5cf 100644
--- a/prototypes/README.md
+++ b/prototypes/README.md
@@ -8,11 +8,7 @@ To build prototype #n of app X under this directory:
 $ ./translate_mu prototypes/__X__/__n__.mu
 ```
 
-Now try running it with some text file:
-
-```
-$ ./a.elf __text_file__
-```
+This will generate a binary called `a.elf`.
 
 Sub-directories are prototypes with multiple files. Build them like this:
 
@@ -20,4 +16,5 @@ Sub-directories are prototypes with multiple files. Build them like this:
 $ ./translate_mu prototypes/__X__/__n__/*.mu
 ```
 
-Run them as before.
+For instructions on running the generated `a.elf` binary, see the prototype's
+Readme.
diff --git a/prototypes/browse/README.md b/prototypes/browse/README.md
index 3977dfb2..8e0152cf 100644
--- a/prototypes/browse/README.md
+++ b/prototypes/browse/README.md
@@ -1,8 +1,13 @@
 # Render text with word-wrap.
 
-This directory contains a series of prototypes.
+This directory contains a series of prototypes. For more details on the
+organization of this directory and building, see [the parent directory](..).
 
-If you need to quit, press 'q'.
+Once you've followed the instructions for building a prototype, try running it
+with some text file:
+
+```
+$ ./a.elf __text_file__
+```
 
-For more details on the organization of this directory, see the parent
-directory.
+If you need to quit, press 'q'.
diff --git a/prototypes/tile/2.mu b/prototypes/tile/2.mu
index 41c19d74..aa0cd05e 100644
--- a/prototypes/tile/2.mu
+++ b/prototypes/tile/2.mu
@@ -5,7 +5,7 @@
 #   cat /dev/urandom |base64 - |head -n 1000 > x
 # then merge pairs of lines.
 #
-# also assumes it's in a window 185 characters wide
+# This prototype assumes it's in a window 185 characters wide.
 
 fn main -> exit-status/ebx: int {
   var num-lines/ecx: int <- copy 0x10