games/yae: Added (Yet another Apple Emulator).

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

1 files changed, 122 insertions, 0 deletions

diff --git a/games/yae/yae.pod b/games/yae/yae.pod
new file mode 100644
index 0000000000..dbb72b976e
--- /dev/null
+++ b/games/yae/yae.pod
@@ -0,0 +1,122 @@
+# pod2man -r0.7 -s1 --stderr -cyae yae.pod > yae.1
+
+=pod
+
+=head1 NAME
+
+B<yae> - Yet another Apple Emulator
+
+=head1 SYNOPSIS
+
+B<yae> [-2|-e|-+] [disk-image] ...
+
+=head1 DESCRIPTION
+
+B<yae> emulates the Apple II, II+, and //e 8-bit computers from Apple,
+Inc. Standard .dsk images are supported. If B<yae> is run without any
+disk image arguments, I</usr/share/yae/Master.dsk> will be booted.
+
+ROM image files are required; see B<FILES> for details.
+
+OSS audio is supported, using the /dev/audio device. For Linux systems
+using ALSA, OSS audio is provided by the snd_pcm_oss and snd_mixer_oss
+kernel modules. If /dev/audio can't be opened, the emulator will run
+with sound disabled.
+
+=head1 OPTIONS
+
+=over
+
+=item -2
+
+Emulate the Apple II.
+
+Note that the emulator uses the same ROM image for II and II+, so the
+emulated II will have Applesoft and autostart (which the original II
+didn't ship with).
+
+=item -+
+
+Emulate the Apple II+.
+
+=item -e
+
+Emulate the Apple //e (the default).
+
+=back
+
+=head1 KEYSTROKES
+
+=over
+
+=item Backspace
+
+Alias for the left-arrow key.
+
+=item Control+Delete
+
+Apple Reset key.
+
+=item Left Alt
+
+The left (open) apple key on the //e keyboard.
+
+=item Right Alt
+
+The right (closed) apple key on the //e keyboard.
+
+=item F1
+
+Change disks in the first drive (slot 6, drive 0). This will either
+read a filename on standard input (if kdialog can't be run), or display
+a kdialog file-selector. Either way, the emulator stops and its window
+becomes unresponsive until a file has been chosen.
+
+=item F2
+
+Exit the emulator immediately. No confirmation dialog, so
+be careful.
+
+=back
+
+All other keystrokes are translated to their equivalent Apple II
+keystrokes, or ignored if there is no equivalent key on the Apple
+keyboard.
+
+=head1 FILES
+
+=over
+
+=item B<.yaerc>, B<~/.yaerc>
+
+Config file. Searched for first in the current directory,
+then in user's home directory. For config file syntax, see
+I</usr/share/yae/yaerc.sample>.
+
+=item ROM files
+
+For II and II+ emulation, the required ROM image is called B<APPLE2.ROM>.
+For the //e, the image is B<APPLE2E.ROM>. For all modes, B<DISK.ROM> is
+required.
+
+ROM file locations can be set in the config file. By default, they're
+searched for in the current directory. If the ROMs can't be found in
+the configured location or the current directory, they will searched
+for in I</usr/share/yae>.
+
+If the required ROM files can't be found, the emulator will refuse
+to start.
+
+=back
+
+=head1 SEE ALSO
+
+B<kegs>(1), B<dos33fsutils>(1)
+
+=head1 AUTHORS
+
+B<yae> was originally written by Doug Kwan, and includes enhancements by
+Warren Toomey. The version documented here also has some small bugfixes
+and enhancements by B. Watson.
+
+This man page was written by B. Watson.