summaryrefslogtreecommitdiff
path: root/system/kegs/README.Slackware
diff options
context:
space:
mode:
authorB. Watson <yalhcru@gmail.com>2015-06-24 16:34:25 -0400
committerWilly Sudiarto Raharjo <willysr@slackbuilds.org>2015-06-28 11:49:20 +0700
commitdfec940e0028db00f9fdf059c7d2c208d908b541 (patch)
treee0e45810ac8244fca5e98bfbefe438661902fb96 /system/kegs/README.Slackware
parentbbaae0b2947a34a69078ceb22d14e25e2e4f138d (diff)
downloadslackbuilds-dfec940e0028db00f9fdf059c7d2c208d908b541.tar.gz
system/kegs: Fix audio issues.
Diffstat (limited to 'system/kegs/README.Slackware')
-rw-r--r--system/kegs/README.Slackware51
1 files changed, 51 insertions, 0 deletions
diff --git a/system/kegs/README.Slackware b/system/kegs/README.Slackware
new file mode 100644
index 0000000000..03e0ebf940
--- /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/