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:17:27 -0300 (ADT)

 Suggested modification to source of /usr/share/man/man1/gzip.1.gz
 below:
 
 
 --- gzip.1.old	2008-04-27 20:08:23.000000000 -0300
 +++ gzip.1.new	2008-04-27 20:13:54.000000000 -0300
 @@ -72,10 +72,17 @@
   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 file argument must contain a separate complete archive;
 +when multiple 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