aboutsummaryrefslogtreecommitdiff
path: root/doc/manual.cli
diff options
context:
space:
mode:
authorKaren Arutyunov <karen@codesynthesis.com>2017-07-17 15:54:32 +0300
committerKaren Arutyunov <karen@codesynthesis.com>2017-07-17 21:25:08 +0300
commit2d9c7b8c018f161cb22e1bccb207c46e1eac8497 (patch)
treeba6c40458739231b2defdc03b2331c786702fa5c /doc/manual.cli
parentcca12c6c6ec645172a731fc4c759e378a9132a29 (diff)
Allow independent wildcard patterns in a group
Diffstat (limited to 'doc/manual.cli')
-rw-r--r--doc/manual.cli9
1 files changed, 6 insertions, 3 deletions
diff --git a/doc/manual.cli b/doc/manual.cli
index 437c1e5..f89fa23 100644
--- a/doc/manual.cli
+++ b/doc/manual.cli
@@ -71,15 +71,18 @@ exe{hello}: cxx{**} # All C++ source files recursively.
A group-enclosed (\c{{\}}) pattern value may be followed by
inclusion/exclusion patterns/matches. A subsequent value is treated as an
-inclusion if it starts with a plus sign (\c{+}) and as an exclusion if it
-starts with a minus (\c{-}). A subsequent value that does not start with
-either of these signs is illegal. For example:
+inclusion or exclusion if it starts with a literal, unquoted plus (\c{+}) or
+minus (\c{-}) sign, respectively. In this case the remaining group values, if
+any, must all be inclusions or exclusions. If the second value doesn't start
+with a plus or minus, then all the group values are considered independent
+with leading pluses and minuses not having any special meaning. For example:
\
exe{hello}: cxx{f* -foo} # Exclude foo if present.
exe{hello}: cxx{f* +foo} # Include foo if not present.
exe{hello}: cxx{f* -fo?} # Exclude foo and fox if present.
exe{hello}: cxx{f* +b* -foo -bar} # Exclude foo and bar if present.
+exe{hello}: cxx{f* b* -z*} # Names matching three patterns.
\
Inclusions and exclusions are applied in the order specified and only to the