--- Begin Message ---
Subject: |
[PATCH] gzip: --rsyncable missing in gzip.1 man page |
Date: |
Thu, 05 Jun 2014 10:34:36 +0200 |
User-agent: |
StGit/0.17-dirty |
Based on notes of Rob Rye from links
http://lists.gnu.org/archive/html/bug-gzip/2010-06/msg00002.html and
http://beeznest.wordpress.com/2005/02/03/rsyncable-gzip/, composed together to
describe --rsyncable option of gzip.
Signed-off-by: jchaloup <address@hidden>
---
doc/gzip.texi | 3 +++
gzip.1 | 3 +++
2 files changed, 6 insertions(+)
diff --git a/doc/gzip.texi b/doc/gzip.texi
index 3de3063..28453b0 100644
--- a/doc/gzip.texi
+++ b/doc/gzip.texi
@@ -394,6 +394,9 @@ method (less compression) and @option{--best} or
@option{-9} indicates the
slowest compression method (optimal compression). The default
compression level is @option{-6} (that is, biased towards high compression at
expense of speed).
+
address@hidden --rsyncable
+Having a compressed file and synchronized between two computers using rsync,
this option allows after changing a file not to send an entire new archive but
just a small portion of it. Normally, after a change in any file of an archive,
compressing algorithm can generate completely different archive that differs
from the old one. This causes rsync to transmit entirely new version to the
remote computer. With this option, rsync is able to transmit just the changed
portions (plus some minimal padding in the area of the archive that necessarily
changed as a result of the changes in the file).
@end table
@node Advanced usage
diff --git a/gzip.1 b/gzip.1
index 71e097c..8c5d8c7 100644
--- a/gzip.1
+++ b/gzip.1
@@ -322,6 +322,9 @@ indicates the slowest compression method (best compression).
The default compression level is
.BR \-6
(that is, biased towards high compression at expense of speed).
+.TP
+.B \-\-rsyncable
+Having a compressed file and synchronized between two computers using rsync,
this option allows after changing a file not to send an entire new archive but
just a small portion of it. Normally, after a change in any file of an archive,
compressing algorithm can generate completely different archive that differs
from the old one. This causes rsync to transmit entirely new version to the
remote computer. With this option, rsync is able to transmit just the changed
portions (plus some minimal padding in the area of the archive that necessarily
changed as a result of the changes in the file).
.SH "ADVANCED USAGE"
Multiple compressed files can be concatenated. In this case,
.I gunzip
--- End Message ---