Put "calculate preprocessor hash" code into "if" block

In a following commit we will execute this code conditionally.

Even though the change is simple, the diff looks rather ugly (unless
when ignoring whitespace differences).  Having this step as a separate
commit should make the following commit more clear.

Chose to not factor it out into a separate function because of the
amount of local variables referenced.

Move update_cached_result_globals() up within source file

Move function so that we can use it in `to_cache()`.

Add missing free()

Add option handling code for `depend_mode`

Only code for the option itself, the option is not being used yet.

Merge branch '3.4-maint'

* 3.4-maint:
  Prepare for v3.4.2
  direct .i mode: Don't create tmp.cpp_stderr file at all

Prepare for v3.4.2

direct .i mode: Don't create tmp.cpp_stderr file at all

Create tmp file only when it's actually needed.

Merge branch '3.4-maint'

* 3.4-maint:
  Clean up
  win32: Silence compiler warnings
  cleanup: Improve robustness when multiple cleanups run concurrently
  cleanup: Log size before cleaning
  Add x_try_unlink utility function
  test: Use helper functions instead of custom code
  test: Improve error messages from expect_{equal,different}_files

Clean up

win32: Silence compiler warnings

cleanup: Improve robustness when multiple cleanups run concurrently

The file count/size counters are now intentionally subtracted even if
there file to delete has disappeared since the final cache size
calculation will be incorrect if they aren’t. This can happen when there
are several parallel ongoing cleanups of the same subdirectory.

Also removed the “delete sibling files” logic; it’s unnecessary for all
siblings except .stderr since that’s the only file in a result that is
optional. Any other missing file will be detected by
get_file_from_cache.

cleanup: Log size before cleaning

Add x_try_unlink utility function

It behaves like x_unlink but doesn’t log a failure if the file is
missing.

test: Use helper functions instead of custom code

test: Improve error messages from expect_{equal,different}_files

Merge branch '3.4-maint'

* 3.4-maint:
  Update NEWS
  Clean up
  Support out-of-source builds
  Be consistent with “Clang” and “NVCC” names in NEWS
  Don’t apply Clang workaround for PCH dependencies for other compilers

Update NEWS

Clean up

Support out-of-source builds

Separate (read-only) $srcdir and (output) $builddir

Still support both developer mode and dist (+check).

Be consistent with “Clang” and “NVCC” names in NEWS

Don’t apply Clang workaround for PCH dependencies for other compilers

Closes #235.

Merge branch '3.4-maint'

* 3.4-maint:
  cleanup: Remove special-casing of files from ccache 2.x
  Fix debug_prefix_map suite
  Improve AsciiDoc markup
  Improve man page generation
  Remove redundant .gitignore entries

cleanup: Remove special-casing of files from ccache 2.x

It feels like a safe assumption that nobody will run ccache 3.4.x and
2.x on the same cache directory.

Fix debug_prefix_map suite

Improve AsciiDoc markup

Improve man page generation

* Use AsciiDoc’s a2x tool instead of running xsltproc explicitly.
* Stow away ccache.1 in doc.
* Make AsciiDoc literals stand out as bold in the man page. We can now
  use properly literals instead of emphasis in the manual.

Remove redundant .gitignore entries

Merge branch '3.4-maint'

* 3.4-maint:
  Change extension of AsciiDoc files to .adoc

Change extension of AsciiDoc files to .adoc

This should make them nicely rendered in the GitHub file tree.

Change extension of AsciiDoc files to .adoc

This should make them nicely rendered in the GitHub file tree.

Update NEWS

Apply code review suggestions

Allow a pre-computed checksum file for precompiled headers

Having large precompiled header files slows down direct mode off
CCache considerably. Allow CCache to check against a (much smaller)
pre-computed checksum file instead of the precompiled header file
itself. This checksum file will be used in the manifest instead of
the actual precompiled header file.

Note that to make this to work, the build system needs to keep a
checksum file in sync with the precompiled header.

The behavior can be activated by the `pch_external_checksum` option.

Merge branch '3.4-maint'

* 3.4-maint:
  The Dockerfile was moved to a subdirectory

The Dockerfile was moved to a subdirectory

Merge branch '3.4-maint'

* 3.4-maint:
  Fix paths to bundled zlib

Fix paths to bundled zlib

Regression from the source code rearrangement in 4aa357782e48.

Also added a distcheck that verifies that “./configure
--with-bundled-zlib” works.

Closes #229.

Merge branch '3.4-maint'

* 3.4-maint:
  Hash preprocessed headers located in “.gch directories” correctly

Hash preprocessed headers located in “.gch directories” correctly

Previously, ccache would not pick up changes to such precompiled
headers, risking false positive cache hits.

Rename CCACHE_CC to CCACHE_COMPILER

Prepare for v3.4.1

Fix printing of version number in “ccache --version”

Closes #225.

Prepare for v3.4

Update lookup tables with new location of .gperf files

Add update-authors make recipe and use it

Improve README.md

Rearrange files into suitable subdirectories, e.g. src and doc

The top directory has become too crowded.

Simplify initialize() slightly

Treat unreadable conf file like missing instead of a fatal error

This reverts 0b18af47 and implements a better solution.

The major reason is to keep ccache transparent, i.e. to still have the
following behavior:

* If ccache returns exit code == 0, then any produced stderr comes from
  the compiler and only from the compiler.
* If ccache returns exit code != 0, then ccache may print error messages
  of its own.

The reason is that autoconf configure scripts have been known to fail
tests if the compiler emits anything to stderr even if the produced
result actually works. (And printing to stdout is also a no-no.)

Document caveats related to colored warnings from compilers

Document more pitfalls with hard links

Use strftime instead of obsolete asctime function

Fix most warnings from cppcheck 1.72

Change “improvements” to “enhancements” in NEWS.txt

Every change is hopefully an improvement.

Fix use-after-free error in 316b966b

Hash host compilers invoked by nvcc

See #145.

Introduce and use ARRAY_SIZE macro

Hash '-ccbin' argument

unittest: Pass errmsg to CHECKM when available

From PR #169.

Update config.guess and config.sub to modern versions

As suggested in PR #169.

Only pass implicit -MQ to preprocessor if needed

Fixes #209.

Update NEWS

test: Add and fix cpp1 suite

I messed up when adapting Anders's work in f58741b5 to the new test
layout.

Update NEWS

Improve docs and clean up

Pass the cpp1 flags more selectively

The -fdirectives-only flag is needed for *both* cpp and cc/c++,
but the -frewrite-includes is only needed for cpp (not cc/c++).

Also make it easier to follow along in the gcc manual by passing
-fpreprocess explicitly, just like we pass the language to clang.

Add test case for directives-only/rewrite-includes

Use run_second_cpp = false (also known sometimes as "cpp1"),
but instruct the preprocessor to only handle include directives.

Make sure that any headers are still processed, and that both
the #define and -D work as usual (with regular preprocessing).

Handle semi-preprocessed source code with cpp1

When using gcc -fdirectives-only or clang -frewrite-includes,
we still need to pass preprocessor arguments to the compiler.

Also make sure to set the language for clang (but not for gcc),
since the file no longer contains regular preprocessed source.

Clean up

Fail if boolean env vars are set with common negative strings

Boolean environment variables have strange semantics: if the variable
is set then the configuration setting is considered "true".  This means
users can easily be mistaken that eg CCACHE_DISABLE=false means that
the "disable" setting is set to false.

To avoid too much backwards-incompatibility, we now exit with an error if
some common negative-sounding (case-insensitive) values:
"0", "false", "disable", "no".

All other values (including the empty string) are still considered to mean
"true".

Resolves https://github.com/ccache/ccache/issues/182

test: Rearrange files into test and unittest directories

* The unit tests formerly located in the test directory have been moved
  to the unittest directory.
* The integration test suite test.sh has been made a bash script and
  renamed to test/run. Its test suites are located in test/suites.

Prefer bash, when running test.sh script

Look for bash, to make it possible to run "make test"
on platforms where it is not the /bin/sh implementation.

It is possible to build ccache without it, when only
running the limited unit tests (with "make quicktest").

Merge branch '3.3-maint'

* 3.3-maint:
  Prepare for v3.3.6

Prepare for v3.3.6

Tweak code style and comments

Merge branch '3.3-maint'

* 3.3-maint:
  Update NEWS
  test: Verify that UNCACHED_ERR_FD works
  Only write hash debug output if there is any data
  Fix broken UNCACHED_ERR_FD

Update NEWS

test: Verify that UNCACHED_ERR_FD works

Only write hash debug output if there is any data

Fix broken UNCACHED_ERR_FD

It shouldn't be closed on exec since that's exactly the point, to leak
it to whatever ccache calls.

test: Fix nvcc tests when using compiler with options

test: Remove superfluous blank lines

test: Split into one file per suite

The test.sh file has simply grown unpleasantly large, so it's time to
split it up. Some suites still refer to stuff defined in earlier suites,
but we'll have to live with that for now.

Update NEWS

Clean up code related to CUDA/nvcc

Remove tabs from test.sh, use lowercase names for local variables and
other minor fixes.

test: Fix nvcc_ldir tests when gcc is a masquerading ccache

Bug fixes and tests for nvcc

Feature: Added cuda compiler in separate travis job and implemented
         tests for nvcc.

Feature: Added support for nvcc compiler options --compiler-bindir/-ccbin,
         --output-directory/-odir and --libdevice-directory/-ldir.
         Added tests for these options in test.sh.

Bug fix: Original patch had a statement to avoid using the preprocessed
         input files for nvcc when run_second_cpp is false. Otherwise,
         when a build is necessary and the preprocessed output was used,
         nvcc results with a compiler error. The patch simply ensures
         run_second_cpp is always set to true for the cuda compiler.

Bug fix: The -optf and -odir options are only accepted for nvcc. For other
         compilers, they behave like '-o ptf' resp. '-o dir'.
         A test was added to check this behaviour.

test: Fix failure in gcc pch suite when using compiler with options

Need to remember any extra compiler options in REAL_COMPILER as well.

test: Find and use real compiler

The real compiler is now found in the same way as ccache itself does it,
so we no longer have to rely on the uncached_compile hack.

test: Check that dependency file contains the correct object name

Refactor and clean up code for copying results to/from the cache

Lots of cruft and copy pasta has collected during the years.

* It's enough to let get_file_from_cache detect missing files in the
  cache; no need to check before.
* Made the order of the handling of the different file types consistent
  in various places.
* Removed the tmp_cov, tmp_su and tmp_dwo variables. I cannot
  see why they just aren't redundant since the corresponding output_*
  variables already exist with the same value. Except for the "GCC has
  some funny rule" part, but that seems bogus anyway since tmp_* and
  output_* must be equal for things to work. Let's just ignore it for
  now.
* Removed the support for generating placeholders for .cov and .su files
  if the compiler doesn't create them. Modern compilers always create
  them, and I want to reduce code complexity.

Improve file size/number counters for overwritten files

When ccache overwrites a cached file, the counters are still increased
as if a new file was stored in the cache, for instance when recaching.

This is now fixed by checking if a cached file exists before storing the
cached file and update file size/number counters with the correct
size/count delta.

Merge branch '3.3-maint'

* 3.3-maint:
  doc: Improve instructions on how to compile in different directories
  Split .incbin directive in ccache source code to enable cache hits

doc: Improve instructions on how to compile in different directories

Split .incbin directive in ccache source code to enable cache hits

Merge branch '3.3-maint'

* 3.3-maint:
  Prepare for v3.3.5
  doc: Tweak automatic cleanup description

Prepare for v3.3.5

doc: Tweak automatic cleanup description

Fix code style

Fix compilation with MinGW32