8 files changed, 476 insertions, 279 deletions
diff --git a/system/kegs/kegs.SlackBuild b/system/kegs/kegs.SlackBuild
index 45e3ebb793..58bc24480a 100644
--- a/system/kegs/kegs.SlackBuild
+++ b/system/kegs/kegs.SlackBuild
@@ -2,10 +2,17 @@
 
 # Slackware build script for kegs
 
-# Written by B. Watson (yalhcru@gmail.com)
+# Written by B. Watson (urchlay@slackware.uk)
 
 # Licensed under the WTFPL. See http://www.wtfpl.net/txt/copying/ for details.
 
+# 20230918 bkw: update for v1.29, binary in /usr/games, section 6 manpage.
+# 20221228 bkw: update for v1.16.
+
+# 20210825 bkw: update for v1.12.
+# - upstream got rid of to_pro and partls, so their man pages are
+#   also gone now.
+
 # 20210225 bkw: update for v1.05. lots of changes:
 # - include the ROM image in the package (add it to DOWNLOAD)
 # - allow_sound_open_fail.diff no longer required
@@ -17,7 +24,7 @@
 
 # 20170305 bkw:
 # - fix building under installwatch, caused by a symlink in the
-#   tarball being listed before its target Why does this choke
+#   tarball being listed before its target. Why does this choke
 #   under installwatch and not otherwise? Not bumping BUILD for this.
 
 # 20150621 bkw: bump BUILD to 2
@@ -30,7 +37,7 @@
 cd $(dirname $0) ; CWD=$(pwd)
 
 PRGNAM=kegs
-VERSION=${VERSION:-1.05}
+VERSION=${VERSION:-1.29}
 BUILD=${BUILD:-1}
 TAG=${TAG:-_SBo}
 PKGTYPE=${PKGTYPE:-tgz}
@@ -43,9 +50,6 @@ if [ -z "$ARCH" ]; then
   esac
 fi
 
-# If the variable PRINT_PACKAGE_NAME is set, then this script will report what
-# the name of the created package would be, and then exit. This information
-# could be useful to other scripts.
 if [ ! -z "${PRINT_PACKAGE_NAME}" ]; then
   echo "$PRGNAM-$VERSION-$ARCH-$BUILD$TAG.$PKGTYPE"
   exit 0
@@ -81,13 +85,11 @@ rm -rf $PKG
 mkdir -p $TMP $PKG $OUTPUT
 cd $TMP
 rm -rf $PRGNAM.$VERSION
-tar xvf $CWD/$PRGNAM.$VERSION.tar.gz \
-  --exclude '*/KEGSMAC.app' \
-  --exclude xkegs
+unzip $CWD/$PRGNAM.$VERSION.zip -x '*/KEGSMAC.app/*' '*/xkegs' '*.exe'
 cd $PRGNAM.$VERSION
 chown -R root:root .
-find -L .  -perm /111 -a \! -perm 755 -a -exec chmod 755 {} \+ -o \
-        \! -perm /111 -a \! -perm 644 -a -exec chmod 644 {} \+
+find -L .  -perm /111 -a \! -perm 755 -a -exec chmod 755 {} + -o \
+        \! -perm /111 -a \! -perm 644 -a -exec chmod 644 {} +
 
 # device name for joysticks has changed for the 21st century.
 sed -i 's,/dev/js,/dev/input/js,' src/joystick_driver.c
@@ -100,25 +102,25 @@ sed -i 's,/dev/js,/dev/input/js,' src/joystick_driver.c
 # for kegs *actually says* you can close the main KEGS window to quit,
 # *and you can't fucking close it* without this patch. Apologies if I
 # sound a bit strident, but...
+# 20230918 bkw: patch still applies (with fuzz) & works on 1.29.
 patch -p1 < $CWD/allow_window_close.diff
 
 cd src
 rm -f vars
 cat $VARS > vars
-make SLKCFLAGS="$SLKCFLAGS" x$PRGNAM to_pro partls
+make SLKCFLAGS="$SLKCFLAGS" x$PRGNAM
 cd -
 
 # No install target, just stick it all where it goes.
 mkdir -p \
-  $PKG/usr/bin \
+  $PKG/usr/games \
   $PKG/usr/libexec \
   $PKG/usr/share/pixmaps \
   $PKG/usr/share/applications \
   $PKG/usr/share/$PRGNAM \
-  $PKG/usr/man/man1
+  $PKG/usr/man/man6
 install -s -m0755 x$PRGNAM $PKG/usr/libexec/
-install -s -m0755 src/to_pro src/partls $PKG/usr/bin/
-install -m0755 $CWD/x$PRGNAM.sh $PKG/usr/bin/x$PRGNAM
+install -m0755 $CWD/x$PRGNAM.sh $PKG/usr/games/x$PRGNAM
 install -m0644 $CWD/$PRGNAM.desktop $PKG/usr/share/applications/
 install -m0644 $CWD/config.$PRGNAM.default $PKG/usr/share/$PRGNAM
 
@@ -136,21 +138,24 @@ ln -s ../icons/hicolor/48x48/apps/$PRGNAM.png $PKG/usr/share/pixmaps/$PRGNAM.png
 # asimov site for at least 20 years now, Apple has never complained.
 unzip -p $CWD/gsrom03.zip > $PKG/usr/share/$PRGNAM/rom03
 
+# 20210825 bkw: include the bundled disk images in the package.
+cp -a [A-Z]*.gz $PKG/usr/share/$PRGNAM/
+
 # Man pages are specific to the SlackBuild, though I've sent
 # them upstream for consideration.
-for file in $CWD/man/*.1; do
+for file in $CWD/man/*.6; do
   sed "s/@VERSION@/$VERSION/g" $file \
   | gzip -9c \
-  > $PKG/usr/man/man1/$( basename $file ).gz
+  > $PKG/usr/man/man6/$( basename $file ).gz
 done
 
 # Half the supplied documentation refers to it as "kegs" and
 # the other half calls it "xkegs". To avoid confusion:
-ln -s x$PRGNAM.1.gz $PKG/usr/man/man1/$PRGNAM.1.gz
-ln -s x$PRGNAM $PKG/usr/bin/$PRGNAM
+ln -s x$PRGNAM.6.gz $PKG/usr/man/man6/$PRGNAM.6.gz
+ln -s x$PRGNAM $PKG/usr/games/$PRGNAM
 
 mkdir -p $PKG/usr/doc/$PRGNAM-$VERSION
-install -m0644 *.txt $PKG/usr/doc/$PRGNAM-$VERSION
+install -m0644 doc/*.txt $PKG/usr/doc/$PRGNAM-$VERSION
 cat $CWD/$PRGNAM.SlackBuild > $PKG/usr/doc/$PRGNAM-$VERSION/$PRGNAM.SlackBuild
 
 mkdir -p $PKG/install
diff --git a/system/kegs/kegs.desktop b/system/kegs/kegs.desktop
index 3339d2bafa..a95ce75dd4 100644
--- a/system/kegs/kegs.desktop
+++ b/system/kegs/kegs.desktop
@@ -3,7 +3,7 @@ Version=1.0
 Name=KEGS
 GenericName=Apple IIgs Emulator
 Type=Application
-Exec=xkegs
+Exec=/usr/games/xkegs
 Icon=kegs
 Terminal=false
 StartupNotify=false
diff --git a/system/kegs/kegs.info b/system/kegs/kegs.info
index 937cf787c0..1bf7277e30 100644
--- a/system/kegs/kegs.info
+++ b/system/kegs/kegs.info
@@ -1,12 +1,12 @@
 PRGNAM="kegs"
-VERSION="1.05"
+VERSION="1.29"
 HOMEPAGE="http://kegs.sourceforge.net/"
-DOWNLOAD="http://kegs.sourceforge.net/kegs.1.05.tar.gz \
+DOWNLOAD="https://kegs.sourceforge.net/kegs.1.29.zip \
           https://mirrors.apple2.org.za/ftp.apple.asimov.net/emulators/rom_images/gsrom03.zip"
-MD5SUM="b7f0452bf173eecdfadf9a82c4f75bea \
+MD5SUM="f4de669e957d0c9570de07ec960e8427 \
         029ebd31845614636f6a34a19730cd57"
 DOWNLOAD_x86_64=""
 MD5SUM_x86_64=""
 REQUIRES=""
 MAINTAINER="B. Watson"
-EMAIL="yalhcru@gmail.com"
+EMAIL="urchlay@slackware.uk"
diff --git a/system/kegs/man/partls.1 b/system/kegs/man/partls.1
deleted file mode 100644
index 1af148532b..0000000000
--- a/system/kegs/man/partls.1
+++ /dev/null
@@ -1,23 +0,0 @@
-.TH PARTLS "1" "January 2011" "SlackBuilds.org" "User Commands"
-.SH NAME
-partls \- Lists partitions on Apple\-partitioned hard drives or CD-ROMs
-.SH SYNOPSIS
-.B partls
-<\fI-l\fR>
-[\fIfile-or-device\fR]
-.SH DESCRIPTION
-partls is distributed with the KEGS emulator.
-.PP
-partls displays the partition table on an Apple\-partitioned disk or
-disk image file. Generally, these partitions will use the Apple HFS filesystem.
-.PP
-With the \fB\-l\fR option, more information is displayed.
-.SH SEE ALSO
-xkegs(1)
-.br
-to_pro(1)
-.SH AUTHORS
-KEGS and partls are by Kent Dickey <kadickey at princeton dot edu>.
-.PP
-This manual page was written by B. Watson for the SlackBuilds.org project (but
-may be used by anyone for any reason).
diff --git a/system/kegs/man/to_pro.1 b/system/kegs/man/to_pro.1
deleted file mode 100644
index a58fada52d..0000000000
--- a/system/kegs/man/to_pro.1
+++ /dev/null
@@ -1,55 +0,0 @@
-.TH TO_PRO "1" "January 2011" "SlackBuilds.org" "User Commands"
-.SH NAME
-to_pro \- creates and copies files to Apple ProDOS disk images
-.SH SYNOPSIS
-.B to_pro
-[\fI-size\fR]
-[\fIfile\fR]
-<\fIfile\fR ...>
-.SH DESCRIPTION
-to_pro is intended for use with the KEGS emulator.
-.PP
-to_pro creates a new ProDOS disk image called POOF1 in the current
-directory, of the given size, containing the specified file(s). At
-least one file must be given (to_pro cannot create a completely blank
-image), and up to 51 file arguments are allowed.
-.PP
-The size argument is in kilobytes (1024 bytes each), and must be larger than the total size of
-all the files (no checking is done, it's up to the user). ProDOS has a limit
-of 32MB per partition, so the \-size argument should always less than
-32767.
-.PP
-Long UNIX filenames are truncated to the 15\-character
-ProDOS limit.
-.PP
-The author warns that the generated disk image files should only be used
-temporarily, to copy files from the image to another ProDOS disk image
-that was formatted within KEGS using ProDOS itself (or, the generated
-image may be formatted within KEGS to create a proper blank disk image).
-.PP
-to_pro automatically sets the ProDOS filetype of files ending in ".shk"
-to $E0.
-.SH EXAMPLES
-.TP
-to_pro \-800 wolfdemo.bxy
-Creates an 800KB disk image called POOF1, containing the file "wolfdemo.bxy"
-(which is likely an Apple IIgs archive, downloaded from an FTP or web site).
-Probably the next thing you will do be "mv POOF1 wolfdemo.dsk".
-.TP
-to_pro \-4096 wolfdemo.bxy
-Same as above, but creates a 4MB POOF1 image file instead.
-.TP
-to_pro \-32000 *.shk
-put all *.shk files in the current Unix directory into a 31.25MB
-image called POOF1.
-.SH SEE ALSO
-xkegs(1)
-.br
-partls(1)
-.PP
-More information on to_pro in /usr/doc/kegs\-@VERSION@/README.kegs.txt
-.SH AUTHORS
-KEGS and to_pro are by Kent Dickey <kadickey at princeton dot edu>.
-.PP
-This manual page was written by B. Watson for the SlackBuilds.org project (but
-may be used by anyone for any reason).
diff --git a/system/kegs/man/xkegs.1 b/system/kegs/man/xkegs.1
deleted file mode 100644
index eb14f217e6..0000000000
--- a/system/kegs/man/xkegs.1
+++ /dev/null
@@ -1,175 +0,0 @@
-.TH KEGS "1" "January 2011" "SlackBuilds.org" "User Commands"
-.SH NAME
-xkegs \- Apple IIgs emulator
-.SH SYNOPSIS
-.B xkegs
-[\fI-options\fR]
-.SH DESCRIPTION
-KEGS (Kent's Emulated GS)
-is an Apple IIgs emulator for Mac OS X, Linux, and Win32. The Apple
-IIgs was the most powerful computer in the Apple II line. It first was
-sold in 1986. An Apple IIgs has the capability to run almost all Apple
-II, Apple IIe, and Apple IIc programs.
-.PP
-xkegs is the KEGS binary, compiled for Linux and X\-Window support.
-.PP
-This manual page only documents the command\-line options and key mappings.
-For the full documentation, see /usr/doc/kegs\-@VERSION@/README.kegs.txt
-(and the other files in the same directory).
-.PP
-\fINote:\fR There is no way to specify disk or ROM images on the command line.
-Use the configuration menu (F4) from within the emulator to select images.
-.SH OPTIONS
-.TP
-\fB\-skip\fR \fI[num]\fR
-KEGS will "skip" that many screen redraws between refreshes.
-\-skip 0 will do 60 frames per second, \-skip 1 will do 30 fps,
-\-skip 5 will do 10 fps.
-.TP
-\fB\-audio\fR \fI[0/1]\fR
-Forces audio [off/on].  By default, audio is on unless
-the X display is a remote machine or shared memory is off.
-This switch can override the default.  \-audio 0 causes KEGS to
-not fork the background audio process, but Ensoniq emulation
-is still 100% accurate, just the sound is not sent to the
-workstation speaker.
-.TP
-\fB\-arate\fR \fI[num]\fR
-Forces audio sample rate to \fI[num]\fR.  44100 and 48000 are
-usual, you can try 22050 to reduce KEGS's overhead.  On a reasonably
-fast machine (>250MHz or so), you shouldn't need to mess with this.
-.TP
-\fB\-dhr140\fR
-Will use the old Double\-hires color algorithm that results in
-exactly 140 colors across the screen, as opposed to the blending
-being done by default.
-.TP
-\fB\-15\fR
-KEGS will only look for a 15\-bit X\-Window display.
-.TP
-\fB\-16\fR
-KEGS will only look for a 16\-bit X\-Window display (not tested, probably
- will get red colors wrong).
-.TP
-\fB\-24\fR
-KEGS will only look for a 24\-bit X\-Window display.
-.TP
-\fB\-display\fR \fI[xdisplay]\fR
-Same as setting the environment variable DISPLAY.
-Sends X display to \fI[xdisplay]\fR
-.TP
-\fB\-noshm\fR
-KEGS will not try to used shared memory for the X graphics display.
-This will make KEGS much slower on graphics\-intensive tasks,
-by as much as a factor of 10!  By default, \-noshm causes an
-effective \-skip of 3 which is 15 fps.  You can override this
-default by specifying a \-skip explicitly.
-.SH KEY BINDINGS
-.TP
-\fBF1\fR
-Alias of Command
-.TP
-\fBF2\fR
-Alias of Option
-.TP
-\fBF3\fR
-Alias of ESC for OS/2 compatibility.
-.TP
-\fBF4\fR
-Configuration Panel
-.TP
-\fBF6\fR
-Toggle through the 4 speeds:
-Unlimited, 1MHz, 2.8MHz, 8.0MHz
-.TP
-\fBShift\-F6\fR
-Enter KEGS debugger (can also be done by center\-clicking the mouse on
-the xkegs window).
-.br
-The debugger is X\-based, and runs in a separate window.
-.TP
-\fBF7\fR
-Toggle fast_disk_emul on/off
-.TP
-\fBF8\fR
-Toggle pointer hiding on/off.
-.TP
-\fBF9\fR
-Invert the sense of the joystick.
-.TP
-\fBShift\-F9\fR
-Swap x and y joystick/paddle axes.
-.TP
-\fBF10\fR
-Attempt to change the a2vid_palette (only useful on 256\-color displays)
-.TP
-\fBF11\fR
-Full screen mode (only on Mac OS X).
-.TP
-\fBF12\fR
-Alias of Pause/Break which is treated as Reset
-.TP
-\fBF2\fR, \fBAlt_R\fR, \fBMeta_r\fR, \fBMenu\fR, \fBPrint\fR, \fBMode_switch\fR, \fBOption\fR
-Option key
-.TP
-\fBF1\fR, \fBAlt_L\fR, \fBMeta_L\fR, \fBCancel\fR, \fBScroll_lock\fR, \fBCommand\fR
-Command key
-.TP
-\fBNum_Lock\fR
-Keypad "Clear".
-.TP
-\fBF12\fR, \fBPause\fR, \fBBreak\fR
-Reset
-.TP
-\fBHome\fR
-Alias for "=" on the keypad
-.SH FILES
-.TP
-\fB~/.config.kegs\fR
-The KEGS configuration file. This can be directly edited if
-necessary, but normally is changed by using the configuration
-menu (F4) from within KEGS. To return to the default configuration,
-you may remove this file.
-.TP
-\fB/usr/share/kegs/rom03\fR (or \fB/usr/share/kegs/rom01\fR)
-The Apple IIgs BIOS ROM image. If KEGS can't find this ROM, it
-will start up with a black display, full of white @ characters.
-Press F4 for the config menu and use the UI to select the correct
-ROM image file.
-.PP
-For reference, the ROM image details are:
-.PP
-\fBrom03\fR: size 262144 bytes, md5sum ba89edf2729a28a17cd9e0f7a0ac9a39
-.br
-\fBrom01\fR: size 131072 bytes, md5sum 20a0334c447cb069a040ae5be1d938df
-.PP
-Other versions of the IIgs ROMs may exist (this author isn't aware of any),
-but these two images are known to work.
-.TP
-\fB/usr/bin/xkegs\fR
-Wrapper script. xkegs will fail to run if it can't find its config file,
-so this script creates one in the user's home directory if necessary,
-then runs the real xkegs binary.
-.TP
-\fB/usr/libexec/xkegs\fR
-Actual xkegs binary. Shouldn't be run directly (use the wrapper instead).
-.TP
-\fB/usr/share/kegs/config.kegs.default\fR
-Copied to \fB~/.config.kegs\fR by the wrapper script, if \fB~/.config.kegs\fR
-doesn't already exist. Can be used to set system\-wide defaults (such as the
-path to the ROM image).
-.SH SEE ALSO
-to_pro(1)
-.br
-partls(1)
-.br
-Full KEGS docs in /usr/doc/kegs\-@VERSION@/*.txt
-.br
-KEGS homepage at http://kegs.sourceforge.net/
-.SH AUTHORS
-KEGS is by Kent Dickey <kadickey at princeton dot edu>.
-.PP
-This manual page was written by B. Watson for the SlackBuilds.org project (but
-may be used by anyone for any reason).
-.PP
-Wrapper script also by B. Watson.
diff --git a/system/kegs/man/xkegs.6 b/system/kegs/man/xkegs.6
new file mode 100644
index 0000000000..011871d235
--- /dev/null
+++ b/system/kegs/man/xkegs.6
@@ -0,0 +1,240 @@
+.\" Man page generated from reStructuredText.
+.
+.
+.nr rst2man-indent-level 0
+.
+.de1 rstReportMargin
+\\$1 \\n[an-margin]
+level \\n[rst2man-indent-level]
+level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
+-
+\\n[rst2man-indent0]
+\\n[rst2man-indent1]
+\\n[rst2man-indent2]
+..
+.de1 INDENT
+.\" .rstReportMargin pre:
+. RS \\$1
+. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
+. nr rst2man-indent-level +1
+.\" .rstReportMargin post:
+..
+.de UNINDENT
+. RE
+.\" indent \\n[an-margin]
+.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
+.nr rst2man-indent-level -1
+.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
+.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
+..
+.TH "XKEGS" 6 "2023-09-18" "1.29" "SlackBuilds.org"
+.SH NAME
+xkegs \- Apple IIgs emulator
+.\" RST source for xkegs(6) man page. Convert with:
+.
+.\" rst2man.py man/xkegs.rst > man/xkegs.6
+.
+.SH SYNOPSIS
+.sp
+\fBxkegs\fP [\-skip \fInum\fP] [\-audio [\fI0|1\fP] [\-arate \fInum\fP] [\-dhr140] [\-15] [\-16] [\-24] [\-display \fIxdisplay\fP] [\-noshm]
+.SH DESCRIPTION
+.sp
+KEGS (Kent\(aqs Emulated GS) is an Apple IIgs emulator for Mac OS X,
+Linux, and Win32. The Apple IIgs was the most powerful computer in the
+Apple II line. It first was sold in 1986. An Apple IIgs has the
+capability to run almost all Apple II, Apple IIe, and Apple IIc
+programs.
+.sp
+xkegs is the KEGS binary, compiled for Linux and X\-Window support.
+.sp
+This manual page only documents the command\-line options
+and key mappings. For the full documentation, see
+/usr/doc/kegs\-1.29/README.kegs.txt (and the other files in the
+same directory).
+.sp
+Note: There is no way to specify disk or ROM images on the command
+line. Use the configuration menu (F4) from within the emulator to select images.
+.SH OPTIONS
+.INDENT 0.0
+.TP
+.B \-skip \fInum\fP
+KEGS will "skip" that many screen redraws between refreshes.
+\-skip 0 will do 60 frames per second, \-skip 1 will do 30 fps,
+\-skip 5 will do 10 fps.
+.TP
+.B \-audio \fI0|1\fP
+Forces audio [off/on]. By default, audio is on unless the X
+display is a remote machine or shared memory is off. This
+switch can override the default. \-audio 0 causes KEGS to not
+fork the background audio process, but Ensoniq emulation is
+still 100% accurate, just the sound is not sent to the workstation
+speaker.
+.TP
+.B \-arate \fInum\fP
+Forces audio sample rate to [num]. 44100 and 48000 are usual,
+you can try 22050 to reduce KEGS\(aqs overhead. On a reasonably
+fast machine (>250MHz or so), you shouldn\(aqt need to mess with
+this.
+.TP
+.B \fB\-dhr140\fP
+Will use the old Double\-hires color algorithm that results in
+exactly 140 colors across the screen, as opposed to the blending
+being done by default.
+.TP
+.B \-15
+KEGS will only look for a 15\-bit X\-Window display.
+.TP
+.B \-16
+KEGS will only look for a 16\-bit X\-Window display (not tested, probably
+will get red colors wrong).
+.TP
+.B \-24
+KEGS will only look for a 24\-bit X\-Window display.
+.TP
+.B \-display \fIxdisplay\fP
+Same as setting the environment variable DISPLAY. Sends X display to [xdisplay]
+.TP
+.B \fB\-noshm\fP
+KEGS will not try to used shared memory for the X graphics
+display. This will make KEGS much slower on graphics\-intensive
+tasks, by as much as a factor of 10! By default, \-noshm causes
+an effective \-skip of 3 which is 15 fps. You can override this
+default by specifying a \-skip explicitly.
+.UNINDENT
+.SH KEY BINDINGS
+.INDENT 0.0
+.TP
+.B F1
+Alias of Command
+.TP
+.B F2
+Alias of Option
+.TP
+.B F3
+Alias of ESC for OS/2 compatibility.
+.TP
+.B F4
+Configuration Panel
+.TP
+.B F6
+Toggle through the 4 speeds: Unlimited, 1MHz, 2.8MHz, 8.0MHz
+.TP
+.B Shift\-F6
+Enter KEGS debugger (can also be done by center\-clicking the
+mouse on the xkegs window).
+The debugger is X\-based, and runs in a separate window.
+.TP
+.B F7
+Toggle fast_disk_emul on/off
+.TP
+.B F8
+Toggle pointer hiding on/off.
+.TP
+.B F9
+Invert the sense of the joystick.
+.TP
+.B Shift\-F9
+Swap x and y joystick/paddle axes.
+.TP
+.B F10
+Attempt to change the a2vid_palette (only useful on 256\-color displays)
+.TP
+.B F11
+Full screen mode (only on Mac OS X).
+.TP
+.B F12
+Alias of Pause/Break which is treated as Reset
+.TP
+.B F2, Alt_R, Meta_r, Menu, Print, Mode_switch, Option
+Option key
+.TP
+.B F1, Alt_L, Meta_L, Cancel, Scroll_lock, Command
+Command key
+.TP
+.B Num_Lock
+Keypad "Clear".
+.TP
+.B F12, Pause, Break
+Reset
+.TP
+.B Home
+Alias for "=" on the keypad
+.UNINDENT
+.SH FILES
+.INDENT 0.0
+.TP
+.B ~/.config.kegs
+The KEGS configuration file. This can be directly edited if necessary,
+but normally is changed by using the configuration menu
+(F4) from within KEGS. To return to the default configuration,
+you may remove this file.
+.TP
+.B /usr/share/kegs/rom03 (or /usr/share/kegs/rom01)
+The Apple IIgs BIOS ROM image. If KEGS can\(aqt find this ROM, it
+will start up with a black display, full of white @ characters.
+Press F4 for the config menu and use the UI to select the correct
+ROM image file.
+.sp
+For reference, the ROM image details are:
+.TS
+center;
+|l|l|l|.
+_
+T{
+Filename
+T}	T{
+Size (bytes)
+T}	T{
+md5sum
+T}
+_
+T{
+rom03
+T}	T{
+262144
+T}	T{
+ba89edf2729a28a17cd9e0f7a0ac9a39
+T}
+_
+T{
+rom01
+T}	T{
+131072
+T}	T{
+20a0334c447cb069a040ae5be1d938df
+T}
+_
+.TE
+.sp
+Other versions of the IIgs ROMs may exist (this author isn\(aqt aware of
+any), but these two images are known to work.
+.TP
+.B /usr/bin/xkegs
+Wrapper script. xkegs will fail to run if it can\(aqt find its config
+file, so this script creates one in the user\(aqs home directory
+if necessary, then runs the real xkegs binary.
+.TP
+.B /usr/libexec/xkegs
+Actual xkegs binary. Shouldn\(aqt be run directly (use the wrapper
+instead).
+.TP
+.B /usr/share/kegs/config.kegs.default
+Copied to \fB~/.config.kegs\fP by the wrapper script, if \fB~/.config.kegs\fP
+doesn\(aqt already exist. Can be used to set system\-wide
+defaults (such as the path to the ROM image).
+.UNINDENT
+.SH AUTHORS
+.sp
+KEGS is by Kent Dickey <\fI\%kadickey@alumni.princeton.edu\fP>.
+.sp
+This manual page was written by B. Watson <\fI\%urchlay@slackware.uk\fP> for
+the SlackBuilds.org project, but may be used by anyone for any purpose.
+.sp
+Wrapper script also by B. Watson.
+.SH SEE ALSO
+.sp
+Full KEGS docs in /usr/doc/kegs\-1.29/
+.sp
+KEGS homepage at \fI\%http://kegs.sourceforge.net/\fP
+.\" Generated by docutils manpage writer.
+.
diff --git a/system/kegs/man/xkegs.rst b/system/kegs/man/xkegs.rst
new file mode 100644
index 0000000000..740c2c98d0
--- /dev/null
+++ b/system/kegs/man/xkegs.rst
@@ -0,0 +1,205 @@
+.. RST source for xkegs(6) man page. Convert with:
+..   rst2man.py man/xkegs.rst > man/xkegs.6
+
+.. |version| replace:: 1.29
+.. |date| date::
+
+=====
+xkegs
+=====
+
+-------------------
+Apple IIgs emulator
+-------------------
+
+:Manual section: 6
+:Manual group: SlackBuilds.org
+:Date: |date|
+:Version: |version|
+
+SYNOPSIS
+========
+
+**xkegs** [-skip *num*] [-audio [*0|1*] [-arate *num*] [-dhr140] [-15] [-16] [-24] [-display *xdisplay*] [-noshm]
+
+DESCRIPTION
+===========
+
+KEGS (Kent's Emulated GS) is an Apple IIgs emulator for Mac OS X,
+Linux, and Win32. The Apple IIgs was the most powerful computer in the
+Apple II line. It first was sold in 1986. An Apple IIgs has the
+capability to run almost all Apple II, Apple IIe, and Apple IIc
+programs.
+
+xkegs is the KEGS binary, compiled for Linux and X-Window support.
+
+This manual page only documents the command-line options
+and key mappings. For the full documentation, see
+/usr/doc/kegs-|version|/README.kegs.txt (and the other files in the
+same directory).
+
+Note: There is no way to specify disk or ROM images on the command
+line. Use the configuration menu (F4) from within the emulator to select images.
+
+OPTIONS
+=======
+
+-skip *num*
+  KEGS will "skip" that many screen redraws between refreshes.
+  -skip 0 will do 60 frames per second, -skip 1 will do 30 fps,
+  -skip 5 will do 10 fps.
+
+-audio *0|1*
+  Forces audio [off/on]. By default, audio is on unless the X
+  display is a remote machine or shared memory is off. This
+  switch can override the default. -audio 0 causes KEGS to not
+  fork the background audio process, but Ensoniq emulation is
+  still 100% accurate, just the sound is not sent to the workstation
+  speaker.
+
+-arate *num*
+  Forces audio sample rate to [num]. 44100 and 48000 are usual,
+  you can try 22050 to reduce KEGS's overhead. On a reasonably
+  fast machine (>250MHz or so), you shouldn't need to mess with
+  this.
+
+**-dhr140**
+  Will use the old Double-hires color algorithm that results in
+  exactly 140 colors across the screen, as opposed to the blending
+  being done by default.
+
+-15
+   KEGS will only look for a 15-bit X-Window display.
+
+-16
+   KEGS will only look for a 16-bit X-Window display (not tested, probably
+   will get red colors wrong).
+
+-24
+   KEGS will only look for a 24-bit X-Window display.
+
+-display *xdisplay*
+  Same as setting the environment variable DISPLAY. Sends X display to [xdisplay]
+
+**-noshm**
+  KEGS will not try to used shared memory for the X graphics
+  display. This will make KEGS much slower on graphics-intensive
+  tasks, by as much as a factor of 10! By default, -noshm causes
+  an effective -skip of 3 which is 15 fps. You can override this
+  default by specifying a -skip explicitly.
+
+KEY BINDINGS
+============
+
+F1
+  Alias of Command
+
+F2
+  Alias of Option
+
+F3
+  Alias of ESC for OS/2 compatibility.
+
+F4
+  Configuration Panel
+
+F6
+  Toggle through the 4 speeds: Unlimited, 1MHz, 2.8MHz, 8.0MHz
+
+Shift-F6
+  Enter KEGS debugger (can also be done by center-clicking the
+  mouse on the xkegs window).
+  The debugger is X-based, and runs in a separate window.
+
+F7
+  Toggle fast_disk_emul on/off
+
+F8
+  Toggle pointer hiding on/off.
+
+F9
+  Invert the sense of the joystick.
+
+Shift-F9
+ Swap x and y joystick/paddle axes.
+
+F10
+  Attempt to change the a2vid_palette (only useful on 256-color displays)
+
+F11
+  Full screen mode (only on Mac OS X).
+
+F12
+  Alias of Pause/Break which is treated as Reset
+
+F2, Alt_R, Meta_r, Menu, Print, Mode_switch, Option
+      Option key
+
+F1, Alt_L, Meta_L, Cancel, Scroll_lock, Command
+      Command key
+
+Num_Lock
+  Keypad "Clear".
+
+F12, Pause, Break
+  Reset
+
+Home
+  Alias for "=" on the keypad
+
+FILES
+=====
+
+~/.config.kegs
+  The KEGS configuration file. This can be directly edited if necessary,
+  but normally is changed by using the configuration menu
+  (F4) from within KEGS. To return to the default configuration,
+  you may remove this file.
+
+/usr/share/kegs/rom03 (or /usr/share/kegs/rom01)
+  The Apple IIgs BIOS ROM image. If KEGS can't find this ROM, it
+  will start up with a black display, full of white @ characters.
+  Press F4 for the config menu and use the UI to select the correct
+  ROM image file.
+
+  For reference, the ROM image details are:
+
+  .. csv-table::
+    :header: "Filename", "Size (bytes)", "md5sum"
+
+    "rom03", "262144", "ba89edf2729a28a17cd9e0f7a0ac9a39"
+    "rom01", "131072", "20a0334c447cb069a040ae5be1d938df"
+
+  Other versions of the IIgs ROMs may exist (this author isn't aware of
+  any), but these two images are known to work.
+
+/usr/bin/xkegs
+  Wrapper script. xkegs will fail to run if it can't find its config
+  file, so this script creates one in the user's home directory
+  if necessary, then runs the real xkegs binary.
+
+/usr/libexec/xkegs
+  Actual xkegs binary. Shouldn't be run directly (use the wrapper
+  instead).
+
+/usr/share/kegs/config.kegs.default
+  Copied to **~/.config.kegs** by the wrapper script, if **~/.config.kegs**
+  doesn't already exist. Can be used to set system-wide
+  defaults (such as the path to the ROM image).
+
+AUTHORS
+=======
+
+KEGS is by Kent Dickey <kadickey@alumni.princeton.edu>.
+
+This manual page was written by B. Watson <urchlay@slackware.uk> for
+the SlackBuilds.org project, but may be used by anyone for any purpose.
+
+Wrapper script also by B. Watson.
+
+SEE ALSO
+========
+
+Full KEGS docs in /usr/doc/kegs-|version|/
+
+KEGS homepage at http://kegs.sourceforge.net/