Package: gzip
Version: 1.5-1.1
Severity: minor
Tags: patch

Dear Maintainer,

A long time ago, #289616 added documentation for the --rsyncable option
in the gzip(1) manpage.

For some reason, the patch is no longer part of
debian/patches/rsyncable.diff and therefore doesn't appear in the manpage.

Appending the attached patch to debian/patches/rsyncable.diff should fix the
problem.

$ apt-cache policy gzip
gzip:
  Installed: 1.5-1.1
  Candidate: 1.5-1.1
  Version table:
 *** 1.5-1.1 0
        700 http://http.debian.net/debian/ testing/main amd64 Packages
        300 http://http.debian.net/debian/ unstable/main amd64 Packages
        100 /var/lib/dpkg/status
     1.3.12-9 0
        500 http://http.debian.net/debian/ stable/main amd64 Packages

$ debsums gzip | grep gzip.1.gz
/usr/share/man/man1/gzip.1.gz                                                 OK

$ zgrep -c rsync /usr/share/man/man1/gzip.1.gz
0

Thanks !

-- System Information:
Debian Release: wheezy/sid
  APT prefers testing
  APT policy: (700, 'testing'), (500, 'testing-proposed-updates'), (500, 
'stable'), (300, 'unstable'), (100, 'experimental')
Architecture: amd64 (x86_64)

Kernel: Linux 3.2.0-3-amd64 (SMP w/4 CPU cores)
Locale: LANG=en_US.UTF-8, LC_CTYPE=en_US.UTF-8 (charmap=UTF-8)
Shell: /bin/sh linked to /bin/dash

Versions of packages gzip depends on:
ii  dpkg          1.16.8
ii  install-info  4.13a.dfsg.1-10
ii  libc6         2.13-35

gzip recommends no packages.

Versions of packages gzip suggests:
ii  less  444-4

-- no debconf information
--- gzip.1.orig	2012-09-21 11:35:29.381116294 +0200
+++ gzip.1	2012-09-21 11:37:06.610287168 +0200
@@ -13,6 +13,7 @@
 .br
 .B gunzip
 .RB [ " \-acfhlLnNrtvV " ]
+.RB [ --rsyncable ]
 .RB [ \-S\ suffix ]
 [
 .I "name \&..."
@@ -290,6 +291,16 @@
 .I gunzip
 ).
 .TP
+.B --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
+.BR rsync (1)
+program can take advantage of similarities in the uncompressed input
+when syncronizing two files compressed with this flag.
+.I gunzip
+cannot tell the difference between a compressed file created with this option,
+and one created without it.
+.TP
 .B \-S .suf   --suffix .suf
 When compressing, use suffix .suf instead of .gz.
 Any non-empty suffix can be given, but suffixes

Reply via email to