system/kegs: Updated for version 1.29.

Signed-off-by: B. Watson <urchlay@slackware.uk>

Signed-off-by: Willy Sudiarto Raharjo <willysr@slackbuilds.org>

6 files changed, 463 insertions, 189 deletions

diff --git a/system/kegs/kegs.SlackBuild b/system/kegs/kegs.SlackBuild
index 39384d6405..58bc24480a 100644
--- a/system/kegs/kegs.SlackBuild
+++ b/system/kegs/kegs.SlackBuild
@@ -6,6 +6,7 @@
 
 # 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.
@@ -36,7 +37,7 @@
 cd $(dirname $0) ; CWD=$(pwd)
 
 PRGNAM=kegs
-VERSION=${VERSION:-1.16}
+VERSION=${VERSION:-1.29}
 BUILD=${BUILD:-1}
 TAG=${TAG:-_SBo}
 PKGTYPE=${PKGTYPE:-tgz}
@@ -84,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
@@ -103,6 +102,7 @@ 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
@@ -113,14 +113,14 @@ 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 -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
 
@@ -143,19 +143,19 @@ 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 4db5439af8..1bf7277e30 100644
--- a/system/kegs/kegs.info
+++ b/system/kegs/kegs.info
@@ -1,9 +1,9 @@
 PRGNAM="kegs"
-VERSION="1.16"
+VERSION="1.29"
 HOMEPAGE="http://kegs.sourceforge.net/"
-DOWNLOAD="http://kegs.sourceforge.net/kegs.1.16.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="5908b495173b36b5905954c151d64cc0 \
+MD5SUM="f4de669e957d0c9570de07ec960e8427 \
         029ebd31845614636f6a34a19730cd57"
 DOWNLOAD_x86_64=""
 MD5SUM_x86_64=""
diff --git a/system/kegs/man/xkegs.1 b/system/kegs/man/xkegs.1
deleted file mode 100644
index 9728c6cc53..0000000000
--- a/system/kegs/man/xkegs.1
+++ /dev/null
@@ -1,171 +0,0 @@
-.TH KEGS "1" "August 2021" "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
-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@alumni.princeton.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/