From 5a25750f46f258357085c26dbb24d038ec88b60a Mon Sep 17 00:00:00 2001
From: Seth Morabito <web@loomcom.com>
Date: Sun, 23 Jul 2023 10:12:16 -0700
Subject: [PATCH] Clarify how to load ROMs in README files

---
 .gitignore     |  1 +
 README.md      |  7 +++----
 samples/README | 17 +++++++++--------
 3 files changed, 13 insertions(+), 12 deletions(-)

diff --git a/.gitignore b/.gitignore
index df6a1a1..1d30822 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1,4 +1,5 @@
 *~
+*.jar
 *#
 target
 .DS_Store
diff --git a/README.md b/README.md
index 5238c8e..404676a 100644
--- a/README.md
+++ b/README.md
@@ -227,10 +227,9 @@ properly. Without a ROM in memory, the simulator will not be able to
 reset, since the reset vector for the 6502 is located in the ROM
 address space.
 
-By default, any file named `rom.bin` that exists in the same directory
-where Symon is launched will be loaded as a ROM image. ROM images can
-also be swapped out at run-time with the "Load ROM Image..." in the
-File menu.
+ROM images can be loaded with the `-rom` argument when running
+Symon from the command line. ROM images can also be swapped out at
+run-time with the "Load ROM..." item in the File menu.
 
 The "samples" directory contains a ROM image for the Symon
 architecture named 'ehbasic.rom', containing Lee Davison's Enhanced
diff --git a/samples/README b/samples/README
index 6681b8c..edb1801 100644
--- a/samples/README
+++ b/samples/README
@@ -11,7 +11,6 @@ Sample Programs
   When loaded at address $0300, this program will echo back to the console
   anything typed.
 
-
 Both hello.prg and echo_poll.prg were assembled with the Ophis assembler:
 
    https://hkn.eecs.berkeley.edu/~mcmartin/ophis/
@@ -19,23 +18,25 @@ Both hello.prg and echo_poll.prg were assembled with the Ophis assembler:
 3. echo_irq.rom
 
   This is another echo program, and behaves identically to echo_poll.prg,
-  except it is interrupt-driven.
+  except it is interrupt-driven. This ROM can be loaded either through the
+  "File->Load ROM..." menu in Symon, or by specifying the path to
+  "echo_irq.rom" with the "-jar" command line option when running Symon,
+  for example: `java -jar symon-1.3.2.jar -rom samples/echo_irq.rom`
 
 4. ehbasic.rom
 
    This is Lee Davison's Enhanced 6502 BASIC.
 
-   To use this ROM image, just copy the file 'ehbasic.rom' into the directory
-   where you run Symon. Rename the file to 'rom.bin'.  When you start Symon,
-   the ROM file will be automatically loaded at address $d000.
+   The EhBASIC ROM can be loaded either through the "File -> Load ROM..."
+   menu in Symon, or by specifying the path to "ehbasic.rom" with
+   the "-jar" command line option when running Symon, for example:
+   `java -jar symon-1.3.2.jar -rom samples/ehbasic.rom`
 
    Click the "Run" button and EhBASIC should automatically start running.
 
    Type 'C' to do a cold start.
 
-   Then, type $C000 when prompted for the memory size.
-
-   NOTE: EhBASIC only wants upper-case input. This confused me at first!
+   Then, type '49152' (without the quotes) when prompted for the memory size.
 
    More information can be found in the 'ehbasic' directory, and by visiting
    the EhBASIC web page: