Fix five README.md statements from the fifth review
check / check (push) Failing after 2m50s

Under `--json`, `snapshot list` prints no warning for a snapshot with
no manifest at the destination; the README now says so and points to
`remote_present`. The stdout list names `snapshot create` as well as
`snapshot restore` for the per-file error lines. `snapshot create`
stops "before it writes anything at the destination", since the
destination binding is saved first. `prune_grace_period` is a Go
duration, so the README now says only which units it rejects. The
commands that run while a backup is in progress are a bulleted list.

Model: fable-5-1
This commit is contained in:
clawbot committed 2026-11-09 01:00:56 +00:00
1 parent b344c019bf
commit a133b8838e
1 file changed
+15 -6
+15 -6
View File
@@ -241,7 +241,7 @@ command that skipped anything still finishes, and then exits non-zero.
`m` means minutes and `mo` means months. Days, weeks, months and years take `m` means minutes and `mo` means months. Days, weeks, months and years take
whole numbers and can be combined, as in `2w3d`. whole numbers and can be combined, as in `2w3d`.
`prune_grace_period` accepts only hours, minutes and seconds. `prune_grace_period` does not accept `d`, `w`, `mo` or `y`.
### `config init` ### `config init`
@@ -321,7 +321,7 @@ Flags:
- `--keep-newer-than <duration>`: with `--prune`, keep every snapshot newer than - `--keep-newer-than <duration>`: with `--prune`, keep every snapshot newer than
this. this.
The backup stops before it writes anything in these cases: The backup stops before it writes anything at the destination in these cases:
- A `file://` destination directory does not exist. - A `file://` destination directory does not exist.
- The destination has no marker file, although the local index holds snapshots. - The destination has no marker file, although the local index holds snapshots.
@@ -429,7 +429,9 @@ marker file although the local index holds snapshots.
- `remote_present`: whether the snapshot is at the destination. It is `null` - `remote_present`: whether the snapshot is at the destination. It is `null`
when the destination could not be listed. when the destination could not be listed.
Under `--json`, every warning above goes to stderr. Under `--json`, every warning above goes to stderr, except the one about a
snapshot with no manifest at the destination. That snapshot has
`remote_present` set to `false`.
### `snapshot verify <snapshot-id>` ### `snapshot verify <snapshot-id>`
@@ -1074,8 +1076,14 @@ The lock covers one user on one machine. It does not stop another user or
another machine from writing to the same destination. See another machine from writing to the same destination. See
[Sharing a destination](#sharing-a-destination). [Sharing a destination](#sharing-a-destination).
No other command takes the lock. `snapshot list`, `snapshot verify`, No other command takes the lock. These commands run while a backup is in
`snapshot restore`, `info` and `remote info` run while a backup is in progress. progress:
- `snapshot list`
- `snapshot verify`
- `snapshot restore`
- `info`
- `remote info`
## Output ## Output
@@ -1084,7 +1092,8 @@ No other command takes the lock. `snapshot list`, `snapshot verify`,
stdout carries the output you asked for: stdout carries the output you asked for:
- status and progress lines - status and progress lines
- warnings, and the errors that `snapshot restore` prints about files - warnings, and the errors that `snapshot create` and `snapshot restore` print
about files
- tables and reports - tables and reports
- JSON documents - JSON documents
- `config get` values - `config get` values