From e71817759bc2a6fd49cb430421de59d3eb0e1da9 Mon Sep 17 00:00:00 2001
From: neauoire <aliceffekt@gmail.com>
Date: Mon, 24 May 2021 20:39:40 -0700
Subject: [PATCH] Added more details to the README

---
 README.md               | 24 ++++++++++++++++++++++++
 build.sh                |  2 +-
 projects/demos/life.usm |  2 +-
 3 files changed, 26 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index 38b7143..4972947 100644
--- a/README.md
+++ b/README.md
@@ -4,6 +4,8 @@ An [8-bit stack-based computer](https://wiki.xxiivv.com/site/uxn.html), written
 
 ## Build
 
+### Linux 
+
 To build the Uxn emulator on Linux, you must have [SDL2](https://wiki.libsdl.org/).
 
 ```sh
@@ -12,6 +14,8 @@ To build the Uxn emulator on Linux, you must have [SDL2](https://wiki.libsdl.org
 	--cli # Run rom without graphics
 ```
 
+### Plan 9 
+
 To build the Uxn emulator on [9front](http://9front.org/), via [npe](https://git.sr.ht/~ft/npe):
 
 ```rc
@@ -21,6 +25,26 @@ mk
 If the build fails on 9front because of missing headers or functions,
 try again after `rm -r /sys/include/npe`.
 
+## Getting Started
+
+Begin by building the assembler and emulator by running the build script.
+
+```
+./build.sh
+```
+
+You now have the assembler(`uxnasm`) and the emulator(`uxnemu`). To create a rom, from a [usm file](https://wiki.xxiivv.com/site/uxambly.html), use the following command. This example will create the `life.rom` from the `life.usm` uxambly file, point to a different file or folder to assemble a different rom. You can find additional roms [here](https://sr.ht/~rabbits/uxn/sources).
+
+```
+bin/uxnasm projects/demos/life.usm bin/life.rom
+```
+
+To launch the rom:
+
+```
+bin/uxnemu bin/life.rom
+```
+
 ## Emulator Controls
 
 - `ctrl+h` toggle debugger
diff --git a/build.sh b/build.sh
index f8bd8d9..2535ba9 100755
--- a/build.sh
+++ b/build.sh
@@ -42,7 +42,7 @@ then
 fi
 
 echo "Assembling.."
-./bin/uxnasm projects/demos/life.usm bin/boot.rom
+./bin/uxnasm projects/demos/piano.usm bin/boot.rom
 
 echo "Running.."
 if [ "${2}" = '--cli' ]; 
diff --git a/projects/demos/life.usm b/projects/demos/life.usm
index d35df6c..0756841 100644
--- a/projects/demos/life.usm
+++ b/projects/demos/life.usm
@@ -187,7 +187,7 @@ RTN
 	DUP2 ,get-index JSR LDA 
 	SWP POP SWP
 	MOD8
-	SFT #01 AND
+	SFT MOD2
 
 RTN