From 78be8e0fc9552189fe0c536a0b88e80ab79ca762 Mon Sep 17 00:00:00 2001 From: Wayne Davison Date: Fri, 9 Sep 2005 07:27:25 +0000 Subject: [PATCH] Improved the -F, --exclude-from, and --include-from sections. --- rsync.yo | 24 ++++++++++++------------ 1 file changed, 12 insertions(+), 12 deletions(-) diff --git a/rsync.yo b/rsync.yo index 9f3c140b..e213b823 100644 --- a/rsync.yo +++ b/rsync.yo @@ -889,14 +889,14 @@ See the FILTER RULES section for detailed information on this option. dit(bf(-F)) The bf(-F) option is a shorthand for adding two bf(--filter) rules to your command. The first time it is used is a shorthand for this rule: -quote(tt( --filter=': /.rsync-filter')) +quote(tt( --filter='dir-merge /.rsync-filter')) This tells rsync to look for per-directory .rsync-filter files that have been sprinkled through the hierarchy and use their rules to filter the files in the transfer. If bf(-F) is repeated, it is a shorthand for this rule: -quote(tt( --filter='- .rsync-filter')) +quote(tt( --filter='exclude .rsync-filter')) This filters out the .rsync-filter files themselves from the transfer. @@ -909,11 +909,10 @@ the full rule-parsing syntax of normal filter rules. See the FILTER RULES section for detailed information on this option. -dit(bf(--exclude-from=FILE)) This option is similar to the bf(--exclude) -option, but instead it adds all exclude patterns listed in the file -FILE to the exclude list. Blank lines in FILE and lines starting with -';' or '#' are ignored. -If em(FILE) is bf(-) the list will be read from standard input. +dit(bf(--exclude-from=FILE)) This option is related to the bf(--exclude) +option, but it specifies a FILE that contains exclude patterns (one per line). +Blank lines in the file and lines starting with ';' or '#' are ignored. +If em(FILE) is bf(-), the list will be read from standard input. dit(bf(--include=PATTERN)) This option is a simplified form of the bf(--filter) option that defaults to an include rule and does not allow @@ -921,12 +920,13 @@ the full rule-parsing syntax of normal filter rules. See the FILTER RULES section for detailed information on this option. -dit(bf(--include-from=FILE)) This specifies a list of include patterns -from a file. -If em(FILE) is "-" the list will be read from standard input. +dit(bf(--include-from=FILE)) This option is related to the bf(--include) +option, but it specifies a FILE that contains include patterns (one per line). +Blank lines in the file and lines starting with ';' or '#' are ignored. +If em(FILE) is bf(-), the list will be read from standard input. dit(bf(--files-from=FILE)) Using this option allows you to specify the -exact list of files to transfer (as read from the specified FILE or "-" +exact list of files to transfer (as read from the specified FILE or bf(-) for standard input). It also tweaks the default behavior of rsync to make transferring just the specified files and directories easier: @@ -1347,7 +1347,7 @@ into the batch file without having to flow over the wire to the receiver dit(bf(--read-batch=FILE)) Apply all of the changes stored in FILE, a file previously generated by bf(--write-batch). -If em(FILE) is "-" the batch data will be read from standard input. +If em(FILE) is bf(-), the batch data will be read from standard input. See the "BATCH MODE" section for details. dit(bf(--protocol=NUM)) Force an older protocol version to be used. This -- 2.34.1