From f291ff20e22b655474e777f848ffee6284ecea18 Mon Sep 17 00:00:00 2001
From: Zellyn Hunter <zellyn@squareup.com>
Date: Tue, 24 Jan 2017 12:06:20 -0600
Subject: [PATCH] Update readme and audit/build script

---
 README.md   | 36 +++++++++++++++++++++++++-----------
 audit/build | 40 +++++++++++++++++++++++++++++++---------
 2 files changed, 56 insertions(+), 20 deletions(-)

diff --git a/README.md b/README.md
index 6785da5..52235f1 100644
--- a/README.md
+++ b/README.md
@@ -1,23 +1,37 @@
 # Apple II Audit
 
-This repository contains routines to audit Apple II computers (II, II+,
-IIe, IIc), providing information about hardware, ROM versions, RAM
-configuration, and behavior.
+This repository contains routines to audit Apple II computers (II,
+II+, IIe, IIc), providing information about hardware, ROM versions,
+RAM configuration, and behavior.
 
-Eventually, it should comprise an emulator test suite, enabling
-emulator writers to systematically identify and eliminate perceptible
-differences from real hardware. If a difference visible to code can be
-found, a test should be added to this suite.
+Eventually, it should comprise a complete emulator test suite,
+enabling emulator writers to systematically identify and eliminate
+software-testable differences from real hardware. If a difference
+visible to code can be found, a test should be added to this suite.
+
+# Error messages
+
+Error messages can be viewed at
+[zellyn.com/a2audit/a2audit/v0](http://zellyn.com/a2audit/v0/) or
+[on github](https://github.com/zellyn/a2audit/blob/master/v0/index.md).
 
 ## Status
 
-I'm just getting started, currently working on:
+### Done
 
-- experimenting with toolchains for automation
-- preliminary floating-bus vsync examples
-- sha1sum assembly code
+- [x] toolchain for automation ([diskii](github.com/zellyn/diskii))
+- [x] sha1sum assembly code (currently not used yet because it's slow)
+- [x] language card tests
+- [x] main/auxiliary memory softswitch behavior tests
+
+### TODO
+
+- [ ] floating-bus tests
+
+## Raison d'être
 
 This test suite is a step on the way to implementing Apple IIe
 (enhanced) support in
 [OpenEmulator](http://openemulatorproject.github.io/): I may alternate
 adding tests here and features there.
+
diff --git a/audit/build b/audit/build
index f4506e1..3910080 100755
--- a/audit/build
+++ b/audit/build
@@ -23,14 +23,36 @@ grep -h '+prerra\? .*;;' *.asm | awk -F' ;; ' '{print $2}' | sort | sed 's|\(E..
 
 # Also run mame? (set ROMPATH to your local variant)
 [[ -z "${ROMPATH-}" ]] && ROMPATH=~/mame/roms/
-[[ "${1-}" == '2ee' ]] && mame -rompath $ROMPATH apple2ee -flop1 ./audit.dsk -skip_gameinfo
-[[ "${1-}" == '2e' ]] && mame -rompath $ROMPATH apple2e -flop1 ./audit.dsk -skip_gameinfo
-[[ "${1-}" == '2p' ]] && mame -rompath $ROMPATH apple2p -flop1 ./audit.dsk -skip_gameinfo
-[[ "${1-}" == '2' ]] && mame -rompath $ROMPATH apple2 -flop1 ./audit.dsk -skip_gameinfo
-[[ "${1-}" == '2ee-d' ]] && mame -rompath $ROMPATH apple2ee -flop1 ./audit.dsk -skip_gameinfo -debug
-[[ "${1-}" == '2e-d' ]] && mame -rompath $ROMPATH apple2e -flop1 ./audit.dsk -skip_gameinfo -debug
-[[ "${1-}" == '2p-d' ]] && mame -rompath $ROMPATH apple2p -flop1 ./audit.dsk -skip_gameinfo -debug
-[[ "${1-}" == '2-d' ]] && mame -rompath $ROMPATH apple2 -flop1 ./audit.dsk -skip_gameinfo -debug
+
+case "${1-none}" in
+    "2ee")
+	mame -rompath $ROMPATH apple2ee -flop1 ./audit.dsk -skip_gameinfo
+	;;
+    "2e")
+	mame -rompath $ROMPATH apple2e -flop1 ./audit.dsk -skip_gameinfo
+	;;
+    "2p")
+	mame -rompath $ROMPATH apple2p -flop1 ./audit.dsk -skip_gameinfo
+	;;
+    "2")
+	mame -rompath $ROMPATH apple2 -flop1 ./audit.dsk -skip_gameinfo
+	;;
+    "2ee-d")
+	mame -rompath $ROMPATH apple2ee -flop1 ./audit.dsk -skip_gameinfo -debug
+	;;
+    "2e-d")
+	mame -rompath $ROMPATH apple2e -flop1 ./audit.dsk -skip_gameinfo -debug
+	;;
+    "2p-d")
+	mame -rompath $ROMPATH apple2p -flop1 ./audit.dsk -skip_gameinfo -debug
+	;;
+    "2-d")
+	mame -rompath $ROMPATH apple2 -flop1 ./audit.dsk -skip_gameinfo -debug
+	;;
+    "none")
+	;;
+    *)
+	echo Options: 2ee, 2e, 2p, 2, 2ee-d, 2e-d, 2p-d, 2-d
+esac
 
 true # Signal success (since we had a bunch of conditionals that can return false status).
-