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.part14
1 files changed, 13 insertions, 1 deletions
diff --git a/doc/configuration/specs.html.part b/doc/configuration/specs.html.part
index 9903a35a0..ed376066f 100644
--- a/doc/configuration/specs.html.part
+++ b/doc/configuration/specs.html.part
@@ -25,18 +25,30 @@ the following order:</p>
<ul>
<li><code>:slot</code>: Match only in that slot.</li>
+
<li><code>::repo-&gt;repo</code>: Repository requirements, described below.</li>
+
<li><code>::something</code>: like <code>::-&gt;something</code>, for all legal values of something.</li>
+
<li><code>[use]</code> and <code>[-use]</code>: Match only if the named USE flag is enabled / disabled for this
package. May be specified multiple times with different USE flag names.</li>
+
<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. <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>). If the key's name is prefixed with
+ <code>::</code>, metadata from the repository rather than the package ID is checked.</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. As above, the key
+ may be a raw name or a dollar-prefixed role name, and may be prefixed with <code>::</code> for checking repository
+ metadata.</li>
</ul>
<p>Repository requirements are in the form <code>to</code>, <code>from-&gt;</code> or <code>::from-&gt;to</code>. The