Make a copy of auto_features options when changing its name

This fixes bogus messages "skipped: feature foo disabled" when
auto_features=disabled. It was reporting the name of the latest
get_option() call instead of the name of the current feature option.

This is especially visible in GStreamer summary where it should show a
different option name for every subproject but instead shows "tools"
everywhere:
```
  Subprojects
    gst-devtools              : NO Feature 'tools' disabled
    gst-editing-services      : NO Feature 'tools' disabled
    ...
```

build: replace hand rolled code with CustomTarget[Index].links_dynamically()

Which also fixes builds on windows that might produce a .lib instead of
a .a. The error message has been changed to reflect that as well

interpreter: add type restrictions to declare_dependency link_whole

Including that we don't accept SharedLibraries or CustomTarget[Index]s
that are a shared library

build: Add a `links_dynamically` method to CustomTarget[Index]

This is useful for cases where we treat CustomTargets as linkable
targets, and need to know whether they're going to link statically or
dynamically.

dependencies: Don't allow as_link_whole to complete with SharedLibraries

Since a SharedLibrary can't be statically linked in, we shouldn't allow
the method to complete.

interpreter: add annotations to extract_variables

dependencies: Fix several annotations issues

- `BuildTarget` should be `SharedLibrary | StaticLibrary`
- Needs to take `CustomTargetIndex` as well as `CustomTarget`
- don't assign to self until values have been converted to the correct
  type

build: fix annotations for BuildTarget.link*target

which do not hold BuildTargets, they are `SharedLibrary | StaticLibrary |
CustomTarget | CustomTargetIndex` (whole doesn't accept `SharedLIbrary`)

modules/gnome: Fix missing type annotation

modules/gnome: fix some typing issues

That come to light with some of the changes later in this series,
particularly around dependencies.

Fix optimization level 's' for the TI compiler

cmake: Add test case

cmake: fix detecting directories as input files (fixes #10244)

ast: cmake: Generate line numbers while printing the AST for better debugging

doc: Generate dev release notes

Compiler-properties.md:link to compiler object page

Tweak "header has symbol" message

Change message

    Header <foo.h> has symbol "BAR"

to

    Header "foo.h" has symbol "BAR"

with the first part also now in bold.  This is more consistent with
other messages like

    Has header "foo.h"

and

    Checking whether type "foo" has member "bar"

fix traceback when run_command has a find_program as the inline arg

We were poking directly at the node, so if it was a FunctionNode then
this broke. Instead, just do a reverse lookup in the overrides table to
get the original find_program name.

mtest: ignore invalid input

TAP version 14 introduced subtests, that are supposedly backward compatible
because "TAP13 specifies that non-TAP output should be ignored".  Meson
reported TAP syntax errors based on behavior of "prove" at the time,
but it seems that now "prove" has become a lot more lenient; it even
accepts the following completely bogus input just fine:

---
ok 1
    ok 2
x
1..1
---

So do the same and make Meson's parser accept invalid TAP input silently.

Fixes: #10032

modules/icestorm: use type checking

modules/icestorm: replace individual tools attributes with dict

As we commonly do in other modules

interpreter: Add another overload to source_strings_to_files

Which doesn't have `StructuredSources`, as is actually quite common.

modules: add typing to the modtest module

move various imports into TYPE_CHECKING blocks for neatness

typing: use forward reference for types defined later in file

fix typing regression

In commit f2d21bf8a98fe4eb528a077f3faf5d68cd35c244 a type annotation was
added that does not exist. The referenced type is present but only as a
dotted name.

Fix invalid Python overrides

- mismatched method type
- mismatched parameter names

Add cc.has_function_attribute('sentinel')

Add cc.has_function_attribute('section')

Reword message in warning

"targetting" is verb-derived adjective, which sort-of-works here, but
makes the whole sentence awkward, because there's no verb. Let's just
use present simple.

Reword misleading warning

"tried to use" implies that the attempt was not successful, i.e. that meson
ignored the feature. But that is not what happens, apart from the warning the
feature works just fine. The new message is also shorter ;)

Fix --allow-shlib-undefined for LLVM versions > 9

fix incorrect FeatureNew for separator kwarg in environment object methods

In commit 6acfe48f32110671a0adf80ad3497a35105b265d, the kwarg was added
to environment() in addition to the env object methods. As part of the
associated refactor, a shared KwargInfo was used, and evolved to be new
since 0.62.0 in the two cases where it is in fact new.

However, it *also* set the base KwargInfo for the exact same newness,
which is wrong as it was present ever since the initial introduction in
0.34.0

As usual for anything that predates 0.37.0 we simply don't tag
FeatureNew. Revert this back to the same KwargInfo definition from
before the refactoring commit.

Fixes #10402

mtest: stop disrespecting the gdb config file

This was added in commit 01be50fdd90851f17de5499537f10b5b62c9fb49 with
zero explanation as a side effect of moving code around. It seems like a
really bad idea and it causes people to view debugging Meson projects on
e.g. debuginfod systems as "painful".

Update Creating-OSX-packages.md

Qt offers a tool to automatize most of what needs to be done regarding its libraries.

Add optional compress

Compress files under source directory using Deflate method.
By default, files are not compressed in the archive.
Compression is active only when this option is defined.

https://docs.python.org/3/library/zipapp.html?highlight=zipapp#cmdoption-zipapp-c

linkers/MinGW: Allow `efi_application` value for `win_subsystem`

Previously, any value other than `windows` or `console` caused an
exception. This change allows for `efi_application` to be passed as
the `win_subsystem` to MinGW based linkers.

Require CMake 3.14 for all tests that use the cmake module

Older versions are not supported by the cmake module since 0.62.

This avoids having to hard-code the linux-bionic-gcc CI job as being
unable to run these tests, which leaves other older environments like
Debian 10 still trying to run them (and failing).

Signed-off-by: Simon McVittie <smcv@collabora.com>

dependencies/boost.py: ignore unknown files

If we encounter a file under the Boost library directory that doesn't
look like a Boost library binary, we should ignore it.

We log a warning for each file we ignore, except for ones we know are
safe to ignore (e. g. PDB files from the SourceForge Windows
distribution).  This should avoid polluting the log.

Fixes #8325.

python module: default extensions to hidden symbol visibility

python compiled extensions should never need to expose any symbol other
than PyInit_* which is declared with default visibility via
PyMODINIT_FUNC on supported compilers.

Thus, a reasonably sane default is to mark any other symbols as hidden,
while still respecting any manually specified visibility.

Gate this on the version of python itself, as not all versions decorate
PyMODINIT_FUNC properly.

compilers/gnu: demote visibilty inlineshidden to hidden for unsupported compilers

This option is only valid for C++ and ObjC++, but the kwarg is useful
for mixed language targets. Asking for inlines as well, when the
compiler driver is trying to build the C components of a target, results
in gcc emitting:

```
cc1: warning: command-line option ‘-fvisibility-inlines-hidden’ is valid for C++/ObjC++ but not for C
```

Squelch this warning by filtering it out on Meson's side of things.

fix regression in reporting errors for invalid gnu_symbol_visibility

In commit fb2cdd0fe2797b30e1fd4c118407302402739a3b the internal property
was renamed, but one use case of it in raising a MesonException was not
changed to go with it.

This meant that instead of erroring out with:

```
ERROR: GNU symbol visibility arg XXXX not one of: default, internal, hidden, protected, inlineshidden
```

we instead errored out with:
```
AttributeError: 'SharedLibrary' object has no attribute 'symbol_visibility'
```

Fixes #9659

compilers/c++: Add MSVC option to make the __cplusplus define accurate

Otherwise it always returns the value for c++98, starting with MSVC 2017
15.7 or later. Earlier versions are not affected by this mis-feature.

See: https://docs.microsoft.com/en-us/cpp/build/reference/zc-cplusplus?view=msvc-160

This was originally applied as 0b97d585480e973d8b149618901f7a4ddfa1a906
but later reverted because it made the CI red. Try it again, now.

Original-patch-by: Dylan Baker <dylan@pnwbakers.com>
Co-authored-by: Dylan Baker <dylan@pnwbakers.com>

Limit parallelism to hopefully work on machines with 160 cores.

compiler.has_argument: Add `-Werror=unknown-warning-option` to clang-cl cmd line

devenv: Set WINEPATH when cross compiling for Windows

coverage: be clever and detect config files for gcovr/lcov

gcovr will read this file anyway, but if it exists we don't need to
assume that the project wishes to exclude subprojects/ -- they can
determine that themselves.

Fixes #3287
Closes #9761

lcov doesn't read the config file by default, but we can do the smart
thing here.

Fixes #4628

Add some scaffolding needed for C++ modules in GCC.

Further work pending GCC bug #105467 and/or Ninja bug #1962.

Move Visual Studio module test to its own subdir.

unittests: Skip prelinking test with gcc 8 or older

This was already skipped when running on the Ubuntu 18.04 version of gcc,
but it also fails with gcc 8.3.0 on Debian 10. Instead of hard-coding
specific versions to look for, do a version comparison.

Signed-off-by: Simon McVittie <smcv@collabora.com>

minit: refuse to allow creating broken projects

Some executable names are invalid, and while it's unlikely anyone will
specify such a thing using the --executable argument, it's not unlikely
that people experimenting will attempt to use meson init in a directory
named "test".

This then defaults to that for both the project name and the sample
target name, and the latter produces errors when you try to build it.

Fixes #10321

add prefer_static built-in option

By default, meson will try to look for shared libraries first before
static ones. In the meson.build itself, one can use the static keyword
to control if a static library will be tried first but there's no simple
way for an end user performing a build to switch back and forth at will.
Let's cover this usecase by adding an option that allows a user to
specify if they want dependency lookups to try static or shared
libraries first. The writer of the meson.build can manually specify the
static keyword where appropriate which will override the value of this
option.

dependencies: cleanup kwargs.get('static') usage

In a couple of spots, kwargs.get('static', False) was being
unneccesarily used. In these spots, we can just use self.static instead
which is already inherited from the ExternalDependency. In additional,
the python system dependency oddly has a kwargs.get('static', False)
line which overrides the self.static in that dependency for no real
reason. Delete this line too.

dependencies: handle one more case of subproject installed files

Some projects treat meson.project_source_root() as the root of the
dependency files, because the project itself merely wraps a bunch of
datafiles. Our validation to make sure this doesn't point to another
subproject, made use of pathlib.Path's generator for all component
paths, which... did not include the path itself. So go ahead and
explicitly check that too. Add a test case to verify it while we are at
it.

Fixes https://github.com/mesonbuild/meson/pull/10103#issuecomment-1114901033

devenv: Use PkgConfigDependency.get_env()

This ensures that PKG_CONFIG_PATH, PKG_CONFIG_LIBDIR and
PKG_CONFIG_SYSROOT_DIR are also set properly.

add testcase for bad things with add_project_dependencies

Test that add_project_dependencies() can only be used before build targets
have been declared.  Also test that one cannot use override_dependency
on a superproject to inject a superproject's build products into the
subproject.  This would violate the rule that build products cannot be used
with add_project_dependencies() (similar to e.g. compiler.has_function),
so check that meson detects the situation correctly.

interpreter: new function add_project_dependencies()

This function can be used to add fundamental dependencies such as glib
to all build products in one fell swoop.  This can be useful whenever,
due to a project's coding conventions, it is not really possible to
compile any source file without including the dependency.

Signed-off-by: Paolo Bonzini <pbonzini@redhat.com>

dependencies: extract code to get all leaf dependencies

Extract to a separate function the code that resolves dependencies
for compiler methods.  We will reuse it for add_project_dependencies().

Signed-off-by: Paolo Bonzini <pbonzini@redhat.com>

interpreter: simplify checks in declare_dependency

Both dependencies.ExternalLibrary and dependencies.InternalDependency are
subclasses of dependencies.Dependency, no need to list them separately.

Signed-off-by: Paolo Bonzini <pbonzini@redhat.com>

complete documentation of declare_dependency

Fix wrong name in doc

The doc about declare_dependency states
d_module_features instead of d_module_versions

docs: correct incorrect types for pch files

In the original RefMan 2.0 implementation, the types for this were
filled in as `str | file`, but the code only ever accepted the former.
Fix the documentation so that it aligns with reality.

Fixes #10338

use shared implementation to convert files() strings to File objects

This handles various edge cases:
- checks for sandbox violations just like all other functions
- warn for direntry issues
- check for generated files referred to via strings instead of the
  returned object

(All valid use cases for wanting to sneak around the checks, are made to
work via commit bba588d8b03a9125bf5c4faaad31b70d39242b68.)

Windows: Improve Python 3.8+ module check on Windows

On Python 3.8.x and later, if the imported module requires non-system DLLs that
are not installed nor bundled with the module package, os.add_dll_directory()
must be called on every path that contains the required DLLs, so that the module
can be imported successfully by Python.

Make things easier for people by calling os.add_dll_directory() on the
valid directories in %PATH%, so that such module checks can be carried out
successfully with much less manual intervention.

mcompile: Print suggestions when target is ambigous

Fixes: #10221

cmake: Fix CMake LLVM dependency error (fixes #10322)

Add support for multiline f-strings

+ Extend the parser to recognize the multiline f-strings, which the
documentation already implies will work.

The syntax is like:
```
x = 'hello'
y = 'world'

msg = f'''This is a multiline string.

Sending a message: '@x@ @y@'
'''
```

which produces:
```
This is a multiline string.

Sending a message: 'hello world'

```

+ Added some f-string tests cases to "62 string arithmetic" to exercise
the new behavior.

Convert if...error checks to assert() in string arithmetic tests

another day, another mypy update becomes stricter about typing

Move GlobalState to a runtime T.NamedTuple, use it for constructing the
tuple we are passing around rather than expecting mypy to detect that
the one we already have matches.

Some documentation fix (#10335)

* update sample image

* increase size so all text will be shown

Merge pull request #10039 from eli-schwartz/wayland-protocols-subproject-files

dependencies: allow get_variable to expose files from subprojects

Ignore detached head warning while cloning subprojects with tags

gnome: Make sure g-ir-scanner can use pkg-config properly

We need to setup the environment we pass to g-ir-scanner because it will
try to use pkg-config to find dependencies, and that must respect user
settings from machine file. Also make it use uninstalled pc files Meson
generated in the case dependencies, such as glib, have been built as
subproject.

pkgconfig: Use EnvironmentVariables to build PKG_CONFIG_* env

The new get_env() method that returns an EnvironmentVariables object
will be needed in next commit that will pass it to CustomTarget.

This has the side effect to use the proper os specific path separator
instead of hardcoding `:`. It is the obvious right thing to do here, but
has caused issues in the past. Hopefully issues have been fixed in the
meantime. If not, better deal with fallouts than keep doing the wrong
thing forever.

use D compiler to check pointer size in test d/14

add release snippet

implement and test a few compiler checks for D

 - run
 - sizeof
 - alignment
 - has_header

linkers: Add support for mold linker

[why]
Support for the relatively new mold linker is missing. If someone wants
to use mold as linker `LDFLAGS="-B/path/to/mold"` has to be added instead
of the usual `CC_LD=mold meson ...` or `CXX_LD=mold meson ...`.

[how]
Allow `mold' as linker for clang and newer GCC versions (that versions
that have support).

The error message can be a bit off, because it is generic for all GNU
like compilers, but I guess that is ok. (i.e. 'mold' is not listed as
possible linker, even if it would be possible for the given compiler.)

[note]
GCC Version 12.0.1 is not sufficient to say `mold` is supported. The
expected release with support will be 12.1.0.
On the other hand people that use the un-released 12.0.1 will probably
have built it from trunk. Allowing 12.0.1 is helping bleeding edge
developers to use mold in Meson already now.

Fixes: #9072

Signed-off-by: Fini Jastrow <ulf.fini.jastrow@desy.de>

qt module: fix missing sanity check for install_dir + install

Regression in commit 11f96380351a88059ec55f1070fdebc1b1033117. When
`install: true` the install_dir must be set. The CustomTarget
initializer no longer checks this for us, so we must include the check
ourselves.

qt module: fix broken install_dir kwarg

Regression in commit 11f96380351a88059ec55f1070fdebc1b1033117. We expect
exactly one string as an install_dir, but CustomTarget started expecting
it to be a list. So we need to pass it as such when forwarding
compile_translations() arguments to the CustomTarget initializer.

devenv: Catch FileNotFoundError

Fixes: #10310

Add small note that get_variable can publicize its data files

Nothing elaborate, just laying down the ground rules for expected usage
and pointing out that it now works. The idea is not to give people
ideas, but to let projects which already have this use case, use it with
confidence.

Validate setting of install_tag for CustomTarget

gnome: Use 'doc' install_tag for gnome.yelp

improve help for -Ddebug

"Debug" is not a very helpful help message.

Signed-off-by: Paolo Bonzini <pbonzini@redhat.com>

Visual Studio: Only use /utf-8 on VS2015 or later or clang-cl

The compiler flag only exists on Visual Studio 2015 or later, or clang-cl,
and using this always can interfere with compiler feature detection when
this flag is not supported.

So, remove '/utf-8' from always_args if we are on Visual Studio 2013 or
earlier.

docs: Remove deprecated meson.source_root() from localisation page example

Meson already supplies the same value

Fix typo that breaks g++ cross detection on Debian.

Do not use 'echo' as it is not available on plain cmd.exe

Use system install scheme rather than the incorrect Debian one.

Allow deprecating an option for a new one

gtkdochelper.py: Use os.pathsep for --path argument

This way, we can ensure that gtk-doc parses the --path argument
correctly when passed in from the cmd.exe console, since ':' is normally
used to denote that a drive is being used on local paths.

vcs_tag: handle non-str / non-file arguments

This makes vcs_tag behave like other commands so it accepts not only
string and file arguments, but also exe, custom_tgt, and
external_program.

vcs_tag: document the already supported file arg

Add NetBSD support in symbolextractor.

Choose FreeBSD backend (OpenBSD backend would also work).

Fix purelib and platlib validation in Python3 module.

docs: Add documentation on pkgconfig.relocatable

- Documentation for the pkgconfig.relocatable module option in
Builtin-options. Gives an explanation on what it does, usefulness and
what error that can occur when using it.

- Add pkgconfig.relocatable release snippet. Similar to the
documentation in Builtin-options. Just a bit more brief.

- Add Pkgconfig to DataTests.test_builtin_options_documented in the
docs unit tests.

unittests: Add test_pkgconfig_relocatable to allplatformstests

Test that the pkgconfig prefix is actually relocatable when
pkgconfig.relocatable=true and is not when
pkgconfig.relocatable=false.

test cases/failing: Add 123 pkgconfig not relocatable outside prefix

Which will check that meson errors out when the install_dir for the
pkgconfig file is outside the install prefix.

pkgconfig: Add relocatable module option

If set to true it will generate the pkgconfig files as relocatable i.e
the prefix variable will be relative to the install_dir. By default
this is false.

Will generate a MesonException if the pkgconfig file is installed
outside of the package and pkgconfig.relocatable=true.