games/stella: Updated for version 5.0.1.

Signed-off-by: B. Watson <yalhcru@gmail.com>

4 files changed, 51 insertions, 12 deletions

diff --git a/games/stella/stella.6 b/games/stella/stella.6
index 0abe5b4baf..e523a85316 100644
--- a/games/stella/stella.6
+++ b/games/stella/stella.6
@@ -71,7 +71,7 @@
 .\" ========================================================================
 .\"
 .IX Title "STELLA 6"
-.TH STELLA 6 "2016-08-04" "4.7.2" "SlackBuilds.org"
+.TH STELLA 6 "2017-07-23" "5.0" "SlackBuilds.org"
 .\" For nroff, turn off justification.  Always turn off hyphenation; it makes
 .\" way too many mistakes in technical documents.
 .if n .ad l
@@ -170,6 +170,18 @@ can reduce width until the pixels appear square. Allowable values are
 .IX Item "-tia.fsfill <1|0>"
 Stretch \s-1TIA\s0 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
@@ -345,7 +357,8 @@ Hide \s-1ROM\s0 info viewer in \s-1ROM\s0 launcher mode (0), or use the given zo
 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.
+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>"
 Set the amount of time to wait between treating successive keypresses
@@ -506,7 +519,8 @@ 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.
+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"
 The Atari 2600 console controls and controllers are mapped to the
@@ -1081,7 +1095,10 @@ Copy entire line to clipboard (not complete)
 Paste clipboard contents (not complete)
 .SH "FILES"
 .IX Header "FILES"
-\&\fB\f(CB$HOME\fB/.stella/\fR contains the following:
+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
diff --git a/games/stella/stella.SlackBuild b/games/stella/stella.SlackBuild
index cefead0f66..bd05d76bf7 100644
--- a/games/stella/stella.SlackBuild
+++ b/games/stella/stella.SlackBuild
@@ -8,6 +8,8 @@
 
 # Now maintained by B. Watson <yalhcru@gmail.com>
 
+# 20170723 bkw: update for 5.0.1
+
 # 20170620 bkw:
 # - fix for -current (does no harm on 14.2).
 # - invert changelog so oldest entries are at bottom.
@@ -34,7 +36,7 @@
 # - StartupNotify=false in .desktop
 
 PRGNAM=stella
-VERSION=${VERSION:-4.7.3}
+VERSION=${VERSION:-5.0.1}
 BUILD=${BUILD:-1}
 TAG=${TAG:-_SBo}
 
diff --git a/games/stella/stella.info b/games/stella/stella.info
index 720fa242a5..677570047c 100644
--- a/games/stella/stella.info
+++ b/games/stella/stella.info
@@ -1,8 +1,8 @@
 PRGNAM="stella"
-VERSION="4.7.3"
+VERSION="5.0.1"
 HOMEPAGE="https://stella-emu.github.io/"
-DOWNLOAD="https://github.com/stella-emu/stella/releases/download/release-4.7.3/stella-4.7.3-src.tar.xz"
-MD5SUM="898578ee405430815e12374f191e9b51"
+DOWNLOAD="https://github.com/stella-emu/stella/releases/download/5.0.1/stella-5.0.1-src.tar.xz"
+MD5SUM="45deeed59a6a54ba46ad14b3c74e209d"
 DOWNLOAD_x86_64=""
 MD5SUM_x86_64=""
 REQUIRES="SDL2"
diff --git a/games/stella/stella.pod b/games/stella/stella.pod
index 0d03af2d25..9a5c51d66a 100644
--- a/games/stella/stella.pod
+++ b/games/stella/stella.pod
@@ -1,5 +1,5 @@
 # pod source for stella man page. Convert with:
-# pod2man --stderr -s6 -cSlackBuilds.org -r4.7.2 -u stella.pod > stella.6
+# pod2man --stderr -s6 -cSlackBuilds.org -r5.0 -u stella.pod > stella.6
 
 =pod
 
@@ -118,6 +118,21 @@ can reduce width until the pixels appear square. Allowable values are
 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
@@ -336,7 +351,8 @@ level (1 or 2).
 
 =item B<-uipalette> <standard|classic>
 
-Use the specified palette for UI elements.
+Use the specified palette for UI elements. B<classic> is green-on-black,
+B<standard> is more colorful.
 
 =item B<-listdelay> <delay>
 
@@ -542,7 +558,8 @@ 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.
+behaviour as compared to real hardware. Note that Thumb ARM emulation
+only applies to the BUS, CDF, and DPC+ cartridge types.
 
 =back
 
@@ -1351,7 +1368,10 @@ Paste clipboard contents (not complete)
 
 =head1 FILES
 
-B<$HOME/.stella/> contains the following:
+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