Annotation of hatari/doc/hatari.1, revision 1.1.1.1

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.

unix.superglobalmegacorp.com

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.