From 3f8585676ba6d2c1bcd5d80a44275fdfa695f8c2 Mon Sep 17 00:00:00 2001 From: Peter Hutterer Date: Wed, 3 Feb 2021 09:15:45 +1000 Subject: Make installing non-existing subdirs a supported feature MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit install_subdir() with a non-existing subdir creates the directory in the target directory. This seems like an implementation detail but is quite useful to create new directories for e.g. configuration or plugins in the installed locations. git bisect says this started with 8fe816101467e66792251b4f57e0ddddb537764a. Let's add a test for it and document it to make this behavior official. Limitation: it can only create at the install_dir location, trying to create nested subdirectories does not work and indeed creates the wrong directory structure. That is a bug that should be fixed separately: install_subdir('blah', install_dir: get_option('prefix')) install_subdir('sub/foobar', install_dir: get_option('prefix')) install_subdir('foo/baz', install_dir: get_option('prefix')) $ tree ../_inst ../_inst ├── baz ├── blah └── foobar Fixes #2904 --- docs/markdown/Reference-manual.md | 10 ++++++++++ 1 file changed, 10 insertions(+) (limited to 'docs/markdown') diff --git a/docs/markdown/Reference-manual.md b/docs/markdown/Reference-manual.md index f12f695..46ea1c0 100644 --- a/docs/markdown/Reference-manual.md +++ b/docs/markdown/Reference-manual.md @@ -1143,6 +1143,10 @@ Installs the entire given subdirectory and its contents from the source tree to the location specified by the keyword argument `install_dir`. +If the subdirectory does not exist in the source tree, an empty directory is +created in the specified location. *(since 0.45.0)* A newly created +subdirectory may only be created in the keyword argument `install_dir`. + The following keyword arguments are supported: - `exclude_files`: a list of file names that should not be installed. @@ -1192,6 +1196,12 @@ share/ file1 ``` +`install_subdir('new_directory', install_dir : 'share')` creates +```text +share/ + new_directory/ +``` + ### is_disabler() ``` meson -- cgit v1.1