Subject: [PATCH] gzip: --rsyncable missing in gzip.1 man page

From: jchaloup <[email-masked]>
Date: Thu, 05 Jun 2014 10:34:36 +0200

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 <[email-masked]>
---
 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).
+
+@item --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