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 https://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 (with support for C++11), and
  22 also the OpenGL development libraries if these aren't pulled in by installing
  23 wxWidgets.
  24
  25 Then at a shell prompt, enter the following commands:
  26
  27 ./configure
  28 make
  29 make install
  30
  31 By default 'make install' will try to install Survex under /usr/local,
  32 which means you'll probably need to become root for the 'make install' stage.
  33 If you use sudo to manage root access, then:
  34
  35 sudo make install
  36
  37 You can tell configure to install Survex elsewhere (e.g. under your home
  38 directory) like so:
  39
  40 ./configure --prefix=/home/olly/survex
  41 make
  42 make install
  43
  44 If your wxWidgets installation isn't picked up automatically, or you
  45 have more than one version installed and want to select a particular
  46 one, then you can specify this like so:
  47
  48 ./configure WX_CONFIG=/opt/bin/wx-config
  49
  50 You can use both --prefix and WX_CONFIG= if necessary.