docs: Remove stray heading in NEWS

chore: Update authors

Update NEWS

fix: Don’t update manifest on preprocessed hit with disabled direct mode

After c7c0837a23fe9dc79613bf3dd4ddd8d91c58d541, update_manifest_file can
be called erroneously if the direct mode is disabled when there has been
a preprocessed hit.

Fix this by asserting that update_manifest_file is only called when
direct mode is enabled, fixing the call site and adding the test case
that should already have existed.

Fixes #935.

ci: Pin macOS to 10.15

macOS-latest now means macOS-11.

refactor: Pass const Context to process_arg

This narrows down what process_arg is allowed to do.

refactor: Move included_pch_file from Context to ArgsInfo

enhance: Add util::replace_all function

test: Cope with CC being a wrapper script that uses ccache

Fixes #914.

test: Silence stray output

test: Use shell builtin pwd for basedir test (#933)

chore: Update news

feat: Show separate statistics counters for misses

fix(http-storage): Enable keep-alive again after fixing SIGPIPE issue

See #931.

fix(redis-storage): Ignore SIGPIPE

libhiredis doesn’t pass MSG_NOSIGNAL to send to ccache can die from
SIGPIPE. Disable SIGPIPE so that the socket code receives EPIPE
correctly.

This should also fix a similar problem with the HTTP storage backend.

Fixes #931.

bump: Upgrade to cpp-httplib 0.9.4

refactor: Improve compatibility definition of DLLIMPORT

fix: Always store configuration origin value (#928)

fix(http-storage): Disable broken connection keep-alive (#927)

Fix build errors with clang on Windows (#924)

Merge pull request #918 from gjasny/ipo

feat(cmake): Disable IPO for mingw

On mingw IPO seems to be broken (out-of-diskspace errors
and lacking linker module support), therefore IPO support is being
deactivated.

feat(cmake): Use standard linker for LTO scenarios

feat(cmake): Use the matching lld for clang

Otherwise one could end up on Ubuntu with clang-11 calling lld-10
which breaks IPO.

fix(test): Pass all three required arguments to expect_file_count (#925)

fix(test): Fix basedir suite failure with symlinked PWD

Fixes #916.

test: Improve output of differing text files on failure

chore: Remove asciidoctor package from CentOS 8 Dockerfile

Asciidoctor is apparently not packaged for CentOS 8.

chore: Sort LICENSE.adoc entries properly

feat: Only show secondary storage stats if non-empty or with -vv

fix(test): Fix .incbin test with newer binutils

The assembler in binutils 2.37 doesn’t want to include /dev/null with
a .incbin directive:

    /tmp/ccbGWiew.s: Assembler messages:
    /tmp/ccbGWiew.s:4: Error: unable to include `/dev/null'
    incbin.s: Assembler messages:
    incbin.s:1: Error: unable to include `/dev/null'

docs: Fix grammar

chore: Update release date

build: Improve detection av Ccache version from source repo

When running CMake outside the source repository a plain git command
naturally won’t find the repository. Fix this by pointing git towards
the repository.

chore: Fix Cppcheck warnings

docs: Improve contributor notes in NEWS

chore: Update authors

docs: Update NEWS for ccache 4.4

chore: Add Ryan Burns to .mailmap

chore: Use official debian:11 Docker tag

docs: Use consistent casing of “Ccache” in NEWS

feat(tracing): Add more trace points

fix(tracing): Always call MTR_END for each MTR_BEGIN

refactor(tracing): Use MTR_SCOPE

bump: Upgrade minitrace to latest master

feat: Improve statistics summary

The number of statistics counters has become very large, making the
output “ccache -s” hard to overview.

Improvements:

- The -s/--show-stats option now prints a more condensed overview where
  the counters representing “uncacheable calls” are summed as
  “uncacheable” and “errors” counters. Note: Scripts should use
  --print-stats instead of trying to parse the output of --show-stats.
- Added hit rate for direct/preprocessed hits/misses as well.
- Added a new -v/--verbose option, which makes --show-stats and
  --show-log-stats show more details.

style: Use uppercase literal suffixes

feat: Print statistics IDs instead of descriptions to debug log

This is in preparation for future statistics counters that won’t have
human-readable descriptions. (The statistics IDs are human-readable
enough.)

refactor: Return from process_main_options instead of exiting

fix: Don’t print “unrecognized option” twice

Fixes an issue introduced in 513c83faaafc3a9848cb4492961104e4f4768247.

enhance: Let TextTable::add_row take a vector

enhance: Add TextTable support for cells spanning several columns

refactor: Simplify TextTable usage

enhance: Add util::TextTable::TextTable(const char*)

enhance: Add TextTable support for right-aligned integers

build: Link ws2_32 to third_party instead of ccache_framework (#913)

fix(test): Fix typos in trim_dir suite

feat: Support subsecond mtime/atime for --cleanup and --trim-dir

enhance: Detect support for st_atim field in struct stat

feat: Rename --directory option to --dir

Other options use abbreviated forms (e.g. “config” and “max”), so this
makes things more consistent.

feat: Add --trim-dir option for usage with secondary storage directories

feat: Make --config-path and --directory affect whole command line

Command line options are processed strictly in order, which means that

    ccache -d dir -s

is not the same as

    ccache -s -d dir

which is not very intuitive. There are also planned features where is
doesn’t make sense to have to put “non-command options” before the
“command options”.

Improve this by processing command line options in two passes: first
non-command options and then command options (still in order).

refactor: Move static getopt data to global level

doc: Describe interaction between primary and secondary storage

feat: Add share-hits attribute for secondary storage

With share-hits=false, a secondary storage backend will not share hits
to primary storage.

feat: Add reshare config option

Setting reshare (CCACHE_RESHARE) to true make ccache send results to
secondary storage even for primary storage cache hits. The default is
false.

feat: Add statistics for forced recaches

feat: Add statistics for primary/secondary hits/miss

feat: Add statistics for direct/preprocessed cache miss

test: Use machine-parsable statistics IDs in tests

refactor(test): Improve duplicate tests in base suite

feat: Sort output of --print-stats

enhance: Prepare for a ccache invocation having multiple results

That is, “result” as in “increased statistics counter”.

fix: Remove obsolete statistics counter and comment when disabled

refactor: Improve handling of statistics updates and expected events

Ccache uses exceptions for both truly exceptional events (such as I/O
error) and non-exceptional events (such as unsupported compiler
arguments). Regardless of the nature of the event, at most one
statistics counter can be incremented.

Improve this by:

- Using nonstd::expected instead of exceptions internally in the main
  code flow. This makes the code easier to reason about.
- Adding support for communicating several statistics counter updates
  both for success and failure code paths. This is in preparation for
  future improvements of statistics related to secondary storage.

chore: Fix example in dockerfiles/README

docs: Use non-legacy markup for block IDs

feat(file-storage): Add support for flat layout

feat(http-storage): Add support for subdirs layout, making it default

enhance(test): Let http-server create subdirectories as needed

fix(test): Remove debug printout and move Bazel layout test

fix: Don’t read let Context read user configuration in unit tests

accd21e4 inadvertently made unit tests populate Context::config from the
environment and the user configuration. Fix this by moving code for
reading config, setting of logging, etc. into a separate method only to
be called by non-test code.

As noted by Michael Kruse in #815.

feat(storage): Add support for cache sharding on secondary storage (#912)

This adds support for a shards attribute with a comma-separated list of
names for sharding (partitioning) the cache entries using Rendezvous
hashing, typically to spread the cache over a server cluster. When set,
the storage URL must contain an asterisk (*), which will be replaced by
one of the shard names to form a real URL. A shard name can optionally
have an appended weight within parentheses to indicate how much of the
key space should be associated with that shard. A shard with weight w
will contain w/S of the cache, where S is the sum of all shard weights.
A weight could for instance be set to represent the available memory for
a memory cache on a specific server. The default weight is 1.

For example,

    redis://cache-*.example.com|shards=a(3),b(1),c(1.5)

will put 55% (3/5.5) of the cache on redis://cache-a.example.com, 18%
(1/5.5) on redis://cache-b.example.com and 27% (1.5/5.5) on
redis://cache-c.example.com.

chore: Sort LICENSE.adoc entries

chore: Improve AsciiDoc markup of LICENSE.adoc

ci: Use latest codespell

chore: Fix typos

refactor: Split httplib into .h and .cpp parts

This improves recompilation speed of
src/storage/secondary/HttpStorage.cpp.

fix(file-storage): Create CACHEDIR.TAG after subdir

Otherwise creation will fail the first time with an ugly log message.

refactor: Use util::parse_double

enhance(util): Add parse_double function

chore: Fix typo in comment

enhance(util): Add replace_first function

docs: Use italics consistently for references to sections

feat(storage): Log time taken for secondary storage operations

feat(http-storage): Log translation to pseudo-SHA256 key

docs: Add scheme to link to fonts.googleapis.com (#910)

This makes it possible to view generated HTML files locally using the file scheme.

docs: Reflow some paragraphs after #911

docs: Fix links to section anchors (#911)

asciidoc uses #_section_header, but github uses #section-header.
Replace all the explicit refs with the section titles, and let
the engine handle it.

build: Only probe for faster linker in dev build mode and on x86_64

Using Gold or LLD on less common platforms such as MIPS may not be a
good idea (see e.g.
<https://www.sourceware.org/bugzilla/show_bug.cgi?id=22838>), so be
conservative and only probe for a faster linker on platforms that likely
don’t have toolchain bugs. Also, using a faster linker is in practice
only relevant for dev builds.

Fixes #907.