summaryrefslogtreecommitdiffstats
path: root/games/xroar/README
diff options
context:
space:
mode:
Diffstat (limited to 'games/xroar/README')
-rw-r--r--games/xroar/README32
1 files changed, 32 insertions, 0 deletions
diff --git a/games/xroar/README b/games/xroar/README
new file mode 100644
index 0000000000..f3cc8ff627
--- /dev/null
+++ b/games/xroar/README
@@ -0,0 +1,32 @@
+XRoar is a Dragon emulator for Linux, Unix, Mac OS X, GP32, Nintendo
+DS and Windows. Due to hardware similarities, XRoar also emulates the
+Tandy Colour Computer (CoCo) models 1 & 2.
+
+Optional, but recommended, is libsndfile (available from SlackBuilds.org).
+xroar uses libsndfile to support audio files (WAV, etc) as cassette
+images. It is not required for the emulator to play audio, nor is it
+required for ".cas" files (cassette data images).
+
+To usefully emulate the Dragon or CoCo, you will need the images of
+the system ROMs for the target system. The ROM images must be copied to
+/usr/share/xroar/roms, and must be given the filenames xroar expects. See
+the xroar info page or /usr/doc/xroar-0.23b/xroar.html for details on
+ROM files.
+
+If you want to include ROM images in the package, get the files
+"coco.zip", "coco2.zip", "cocoe.zip", "dragon32.zip", and/or
+"dragon64.zip" from any site that carries MESS BIOS images. Place them
+in the directory with the SlackBuild script before running it. The
+resulting package cannot be redistributed (that would violate both the
+GPL and the original copyright on the ROM images).
+
+If you don't include the ROM images, it's still possible to run
+some Dragon32 software: the package includes a freeware ROM image
+(mini-dragon.rom) that partly reimplements the original ROM code. This
+is enough to run at least some cartridge-based games.
+
+More information on the Dragon and CoCo computers:
+
+http://en.wikipedia.org/wiki/TRS-80_Color_Computer
+http://archive.worldofdragon.org/index.php?title=Main_Page
+http://archive.worldofdragon.org/archive/index.php