aboutsummaryrefslogtreecommitdiff
path: root/games/xroar/README_SBo.txt
diff options
context:
space:
mode:
authorB. Watson <yalhcru@gmail.com>2020-10-25 02:02:37 -0400
committerWilly Sudiarto Raharjo <willysr@slackbuilds.org>2020-10-31 11:15:37 +0700
commit63c0f8d3e150cd385055d1ed11094f29064c012a (patch)
tree3b84b6423f45af5f2372e9b994983d825f460ca5 /games/xroar/README_SBo.txt
parent70518dbaedd94c3d6c3727449bc2119ae220a36e (diff)
games/xroar: Updated for version 0.36.2.
Signed-off-by: B. Watson <yalhcru@gmail.com> Signed-off-by: Willy Sudiarto Raharjo <willysr@slackbuilds.org>
Diffstat (limited to 'games/xroar/README_SBo.txt')
-rw-r--r--games/xroar/README_SBo.txt40
1 files changed, 40 insertions, 0 deletions
diff --git a/games/xroar/README_SBo.txt b/games/xroar/README_SBo.txt
new file mode 100644
index 0000000000000..c7ccc12db306f
--- /dev/null
+++ b/games/xroar/README_SBo.txt
@@ -0,0 +1,40 @@
+Optional Dependencies
+=====================
+
+SDL2 - If this is installed, xroar's alternate "bare-bones" SDL2
+ user inteface will be available via the "-ui sdl" option.
+
+jack - if you want to use JACK for audio output, install jack and set
+ JACK=yes in the environment before building xroar. If JACK audio has
+ x-runs, try 'setcap cap_ipc_lock,cap_sys_nice=ep /usr/games/xroar'.
+
+
+Environment Variables
+=====================
+
+GTKGLEXT - If you have gtkglext installed, but don't want to build
+ xroar with it, export GTKGLEXT=no [1] [2].
+
+SDL2 - If you have SDL2 installed, but don't want to build xroar with
+ it, export SDL2=no [2].
+
+OSS - use OSS for audio? Default is "no", export OSS="yes" to enable.
+ Most users won't need this.
+
+PULSE - use PulseAudio? Default is "yes", export PULSE="no" to disable.
+
+
+Notes
+=====
+
+[1]: Yes, gtkglext is optional, despite being listed in REQUIRES in
+ the .info file. There's no "either-or" syntax for REQUIRES, so
+ I had to list either gtkglext or SDL2, and the gtkglext UI
+ is a lot nicer so it's what most people will want.
+
+[2]: At least one of SDL2 or gtkglext is required, so you can't build
+ with SDL2=no GTKGLEXT=no. If you want to be super-pedantic, yes,
+ it *is* possible to build xroar without either gtkglext or SDL2,
+ but the result is that xroar won't display anything at all. This
+ is useless and confusing, nobody wants it, and I'm not willing to
+ support it.