Update testsuite; improve locations for some cases
[survex.git] / INSTALL
blob37166925ebe3669728eec89630534d87c3769e3d
1 Installing Survex on Unix
2 =========================
4 If you are using Debian Linux or Ubuntu Linux or a distribution based
5 on one of these, you will find it easier to install one of the
6 prepackaged versions of Survex.
8 Otherwise building from source is very easy.  First of all, you need
9 to make sure you have the required libraries installed.  The main
10 dependency is wxWidgets 2.8 or later - if there's a suitable wxWidgets
11 package for your platform, then just use that (note: library packages
12 are usually split into runtime and development, usually with the same
13 name but with a -dev or -devel or similar suffix on the latter - you'll
14 need both to build Survex).
16 Otherwise download the source code from http://www.wxwidgets.org/ and
17 follow their build instructions.  IMPORTANT: You must enable OpenGL
18 support by adding --with-opengl to the configure command line, and
19 you probably want to use --enable-unicode too.
21 You'll also need a working C and C++ compiler, and also the OpenGL development
22 libraries if these aren't pulled in by installing wxWidgets.
24 Then at a shell prompt, enter the following commands:
26 ./configure
27 make
28 make install
30 By default 'make install' will try to install Survex under /usr/local,
31 which means you'll probably need to become root for the 'make install' stage.
32 If you use sudo to manage root access, then:
34 sudo make install
36 You can tell configure to install Survex elsewhere (e.g. under your home
37 directory) like so:
39 ./configure --prefix=/home/olly/survex
40 make
41 make install
43 If your wxWidgets installation isn't picked up automatically, or you
44 have more than one version installed and want to select a particular
45 one, then you can specify this like so:
47 ./configure WX_CONFIG=/opt/bin/wx-config
49 You can use both --prefix and WX_CONFIG= if necessary.