upgrade waf to 2.1.2
[gmidimonitor.git] / INSTALL
blob897fc9a5143342a59db220a31b53957d00720571
1 Quick instructions: ./waf configure && ./waf && sudo ./waf install
3 You need:
5   1. Build tools
6      1.1 compiler + linker
7          Known to work with gcc 3.4.3 and binutils 2.15.94.0.2.2
8          You can get gcc from http://www.gnu.org/software/gcc/
9          You can get binutils from http://www.gnu.org/software/binutils/
10      1.2 Python
11          Known to work with Python 2.7.1
12          You can get it from http://www.python.org/
13      1.3 pkg-config
14          Known to work with pkg-config 0.19
15          You can get it from http://pkgconfig.freedesktop.org/wiki/
17   2. Libraries
18      2.1 GTK+ >= 2.12 (required)
19          Known to work with GTK+ 2.24.4
20          You can get it from http://www.gtk.org/
21      2.2 JACK with MIDI support, i.e. >= 0.102.20 (optional)
22          You can get it from http://jackaudio.org/
23      2.3 ALSA library (optional)
24          Known to work with alsa-lib 1.0.9
25          You can get it from http://www.alsa-project.org/
26      2.4 LASH (optional)
27          Known to work with lash 0.5.0
28          You can get it from http://www.nongnu.org/lash/
30 Support for both JACK MIDI and ALSA MIDI is optional, but you have
31 to use at least one of them.
33 To configure gmidimonitor execute the configure script:
35     # ./waf configure
37 If you want to explicitly enable or disable jack, alsa or lash
38 support, you can do it at configure stage.
40 For example:
42     # ./waf configure --alsa=no --jack=yes
44 With these options, the configure stage will not even try to detected
45 whether ALSA can be built, will fail if JACK it cannot find JACK and
46 will enable LASH only if it is available.
48 To build gmidimonitor:
50     # ./waf
52 Now install it (you may need to be root to do this):
54     # ./waf install
56 Good luck and report bugs so they can get fixed.