From nobody@FreeBSD.org  Fri Aug 31 10:09:39 2012
Return-Path: <nobody@FreeBSD.org>
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34])
	by hub.freebsd.org (Postfix) with ESMTP id 3AE601065676
	for <freebsd-gnats-submit@FreeBSD.org>; Fri, 31 Aug 2012 10:09:39 +0000 (UTC)
	(envelope-from nobody@FreeBSD.org)
Received: from red.freebsd.org (red.freebsd.org [IPv6:2001:4f8:fff6::22])
	by mx1.freebsd.org (Postfix) with ESMTP id 0D2B78FC17
	for <freebsd-gnats-submit@FreeBSD.org>; Fri, 31 Aug 2012 10:09:39 +0000 (UTC)
Received: from red.freebsd.org (localhost [127.0.0.1])
	by red.freebsd.org (8.14.4/8.14.4) with ESMTP id q7VA9cLX021720
	for <freebsd-gnats-submit@FreeBSD.org>; Fri, 31 Aug 2012 10:09:38 GMT
	(envelope-from nobody@red.freebsd.org)
Received: (from nobody@localhost)
	by red.freebsd.org (8.14.4/8.14.4/Submit) id q7VA9c9Y021719;
	Fri, 31 Aug 2012 10:09:38 GMT
	(envelope-from nobody)
Message-Id: <201208311009.q7VA9c9Y021719@red.freebsd.org>
Date: Fri, 31 Aug 2012 10:09:38 GMT
From: deeptech71 <deeptech71@gmail.com>
To: freebsd-gnats-submit@FreeBSD.org
Subject: the bsdgrep(1) man page should document -u
X-Send-Pr-Version: www-3.1
X-GNATS-Notify: dt71@gmx.com

>Number:         171200
>Category:       docs
>Synopsis:       the bsdgrep(1) man page should document -u
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    issyl0
>State:          feedback
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          sw-bug
>Submitter-Id:   current-users
>Arrival-Date:   Fri Aug 31 10:10:05 UTC 2012
>Closed-Date:    
>Last-Modified:  Mon Dec 30 03:59:15 UTC 2013
>Originator:     deeptech71
>Release:        -CURRENT
>Organization:
>Environment:
FreeBSD  10.0-CURRENT FreeBSD 10.0-CURRENT #0 r239919M: Fri Aug 31 05:52:42 CEST 2012     root@:/usr/obj/usr/src/sys/HQ  i386

>Description:
bsdgrep(1) silently ignores the -u flag. This is worth mentioning in the man page.
>How-To-Repeat:

>Fix:
Add, for example:

    -u
            This option has no effect, and is provided only for compatibility with GNU grep.

>Release-Note:
>Audit-Trail:
Responsible-Changed-From-To: freebsd-bugs->freebsd-doc 
Responsible-Changed-By: linimon 
Responsible-Changed-When: Fri Aug 31 13:15:30 UTC 2012 
Responsible-Changed-Why:  
reclassify. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=171200 
State-Changed-From-To: open->	 feedback  
State-Changed-By: issyl0 
State-Changed-When: Sat Sep 15 12:48:30 UTC 2012 
State-Changed-Why:  
Hi, 

The bsdgrep(1) man page already says: 

"Historic versions of the grep utility also supported the flags [-ruy]. 
This implementation supports those options; however, their use is 
strongly discouraged." 

which appears to address your concern.  Are you happy for this to be closed? 

Thanks, 

Isabell. 


Responsible-Changed-From-To: freebsd-doc->issyl0 
Responsible-Changed-By: issyl0 
Responsible-Changed-When: Sat Sep 15 12:48:30 UTC 2012 
Responsible-Changed-Why:  
I'll deal with this one. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=171200 

From: deeptech71@gmail.com
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/171200: the bsdgrep(1) man page should document -u
Date: Tue, 25 Sep 2012 18:07:59 +0200

 Some things:
 - Since when is -r (aka. --recursive) obsolete?????
 - The man page explicitly mentions the -r and the -y flags (in addition to mentioning them in the history paragraph), and describes what they do. Following this practice, -u should also be explicitly described.
 - The whole history paragraph should be removed after adding an explicit descripion for -u. If that is not going to be done, then:
 - I recommend replacing "-ruy" with "-r, -u, and -y", to allow man page readers to find the "-u" text.
 - I repeat: I find it surprizing that -r is obsolete, since I've been using that option ever since day 1. The bsdgrep man page doesn't mention the obsoleteness of -r directly. The gnugrep man page doesn't even say anything about the obsoleteness of -r.
>Unformatted:
