Describe snapshot remove with a remote key when the listing fails

Given a remote key, `snapshot remove` lists the destination before it
removes anything. When the destination cannot be listed or has no marker
file, it fails and removes nothing. The README and `snapshot remove
--help` said a snapshot in the local index is still removed from it.
That holds only for a snapshot named by its ID.

"The marker file" in `README.md` and `docs/REPOSTRUCTURE.md` now lists
`snapshot remove` with the commands that fail when given a remote key,
or a snapshot ID that is not in the local index.

The `--local-only` sentence in the help ran to 35 words and is split in
two.

Model: fable-5-2
This commit is contained in:
sneak committed 2026-11-19 08:40:15 +00:00
1 parent 3cc3f713a4
commit d3e3cae424
3 files changed
+28 -12

No files matched your search

+3 -1
View File
@@ -66,8 +66,10 @@ not exist, commands treat the destination as not present:
- `snapshot files`
- `snapshot verify`
- `snapshot restore`
- `snapshot remove`
- `snapshot list` shows the local index alone.
- `snapshot remove` deletes nothing at the destination.
- `snapshot remove` deletes nothing at the destination when given a snapshot ID
that is in the local index.
The check is skipped when the look-up fails for any other reason. S3 refuses the
look-up to credentials that can only write. A machine with such credentials