The following instructions describe how to work with the source code that was
checked out from the git repository.

The major difference between using a released source code package and source
code from the repository is that the former does not contain autotools-based
makefiles or Visual Studio project files. Instead, it contains templates for
these files as well as its own, custom build system. This build system is
used for development as well as to automatically generate the autotools and
Visual Studio files.

This file describes how to use this build system to build the package as well
as to create a release-ready source distribution which contains the autotools
build system and Visual Studio project files.


Prerequisites
=============

Besides the prerequisites listed in the INSTALL file, you will need the
following additional packages:

  - GNU bash >= 2.0.0   http://www.gnu.org/software/bash/
  - GNU make >= 3.81    http://www.gnu.org/software/make/
  - build    >= latest  http://www.codesynthesis.com/projects/build/

If you are planning to create the source code distributions, then you will
also need the following packages:

  - GNU m4   >= 1.4.0   http://www.gnu.org/software/m4/
  - GNU sed  >= 4.0.0   http://www.gnu.org/software/sed/
  - tofrodos >= 1.7.0   http://www.thefreecountry.com/tofrodos/

As we as the GNU autotools:

  - GNU libtool  >= 2.2.6b  http://www.gnu.org/software/libtool/
  - GNU autoconf >= 2.67    http://www.gnu.org/software/autoconf/
  - GNU automake >= 1.11.1  http://www.gnu.org/software/automake/

Any reasonably up to date GNU/Linux installation would normally have all of
the above packages already present, except for build and maybe tofrodos.


Configuring and Building
========================

To build the source code simply run make in the root directory of the package.
The first time you run make, the build process will also configure the
package by asking you several questions. On the subsequent runs, make will
only rebuild what has changed.

To run the automated test suite (if any), run 'make test'. To clean the object
files, executables, etc., run 'make clean'. To de-configure the package (that
is, to remove configuration files in addition to objects, executables, etc.),
run 'make disfigure'.


Creating Distribution
=====================

To create the source code distribution, use the dist make target as well as
the dist_prefix variable to specify the directory where the distribution files
should be placed. For example:

make dist dist_prefix=/tmp/package-1.1.0

Once the distribution files are ready, change to the distribution directory
and run the bootstrap script to bootstrap the autotools build system, for
example:

cd /tmp/package-1.1.0
./bootsrap

To create the source code archives, use the autotools build system. First
configuring the package (see the INSTALL file for more information on this
step) and then use the dist target to make the archives, for example:

./configure
make dist