system/kegs: Updated for version 1.05.

Signed-off-by: B. Watson <yalhcru@gmail.com>

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

3 files changed, 253 insertions, 0 deletions

diff --git a/system/kegs/man/partls.1 b/system/kegs/man/partls.1
new file mode 100644
index 0000000000000..1af148532b809
--- /dev/null
+++ b/system/kegs/man/partls.1
@@ -0,0 +1,23 @@
+.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
new file mode 100644
index 0000000000000..a58fada52dcbe
--- /dev/null
+++ b/system/kegs/man/to_pro.1
@@ -0,0 +1,55 @@
+.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
new file mode 100644
index 0000000000000..eb14f217e6235
--- /dev/null
+++ b/system/kegs/man/xkegs.1
@@ -0,0 +1,175 @@
+.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.