GNU bug report logs - #46730
man page says program can deal with .zip

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 46730 in the body.
You can then email your comments to 46730 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: 積丹尼 Dan Jacobson <jidanni <at> jidanni.org>
To: bug-gzip <at> gnu.org
Subject: man page says program can deal with .zip
Date: Tue, 23 Feb 2021 18:45:40 +0800

Man page says

       Files created by zip can be uncompressed by gzip only if  they  have  a
       single  member  compressed with the 'deflation' method. This feature is
       only intended to help conversion of tar.zip files to the tar.gz format.
       To  extract  a zip file with a single member, use a command like gunzip
       <foo.zip or gunzip -S .zip foo.zip.  To extract zip files with  several
       members, use unzip instead of gunzip.

$ touch /tmp/e.zip
$ gunzip /tmp/e.zip
gzip: /tmp/e.zip: unknown suffix -- ignored
$ touch /tmp/e.tar.zip
$ gunzip /tmp/e.tar.zip
gzip: /tmp/e.tar.zip: unknown suffix -- ignored
$ touch /tmp/x.gz
$ gunzip /tmp/x.gz
gzip: /tmp/x.gz: unexpected end of file #Good. At least suffix is recognized
$ gunzip --version
gunzip (gzip) 1.10

So we see *.zip can't be dealt with at all.
So the man page should say that instead.

Yes maybe other parts of the documentation say something else, but I'm
just talking about the man page.

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

From: Paul Eggert <eggert <at> cs.ucla.edu>
To: 積丹尼 Dan Jacobson <jidanni <at> jidanni.org>
Cc: 46730 <at> debbugs.gnu.org
Subject: Re: bug#46730: man page says program can deal with .zip
Date: Tue, 23 Feb 2021 17:35:11 -0800

On 2/23/21 2:45 AM, 積丹尼 Dan Jacobson wrote:
>         To  extract  a zip file with a single member, use a command like gunzip
>         <foo.zip or gunzip -S .zip foo.zip....

> $ touch /tmp/e.zip
> $ gunzip /tmp/e.zip
> gzip: /tmp/e.zip: unknown suffix -- ignored

You didn't follow the instructions that you quoted.

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

From: 積丹尼 Dan Jacobson <jidanni <at> jidanni.org>
To: Paul Eggert <eggert <at> cs.ucla.edu>
Cc: 46730 <at> debbugs.gnu.org
Subject: Re: bug#46730: man page says program can deal with .zip
Date: Wed, 24 Feb 2021 10:35:16 +0800

PE> You didn't follow the instructions that you quoted.

Oh, so
       To  extract  a zip file with a single member, use a command like gunzip
       <foo.zip or gunzip -S .zip foo.zip.  To extract zip files with  several
       members, use unzip instead of gunzip.

should be

       To  extract  a zip file with a single member, use a command like
       $ gunzip < foo.zip
       or
       $ gunzip -S .zip foo.zip.

As the
<arrow glued to text at the beginning of a line
is treated by the eyeball as part of some
<long running example that probably has a matching> but you never know.

Or as some groff formatting mess.

Anyway please make the arrow more easy to be sure about.

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

From: Paul Eggert <eggert <at> cs.ucla.edu>
To: 積丹尼 Dan Jacobson <jidanni <at> jidanni.org>
Cc: 46730 <at> debbugs.gnu.org
Subject: Re: bug#46730: man page says program can deal with .zip
Date: Fri, 26 Feb 2021 13:35:27 -0800

[Message part 1 (text/plain, inline)]

On 2/23/21 6:35 PM, 積丹尼 Dan Jacobson wrote:
> Or as some groff formatting mess.

Thanks, I added some quotes to try to clarify things, as per attached.

[0001-gzip.1-Quote-better-Bug-46730.patch (text/x-patch, attachment)]

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

From: 積丹尼 Dan Jacobson <jidanni <at> jidanni.org>
To: Paul Eggert <eggert <at> cs.ucla.edu>
Cc: 46730 <at> debbugs.gnu.org
Subject: Re: bug#46730: man page says program can deal with .zip
Date: Sat, 27 Feb 2021 18:48:26 +0800

Thanks, however saying

gunzip <foo.zip

or even

gunzip< foo.zip

instead of

gunzip<foo.zip

or (best):

gunzip < foo.zip

makes one think something funny is going on and we are looking at some
HTML artifact etc.

Previous Next

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