From 8b9701d2ad76a9a571c445b318557261a4922758 Mon Sep 17 00:00:00 2001 From: Boris Kolpackov Date: Tue, 4 Apr 2023 14:10:27 +0200 Subject: Remove global override restriction from config.install.filter --- doc/manual.cli | 11 +++++------ 1 file changed, 5 insertions(+), 6 deletions(-) (limited to 'doc/manual.cli') diff --git a/doc/manual.cli b/doc/manual.cli index e9b59d2..101493c 100644 --- a/doc/manual.cli +++ b/doc/manual.cli @@ -6287,8 +6287,7 @@ assert (!$install.relocatable) 'relocatable installation not supported' While project authors determine what gets installed at the \c{buildfile} level, the users of the project can further filter the installation using the -\c{config.install.filter} variable. \N{This variable can only be specified as -a global override.} +\c{config.install.filter} variable. The value of this variable is a list of key-value pairs that specify the filesystem entries to include or exclude from the installation. For example, @@ -6296,7 +6295,7 @@ the following filters will omit installing headers and static libraries (notice the quoting of the wildcard). \ -$ b install !config.install.filter='include/@false \"*.a\"@false' +$ b install config.install.filter='include/@false \"*.a\"@false' \ The key in each pair is a file or directory path or a path wildcard pattern. @@ -6316,7 +6315,7 @@ as included with the rest of the components matched against the following sub-filters. For example: \ -$ b install !config.install.filter=' +$ b install config.install.filter=' include/x86_64-linux-gnu/@true include/x86_64-linux-gnu/details/@false include/@false' @@ -6326,7 +6325,7 @@ The \c{true} or \c{false} value may be followed by comma and the \c{symlink} modifier to only apply to symlink filesystem entries. For example: \ -$ b !config.install.filter='\"*.so\"@false,symlink' +$ b config.install.filter='\"*.so\"@false,symlink' \ Note that this mechanism only affects what gets physically copied to the @@ -6349,7 +6348,7 @@ and shared library symlinks; assuming the platform uses the \c{.a}/\c{.so} extensions for the libraries): \ -$ b install !config.install.filter=' +$ b install config.install.filter=' include/@false pkgconfig/@false \"lib/*.a\"@false -- cgit v1.1