Unpacking, Configuring, Building, and Installing

Once you have the CCM Tools source tarball, locate a suitable directory for unpacking it. Common places to do this (on Linux) are $HOME/src, or, if you decide to install as the superuser, in /usr/local/src or /usr/src. For the rest of this section, as an example, I will assume you want to build in a directory under /home/leif/src.

First, open up a terminal window, and change directories to your chosen location.

leif@fridge:~ $ cd src

Then unpack the source tarball, and change directories into the newly-created ccmtools-A.B.C directory (where A.B.C is the version of CCM Tools that you are using).

leif@fridge:~/src $ tar zxf ccmtools-A.B.C.tar.gz
leif@fridge:~/src $ cd ccmtools-A.B.C

The standard GNU install process involves two major steps: configuring and building. To help with platform-independence for installing and such, the tarball comes with a configure script. To invoke it, just type ./configure. You can get a list of available options by giving the -help option.

If you want to install the CCM Tools into a nonstandard location (the default is system dependent), specify the -prefix=DIR option. If you would like to build the tests and documentation by default, specify the -enable-tests and -enable-docs options, respectively. Note that enabling tests while building the CCM Tools is not the same as building test or mirror components; you can keep the CCM Tools tests disabled at this point and still be able to generate test components later.

leif@fridge:~/src $ ./configure --help
`configure' configures ccmtools A.B.C to adapt to many ...

Usage: ./configure [OPTION]... [VAR=VALUE]...
:
:
leif@fridge:~/src $ ./configure --prefix=/home/leif/sandbox
checking for a BSD-compatible install... /usr/bin/install -c
checking whether build environment is sane... yes
checking for gawk... gawk
checking whether make sets $(MAKE)... yes
:
:

Then, to build the package, simply type make. Install the package with make install. Note that normally the package needs to be installed to function correctly, as the code generators otherwise have no way of finding their template sets.