aboutsummaryrefslogtreecommitdiff
path: root/doc/configuration/specs.html.part
diff options
context:
space:
mode:
Diffstat (limited to 'doc/configuration/specs.html.part')
-rw-r--r--doc/configuration/specs.html.part7
1 files changed, 5 insertions, 2 deletions
diff --git a/doc/configuration/specs.html.part b/doc/configuration/specs.html.part
index 79f75f21d..97029e30a 100644
--- a/doc/configuration/specs.html.part
+++ b/doc/configuration/specs.html.part
@@ -32,12 +32,15 @@ the following order:</p>
<li><code>[=1.23]</code>: Match a particular version. Any operator described below
can be used. May be extended to ranged dependencies, using either <code>[=1.23|=1.24|=1.25]</code> for an or
dependency or <code>[&gt;=1.2&amp;&lt;2]</code> for an and dependency.</li>
- <li><code>[.key?]</code>: Match only if the specified metadata key exists.</li>
+ <li><code>[.key?]</code>: Match only if the specified metadata key exists. <code>key</code> may be a key's raw
+ name (e.g. <code>DESCRIPTION</code>, <code>DEPEND</code>) or a role prefixed with a dollar sign (e.g.
+ <code>$short_description</code>, <code>$build_dependencies</code>).</li>
<li><code>[.key=value]</code>: Match only if the specified metadata key has a particular exact value. Only works for
simple values, sets and sequences, not spec trees and other complex compound keys. If <code>&lt;</code> is used in
place of <code>=</code>, for numeric values a less-than comparison is used, and for sets, sequences and spec trees,
a match occurs if any member of the set or sequence is equal to the value. Similarly if <code>&gt;</code> is used,
- for numeric values a greater-than comparison is used; it does not match for other types of values.</li>
+ for numeric values a greater-than comparison is used; it does not match for other types of values. The key may
+ be a raw name or a dollar-prefixed role name as above.</li>
</ul>
<p>Repository requirements are in the form <code>to</code>, <code>from-&gt;</code> or <code>::from-&gt;to</code>. The