aboutsummaryrefslogtreecommitdiffstats
path: root/README.md
diff options
context:
space:
mode:
Diffstat (limited to 'README.md')
-rw-r--r--README.md18
1 files changed, 10 insertions, 8 deletions
diff --git a/README.md b/README.md
index 9f1b760..7fdd8eb 100644
--- a/README.md
+++ b/README.md
@@ -356,15 +356,17 @@ Supported attributes:
of rsync. Defaults to `true`.
* `insecureLinks` (optional) -
- what to do if rsync can't read `.rsync-filter` files in `path`. rsync 3.5.0
+ what to do if rsync can't read `.rsync-filter` files that apply to `path`:
+ the ones therein, and the ones in the directories above it. rsync 3.5.0
and later open them more strictly than the files they transfer, and ignore
- the ones they can't open, e.g. because a directory on the way may be
- entered but not read, like a home directory with mode 711, or because a
- symlink on the way belongs to neither root nor the user deploying. By
- default, with `null`, populating fails with an error naming the file. With
- `true`, rsync reads such files anyway (`--insecure-links`); with `false`,
- rsync syncs without them. Both print a warning. Older versions of rsync
- aren't affected.
+ the ones they can't open, e.g. because a symlink on the way belongs to
+ neither root nor the user deploying, or, with rsync 3.5.0, because a
+ directory on the way may be entered but not read, like a home directory
+ with mode 711. By default, with `null`, populating fails with an error
+ naming the file. With `true`, rsync reads such files anyway
+ (`--insecure-links`), which also lets it pass such symlinks on the way to
+ the target path of a local target; with `false`, rsync syncs without them.
+ Both print a warning. Older versions of rsync aren't affected.
* `inputs` (optional) -
inputs of the flake in this source to draw from other sources, see