From 04211fa81efd1bee3a3c9cee0bf008c25f9f02bf Mon Sep 17 00:00:00 2001
From: krumelmonster <krumelmonster@zoho.com>
Date: Fri, 15 Dec 2023 14:26:44 +0100
Subject: [PATCH] explain relationship between --prefer-cache and --cached-only

---
 doc/downgrade.8    | 2 ++
 doc/downgrade.8.md | 3 ++-
 2 files changed, 4 insertions(+), 1 deletion(-)

diff --git a/doc/downgrade.8 b/doc/downgrade.8
index 9ebbf87..864d42e 100644
--- a/doc/downgrade.8
+++ b/doc/downgrade.8
@@ -178,6 +178,8 @@ Allows for noninteractive downgrades when used in conjunction with
 .PP
 If a package matching the version filter is found in the cache, skip
 querying ala.
+Unlike \[en]cached-only, \[en]prefer-cache does query ala if no package
+could be matched in cache.
 .RE
 .PP
 \f[B]--version\f[R]
diff --git a/doc/downgrade.8.md b/doc/downgrade.8.md
index 8985d4c..3dbd9a1 100644
--- a/doc/downgrade.8.md
+++ b/doc/downgrade.8.md
@@ -100,7 +100,8 @@ on the ALA.
 **\--prefer-cache**\
 
 > If a package matching the version filter is found in the cache, skip querying
-> ala.
+> ala. Unlike --cached-only, --prefer-cache does query ala if no package could
+> be matched in cache.
 
 **\--version**\