INSTALL

   1 Installing Survex on Unix
   2 =========================
   3
   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.
   7
   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).
  15
  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.
  20
  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.
  23
  24 Then at a shell prompt, enter the following commands:
  25
  26 ./configure
  27 make
  28 make install
  29
  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:
  33
  34 sudo make install
  35
  36 You can tell configure to install Survex elsewhere (e.g. under your home
  37 directory) like so:
  38
  39 ./configure --prefix=/home/olly/survex
  40 make
  41 make install
  42
  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:
  46
  47 ./configure WX_CONFIG=/opt/bin/wx-config
  48
  49 You can use both --prefix and WX_CONFIG= if necessary.