summaryrefslogtreecommitdiff
path: root/README.txt
diff options
context:
space:
mode:
Diffstat (limited to 'README.txt')
-rw-r--r--README.txt33
1 files changed, 33 insertions, 0 deletions
diff --git a/README.txt b/README.txt
new file mode 100644
index 0000000..b07663c
--- /dev/null
+++ b/README.txt
@@ -0,0 +1,33 @@
+LUMA
+
+Copyright 2021-2023 Gabriel Jensen.
+
+luma is an emulator for the AGB - Game Boy Advance - platform.
+
+USAGE
+
+luma [image] [bootloader]
+
+Invoke the emulator via the 'luma' command.
+
+CONFIGURATION
+
+The emulator tries to read the configuration file at '${HOME}/.luma.ini'. If
+this file is found, the following fields are read (if present):
+
+luma:
+ - version: (Uint) The version of the configuration file (0)
+
+device:
+ - bootloader: (String) The path to the bootloader file (home-relative)
+ - image: (String) The path to the image file (home-relative)
+
+video:
+ - scale: (Uint) The scale modifier applied to the screen (min 1; max (2^32-1))
+
+These settings are overwritten by terminal parameters (see USAGE).
+
+COMPATIBILITY
+
+Currently, the emulator only supports the b{cond}{l}.w instruction. Improved
+support is, of course, planned.