From cdd11ccb256771142f72d9447f63acbed0415a1a Mon Sep 17 00:00:00 2001
From: Matthew Jackson <1085847+MattJackson@users.noreply.github.com>
Date: Wed, 24 Jun 2026 05:02:24 -0700
Subject: [PATCH] =?UTF-8?q?fix:=20correct=20stale=20doc=20on=20PatchItem::?=
 =?UTF-8?q?Unreadable=20=E2=80=94=20promotion=20shipped=20via=20Mapfile::r?=
 =?UTF-8?q?ecord,=20not=20PatchSink?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 src/disc/patch.rs | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/src/disc/patch.rs b/src/disc/patch.rs
index c6908ee..d1117ca 100644
--- a/src/disc/patch.rs
+++ b/src/disc/patch.rs
@@ -76,9 +76,10 @@ pub(super) enum PatchItem {
     /// `NonTrimmed` so future passes get another shot at them). Kept
     /// in the enum for the orchestrator-side end-of-recovery promotion
     /// (autorip, after the final retry pass completes, promotes
-    /// still-NonTrimmed bytes to Unreadable). When that ships, this
-    /// becomes the variant the orchestrator emits to the same
-    /// PatchSink.
+    /// still-NonTrimmed bytes to Unreadable). The orchestrator (autorip)
+    /// performs this promotion directly via `Mapfile::record()` after all
+    /// retry passes complete, not by emitting to `PatchSink`. This variant
+    /// remains unused by the library itself.
     #[allow(dead_code)]
     Unreadable { pos: u64, len: u64 },