Update reference manual to include 'install_mode' where supported

pull/3134/head
Filipe Brandenburger 7 years ago committed by Nirbheek Chauhan
parent 04c39ad562
commit 73decf31f1
  1. 18
      docs/markdown/Reference-manual.md

@ -204,6 +204,8 @@ the `@variable@` syntax.
- `install_dir` the subdirectory to install the generated file to - `install_dir` the subdirectory to install the generated file to
(e.g. `share/myproject`), if omitted or given the value of empty (e.g. `share/myproject`), if omitted or given the value of empty
string, the file is not installed. string, the file is not installed.
- `install_mode` *(added 0.47.0)* specify the file mode in symbolic format
and optionally the owner/uid and group/gid for the installed files.
- `output` the output file name (since v0.41.0, may contain - `output` the output file name (since v0.41.0, may contain
`@PLAINNAME@` or `@BASENAME@` substitutions). In configuration mode, `@PLAINNAME@` or `@BASENAME@` substitutions). In configuration mode,
the permissions of the input file (if it is specified) are copied to the permissions of the input file (if it is specified) are copied to
@ -261,6 +263,8 @@ following.
- `input` list of source files. As of 0.41.0 the list will be flattened. - `input` list of source files. As of 0.41.0 the list will be flattened.
- `install` when true, this target is installed during the install step - `install` when true, this target is installed during the install step
- `install_dir` directory to install to - `install_dir` directory to install to
- `install_mode` *(added 0.47.0)* the file mode and optionally the
owner/uid and group/gid
- `output` list of output files - `output` list of output files
The list of strings passed to the `command` keyword argument accept The list of strings passed to the `command` keyword argument accept
@ -472,6 +476,8 @@ be passed to [shared and static libraries](#library).
relative to the `prefix` specified. F.ex, if you want to install relative to the `prefix` specified. F.ex, if you want to install
plugins into a subdir, you'd use something like this: `install_dir : plugins into a subdir, you'd use something like this: `install_dir :
join_paths(get_option('libdir'), 'projectname-1.0'`). join_paths(get_option('libdir'), 'projectname-1.0'`).
- `install_mode` *(added 0.47.0)* specify the file mode in symbolic format
and optionally the owner/uid and group/gid for the installed files.
- `install_rpath` a string to set the target's rpath to after install - `install_rpath` a string to set the target's rpath to after install
(but *not* before that) (but *not* before that)
- `objects` list of prebuilt object files (usually for third party - `objects` list of prebuilt object files (usually for third party
@ -814,6 +820,11 @@ This will install `common.h` and `kola.h` into `/{prefix}/cust/myproj`:
install_headers('common.h', 'proj/kola.h', install_dir : 'cust', subdir : 'myproj') install_headers('common.h', 'proj/kola.h', install_dir : 'cust', subdir : 'myproj')
``` ```
The `install_mode` argument can be used to specify the file mode in symbolic
format and optionally the owner/uid and group/gid for the installed files.
An example value could be `['rwxr-sr-x', 'root', 'root']`.
*(Added 0.47.0)*.
### install_man() ### install_man()
``` meson ``` meson
@ -826,6 +837,11 @@ overridden by specifying it with the `install_dir` keyword
argument. All man pages are compressed during installation and argument. All man pages are compressed during installation and
installed with a `.gz` suffix. installed with a `.gz` suffix.
The `install_mode` argument can be used to specify the file mode in symbolic
format and optionally the owner/uid and group/gid for the installed files.
An example value could be `['rwxr-sr-x', 'root', 'root']`.
*(Added 0.47.0)*.
### install_subdir() ### install_subdir()
``` meson ``` meson
@ -843,6 +859,8 @@ The following keyword arguments are supported:
- `exclude_directories`: a list of directory names that should not be installed. - `exclude_directories`: a list of directory names that should not be installed.
Names are interpreted as paths relative to the `subdir_name` location. Names are interpreted as paths relative to the `subdir_name` location.
- `install_dir`: the location to place the installed subdirectory. - `install_dir`: the location to place the installed subdirectory.
- `install_mode`: the file mode in symbolic format and optionally
the owner/uid and group/gid for the installed files. *(Added 0.47.0)*
- `strip_directory`: install directory contents. `strip_directory=false` by default. - `strip_directory`: install directory contents. `strip_directory=false` by default.
If `strip_directory=false` only last component of source path is used. If `strip_directory=false` only last component of source path is used.
Since 0.45.0 Since 0.45.0

Loading…
Cancel
Save