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.

build: Try harder to determine FMT_VERSION (#1478)

fmt-11.0 moved the FMT_VERSION from core.h to base.h, so try the
new header first and then fall back to the old one.

Closes: #1477

chore: Update authors

(cherry picked from commit 4c6181f7f93f8dad8106973aaf55475cddfd2730)

chore: Update NEWS

(cherry picked from commit 14a0714cbfe2b1e5eaebf50c8fef17529a60a01b)

chore: Fix reference to format.cc in LICENSE.adoc

refactor: Convert some std::string paths to fs::path

chore: Rename source files to lowercase for consistency

refactor: Clean up some fs::path usage

refactor: Convert Config::m_temporary_dir to fs::path

refactor: Convert Config::m_stats_log to fs::path

refactor: Convert Config::m_log_file to fs::path

refactor: Convert Config::m_cache_dir to fs::path

refactor: Convert Context::i_tmpfile to fs::path

refactor: Use fs::path for Context::register_pending_tmp_file

refactor: Improve handling of ignore_header_paths matching

refactor: Convert ArgsInfo::sanitize_blacklists to fs::path

refactor: Convert ArgsInfo::profile_path to fs::path

refactor: Convert ArgsInfo::included_pch_file to fs::path

chore: Add ubuntu-24.04 Dockerfile

refactor: Convert ArgsInfo::orig_included_pch_file to fs::path

refactor: Convert ArgsInfo::output_al to fs::path

refactor: Convert ArgsInfo::output_ipa to fs::path

refactor: Convert ArgsInfo::output_dwo to fs::path

refactor: Convert ArgsInfo::output_dia to fs::path

refactor: Convert ArgsInfo::output_ci to fs::path

refactor: Convert ArgsInfo::output_su to fs::path

refactor: Convert ArgsInfo::output_dep to fs::path

refactor: Convert ArgsInfo::output_obj to fs::path

refactor: Convert APIs to use std::filesystem::path for paths

enhance: Add Args::push_back(const std::filesystem::path&)

refactor: Convert ArgsInfo::orig_output_obj to fs::path

refactor: Convert ArgsInfo::input_file to fs::path

refactor: Improve language_for_file signature

refactor: Convert ArgsInfo::orig_input_file to fs::path

refactor: Use util::with_extension

enhance: Add util::with_extension

enhance: Add util::add_extension

refactor: Add and use util::pstr type alias

Also removed less common util::PathString::operator const char* to make
some call sites unambiguous.

refactor: Convert APIs to use std::filesystem::path for paths

chore: Add note about --compile being an NVCC option

feat: Support NVCC --compile option (#1475)

The nvcc (CUDA) compiler has a extra option compliant with -c: --compile.
https://docs.nvidia.com/cuda/cuda-compiler-driver-nvcc/#supported-phases

So ccache should see the --compile option as the -c option (especially because the CUDA MVS plugin use it!)

perf: Use posix_spawn to execute the compiler (#1471)

build: Simplify cxxurl build script

build: Remove no longer needed workaround when building downloaded Zstd

build: Bundle Fmt again

Fmt is currently the only required C++ dependency that isn't bundled.
Since the Fmt API is still evolving, it's convenient for Ccache users
that lack a proper Fmt version locally to be able to build without
having to download Fmt. Thus, bundle Fmt again for now. (When we can
bump compiler requirements to versions that implement std::format
properly in the future we will switch to std::format instead.)

Closes #1470.

test: Improve CCACHE_PREFIX test to catch regression fixed in PR #1474

docs: Clarify that --set-config writes to the configuration file

See also discussion #1468.