From a19ebe5eccb4281c452b85369b6cbc78287fa0d9 Mon Sep 17 00:00:00 2001
From: Thomas Waldmann <tw@waldmann-edv.de>
Date: Wed, 1 Nov 2023 17:18:32 +0100
Subject: [PATCH] docs: consequences of borg check, fixes #7816

---
 docs/changes.rst | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/docs/changes.rst b/docs/changes.rst
index ed3817e11..edc23bf0d 100644
--- a/docs/changes.rst
+++ b/docs/changes.rst
@@ -39,8 +39,10 @@ Steps you must take to upgrade a repository:
    Note: it is not required to upgrade a server, except if the server-side borg
    is also used as a client (and not just for "borg serve").
 
-   Do **not** run ``borg check`` with borg > 1.2.4 before completing the upgrade steps.
+   Do **not** run ``borg check`` with borg > 1.2.4 before completing the upgrade steps:
 
+   - ``borg check`` would complain about archives without a valid archive TAM.
+   - ``borg check --repair`` would remove such archives!
 2. Run ``BORG_WORKAROUNDS=ignore_invalid_archive_tam borg info --debug <repo> 2>&1 | grep TAM | grep -i manifest``.
 
    a) If you get "TAM-verified manifest", continue with 3.