94e540a5f2d37f23b40b7cbb0cbef51d65b10af5
[expresskeys.git] / INSTALL
1
2 (Look at the end of this file if there is a problem compiling)
3
4 Normally just type:
5
6 ./configure
7 make
8 make install
9
10 Default installation directory is /usr/local/bin so you must be root
11 for the "make install" part. Change the target directory if this is
12 undesirable, eg:
13
14 ./configure --prefix=/home/user
15
16 The binary will then be installed to a /home/user/bin directory instead.
17
18 The old-extra directory holds the expresskeys-reread.sh and
19 expresskeys-terminate.sh shell scripts. They are not installed by the
20 GNU Autotools. Copy them manually if you want them.
21
22 Use the "--with-xlib=" and/or "--with-xinc=" options if your Xlib environment
23 is nonstandard. By default we test what is returned from the commands
24 "pkg-config --variable=libdir x11" and "pkg-config --variable=includedir x11"
25 which works in the modular X11R7 releases. If that fails, we try a hardcoded
26 /usr/X11R6/lib[64] and /usr/X11R6/include for the monolithic X11R6 releases.
27
28 --------------------------------------------------------------------------
29
30 I've also left the old style Makefiles in the old-extra directory. If the
31 GNU Autotools fail for some reason, those are easier to understand and
32 edit. Then just copy them over to each Makefile in the source directories.
33 Type "make" and copy the binary to a suitable location.
34
35 --------------------------------------------------------------------------
36
37 Problems?
38
39 Make sure that the dependencies for compiling this program are met.
40 Apart from the normal libraries and header files used for any
41 program development, we need what loosely can be called an
42 "X development environment". Specifically the following libraries
43 must be available for linking: libX11.so libXext.so libXi.so and
44 libXtst.so Header files from X that we must be able to include are:
45 X11/Xlib.h X11/Xutil.h X11/extensions/XInput.h and X11/extensions/XTest.h
46 Some distributions do not provide this environment by default and
47 therefore require additional packages to be installed before
48 compiling. Example names from one distribution are libxi-dev and
49 libxtst-dev for the xinput and xtest packages.
50