From owner-freebsd-doc@FreeBSD.ORG  Thu Feb  3 17:20:24 2005
Return-Path: <owner-freebsd-doc@FreeBSD.ORG>
Delivered-To: freebsd-doc@hub.freebsd.org
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id BA3BB16A4CE
	for <freebsd-doc@hub.freebsd.org>;
	Thu,  3 Feb 2005 17:20:24 +0000 (GMT)
Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21])
	by mx1.FreeBSD.org (Postfix) with ESMTP id 99DBA43D1F
	for <freebsd-doc@hub.freebsd.org>;
	Thu,  3 Feb 2005 17:20:24 +0000 (GMT)
	(envelope-from gnats@FreeBSD.org)
Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1])
	by freefall.freebsd.org (8.13.1/8.13.1) with ESMTP id j13HKOV1099441
	for <freebsd-doc@freefall.freebsd.org>; Thu, 3 Feb 2005 17:20:24 GMT
	(envelope-from gnats@freefall.freebsd.org)
Received: (from gnats@localhost)
	by freefall.freebsd.org (8.13.1/8.13.1/Submit) id j13HKOI8099440;
	Thu, 3 Feb 2005 17:20:24 GMT
	(envelope-from gnats)
Date: Thu, 3 Feb 2005 17:20:24 GMT
Message-Id: <200502031720.j13HKOI8099440@freefall.freebsd.org>
To: freebsd-doc@FreeBSD.org
From: Adrian Filipi <adrian@ubergeeks.com>
Subject: Re: docs/77024: typo/bad grammar in indent(1) manpage
X-BeenThere: freebsd-doc@freebsd.org
X-Mailman-Version: 2.1.1
Precedence: list
Reply-To: Adrian Filipi <adrian@ubergeeks.com>
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: Thu, 03 Feb 2005 17:20:24 -0000

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

From: Adrian Filipi <adrian@ubergeeks.com>
To: Giorgos Keramidas <keramida@freebsd.org>
Cc: bug-followup@freebsd.org
Subject: Re: docs/77024: typo/bad grammar in indent(1) manpage
Date: Thu, 3 Feb 2005 12:17:04 -0500 (EST)

  	Sounds good to me.  Better than the original.
 
  	Adrian
 -- 
 [ adrian@ubergeeks.com ]
 
 On Thu, 3 Feb 2005, Giorgos Keramidas wrote:
 
 > % --- indent.1.orig	Thu Feb  3 00:35:20 2005
 > % +++ indent.1	Thu Feb  3 00:36:37 2005
 > % @@ -534,7 +534,7 @@
 > %  .Pp
 > %  .Dl indent *.c
 > %  .Pp
 > % -to the shell in an attempt to indent all the
 > % +To the shell this is an attempt to indent all the
 > %  .Em C
 > %  programs in a directory.
 > % -This is probably a bug, not a feature.
 > % +It is probably a bug, not a feature.
 >
 > This shows too little context from the original manpage.  Reading both the
 > preceding paragraph and the one that follows the displayed material we see:
 >
 > %    A common mistake that often causes grief is typing:
 > %
 > %          indent *.c
 > %
 > %    to the shell in an attempt to indent all the C programs in a
 > %    directory.  This is probably a bug, not a feature.
 >
 > If you read both these paragraphs as one sentence, it probably
 > makes more sense.  I agree it looks a bit confusing though.
 >
 > We can probably rewrite this part as:
 >
 > %   A common mistake is to try to indent all the C programs in a
 > %   directory by typing:
 > %
 > %         indent *.c
 > %
 > %   This is probably a bug, not a feature.
 >