1ccache installation from release archive
2========================================
3
4Prerequisites
5-------------
6
7To build ccache from a
8[release archive](https://ccache.dev/download.html), you need:
9
10- A C compiler (for instance GCC)
11
12It is also recommended that you have:
13
14- [zlib](http://www.zlib.net) (if you don't have zlib installed, ccache will
15  use a bundled copy)
16
17
18Installation
19------------
20
21To compile and install ccache, run these commands:
22
23    ./configure
24    make
25    make install
26
27You may set the installation directory and other parameters by options to
28`./configure`. To see them, run `./configure --help`.
29
30There are two ways to use ccache. You can either prefix your compilation
31commands with `ccache` or you can create a symbolic link (named as your
32compiler) to ccache. The first method is most convenient if you just want to
33try out ccache or wish to use it for some specific projects. The second method
34is most useful for when you wish to use ccache for all your compilations.
35
36To install for usage by the first method just copy ccache to somewhere in your
37path.
38
39To install for the second method, do something like this:
40
41    cp ccache /usr/local/bin/
42    ln -s ccache /usr/local/bin/gcc
43    ln -s ccache /usr/local/bin/g++
44    ln -s ccache /usr/local/bin/cc
45    ln -s ccache /usr/local/bin/c++
46
47And so forth. This will work as long as `/usr/local/bin` comes before the path
48to the compiler (which is usually in `/usr/bin`). After installing you may wish
49to run `which gcc` to make sure that the correct link is being used.
50
51NOTE: Do not use a hard link, use a symbolic link. A hard link will cause
52"interesting" problems.
53