Hi together, I'd like to propose the attached patch for the man page clarifying the difference between shell patterns and rsync patterns as it is not clear in at least of the examples (the user might think that `rsync remote.host:*.c /local/target/` is possible. A HACKING file has been added to provide an entry point for working on documentation.
All the best, Karl-P. Richter
From 81fe5c12bd5875069bff2454f2d8a835053b394c Mon Sep 17 00:00:00 2001 From: Karl-Philipp Richter <krichter...@aol.de> Date: Wed, 11 Jun 2014 00:26:07 +0200 Subject: [PATCH 1/2] added HACKING to provide more intuitive accesss to infos about yodl usage --- HACKING | 7 +++++++ 1 file changed, 7 insertions(+) create mode 100644 HACKING diff --git a/HACKING b/HACKING new file mode 100644 index 0000000..c0ad2f2 --- /dev/null +++ b/HACKING @@ -0,0 +1,7 @@ +Please consider INSTALL and README first. + +DOCUMENTATION +------------- +The structure of the documentation and its automated building with docbook is +described in doc/README-SGML. Besides the project uses yodl +(http://yodl.sourceforge.net/) which is controlled in the rsync.yo file. \ No newline at end of file -- 1.9.1 From f2a33d39c2e437af2d440861997e4fcb5a1dfc32 Mon Sep 17 00:00:00 2001 From: Karl-Philipp Richter <krichter...@aol.de> Date: Wed, 11 Jun 2014 00:27:30 +0200 Subject: [PATCH 2/2] added hint about distinction between shell and exclude/include patterns to avoid users e.g. trying *rsync -a remote.com:*.c /local/target/* --- rsync.yo | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/rsync.yo b/rsync.yo index c80610d..02beef4 100644 --- a/rsync.yo +++ b/rsync.yo @@ -103,7 +103,11 @@ This would transfer all files matching the pattern *.c from the current directory to the directory src on the machine foo. If any of the files already exist on the remote system then the rsync remote-update protocol is used to update the file by sending only the -differences. See the tech report for details. +differences. See the tech report for details. This example takes advantage of +shell expansion of the *.c pattern. Note the difference between +shell patterns and their limitations and include/exclude +patterns of rsync providing facilities to handle excludes/includes on remote +machines described in the section below. quote(tt(rsync -avz foo:src/bar /data/tmp)) -- 1.9.1
signature.asc
Description: OpenPGP digital signature
-- Please use reply-all for most replies to avoid omitting the mailing list. To unsubscribe or change options: https://lists.samba.org/mailman/listinfo/rsync Before posting, read: http://www.catb.org/~esr/faqs/smart-questions.html
