From 80ec88369dc91fdb8571d31cd29c0ef8e593372a Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ingo=20Br=C3=BCckl?= <ib@wupperonline.de>
Date: Wed, 14 Jun 2023 17:18:23 +0200
Subject: [PATCH] Add to the documentation on the --installed option

The description so far might be misleading
(see https://bugs.debian.org/1029586).
---
 doc/apt-cache.8.xml | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/doc/apt-cache.8.xml b/doc/apt-cache.8.xml
index 0958dbcd6..68792812a 100644
--- a/doc/apt-cache.8.xml
+++ b/doc/apt-cache.8.xml
@@ -347,7 +347,9 @@ Reverse Provides:
       <listitem><para>
       Limit the output of <literal>depends</literal> and <literal>rdepends</literal> to
       packages which are currently installed.
-      Configuration Item: <literal>APT::Cache::Installed</literal>.</para></listitem>
+      Configuration Item: <literal>APT::Cache::Installed</literal>.</para>
+      <para>Note that this limits the output list of all inspected packages.
+      It does not limit inspection to only installed packages.</para></listitem>
       </varlistentry>
 
       <varlistentry><term><option>--with-source</option> <option>&synopsis-param-filename;</option></term>
-- 
2.30.2