aboutsummaryrefslogtreecommitdiff
path: root/docs/yaml
AgeCommit message (Collapse)AuthorFilesLines
2022-05-03interpreter: new function add_project_dependencies()Paolo Bonzini1-0/+16
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>
2022-05-02complete documentation of declare_dependencyRemi Thebault1-0/+14
2022-05-02docs: correct incorrect types for pch filesEli Schwartz1-1/+1
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
2022-04-20vcs_tag: handle non-str / non-file argumentsKirill Isakov1-1/+3
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.
2022-04-20vcs_tag: document the already supported file argKirill Isakov1-1/+3
2022-04-07docs: YAML: Add `arg_flattening: false` where requiredDaniel Mensinger12-0/+27
2022-04-07docs: Fix [[true]] --> `true`Daniel Mensinger1-2/+2
2022-04-01docs: fix inaccurate description of command targetsEli Schwartz2-2/+2
It isn't possible to have one target depend on a run_target, because those produce no outputs and are always out of date. But the docs didn't specify which types of target are valid here. Correct the docs to align with the implementation. Fixes #10198
2022-03-31docs: note that find_program accepts file objectsEli Schwartz1-4/+6
This was implemented in commit 280346da3ac5904ec097afe89ef45ad34bd4a173 but never properly documented (it predated the version-controlled docs).
2022-03-31docs: correct documentation of shared_library soversionsEli Schwartz1-2/+2
We have always accepted an int here as an alternative to a string, but the initial documentation thought it was only a string.
2022-03-30Add new debug() functionMarvin Scholz1-0/+14
Adds a new debug() function that can be used in the meson.build to log messages to the meson-log.txt that will not be printed to stdout when configuring the project.
2022-03-24Make compilers list per subprojectXavier Claessens1-1/+1
Previously subprojects inherited languages already added by main project, or any previous subproject. This change to have a list of compilers per interpreters, which means that if a subproject does not add 'c' language it won't be able to compile .c files any more, even if main project added the 'c' language. This delays processing list of compilers until the interpreter adds the BuildTarget into its list of targets. That way the interpreter can add missing languages instead of duplicating that logic into BuildTarget for the cython case.
2022-03-22Fix missing ' in custom_target docsrusty-snake1-2/+2
2022-03-22Add ability to add resources to jarsTristan Partin1-0/+4
Previously Meson lacked the ability to add resources to jar files. Fixes #9945
2022-03-20docs: fix incorrect default for test is_parallelEli Schwartz1-1/+1
In the original RefMan 2.0 implementation, this incorrectly started claiming that the default is false. Fixes #10155
2022-03-13Merge pull request #9339 from dcbaker/submit/structured_sourcesJussi Pakkanen3-1/+25
Structured Sources
2022-03-07docs: document the rust_crate_type build_target keywordDylan Baker1-0/+20
2022-03-07docs: Add docs for structured_sourcesDylan Baker3-1/+25
2022-03-06find_program: add a version() method to match the one for dependenciesEli Schwartz1-0/+8
It is often useful to check the found version of a program without checking whether you can successfully find `find_program('foo', required: false, version: '>=XXX')`
2022-03-02document and raise an error for disallowed combination of install_headers argsEli Schwartz1-2/+5
It makes no sense to specify both: - install_dir, which overrides the -Dincludedir= builtin option - subdir, which suffixes the -Dincludedir= builtin option We've always silently ignored the subdir in this case, which is really surprising if someone actually passed it and expected it to do something. We also confusingly didn't say anything in the documentation about it. Document that the options are incompatible, and explicitly check to see if they are both passed -- if so, raise an error message pointing out that only install_dir should be used. Fixes #10046
2022-02-28Allow setting method/separator in environment() and meson.add_devenv()Xavier Claessens2-3/+44
2022-02-28doc: Fix spelling developper->developerXavier Claessens1-1/+1
Mistaken from French développeur.
2022-02-20add all supported arguments in docs for summary()Stone Tickle1-5/+28
2022-02-14shared module: Allow linking on AndroidNirbheek Chauhan1-5/+11
Android requires shared modules that use symbols from other shared modules to be linked before they can be dlopen()ed in the correct order. Not doing so leads to a missing symbol error: https://github.com/android/ndk/issues/201 We need to always allow linking for this. Also add a soname, although it's not confirmed that it's needed, and it doesn't really hurt if it isn't needed.
2022-02-09meson: Allow directory options outside of prefixJan Tojnar2-14/+12
This bring us in line with Autotools and CMake and it is useful for platforms like Nix, which install projects into multiple independent prefixes. As a consequence, `get_option` might return absolute paths for some directory options, if a directory outside of prefix is passed. This is technically a backwards incompatible change but its effect should be minimal, thanks to widespread use of `join_paths`/`/` operator and pkg-config generator module. It should only cause an issue when a path were constructed by concatenating the value of directory path option. Also remove a comment about commonpath since we do not use that since <https://github.com/mesonbuild/meson/commit/00f5dadd5b7d71c30bd7393d165a87f554eb92e5>. Fixes: https://github.com/mesonbuild/meson/issues/2561
2022-02-03docs: strongly recommend the use of SPDX instead of array of licenseDylan Baker1-9/+17
The array of licenses is not clear, where and SPDX expression using AND and OR is very clear, take for example this: `['Apache', 'GPLv2']`. What does that mean? Any Apache license you like and GPLv2? Using a valid SPDX license identifier however makes it extremely clear what is meant: `'Apache-2.0 OR GPL-2.0-only'`. It is very clear that you mean, "this is Apache 2.0, however, you can use as GPL-2.0 for the purpose of linking it into your GPL-2.0 project".
2022-02-01interpreter: support for forcibly verbose logging of some testsPaolo Bonzini2-0/+15
Add a new keyword argument to test() and benchmark(), completing the implementation of the feature. Signed-off-by: Paolo Bonzini <pbonzini@redhat.com>
2022-01-29docs: find_program can return the current Python3 interpreterAndrea Pappacoda1-1/+3
This was the case since 067ff7eeae26eda8edc9f7f7432f551c3e373eaa, i.e. version 0.50.0. Fixes #3856
2022-01-18interpreterobjects: deprecated passing a number to configuration_data.set10Dylan Baker2-3/+12
This is currently allowed, and is used in at least a few projects. It was not intended to work or documented, but it does and since it is in use a full deprecation period must be used. A warning has also been added for values < 0, which have surprising behavior.
2022-01-14docs/dep.yaml: davault -> defaultDylan Baker1-1/+1
2021-12-30fix incorrect docs for add_*_scriptEli Schwartz1-8/+23
They claimed that all of these functions accepted any posargs or varargs that install scripts supported. This was inconsistent with both the types that meson currently allowed, and the types that we documented in refman 1.0 *should* be allowed. Take the opportuninty to be clear as refman 1.0 never was, about the difference between types supported in the first posarg, and the ypes supported in succeeding varargs.
2021-12-08docs: Add the `configuration` keyword argument to `configure_File`Dylan Baker1-0/+7
We were missing the most important keyword argument of them all!
2021-12-01add install_symlink functionPablo Correa Gómez1-0/+34
Allows installing symlinks directly from meson, which can become useful in multiple scenarios. Current main use is to help moving forward #9557
2021-11-29docs: add missing argument documentation for run_command captureDylan Baker1-0/+9
2021-11-24shared_module: Add soname when used as a link targetNirbheek Chauhan2-7/+9
Emit a detailed deprecation warning that explains what to do instead. Also add a unittest. ``` DEPRECATION: target prog links against shared module mymod, which is incorrect. This will be an error in the future, so please use shared_library() for mymod instead. If shared_module() was used for mymod because it has references to undefined symbols, use shared_libary() with `override_options: ['b_lundef=false']` instead. ``` Fixes https://github.com/mesonbuild/meson/issues/9492
2021-11-21Clarify some wording for compiler.first_supported_argumentLuke Drummond1-2/+3
After a discussion implementing this for muon [1] and clarification on IRC on Meson's behaviour. [1] https://lists.sr.ht/~lattis/muon/patches/26722
2021-11-21Support Visual Studio 2022 backendCrend King1-0/+1
2021-11-09docs: fix refman 2.0 regression in correctly describing ↵Eli Schwartz1-2/+37
find_library(has_headers) All kwargs inherited from has_header need to be prefixed `header_` so we cannot just do straight inheritance. And the part of the description that highlighted the way kwargs are derived and evolved, went entirely missing. Fixes #9551
2021-11-09docs: fix some spelling typosEli Schwartz1-1/+1
2021-11-05Fix markdown formating in find_program.yamlrusty-snake1-2/+2
fixes #9528
2021-10-30Added warning if run_command is called without the check kwargVolker Weißmann1-1/+2
2021-10-26message: Allow boolXavier Claessens1-3/+3
It has always been working even if not documented and there is no reason to not accept it. However, change "True/False" to "true/false" to be consistent with meson language. Fixes: #9436
2021-10-21Fix typosHofer-Julian3-3/+3
"seperator" -> "separator"
2021-10-11docs: fix a typoed arg name and another missing argEli Schwartz1-1/+5
More stuff that got overlooked during the big refman migration.
2021-10-08doc: fix yaml indentation typo that broke building the websiteEli Schwartz1-6/+6
2021-10-08add install_emptydir functionEli Schwartz2-3/+33
This replaces the absolute hack of using ``` install_subdir('nonexisting', install_dir: 'share') ``` which requires you to make sure you don't accidentally or deliberately have a completely different directory with the same name in your source tree that is full of files you don't want installed. It also avoids splitting the name in two and listing them in the wrong order. You can also set the install mode of each directory component by listing them one at a time in order, and in fact create nested structures at all. Fixes #1604 Properly fixes #2904
2021-10-07docs: restore build_target method documentation which went missingEli Schwartz1-0/+40
In the refman rewrite, these functions vanished. I noticed this when I went looking at the docs for extract_all_objects(), or should I say I tried to go looking.
2021-10-04Minor fixupsDaniel Mensinger4-3/+40
2021-10-03docs: Update YAML docs after rebaseDaniel Mensinger4-13/+59
2021-10-03docs: Added new static docsDaniel Mensinger2-0/+11