aboutsummaryrefslogtreecommitdiff
path: root/doc/manual.cli
diff options
context:
space:
mode:
authorBoris Kolpackov <boris@codesynthesis.com>2023-04-10 14:28:23 +0200
committerBoris Kolpackov <boris@codesynthesis.com>2023-04-10 14:28:23 +0200
commit1308eb0d740a687161641d52dabad8c0f849db08 (patch)
treed44ae8e001db5c54f0b619616d04efe2706a207e /doc/manual.cli
parent74d42005e25e4a3c8356d44010b82a206b8aa7e6 (diff)
Add support for negation in config.install.filter
Diffstat (limited to 'doc/manual.cli')
-rw-r--r--doc/manual.cli22
1 files changed, 14 insertions, 8 deletions
diff --git a/doc/manual.cli b/doc/manual.cli
index 101493c..7f6b730 100644
--- a/doc/manual.cli
+++ b/doc/manual.cli
@@ -6328,14 +6328,20 @@ modifier to only apply to symlink filesystem entries. For example:
$ b config.install.filter='\"*.so\"@false,symlink'
\
-Note that this mechanism only affects what gets physically copied to the
-installation directory without affecting what gets built for install or the
-view of what gets installed at the \c{buildfile} level. For example,
-given the \c{include/@false *.a@false} filters, static libraries will still be
-built (unless arranged not to with \c{config.bin.lib}) and the \c{pkg-config}
-files will still end up with \c{-I} options pointing to the header
-installation directory. Note also that this mechanism applies to both
-\c{install} and \c{uninstall} operations.
+A filter can be negated by specifying \c{!} as the first pair. For example:
+
+\
+$ b install config.install.filter='! include/@false \"*.a\"@false'
+\
+
+Note that the filtering mechanism only affects what gets physically copied to
+the installation directory without affecting what gets built for install or
+the view of what gets installed at the \c{buildfile} level. For example, given
+the \c{include/@false *.a@false} filters, static libraries will still be built
+(unless arranged not to with \c{config.bin.lib}) and the \c{pkg-config} files
+will still end up with \c{-I} options pointing to the header installation
+directory. Note also that this mechanism applies to both \c{install} and
+\c{uninstall} operations.
\N|If you are familiar with the Debian or Fedora packaging, this mechanism is
somewhat similar to (and can be used for a similar purpose as) the Debian's