From 86355a121ffe39e05cda52e377965faa0de7054a Mon Sep 17 00:00:00 2001
From: Jochen Bandhauer <jb@jbitc.de>
Date: Mon, 31 Aug 2026 12:54:02 +0200
Subject: [PATCH v1] doc: add a note to repack (verbose) regarding removable
 row versions

---
 doc/src/sgml/ref/repack.sgml | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/doc/src/sgml/ref/repack.sgml b/doc/src/sgml/ref/repack.sgml
index 0cb72b6b289..eed85494f49 100644
--- a/doc/src/sgml/ref/repack.sgml
+++ b/doc/src/sgml/ref/repack.sgml
@@ -376,6 +376,15 @@ REPACK [ ( <replaceable class="parameter">option</replaceable> [, ...] ) ] USING
     inside a transaction block.
    </para>
 
+  <para>
+    The number of removable row versions shown in the verbose output should not
+    be considered a definitive measure of all dead tuples in the table. It
+    reflects the number of dead tuples encountered by the specific scanning method
+    (e.g., an index scan) that was used to rebuild the table. In some cases, dead
+    tuples may be physically removed from the heap (pruned) before they are even
+    encountered, further influencing this count.
+  </para>
+
  </refsect1>
 
  <refsect1>
-- 
2.52.0