diff options
Diffstat (limited to 'system/kegs/man')
-rw-r--r-- | system/kegs/man/xkegs.1 | 171 | ||||
-rw-r--r-- | system/kegs/man/xkegs.6 | 240 | ||||
-rw-r--r-- | system/kegs/man/xkegs.rst | 205 |
3 files changed, 445 insertions, 171 deletions
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/ |