From 53d18fe48618c9864de021cc5862685faac7c752 Mon Sep 17 00:00:00 2001
From: Julian Andres Klode <julian.klode@canonical.com>
Date: Mon, 14 Dec 2020 14:28:35 +0100
Subject: 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.
---
 doc/apt-patterns.7.xml | 19 +++++++++++++++++++
 1 file changed, 19 insertions(+)

(limited to 'doc')

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>
 
-- 
cgit v1.2.3


From 2015e0c5eec5750d4f4094d9689cd680608e714f Mon Sep 17 00:00:00 2001
From: Julian Andres Klode <julian.klode@canonical.com>
Date: Sun, 27 Dec 2020 13:49:20 +0100
Subject: woof

---
 doc/apt-patterns.7.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

(limited to 'doc')

diff --git a/doc/apt-patterns.7.xml b/doc/apt-patterns.7.xml
index 161d8ded3..06a60285b 100644
--- a/doc/apt-patterns.7.xml
+++ b/doc/apt-patterns.7.xml
@@ -165,7 +165,7 @@
      <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>
+     <listitem><para>Selects versions depending/pre-depending/suggesting/conflicting/etc on/with/ packages matching PATTERN.</para></listitem>
      </varlistentry>
   </variablelist>
 
-- 
cgit v1.2.3


From 7bec6d3d7008dcfde1d999776102bf5ab2e86381 Mon Sep 17 00:00:00 2001
From: Julian Andres Klode <julian.klode@canonical.com>
Date: Sun, 27 Dec 2020 13:56:22 +0100
Subject: Implement ?reverse-depends/~R and friends

This was easy.
---
 doc/apt-patterns.7.xml | 8 ++++++++
 1 file changed, 8 insertions(+)

(limited to 'doc')

diff --git a/doc/apt-patterns.7.xml b/doc/apt-patterns.7.xml
index 06a60285b..0d2e79f88 100644
--- a/doc/apt-patterns.7.xml
+++ b/doc/apt-patterns.7.xml
@@ -167,6 +167,14 @@
      <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>
-- 
cgit v1.2.3