git

If you want to help with development or testing of experimental Survex code, and don't mind having to build it yourself, you can fetch the very latest sources using git. Most people will prefer to download a stable release.

To checkout from git.survex.com:

git clone https://git.survex.com/survex

This will check out the sources into a directory called survex and will check out the master branch by default (which is where 1.4.x is developed). You can switch to the 1.2 branch like so:

cd survex
git checkout -b RELEASE/1.2

The repository is also mirrored automatically to some git hosting sites - if you use those, you may prefer to create your own fork there and work with that:

• repo.or.cz
• github

Browsing git online

You can browse the repository online using gitweb, using trac, or via repo.or.cz or github (see above links).

Preparing to build

You'll need a few other programs to be installed in order to build Survex from git. Here's a (possibly incomplete - let us know if you find any omissions) list of the Debian package names (Ubuntu package names should be the same - for other Linux distributions the names may not be quite the same; if you're using some other OS you may need to install these from source):

• autoconf
• automake
• gcc
• g++
• gettext
• libproj-dev
• libwxgtk3.2-dev or libwxgtk3.0-gtk3-dev or libwxgtk3.0-dev
• perl
• imagemagick
• ghostscript
• netpbm
• liblocale-po-perl
• unifont
• sphinx-doc
• w3m

If you want the movie export feature then you'll also need:

• libavcodec-dev
• libavformat-dev
• libswscale-dev

You now need to generate the build system files - to do this, just run: autoreconf -i from autoconf 2.50 or later; you'll also need automake 1.5 or later installed.

Now you should be able to run ./configure and make as usual.

webmaster: Olly Betts