summaryrefslogtreecommitdiff
path: root/docs/yaml
AgeCommit message (Collapse)Author
2022-04-20vcs_tag: handle non-str / non-file argumentsKirill Isakov
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 Isakov
2022-04-07docs: YAML: Add `arg_flattening: false` where requiredDaniel Mensinger
2022-04-07docs: Fix [[true]] --> `true`Daniel Mensinger
2022-04-01docs: fix inaccurate description of command targetsEli Schwartz
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 Schwartz
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 Schwartz
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 Scholz
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 Claessens
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-snake
2022-03-22Add ability to add resources to jarsTristan Partin
Previously Meson lacked the ability to add resources to jar files. Fixes #9945
2022-03-20docs: fix incorrect default for test is_parallelEli Schwartz
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 Pakkanen
Structured Sources
2022-03-07docs: document the rust_crate_type build_target keywordDylan Baker
2022-03-07docs: Add docs for structured_sourcesDylan Baker
2022-03-06find_program: add a version() method to match the one for dependenciesEli Schwartz
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 Schwartz
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 Claessens
2022-02-28doc: Fix spelling developper->developerXavier Claessens
Mistaken from French développeur.
2022-02-20add all supported arguments in docs for summary()Stone Tickle
2022-02-14shared module: Allow linking on AndroidNirbheek Chauhan
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 Tojnar
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 Baker
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 Bonzini
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 Pappacoda
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 Baker
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 Baker
2021-12-30fix incorrect docs for add_*_scriptEli Schwartz
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 Baker
We were missing the most important keyword argument of them all!
2021-12-01add install_symlink functionPablo Correa Gómez
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 Baker
2021-11-24shared_module: Add soname when used as a link targetNirbheek Chauhan
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 Drummond
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 King
2021-11-09docs: fix refman 2.0 regression in correctly describing ↵Eli Schwartz
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 Schwartz
2021-11-05Fix markdown formating in find_program.yamlrusty-snake
fixes #9528
2021-10-30Added warning if run_command is called without the check kwargVolker Weißmann
2021-10-26message: Allow boolXavier Claessens
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-Julian
"seperator" -> "separator"
2021-10-11docs: fix a typoed arg name and another missing argEli Schwartz
More stuff that got overlooked during the big refman migration.
2021-10-08doc: fix yaml indentation typo that broke building the websiteEli Schwartz
2021-10-08add install_emptydir functionEli Schwartz
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 Schwartz
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 Mensinger
2021-10-03docs: Update YAML docs after rebaseDaniel Mensinger
2021-10-03docs: Added new static docsDaniel Mensinger
2021-10-03docs: added install_tag docsDaniel Mensinger
2021-10-03docs: added unset_variable()Daniel Mensinger
2021-10-03docs: Add the YAML Reference manualDaniel Mensinger