From bda27dd3993f2b4fdf4afecf06435373d462a3bc Mon Sep 17 00:00:00 2001 From: Zen Dodd Date: Mon, 10 Aug 2026 15:20:42 +1000 Subject: [PATCH] docs: clarify --files-from deletion scope Signed-off-by: Zen Dodd --- rsync.1.md | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/rsync.1.md b/rsync.1.md index 2d38efe30..c8149ff31 100644 --- a/rsync.1.md +++ b/rsync.1.md @@ -2418,6 +2418,12 @@ expand it. options are parsed (e.g. [`-a`](#opt) works the same before or after `--files-from`, as does `--no-R` and all other options). + Listing individual files with `--files-from` does not make unlisted + siblings eligible for deletion. The [`--delete`](#opt) option only removes + entries from directories whose complete contents are being synchronised, + so list the directory itself and enable recursion if that deletion scope is + intended. + The filenames that are read from the FILE are all relative to the source dir -- any leading slashes are removed and no ".." references are allowed to go higher than the source dir. Blank entries are ignored, as are