aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorThomas Voss <mail@thomasvoss.com> 2024-02-18 16:51:35 +0100
committerThomas Voss <mail@thomasvoss.com> 2024-02-18 16:51:35 +0100
commitc2e81f8972b6a0bb3c4dbf675edb9d9bae1c50e1 (patch)
tree92f65523620d18ca62a84ca141b36c341e487d80
parent3e9643120fd08ce9c455b63a135ee43a323cd948 (diff)
Update README
-rw-r--r--README.md46
1 files changed, 43 insertions, 3 deletions
diff --git a/README.md b/README.md
index 8677a49..d8bce96 100644
--- a/README.md
+++ b/README.md
@@ -1,6 +1,46 @@
-# Ahoy — The CHIP-8 Emulator and -Toolchain
+# Ahoy! — The CHIP-8 Emulator and -Toolchain
-### Where does the name come from?
+Ahoy! (the ‘!’ is part of the name) is a CHIP-8 emulator and -toolchain.
+As of writing, the following binaries exist as part of the Ahoy!
+distribution:
-The ‘Chips Ahoy!’ cookies.
+- `ahoy` — GUI emulator
+- `c8asm` — CHIP-8 assembler
+- `c8dump` — CHIP-8 disassembler
+
+
+## Where does the name come from?
+
+The ‘Chips Ahoy!’ cookies I enjoyed as a child.
+
+
+## Building and Installation
+
+The entire project can be built with a C23 compiler:
+
+```sh
+$ cc -std=c23 -o make make.c
+$ ./make # compile everything
+$ ./make install # install everything
+```
+
+The following flags can be provided to the build script:
+
+- `-f` / `--force`: force a complete rebuild
+- `-r` / `--release`: build with optimizations enabled
+
+
+## Documentation
+
+All programs in the Ahoy! collection are documented via manual pages.
+You can read them either with the `man` command, or by passing the
+`-h`/`--help` flag to the given program.
+
+
+## Potential Future Plans?
+
+- TUI emulator via ncurses
+- Compiler for a C-like higher-level language
+- SCHIP support
+- Handheld emulator on an embedded system