From: Wayne Davison <wayned@samba.org>
Date: Wed, 14 Dec 2005 21:59:11 +0000 (+0000)
Subject: Mention new quote-parsing for the --rsh/-e and RSYNC_RSH handling.
X-Git-Url: https://mattmccutchen.net/rsync/rsync.git/commitdiff_plain/5d9530fe47241bf21435bd89f10981cde25f50f8

Mention new quote-parsing for the --rsh/-e and RSYNC_RSH handling.
---

diff --git a/rsync.yo b/rsync.yo
index 6fe98a04..e7fd8faa 100644
--- a/rsync.yo
+++ b/rsync.yo
@@ -853,9 +853,18 @@ running rsync daemon on the remote host.  See the section "USING
 RSYNC-DAEMON FEATURES VIA A REMOTE-SHELL CONNECTION" above.
 
 Command-line arguments are permitted in COMMAND provided that COMMAND is
-presented to rsync as a single argument.  For example:
+presented to rsync as a single argument.  You must use spaces (not tabs
+or other whitespace) to separate the command and args from each other,
+and you can use single- and/or double-quotes to preserve spaces in an
+argument (but not backslashes).  Note that doubling a single-quote
+inside a single-quoted string gives you a single-quote; likewise for
+double-quotes (though you need to pay attention to which quotes your
+shell is parsing and which quotes rsync is parsing).  Some examples:
 
-quote(tt(   -e "ssh -p 2234"))
+quote(
+tt(    -e 'ssh -p 2234')nl()
+tt(    -e 'ssh -o "ProxyCommand nohup ssh firewall nc -w1 %h %p"')nl()
+)
 
 (Note that ssh users can alternately customize site-specific connect
 options in their .ssh/config file.)