From 73f7408f6d164e595fb2e3a3df856a8f8168fcb9 Mon Sep 17 00:00:00 2001
From: Julian Andres Klode <julian.klode@canonical.com>
Date: Fri, 13 Jan 2023 12:23:43 +0100
Subject: make ?installed pattern match installed version only when narrowed

This is the correct behavior, but it was overlooked when aptitude
patterns where ported. I remember wondering about this, but I checked
the aptitude code and saw a check that CurrentVer != 0 or something
and then apparently did not notice another implementation for version
matching.
---
 doc/apt-patterns.7.xml | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

(limited to 'doc/apt-patterns.7.xml')

diff --git a/doc/apt-patterns.7.xml b/doc/apt-patterns.7.xml
index 45f2f9fd7..9ed8aa835 100644
--- a/doc/apt-patterns.7.xml
+++ b/doc/apt-patterns.7.xml
@@ -108,7 +108,7 @@
      <listitem><para>Selects packages that can be removed automatically.</para></listitem>
      </varlistentry>
      <varlistentry><term><code>?installed</code></term><term><code>~i</code></term>
-     <listitem><para>Selects packages that are currently installed.</para></listitem>
+     <listitem><para>Selects packages that are currently installed. Since version 2.5.4, narrowing this pattern (see narrowing patterns above) makes it only match installed versions (see version patterns below).</para></listitem>
      </varlistentry>
      <varlistentry><term><code>?name(REGEX)</code></term><term><code>~nREGEX</code></term>
      <listitem><para>Selects packages where the name matches the given regular expression.</para></listitem>
@@ -138,6 +138,9 @@
      <varlistentry><term><code>?codename(REGEX)</code></term>
      <listitem><para>Selects versions that come from the codename that matches the specified regular expression. Codename, here, means the values after <code>n=</code> in <command>apt-cache policy</command>.</para></listitem>
      </varlistentry>
+     <varlistentry><term><code>?installed</code></term><term><code>~i</code></term>
+         <listitem><para>Selects package versions that are currently installed. Versions prior to 2.5.4 only matched at the package level, hence <code>?any-version(?installed?version(2.0))</code>matched even if 2.0 was not installed, but another version was.</para></listitem>
+     </varlistentry>
      <varlistentry><term><code>?origin(REGEX)</code></term><term><code>~OREGEX</code></term>
      <listitem><para>Selects versions that come from the origin that matches the specified regular expression. Origin, here, means the values after <code>o=</code> in <command>apt-cache policy</command>.</para></listitem>
      </varlistentry>
-- 
cgit v1.2.3-70-g09d2