From: Wayne Davison <wayned@samba.org>
Date: Mon, 6 Feb 2006 17:58:29 +0000 (+0000)
Subject: Mention the new output-escaping idiom and the multibyte support.
X-Git-Url: https://mattmccutchen.net/rsync/rsync.git/commitdiff_plain/36f59b5802bdb2320d12d9429ef9347321cd2ec6

Mention the new output-escaping idiom and the multibyte support.
---

diff --git a/NEWS b/NEWS
index 32b49315..9c33b4d4 100644
--- a/NEWS
+++ b/NEWS
@@ -8,6 +8,21 @@ Changes since 2.6.6:
       clumping them together with the 'D' for devices.  The number of
       characters is also different (to remove an unused field).
 
+    - The way rsync escapes unreadable characters has changed.  First, rsync
+      now has support for recognizing valid multibyte character sequences in
+      your current locale, allowing it to escape fewer characters than before
+      for a locale such as UTF-8.  Second, it now uses an escape idiom of
+      "\#123", which is the literal string "\#" followed by exactly 3 octal
+      digits.  Rsync no longer doubles a backslash character in a filename
+      (e.g. it used to output "foo\\bar" when copying "foo\bar") -- now it only
+      escapes a backslash that is followed by a hash-sign and 3 digits (0-9)
+      (e.g. it will output "foo\#134#789" when copying "foo\#789").
+
+      Script writers: the local rsync is the one that outputs escaped names,
+      so if you need to support unescaping of filenames for older rsyncs, I'd
+      suggest that you parse the output of "rsync --version" and only use the
+      old unescaping rules for 2.6.5 and 2.6.6.
+
   BUG FIXES:
 
     - Fixed a really old bug that caused --checksum (-c) to checksum all the