From 0af126fec798d6dbb0d1ad52168cc1f3f1758acd Mon Sep 17 00:00:00 2001 From: Arsen Arsenović Date: Tue, 12 Jul 2022 15:26:22 +0200 Subject: install_{data,headers,subdir}: implement follow_symlinks This permits users who rely on following symlinks to stay on the old default of following them. --- docs/markdown/snippets/install_follow_symlink_arg.md | 7 +++++++ docs/yaml/functions/install_data.yaml | 8 ++++++++ docs/yaml/functions/install_headers.yaml | 8 ++++++++ docs/yaml/functions/install_subdir.yaml | 8 ++++++++ 4 files changed, 31 insertions(+) create mode 100644 docs/markdown/snippets/install_follow_symlink_arg.md (limited to 'docs') diff --git a/docs/markdown/snippets/install_follow_symlink_arg.md b/docs/markdown/snippets/install_follow_symlink_arg.md new file mode 100644 index 000000000..ce971d7ff --- /dev/null +++ b/docs/markdown/snippets/install_follow_symlink_arg.md @@ -0,0 +1,7 @@ +## Added follow_symlinks arg to install_data, install_header, and install_subdir + +The [[install_data]], [[install_headers]], [[install_subdir]] functions now +have an optional argument `follow_symlinks` that, if set to `true`, makes it so +symbolic links in the source are followed, rather than copied into the +destination tree, to match the old behavior. The default, which is currently +to follow links, is subject to change in the future. diff --git a/docs/yaml/functions/install_data.yaml b/docs/yaml/functions/install_data.yaml index 5ecc318a9..ff4f3363d 100644 --- a/docs/yaml/functions/install_data.yaml +++ b/docs/yaml/functions/install_data.yaml @@ -69,3 +69,11 @@ kwargs: sources: type: list[file | str] description: Additional files to install. + + follow_symlinks: + type: bool + since: 1.3.0 + default: true + description: | + If true, dereferences links and copies their target instead. The default + value will become false in the future. diff --git a/docs/yaml/functions/install_headers.yaml b/docs/yaml/functions/install_headers.yaml index 958ab156e..0ac4fc586 100644 --- a/docs/yaml/functions/install_headers.yaml +++ b/docs/yaml/functions/install_headers.yaml @@ -73,3 +73,11 @@ kwargs: Disable stripping child-directories from header files when installing. This is equivalent to GNU Automake's `nobase` option. + + follow_symlinks: + type: bool + since: 1.3.0 + default: true + description: | + If true, dereferences links and copies their target instead. The default + value will become false in the future. diff --git a/docs/yaml/functions/install_subdir.yaml b/docs/yaml/functions/install_subdir.yaml index 1907cec40..19abee37d 100644 --- a/docs/yaml/functions/install_subdir.yaml +++ b/docs/yaml/functions/install_subdir.yaml @@ -106,3 +106,11 @@ kwargs: description: | Install directory contents. If `strip_directory=true` only the last component of the source path is used. + + follow_symlinks: + type: bool + since: 1.3.0 + default: true + description: | + If true, dereferences links and copies their target instead. The default + value will become false in the future. -- cgit v1.3