The Meson Build System
http://mesonbuild.com/
You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
79 lines
2.4 KiB
79 lines
2.4 KiB
name: install_data |
|
returns: void |
|
description: | |
|
Installs files from the source tree that are listed as positional arguments. |
|
|
|
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 untill 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: list[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: list[str] |
|
since: 0.46.0 |
|
description: | |
|
If specified renames each source file into corresponding file from `rename` list. |
|
Nested paths are allowed and they are |
|
joined with `install_dir`. Length of `rename` list must be equal to |
|
the number of sources. |
|
|
|
sources: |
|
type: list[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.
|
|
|