Commit 78be8e0f authored by Wayne Davison's avatar Wayne Davison

Improved the -F, --exclude-from, and --include-from sections.

parent a5b786d8
...@@ -889,14 +889,14 @@ See the FILTER RULES section for detailed information on this option. ...@@ -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 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: 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 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 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 files in the transfer. If bf(-F) is repeated, it is a shorthand for this
rule: rule:
quote(tt( --filter='- .rsync-filter')) quote(tt( --filter='exclude .rsync-filter'))
This filters out the .rsync-filter files themselves from the transfer. This filters out the .rsync-filter files themselves from the transfer.
...@@ -909,11 +909,10 @@ the full rule-parsing syntax of normal filter rules. ...@@ -909,11 +909,10 @@ the full rule-parsing syntax of normal filter rules.
See the FILTER RULES section for detailed information on this option. See the FILTER RULES section for detailed information on this option.
dit(bf(--exclude-from=FILE)) This option is similar to the bf(--exclude) dit(bf(--exclude-from=FILE)) This option is related to the bf(--exclude)
option, but instead it adds all exclude patterns listed in the file option, but it specifies a FILE that contains exclude patterns (one per line).
FILE to the exclude list. Blank lines in FILE and lines starting with Blank lines in the file and lines starting with ';' or '#' are ignored.
';' or '#' are ignored. If em(FILE) is bf(-), the list will be read from standard input.
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 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 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. ...@@ -921,12 +920,13 @@ the full rule-parsing syntax of normal filter rules.
See the FILTER RULES section for detailed information on this option. See the FILTER RULES section for detailed information on this option.
dit(bf(--include-from=FILE)) This specifies a list of include patterns dit(bf(--include-from=FILE)) This option is related to the bf(--include)
from a file. option, but it specifies a FILE that contains include patterns (one per line).
If em(FILE) is "-" the list will be read from standard input. 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 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 for standard input). It also tweaks the default behavior of rsync to make
transferring just the specified files and directories easier: 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 ...@@ -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 dit(bf(--read-batch=FILE)) Apply all of the changes stored in FILE, a
file previously generated by bf(--write-batch). 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. See the "BATCH MODE" section for details.
dit(bf(--protocol=NUM)) Force an older protocol version to be used. This dit(bf(--protocol=NUM)) Force an older protocol version to be used. This
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment