summaryrefslogtreecommitdiffstats
path: root/system/sdltrs/README
diff options
context:
space:
mode:
Diffstat (limited to 'system/sdltrs/README')
-rw-r--r--system/sdltrs/README26
1 files changed, 23 insertions, 3 deletions
diff --git a/system/sdltrs/README b/system/sdltrs/README
index 8b6f1c72f8..f3b219e8d0 100644
--- a/system/sdltrs/README
+++ b/system/sdltrs/README
@@ -1,8 +1,28 @@
+sdltrs (Radio Shack TRS-80 Model I/III/4/4P Emulator)
+
sdltrs is a Radio Shack TRS-80 Model I/III/4/4P emulator for Macintosh
OSX, Windows and Linux. It has been ported from the excellent X
Window Unix emulator xtrs. Instead of using the X-Window system for
graphics, it uses the portable SDL library.
-A simple sdltrs.desktop file is included that will start sdltrs
-with the default options. Read the included documentation after
-installation for more information.
+This build uses SDL-1.2, which is an older library that performs
+better on older and lower-spec machine. If your computer was made
+in the last 10 years or so, you probably should be using the SDL-2.0
+build, which is called sdl2trs. It's possible to install both sdltrs
+and sdl2trs on the same system without conflict.
+
+Note: When you start up sdltrs for the first time, it attempts
+to boot from floppy disk. If you didn't give either the "-disk0
+/path/to/image.dsk" or "-nofloppy" options on the command line, it
+will "hang" with a black screen, because it's trying to boot from a
+nonexistent floppy disc. To recover from this:
+
+- Hold down F10 (TRS-80 Reset) and press Escape (TRS-80 Break key) to
+ skip the disk boot and enter the ROM BASIC.
+
+- Press Alt+D to enter the emulator's disk menu, and from there,
+ either select a bootable disk image for drive 0, or disable the
+ floppy disk controller. Then press Shift-F10 to reboot the TRS-80.
+
+See the man page and the documentation at
+/usr/doc/sdltrs-$VERSION/html/index.html for further details.