Overview

The build works like this:

• We start by running ./autogen.sh

  • autogen.sh runs autoconf to turn configure.ac into configure
  • autogen.sh also runs automake to turn Makefile.am into Makefile.in and src/Makefile.am into src/Makefile.in

• We then run ./configure

  • configure turns Makefile.in into Makefile and src/Makefile.in into src/Makefile
  • configure also turns config.h.in into config.h that contains some variables
  • configure also writes config.log, if there are errors they will be there

• ALWAYS run ./autogen.sh and ./configure from top-level, never a subdirectory

• ALWAYS configure with --enable-ccache for caching

• ALWAYS configure with --enable-sdfprefs to inhibit noisy build output

• NEVER edit configure directly, only ever edit configure.ac

• NEVER edit Makefile or Makefile.in directly, only ever edit Makefile.am

To change configuration settings, re-run ./configure with new flags.