aboutsummaryrefslogtreecommitdiff
path: root/docs/markdown/Reference-manual.md
AgeCommit message (Collapse)AuthorFilesLines
2020-09-06doc: Add missing method arguments [skip ci]Michal Sojka1-21/+21
Documentation of most methods mentions method arguments enclosed in parentheses. Two methods are an exception and we fix them here to make the manual more consistent.
2020-09-05docs: Fix typo in Reference-manual.md [skip ci]Krzysztof MaƂysa1-1/+1
2020-08-15Add that prefix keyword works for cc.get_defineJohn Scott1-1/+1
2020-07-20string: add substring methodStéphane Cerveau1-0/+3
This method aims to offer a simple way to 'substring' an existing string with start and end values.
2020-07-09doc: Small tweaks to fallback documentation [skip ci]Xavier Claessens1-0/+2
2020-07-01wrap: Add 'provide' sectionXavier Claessens1-1/+3
2020-07-01Implicit dependency fallback when a subproject wrap or dir existsXavier Claessens1-1/+3
2020-06-30Cleaned up Reference docs [skip ci]TheQwertiest1-486/+470
2020-06-11Correct argument typo in partial_dependnecy (#7300) [skip ci]Phillip Johnston1-1/+1
Should be "sources" not "source" ``` ../meson.build:162: WARNING: Passed invalid keyword argument "source". WARNING: This will become a hard error in the future. Traceback (most recent call last): File "/usr/local/lib/python3.7/site-packages/mesonbuild/mesonmain.py", line 131, in run return options.run_func(options) File "/usr/local/lib/python3.7/site-packages/mesonbuild/msetup.py", line 245, in run app.generate() File "/usr/local/lib/python3.7/site-packages/mesonbuild/msetup.py", line 159, in generate self._generate(env) File "/usr/local/lib/python3.7/site-packages/mesonbuild/msetup.py", line 192, in _generate intr.run() File "/usr/local/lib/python3.7/site-packages/mesonbuild/interpreter.py", line 4359, in run super().run() File "/usr/local/lib/python3.7/site-packages/mesonbuild/interpreterbase.py", line 465, in run self.evaluate_codeblock(self.ast, start=1) File "/usr/local/lib/python3.7/site-packages/mesonbuild/interpreterbase.py", line 490, in evaluate_codeblock raise e File "/usr/local/lib/python3.7/site-packages/mesonbuild/interpreterbase.py", line 483, in evaluate_codeblock self.evaluate_statement(cur) File "/usr/local/lib/python3.7/site-packages/mesonbuild/interpreterbase.py", line 498, in evaluate_statement self.assignment(cur) File "/usr/local/lib/python3.7/site-packages/mesonbuild/interpreterbase.py", line 1151, in assignment value = self.evaluate_statement(node.value) File "/usr/local/lib/python3.7/site-packages/mesonbuild/interpreterbase.py", line 500, in evaluate_statement return self.method_call(cur) File "/usr/local/lib/python3.7/site-packages/mesonbuild/interpreterbase.py", line 895, in method_call return obj.method_call(method_name, args, self.kwargs_string_keys(kwargs)) File "/usr/local/lib/python3.7/site-packages/mesonbuild/interpreterbase.py", line 39, in method_call return method(args, kwargs) File "/usr/local/lib/python3.7/site-packages/mesonbuild/interpreterbase.py", line 285, in wrapped return f(*wrapped_args, **wrapped_kwargs) File "/usr/local/lib/python3.7/site-packages/mesonbuild/interpreterbase.py", line 151, in wrapped return f(*wrapped_args, **wrapped_kwargs) File "/usr/local/lib/python3.7/site-packages/mesonbuild/interpreterbase.py", line 213, in wrapped return f(*wrapped_args, **wrapped_kwargs) File "/usr/local/lib/python3.7/site-packages/mesonbuild/interpreter.py", line 484, in partial_dependency_method pdep = self.held_object.get_partial_dependency(**kwargs) TypeError: get_partial_dependency() got an unexpected keyword argument 'source' FAILED: build.ninja ```
2020-05-18pass exe_wrapper to test scripts through the environmentDylan Baker1-0/+7
This adds a new MESON_EXE_WRAPPER environment variable containing the string form of the exe_wrapper, if there is an exe_wrapper defined. Fixes #4427
2020-05-14interpreter: Rename has_exe_wrapper -> can_run_host_binariesDylan Baker1-4/+8
The implementation of this function has changed enough that the name doesn't really reflect what it actually does. It basically returns true unless you're cross compiling, need and exe_wrapper, and don't have one. The original function remains but is marked as deprecated. This makes one small change the meson source language, which is that it defines that can_run_host_binaries will return true in build == host compilation, which was the behavior that already existed. Previously this was undefined in build == host compilation.
2020-05-06Merge pull request #7064 from dcbaker/gtest-protocolJussi Pakkanen1-5/+8
Add support for Gtest as a test protocol
2020-05-04Add native support for gtest testsDylan Baker1-5/+8
Gtest can output junit results with a command line switch. We can parse this to get more detailed results than the returncode, and put those in our own Junit output. We basically just throw away the top level 'testsuites' object, then fixup the names of the tests, and shove that into our junit.
2020-05-03Merge pull request #7060 from dcbaker/install-script-targetsJussi Pakkanen1-0/+7
Allow meson.add_*_script to take additional types
2020-04-30Docs: Update link_language docs to explain when it should be usedDylan Baker1-2/+6
2020-04-30docs: Update documentation for add_*_scriptDylan Baker1-0/+7
2020-04-28find_program: Fixes when the program has been overridden by executableXavier Claessens1-1/+9
- ExternalProgramHolder has path() method while CustomTargetHolder and BuildTargetHolder have full_path(). - The returned ExternalProgramHolder's path() method was broken, because build.Executable object has no get_path() method, it needs the backend. - find_program('overridden_prog', version : '>=1.0') was broken because it needs to execute the exe that is not yet built. Now assume the program has the (sub)project version. - If the version check fails, interpreter uses ExternalProgramHolder.get_name() for the error message but build.Executable does not implement get_name() method.
2020-04-12Merge pull request #6958 from jon-turney/fix-name-prefix-explicit-defaultJussi Pakkanen1-4/+4
Fix library(name_prefix: [])
2020-04-11docs: fix the docs for install_subdir's strip_directory [skip ci]Peter Hutterer1-1/+1
When set to **true** only the last component is used. And throw in two minor grammatical fixes while we're there.
2020-04-11Refine documentation of default name_prefixJon Turney1-4/+4
Refine documentation of the default name_prefix, so people don't get the impression they can write logic which uses 'lib' as the default, when they should be defaulting to '[]', to let us take care of the complexities.
2020-03-28docs: why 'ninja test' depends on build_by_default targets [skip ci]Marc Herbert1-2/+6
Fixes #1949
2020-03-19cmake: Add find_package COMPONETS supportDaniel Mensinger1-1/+2
2020-03-09Merge pull request #6532 from jon-turney/languages-native-kwargJussi Pakkanen1-9/+19
Add add_languages(native:)
2020-03-06Improve logged messages for overriden dependenciesXavier Claessens1-1/+4
2020-03-06Simplify dependency() fallbackXavier Claessens1-0/+4
Now that subprojects can override the dependency name, there is no need to provide a variable name for the fallback any more.
2020-03-06Add meson.override_dependency()Xavier Claessens1-1/+7
Similar to meson.override_find_program() but overrides the result of the dependency() function. Also ensure that dependency() always returns the same result when looking for the same dependency, this fixes cases where parts of the project could be using a system library and other parts use the library provided by a subproject.
2020-03-04interpreter: add 'name' method to BuildTargetHolderStéphane Cerveau1-0/+2
As any child of BuildTargetHolder might need the name of the object, provides a method to get object name. This is useful in gst-build to display the plugin name and not the filename.
2020-02-26summary: Add list_sep keyword argumentXavier Claessens1-1/+2
This allows having lists on a single line instead of having each value aligned on a new line.
2020-02-19docs: Improve visibility for `.enabled()` etc., add example [skip ci]Niklas HambĂŒchen1-2/+14
2020-02-18docs: Mention `cuda` as supported language [skip ci]Niklas HambĂŒchen1-1/+1
2020-02-18docs: Fix typo 'serie' -> 'series'Niklas HambĂŒchen1-1/+1
2020-02-17minstall: Add a new option --quietNirbheek Chauhan1-2/+5
This is a significant speed-up on Windows because terminals are slow to print things out. Speed-up in gst-build on Windows: ``` meson install: before: 5.1 seconds after: 4.0 seconds ```
2020-02-12Refine behaviour of add_languages() when native: is missingJon Turney1-3/+7
This improves the common case of a simple meson.build which doesn't contain any 'native: true' targets to not require a native compiler when cross-compiling, without needing any changes in the meson.build. v2: Do it the right way around!
2020-02-09Add add_languages(native:)Jon Turney1-9/+15
v2: Retain not using logical-and, to avoid short-circuiting side-effects of add_languages()
2020-02-06Make 'default_library' per-subproject builtin optionXavier Claessens1-1/+2
Currently it's just like if all builtin/base/compiler options are yielding. This patch makes possible to have non-yielding builtin options. The value in is overriden in this order: - Value from parent project - Value from subproject's default_options if set - Value from subproject() default_options if set - Value from command line if set
2020-02-06docs: explain the purpose of order-only deps for generated files [skip ci]Marc Herbert1-5/+6
The documentation of "order-only" dependencies is limited and their various purposes are especially not clear. See issue #6391 for a recent example, search the internet for many more. So mention the particular purpose here while making the documentation barely longer.
2020-02-05docMichael Hirsch, Ph.D1-1/+1
2020-02-05add get_external_property to replace get_cross_propertyMichael Hirsch, Ph.D1-7/+12
2020-02-05add native-file properties testsMichael Hirsch, Ph.D1-0/+4
2020-02-04interpreter: Iterate custom target outputsXavier Claessens1-0/+6
2020-01-27Merge pull request #6423 from dcbaker/declare-dependency-variablesJussi Pakkanen1-2/+7
Add ability to set and query arbitrary variables on declare_dependency objects
2020-01-26Support multiple args to message() and warning()Xavier Claessens1-0/+6
2020-01-23Set source and build dir envvars when running dist.Jussi Pakkanen1-8/+11
2020-01-09docs: Add documentation for variables keywordDylan Baker1-2/+7
In declare_dependency() and dependency.get_variables().
2019-12-19summary: Change 'section' to be a kwarg instead of positionalXavier Claessens1-16/+14
Fixes: #6372.
2019-12-19add compiler.get_linker_id() methodMichael Hirsch, Ph.D1-1/+3
this can be useful for if/elif where linker behaviors must be considered. For example, clang with "link" vs gcc with "ld.bfd" etc. ci for compiler.get_linker_id() method doc add @FeatureNew check Co-Authored-By: Daniel Mensinger <daniel@mensinger-ka.de>
2019-12-12summary: Add bool_yn keyword argumentXavier Claessens1-0/+4
2019-12-12summary: Allow section with no title, and passing key/value separatelyXavier Claessens1-5/+12
2019-12-12Add a summary() function for configuration summarizationXavier Claessens1-0/+52
Based on patch from Dylan Baker. Fixes #757
2019-12-10assert(): Make message argument optionalXavier Claessens1-0/+3