[SCM] The rsync repository. - branch master updated

Rsync CVS commit messages rsync-cvs at lists.samba.org
Thu Jun 2 01:49:35 UTC 2022

The branch, master has been updated
       via  6f355533 Fix grabbing version value in configure.
       via  71090b7e Improve discussion of old-args in advanced usage.
      from  2ab2ee16 Make md-convert --test work again.


- Log -----------------------------------------------------------------
commit 6f35553372f262b8024918677645cafd649162e0
Author: Wayne Davison <wayne at opencoder.net>
Date:   Wed Jun 1 17:41:28 2022 -0700

    Fix grabbing version value in configure.

commit 71090b7e2caefb5894c10b02d34e2c57e4de848b
Author: Wayne Davison <wayne at opencoder.net>
Date:   Sat May 14 16:31:50 2022 -0700

    Improve discussion of old-args in advanced usage.


Summary of changes:
 configure.ac |  2 +-
 rsync.1.md   | 32 ++++++++++++++++++--------------
 2 files changed, 19 insertions(+), 15 deletions(-)

Changeset truncated at 500 lines:

diff --git a/configure.ac b/configure.ac
index 24e383a9..29698bc0 100644
--- a/configure.ac
+++ b/configure.ac
@@ -22,7 +22,7 @@ AC_CONFIG_SRCDIR([byteorder.h])
-PACKAGE_VERSION=`sed 's/.*"\(.*\)".*/\1/' <$srcdir/version.h`
+PACKAGE_VERSION=`sed -n 's/.*RSYNC_VERSION.*"\(.*\)".*/\1/p' <$srcdir/version.h`
 AC_MSG_NOTICE([Configuring rsync $PACKAGE_VERSION])
diff --git a/rsync.1.md b/rsync.1.md
index 92030b3b..1e665982 100644
--- a/rsync.1.md
+++ b/rsync.1.md
@@ -177,20 +177,24 @@ the hostname omitted.  For instance, all these work:
 >     rsync -aiv host::modname/file{1,2} host::modname/extra /dest/
 >     rsync -aiv host::modname/first ::modname/extra{1,2} /dest/
-In a modern rsync, you only need to quote or backslash-escape things like
-spaces from the local shell but not also from the remote shell:
->     rsync -aiv host:'a simple file.pdf' /dest/
-Really old versions of rsync only allowed specifying one remote-source arg, so
-it required the remote side to split the args at a space.  You can still get
-this old-style arg splitting by using the [`--old-args`](#opt) option:
->     rsync -ai --old-args host:'dir1/file1 dir2/file2' /dest
->     rsync -ai --old-args host::'modname/dir1/file1 modname/dir2/file2' /dest
-See that option's section for an [environment variable](#RSYNC_OLD_ARGS) that
-can be exported to help old scripts.
+Really old versions of rsync (2.6.9 and before) only allowed specifying one
+remote-source arg, so some people have instead relied on the remote-shell
+performing space splitting to break up an arg into multiple paths. Such
+unintuitive behavior is no longer supported by default (though you can request
+it, as described below).
+Starting in 3.2.4, filenames are passed to a remote shell in such a way as to
+preserve the characters you give it. Thus, if you ask for a file with spaces
+in the name, that's what the remote rsync looks for:
+>     rsync -aiv host:'a simple file.pdf' /dest/                                                                                
+If you use scripts that have been written to manually apply extra quoting to
+the remote rsync args (or to require remote arg splitting), you can ask rsync
+to let your script handle the extra escaping.  This is done by either adding
+the [`--old-args`](#opt) option to the rsync runs in the script (which requires
+a new rsync) or exporting [RSYNC_OLD_ARGS](#)=1 and [RSYNC_PROTECT_ARGS](#)=0
+(which works with old or new rsync versions).

The rsync repository.

More information about the rsync-cvs mailing list