aboutsummaryrefslogtreecommitdiff
path: root/games/xroar/README_SBo.txt
blob: ec19bf5505de1db2de022c4b0e67848202784ba9 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
Optional Dependencies
=====================

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 don't want to build xroar with SDL2, export SDL2=no [2].
  This will remove the "-ui sdl" option, which is probably of no
  consequence since the SDL user interface isn't very featureful.

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. I made it a hard dependency because the SDL user
     interface has no real GUI features, while the gtkglext UI acts
     like a proper GUI application. Users who just take the defaults
     will end up with the usable UI. If you're reading this, you're
     welcome to ignore the REQUIRES="gtkglext" and build with SDL2
     only, if you have a reason to want to.

[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.