Improve the filter intro.
authorWayne Davison <wayne@opencoder.net>
Sun, 19 Jun 2022 23:43:38 +0000 (16:43 -0700)
committerWayne Davison <wayne@opencoder.net>
Sun, 19 Jun 2022 23:45:43 +0000 (16:45 -0700)
rsync.1.md

index 038dbdc0fc8e7918f5b3204015d5e94e6cc921f9..9c149b318496b3fa9f62dfe89058004c5804bfad 100644 (file)
@@ -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