chore: Prepare for release

chore: Update authors

chore: Update NEWS

test: Remove centos-7 Dockerfile

test: Add alma-8 Dockerfile

feat: Add knowledge about options related to react-native builds (#1567)

- Add compopt entries for -ivfsoverlay, -fmodules-cache-path, -fmodule-map-file and -fbuild-session-file
- Add hashing of build session file mtime unless sloppiness flag is set
- Add unit tests for the flags above as well as an e2e test for -fbuild-session-file

test: Add debian-12 to test-all-systems

test: Refresh dockerfiles and add Debian 12 (#1538)

- Make gcc package name configurable, this is to fix
  "E: Package 'gcc-multilib' has no installation candidate"
  on non-x86.

- Allow BASE_IMAGE to be overridden.

- Add Debian 12.

refactor: Remove redundant args_info parameter from hash_common_info

docs: Add space after CMake -D option

bump: Upgrade to xxhash 1.5.7

bump: Upgrade to xxhash 0.8.3

bump: Upgrade to fmt 11.1.4

bump: Upgrade to blake3 1.6.1

bump: Upgrade to cpp-httplib 0.19.0

refactor: Simplify nested ifs

feat: Add knowledge about --offload-compress (#1571)

Clang has a feature where it can compress compiler products such as object files, and this includes when it is just called to preprocess the input file.

Ccache expects to be able to process the output of the preprocessor, and is not expecting a compressed binary file.

The fix is to remove this "--offload-compress" option using the existing facilities when preprocessing.

fix: Rename raw files correctly for >2 cache levels

LocalStorage::move_to_wanted_cache_level renames raw files incorrectly without
recalculating full hash filename with new prefix.

ci: Test more Clang versions available in ubuntu-24

ci: Drop ubuntu-20 in favor of ubuntu-22

refactor: Simplify code for executing Windows processes

chore: Simplify util::add_exe_suffix

fix: Fix --trim-method mtime

fix: Handle command line config options ending with /ccache properly

Fixes #1560.

feat: Add support for -f(debug|file)-compilation-dir (#1535)

feat: Support .bat and .cmd scripts as the compiler on Windows (#1546)

docs: Fix typo

docs: Clarify how LRU cleanup works

Closes #1543.

fix: Correctly call sha256sum on macOS (#1549)

sha256sum requires explicitly using `-` as the input file on macOS.

docs: Fix description of icx-cl (#1548)

chore: Improve variable name in misc/clang-format

perf: Avoid stat call for ~/.ccache if CCACHE_DIR is set

Closes #1541.

chore: Add NOCACHE option to misc/build-in-docker

feat: Add support for Intel's LLVM-based compilers (#1533)

feat: Add support for clang-cl option /showIncludes:user

Closes #1534.

chore: Tweak comment and add const

feat: Add HTTP_STORAGE_BACKEND build option (#1537)

fix: Rewrite more paths with absolute_paths_in_stderr (#1539)

refactor: Tweak includes

fix: Synchonize writing to the log file

Fixes #350.

enhance: Add util::FileLock

ci: Use newest macos image

fix: Pass -fprofile-abs-path through to GCC (#1531)

When caching support for -fprofile-abs-path was added, the argument was
omitted from the gcc commandline.

build: Ignore Clang 19 -Wcast-function-type-mismatch warning

fix: Add support for Clang -frandomize-layout-seed-file option

Fixes #1528.

fix: Use util::getenv_path for environment variables that contain a path

This should improve support for non-ASCII paths in Windows.

Hopefully fixes #1409.

fix: Use util::getenv_path_list to get PATH in find_executable_in_path

This should improve support for non-ASCII paths in Windows.

chore: Store config paths in lexically normal form

refactor: fs::path-ify helper functions in config.cpp

refactor: Use util::lexically_normal

enhance: Add util::lexically_normal

enhance: Make util::getenv_path differentiate between unset and empty

fix: Fix util::make_relative_path for trailing slash on Windows

Given an existing directory called "example", std::filesystem apparently
behaves like this on Windows:

    std::filesystem::exists("example")                  -> true
    std::filesystem::exists("example/")                 -> true
    std::filesystem::exists("example\\")                -> true
    std::filesystem::equivalent("example", "example")   -> true
    std::filesystem::equivalent("example", "example/")  -> false
    std::filesystem::equivalent("example", "example\\") -> false

That's... well, unexpected. This makes util::make_relative_path buggy.
Fix this by pruning the trailing slash after normalizing the path.

Fixes #1518.

fix: Ignore trailing slash in prefix in util::path_starts_with

Fixes #1265.

chore: Mention correct Clang-Format version lower bar

chore: Fix typo

docs: Fix description of default cache_dir on non-macOS POSIX systems

As mentioned in discussion #1527.

refactor: Rename "at file" to "response file" internally

test: Add and use postdate function for making future filestamps

refactor: Avoid const data members

C++ Core Guidelines C.12

refactor: Properly move fds into execute()

C++ Core Guidelines F.18

refactor: Restructure code to help Clang-Tidy understand it

chore: Mark some return values as ignored

refactor: Use C++17-style variable templates

chore: Ignore useless cppcoreguidelines-avoid-do-while warning

enhance: Add util::getenv_path and util::getenv_path_list

feat: Add response_file_format config option for rsp file format (#1522)

test: Make tests pass in 2038 (#1525)

We use relative future timestamps to keep systems with 32-bit time_t working
until 2037.

Use the 3rd of January of the following year to ensure that it is in the future,
even when starting a second before new year

ci: Enable ubuntu-24.04 builds again

ci: Remove macOS-12 builds

Says GitHub: "The macOS 12 runner image will be removed by December 3rd,
2024."

fix: Fix binary patching of sysconfdir for Linux prebuilt binary

After fs::path-ification it no longer works to binary patch sysconfdir
at install time since the compiler apparently makes a note of the actual
length of SYSCONFDIR in

    const char k_sysconfdir[4096 + 1] = SYSCONFDIR;

and uses the length in the

    fs::path sysconfdir(k_sysconfdir);

call. When patching the SYSCONFDIR string the length of the original
string is used so that only the first strlen(SYSCONFDIR) part of the new
sysconfdir will be used.

Fix this by adding a pointer indirection which makes binary patching
work again.

refactor: Improve some types

ci: Upgrade codespell and typos versions

feat: Add support for -fprofile-prefix-path gcc option (#1515)

test: Add a unittest for the hard link based compiler detection (#1517)

fix: Detect compiler type for hard linked generic compiler name

This makes color diagnostics work on systems like Arch Linux where e.g.
/usr/bin/c++ is a hard link to /usr/bin/g++.

Fixes #1514.

chore: Tweak comments

fix(http-storage): Make sure 'keep-alive' can be overridden as expected (#1510)

The changes introduced in dfcdb68 made it impossible to disable HTTP keep-alive
by setting the 'keep-alive' attribute in the backend string accordingly: The
default of 'true' is applied after parsing of the attributes, overriding the
value configured by the user (if any). Rectify this.

feat: Relativize absolute paths within base_dir in MSVC diagnostics messages (#1509)

MSVC /FC option causes the paths in diagnostics messages become absolute.
Convert them to relative to avoid leakage of workspace paths.
User can specify absolute_paths_in_stderr=true to convert them back to absolute.

docs: Mention that absolute_paths_in_stderr applies to stdout as well

Closes #1505.

build: Instruct MSVC to accept UTF-8 characters (#1508)

refactor: Remove duplicated call to posix_spawn_file_actions_init (#1506)

feat: Make absolute_paths_in_stderr also handle MSVC/Windows (#1504)

feat: Option absolute_paths_in_stderr also rewrites relative paths in MSVC diagnostics messages

enhance: Add utility to get path length in compiler diagnostics messages

fix: Fix util::replace_all for string_view to non-C string (#1502)

feat: Add support for MSVC /TC and /TP options (#1499)

chore: Improve type of boolean

docs: Remove repeated word

chore: Correct my name (#1498)

feat: Add ability to send arbitrary HTTP headers to HTTP storage (#1496)

chore: Update authors

(cherry picked from commit cc653c59b715833f452cb9d696b35975fbc5952d)

chore: Update NEWS

(cherry picked from commit 17744ca1c39facaed1f0ed0464aae58f22f69b94)

test: Only run -fprofile-update=atomic test when supported by compiler

This fixes an issue with the arm-linux-gnueabi GCC which doesn't support
-fprofile-update=atomic.

chore: Remove no longer relevant Gitter links

test: Use bash for running script command (#1482)

The script program will try to run the --command parameter with the
login shell, rather than the currently running test shell (bash).

chore: Fix copyright row order

refactor: Introduce and use DEFER macro, replacing util::Finalizer

refactor: Introduce and use CHECK_LIB_CALL macro

build: Fix detection of Fmt version for Fmt<11

Fixes regression in 71f772e9d3d4f8045cfa7bccd03bd21c1e8fbef1.