From owner-freebsd-doc@FreeBSD.ORG  Sun Apr 27 23:30:07 2008
Return-Path: <owner-freebsd-doc@FreeBSD.ORG>
Delivered-To: freebsd-doc@hub.freebsd.org
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34])
	by hub.freebsd.org (Postfix) with ESMTP id 789DD106564A
	for <freebsd-doc@hub.freebsd.org>; Sun, 27 Apr 2008 23:30:07 +0000 (UTC)
	(envelope-from gnats@FreeBSD.org)
Received: from freefall.freebsd.org (freefall.freebsd.org
	[IPv6:2001:4f8:fff6::28])
	by mx1.freebsd.org (Postfix) with ESMTP id 5F92D8FC0C
	for <freebsd-doc@hub.freebsd.org>; Sun, 27 Apr 2008 23:30:07 +0000 (UTC)
	(envelope-from gnats@FreeBSD.org)
Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1])
	by freefall.freebsd.org (8.14.2/8.14.2) with ESMTP id m3RNU78f088592
	for <freebsd-doc@freefall.freebsd.org>; Sun, 27 Apr 2008 23:30:07 GMT
	(envelope-from gnats@freefall.freebsd.org)
Received: (from gnats@localhost)
	by freefall.freebsd.org (8.14.2/8.14.1/Submit) id m3RNU7kO088587;
	Sun, 27 Apr 2008 23:30:07 GMT (envelope-from gnats)
Date: Sun, 27 Apr 2008 23:30:07 GMT
Message-Id: <200804272330.m3RNU7kO088587@freefall.freebsd.org>
To: freebsd-doc@FreeBSD.org
From: "A. Hamilton-Wright" <andrew@qemg.org>
Cc: 
Subject: Re: docs/123010: Misleading Documentation in gzip(1)
X-BeenThere: freebsd-doc@freebsd.org
X-Mailman-Version: 2.1.5
Precedence: list
Reply-To: "A. Hamilton-Wright" <andrew@qemg.org>
List-Id: Documentation project <freebsd-doc.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
	<mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc>
List-Post: <mailto:freebsd-doc@freebsd.org>
List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
	<mailto:freebsd-doc-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Sun, 27 Apr 2008 23:30:07 -0000

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

From: "A. Hamilton-Wright" <andrew@qemg.org>
To: bug-followup@FreeBSD.org
Cc: "A. Hamilton-Wright" <andrew@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