blob: 2dec753000dfa467a3992375d2d6047d8ebe1741 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
|
name: build_tgt
long_name: Build target
extends: tgt
description: |
A build target is either an executable, shared library, static library,
both shared and static library or shared module.
methods:
- name: extract_objects
returns: extracted_obj
description: |
Returns an opaque value representing the object files generated for those
source files. This is typically used to take single object files and link
them to unit tests or to compile some source files with custom flags. To
use the object file(s) in another build target, use the
`objects:` keyword argument to a [[build_target]] or include them in the command
line of a [[custom_target]].
varargs:
name: source
type: str | file
description: |
Source filenames for which the built objects should be extracted.
min_varargs: 1
- name: extract_all_objects
returns: extracted_obj
description: |
Acts the same as `extract_objects`, but returns all object files generated
by this target.
By default only objects built for this target are returned to maintain
backward compatibility with previous versions. The default value for the
`recursive` kwarg will eventually be changed to `true` in a future version.
kwargs:
recursive:
type: bool
description: |
Also return objects passed to the `objects` argument of this target.
since: 0.46.0
default: true
- name: full_path
returns: str
description: |
Returns a full path pointing to the result target file.
**NOTE:** In most cases using the object itself will do the same job
as this and will also allow Meson to setup inter-target dependencies
correctly. Please file a bug if that doesn't work for you.
- name: path
returns: str
since: 0.59.0
deprecated: 0.59.0
description: |
Does the exact same as [[build_tgt.full_path]]. **NOTE**: This
function is solely kept for compatebility with [[@external_program]] objects.
It will be removed once the, also deprecated, corresponding `path()`
function in the [[@external_program]] object is removed.
- name: private_dir_include
returns: inc
description: |
Returns a value that works like [[include_directories]], but points to the
private directory of this target. Usually only needed if an another target
needs to access some generated internal headers of this target.
- name: name
returns: str
since: 0.54.0
description: Returns the name of the target.
- name: found
returns: bool
since: 0.59.0
description: |
Always returns `true`. This function is meant to make executables
objects feature compatible with [[@external_program]] objects. This
simplifies use-cases where an executable is used instead of
an [[@external_program]].
|
