summaryrefslogtreecommitdiff
path: root/doc/concepts/overview.org
diff options
context:
space:
mode:
Diffstat (limited to 'doc/concepts/overview.org')
-rw-r--r--doc/concepts/overview.org13
1 files changed, 13 insertions, 0 deletions
diff --git a/doc/concepts/overview.org b/doc/concepts/overview.org
index 13d5d04b..a7230066 100644
--- a/doc/concepts/overview.org
+++ b/doc/concepts/overview.org
@@ -134,6 +134,11 @@ to in target files.
second position (where normally the module would be) is necessary
to ensure the name has length more than 2 to distinguish it from
a reference to the module ~"FILE"~.
+- A reference to an collection, given by a shell pattern, of explicit
+ source files in the top-level directory of the same module,
+ specified as ~["GLOB", null, pattern]~. The explicit ~null~ at
+ second position is required for the same reason as in the explicit
+ file reference.
- A reference to a tree target in the same module, specified as
~["TREE", null, name]~. The explicit ~null~ at second position is
required for the same reason as in the explicit file reference.
@@ -179,6 +184,14 @@ the relative path of the file to the module root and the value the
file artifact located at the specified location. The runfiles are
the same as the artifacts and the provides map is empty.
+**** Collection of files given by a shell pattern
+
+A collection of files given by a shell pattern has, both as artifacts
+and runfiles, the (necessarily disjoint) union of the artifact
+maps of the (zero or more) source targets that match the pattern.
+Only /files/ in the /top-level/ directory of the given modules are
+considered for matches. The provides map is empty.
+
**** Trees
A tree describes a directory. Internally, however, it is a single