From c7d98a0e9a2f2a6055dd4fd5ca1eea111c4aa558 Mon Sep 17 00:00:00 2001 From: Joel Rosdahl Date: Wed, 23 Aug 2023 19:06:35 +0200 Subject: [PATCH] docs: Mention that system_headers sloppiness is not supported for MSVC Closes #1224. --- doc/MANUAL.adoc | 13 ++++++++++--- 1 file changed, 10 insertions(+), 3 deletions(-) diff --git a/doc/MANUAL.adoc b/doc/MANUAL.adoc index 4243fff18..64b429030 100644 --- a/doc/MANUAL.adoc +++ b/doc/MANUAL.adoc @@ -1056,9 +1056,16 @@ preprocessing first. hash. This is useful if your build system generates different seeds between builds and you are OK with reusing cached results. *system_headers*:: - By default, ccache will also include all system headers in the manifest. - With this sloppiness set, ccache will only include system headers in the - hash but not add the system header files to the list of include files. + Only check non-system headers in direct mode. + This can be useful if e.g. your system headers tend to change but you know that + the changes don't matter. Notes: ++ +* This sloppiness is only supported for GCC-like compilers, not MSVC. +* System headers are still taken into account for preprocessed lookup. +* You can get stale cache hits if the system headers do change in incompatible + ways. +* See also the + <> setting. *time_macros*:: Ignore `+__DATE__+`, `+__TIME__+` and `+__TIMESTAMP__+` being present in the source code. -- 2.47.2