Reword ten sentences after rereading the last commit's prose
The last commit was not written on the model that #397 requires. Every sentence it added or changed was read again under that issue's rules and checked against the code, as #399 (comment) asks. - The local index lists files too, so the README and the help text no longer say the file list is stored only in the snapshot's database. - The root help lists the three commands that need the private key. - The quoted-path, mode and rclone upload sentences now put the subject and verb early. - `docs/REPOSTRUCTURE.md` names the path that `snapshot files` writes. - The example config says what runs when the `snapshots` requirement is not met. - "take that object for complete" becomes "treat that object as complete". Model: fable-5-2
This commit is contained in:
1 parent
45d775709d
commit
b2c8d75bcc
5 files changed
+25
-20
No files matched your search
@@ -483,7 +483,7 @@ It needs:
|
||||
- Permission to read at the destination, and to list it when you give a remote
|
||||
key, or a snapshot ID that is not in the local index.
|
||||
|
||||
The file list is stored only in the snapshot's encrypted database. The command
|
||||
The command reads the file list from the snapshot's encrypted database. It
|
||||
downloads and decrypts that database. It writes the decrypted database to a
|
||||
temporary directory and removes it afterwards. See
|
||||
[Temporary files](#temporary-files).
|
||||
@@ -499,12 +499,12 @@ The table is sorted by path. It has these columns:
|
||||
- `MODIFIED`: the modification time, in UTC.
|
||||
- `PATH`: the original absolute path.
|
||||
|
||||
In the table, a path that holds a newline or another non-printable character is
|
||||
shown in double quotes, with that character escaped, as in `"a\nb"`.
|
||||
A path can contain a newline or another non-printable character. The table shows
|
||||
such a path in double quotes, with that character escaped, as in `"a\nb"`.
|
||||
|
||||
The mode looks like the one `ls -l` shows, as in `-rw-r--r--` or `drwxr-xr-x`.
|
||||
The letters before the nine permission characters show the type and any special
|
||||
bit. These letters differ from `ls -l`:
|
||||
The letters before the nine permission characters show the type. They also show
|
||||
the setuid, setgid and sticky bits. These letters differ from `ls -l`:
|
||||
|
||||
- `L`: a symlink, which `ls -l` shows as `l`.
|
||||
- `u`: setuid, which `ls -l` shows as `s` in place of the owner's `x`.
|
||||
@@ -1096,7 +1096,7 @@ The URL takes no parameters and no credentials.
|
||||
### Interrupted uploads
|
||||
|
||||
An upload that is cut off must not leave a partial object under the final name.
|
||||
A later backup would take that object for complete.
|
||||
A later backup would treat that object as complete.
|
||||
|
||||
- S3 shows an object only once its upload has finished.
|
||||
- The local directory destination writes a temporary file and then renames it.
|
||||
@@ -1127,9 +1127,9 @@ Commands need these permissions at the destination:
|
||||
- `prune` and `snapshot create --prune` list, read and delete.
|
||||
|
||||
On an rclone remote, a backup can also need permission to read and delete. Which
|
||||
ones depends on the storage service. An upload to a remote that can move objects
|
||||
looks up the object it replaces and deletes it. It stops when the look-up is
|
||||
refused.
|
||||
ones depends on the storage service. On a remote that can move objects, an
|
||||
upload looks up the object it replaces and deletes that object. The upload stops
|
||||
when the look-up is refused.
|
||||
|
||||
These commands list only when you give a remote key, or a snapshot ID that is
|
||||
not in the local index:
|
||||
|
||||
Reference in new issue
Block a user