blob: b9aedca848d6ba34d3acccca461cecc29bed4fbc (
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
80
81
82
|
name: install_data
returns: void
description: |
Installs files from the source tree that are listed as positional arguments.
Please note that this can only install static files from the source tree.
Generated files are installed via the `install_dir:` kwarg on the respective
generators, such as `custom_target()` or `configure_file().
See [Installing](Installing.md) for more examples.
varargs:
name: file
type: file | str
description: Files to install.
warnings:
- the `install_mode` kwarg ignored integer values between 0.59.0 -- 1.1.0.
- an omitted `install_dir` kwarg did not work correctly inside of a subproject until 1.3.0.
- an omitted `install_dir` kwarg did not work correctly when combined with the `preserve_path` kwarg until 1.3.0.
kwargs:
install_dir:
type: str
description: |
The absolute or relative path to the installation directory.
If this is a relative path, it is assumed to be relative to the prefix.
If omitted, the directory defaults to `{datadir}/{projectname}` *(since 0.45.0)*.
install_mode:
type: array[str | int]
since: 0.38.0
description: |
specify the file mode in symbolic format and
optionally the owner/uid and group/gid for the installed files. For
example:
`install_mode: 'rw-r--r--'` for just the file mode
`install_mode: ['rw-r--r--', 'nobody', 'nogroup']` for the file mode and the user/group
`install_mode: ['rw-r-----', 0, 0]` for the file mode and uid/gid
To leave any of these three as the default, specify `false`.
install_tag:
type: str
since: 0.60.0
description: |
A string used by the `meson install --tags` command
to install only a subset of the files. By default these files have no install
tag which means they are not being installed when `--tags` argument is specified.
preserve_path:
type: bool
since: 0.64.0
default: false
description: |
Disable stripping child-directories from data files when installing.
This is equivalent to GNU Automake's `nobase` option.
rename:
type: array[str]
since: 0.46.0
description: |
If specified renames each source file into corresponding file from `rename` array.
Nested paths are allowed and they are
joined with `install_dir`. Length of `rename` array must be equal to
the number of sources.
sources:
type: array[file | str]
description: Additional files to install.
follow_symlinks:
type: bool
since: 1.3.0
default: true
description: |
If true, dereferences links and copies their target instead. The default
value will become false in the future.
|
