diff options
| -rw-r--r-- | docs/markdown/Installing.md | 13 | ||||
| -rw-r--r-- | docs/markdown/Reference-manual.md | 7 | 
2 files changed, 20 insertions, 0 deletions
diff --git a/docs/markdown/Installing.md b/docs/markdown/Installing.md index 46705447f..b8e6a81f0 100644 --- a/docs/markdown/Installing.md +++ b/docs/markdown/Installing.md @@ -29,6 +29,19 @@ install_man('foo.1') # -> share/man/man1/foo.1.gz  install_data('datafile.dat', install_dir : join_paths(get_option('datadir'), 'progname')) # -> share/progname/datafile.dat  ``` +`install_data()` supports rename of the file *since 0.46.0*. + +```meson +# file.txt -> {datadir}/{projectname}/new-name.txt +install_data('file.txt', rename : 'new-name.txt') + +# file1.txt -> share/myapp/dir1/data.txt +# file2.txt -> share/myapp/dir2/data.txt +install_data(['file1.txt', 'file2.txt'], +             rename : ['dir1/data.txt', 'dir2/data.txt'], +             install_dir : 'share/myapp') +``` +  Sometimes you want to copy an entire subtree directly. For this use case there is the `install_subdir` command, which can be used like this.  ```meson diff --git a/docs/markdown/Reference-manual.md b/docs/markdown/Reference-manual.md index 589baf1e8..0d7dedc4f 100644 --- a/docs/markdown/Reference-manual.md +++ b/docs/markdown/Reference-manual.md @@ -737,6 +737,13 @@ arguments. The following keyword arguments are supported:   To leave any of these three as the default, specify `false`. +- `rename` 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. +  *(added 0.46.0)* + +See [Installing](Installing.md) for more examples. +  ### install_headers()  ``` meson  | 
