docs/123010: Misleading Documentation in gzip(1)

[A. Hamilton-Wright]

The following reply was made to PR docs/123010; it has been noted by GNATS.

From: "A. Hamilton-Wright" <andrew at qemg.org>
To: bug-followup at FreeBSD.org
Cc: "A. Hamilton-Wright" <andrew at qemg.org>
Subject: Re: docs/123010: Misleading Documentation in gzip(1)
Date: Sun, 27 Apr 2008 20:28:26 -0300 (ADT)

 On Sun, 27 Apr 2008, A. Hamilton-Wright wrote:
 
 > Suggested modification to source of /usr/share/man/man1/gzip.1.gz
 > below:
 
 I just noticed that I hadn't flagged "file" as per the argument
 notation.  Updated patch:
 
 
 --- gzip.1.old	2008-04-27 20:08:23.000000000 -0300
 +++ gzip.1.new	2008-04-27 20:26:30.000000000 -0300
 @@ -72,10 +72,21 @@
   will be replaced with another file with the suffix, set by the
   .Fl S Ar suffix
   option, added, if possible.
 +.Pp
   In decompression mode, each
   .Ar file
   will be checked for existence, as will the file with the suffix
   added.
 +Each
 +.Ar file
 +argument must contain a separate complete archive;
 +when multiple
 +.Ar files
 +are indicated, each is decompressed in turn.
 +In the case of
 +.Nm gzcat
 +the resulting data is then concatenated in the manner of
 +.Xr cat 1 .
   .Pp
   If invoked as
   .Nm gunzip