From e7544f9b76aac01fbaeac38e25e5ef1223e2513a Mon Sep 17 00:00:00 2001 From: Joel Rosdahl Date: Wed, 6 Jan 2010 15:37:18 +0100 Subject: [PATCH] Document CCACHE_BASEDIR --- NEWS | 15 ++++++++------- ccache.yo | 9 +++++++++ 2 files changed, 17 insertions(+), 7 deletions(-) diff --git a/NEWS b/NEWS index 0a9884a..c44fa92 100644 --- a/NEWS +++ b/NEWS @@ -10,13 +10,14 @@ New features and improvements: speedup will be higher when I/O is fast (e.g., when files are in the disk cache). The direct mode can be disabled by setting CCACHE_NODIRECT. - - When hashing the output from the preprocessor, absolute paths for which the - path specified by CCACHE_BASEDIR is a prefix are rewritten to relative. - Paths specified by -I and similar flags get the same treatment. This is - done to get cache hits even when compiling with -g and when using absolute - include directory paths. Absolute paths in the standard error text will - also be more accurate. CCACHE_BASEDIR defaults to the current working - directory. + - When hashing the output from the preprocessor, absolute paths are rewritten + to relative paths, but only for paths under the directory specified by + CCACHE_BASEDIR. Paths specified by -I and similar options get the same + treatment. This is done to get cache hits even when compiling with -g and + when using absolute include directory paths. Absolute paths in the standard + error text will also be more accurate. The default value of CCACHE_BASEDIR + is the current working directory. To disable the rewriting, set + CCACHE_BASEDIR to the empty string. - Object files are now by default stored compressed in the cache. The runtime cost is negligible, and more files will fit in the ccache directory and in diff --git a/ccache.yo b/ccache.yo index 151c467..21704e0 100644 --- a/ccache.yo +++ b/ccache.yo @@ -124,6 +124,15 @@ most cases you won't need any of these as the defaults will be fine. startdit() +dit(bf(CCACHE_BASEDIR)) When hashing the output from the preprocessor, +absolute paths are rewritten to relative paths, but only for paths +under the directory specified by CCACHE_BASEDIR. Paths specified by -I +and similar options get the same treatment. This is done to get cache +hits even when compiling with -g and when using absolute include +directory paths. The default value of CCACHE_BASEDIR is the current +working directory. To disable the rewriting, set CCACHE_BASEDIR to the +empty string. + dit(bf(CCACHE_CC)) You can optionally set CCACHE_CC to force the name of the compiler to use. If you don't do this then ccache works it out from the command line.