DWARF information support updates
[clinton/Virtual-Jaguar-Rx.git] / docs / virtualjaguar.1
index fda9eb9..9c85eb2 100644 (file)
@@ -1,11 +1,11 @@
-.TH virtualjaguar 1 2017-09-06 Virtualjaguar Rx
+.TH virtualjaguar 1 2018-09-19 Virtualjaguar Rx
 .SH NAME
 virtualjaguar \- An Atari Jaguar emulator
 
 .SH SYNOPSIS
 .B virtualjaguar
 .RI [options]
 .SH NAME
 virtualjaguar \- An Atari Jaguar emulator
 
 .SH SYNOPSIS
 .B virtualjaguar
 .RI [options]
-.RI [rom\ image\ file]
+.RI [rom image file]
 
 .SH DESCRIPTION
 Virtualjaguar is an emulator for the Atari Jaguar videogame system.
 
 .SH DESCRIPTION
 Virtualjaguar is an emulator for the Atari Jaguar videogame system.
@@ -13,7 +13,7 @@ Virtualjaguar is an emulator for the Atari Jaguar videogame system.
 .SH OPTIONS
 .TP
 .B [rom image file]
 .SH OPTIONS
 .TP
 .B [rom image file]
-Name of file to load
+Name of file to load;
 .TP
 .B \-a, \-\-alpine
 Run in Alpine emulation mode
 .TP
 .B \-a, \-\-alpine
 Run in Alpine emulation mode
@@ -24,10 +24,10 @@ Boot using Jaguar BIOS
 .B \-\-no\-bios
 Do not use Jaguar BIOS
 .TP
 .B \-\-no\-bios
 Do not use Jaguar BIOS
 .TP
-.B \-a, \-\-debugger
+.B \-D, \-\-debugger
 Run in Debugger emulation mode
 .TP
 Run in Debugger emulation mode
 .TP
-.B \-a, \-\-dram-max
+.B , \-\-dram-max
 Set the main ram to 8MB
 .TP
 .B \-g, \-\-gpu
 Set the main ram to 8MB
 .TP
 .B \-g, \-\-gpu
@@ -42,11 +42,22 @@ Create and use log file
 .B \-\-no\-log
 Do not use log file
 .TP
 .B \-\-no\-log
 Do not use log file
 .TP
-.B \-h, \-\-help
+.B \-h, \-?, \-\-help
 Show command line help
 
 Show command line help
 
+.SH SETTINGS
+.TP
+.B \-\-es\-all
+Erase all settings,
+.B \-\-es\-ui
+Erase UI settings only,
+.B \-\-es\-alpine
+Erase alpine mode settings only,
+.B \-\-es\-debugger
+Erase debugger mode settings only
+
 .SH SOUND
 .SH SOUND
-DSP emulation is needed for audio output
+DSP emulation is needed for audio output;
 .TP
 .B \-d, \-\-dsp
 Enable DSP emulation
 .TP
 .B \-d, \-\-dsp
 Enable DSP emulation
@@ -74,53 +85,74 @@ Disable GL bilinear filter
 .B \-z, \-\-please\-dont\-kill\-my\-computer
 Do not show emulation of tv static. This can be slow on low end CPUs.
 
 .B \-z, \-\-please\-dont\-kill\-my\-computer
 Do not show emulation of tv static. This can be slow on low end CPUs.
 
-.SH CONTROLS
+.SH SHORTCUTS
+.TP
+The default key bindings are:
 .TP
 .B Ctrl-Q
 .TP
 .B Ctrl-Q
-Quit virtualjaguar
+Quit virtualjaguar,
 .TP
 .B Ctrl-I
 .TP
 .B Ctrl-I
-Load a new program
+Load a new program,
+.TP
+.B Ctrl+C
+Configure tab,
+.TP
+.B Ctrl+S
+Emulator status,
+.TP
+.B Ctrl+Shift+F5
+Restart program,
+.TP
+.B F11
+Step into code,
+.TP
+.B F10
+Step over code,
 .TP
 .B Esc
 .TP
 .B Esc
-Pause emulation
+Pause emulation,
 .TP
 .B F7
 .TP
 .B F7
-Advance the emulation by a single frame
+Advance the emulation by a single frame,
 .TP
 .B F9
 .TP
 .B F9
-Toggle full screen mode
+Toggle full screen mode,
+.TP
+.B F8
+Screenshot
 
 
+.SH CONTROLS
 .TP
 .TP
-The default keybindings for controller 1 are:
-(Keybindings can be changed in the configuration dialog.)
+The default key bindings for controller 1 are:
+(Key bindings can be changed in the configuration dialog.)
 .TP
 .B S
 .TP
 .B S
-Up
+Up,
 .TP
 .B X
 .TP
 .B X
-Down
+Down,
 .TP
 .B A
 .TP
 .B A
-Left
+Left,
 .TP
 .B D
 .TP
 .B D
-Right
+Right,
 .TP
 .B P
 .TP
 .B P
-Pause
+Pause,
 .TP
 .B O
 .TP
 .B O
-Option
+Option,
 .TP
 .B J
 .TP
 .B J
-Button C
+Button C,
 .TP
 .B K
 .TP
 .B K
-Button B
+Button B,
 .TP
 .B L
 .TP
 .B L
-Button A
+Button A,
 .TP
 .B 1 through 0
 Buttons 1 through 0 on the keypad
 .TP
 .B 1 through 0
 Buttons 1 through 0 on the keypad
@@ -132,19 +164,22 @@ Keypad *
 Keypad #
 
 .SH FILES
 Keypad #
 
 .SH FILES
-.TP
+.PP
 .B virtualjaguar.log
 Virtualjaguar log file. Only written if the log option (\-l or
 \-\-log) is given. If the file cannot be opened, the log it sent to
 standard output instead. The log file is overwritten on startup. Note
 that the file is written to the current directory.
 .B virtualjaguar.log
 Virtualjaguar log file. Only written if the log option (\-l or
 \-\-log) is given. If the file cannot be opened, the log it sent to
 standard output instead. The log file is overwritten on startup. Note
 that the file is written to the current directory.
-.TP
+.PP
+.B ${XDG_DATA_HOME}/virtualjaguar/screenshots/ (typically ~/.local/share/data/virtualjaguar/screenshots/)
+Screenshots will be save in this directory.
+.PP
 .B ${XDG_DATA_HOME}/virtualjaguar/eeproms/ (typically ~/.local/share/data/virtualjaguar/eeproms/)
 Some Atari Jaguar cartridges feature a small writable EEPROM, used for
 saving game state and score lists. If this directory exists,
 virtualjaguar will emulate the EEPROM by saving the state in file in
 this directory.
 .B ${XDG_DATA_HOME}/virtualjaguar/eeproms/ (typically ~/.local/share/data/virtualjaguar/eeproms/)
 Some Atari Jaguar cartridges feature a small writable EEPROM, used for
 saving game state and score lists. If this directory exists,
 virtualjaguar will emulate the EEPROM by saving the state in file in
 this directory.
-.TP
+.PP
 .B ${XDG_DATA_HOME}/virtualjaguar/software/ (typically ~/.local/share/data/virtualjaguar/software/)
 The virtualjaguar GUI for loading software scans this directory, and
 shows the loadable files, along with information about the program,
 .B ${XDG_DATA_HOME}/virtualjaguar/software/ (typically ~/.local/share/data/virtualjaguar/software/)
 The virtualjaguar GUI for loading software scans this directory, and
 shows the loadable files, along with information about the program,
@@ -152,4 +187,4 @@ and a label image if one is included in a zip archive of the software.
 
 .SH AUTHOR
 This manual page was written by Teemu Hukkanen <tjhukkan@iki.fi>.
 
 .SH AUTHOR
 This manual page was written by Teemu Hukkanen <tjhukkan@iki.fi>.
-Additional informations written by Flynn.
+Additional information written by Jean-Paul Mari <djipi.mari@gmail.com>.