summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorJulian Andres Klode <julian.klode@canonical.com>2020-12-14 14:28:35 +0100
committerJulian Andres Klode <julian.klode@canonical.com>2020-12-27 13:36:07 +0100
commit53d18fe48618c9864de021cc5862685faac7c752 (patch)
tree75426646b4aac37272f746b97388f52002922092 /doc
parent4215b6b2ce64f7bd0988c63c8d7d3e34833ec813 (diff)
patterns: Add dependency patterns ?depends, ?conflicts, etc.
These match the target package, not target versions which is slightly unfortunate but might make sense. Maybe we should add a version that matches Versions instead.
Diffstat (limited to 'doc')
-rw-r--r--doc/apt-patterns.7.xml19
1 files changed, 19 insertions, 0 deletions
diff --git a/doc/apt-patterns.7.xml b/doc/apt-patterns.7.xml
index 168ba3c59..161d8ded3 100644
--- a/doc/apt-patterns.7.xml
+++ b/doc/apt-patterns.7.xml
@@ -153,7 +153,23 @@
</variablelist>
</refsect1>
+ <refsect1><title>Package relationship patterns</title>
+ <para>These patterns match specific package versions that depend/conflict with some other packages.</para>
+ <variablelist>
+ <varlistentry>
+ <term><code>?depends(PATTERN)</code></term><term><code>~DPATTERN</code></term>
+ <term><code>?pre-depends(PATTERN)</code></term><term><code>~DPre-Depends:PATTERN</code></term>
+ <term><code>?suggests(PATTERN)</code></term><term><code>~DSuggests:PATTERN</code></term>
+ <term><code>?conflicts(PATTERN)</code></term><term><code>~DConflicts:PATTERN</code></term>
+ <term><code>?replaces(PATTERN)</code></term><term><code>~DReplaces:PATTERN</code></term>
+ <term><code>?obsoletes(PATTERN)</code></term><term><code>~DObsoletes:PATTERN</code></term>
+ <term><code>?breaks(PATTERN)</code></term><term><code>~DBreaks:PATTERN</code></term>
+ <term><code>?enhances(PATTERN)</code></term><term><code>~DEnhances:PATTERN</code></term>
+ <listitem><para>Selects packages depending/pre-depending/suggesting/conflicting/etc on/with/ packages matching PATTERN.</para></listitem>
+ </varlistentry>
+ </variablelist>
+ </refsect1>
<refsect1><title>Examples</title>
<variablelist>
<varlistentry><term><code>apt remove ?garbage</code></term>
@@ -206,6 +222,9 @@
<para>Grouping patterns with <code>(...)</code> or writing <code>?or(A,B)</code> as <code>A|B</code> are not supported. We
do not believe that the use of <code>|</code> is that common, and the grouping is not necessary without it.</para>
</listitem>
+ <listitem>
+ <para>Dependency types for ~D and related operators need to be specified in the canonical case.</para>
+ </listitem>
</itemizedlist>
</refsect1>