aboutsummaryrefslogtreecommitdiff
path: root/docs/yaml/functions/install_emptydir.yaml
blob: e598b5e9ac70a9ebcac6767a587ac485ed98e15a (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
name: install_emptydir
returns: void
since: 0.60.0
description: |
  Installs a new directory entry to the location specified by the positional
  argument. If the directory exists and is not empty, the contents are left in
  place.

varargs:
  name: dirpath
  type: str
  description: Directory to create during installation.

kwargs:
  install_mode:
    type: list[str | int]
    description: |
      Specify the file mode in symbolic format and optionally the owner/uid and
      group/gid for the created directory.

      See the `install_mode` kwarg of [[install_data]] for more information.
  install_tag:
    type: str
    description: |
      A string used by the `meson install --tags` command to install only a
      subset of the files. By default this directory has no install tag which
      means it is not installed when the `--tags` argument is specified.