From 1818209f5c4879522d69a09bedb0553543d6889e Mon Sep 17 00:00:00 2001
From: Bdale Garbee <bdale@gag.com>
Date: Thu, 12 Apr 2012 22:41:31 -0600
Subject: [PATCH] patch for zdiff man page

---
 debian/changelog              |  1 +
 debian/patches/series         |  1 +
 debian/patches/zdiff-man.diff | 43 +++++++++++++++++++++++++++++++++++
 zdiff.1                       | 18 +++++++++++----
 4 files changed, 58 insertions(+), 5 deletions(-)
 create mode 100644 debian/patches/zdiff-man.diff

diff --git a/debian/changelog b/debian/changelog
index 7d35092..efc68ca 100644
--- a/debian/changelog
+++ b/debian/changelog
@@ -5,6 +5,7 @@ gzip (1.4-6) unstable; urgency=low
     closes: #308522
   * patch to add --rsyncable doc to info page from Jörgen Grahn,
     closes: #637626
+  * patch to improve zdiff doc from Stéphane Aulery, closes: #269612
 
  -- Bdale Garbee <bdale@gag.com>  Thu, 12 Apr 2012 11:38:56 -0600
 
diff --git a/debian/patches/series b/debian/patches/series
index 51c69c0..ac59100 100644
--- a/debian/patches/series
+++ b/debian/patches/series
@@ -5,3 +5,4 @@ sys_stat.in.h.diff
 determinism.diff
 zgrep-dash-h.diff
 gzip-man-pack.diff
+zdiff-man.diff
diff --git a/debian/patches/zdiff-man.diff b/debian/patches/zdiff-man.diff
new file mode 100644
index 0000000..b402473
--- /dev/null
+++ b/debian/patches/zdiff-man.diff
@@ -0,0 +1,43 @@
+diff --git a/zdiff.1 b/zdiff.1
+index 588974c..3a586a2 100644
+--- a/zdiff.1
++++ b/zdiff.1
+@@ -10,6 +10,7 @@ zcmp, zdiff \- compare compressed files
+ [ diff_options ] file1
+ [ file2 ]
+ .SH DESCRIPTION
++.P
+ .I  Zcmp
+ and
+ .I zdiff
+@@ -23,11 +24,11 @@ All options specified are passed directly to
+ .I cmp
+ or
+ .IR diff "."
+-If only 1 file is specified, then the files compared are
+-.I file1
+-and an uncompressed
+-.IR file1 ".gz."
+-If two files are specified, then they are uncompressed if necessary and fed to
++If only one file is specified, then it is compared to a file with the same name
++without the
++.I ".gz"
++extension. If two files are specified, then they are uncompressed if necessary
++and fed to
+ .I cmp
+ or
+ .IR diff "."
+@@ -36,6 +37,13 @@ The exit status from
+ or
+ .I diff
+ is preserved.
++.P
++When both files must be uncompressed before comparison, the second is
++uncompressed to
++.IR "/tmp" "."
++In all other cases,
++.IR "zdiff" " and " "zcmp"
++use only a pipe.
+ .SH "SEE ALSO"
+ cmp(1), diff(1), zmore(1), zgrep(1), znew(1), zforce(1), gzip(1), gzexe(1)
+ .SH BUGS
diff --git a/zdiff.1 b/zdiff.1
index 588974c..3a586a2 100644
--- a/zdiff.1
+++ b/zdiff.1
@@ -10,6 +10,7 @@ zcmp, zdiff \- compare compressed files
 [ diff_options ] file1
 [ file2 ]
 .SH DESCRIPTION
+.P
 .I  Zcmp
 and
 .I zdiff
@@ -23,11 +24,11 @@ All options specified are passed directly to
 .I cmp
 or
 .IR diff "."
-If only 1 file is specified, then the files compared are
-.I file1
-and an uncompressed
-.IR file1 ".gz."
-If two files are specified, then they are uncompressed if necessary and fed to
+If only one file is specified, then it is compared to a file with the same name
+without the
+.I ".gz"
+extension. If two files are specified, then they are uncompressed if necessary
+and fed to
 .I cmp
 or
 .IR diff "."
@@ -36,6 +37,13 @@ The exit status from
 or
 .I diff
 is preserved.
+.P
+When both files must be uncompressed before comparison, the second is
+uncompressed to
+.IR "/tmp" "."
+In all other cases,
+.IR "zdiff" " and " "zcmp"
+use only a pipe.
 .SH "SEE ALSO"
 cmp(1), diff(1), zmore(1), zgrep(1), znew(1), zforce(1), gzip(1), gzexe(1)
 .SH BUGS
-- 
2.30.2