From 71e03461868417cb5d5ea973dfa5f83227148fda Mon Sep 17 00:00:00 2001
From: eliets2 <287273517+eliets2@users.noreply.github.com>
Date: Tue, 20 Oct 2026 18:25:15 +0300
Subject: [PATCH] docs(redact): say that a mark with no readable area fails
 apply

The apply section of the redact README described the fail-closed rules but not the new refusal of a Redact annotation with neither a usable QuadPoints array nor a usable Rect. Documented here with the error name and the page scope of the count. No behaviour change in this commit.
---
 crates/redact/README.md | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/crates/redact/README.md b/crates/redact/README.md
index 7cd5ded1e..3332da14f 100644
--- a/crates/redact/README.md
+++ b/crates/redact/README.md
@@ -32,7 +32,9 @@ clear_marks(&mut doc, None)?;                        // remove marks without app
 
 A verification pass re-reads each redacted page and fails the operation if any glyph or inline
 image is still under an area. Content that can't be decoded makes the operation fail rather than
-leave it unredacted.
+leave it unredacted. A Redact annotation with neither a usable `/QuadPoints` array nor a usable
+`/Rect` makes it fail with `RedactError::UnreadableMark` before anything changes, instead of
+skipping that mark. The count covers the marks on the pages being applied.
 
 Before changing any page, `apply` prepares the redaction appearances with a shared 8 MiB
 budget for their uncompressed PDF content across the selected pages. It bounds repeated-text