Document CCACHE_BASEDIR

This commit is contained in:
Joel Rosdahl 2010-01-06 15:37:18 +01:00
parent d44f0b0592
commit e7544f9b76
2 changed files with 17 additions and 7 deletions

15
NEWS
View File

@ -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

View File

@ -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.