|
|
1.1 root 1: .\" Hey, EMACS: -*- nroff -*-
2: .\" First parameter, NAME, should be all caps
3: .\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
4: .\" other parameters are allowed: see man(7), man(1)
5: .TH "HATARI" "1" "2004-07-20" "Hatari" ""
6: .\" Please adjust this date whenever revising the manpage.
7:
8: .SH "NAME"
9: hatari \- Atari ST emulator
10: .SH "SYNOPSIS"
11: .B hatari
12: .RI [options]
13: .RI [diskimage]
14: .SH "DESCRIPTION"
15: Hatari is an Atari ST emulator for Linux, FreeBSD, BeOS and other Systems which are supported by the SDL library.
16: .PP
17: With hatari one can run games, demos or applications written for Atari ST. It supports the commonly used .st and .msa disk images and hard disk emulation.
18: .PP
19: To run the emulator a TOS ROM image is needed. EmuTOS, a free implementation of TOS is shipped with hatari. Since it is not yet fully compatible with the original TOS some programs won't run correctly with this. Because of this it is recommended to use a TOS ROM from a real Atari.
20: .SH "OPTIONS"
21: .TP
22: .B \-h, \-\-help
23: prints command line options and terminates
24: .TP
25: .B \-v, \-\-version
26: prints version information and terminates
27: .TP
28: .B \-m, \-\-mono
29: starts the emulated Atari ST in monochrome resolution
30: .TP
31: .B \-f, \-\-fullscreen
32: tries to use a fullscreen mode
33: .TP
34: .B \-j, \-\-joystick
35: activates joystick emulation via cursor keys
36: .TP
37: .B \-\-nosound
38: disables sound (makes emulation faster)
39: .TP
40: .B \-\-frameskip
41: drops every second frame (accelerates emulation)
42: .TP
43: .B \-D, \-\-debug
44: activates the simple builtin debugger
45: .TP
46: .B \-\-slowfdc
47: slows down FDC emulation (needed to make some games and demos work)
48: .TP
49: .B \-d, \-\-harddrive <dir>
50: emulates <dir> as a hard disk
51: .TP
52: .B \-\-hdimage <imagefile>
53: emulate hard disk with an image file
54: .TP
55: .B \-\-tos <imagefile>
56: specify TOS ROM image to use
57: .TP
58: .B \-\-memsize x
59: set amount of emulated RAM
60: .br
61: x=0 for 512K,
62: .br
63: x=1,x=2 or x=4 for 1,2 or 4 MB
64: .TP
65: .B
66: \-\-cpulevel x
67: specify CPU (680x0) to use (TOS 2.06 only!!)
68: .TP
69: .B
70: \-\-compatible
71: use a more compatible but slower 68000 CPU mode
72: .TP
73: .B
74: \-\-blitter
75: enable blitter emulation
76: .TP
77: .B
78: \-\-vdi
79: use extended VDI resolution
80: .TP
81: .B
82: \-\-printer
83: enable experimental printer support
84: .TP
85: .B
86: \-\-midi <filename>
87: enable experimental MIDI output to the mentioned file
88: .TP
89: .B
90: \-\-rs232 <filename>
91: enable experimental RS232 emulation via the mentioned file/device
92: .TP
93: .B \-c, \-\-configfile <filename>
94: Use the mentioned file as configuration file instead of ~/.hatari.cfg
95:
96: .SH "COMMANDS"
97: .TP
98: .B AltGr + a
99: record animation
100: .TP
101: .B AltGr + g
102: grab a screenshot
103: .TP
104: .B AltGr + i
105: boss key: leave full screen mode and iconify window
106: .TP
107: .B AltGr + j
108: activate joystick emulation via cursor keys
109: .TP
110: .B AltGr + m
111: (un-)lock the mouse into the window
112: .TP
113: .B AltGr + r
114: (warm) reset the ST
115: .TP
116: .B AltGr + c
117: coldreset the ST (same as the original power switch)
118: .TP
119: .B AltGr + s
120: enable/disable sound
121: .TP
122: .B AltGr + q
123: quit the emulator
124: .TP
125: .B AltGr + x
126: toggle normal/max speed
127: .TP
128: .B AltGr + y
129: enable/disable sound recording
130: .TP
131: .B F11
132: toggle between fullscreen and windowed mode
133: .TP
134: .B F12
135: activate the hatari command GUI
136: .br
137: You may need to hold SHIFT down while in windowed mode.
138: .TP
139: .B Pause
140: will go to the debugger if it was activated at compile time
141:
142: .SH Emulated Atari ST keyboard
143: All other keys on the keyboard act as the normal Atari ST keys so pressing SPACE on your PC will result in an emulated press of the SPACE key on the ST. The following keys have special meanings:
144: .TP
145: .B Alt
146: will act as the ST's ALTERNATE key
147: .TP
148: .B left Ctrl
149: will act as the ST's CONTROL key
150: .TP
151: .B Page Up
152: will emulate the ST's HELP key
153: .TP
154: .B Page Down
155: will emulate the ST's UNDO key
156: .PP
157: .B AltGr
158: will act as
159: .B Alternate
160: as well as long as you do not press it together with a Hatari hotkey combination.
161:
162: The
163: .B right Ctrl
164: key is used as the fire button of the emulated joystick when you turn on joystick emulation via keyboard.
165:
166: The cursor keys will act as the cursor keys on the Atari ST as long as joystick emulation via keyboard has been turned off.
167:
168: .SH "SEE ALSO"
169: The main program documentation, usually in /usr/share/doc/.
170: .PP
171: The homepage of hatari: http://hatari.sourceforge.net
172:
173: .SH "AUTHOR"
174: This manual page was written by Marco Herrn <[email protected]>,
175: for the Debian project and later modified by Thomas Huth to suit the latest
176: version of Hatari.
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.