summaryrefslogtreecommitdiff
path: root/doc/apt-patterns.7.xml
diff options
context:
space:
mode:
authorJulian Andres Klode <julian.klode@canonical.com>2019-08-15 12:50:22 +0200
committerJulian Andres Klode <julian.klode@canonical.com>2019-08-15 20:21:34 +0200
commitc64a85dd7524546864603b955f601bf64c9a4bcf (patch)
tree1e97211ac7d8673715266f3702f4535d1cbb194d /doc/apt-patterns.7.xml
parent08b61197f418883ea20563e2251fb60779c0ba87 (diff)
Add patterns for the existing CacheFilter::Matcher classes
This implements the basic logic patterns: ?and ?false ?not ?or ?true and the basic package patterns: ?architecture ?name ?x-name-fnmatch
Diffstat (limited to 'doc/apt-patterns.7.xml')
-rw-r--r--doc/apt-patterns.7.xml38
1 files changed, 36 insertions, 2 deletions
diff --git a/doc/apt-patterns.7.xml b/doc/apt-patterns.7.xml
index 079c493e4..5aa352f03 100644
--- a/doc/apt-patterns.7.xml
+++ b/doc/apt-patterns.7.xml
@@ -36,12 +36,46 @@
</refsect1>
<refsect1>
- <title>Syntax</title>
+ <title>Logic patterns</title>
+ <para>
+ These patterns provide the basic means to combine other patterns into
+ more complex expressions, as well as <code>?true</code> and <code>?false</code>
+ patterns.
+ </para>
<variablelist>
+ <varlistentry><term><code>?and(PATTERN, PATTERN, ...)</code></term>
+ <listitem><para>Selects objects where all specified patterns match.</para></listitem>
+ </varlistentry>
+ <varlistentry><term><code>?false</code></term>
+ <listitem><para>Selects nothing.</para></listitem>
+ </varlistentry>
+ <varlistentry><term><code>?not(PATTERN)</code></term>
+ <listitem><para>Selects objects where PATTERN does not match.</para></listitem>
+ </varlistentry>
+ <varlistentry><term><code>?or(PATTERN, PATTERN, ...)</code></term>
+ <listitem><para>Selects objects where at least one of the specified patterns match.</para></listitem>
+ </varlistentry>
+ <varlistentry><term><code>?true</code></term>
+ <listitem><para>Selects all objects.</para></listitem>
+ </varlistentry>
+ </variablelist>
+ </refsect1>
+ <refsect1>
+ <title>Package patterns</title>
+ <para>
+ These patterns select specific packages.
+ </para>
+ <variablelist>
+ <varlistentry><term><code>?architecture(WILDCARD)</code></term>
+ <listitem><para>Selects packages matching the specified architecture, which may contain wildcards using any.</para></listitem>
+ </varlistentry>
+ <varlistentry><term><code>?name(REGEX)</code></term>
+ <listitem><para>Selects packages where the name matches the given regular expression.</para></listitem>
+ </varlistentry>
</variablelist>
-
</refsect1>
+
<refsect1><title>Examples</title>
</refsect1>