summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorJulian Andres Klode <jak@debian.org>2021-01-07 10:46:40 +0000
committerJulian Andres Klode <jak@debian.org>2021-01-07 10:46:40 +0000
commit4d9df23b9c2c7039f2e4e7c19df57bfcdef9502b (patch)
tree5b133b845d8a71c3563fceb090aaf42191ec257f /doc
parente92cdbfda401835318600b0d0f31901701b6a675 (diff)
parent7bec6d3d7008dcfde1d999776102bf5ab2e86381 (diff)
Merge branch 'pu/depends' into 'master'
?depends patterns and friends See merge request apt-team/apt!146
Diffstat (limited to 'doc')
-rw-r--r--doc/apt-patterns.7.xml27
1 files changed, 27 insertions, 0 deletions
diff --git a/doc/apt-patterns.7.xml b/doc/apt-patterns.7.xml
index 168ba3c59..0d2e79f88 100644
--- a/doc/apt-patterns.7.xml
+++ b/doc/apt-patterns.7.xml
@@ -153,7 +153,31 @@
</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 versions depending/pre-depending/suggesting/conflicting/etc on/with/ packages matching PATTERN.</para></listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><code>?reverse-<emphasis>depType</emphasis>(PATTERN)</code></term>
+ <term><code>~R<emphasis>DepType</emphasis>:PATTERN</code></term>
+ <listitem><para>Opposite of <code>?depends</code> and friends - selects all packages that have reverse-dependencies (versions) matching PATTERN.</para>
+ <para><emphasis>depType</emphasis> is one of the dependency types such as <code>depends</code>, so that we don't have to repeat the entire list from the first paragraph here.</para>
+ </listitem>
+ </varlistentry>
+
+ </variablelist>
+ </refsect1>
<refsect1><title>Examples</title>
<variablelist>
<varlistentry><term><code>apt remove ?garbage</code></term>
@@ -206,6 +230,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>