From owner-freebsd-doc@FreeBSD.ORG  Fri Oct 22 08:50:33 2004
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 AEE3216A4D2
	for <freebsd-doc@hub.freebsd.org>;
	Fri, 22 Oct 2004 08:50:33 +0000 (GMT)
Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21])
	by mx1.FreeBSD.org (Postfix) with ESMTP id 9CB3943D46
	for <freebsd-doc@hub.freebsd.org>;
	Fri, 22 Oct 2004 08:50:33 +0000 (GMT)
	(envelope-from gnats@FreeBSD.org)
Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1])
	by freefall.freebsd.org (8.12.11/8.12.11) with ESMTP id i9M8oXd7007612
	for <freebsd-doc@freefall.freebsd.org>; Fri, 22 Oct 2004 08:50:33 GMT
	(envelope-from gnats@freefall.freebsd.org)
Received: (from gnats@localhost)
	by freefall.freebsd.org (8.12.11/8.12.11/Submit) id i9M8oXkO007611;
	Fri, 22 Oct 2004 08:50:33 GMT
	(envelope-from gnats)
Date: Fri, 22 Oct 2004 08:50:33 GMT
Message-Id: <200410220850.i9M8oXkO007611@freefall.freebsd.org>
To: freebsd-doc@FreeBSD.org
From: Giorgos Keramidas <keramida@freebsd.org>
Subject: Re: docs/72985: `grep` man page typo/error for --line-buffering /
	--line-buffered option
X-BeenThere: freebsd-doc@freebsd.org
X-Mailman-Version: 2.1.1
Precedence: list
Reply-To: Giorgos Keramidas <keramida@freebsd.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: Fri, 22 Oct 2004 08:50:33 -0000

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

From: Giorgos Keramidas <keramida@freebsd.org>
To: John Engelhart <johne@zang.com>
Cc: freebsd-gnats-submit@freebsd.org
Subject: Re: docs/72985: `grep` man page typo/error for --line-buffering / --line-buffered option
Date: Fri, 22 Oct 2004 11:49:29 +0300

 On 2004-10-21 23:46, John Engelhart <johne@zang.com> wrote:
 > >Environment:
 > FreeBSD new.zang.com 5.3-BETA7 FreeBSD 5.3-BETA7 #0:\
 > Sun Oct 17 00:32:33 EDT 2004     \
 > johne@new.zang.com:/usr/src/sys/i386/compile/new  i386
 >
 > >Description:
 > The man page for the command grep has a typo/error in it.
 >
 > The option syntax for "line-buffered" output is specified in the man page as:
 >
 > --line-buffering
 >
 > Whereas the command itself takes (from grep --help, and checked by running)
 >
 >       --line-buffered       flush output on every line
 
 You are right.  Does the following change look ok?
 
 %%%
 Index: grep.1
 ===================================================================
 RCS file: /home/ncvs/src/gnu/usr.bin/grep/grep.1,v
 retrieving revision 1.25
 diff -u -u -r1.25 grep.1
 --- grep.1	4 Jul 2004 10:02:03 -0000	1.25
 +++ grep.1	22 Oct 2004 08:47:28 -0000
 @@ -312,8 +312,9 @@
  This is especially useful for tools like zgrep, e.g.
  .B "gzip -cd foo.gz |grep --label=foo something"
  .TP
 -.BR \-\^\-line-buffering
 -Use line buffering, it can be a performance penality.
 +.BR \-\^\-line-buffered
 +Flush output on every line.
 +Note that this incurs a performance penalty.
  .TP
  .BR \-q ", " \-\^\-quiet ", " \-\^\-silent
  Quiet; do not write anything to standard output.
 %%%