From d0022dd9082bc1a71a5e43e21da38292ec732c7e Mon Sep 17 00:00:00 2001 From: Wayne Davison Date: Mon, 6 Feb 2006 18:43:12 +0000 Subject: [PATCH] Document --8-bit (-8). --- rsync.yo | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/rsync.yo b/rsync.yo index 9ccd6ad0..af56596e 100644 --- a/rsync.yo +++ b/rsync.yo @@ -378,6 +378,7 @@ to the detailed description below for a complete description. verb( --sockopts=OPTIONS specify custom TCP options --blocking-io use blocking I/O for the remote shell --stats give some file-transfer stats + -8, --8-bit leave high-bit chars unescaped in output -h, --human-readable output numbers in a human-readable format --si like human-readable, but use powers of 1000 --progress show progress during transfer @@ -1394,6 +1395,17 @@ dit(bf(--stats)) This tells rsync to print a verbose set of statistics on the file transfer, allowing you to tell how effective the rsync algorithm is for your data. +dit(bf(-8, --8-bit)) This tells rsync to leave all high-bit characters +unescaped in the output instead of trying to test them to see if they're +valid in the current locale and escaping the invalid ones. All control +characters (but never tabs) are always escaped, regardless of this option's +setting. + +The escape idiom that started in 2.6.7 is to output a literal backslash (\) +and a hash (#), followed by exactly 3 octal digits. For example, a newline +would output as "\#012". A literal backslash that is in a filename is not +escaped unless it is followed by a hash and 3 digits (0-9). + dit(bf(-h, --human-readable)) Output numbers in a more human-readable format. Large numbers may be output in larger units, with a K (1024), M (1024*1024), or G (1024*1024*1024) suffix. -- 2.34.1