1 files changed, 15 insertions, 13 deletions

diff --git a/README.md b/README.md
index dbc90c0..baadcc9 100644
--- a/README.md
+++ b/README.md
@@ -1,10 +1,13 @@
 # UXNGBA
 
-This is a port of the [UXN virtual machine][uxn] for the GBA. It is currently at
-an early stage, but is capable of running simple demos that make use of the
-screen or console devices, including the beautiful DVD bouncing.
+This is a port of the [UXN virtual machine][uxn] for the GBA. UXN is a project
+created by the artist collective and research studio [100 rabbits][100r]. It can
+be used to write small graphical applications, tools and games. Programs written
+for UXN are distributed via bytecode compiled roms, akin to classic console
+emulators. For this project, uxn roms are embedded directly in the .gba rom.
 
 [uxn]: https://wiki.xxiivv.com/site/uxn.html
+[100r]: https://100r.co/
 
 ## Building from source
 
@@ -27,16 +30,13 @@ If everything is properly installed, you should be able to run `make` to compile
 the program into a `uxngba.gba` rom. If you have `mgba-qt` installed, you can
 test it with: `make run`.
 
-To use a specific UXN compiled rom, you can pass it as the `ROM_SRC` make
+To use a specific UXN compiled rom, you can pass it as the `UXN_ROM` make
 parameter:
 
 ```
-make run ROM_SRC=roms/noodle.rom
+make run UXN_ROM=roms/noodle.rom
 ```
 
-If you have compiled a rom already and want to change it, you probably want to
-use `make clean` beforehand.
-
 [devkitpro]: https://devkitpro.org/
 
 ## Configuration
@@ -49,14 +49,14 @@ macros on compile time as described below.
 ### Input method order
 
 Uxngba currently supports three different control schemes that can be cycled by
-pressing the SELECT button: `CONTROL_CONTROLLER`, `CONTROL_MOUSE` and
+pressing the L or R buttons: `CONTROL_CONTROLLER`, `CONTROL_MOUSE` and
 `CONTROL_KEYBOARD`. To select the order and available methods set the
 `CONTROL_METHODS` macro on compile time. For example, [noodle][noodle] doesn't
 make much use of the controller scheme, and we may want to use the mouse as the
 default input method. This can be achieved with the following command:
 
 ```
-make run ROM_SRC=roms/noodle.rom CONFIG="-DCONTROL_METHODS=CONTROL_MOUSE,CONTROL_KEYBOARD"
+make run UXN_ROM=roms/noodle.rom CONFIG="-DCONTROL_METHODS=CONTROL_MOUSE,CONTROL_KEYBOARD"
 ```
 
 ### Audio quality
@@ -69,11 +69,11 @@ a good quality-performance compromise. A high quality and low-fi audio modes can
 be selected by setting the `AUDIO_HIFI` or `AUDIO_LOFI` macros:
 
 ```
-make run ROM_SRC=roms/audio.rom CONFIG="-DAUDIO_HIFI"
+make run UXN_ROM=roms/audio.rom CONFIG="-DAUDIO_HIFI"
 
   or
 
-make run ROM_SRC=roms/audio.rom CONFIG="-DAUDIO_LOFI"
+make run UXN_ROM=roms/audio.rom CONFIG="-DAUDIO_LOFI"
 ```
 
 ### Text layer
@@ -81,10 +81,12 @@ make run ROM_SRC=roms/audio.rom CONFIG="-DAUDIO_LOFI"
 When writing text to the screen (for example using the console device) the text
 will be drawn by default on the foreground layer. This can be controlled by
 setting the `TEXT_MODE` option to 0 for foreground mode or 1 for background
-mode.
+mode. The text layer can be omitted if using the TEXT_DISABLE macro.
 
 ```
 make run CONFIG="-DTEXT_MODE=1"
+
+make run CONFIG="-DTEXT_DISABLE=1"
 ```
 
 ### Performance metrics