Repository navigation
docs: redacting a passage, and why it is not a black rectangle - #41
Merged
Merged
Conversation
The workbench page covers selecting and marking; Redact is the fourth editing scope and the only verb there that destroys anything. The section says what the difference is, in the spec's own words — ISO 32000-1 §12.5.6.23 requires a conforming reader to "remove all traces of the specified content" and says "clipping or image masks shall not be used to hide that data" — and then what that means for a reader: a rectangle drawn over a paragraph leaves the text in the stream for anyone to copy out. It also lists the four refusals and why each one is a refusal rather than a best effort, because the commonest of them is a flow a reader walks into: highlight a passage, then decide to redact it. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Why
The workbench page covers selecting and marking. Redact is the fourth
editing scope — and the only verb on that tab that destroys anything, so it is
the one most worth explaining.
What the section says
"removed 17 characters from 1 page — the text is gone from the file, not
covered";
requires a conforming reader applying a redaction to "remove all traces of
the specified content" and says "clipping or image masks shall not be used
to hide that data". A rectangle drawn over a paragraph leaves the text in the
stream for anyone to copy out from under it;
had to go and find on another tab is one you would do with a rectangle
instead;
form XObject (shared bytes), an image (the pixels must be destroyed, and a
mask over them is what the spec forbids), an annotation (it holds text of its
own), and an operator that also draws words outside the selection. A redaction
betrays its reader in two directions, and removing too much is the quieter
one;
to redact it. The highlight is an annotation over those words and its note
can quote them, so it has to go first;
same arithmetic, so highlighting a line and then redacting it gets the same
words both times.
Text only — no front matter, navigation or shortcode changes.
Companions: app#79 (the verb),
ops#68 and
ops#69 (the library).
🤖 Generated with Claude Code