On Sat Aug 13 13:11:12 2011, [email protected] wrote: > On Sat, 13 Aug 2011 10:31:12 +0200, Jorgen Grahn > <[email protected]> wrote: > > I remember the time when gzip got --rsyncable support, but it > > wasn't documented in the man page. That was fixed after a while. > > But now when I looked at the info page, I see that it's still > > missing there! > > > > Perhaps other things have drifted out of sync, too. I don't normally > > read info pages, but for Gnu tools there's always a feeling they > > might have neglected the man page in favor of the info page. > > Upstream has never merged the --rsyncable patch, I continue to have to > carry it around in the Debian source package. > > If you're interested in producing a patch for the info page sources, > I'll be happy to apply it. Otherwise I may not get to this for a while.
Fair enough. I've attached a patch against 1.3.12-9 below. I haven't actually /formatted/ the documentation, so please have a quick look if you include it. But it was just a matter of copying text verbatim from the man page and applying a little bit of Texinfo markup. I went through the gzip -h output, the man page and the two command-line option listings in the info page. The only other thing which was out of sync was the useless --ascii option, so it's in quite good shape. /Jorgen -- // Jörgen Grahn | mot du jour: en ômma \X/ <[email protected]> |
diff -Naur gzip_1.3.12-9-orig/doc/gzip.texi gzip_1.3.12-9/doc/gzip.texi
--- gzip_1.3.12-9-orig/doc/gzip.texi 2007-02-06 00:29:04.000000000 +0100
+++ gzip_1.3.12-9/doc/gzip.texi 2011-08-14 08:55:25.000000000 +0200
@@ -204,6 +204,7 @@
-V, --version display version number
-1, --fast compress faster
-9, --best compress better
+ --rsyncable Make rsync-friendly archive
With no FILE, or when FILE is -, read standard input.
@@ -350,6 +351,14 @@
into the directory and compress all the files it finds there (or
decompress them in the case of @command{gunzip}).
+@item --rsyncable
+While compressing, synchronize the output occasionally based on
+the input. This increases size by less than 1 percent most
+cases, but means that the @command{rsync} program can much more efficiently
+synchronize files compressed with this flag. @command{gunzip}
+cannot tell the difference between a compressed file created
+with this option, and one created without it.
+
@item --suffix @var{suf}
@itemx -S @var{suf}
Use suffix @var{suf} instead of @samp{.gz}. Any suffix can be
signature.asc
Description: Digital signature
