From: Wayne Davison <wayne@opencoder.net>
Date: Sun, 19 Jun 2022 23:43:38 +0000 (-0700)
Subject: Improve the filter intro.
X-Git-Tag: v3.2.5pre1~13
X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=defe2287aa7e4fedc3c5589d142cfad7b740dacd;p=thirdparty%2Frsync.git

Improve the filter intro.
---

diff --git a/rsync.1.md b/rsync.1.md
index 038dbdc0..9c149b31 100644
--- a/rsync.1.md
+++ b/rsync.1.md
@@ -3739,11 +3739,19 @@ The options allowed when starting an rsync daemon are as follows:
 
 ## FILTER RULES
 
-The filter rules allow for flexible selection of which files to transfer
-(include) and which files to skip (exclude).  The rules either directly specify
-include/exclude patterns or they specify a way to acquire more include/exclude
-patterns (e.g. to read them from a file). Some rules even exclude/include xattr
-attributes.
+The filter rules allow for custom control of several aspects of how files are
+handled:
+
+- Control which files the sending side puts into the file list that describes
+  the transfer hierarchy
+- Control which files the receiving side protects from deletion when the file
+  is not in the sender's file list
+- Control which extended attribute names are skipped when copying xattrs
+
+The rules are either directly specified via option arguments or they can be
+read in from one or more files.  The filter-rule files can even be a part of
+the hierarchy of files being copied, affecting different parts of the tree in
+different ways.
 
 ### SIMPLE INCLUDE/EXCLUDE RULES