summaryrefslogtreecommitdiff
path: root/games/yae/yae.pod
blob: 2b258b25b9d80ccb7c8ab5f9e5067036947a050f (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
# 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.

ALSA audio is supported, by linking the emulator with B<-laoss>. This
also allows PulseAudio to work, if you have the default ALSA device
set to "pcm.default pulse" (and "ctl.default pulse") in B</etc/asound.conf>.

=head1 OPTIONS

=over

=item B<-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 B<-+>

Emulate the Apple II+.

=item B<-e>

Emulate the Apple //e (the default).

=back

=head1 KEYSTROKES

=over

=item B<Backspace>

Alias for the left-arrow key.

=item B<Control+Delete>

Apple Reset key.

=item B<Left Alt>

The left (open) apple key on the //e keyboard.

=item B<Right Alt>

The right (closed) apple key on the //e keyboard.

=item B<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 B<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 B<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.