system/kegs: Fix audio issues.

1 files changed, 51 insertions, 0 deletions

diff --git a/system/kegs/README.Slackware b/system/kegs/README.Slackware
new file mode 100644
index 0000000000000..03e0ebf940a07
--- /dev/null
+++ b/system/kegs/README.Slackware
@@ -0,0 +1,51 @@
+ROM Images
+==========
+
+KEGS requires a ROM image dumped from an Apple IIgs. This will typically
+be called either "rom01" (131072 bytes) or "rom03" (262144 bytes),
+and will often be distributed in zip files called apple2g1.zip and
+apple2gs.zip (for use with MESS). This package can optionally include
+the ROM file. To do this, place the ROM image in the slackbuild
+directory before running the script. The image will be installed
+as /usr/share/kegs/rom03 (or rom01). If you do not include the ROM
+in the package, you will need to manually copy the rom03 image to
+/usr/share/kegs/rom03 before the emulator will work properly.
+
+Audio
+=====
+
+kegs uses OSS for audio. To get sound working, you have 3 options:
+
+1. Run kegs as "aoss xkegs", or launch it from your desktop's application
+   menu (which does the same thing).
+
+2. Enable ALSA OSS emulation:
+   # chmod +x /etc/rc.d/rc.alsa-oss
+   # /etc/rc.d/rc.alsa-oss
+
+   However, this may interfere with other applications' use of the
+   sound card.
+
+3. If you already use OSSv4 (audio/oss from slackbuilds.org), kegs
+   should be able to use it. It's not recommended to switch to OSSv4
+   just to get audio working in kegs, though.
+
+GS/OS Disk Images
+=================
+
+If you intend to run Apple's GS/OS in the emulator, you will need
+macutils to extract the .sea.bin archives. Download disk image(s) from
+one of the sites listed below and then run e.g.:
+
+$ macunpack -d Disk_2_of_7-System.Disk.sea.bin
+$ mv Disk_2_of_7-System.Disk.data system_disk.dsk
+
+Mount system_disk.dsk on slot 5 using the config menu within xkegs,
+set slot 5 as the default startup device in the IIgs control panel,
+and you should be booting into the IIgs native GUI environment.
+
+The GS/OS disk images used to be hosted on Apple's site, but have been
+removed. They can be found on various archive sites, including:
+
+ftp://ftp.muleslow.net/apple2/
+http://mirrors.apple2.org.za/ftp.info.apple.com/Apple_IIGS_System_6.0.1/