*CCACHE_BASEDIR*::
- If you set the environment variable *CCACHE_BASEDIR* to an absolute path,
- ccache rewrites absolute paths into relative paths before computing the
- hash that identifies the compilation, but only for paths under the
- specified directory. See the discussion under
+ If you set the environment variable *CCACHE_BASEDIR* to an absolute path to
+ a directory, ccache rewrites absolute paths into relative paths before
+ computing the hash that identifies the compilation, but only for paths
+ under the specified directory. See the discussion under
<<_compiling_in_different_directories,COMPILING IN DIFFERENT DIRECTORIES>>.
*CCACHE_CC*::
* the command line options except options that affect include files (*-I*,
*-include*, *-D*, etc; the theory is that these options will change the
preprocessor output if they have any effect at all)
-* the real compiler's size and modification time (unless
- *CCACHE_COMPILERCHECK* says something else)
+* the real compiler's size and modification time (unless CCACHE_COMPILERCHECK*
+ *says something else)
* any standard error output generated by the preprocessor
Based on the hash, the cached compilation result can be looked up directly in
share compilation results between the different build directories since you get
cache misses because of the absolute build directory paths that are part of the
hash. To mitigate this problem, you can specify a ``base directory'' by setting
-the *CCACHE_BASEDIR* variable to an absolute path. ccache will then rewrite
-absolute paths that are under the base directory (i.e., paths that have the
-base directory as a prefix) to relative paths when constructing the hash. The
-typical path to use as base directory is your home directory or another
-directory that is a parent of your build directories. (Don't use +/+ as the
-base directory since that will make ccache also rewrite paths to system header
-files, which doesn't gain anything.)
+the *CCACHE_BASEDIR* variable to an absolute path to the directory. ccache will
+then rewrite absolute paths that are under the base directory (i.e., paths that
+have the base directory as a prefix) to relative paths when constructing the
+hash. A typical path to use as the base directory is your home directory or
+another directory that is a parent of your build directories. (Don't use +/+ as
+the base directory since that will make ccache also rewrite paths to system
+header files, which doesn't gain anything.)
The drawbacks of using *CCACHE_BASEDIR* are: