aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--games/stella/stella.61665
-rw-r--r--games/stella/stella.SlackBuild18
-rw-r--r--games/stella/stella.info6
-rw-r--r--games/stella/stella.pod1411
4 files changed, 644 insertions, 2456 deletions
diff --git a/games/stella/stella.6 b/games/stella/stella.6
index 0831ce29c1935..d7c868fd3b0ce 100644
--- a/games/stella/stella.6
+++ b/games/stella/stella.6
@@ -1,1127 +1,726 @@
-.\" Automatically generated by Pod::Man 2.28 (Pod::Simple 3.29)
-.\"
-.\" Standard preamble:
-.\" ========================================================================
-.de Sp \" Vertical space (when we can't use .PP)
-.if t .sp .5v
-.if n .sp
-..
-.de Vb \" Begin verbatim text
-.ft CW
-.nf
-.ne \\$1
-..
-.de Ve \" End verbatim text
-.ft R
-.fi
-..
-.\" Set up some character translations and predefined strings. \*(-- will
-.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
-.\" double quote, and \*(R" will give a right double quote. \*(C+ will
-.\" give a nicer C++. Capital omega is used to do unbreakable dashes and
-.\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff,
-.\" nothing in troff, for use with C<>.
-.tr \(*W-
-.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
-.ie n \{\
-. ds -- \(*W-
-. ds PI pi
-. if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
-. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
-. ds L" ""
-. ds R" ""
-. ds C` ""
-. ds C' ""
-'br\}
-.el\{\
-. ds -- \|\(em\|
-. ds PI \(*p
-. ds L" ``
-. ds R" ''
-. ds C`
-. ds C'
-'br\}
-.\"
-.\" Escape single quotes in literal strings from groff's Unicode transform.
-.ie \n(.g .ds Aq \(aq
-.el .ds Aq '
-.\"
-.\" If the F register is turned on, we'll generate index entries on stderr for
-.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
-.\" entries marked with X<> in POD. Of course, you'll have to process the
-.\" output yourself in some meaningful fashion.
-.\"
-.\" Avoid warning from groff about undefined register 'F'.
-.de IX
-..
-.nr rF 0
-.if \n(.g .if rF .nr rF 1
-.if (\n(rF:(\n(.g==0)) \{
-. if \nF \{
-. de IX
-. tm Index:\\$1\t\\n%\t"\\$2"
-..
-. if !\nF==2 \{
-. nr % 0
-. nr F 2
-. \}
-. \}
-.\}
-.rr rF
-.\" ========================================================================
-.\"
-.IX Title "STELLA 6"
-.TH STELLA 6 "2017-08-21" "5.0.2" "SlackBuilds.org"
-.\" For nroff, turn off justification. Always turn off hyphenation; it makes
-.\" way too many mistakes in technical documents.
-.if n .ad l
-.nh
-.SH "NAME"
-stella \- an Atari 2600 emulator
-.SH "SYNOPSIS"
-.IX Header "SYNOPSIS"
-\&\fBstella\fR \fIoptions\fR \fI\s-1ROM\s0 file\fR
-.SH "DESCRIPTION"
-.IX Header "DESCRIPTION"
-\&\fBstella\fR is a comprehensive emulator of the old Atari 2600 video-game
+.TH stella 6 "January 12, 2019" stella
+.SH NAME
+stella \- Atari 2600 emulator
+.SH SYNOPSIS
+.B stella
+[\fIoptions\fP] <\fIROM file\fP>
+.SH DESCRIPTION
+.B stella
+is a comprehensive emulator of the old Atari 2600 video-game
console. It support most Atari 2600 games and many peripherals.
.PP
-If you start Stella and do not specify a \s-1ROM\s0 image, it will start in
-\&'\s-1ROM\s0 Launcher' mode. If this is your first time starting Stella, you
-will be asked to select the default \s-1ROM\s0 directory to use.
-.PP
-This man page only documents the command-line options and default
-keybindings. The complete documentation is in \fIindex.html\fR and
-\&\fIdebugger.html\fR, usually installed in \fI/usr/share/doc/stella/\fR or
-\&\fI/usr/doc/stella\-4.7.2/\fR.
-.SH "OPTIONS"
-.IX Header "OPTIONS"
-.IP "\fB\-video\fR <direct3d|opengl|opengles2|opengles|software>" 4
-.IX Item "-video <direct3d|opengl|opengles2|opengles|software>"
-Use the given rendering backend (where applicable); default is the best
-available mode detected.
-.IP "\fB\-vsync\fR <1|0>" 4
-.IX Item "-vsync <1|0>"
+.SH OPTIONS
+.B stella
+accepts the following options:
+.TP
+.BR \-video " <" opengl | opengles2 | opengles | software >
+Use OpenGL, OpenGLES or SDL software rendering mode; the default is
+the best available mode detected.
+.TP
+.BR \-vsync " <" 1 | 0 >
Synchronize screen updates to the vertical blank period. This can
result in smoother updates, and eliminate tearing.
-.IP "\fB\-fullscreen\fR <1|0>" 4
-.IX Item "-fullscreen <1|0>"
-Enable fullscreen mode.
-.IP "\fB\-center\fR <1|0>" 4
-.IX Item "-center <1|0>"
+.TP
+.BR \-fullscreen " <" 1 | 0 >
+Play the game in fullscreen mode (\fB1\fP) or in a window (\fB0\fP).
+.TP
+.BR \-center " <" 1 | 0 >
Centers game window (if possible).
-.IP "\fB\-palette\fR <standard|z26|user>" 4
-.IX Item "-palette <standard|z26|user>"
-Set the palette to either normal Stella, the one used in the z26
+.TP
+.BR \-palette " <" standard | z26 | user >
+Sets the palette to either normal Stella, the one used in the \fBz26\fP
emulator, or a user-defined palette.
-.IP "\fB\-colorloss\fR <1|0>" 4
-.IX Item "-colorloss <1|0>"
-Enable/disable the \s-1PAL\s0 color-loss effect.
-.IP "\fB\-framerate\fR <number>" 4
-.IX Item "-framerate <number>"
-Display the given number of frames per second. Normally, Stella will
-determine framerate based on number of scanlines. Setting this to 0
-automatically enables auto-frame calculation (ie, framerate based on
-scanlines).
-.IP "\fB\-timing\fR <sleep|busy>" 4
-.IX Item "-timing <sleep|busy>"
-Determines type of wait to perform between processing frames. Sleep
-will release the \s-1CPU\s0 as much as possible, and is the preferred method
-on laptops (and other low-powered devices) and when using VSync. Busy
-will emulate z26 busy-wait behaviour, and use all possible \s-1CPU\s0 time,
-but may eliminate graphical 'tearing' in software mode.
-.IP "\fB\-uimessages\fR <1|0>" 4
-.IX Item "-uimessages <1|0>"
-Enable or disable display of message in the \s-1UI.\s0 Note that messages
-indicating serious errors override this setting, and are always shown.
-.IP "\fB\-sound\fR <1|0>" 4
-.IX Item "-sound <1|0>"
+.TP
+.BR \-speed " <\fInumber\fP>"
+Controls the emulation speed (as a percentage, between 10 and 1000,
+from one-tenth the native speed to ten times the native speed).
+.TP
+.BR \-uimessages " <" 1 | 0 >
+Enable or disable display of message in the UI.
+Note that messages indicating serious errors override this setting,
+and are always shown.
+.TP
+.BR \-sound " <" 1 | 0 >
Enable or disable sound generation.
-.IP "\fB\-fragsize\fR <number>" 4
-.IX Item "-fragsize <number>"
-Specify the sound fragment size to use. Linux/Mac seems to work with
-512, Windows usually needs 1024.
-.IP "\fB\-freq\fR <number>" 4
-.IX Item "-freq <number>"
-Set sound sample output frequency (11025,22050,31400,44100,48000)
-Default is 31400. Do not change unless you experience sound issues.
-.IP "\fB\-volume\fR <number>" 4
-.IX Item "-volume <number>"
-Set the volume (0 \- 100).
-.IP "\fB\-tia.zoom\fR <zoom>" 4
-.IX Item "-tia.zoom <zoom>"
+.TP
+.BR \-fragsize " <\fInumber\fP>"
+Specify the sound fragment size to use. Under Debian the recommended
+value is 512.
+.TP
+.BR \-freq " <\fInumber\fP>"
+Set sound sample output frequency (0 - 48000). Default is 31400. Do
+not change unless you experience sound issues.
+.TP
+.BR \-volume " <\fInumber\fP>"
+Set the volume (0 - 100).
+.TP
+.BR \-tia.zoom " <\fInumber\fP>"
Use the specified zoom level (integer) while in TIA/emulation mode.
-.IP "\fB\-tia.inter\fR <1|0>" 4
-.IX Item "-tia.inter <1|0>"
-Use interpolation for the \s-1TIA\s0 image (results in blending/smoothing of
+.TP
+.BR \-tia.inter " <" 1 | 0 >
+Use interpolation for the TIA image (results in blending/smoothing of
the image).
-.IP "\fB\-tia.aspectn\fR <number>" 4
-.IX Item "-tia.aspectn <number>"
-.PD 0
-.IP "\fB\-tia.aspectp\fR <number>" 4
-.IX Item "-tia.aspectp <number>"
-.PD
-Specify the amount (as a percentage) to scale the \s-1TIA\s0 image width in
-\&\s-1NTSC\s0 and \s-1PAL\s0 mode. Since many video modes do not use square pixels, you
-can reduce width until the pixels appear square. Allowable values are
-80 \- 120; I find 85 \- 90 gives the most authentic look for \s-1NTSC,\s0 and
-105 \- 110 for \s-1PAL.\s0
-.IP "\fB\-tia.fsfill\fR <1|0>" 4
-.IX Item "-tia.fsfill <1|0>"
-Stretch \s-1TIA\s0 image completely while in fullscreen mode (vs. an integral
+.TP
+.BR \-tia.aspectn " <\fInumber\fP>, " \-tia.aspectp " <\fInumber\fP>"
+Specify the amount (as a percentage) to scale the TIA image width in
+NTSC and PAL mode. Since many video modes do not use square pixels,
+you can reduce width until the pixels appear square. Allowable values
+are 80\-120; the author finds 85\-90 gives the mos authentic look for
+NTSC, and 105\-110 for PAL.
+.TP
+.BR \-tia.fsfill " <" 1 | 0 >
+Stretch TIA image completely while in fullscreen mode (vs. an integral
stretch which won't necessarily completely fill the screen).
-.IP "\fB\-tia.dbgcolors\fR <roygbp>" 4
-.IX Item "-tia.dbgcolors <roygbp>"
-Assigns the colours (R)ed, (O)range, (Y)ellow, (G)reen,
-(B)lue and (P)urple to each graphical register P0/M0/P1/M1/PF/BL,
-respectively. Currently, these can be changed around to apply different
-colours to the respective register.
-.IP "\fB\-tv.phosphor\fR <always|byrom>" 4
-.IX Item "-tv.phosphor <always|byrom>"
-When to use phosphor mode.
-.IP "\fB\-tv.phosblend\fR <0 \- 100>" 4
-.IX Item "-tv.phosblend <0 - 100>"
-Set default blend level in phosphor mode.
-.IP "\fB\-tv.filter\fR <1 \- 6>" 4
-.IX Item "-tv.filter <1 - 6>"
-Blargg \s-1TV\s0 effects, 0 is disabled, next numbers in sequence represent
-presets for 'Composite', 'S\-Video', '\s-1RGB\s0', 'Bad Adjust', and 'Custom'
+.TP
+.BR \-tia.dbgcolors " <\fIroygbp\fP>"
+Assigns the colours (r)ed, (o)range, (y)ellow, (g)reen, (b)lue and
+(p)urple to each graphical register P0/M0/P1/M1/PF/BL, respectively.
+Currently, these can be changed around to apply different colours to
+the respective register.
+.TP
+.BR \-tv.filter " <" 0 \- 5 >
+Blargg TV effects, 0 is disabled, next numbers in sequence represent
+presets for "Composite", "S-Video", "RGB", "Bad Adjust" and "Custom"
modes.
-.IP "\fB\-tv.scanlines\fR <0 \- 100>" 4
-.IX Item "-tv.scanlines <0 - 100>"
-Blargg \s-1TV\s0 effects scanline intensity, where 0 means completely off.
-.IP "\fB\-tv.scaninter\fR <1|0>" 4
-.IX Item "-tv.scaninter <1|0>"
-Blargg \s-1TV\s0 effects scanline interpolation, resulting in
+.TP
+.BR \-tv.phosphor " <" always | byrom >
+Determines how phosphor mode is enabled. If
+.BR always ,
+then the ROM properties entry is ignored, and phosphor mode is always
+turned on.
+Otherwise, the ROM properties determine whether phosphor mode is used
+for each ROM.
+.TP
+.BR \-tv.scanlines " <" 0 \- 100 >
+TV effects scanline intensity, where 0 means completely off.
+.TP
+.BR \-tv.scaninter " <" 1 | 0 >
+Blargg TV effects scanline interpolation, resulting in
blending/smoothing of the scanlines.
-.IP "\fB\-tv.jitter\fR <1|0>" 4
-.IX Item "-tv.jitter <1|0>"
-Enable \s-1TV\s0 jitter effect.
-.IP "\fB\-tv.jitter_recovery\fR <1 \- 20>" 4
-.IX Item "-tv.jitter_recovery <1 - 20>"
-Set recovery time for \s-1TV\s0 jitter effect.
-.IP "\fB\-tv.contrast\fR <number>" 4
-.IX Item "-tv.contrast <number>"
-Blargg \s-1TV\s0 effects 'contrast' (only available in custom mode, range \-1.0
-to 1.0).
-.IP "\fB\-tv.brightness\fR <number>" 4
-.IX Item "-tv.brightness <number>"
-Blargg \s-1TV\s0 effects 'brightness' (only available in custom mode, range
-\&\-1.0 to 1.0).
-.IP "\fB\-tv.hue\fR <number>" 4
-.IX Item "-tv.hue <number>"
-Blargg \s-1TV\s0 effects 'hue' (only available in custom mode, range \-1.0 to
+.TP
+.BR \-tv.contrast " <\fInumber\fP>"
+Blargg TV effects 'contrast' (only available in custom mode, range
+\-1.0 to 1.0).
+.TP
+.BR \-tv.brightness " <\fInumber\fP>"
+Blargg TV effects 'brightness' (only available in custom mode, range
+\-1.0 to 1.0).
+.TP
+.BR \-tv.hue " <\fInumber\fP>"
+Blargg TV effects 'hue' (only available in custom mode, range \-1.0 to
1.0).
-.IP "\fB\-tv.saturation\fR <number>" 4
-.IX Item "-tv.saturation <number>"
-Blargg \s-1TV\s0 effects 'saturation' (only available in custom mode, range
-\&\-1.0 to 1.0).
-.IP "\fB\-tv.gamma\fR <number>" 4
-.IX Item "-tv.gamma <number>"
-Blargg \s-1TV\s0 effects 'gamma' (only available in custom mode, range \-1.0 to
-1.0).
-.IP "\fB\-tv.sharpness\fR <number>" 4
-.IX Item "-tv.sharpness <number>"
-Blargg \s-1TV\s0 effects 'sharpness' (only available in custom mode, range
-\&\-1.0 to 1.0).
-.IP "\fB\-tv.resolution\fR <number>" 4
-.IX Item "-tv.resolution <number>"
-Blargg \s-1TV\s0 effects 'resolution' (only available in custom mode, range
-\&\-1.0 to 1.0).
-.IP "\fB\-tv.artifacts\fR <number>" 4
-.IX Item "-tv.artifacts <number>"
-Blargg \s-1TV\s0 effects 'artifacts' (only available in custom mode, range
-\&\-1.0 to 1.0).
-.IP "\fB\-tv.fringing\fR <number>" 4
-.IX Item "-tv.fringing <number>"
-Blargg \s-1TV\s0 effects 'fringing' (only available in custom mode, range \-1.0
+.TP
+.BR \-tv.saturation " <\fInumber\fP>"
+Blargg TV effects 'saturation' (only available in custom mode, range
+\-1.0 to 1.0).
+.TP
+.BR \-tv.gamma " <\fInumber\fP>"
+Blargg TV effects 'gamma' (only available in custom mode, range \-1.0
to 1.0).
-.IP "\fB\-tv.bleed\fR <number>" 4
-.IX Item "-tv.bleed <number>"
-Blargg \s-1TV\s0 effects 'bleed' (only available in custom mode, range \-1.0 to
-1.0).
-.IP "\fB\-cheat\fR <code>" 4
-.IX Item "-cheat <code>"
-Use the specified cheatcode (see Cheat section for description).
-.IP "\fB\-loglevel\fR <0|1|2>" 4
-.IX Item "-loglevel <0|1|2>"
-Indicates level of logging to perform while the application is running.
-Zero completely disables logging (except for serious errors), while the
-remaining numbers show increasingly more detail.
-.IP "\fB\-logtoconsole\fR <1|0>" 4
-.IX Item "-logtoconsole <1|0>"
+.TP
+.BR \-tv.sharpness " <\fInumber\fP>"
+Blargg TV effects 'sharpness' (only available in custom mode, range
+\-1.0 to 1.0).
+.TP
+.BR \-tv.resolution " <\fInumber\fP>"
+Blargg TV effects 'resolution' (only available in custom mode, range
+\-1.0 to 1.0).
+.TP
+.BR \-tv.artifacts " <\fInumber\fP>"
+Blargg TV effects 'artifacts' (only available in custom mode, range
+\-1.0 to 1.0).
+.TP
+.BR \-tv.fringing " <\fInumber\fP>"
+Blargg TV effects 'fringing' (only available in custom mode, range
+\-1.0 to 1.0).
+.TP
+.BR \-tv.bleed " <\fInumber\fP>"
+Blargg TV effects 'bleed' (only available in custom mode, range \-1.0
+to 1.0).
+.TP
+.BR \-cheat " <\fIcode\fP>"
+Use the specified cheatcode (see the \fICheat\fP section in the
+provided documentation for a description of cheatcodes).
+.TP
+.BR \-loglevel " <" 0 | 1 | 2 >
+Indicates level of logging to perform while the application is
+running. Zero completely disables logging (except for serious errors),
+while the remaining numbers show increasingly more detail.
+.TP
+.BR \-logtoconsole " <" 1 | 0 >
Indicates that logged output should be printed to the
-console/commandline as it's being collected. An internal log will still
-be kept, and the amount of logging is still controlled by 'loglevel'.
-.IP "\fB\-joydeadzone\fR <number>" 4
-.IX Item "-joydeadzone <number>"
-Sets the joystick axis deadzone area for joysticks/gamepads. All values
-within the deadzone are treated as zero-axis values, while only those
-values outside are registered as valid input. Accepts a number from 0 \-
-29, and uses the formula 3200 + number * 1000. So the possible deadzone
-values range from 3200 to 32200.
-.IP "\fB\-joyallow4\fR <1|0>" 4
-.IX Item "-joyallow4 <1|0>"
-Allow all 4 directions on a joystick to be pressed simultaneously.
-Bumper Bash ignores this setting, and always allows all 4 directions.
-.IP "\fB\-usemouse\fR <always|analog|never>" 4
-.IX Item "-usemouse <always|analog|never>"
-Use mouse as a controller as specified by \s-1ROM\s0 properties in specific
-case. Always and never are self-explanatory, analog means only for
-analog-type devices (paddles, trackball, etc).
-.IP "\fB\-grabmouse\fR <1|0>" 4
-.IX Item "-grabmouse <1|0>"
-Locks the mouse cursor in the game window in emulation mode.
-.IP "\fB\-cursor\fR <0,1,2,3>" 4
-.IX Item "-cursor <0,1,2,3>"
-Set cursor state in UI/emulation modes.
-.IP "\fB\-dsense\fR <number>" 4
-.IX Item "-dsense <number>"
-Sensitivity for emulation of paddles when using a digital device (ie,
-joystick digital axis or button, keyboard key, etc). Valid range of
-values is from 1 to 20, with larger numbers causing faster movement.
-.IP "\fB\-msense\fR <number>" 4
-.IX Item "-msense <number>"
-Sensitivity for emulation of paddles when using a mouse. Valid range of
-values is from 1 to 20, with larger numbers causing faster movement.
-.IP "\fB\-tsense\fR <number>" 4
-.IX Item "-tsense <number>"
-Sensitivity of mouse emulated trackball movement (1\-20).
-.IP "\fB\-saport\fR <lr|rl>" 4
-.IX Item "-saport <lr|rl>"
-Determines how to enumerate the Stelladaptor/2600\-daptor devices in the
-order they are found: 'lr' means first is left port, second is right
-port, 'rl' means the opposite.
-.IP "\fB\-ctrlcombo\fR <1|0>" 4
-.IX Item "-ctrlcombo <1|0>"
+console/commandline as it's being collected. An internal log will
+still be kept, and the amount of logging is still controlled
+by \fBloglevel\fP.
+.TP
+.BR \-joydeadzone " <\fInumber\fP>"
+Sets the joystick deadzone area for analog joysticks. Accepts a number
+from 0 - 29, and uses the formula 3200 + \fInumber\fP * 1000. So the
+possible deadzone values range from 3200 to 32200.
+.TP
+.BR \-joyallow4 " <" 1 | 0 >
+Allow all 4 directions on a joystick to be pressed
+simultaneously. Bumper Bash ignores this setting, and always allows
+all 4 directions.
+.TP
+.BR \-usemouse " <" always | analog | never >
+Use mouse as a controller as specified by ROM properties in specific
+case. \fBalways\fP and \fBnever\fP are self-explanatory, \fBanalog\fP
+means only for analog-type devices (paddles, trackball, etc.).
+.TP
+.BR \-grabmouse " <" 1 | 0 >
+Keeps the mouse in the game window in emulation mode.
+.TP
+.BR \-cursor " <" 0 | 1 | 2 | 3 >
+Set mouse cursor state in UI/emulation modes.
+.TP
+.BR \-dsense " <\fInumber\fP>"
+Sensitivity for emulation of paddles when using a digital device
+(joystick digital axis or button, keyboard key, etc.). \fInumber\fP
+may range from 1 to 20, with larger numbers causing faster movement.
+.TP
+.BR \-msense " <\fInumber\fP>"
+Sensitivity for emulation of paddles when using a mouse. \fInumber\fP
+may range from 1 to 20, with larger numbers causing faster movement.
+.TP
+.BR \-tsense " <\fInumber\fP>"
+Sensitivity for emulation of trackball controllers when using a mouse.
+\fInumber\fP may range from 1 to 20, with larger numbers causing
+faster movement.
+.TP
+.BR \-saport " <" lr | rl >
+Determines how to enumerate the Stelladaptor/2600-daptor devices in
+the order they are found: 'lr' means first is left port, second is
+right port, 'rl' means the opposite.
+.TP
+.BR \-ctrlcombo " <" 1 | 0 >
Use control-x key combos. This is normally enabled, since the Quit
-command is tied to 'Control\-q'. However, there are times when a
-2\-player game is using either the 'f' or 'r' keys for movement, and
+command is tied to 'Control-q'. However, there are times when a
+2-player game is using either the 'f' or 'r' keys for movement, and
pressing Control (for Fire) will perform an unwanted action associated
with Control-r or Control-f.
-.IP "\fB\-autoslot\fR <1|0>" 4
-.IX Item "-autoslot <1|0>"
-Automatically switch to the next available save state slot after saving
-a \s-1ROM\s0 state file.
-.IP "\fB\-stats\fR <1|0>" 4
-.IX Item "-stats <1|0>"
-Overlay console info on the \s-1TIA\s0 image during emulation.
-.IP "\fB\-fastscbios\fR <1|0>" 4
-.IX Item "-fastscbios <1|0>"
-Disable Supercharger \s-1BIOS\s0 progress loading bars.
-.IP "\fB\-snapsavedir\fR <path>" 4
-.IX Item "-snapsavedir <path>"
+.TP
+.BR \-autoslot " <" 1 | 0 >
+Automatically switch to the next available save state slot after
+saving a ROM state file.
+.TP
+.BR \-fastscbios " <" 1 | 0 >
+Disable Supercharger BIOS progress loading bars.
+.TP
+.BR \-snapsavedir " <\fIpath\fP>"
The directory to save snapshot files to.
-.IP "\fB\-snaploaddir\fR <path>" 4
-.IX Item "-snaploaddir <path>"
+.TP
+.BR \-snaploaddir " <\fIpath\fP>"
The directory to load snapshot files from.
-.IP "\fB\-snapname\fR <int|rom>" 4
-.IX Item "-snapname <int|rom>"
+.TP
+.BR \-snapname " <" int | rom >
When saving snapshots, use either the internal database name or the
-actual \s-1ROM\s0 filename.
-.IP "\fB\-sssingle\fR <1|0>" 4
-.IX Item "-sssingle <1|0>"
+actual ROM filename.
+.TP
+.BR \-sssingle " <" 1 | 0 >
Generate single snapshot instead of many, overwriting any previous
snapshots.
-.IP "\fB\-ss1x\fR <1|0>" 4
-.IX Item "-ss1x <1|0>"
-Ignore any scaling applied to the \s-1TIA\s0 image, and save snapshot in
+.TP
+.BR \-ss1x " <" 1 | 0 >
+Ignore any scaling applied to the TIA image, and save snapshot in
unscaled (1x) mode.
-.IP "\fB\-ssinterval\fR <number>" 4
-.IX Item "-ssinterval <number>"
+.TP
+.BR \-ssinterval " <\fInumber\fP>"
Set the interval in seconds between taking snapshots in continuous
-snapshot mode (currently, 1 \- 10).
-.IP "\fB\-rominfo\fR <rom>" 4
-.IX Item "-rominfo <rom>"
-Display detailed information about the given \s-1ROM,\s0 and then exit Stella.
-.IP "\fB\-listrominfo\fR" 4
-.IX Item "-listrominfo"
-Prints relevant contents of the Stella \s-1ROM\s0 database, one \s-1ROM\s0 per line,
+snapshot mode (currently, 1 - 10).
+.TP
+.BR \-rominfo " <\fIrom\fP>"
+Display detailed information about the given ROM, and then exit
+Stella.
+.TP
+.BR \-listrominfo
+Prints relevant contents of the Stella ROM database, one ROM per line,
and then exit Stella. This can be used for external frontends.
-.IP "\fB\-exitlauncher\fR <1|0>" 4
-.IX Item "-exitlauncher <1|0>"
-Always exit to \s-1ROM\s0 launcher when exiting a \s-1ROM \s0(normally, an exit to
+.TP
+.BR \-exitlauncher " <" 1 | 0 >
+Always exit to ROM launcher when exiting a ROM (normally, an exit to
launcher only happens when started with the launcher).
-.IP "\fB\-launcherres\fR <WxH>" 4
-.IX Item "-launcherres <WxH>"
-Set the size of the \s-1ROM\s0 launcher.
-.IP "\fB\-launcherfont\fR <small|medium|large>" 4
-.IX Item "-launcherfont <small|medium|large>"
-Set the size of the font in the \s-1ROM\s0 launcher.
-.IP "\fB\-launcherexts\fR <allfiles|allroms|LIST>" 4
-.IX Item "-launcherexts <allfiles|allroms|LIST>"
-Specifies which files to show in the \s-1ROM\s0 launcher ('allfiles' is
-self-explanatory, 'allroms' is all files with valid rom extensions
-(currently: a26, bin, rom, gz, zip), '\s-1LIST\s0' is a ':' separated list of
-valid rom extensions.
-.IP "\fB\-romviewer\fR <0|1|2>" 4
-.IX Item "-romviewer <0|1|2>"
-Hide \s-1ROM\s0 info viewer in \s-1ROM\s0 launcher mode (0), or use the given zoom
+.TP
+.BR \-launcherres " <\fIW\fP" x \fIH\fP>
+Set the size of the ROM launcher.
+.TP
+.BR \-launcherfont " <" small | medium | large >
+Set the size of the font in the ROM launcher.
+.TP
+.BR \-laucnherroms " <" 1 | 0 >
+Specifies whether to show ROMs only (the default) or all files in the
+ROM launcher.
+.TP
+.BR \-romviewer " <" 0 | 1 | 2 >
+Hide ROM info viewer in ROM launcher mode (0), or use the given zoom
level (1 or 2).
-.IP "\fB\-uipalette\fR <standard|classic>" 4
-.IX Item "-uipalette <standard|classic>"
-Use the specified palette for \s-1UI\s0 elements. \fBclassic\fR is green-on-black,
-\&\fBstandard\fR is more colorful.
-.IP "\fB\-listdelay\fR <delay>" 4
-.IX Item "-listdelay <delay>"
+.TP
+.BR \-uipalette " <" standard | classic >
+Use the specified palette for UI elements.
+.TP
+.BR \-listdelay " <\fIdelay\fP>"
Set the amount of time to wait between treating successive keypresses
-as a single word in list widgets (value can range from 300\-1000). Use
-\&'0' to disable list-skipping completely,
-.IP "\fB\-mwheel\fR <lines>" 4
-.IX Item "-mwheel <lines>"
-Set the number of lines a mousewheel will scroll in the \s-1UI.\s0
-.IP "\fB\-romdir\fR <dir>" 4
-.IX Item "-romdir <dir>"
-Set the directory where the \s-1ROM\s0 launcher will start.
-.IP "\fB\-statedir\fR <dir>" 4
-.IX Item "-statedir <dir>"
-Set the directory in which to access state files.
-.IP "\fB\-cheatfile\fR <file>" 4
-.IX Item "-cheatfile <file>"
+as a single word in list widgets (value can range from 300-1000).
+.TP
+.BR \-mwheel " <\fIlines\fP>"
+Set the number of lines a mousewheel will scroll in the UI.
+.TP
+.BR \-romdir " <\fIdir\fP>"
+Set the directory where the ROM launcher will start.
+.TP
+.BR \-statedir " <\fIdir\fP>"
+Set the directory in which to save state files.
+.TP
+.BR \-cheatfile " <\fIfile\fP>"
Set the full pathname of the cheatfile database.
-.IP "\fB\-palettefile\fR <file>" 4
-.IX Item "-palettefile <file>"
+.TP
+.BR \-palettefile " <\fIfile\fP>"
Set the full pathname of the user-defined palette file.
-.IP "\fB\-propsfile\fR <file>" 4
-.IX Item "-propsfile <file>"
-Set the full pathname of the \s-1ROM\s0 properties file.
-.IP "\fB\-nvramdir\fR <dir>" 4
-.IX Item "-nvramdir <dir>"
-Set the directory in which to access non-volatile (flash/EEPROM) files.
-.IP "\fB\-cfgdir\fR <dir>" 4
-.IX Item "-cfgdir <dir>"
+.TP
+.BR \-propsfile " <\fIfile\fP>"
+Set the full pathname of the ROM properties file.
+.TP
+.BR \-nvramdir " <\fIdir\fP>"
+Set the directory in which to save EEPROM files.
+.TP
+.BR \-cfgdir " <\fIdir\fP>"
Set the directory in which to access Distella config files.
-.IP "\fB\-avoxport\fR <name>" 4
-.IX Item "-avoxport <name>"
+.TP
+.BR \-avoxport " <\fIname\fP>"
Set the name of the serial port where an AtariVox is connected.
-.IP "\fB\-maxres\fR <WxH>" 4
-.IX Item "-maxres <WxH>"
-Useful for developers, this sets the maximum size of window that can be
-created, allowing to simulate testing on 'smaller' systems.
-.IP "\fB\-help\fR" 4
-.IX Item "-help"
-Prints a help message describing these options, and then exit Stella.
-.Sp
-The following are useful to developers. Only use them if you know
-what you're doing! Note that in all cases, the values supplied to
-the arguments are not case sensitive.
-.Sp
-Argument Description
-.IP "\fB\-dis.resolve\fR <1|0>" 4
-.IX Item "-dis.resolve <1|0>"
+.TP
+.BR \-maxres " <\fIW\fP" x \fIH\fP>
+Useful for developers, this sets the maximum size of window that can
+be created, allowing to simulate testing on 'smaller' systems.
+.TP
+.BR \-help
+Print a help message describing these options, and then exit Stella.
+
+.P
+The following are useful to developers. Only use them if you know what
+you're doing! Note that in all cases, the values supplied to the
+arguments are \fBnot\fP case sensitive.
+.TP
+.BR \-dis.resolve " <" 1 | 0 >
Try to differentiate between code vs. data sections in the
-disassembler. See the Debugger section for more information.
-.IP "\fB\-dis.gfxformat\fR <2|16>" 4
-.IX Item "-dis.gfxformat <2|16>"
-Sets the base to use for displaying \s-1GFX\s0 sections in the disassembler.
-.IP "\fB\-dis.showaddr\fR <1|0>" 4
-.IX Item "-dis.showaddr <1|0>"
+disassembler. See the \fIDebugger\fP section in the provided
+documentation for more information.
+.TP
+.BR \-dis.gfxformat " <" 2 | 16 >
+Sets the base to use for displaying GFX sections in the disassembler.
+.TP
+.BR \-dis.showaddr " <" 1 | 0 >
Shows/hides opcode addresses in the disassembler.
-.IP "\fB\-dis.relocate\fR <1|0>" 4
-.IX Item "-dis.relocate <1|0>"
+.TP
+.BR \-dis.relocate " <" 1 | 0 >
Relocate calls out of address range in the disassembler.
-.IP "\fB\-dbg.res\fR <WxH>" 4
-.IX Item "-dbg.res <WxH>"
+.TP
+.BR \-dbg.res " <\fIW\fP" x \fIH\fP>
Set the size of the debugger window.
-.IP "\fB\-dbg.fontstyle\fR <0|1|2|3>" 4
-.IX Item "-dbg.fontstyle <0|1|2|3>"
-How to use bold fonts in the debugger window. '0' means all normal
-font, '1' is bold labels only, '2' is bold non-labels only, '3' is all
-bold font.
-.IP "\fB\-break\fR <address>" 4
-.IX Item "-break <address>"
-Set a breakpoint at specified address.
-.IP "\fB\-debug\fR" 4
-.IX Item "-debug"
+.TP
+.BR \-dbg.fontsize " <" small | medium | large >
+Set the font size in the debugger window.
+.TP
+.BR \-dbg.fontstyle " <" 0 | 1 | 2 | 3 >
+How to use bold fonts in the debugger window. \fB0\fP means all normal
+font, \fB1\fP is bold labels only, \fB2\fP is bold non-labels only,
+\fB3\fP is all bold font.
+.TP
+.BR \-dbg.ghostreadstrap " <" 1 | 0 >
+Debugger considers/ignores 'ghost' reads for trap addresses.
+.TP
+.BR \-dbg.uhex " <" 0 | 1 >
+Lower/uppercase hexadecimal display.
+.TP
+.BR \-break " <\fIaddress\fP>"
+Set a breakpoint at a specified address.
+.TP
+.BR \-debug
Immediately jump to debugger mode when starting Stella.
-.IP "\fB\-holdjoy0\fR <U,D,L,R,F>" 4
-.IX Item "-holdjoy0 <U,D,L,R,F>"
-Start the emulator with the left joystick direction/button held down
-(ie, use '\s-1UF\s0' for up and fire).
-.IP "\fB\-holdjoy1\fR <U,D,L,R,F>" 4
-.IX Item "-holdjoy1 <U,D,L,R,F>"
-Start the emulator with the right joystick direction/button held down
-(ie, use '\s-1UF\s0' for up and fire).
-.IP "\fB\-holdselect\fR" 4
-.IX Item "-holdselect"
+.TP
+.BR \-holdjoy0 " [" UDLRF ]
+Start the emulator with the specified left joystick direction and
+button held down (\fBUF\fP for up and fire).
+After entering the emulation, you will have to press and release the
+direction again to release the event.
+.TP
+.BR \-holdjoy1 " [" UDLRF ]
+Start the emulator with the specified right joystick direction and
+button held down (\fBUF\fP for up and fire).
+After entering the emulation, you will have to press and release the
+direction again to release the event.
+.TP
+.BR \-holdselect
Start the emulator with the Game Select switch held down.
-.IP "\fB\-holdreset\fR" 4
-.IX Item "-holdreset"
+After entering the emulation, you will have to press and
+release 'Select' to release the event.
+.TP
+.BR \-holdreset
Start the emulator with the Game Reset switch held down.
-.IP "\fB\-tiadriven\fR <1|0>" 4
-.IX Item "-tiadriven <1|0>"
-Set unused \s-1TIA\s0 pins to be randomly driven high or low on a read/peek.
-If disabled, use the last databus value for those pins instead.
-.IP "\fB\-cpurandom\fR <S,A,X,Y,P>" 4
-.IX Item "-cpurandom <S,A,X,Y,P>"
-On reset, randomize the content of the specified \s-1CPU\s0 registers.
-.IP "\fB\-ramrandom\fR <1|0>" 4
-.IX Item "-ramrandom <1|0>"
-On reset, either randomize all \s-1RAM\s0 content, or zero it out instead.
-.IP "\fB\-bs\fR <type>" 4
-.IX Item "-bs <type>"
-Set \*(L"Cartridge.Type\*(R" property. See the Game Properties section for
-valid types.
-.IP "\fB\-type\fR <type>" 4
-.IX Item "-type <type>"
-Same as using \-bs.
-.IP "\fB\-channels\fR <Mono|Stereo>" 4
-.IX Item "-channels <Mono|Stereo>"
-Set \*(L"Cartridge.Sound\*(R" property.
-.IP "\fB\-ld\fR <A|B>" 4
-.IX Item "-ld <A|B>"
-Set \*(L"Console.LeftDifficulty\*(R" property.
-.IP "\fB\-rd\fR <A|B>" 4
-.IX Item "-rd <A|B>"
-Set \*(L"Console.RightDifficulty\*(R" property.
-.IP "\fB\-tv\fR <Color|BW>" 4
-.IX Item "-tv <Color|BW>"
-Set \*(L"Console.TelevisionType\*(R" property.
-.IP "\fB\-sp\fR <Yes|No>" 4
-.IX Item "-sp <Yes|No>"
-Set \*(L"Console.SwapPorts\*(R" property.
-.IP "\fB\-lc\fR <type>" 4
-.IX Item "-lc <type>"
-Set \*(L"Controller.Left\*(R" property. See the Game Properties section for
-valid types.
-.IP "\fB\-rc\fR <type>" 4
-.IX Item "-rc <type>"
-Set \*(L"Controller.Right\*(R" property. See the Game Properties section for
-valid types.
-.IP "\fB\-bc\fR <type>" 4
-.IX Item "-bc <type>"
-Sets both \*(L"Controller.Left\*(R" and \*(L"Controller.Right\*(R" properties. See the
-Game Properties section for valid types.
-.IP "\fB\-cp\fR <Yes|No>" 4
-.IX Item "-cp <Yes|No>"
-Set \*(L"Controller.SwapPaddles\*(R" property.
-.IP "\fB\-ma\fR <Auto|XY>" 4
-.IX Item "-ma <Auto|XY>"
-Set \*(L"Controller.MouseAxis\*(R" property. See the Game Properties section
-for valid types.
-.IP "\fB\-format\fR <format>" 4
-.IX Item "-format <format>"
-Set \*(L"Display.Format\*(R" property. See the Game Properties section for
-valid formats.
-.IP "\fB\-ystart\fR <number>" 4
-.IX Item "-ystart <number>"
-Set \*(L"Display.YStart\*(R" property (0 \- 64).
-.IP "\fB\-height\fR <number>" 4
-.IX Item "-height <number>"
-Set \*(L"Display.Height\*(R" property (210 \- 256).
-.IP "\fB\-pp\fR <Yes|No>" 4
-.IX Item "-pp <Yes|No>"
-Set \*(L"Display.Phosphor\*(R" property.
-.IP "\fB\-ppblend\fR <number>" 4
-.IX Item "-ppblend <number>"
-Set \*(L"Display.PPBlend\*(R" property, used for phosphor effect (0\-100).
-Default is 77.
-.IP "\fB\-thumb.trapfatal\fR <1|0>" 4
-.IX Item "-thumb.trapfatal <1|0>"
-The default of true allows the Thumb \s-1ARM\s0 emulation to throw an
-exception and enter the debugger on fatal errors. When disabled, such
-fatal errors are simply logged, and emulation continues. Do not use
-this unless you know exactly what you're doing, as it changes the
-behaviour as compared to real hardware. Note that Thumb \s-1ARM\s0 emulation
-only applies to the \s-1BUS, CDF,\s0 and \s-1DPC+\s0 cartridge types.
-.SH "KEYBOARD"
-.IX Header "KEYBOARD"
+After entering the emulation, you will have to press and
+release 'Reset' to release the event.
+.TP
+.BR \-bs " <\fItype\fP>, " \-type " <\fItype\fP>"
+Set "Cartridge.Type" property. See the \fIGame Properties\fP section
+in the provided documentation for valid types.
+.TP
+.BR \-channels " <" Mono | Stereo >
+Set "Cartridge.Sound" property.
+.TP
+.BR \-ld " <" A | B >
+Set "Console.LeftDifficulty" property.
+.TP
+.BR \-rd " <" A | B >
+Set "Console.RightDifficulty" property.
+.TP
+.BR \-tv " <" Color | BlackAndWhite >
+Set "Console.TelevitionType" property.
+.TP
+.BR \-sp " <" Yes | No >
+Set "Console.SwapPorts" property.
+.TP
+.BR \-lc " <\fItype\fP>"
+Set "Controller.Left" property. See the \fIGame Properties\fP section
+in the provided documentation for valid types.
+.TP
+.BR \-rc " <\fItype\fP>"
+Set "Controller.Right" property. See the \fIGame Properties\fP section
+in the provided documentation for valid types.
+.TP
+.BR \-bc " <\fItype\fP>"
+Sets both "Controller.Left" and "Controller.Right" properties. See the
+\fIGame Properties\fP section in the provided documentation for valid
+types.
+.TP
+.BR \-cp " <" Yes | No >
+Set "Controller.SwapPaddles" property. See the \fIGame Properties\fP
+section in the provided documentation for valid types.
+.TP
+.BR \-ma " <" Auto | XY >
+Set "Controller.MouseAxis" property. See the \fIGame Properties\fP
+section in the provided documentation for valid types.
+.TP
+.BR \-format " <\fIformat\fP>"
+Set "Display.Format" property. See the \fIGame Properties\fP section
+in the provided documentation for valid formats.
+.TP
+.BR \-ystart " <\fInumber\fP>"
+Set "Display.YStart" property (0 - 64).
+.TP
+.BR \-height " <\fInumber\fP>"
+Set "Display.Height" property (210 - 256).
+.TP
+.BR \-pp " <" Yes | No >
+Set "Display.Phosphor" property.
+.TP
+.BR \-ppblend " <\fInumber\fI>"
+Set "Display.PPBlend" property, used for phosphor effect
+(0-100). Default is 77.
+
+.P
+The following are available in two sets, one for players (prefixed by
+.BR plr. )
+and one for developers (prefixed by
+.BR dev. ).
+Only use them if you know what you're doing!
+Note that in all cases, the values supplied to the arguments are
+\fBnot\fP case sensitive.
+.TP
+.BR \-dev.settings " <" 1 | 0 >
+Select developer
+.RB ( 1 )
+or player
+.RB ( 0 )
+set.
+.TP
+.BR \- < plr | dev > .stats " <" 1 | 0 >
+Overlay console info on the TIA image during emulation.
+.TP
+.BR \- < plr | dev > .console " <" 2600 | 7800 >
+Select console for B/W and Pause key handling and RAM initialization.
+.TP
+.BR \- < plr | dev > .bankrandom " <" 1 | 0 >
+On reset, randomize the startup bank (only for selected bankswitch
+types).
+.TP
+.BR \- < plr | dev > .ramrandom " <" 1 | 0 >
+On reset, either randomize all RAM content, or zero it out instead.
+.TP
+.BR \- < plr | dev > .cpurandom " [" SAXYP ]
+On reset, randomize the content of the specified CPU registers.
+.TP
+.BR \- < plr | dev > .tiadriven " <" 1 | 0 >
+Set unused TIA pins to be randomly driven high or low on a read/peek.
+.TP
+.BR \- < plr | dev > .rwportbreak " <" 1 | 0 >
+Since the 2600 has no dedicated R/W line, different addresses are used
+for RAM read or write access.
+If the code reads from such a write address, this causes an unwanted,
+semi-random write to that address.
+When this option is enabled, such reads interrupt emulation and the
+debugger is entered.
+.TP
+.BR \- < plr | dev > .thumb.trapfatal " <" true | false >
+The default of \fBtrue\fP allows the Thumb ARM emulation to throw an
+exception and enter the debugger on fatal errors.
+When disabled, such fatal errors are simply logged, and emulation
+continues.
+Do not use this unless you know exactly what you're doing, as it
+changes the behaviour as compared to real hardware.
+.TP
+.BR \- < plr | dev > .eepromaccess " <" 1 | 0 >
+When enabled, each read or write access to the AtariVox/SaveKey EEPROM
+is signalled by a message.
+.TP
+.BR \- < plr | dev > .tv.jitter " <" 1 | 0 >
+Enable TV jitter/roll effect, when there are too many or too few
+scanlines per frame.
+.TP
+.BR \- < plr | dev > .tv.jitter_recovery " <" 1 - 20 >
+When TV jitter/roll effect is enabled, determines how long to delay
+recovery time (recovery spread over multiple frames).
+.TP
+.BR \- < plr | dev > .colorloss " <" 1 | 0 >
+Enable/disable the PAL color-loss effect.
+.TP
+.BR \- < plr | dev > .debugcolors " <" 1 | 0 >
+Enable/disable the fixed debug colors.
+.TP
+.BR \- < plr | dev > .timemachine " <" 1 | 0 >
+Enables the Time Machine.
+.TP
+.BR \- < plr | dev > .tm.size " <" 20 - 1000 >
+Defines the Time Machine buffer size.
+.TP
+.BR \- < plr | dev > .tm.uncompressed " <" 0 - 1000 >
+Defines the uncompressed Time Machine buffer size.
+Must be less than Time Machine the buffer size.
+.TP
+.BR \- < plr | dev > .tm.interval " <" 1f | 3f | 10f | 30f | 1s | 3s | 10s >
+Defines the interval between two save states.
+.TP
+.BR \- < plr | dev > .tm.horizon " <" 3s | 10s | 30s | 1m | 3m | 10m | 30m | 60m >
+Defines the horizon of the Time Machine.
+
+.SH KEYBOARD CONTROLS
The Atari 2600 console controls and controllers are mapped to the
-computer's keyboard as shown in the following tables. However, most of
+computer's keyboard as shown in the following sections. However, most of
these events can be remapped to other keys on your keyboard or buttons
-on your joystick (see \fBAdvanced Configuration \- Event Remapping\fR in
-the \s-1HTML\s0 documentation). The tables below show the default settings.
-.SS "Console Controls (can be remapped)"
-.IX Subsection "Console Controls (can be remapped)"
-.IP "\fBControl + q\fR" 4
-.IX Item "Control + q"
+on your joystick.
+
+.SS Console controls (can be remapped)
+.IP "Control + q"
Exit emulator
-.IP "\fBEscape\fR" 4
-.IX Item "Escape"
+.IP Escape
Exit game mode/enter launcher mode
-.IP "\fBTab\fR" 4
-.IX Item "Tab"
+.IP Tab
Enter/exit options mode
-.IP "\fBBackslash (\e)\fR" 4
-.IX Item "Backslash ()"
+.IP "Backslash (\e)"
Enter/exit command mode
-.IP "\fBBackquote (`)\fR" 4
-.IX Item "Backquote (`)"
+.IP "Backquote (`)"
Enter/exit debugger
-.IP "\fBF1\fR" 4
-.IX Item "F1"
+.IP F1
Select Game
-.IP "\fBF2\fR" 4
-.IX Item "F2"
+.IP F2
Reset Game
-.IP "\fBF3\fR" 4
-.IX Item "F3"
-Color \s-1TV\s0
-.IP "\fBF4\fR" 4
-.IX Item "F4"
-Black/White \s-1TV\s0
-.IP "\fBF5\fR" 4
-.IX Item "F5"
+.IP F3
+Color TV
+.IP F4
+Black/White TV
+.IP F5
Left Player Difficulty A
-.IP "\fBF6\fR" 4
-.IX Item "F6"
+.IP F6
Left Player Difficulty B
-.IP "\fBF7\fR" 4
-.IX Item "F7"
+.IP F7
Right Player Difficulty A
-.IP "\fBF8\fR" 4
-.IX Item "F8"
+.IP F8
Right Player Difficulty B
-.IP "\fBF9\fR" 4
-.IX Item "F9"
+.IP F9
Save state to current slot
-.IP "\fBF10\fR" 4
-.IX Item "F10"
+.IP F10
Change current state slot
-.IP "\fBF11\fR" 4
-.IX Item "F11"
+.IP F11
Load state from current slot
-.IP "\fBF12\fR" 4
-.IX Item "F12"
-Save \s-1PNG\s0 snapshot
-.IP "\fBPause\fR" 4
-.IX Item "Pause"
+.IP F12
+Save PNG snapshot
+.IP Pause
Pause/resume emulation
-.SS "Joystick / BoosterGrip Controller (can be remapped)"
-.IX Subsection "Joystick / BoosterGrip Controller (can be remapped)"
-\fILeft Joystick (Joy0)\fR
-.IX Subsection "Left Joystick (Joy0)"
-.IP "\fBUp arrow\fR" 4
-.IX Item "Up arrow"
-Joystick Up
-.IP "\fBDown arrow\fR" 4
-.IX Item "Down arrow"
-Joystick Down
-.IP "\fBLeft arrow\fR" 4
-.IX Item "Left arrow"
-Joystick Left
-.IP "\fBRight arrow\fR" 4
-.IX Item "Right arrow"
-Joystick Right
-.IP "\fBSpace\fR" 4
-.IX Item "Space"
-Fire Button
-.IP "\fB4\fR" 4
-.IX Item "4"
-Trigger Button
-.IP "\fB5\fR" 4
-.IX Item "5"
-Booster Button
-.PP
-\fIRight Joystick (Joy1)\fR
-.IX Subsection "Right Joystick (Joy1)"
-.IP "\fBY\fR" 4
-.IX Item "Y"
-Joystick Up
-.IP "\fBH\fR" 4
-.IX Item "H"
-Joystick Down
-.IP "\fBG\fR" 4
-.IX Item "G"
-Joystick Left
-.IP "\fBJ\fR" 4
-.IX Item "J"
-Joystick Right
-.IP "\fBF\fR" 4
-.IX Item "F"
-Fire Button
-.IP "\fB6\fR" 4
-.IX Item "6"
-Trigger Button
-.IP "\fB7\fR" 4
-.IX Item "7"
-Booster Button
-.SS "Paddle Controller digital emulation (can be remapped independently of joystick controller)"
-.IX Subsection "Paddle Controller digital emulation (can be remapped independently of joystick controller)"
-\fILeft Paddles\fR
-.IX Subsection "Left Paddles"
-.IP "\fBSame as 'Joy0 Left'\fR" 4
-.IX Item "Same as 'Joy0 Left'"
+
+.SS Joystick / BoosterGrip Controller (can be remapped)
+.P
+Left joystick:
+.IP "Up arrow"
+Joystick up
+.IP "Down arrow"
+Joystick down
+.IP "Left arrow"
+Joystick left
+.IP "Right arrow"
+Joystick right
+.IP Space
+Fire button
+.IP 4
+Trigger button
+.IP 5
+Booster button
+.P
+Right joystick:
+.IP Y
+Joystick up
+.IP H
+Joystick down
+.IP G
+Joystick left
+.IP J
+Joystick right
+.IP F
+Fire button
+.IP 6
+Trigger button
+.IP 7
+Booster button
+
+.SS Paddle Controller digital emulation (can be remapped independently of joystick controller)
+.P
+By default the left paddles are mapped to the left joystick as follows:
+.IP Left
Paddle 0 decrease
-.IP "\fBSame as 'Joy0 Right'\fR" 4
-.IX Item "Same as 'Joy0 Right'"
+.IP Right
Paddle 0 increase
-.IP "\fBSame as 'Joy0 Fire'\fR" 4
-.IX Item "Same as 'Joy0 Fire'"
-Paddle 0 Fire
-.IP "\fBSame as 'Joy0 Up'\fR" 4
-.IX Item "Same as 'Joy0 Up'"
+.IP Fire
+Paddle 0 fire
+.IP Up
Paddle 1 decrease
-.IP "\fBSame as 'Joy0 Down'\fR" 4
-.IX Item "Same as 'Joy0 Down'"
+.IP Down
Paddle 1 increase
-.IP "\fBSame as 'Joy0 Booster'\fR" 4
-.IX Item "Same as 'Joy0 Booster'"
-Paddle 1 Fire
-.PP
-\fIRight Paddles\fR
-.IX Subsection "Right Paddles"
-.IP "\fBSame as 'Joy1 Left'\fR" 4
-.IX Item "Same as 'Joy1 Left'"
-Paddle 2 decrease
-.IP "\fBSame as 'Joy1 Right'\fR" 4
-.IX Item "Same as 'Joy1 Right'"
-Paddle 2 increase
-.IP "\fBSame as 'Joy1 Fire'\fR" 4
-.IX Item "Same as 'Joy1 Fire'"
-Paddle 2 Fire
-.IP "\fBSame as 'Joy1 Up'\fR" 4
-.IX Item "Same as 'Joy1 Up'"
-Paddle 3 decrease
-.IP "\fBSame as 'Joy1 Down'\fR" 4
-.IX Item "Same as 'Joy1 Down'"
-Paddle 3 increase
-.IP "\fBSame as 'Joy1 Booster'\fR" 4
-.IX Item "Same as 'Joy1 Booster'"
-Paddle 3 Fire
-.SS "Driving Controller (cannot be remapped, always associated with joystick controller)"
-.IX Subsection "Driving Controller (cannot be remapped, always associated with joystick controller)"
-\fILeft Driving\fR
-.IX Subsection "Left Driving"
-.IP "\fBSame as 'Joy0 Left'\fR" 4
-.IX Item "Same as 'Joy0 Left'"
-Left Direction
-.IP "\fBSame as 'Joy0 Right'\fR" 4
-.IX Item "Same as 'Joy0 Right'"
-Right Direction
-.IP "\fBSame as 'Joy0 Fire'\fR" 4
-.IX Item "Same as 'Joy0 Fire'"
-Fire Button
-.PP
-\fIRight Driving\fR
-.IX Subsection "Right Driving"
-.IP "\fBSame as 'Joy1 Left'\fR" 4
-.IX Item "Same as 'Joy1 Left'"
-Left Direction
-.IP "\fBSame as 'Joy1 Right'\fR" 4
-.IX Item "Same as 'Joy1 Right'"
-Right Direction
-.IP "\fBSame as 'Joy1 Fire'\fR" 4
-.IX Item "Same as 'Joy1 Fire'"
-Fire Button
-.SS "Sega Genesis Controller (cannot be remapped, always associated with joystick and booster-grip controllers)"
-.IX Subsection "Sega Genesis Controller (cannot be remapped, always associated with joystick and booster-grip controllers)"
-\fILeft Pad\fR
-.IX Subsection "Left Pad"
-.IP "\fBSame as 'Joy0 Up'\fR" 4
-.IX Item "Same as 'Joy0 Up'"
-Pad Up
-.IP "\fBSame as 'Joy0 Down'\fR" 4
-.IX Item "Same as 'Joy0 Down'"
-Pad Down
-.IP "\fBSame as 'Joy0 Left'\fR" 4
-.IX Item "Same as 'Joy0 Left'"
-Pad Left
-.IP "\fBSame as 'Joy0 Right'\fR" 4
-.IX Item "Same as 'Joy0 Right'"
-Pad Right
-.IP "\fBSame as 'Joy0 Fire'\fR" 4
-.IX Item "Same as 'Joy0 Fire'"
-Button 'B'
-.IP "\fBSame as 'Joy0 Booster'\fR" 4
-.IX Item "Same as 'Joy0 Booster'"
-Button 'C'
-.PP
-\fIRight Pad\fR
-.IX Subsection "Right Pad"
-.IP "\fBSame as 'Joy1 Up'\fR" 4
-.IX Item "Same as 'Joy1 Up'"
-Pad Up
-.IP "\fBSame as 'Joy1 Down'\fR" 4
-.IX Item "Same as 'Joy1 Down'"
-Pad Down
-.IP "\fBSame as 'Joy1 Left'\fR" 4
-.IX Item "Same as 'Joy1 Left'"
-Pad Left
-.IP "\fBSame as 'Joy1 Right'\fR" 4
-.IX Item "Same as 'Joy1 Right'"
-Pad Right
-.IP "\fBSame as 'Joy1 Fire'\fR" 4
-.IX Item "Same as 'Joy1 Fire'"
+.IP Booster
+Paddle 1 fire
+.P
+The same mappings on the right joystick correspond to the right
+paddles (paddles 2 and 3 respectively).
+
+.SS Driving Controller (cannot be remapped, always associated with joystick controllers)
+Each driving controller is mapped to the corresponding joystick, using
+the left, right and fire controls.
+
+.SS Sega Genesis Controller (cannot be remapped, always associated with joystick and booster-grip controllers)
+Each pad is mapped to the correspondig joystick as follows:
+.IP Up
+Up
+.IP Down
+Down
+.IP Left
+Left
+.IP Right
+Right
+.IP Fire
Button 'B'
-.IP "\fBSame as 'Joy1 Booster'\fR" 4
-.IX Item "Same as 'Joy1 Booster'"
+.IP Booster
Button 'C'
-.SS "Keypad Controller (can be remapped)"
-.IX Subsection "Keypad Controller (can be remapped)"
-\fILeft Keypad\fR
-.IX Subsection "Left Keypad"
-.IP "\fB1\fR" 4
-.IX Item "1"
+
+.SS Keypad Controller (can be remapped)
+.P
+Left keypad (press the key on the left to emulate the key on the
+right):
+.IP 1
1
-.IP "\fB2\fR" 4
-.IX Item "2"
+.IP 2
2
-.IP "\fB3\fR" 4
-.IX Item "3"
+.IP 3
3
-.IP "\fBQ\fR" 4
-.IX Item "Q"
+.IP Q
4
-.IP "\fBW\fR" 4
-.IX Item "W"
+.IP W
5
-.IP "\fBE\fR" 4
-.IX Item "E"
+.IP E
6
-.IP "\fBA\fR" 4
-.IX Item "A"
+.IP A
7
-.IP "\fBS\fR" 4
-.IX Item "S"
+.IP S
8
-.IP "\fBD\fR" 4
-.IX Item "D"
+.IP D
9
-.IP "\fBZ\fR" 4
-.IX Item "Z"
+.IP Z
\&.
-.IP "\fBX\fR" 4
-.IX Item "X"
+.IP X
0
-.IP "\fBC\fR" 4
-.IX Item "C"
+.IP C
#
-.PP
-\fIRight Keypad\fR
-.IX Subsection "Right Keypad"
-.IP "\fB8\fR" 4
-.IX Item "8"
+
+.P
+Right keypad:
+.IP 8
1
-.IP "\fB9\fR" 4
-.IX Item "9"
+.IP 9
2
-.IP "\fB0\fR" 4
-.IX Item "0"
+.IP "0 (the digit)"
3
-.IP "\fBI\fR" 4
-.IX Item "I"
+.IP I
4
-.IP "\fBO\fR" 4
-.IX Item "O"
+.IP "O (the letter)"
5
-.IP "\fBP\fR" 4
-.IX Item "P"
+.IP P
6
-.IP "\fBK\fR" 4
-.IX Item "K"
+.IP K
7
-.IP "\fBL\fR" 4
-.IX Item "L"
+.IP L
8
-.IP "\fB;\fR" 4
-.IX Item ";"
+.IP ;
9
-.IP "\fB,\fR" 4
-.IX Item ","
+.IP ,
\&.
-.IP "\fB.\fR" 4
-.IX Item "."
+.IP .
0
-.IP "\fB/\fR" 4
-.IX Item "/"
+.IP /
#
-.SS "CompuMate Controller (cannot be remapped)"
-.IX Subsection "CompuMate Controller (cannot be remapped)"
-.IP "\fB 0 \- 9\fR" 4
-.IX Item " 0 - 9"
-0 \- 9
-.IP "\fB A \- Z\fR" 4
-.IX Item " A - Z"
-A \- Z
-.IP "\fB Comma\fR" 4
-.IX Item " Comma"
+
+.SS CompuMate Controller (cannot be remapped)
+.P
+.IP 0-9
+0-9
+.IP A-Z
+A-Z
+.IP Comma
Comma
-.IP "\fB Period\fR" 4
-.IX Item " Period"
+.IP Period
Period
-.IP "\fB Control (left or right)\fR" 4
-.IX Item " Control (left or right)"
+.IP Control
Func
-.IP "\fB Shift (left or right)\fR" 4
-.IX Item " Shift (left or right)"
+.IP Shift
Shift
-.IP "\fB Return/Enter\fR" 4
-.IX Item " Return/Enter"
+.IP "; or Return/Enter"
Enter
-.IP "\fB Space\fR" 4
-.IX Item " Space"
+.IP "/ or Space"
Space
-.IP "\fB Backspace\fR" 4
-.IX Item " Backspace"
+.IP Backspace
Func-Space
-.IP "\fB + or Shift\-1\fR" 4
-.IX Item " + or Shift-1"
-+
-.IP "\fB \- or Shift\-2\fR" 4
-.IX Item " - or Shift-2"
-\&\-
-.IP "\fB Shift\-3\fR" 4
-.IX Item " Shift-3"
-*
-.IP "\fB / or Shift\-4\fR" 4
-.IX Item " / or Shift-4"
-/
-.IP "\fB = or Shift\-5\fR" 4
-.IX Item " = or Shift-5"
-=
-.IP "\fB ? (Shift\-/) or Shift\-6\fR" 4
-.IX Item " ? (Shift-/) or Shift-6"
-?
-.IP "\fB Shift\-7\fR" 4
-.IX Item " Shift-7"
-$
-.IP "\fB [ or Shift\-8\fR" 4
-.IX Item " [ or Shift-8"
-[
-.IP "\fB ] or Shift\-9\fR" 4
-.IX Item " ] or Shift-9"
-]
-.IP "\fB "" (Shift\-') or Shift\-0\fR" 4
-.IX Item " "" (Shift-') or Shift-0"
-"
-.SS "\s-1TV\s0 effects (cannot be remapped, only active in \s-1TIA\s0 mode)"
-.IX Subsection "TV effects (cannot be remapped, only active in TIA mode)"
-.IP "\fBAlt + 1\fR" 4
-.IX Item "Alt + 1"
-Disable \s-1TV\s0 effects
-.IP "\fBAlt + 2\fR" 4
-.IX Item "Alt + 2"
-Select 'Composite' preset
-.IP "\fBAlt + 3\fR" 4
-.IX Item "Alt + 3"
-Select 'S\-video' preset
-.IP "\fBAlt + 4\fR" 4
-.IX Item "Alt + 4"
-Select '\s-1RGB\s0' preset
-.IP "\fBAlt + 5\fR" 4
-.IX Item "Alt + 5"
-Select 'Badly adjusted' preset
-.IP "\fBAlt + 6\fR" 4
-.IX Item "Alt + 6"
-Select 'Custom' preset
-.IP "\fBShift-Alt + 7\fR" 4
-.IX Item "Shift-Alt + 7"
-Decrease scanline intensity
-.IP "\fBAlt + 7\fR" 4
-.IX Item "Alt + 7"
-Increase scanline intensity
-.IP "\fBShift-Alt + 8\fR" 4
-.IX Item "Shift-Alt + 8"
-Disable scanline interpolation
-.IP "\fBAlt + 8\fR" 4
-.IX Item "Alt + 8"
-Enable scanline interpolation
-.IP "\fBShift-Alt + 9\fR" 4
-.IX Item "Shift-Alt + 9"
-Select previous 'Custom' mode attribute (*)
-.IP "\fBAlt + 9\fR" 4
-.IX Item "Alt + 9"
-Select next 'Custom' mode attribute (*)
-.IP "\fBShift-Alt + 0\fR" 4
-.IX Item "Shift-Alt + 0"
-Decrease 'Custom' selected attribute value (*)
-.IP "\fBAlt + 0\fR" 4
-.IX Item "Alt + 0"
-Increase 'Custom' selected attribute value (*)
-.PP
-Items marked as (*) are only available in 'Custom' preset mode
-.SS "Developer Keys in \s-1TIA\s0 mode (cannot be remapped)"
-.IX Subsection "Developer Keys in TIA mode (cannot be remapped)"
-.IP "\fBAlt + PageUp\fR" 4
-.IX Item "Alt + PageUp"
-Set \*(L"Display.YStart\*(R" to next larger value
-.IP "\fBAlt + PageDown\fR" 4
-.IX Item "Alt + PageDown"
-Set \*(L"Display.YStart\*(R" to next smaller value
-.IP "\fBControl + PageUp\fR" 4
-.IX Item "Control + PageUp"
-Set \*(L"Display.Height\*(R" to next larger value
-.IP "\fBControl + PageDown\fR" 4
-.IX Item "Control + PageDown"
-Set \*(L"Display.Height\*(R" to next smaller value
-.IP "\fBAlt + l\fR" 4
-.IX Item "Alt + l"
-Toggle frame stats (scanline count/fps/bs type/etc)
-.IP "\fBAlt + z\fR" 4
-.IX Item "Alt + z"
-Toggle \s-1TIA\s0 Player0 object
-.IP "\fBAlt + x\fR" 4
-.IX Item "Alt + x"
-Toggle \s-1TIA\s0 Player1 object
-.IP "\fBAlt + c\fR" 4
-.IX Item "Alt + c"
-Toggle \s-1TIA\s0 Missile0 object
-.IP "\fBAlt + v\fR" 4
-.IX Item "Alt + v"
-Toggle \s-1TIA\s0 Missile1 object
-.IP "\fBAlt + b\fR" 4
-.IX Item "Alt + b"
-Toggle \s-1TIA\s0 Ball object
-.IP "\fBAlt + n\fR" 4
-.IX Item "Alt + n"
-Toggle \s-1TIA\s0 Playfield object
-.IP "\fBShift-Alt + z\fR" 4
-.IX Item "Shift-Alt + z"
-Toggle \s-1TIA\s0 Player0 collisions
-.IP "\fBShift-Alt + x\fR" 4
-.IX Item "Shift-Alt + x"
-Toggle \s-1TIA\s0 Player1 collisions
-.IP "\fBShift-Alt + c\fR" 4
-.IX Item "Shift-Alt + c"
-Toggle \s-1TIA\s0 Missile0 collisions
-.IP "\fBShift-Alt + v\fR" 4
-.IX Item "Shift-Alt + v"
-Toggle \s-1TIA\s0 Missile1 collisions
-.IP "\fBShift-Alt + b\fR" 4
-.IX Item "Shift-Alt + b"
-Toggle \s-1TIA\s0 Ball collisions
-.IP "\fBShift-Alt + n\fR" 4
-.IX Item "Shift-Alt + n"
-Toggle \s-1TIA\s0 Playfield collisions
-.IP "\fBAlt + m\fR" 4
-.IX Item "Alt + m"
-Toggle \s-1TIA HMOVE\s0 blanks
-.IP "\fBAlt + Comma\fR" 4
-.IX Item "Alt + Comma"
-Toggle \s-1TIA \s0'Fixed Debug Colors' mode
-.IP "\fBAlt + .\fR" 4
-.IX Item "Alt + ."
-Toggle all \s-1TIA\s0 objects
-.IP "\fBShift-Alt + .\fR" 4
-.IX Item "Shift-Alt + ."
-Toggle all \s-1TIA\s0 collisions
-.SS "Other Keys (cannot be remapped, except those marked with '*')"
-.IX Subsection "Other Keys (cannot be remapped, except those marked with '*')"
-.IP "\fBAlt + =\fR" 4
-.IX Item "Alt + ="
-Switch to next larger zoom level
-.IP "\fBAlt + \-\fR" 4
-.IX Item "Alt + -"
-Switch to next smaller zoom level
-.IP "\fBAlt + Enter\fR" 4
-.IX Item "Alt + Enter"
-Toggle fullscreen/windowed mode
-.IP "\fBAlt + [\fR" 4
-.IX Item "Alt + ["
-Decrease volume (*)
-.IP "\fBAlt + ]\fR" 4
-.IX Item "Alt + ]"
-Increase volume (*)
-.IP "\fBControl + f\fR" 4
-.IX Item "Control + f"
-Toggle console type in increasing order (\s-1NTSC/PAL/SECAM,\s0 etc))
-.IP "\fBShift-Control + f\fR" 4
-.IX Item "Shift-Control + f"
-Toggle console type in decreasing order (\s-1NTSC/PAL/SECAM,\s0 etc))
-.IP "\fBControl + s\fR" 4
-.IX Item "Control + s"
-Save current properties to a new properties file
-.IP "\fBControl + 0\fR" 4
-.IX Item "Control + 0"
-Switch mouse between controller emulation modes
-.IP "\fBControl + 1\fR" 4
-.IX Item "Control + 1"
-Swap Stelladaptor/2600\-daptor port ordering
-.IP "\fBControl + r\fR" 4
-.IX Item "Control + r"
-Reload current \s-1ROM \s0(singlecart \s-1ROM, TIA\s0 mode) or Load next game in \s-1ROM \s0(multicart \s-1ROM, TIA\s0 mode)
-.IP "\fBControl + r\fR" 4
-.IX Item "Control + r"
-Reload \s-1ROM\s0 listing (\s-1ROM\s0 launcher mode)
-.IP "\fBBackspace\fR" 4
-.IX Item "Backspace"
-Emulate 'frying' effect (\s-1TIA\s0 mode) (*), Go to parent directory (\s-1UI\s0 mode) (*)
-=item \fBAlt + p\fR
-.Sp
-Toggle 'phosphor' effect
-.IP "\fBControl + p\fR" 4
-.IX Item "Control + p"
-Toggle palette
-.IP "\fBControl + l\fR" 4
-.IX Item "Control + l"
-Toggle \s-1PAL\s0 color-loss effect
-.IP "\fBAlt + s\fR" 4
-.IX Item "Alt + s"
-Save continuous \s-1PNG\s0 snapshots (per interval)
-.IP "\fBShift-Alt + s\fR" 4
-.IX Item "Shift-Alt + s"
-Save continuous \s-1PNG\s0 snapshots (every frame)
-.SS "\s-1UI\s0 keys in Text Editing areas (cannot be remapped)"
-.IX Subsection "UI keys in Text Editing areas (cannot be remapped)"
-.IP "\fBHome\fR" 4
-.IX Item "Home"
-Move cursor to beginning of line
-.IP "\fBEnd\fR" 4
-.IX Item "End"
-Move cursor to end of line
-.IP "\fBDelete\fR" 4
-.IX Item "Delete"
-Remove character to right of cursor
-.IP "\fBBackspace\fR" 4
-.IX Item "Backspace"
-Remove character to left of cursor
-.IP "\fBControl-a\fR" 4
-.IX Item "Control-a"
-Same function as 'Home'
-.IP "\fBControl-e\fR" 4
-.IX Item "Control-e"
-Same function as 'End'
-.IP "\fBControl-d\fR" 4
-.IX Item "Control-d"
-Same function as 'Delete'
-.IP "\fBControl-k\fR" 4
-.IX Item "Control-k"
-Remove all characters from cursor to end of line
-.IP "\fBControl-u\fR" 4
-.IX Item "Control-u"
-Remove all characters from cursor to beginning of line
-.IP "\fBControl-w\fR" 4
-.IX Item "Control-w"
-Remove entire word to left of cursor
-.IP "\fBControl-Left\fR" 4
-.IX Item "Control-Left"
-Move cursor to beginning of word to the left
-.IP "\fBControl-Right\fR" 4
-.IX Item "Control-Right"
-Move cursor to beginning of word to the right
-.IP "\fBControl-c\fR" 4
-.IX Item "Control-c"
-Copy entire line to clipboard (not complete)
-.IP "\fBControl-v\fR" 4
-.IX Item "Control-v"
-Paste clipboard contents (not complete)
-.SH "FILES"
-.IX Header "FILES"
-Starting with 5.0, \fBstella\fR uses \fB\f(CB$HOME\fB/.config/stella/\fR as
-the per-user config directory. Previous versions used \fB\f(CB$HOME\fB/.stella/\fR.
-.PP
-The config directory contains the following:
-.IP "\fBstellarc\fR" 4
-.IX Item "stellarc"
-The Stella config file, created by \fBstella\fR. May be hand-edited, but
-normally the built-in \s-1GUI\s0 is used to set these options.
-.IP "\fBcfg/\fR" 4
-.IX Item "cfg/"
-Directory for DiStella config files, used only by the debugger.
-.IP "\fBnvram/\fR" 4
-.IX Item "nvram/"
-Directory used to store the contents of non-volatile cartridge memory.
-.IP "\fBstate/\fR" 4
-.IX Item "state/"
-Directory used to store save-states (see \fBF9\fR key).
-.SH "AUTHORS"
-.IX Header "AUTHORS"
-Stella was originally developed for Linux by Bradford W. Mott
-<bwmott@users.sourceforge.net>, and is currently maintained by Stephen
-Anthony <stephena@users.sourceforge.net>. Other contributors include
-Eckhard Stolberg <estolberg@users.sourceforge.net> and Brian Watson
-<yalhcru@gmail.com>.
-.SH "SEE ALSO"
-.IX Header "SEE ALSO"
-Stella web site: \fIhttp://stella.sourceforge.net/\fR.
+
+.SH FILES
+.IP ~/.config/stella/stellarc
+Default options (command line options override these). Lines starting
+with ';' are considered comments and are ignored. Any other line must
+be of the form <\fIcommand\fP> \fB=\fP <\fIvalue\fP>, where
+\fIcommand\fP is the same as that specified on the command line,
+without the '-' character, and \fIvalue\fP is the value given to the
+setting.
+.IP ~/.config/stella/atarivox_eeprom.dat
+Default storage for the emulated EEPROM portion of an attached
+AtariVox device.
+.IP ~/.config/stella/savekey_eeprom.dat
+Default storage for the emulated EEPROM portion of an attached SaveKey
+device.
+.IP ~/.config/stella/stella.cht
+Default location of the cheat database file.
+
+.SH SEE ALSO
+\fB/usr/share/doc/stella/index.html\fP,
+\fB/usr/share/doc/stella/debugger.html\fP.
+
+.SH AUTHORS
+\fBstella\fP was written by Bradford W. Mott, Stephen Anthony and the
+Stella Team.
+
+This manual page was adapted from the provided documentation by
+Stephen Kitt <skitt@debian.org>, for the Debian GNU/Linux system (but
+may be used by others). It was last modified for \fBstella\fP version
+6.0.
diff --git a/games/stella/stella.SlackBuild b/games/stella/stella.SlackBuild
index 990c9fc111ce6..4c4f6cc0f8209 100644
--- a/games/stella/stella.SlackBuild
+++ b/games/stella/stella.SlackBuild
@@ -8,6 +8,10 @@
# Now maintained by B. Watson <yalhcru@gmail.com>
+# 20191201 bkw:
+# - update for 6.0.2.
+# - replace my outdated man page with the up-to-date one from Debian.
+
# 20180611 bkw: update for 5.1.3, move binary to /usr/games
# 20180206 bkw: update for 5.1
# 20170821 bkw: update for 5.0.2
@@ -37,7 +41,7 @@
# - StartupNotify=false in .desktop
PRGNAM=stella
-VERSION=${VERSION:-5.1.3}
+VERSION=${VERSION:-6.0.2}
BUILD=${BUILD:-1}
TAG=${TAG:-_SBo}
@@ -76,16 +80,12 @@ cd $TMP
rm -rf $PRGNAM-$VERSION
tar xvf $CWD/$PRGNAM-$VERSION-src.tar.xz
cd $PRGNAM-$VERSION
-chown -R root:root .
-find -L . \
- \( -perm 777 -o -perm 775 -o -perm 750 -o -perm 711 -o -perm 555 -o -perm 511 \) \
- -exec chmod 755 {} \; -o \
- \( -perm 666 -o -perm 664 -o -perm 600 -o -perm 444 -o -perm 440 -o -perm 400 \) \
- -exec chmod 644 {} \;
+find -L . -perm /111 -a \! -perm 755 -a -exec chmod 755 {} \+ -o \
+ \! -perm /111 -a \! -perm 644 -a -exec chmod 644 {} \+
# 20170620 bkw: configure checks for gcc 4.7, 5.x, or 6.x. Fails on -current
# because we have 7.x.
-sed -i 's,\[5-6\],[5-9],g' configure
+#sed -i 's,\[5-6\],[5-9],g' configure
CFLAGS="$SLKCFLAGS" \
CXXFLAGS="$SLKCFLAGS" \
@@ -105,7 +105,7 @@ ln -s \
../icons/hicolor/128x128/apps/$PRGNAM.png \
$PKG/usr/share/pixmaps/$PRGNAM.png
-# Man page written for this build.
+# Man page borrowed from Debian.
# Upstream said he'd be shipping a man page starting with 4.7, so I could
# quit including one here, but so far it hasn't happened...
mkdir -p $PKG/usr/man/man6
diff --git a/games/stella/stella.info b/games/stella/stella.info
index c77077e2a4e70..4f84ddc7dd6fe 100644
--- a/games/stella/stella.info
+++ b/games/stella/stella.info
@@ -1,8 +1,8 @@
PRGNAM="stella"
-VERSION="5.1.3"
+VERSION="6.0.2"
HOMEPAGE="https://stella-emu.github.io/"
-DOWNLOAD="https://github.com/stella-emu/stella/releases/download/5.1.3/stella-5.1.3-src.tar.xz"
-MD5SUM="f7cccdf4761b7183a235ffeef136e180"
+DOWNLOAD="https://github.com/stella-emu/stella/releases/download/6.0.2/stella-6.0.2-src.tar.xz"
+MD5SUM="43f71246d9ab256687bce4ddc6e63965"
DOWNLOAD_x86_64=""
MD5SUM_x86_64=""
REQUIRES="SDL2"
diff --git a/games/stella/stella.pod b/games/stella/stella.pod
deleted file mode 100644
index 908d33cc28d57..0000000000000
--- a/games/stella/stella.pod
+++ /dev/null
@@ -1,1411 +0,0 @@
-# pod source for stella man page. Convert with:
-# pod2man --stderr -s6 -cSlackBuilds.org -r5.0.2 -u stella.pod > stella.6
-
-=pod
-
-=head1 NAME
-
-stella - an Atari 2600 emulator
-
-=head1 SYNOPSIS
-
-B<stella> I<options> I<ROM file>
-
-=head1 DESCRIPTION
-
-B<stella> is a comprehensive emulator of the old Atari 2600 video-game
-console. It support most Atari 2600 games and many peripherals.
-
-If you start Stella and do not specify a ROM image, it will start in
-'ROM Launcher' mode. If this is your first time starting Stella, you
-will be asked to select the default ROM directory to use.
-
-This man page only documents the command-line options and default
-keybindings. The complete documentation is in I<index.html> and
-I<debugger.html>, usually installed in I</usr/share/doc/stella/> or
-I</usr/doc/stella-4.7.2/>.
-
-=head1 OPTIONS
-
-=over 4
-
-=item B<-video> <direct3d|opengl|opengles2|opengles|software>
-
-Use the given rendering backend (where applicable); default is the best
-available mode detected.
-
-=item B<-vsync> <1|0>
-
-Synchronize screen updates to the vertical blank period. This can
-result in smoother updates, and eliminate tearing.
-
-=item B<-fullscreen> <1|0>
-
-Enable fullscreen mode.
-
-=item B<-center> <1|0>
-
-Centers game window (if possible).
-
-=item B<-palette> <standard|z26|user>
-
-Set the palette to either normal Stella, the one used in the z26
-emulator, or a user-defined palette.
-
-=item B<-colorloss> <1|0>
-
-Enable/disable the PAL color-loss effect.
-
-=item B<-framerate> <number>
-
-Display the given number of frames per second. Normally, Stella will
-determine framerate based on number of scanlines. Setting this to 0
-automatically enables auto-frame calculation (ie, framerate based on
-scanlines).
-
-=item B<-timing> <sleep|busy>
-
-Determines type of wait to perform between processing frames. Sleep
-will release the CPU as much as possible, and is the preferred method
-on laptops (and other low-powered devices) and when using VSync. Busy
-will emulate z26 busy-wait behaviour, and use all possible CPU time,
-but may eliminate graphical 'tearing' in software mode.
-
-=item B<-uimessages> <1|0>
-
-Enable or disable display of message in the UI. Note that messages
-indicating serious errors override this setting, and are always shown.
-
-=item B<-sound> <1|0>
-
-Enable or disable sound generation.
-
-=item B<-fragsize> <number>
-
-Specify the sound fragment size to use. Linux/Mac seems to work with
-512, Windows usually needs 1024.
-
-=item B<-freq> <number>
-
-Set sound sample output frequency (11025,22050,31400,44100,48000)
-Default is 31400. Do not change unless you experience sound issues.
-
-=item B<-volume> <number>
-
-Set the volume (0 - 100).
-
-=item B<-tia.zoom> <zoom>
-
-Use the specified zoom level (integer) while in TIA/emulation mode.
-
-=item B<-tia.inter> <1|0>
-
-Use interpolation for the TIA image (results in blending/smoothing of
-the image).
-
-=item B<-tia.aspectn> <number>
-
-=item B<-tia.aspectp> <number>
-
-Specify the amount (as a percentage) to scale the TIA image width in
-NTSC and PAL mode. Since many video modes do not use square pixels, you
-can reduce width until the pixels appear square. Allowable values are
-80 - 120; I find 85 - 90 gives the most authentic look for NTSC, and
-105 - 110 for PAL.
-
-=item B<-tia.fsfill> <1|0>
-
-Stretch TIA image completely while in fullscreen mode (vs. an integral
-stretch which won't necessarily completely fill the screen).
-
-=item B<-tia.dbgcolors> <roygbp>
-
-Assigns the colours (R)ed, (O)range, (Y)ellow, (G)reen,
-(B)lue and (P)urple to each graphical register P0/M0/P1/M1/PF/BL,
-respectively. Currently, these can be changed around to apply different
-colours to the respective register.
-
-=item B<-tv.phosphor> <always|byrom>
-
-When to use phosphor mode.
-
-=item B<-tv.phosblend> <0 - 100>
-
-Set default blend level in phosphor mode.
-
-=item B<-tv.filter> <1 - 6>
-
-Blargg TV effects, 0 is disabled, next numbers in sequence represent
-presets for 'Composite', 'S-Video', 'RGB', 'Bad Adjust', and 'Custom'
-modes.
-
-=item B<-tv.scanlines> <0 - 100>
-
-Blargg TV effects scanline intensity, where 0 means completely off.
-
-=item B<-tv.scaninter> <1|0>
-
-Blargg TV effects scanline interpolation, resulting in
-blending/smoothing of the scanlines.
-
-=item B<-tv.jitter> <1|0>
-
-Enable TV jitter effect.
-
-=item B<-tv.jitter_recovery> <1 - 20>
-
-Set recovery time for TV jitter effect.
-
-=item B<-tv.contrast> <number>
-
-Blargg TV effects 'contrast' (only available in custom mode, range -1.0
-to 1.0).
-
-=item B<-tv.brightness> <number>
-
-Blargg TV effects 'brightness' (only available in custom mode, range
--1.0 to 1.0).
-
-=item B<-tv.hue> <number>
-
-Blargg TV effects 'hue' (only available in custom mode, range -1.0 to
-1.0).
-
-=item B<-tv.saturation> <number>
-
-Blargg TV effects 'saturation' (only available in custom mode, range
--1.0 to 1.0).
-
-=item B<-tv.gamma> <number>
-
-Blargg TV effects 'gamma' (only available in custom mode, range -1.0 to
-1.0).
-
-=item B<-tv.sharpness> <number>
-
-Blargg TV effects 'sharpness' (only available in custom mode, range
--1.0 to 1.0).
-
-=item B<-tv.resolution> <number>
-
-Blargg TV effects 'resolution' (only available in custom mode, range
--1.0 to 1.0).
-
-=item B<-tv.artifacts> <number>
-
-Blargg TV effects 'artifacts' (only available in custom mode, range
--1.0 to 1.0).
-
-=item B<-tv.fringing> <number>
-
-Blargg TV effects 'fringing' (only available in custom mode, range -1.0
-to 1.0).
-
-=item B<-tv.bleed> <number>
-
-Blargg TV effects 'bleed' (only available in custom mode, range -1.0 to
-1.0).
-
-=item B<-cheat> <code>
-
-Use the specified cheatcode (see Cheat section for description).
-
-=item B<-loglevel> <0|1|2>
-
-Indicates level of logging to perform while the application is running.
-Zero completely disables logging (except for serious errors), while the
-remaining numbers show increasingly more detail.
-
-=item B<-logtoconsole> <1|0>
-
-Indicates that logged output should be printed to the
-console/commandline as it's being collected. An internal log will still
-be kept, and the amount of logging is still controlled by 'loglevel'.
-
-=item B<-joydeadzone> <number>
-
-Sets the joystick axis deadzone area for joysticks/gamepads. All values
-within the deadzone are treated as zero-axis values, while only those
-values outside are registered as valid input. Accepts a number from 0 -
-29, and uses the formula 3200 + number * 1000. So the possible deadzone
-values range from 3200 to 32200.
-
-=item B<-joyallow4> <1|0>
-
-Allow all 4 directions on a joystick to be pressed simultaneously.
-Bumper Bash ignores this setting, and always allows all 4 directions.
-
-=item B<-usemouse> <always|analog|never>
-
-Use mouse as a controller as specified by ROM properties in specific
-case. Always and never are self-explanatory, analog means only for
-analog-type devices (paddles, trackball, etc).
-
-=item B<-grabmouse> <1|0>
-
-Locks the mouse cursor in the game window in emulation mode.
-
-=item B<-cursor> <0,1,2,3>
-
-Set cursor state in UI/emulation modes.
-
-=item B<-dsense> <number>
-
-Sensitivity for emulation of paddles when using a digital device (ie,
-joystick digital axis or button, keyboard key, etc). Valid range of
-values is from 1 to 20, with larger numbers causing faster movement.
-
-=item B<-msense> <number>
-
-Sensitivity for emulation of paddles when using a mouse. Valid range of
-values is from 1 to 20, with larger numbers causing faster movement.
-
-=item B<-tsense> <number>
-
-Sensitivity of mouse emulated trackball movement (1-20).
-
-=item B<-saport> <lr|rl>
-
-Determines how to enumerate the Stelladaptor/2600-daptor devices in the
-order they are found: 'lr' means first is left port, second is right
-port, 'rl' means the opposite.
-
-=item B<-ctrlcombo> <1|0>
-
-Use control-x key combos. This is normally enabled, since the Quit
-command is tied to 'Control-q'. However, there are times when a
-2-player game is using either the 'f' or 'r' keys for movement, and
-pressing Control (for Fire) will perform an unwanted action associated
-with Control-r or Control-f.
-
-=item B<-autoslot> <1|0>
-
-Automatically switch to the next available save state slot after saving
-a ROM state file.
-
-=item B<-stats> <1|0>
-
-Overlay console info on the TIA image during emulation.
-
-=item B<-fastscbios> <1|0>
-
-Disable Supercharger BIOS progress loading bars.
-
-=item B<-snapsavedir> <path>
-
-The directory to save snapshot files to.
-
-=item B<-snaploaddir> <path>
-
-The directory to load snapshot files from.
-
-=item B<-snapname> <int|rom>
-
-When saving snapshots, use either the internal database name or the
-actual ROM filename.
-
-=item B<-sssingle> <1|0>
-
-Generate single snapshot instead of many, overwriting any previous
-snapshots.
-
-=item B<-ss1x> <1|0>
-
-Ignore any scaling applied to the TIA image, and save snapshot in
-unscaled (1x) mode.
-
-=item B<-ssinterval> <number>
-
-Set the interval in seconds between taking snapshots in continuous
-snapshot mode (currently, 1 - 10).
-
-=item B<-rominfo> <rom>
-
-Display detailed information about the given ROM, and then exit Stella.
-
-=item B<-listrominfo>
-
-Prints relevant contents of the Stella ROM database, one ROM per line,
-and then exit Stella. This can be used for external frontends.
-
-=item B<-exitlauncher> <1|0>
-
-Always exit to ROM launcher when exiting a ROM (normally, an exit to
-launcher only happens when started with the launcher).
-
-=item B<-launcherres> <WxH>
-
-Set the size of the ROM launcher.
-
-=item B<-launcherfont> <small|medium|large>
-
-Set the size of the font in the ROM launcher.
-
-=item B<-launcherexts> <allfiles|allroms|LIST>
-
-Specifies which files to show in the ROM launcher ('allfiles' is
-self-explanatory, 'allroms' is all files with valid rom extensions
-(currently: a26, bin, rom, gz, zip), 'LIST' is a ':' separated list of
-valid rom extensions.
-
-=item B<-romviewer> <0|1|2>
-
-Hide ROM info viewer in ROM launcher mode (0), or use the given zoom
-level (1 or 2).
-
-=item B<-uipalette> <standard|classic>
-
-Use the specified palette for UI elements. B<classic> is green-on-black,
-B<standard> is more colorful.
-
-=item B<-listdelay> <delay>
-
-Set the amount of time to wait between treating successive keypresses
-as a single word in list widgets (value can range from 300-1000). Use
-'0' to disable list-skipping completely,
-
-=item B<-mwheel> <lines>
-
-Set the number of lines a mousewheel will scroll in the UI.
-
-=item B<-romdir> <dir>
-
-Set the directory where the ROM launcher will start.
-
-=item B<-statedir> <dir>
-
-Set the directory in which to access state files.
-
-=item B<-cheatfile> <file>
-
-Set the full pathname of the cheatfile database.
-
-=item B<-palettefile> <file>
-
-Set the full pathname of the user-defined palette file.
-
-=item B<-propsfile> <file>
-
-Set the full pathname of the ROM properties file.
-
-=item B<-nvramdir> <dir>
-
-Set the directory in which to access non-volatile (flash/EEPROM) files.
-
-=item B<-cfgdir> <dir>
-
-Set the directory in which to access Distella config files.
-
-=item B<-avoxport> <name>
-
-Set the name of the serial port where an AtariVox is connected.
-
-=item B<-maxres> <WxH>
-
-Useful for developers, this sets the maximum size of window that can be
-created, allowing to simulate testing on 'smaller' systems.
-
-=item B<-help>
-
-Prints a help message describing these options, and then exit Stella.
-
-The following are useful to developers. Only use them if you know
-what you're doing! Note that in all cases, the values supplied to
-the arguments are not case sensitive.
-
-Argument Description
-
-=item B<-dis.resolve> <1|0>
-
-Try to differentiate between code vs. data sections in the
-disassembler. See the Debugger section for more information.
-
-=item B<-dis.gfxformat> <2|16>
-
-Sets the base to use for displaying GFX sections in the disassembler.
-
-=item B<-dis.showaddr> <1|0>
-
-Shows/hides opcode addresses in the disassembler.
-
-=item B<-dis.relocate> <1|0>
-
-Relocate calls out of address range in the disassembler.
-
-=item B<-dbg.res> <WxH>
-
-Set the size of the debugger window.
-
-=item B<-dbg.fontstyle> <0|1|2|3>
-
-How to use bold fonts in the debugger window. '0' means all normal
-font, '1' is bold labels only, '2' is bold non-labels only, '3' is all
-bold font.
-
-=item B<-break> <address>
-
-Set a breakpoint at specified address.
-
-=item B<-debug>
-
-Immediately jump to debugger mode when starting Stella.
-
-=item B<-holdjoy0> <U,D,L,R,F>
-
-Start the emulator with the left joystick direction/button held down
-(ie, use 'UF' for up and fire).
-
-=item B<-holdjoy1> <U,D,L,R,F>
-
-Start the emulator with the right joystick direction/button held down
-(ie, use 'UF' for up and fire).
-
-=item B<-holdselect>
-
-Start the emulator with the Game Select switch held down.
-
-=item B<-holdreset>
-
-Start the emulator with the Game Reset switch held down.
-
-=item B<-tiadriven> <1|0>
-
-Set unused TIA pins to be randomly driven high or low on a read/peek.
-If disabled, use the last databus value for those pins instead.
-
-=item B<-cpurandom> <S,A,X,Y,P>
-
-On reset, randomize the content of the specified CPU registers.
-
-=item B<-ramrandom> <1|0>
-
-On reset, either randomize all RAM content, or zero it out instead.
-
-=item B<-bs> <type>
-
-Set "Cartridge.Type" property. See the Game Properties section for
-valid types.
-
-=item B<-type> <type>
-
-Same as using -bs.
-
-=item B<-channels> <Mono|Stereo>
-
-Set "Cartridge.Sound" property.
-
-=item B<-ld> <A|B>
-
-Set "Console.LeftDifficulty" property.
-
-=item B<-rd> <A|B>
-
-Set "Console.RightDifficulty" property.
-
-=item B<-tv> <Color|BW>
-
-Set "Console.TelevisionType" property.
-
-=item B<-sp> <Yes|No>
-
-Set "Console.SwapPorts" property.
-
-=item B<-lc> <type>
-
-Set "Controller.Left" property. See the Game Properties section for
-valid types.
-
-=item B<-rc> <type>
-
-Set "Controller.Right" property. See the Game Properties section for
-valid types.
-
-=item B<-bc> <type>
-
-Sets both "Controller.Left" and "Controller.Right" properties. See the
-Game Properties section for valid types.
-
-=item B<-cp> <Yes|No>
-
-Set "Controller.SwapPaddles" property.
-
-=item B<-ma> <Auto|XY>
-
-Set "Controller.MouseAxis" property. See the Game Properties section
-for valid types.
-
-=item B<-format> <format>
-
-Set "Display.Format" property. See the Game Properties section for
-valid formats.
-
-=item B<-ystart> <number>
-
-Set "Display.YStart" property (0 - 64).
-
-=item B<-height> <number>
-
-Set "Display.Height" property (210 - 256).
-
-=item B<-pp> <Yes|No>
-
-Set "Display.Phosphor" property.
-
-=item B<-ppblend> <number>
-
-Set "Display.PPBlend" property, used for phosphor effect (0-100).
-Default is 77.
-
-=item B<-thumb.trapfatal> <1|0>
-
-The default of true allows the Thumb ARM emulation to throw an
-exception and enter the debugger on fatal errors. When disabled, such
-fatal errors are simply logged, and emulation continues. Do not use
-this unless you know exactly what you're doing, as it changes the
-behaviour as compared to real hardware. Note that Thumb ARM emulation
-only applies to the BUS, CDF, and DPC+ cartridge types.
-
-=back
-
-=head1 KEYBOARD
-
-The Atari 2600 console controls and controllers are mapped to the
-computer's keyboard as shown in the following tables. However, most of
-these events can be remapped to other keys on your keyboard or buttons
-on your joystick (see B<Advanced Configuration - Event Remapping> in
-the HTML documentation). The tables below show the default settings.
-
-=head2 Console Controls (can be remapped)
-
-=over 4
-
-=item B<Control + q>
-
-Exit emulator
-
-=item B<Escape>
-
-Exit game mode/enter launcher mode
-
-=item B<Tab>
-
-Enter/exit options mode
-
-=item B<Backslash (\)>
-
-Enter/exit command mode
-
-=item B<Backquote (`)>
-
-Enter/exit debugger
-
-=item B<F1>
-
-Select Game
-
-=item B<F2>
-
-Reset Game
-
-=item B<F3>
-
-Color TV
-
-=item B<F4>
-
-Black/White TV
-
-=item B<F5>
-
-Left Player Difficulty A
-
-=item B<F6>
-
-Left Player Difficulty B
-
-=item B<F7>
-
-Right Player Difficulty A
-
-=item B<F8>
-
-Right Player Difficulty B
-
-=item B<F9>
-
-Save state to current slot
-
-=item B<F10>
-
-Change current state slot
-
-=item B<F11>
-
-Load state from current slot
-
-=item B<F12>
-
-Save PNG snapshot
-
-=item B<Pause>
-
-Pause/resume emulation
-
-=back
-
-=head2 Joystick / BoosterGrip Controller (can be remapped)
-
-=head3 Left Joystick (Joy0)
-
-=over 4
-
-=item B<Up arrow>
-
-Joystick Up
-
-=item B<Down arrow>
-
-Joystick Down
-
-=item B<Left arrow>
-
-Joystick Left
-
-=item B<Right arrow>
-
-Joystick Right
-
-=item B<Space>
-
-Fire Button
-
-=item B<4>
-
-Trigger Button
-
-=item B<5>
-
-Booster Button
-
-=back
-
-=head3 Right Joystick (Joy1)
-
-=over 4
-
-=item B<Y>
-
-Joystick Up
-
-=item B<H>
-
-Joystick Down
-
-=item B<G>
-
-Joystick Left
-
-=item B<J>
-
-Joystick Right
-
-=item B<F>
-
-Fire Button
-
-=item B<6>
-
-Trigger Button
-
-=item B<7>
-
-Booster Button
-
-=back
-
-=head2 Paddle Controller digital emulation (can be remapped independently of joystick controller)
-
-=head3 Left Paddles
-
-=over 4
-
-=item B<Same as 'Joy0 Left'>
-
-Paddle 0 decrease
-
-=item B<Same as 'Joy0 Right'>
-
-Paddle 0 increase
-
-=item B<Same as 'Joy0 Fire'>
-
-Paddle 0 Fire
-
-=item B<Same as 'Joy0 Up'>
-
-Paddle 1 decrease
-
-=item B<Same as 'Joy0 Down'>
-
-Paddle 1 increase
-
-=item B<Same as 'Joy0 Booster'>
-
-Paddle 1 Fire
-
-=back
-
-=head3 Right Paddles
-
-=over 4
-
-=item B<Same as 'Joy1 Left'>
-
-Paddle 2 decrease
-
-=item B<Same as 'Joy1 Right'>
-
-Paddle 2 increase
-
-=item B<Same as 'Joy1 Fire'>
-
-Paddle 2 Fire
-
-=item B<Same as 'Joy1 Up'>
-
-Paddle 3 decrease
-
-=item B<Same as 'Joy1 Down'>
-
-Paddle 3 increase
-
-=item B<Same as 'Joy1 Booster'>
-
-Paddle 3 Fire
-
-=back
-
-=head2 Driving Controller (cannot be remapped, always associated with joystick controller)
-
-=head3 Left Driving
-
-=over 4
-
-=item B<Same as 'Joy0 Left'>
-
-Left Direction
-
-=item B<Same as 'Joy0 Right'>
-
-Right Direction
-
-=item B<Same as 'Joy0 Fire'>
-
-Fire Button
-
-=back
-
-=head3 Right Driving
-
-=over 4
-
-=item B<Same as 'Joy1 Left'>
-
-Left Direction
-
-=item B<Same as 'Joy1 Right'>
-
-Right Direction
-
-=item B<Same as 'Joy1 Fire'>
-
-Fire Button
-
-=back
-
-=head2 Sega Genesis Controller (cannot be remapped, always associated with joystick and booster-grip controllers)
-
-=head3 Left Pad
-
-=over 4
-
-=item B<Same as 'Joy0 Up'>
-
-Pad Up
-
-=item B<Same as 'Joy0 Down'>
-
-Pad Down
-
-=item B<Same as 'Joy0 Left'>
-
-Pad Left
-
-=item B<Same as 'Joy0 Right'>
-
-Pad Right
-
-=item B<Same as 'Joy0 Fire'>
-
-Button 'B'
-
-=item B<Same as 'Joy0 Booster'>
-
-Button 'C'
-
-=back
-
-=head3 Right Pad
-
-=over 4
-
-=item B<Same as 'Joy1 Up'>
-
-Pad Up
-
-=item B<Same as 'Joy1 Down'>
-
-Pad Down
-
-=item B<Same as 'Joy1 Left'>
-
-Pad Left
-
-=item B<Same as 'Joy1 Right'>
-
-Pad Right
-
-=item B<Same as 'Joy1 Fire'>
-
-Button 'B'
-
-=item B<Same as 'Joy1 Booster'>
-
-Button 'C'
-
-=back
-
-=head2 Keypad Controller (can be remapped)
-
-=head3 Left Keypad
-
-=over 4
-
-=item B<1>
-
-1
-
-=item B<2>
-
-2
-
-=item B<3>
-
-3
-
-=item B<Q>
-
-4
-
-=item B<W>
-
-5
-
-=item B<E>
-
-6
-
-=item B<A>
-
-7
-
-=item B<S>
-
-8
-
-=item B<D>
-
-9
-
-=item B<Z>
-
-.
-
-=item B<X>
-
-0
-
-=item B<C>
-
-#
-
-=back
-
-=head3 Right Keypad
-
-=over 4
-
-=item B<8>
-
-1
-
-=item B<9>
-
-2
-
-=item B<0>
-
-3
-
-=item B<I>
-
-4
-
-=item B<O>
-
-5
-
-=item B<P>
-
-6
-
-=item B<K>
-
-7
-
-=item B<L>
-
-8
-
-=item B<;>
-
-9
-
-=item B<,>
-
-.
-
-=item B<.>
-
-0
-
-=item B</>
-
-#
-
-=back
-
-=head2 CompuMate Controller (cannot be remapped)
-
-=over 4
-
-=item B< 0 - 9>
-
-0 - 9
-
-=item B< A - Z>
-
-A - Z
-
-=item B< Comma>
-
-Comma
-
-=item B< Period>
-
-Period
-
-=item B< Control (left or right)>
-
-Func
-
-=item B< Shift (left or right)>
-
-Shift
-
-=item B< Return/Enter>
-
-Enter
-
-=item B< Space>
-
-Space
-
-=item B< Backspace>
-
-Func-Space
-
-=item B< + or Shift-1>
-
-+
-
-=item B< - or Shift-2>
-
--
-
-=item B< Shift-3>
-
-*
-
-=item B< / or Shift-4>
-
-/
-
-=item B< = or Shift-5>
-
-=
-
-=item B< ? (Shift-/) or Shift-6>
-
-?
-
-=item B< Shift-7>
-
-$
-
-=item B< [ or Shift-8>
-
-[
-
-=item B< ] or Shift-9>
-
-]
-
-=item B< " (Shift-') or Shift-0>
-
-"
-
-=back
-
-=head2 TV effects (cannot be remapped, only active in TIA mode)
-
-=over 4
-
-=item B<Alt + 1>
-
-Disable TV effects
-
-=item B<Alt + 2>
-
-Select 'Composite' preset
-
-=item B<Alt + 3>
-
-Select 'S-video' preset
-
-=item B<Alt + 4>
-
-Select 'RGB' preset
-
-=item B<Alt + 5>
-
-Select 'Badly adjusted' preset
-
-=item B<Alt + 6>
-
-Select 'Custom' preset
-
-=item B<Shift-Alt + 7>
-
-Decrease scanline intensity
-
-=item B<Alt + 7>
-
-Increase scanline intensity
-
-=item B<Shift-Alt + 8>
-
-Disable scanline interpolation
-
-=item B<Alt + 8>
-
-Enable scanline interpolation
-
-=item B<Shift-Alt + 9>
-
-Select previous 'Custom' mode attribute (*)
-
-=item B<Alt + 9>
-
-Select next 'Custom' mode attribute (*)
-
-=item B<Shift-Alt + 0>
-
-Decrease 'Custom' selected attribute value (*)
-
-=item B<Alt + 0>
-
-Increase 'Custom' selected attribute value (*)
-
-=back
-
-Items marked as (*) are only available in 'Custom' preset mode
-
-=head2 Developer Keys in TIA mode (cannot be remapped)
-
-=over
-
-=item B<Alt + PageUp>
-
-Set "Display.YStart" to next larger value
-
-=item B<Alt + PageDown>
-
-Set "Display.YStart" to next smaller value
-
-=item B<Control + PageUp>
-
-Set "Display.Height" to next larger value
-
-=item B<Control + PageDown>
-
-Set "Display.Height" to next smaller value
-
-=item B<Alt + l>
-
-Toggle frame stats (scanline count/fps/bs type/etc)
-
-=item B<Alt + z>
-
-Toggle TIA Player0 object
-
-=item B<Alt + x>
-
-Toggle TIA Player1 object
-
-=item B<Alt + c>
-
-Toggle TIA Missile0 object
-
-=item B<Alt + v>
-
-Toggle TIA Missile1 object
-
-=item B<Alt + b>
-
-Toggle TIA Ball object
-
-=item B<Alt + n>
-
-Toggle TIA Playfield object
-
-=item B<Shift-Alt + z>
-
-Toggle TIA Player0 collisions
-
-=item B<Shift-Alt + x>
-
-Toggle TIA Player1 collisions
-
-=item B<Shift-Alt + c>
-
-Toggle TIA Missile0 collisions
-
-=item B<Shift-Alt + v>
-
-Toggle TIA Missile1 collisions
-
-=item B<Shift-Alt + b>
-
-Toggle TIA Ball collisions
-
-=item B<Shift-Alt + n>
-
-Toggle TIA Playfield collisions
-
-=item B<Alt + m>
-
-Toggle TIA HMOVE blanks
-
-=item B<Alt + Comma>
-
-Toggle TIA 'Fixed Debug Colors' mode
-
-=item B<Alt + .>
-
-Toggle all TIA objects
-
-=item B<Shift-Alt + .>
-
-Toggle all TIA collisions
-
-=back
-
-=head2 Other Keys (cannot be remapped, except those marked with '*')
-
-=over 4
-
-=item B<Alt + =>
-
-Switch to next larger zoom level
-
-=item B<Alt + ->
-
-Switch to next smaller zoom level
-
-=item B<Alt + Enter>
-
-Toggle fullscreen/windowed mode
-
-=item B<Alt + [>
-
-Decrease volume (*)
-
-=item B<Alt + ]>
-
-Increase volume (*)
-
-=item B<Control + f>
-
-Toggle console type in increasing order (NTSC/PAL/SECAM, etc))
-
-=item B<Shift-Control + f>
-
-Toggle console type in decreasing order (NTSC/PAL/SECAM, etc))
-
-=item B<Control + s>
-
-Save current properties to a new properties file
-
-=item B<Control + 0>
-
-Switch mouse between controller emulation modes
-
-=item B<Control + 1>
-
-Swap Stelladaptor/2600-daptor port ordering
-
-=item B<Control + r>
-
-Reload current ROM (singlecart ROM, TIA mode) or Load next game in ROM (multicart ROM, TIA mode)
-
-=item B<Control + r>
-
-Reload ROM listing (ROM launcher mode)
-
-=item B<Backspace>
-
-Emulate 'frying' effect (TIA mode) (*), Go to parent directory (UI mode) (*)
-=item B<Alt + p>
-
-Toggle 'phosphor' effect
-
-=item B<Control + p>
-
-Toggle palette
-
-=item B<Control + l>
-
-Toggle PAL color-loss effect
-
-=item B<Alt + s>
-
-Save continuous PNG snapshots (per interval)
-
-=item B<Shift-Alt + s>
-
-Save continuous PNG snapshots (every frame)
-
-=back
-
-=head2 UI keys in Text Editing areas (cannot be remapped)
-
-=over 4
-
-=item B<Home>
-
-Move cursor to beginning of line
-
-=item B<End>
-
-Move cursor to end of line
-
-=item B<Delete>
-
-Remove character to right of cursor
-
-=item B<Backspace>
-
-Remove character to left of cursor
-
-=item B<Control-a>
-
-Same function as 'Home'
-
-=item B<Control-e>
-
-Same function as 'End'
-
-=item B<Control-d>
-
-Same function as 'Delete'
-
-=item B<Control-k>
-
-Remove all characters from cursor to end of line
-
-=item B<Control-u>
-
-Remove all characters from cursor to beginning of line
-
-=item B<Control-w>
-
-Remove entire word to left of cursor
-
-=item B<Control-Left>
-
-Move cursor to beginning of word to the left
-
-=item B<Control-Right>
-
-Move cursor to beginning of word to the right
-
-=item B<Control-c>
-
-Copy entire line to clipboard (not complete)
-
-=item B<Control-v>
-
-Paste clipboard contents (not complete)
-
-=back
-
-=head1 FILES
-
-Starting with 5.0, B<stella> uses B<$HOME/.config/stella/> as
-the per-user config directory. Previous versions used B<$HOME/.stella/>.
-
-The config directory contains the following:
-
-=over 4
-
-=item B<stellarc>
-
-The Stella config file, created by B<stella>. May be hand-edited, but
-normally the built-in GUI is used to set these options.
-
-=item B<cfg/>
-
-Directory for DiStella config files, used only by the debugger.
-
-=item B<nvram/>
-
-Directory used to store the contents of non-volatile cartridge memory.
-
-=item B<state/>
-
-Directory used to store save-states (see B<F9> key).
-
-=back
-
-=head1 AUTHORS
-
-Stella was originally developed for Linux by Bradford W. Mott
-<bwmott@users.sourceforge.net>, and is currently maintained by Stephen
-Anthony <stephena@users.sourceforge.net>. Other contributors include
-Eckhard Stolberg <estolberg@users.sourceforge.net> and Brian Watson
-<yalhcru@gmail.com>.
-
-=head1 SEE ALSO
-
-Stella web site: I<http://stella.sourceforge.net/>.