From 73decf31f1e8e58aba57bfdb607fb5d2a2717e74 Mon Sep 17 00:00:00 2001
From: Filipe Brandenburger <filbranden@google.com>
Date: Wed, 25 Apr 2018 00:49:40 -0700
Subject: [PATCH] Update reference manual to include 'install_mode' where
 supported

---
 docs/markdown/Reference-manual.md | 18 ++++++++++++++++++
 1 file changed, 18 insertions(+)

diff --git a/docs/markdown/Reference-manual.md b/docs/markdown/Reference-manual.md
index 0c54de0e0..44ac287b2 100644
--- a/docs/markdown/Reference-manual.md
+++ b/docs/markdown/Reference-manual.md
@@ -204,6 +204,8 @@ the `@variable@` syntax.
 - `install_dir` the subdirectory to install the generated file to
   (e.g. `share/myproject`), if omitted or given the value of empty
   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
   `@PLAINNAME@` or `@BASENAME@` substitutions). In configuration mode,
   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.
 - `install` when true, this target is installed during the install step
 - `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
 
 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
   plugins into a subdir, you'd use something like this: `install_dir :
   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
   (but *not* before that)
 - `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')
 ```
 
+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()
 
 ``` meson
@@ -826,6 +837,11 @@ overridden by specifying it with the `install_dir` keyword
 argument. All man pages are compressed during installation and
 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()
 
 ``` meson
@@ -843,6 +859,8 @@ The following keyword arguments are supported:
 - `exclude_directories`: a list of directory names that should not be installed.
   Names are interpreted as paths relative to the `subdir_name` location.
 - `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.
   If `strip_directory=false` only last component of source path is used.
   Since 0.45.0