GNU bug report logs - #17698
[PATCH] gzip: --rsyncable missing in gzip.1 man page

Previous Next

To add a comment to this bug, you must first unarchive it, by sending
a message to control AT debbugs.gnu.org, with unarchive 17698 in the body.
You can then email your comments to 17698 AT debbugs.gnu.org in the normal way.

Toggle the display of automated, internal messages from the tracker.

Message #5 received at submit <at> debbugs.gnu.org (full text, mbox):

From: jchaloup <jchaloup <at> redhat.com>
To: bug-gzip <at> gnu.org
Cc: jchaloup <at> redhat.com
Subject: [PATCH] gzip: --rsyncable missing in gzip.1 man page
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 <jchaloup <at> redhat.com>
---
 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

Message #10 received at 17698-done <at> debbugs.gnu.org (full text, mbox):

From: Paul Eggert <eggert <at> cs.ucla.edu>
To: jchaloup <jchaloup <at> redhat.com>, 17698-done <at> debbugs.gnu.org
Subject: Re: bug#17698: [PATCH] gzip: --rsyncable missing in gzip.1 man page
Date: Thu, 05 Jun 2014 08:58:45 -0700

GNU gzip doesn't have an --rsyncable option, so I'm afraid you'll need 
to send this to the maintainer of the patched version you're using.

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.