From nobody@FreeBSD.org  Fri Oct 29 13:29:13 2010
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 CF28E1065670
	for <freebsd-gnats-submit@FreeBSD.org>; Fri, 29 Oct 2010 13:29:13 +0000 (UTC)
	(envelope-from nobody@FreeBSD.org)
Received: from www.freebsd.org (www.freebsd.org [IPv6:2001:4f8:fff6::21])
	by mx1.freebsd.org (Postfix) with ESMTP id A37958FC0A
	for <freebsd-gnats-submit@FreeBSD.org>; Fri, 29 Oct 2010 13:29:13 +0000 (UTC)
Received: from www.freebsd.org (localhost [127.0.0.1])
	by www.freebsd.org (8.14.3/8.14.3) with ESMTP id o9TDTDTl089149
	for <freebsd-gnats-submit@FreeBSD.org>; Fri, 29 Oct 2010 13:29:13 GMT
	(envelope-from nobody@www.freebsd.org)
Received: (from nobody@localhost)
	by www.freebsd.org (8.14.3/8.14.3/Submit) id o9TDTDN1089146;
	Fri, 29 Oct 2010 13:29:13 GMT
	(envelope-from nobody)
Message-Id: <201010291329.o9TDTDN1089146@www.freebsd.org>
Date: Fri, 29 Oct 2010 13:29:13 GMT
From: Jay <jouellette@gmail.com>
To: freebsd-gnats-submit@FreeBSD.org
Subject: find man page missing stuff
X-Send-Pr-Version: www-3.1
X-GNATS-Notify:

>Number:         151812
>Category:       docs
>Synopsis:       find man page missing stuff
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    gjb
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Fri Oct 29 13:30:13 UTC 2010
>Closed-Date:    Thu Mar 17 22:37:39 UTC 2011
>Last-Modified:  Thu Mar 17 22:40:11 UTC 2011
>Originator:     Jay
>Release:        
>Organization:
NA
>Environment:
>Description:
The find command.

Putting a plus or minus sign in-front of a number can be used to indicate greater than or less than. eg.

find . -type f -size +4096c

finds all files greater than 4096 bytes.

This feature is missing from the man page.

>How-To-Repeat:
$ man find
>Fix:


>Release-Note:
>Audit-Trail:
State-Changed-From-To: open->feedback 
State-Changed-By: gjb 
State-Changed-When: Fri Oct 29 13:41:46 UTC 2010 
State-Changed-Why:  
Feedback requested. 



Responsible-Changed-From-To: freebsd-doc->gjb 
Responsible-Changed-By: gjb 
Responsible-Changed-When: Fri Oct 29 13:41:46 UTC 2010 
Responsible-Changed-Why:  
Feedback requested. 


http://www.freebsd.org/cgi/query-pr.cgi?pr=151812 
State-Changed-From-To: feedback->analyzed 
State-Changed-By: gjb 
State-Changed-When: Fri Oct 29 14:19:48 UTC 2010 
State-Changed-Why:  
Feedback received. 

I asked the submitter: 
I believe this is documented at the end of the PRIMARIES section: 

to which I received a response via private email: 
Yes. Your right. That is what I was looking for. Thanks. 
Most other man pages put it at the top. I guess its not a big deal, 
but people do have trouble finding it way down there. 

I'll take a look at moving this more toward the top of the section. 


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

From: Glen Barber <glen.j.barber@gmail.com>
To: Jay <jouellette@gmail.com>
Cc: freebsd-gnats-submit@FreeBSD.org
Subject: Re: docs/151812: find man page missing stuff
Date: Fri, 29 Oct 2010 09:38:25 -0400

 Hello Jay,
 
 On 10/29/10 9:29 AM, Jay wrote:
 >> Description:
 > The find command.
 > 
 > Putting a plus or minus sign in-front of a number can be used to indicate greater than or less than. eg.
 > 
 > find . -type f -size +4096c
 > 
 > finds all files greater than 4096 bytes.
 > 
 > This feature is missing from the man page.
 > 
 >> How-To-Repeat:
 > $ man find
 
 
 I believe this is documented at the end of the PRIMARIES section:
 
 All primaries which take a numeric argument allow the number to be pre-
 ceded by a plus sign (``+'') or a minus sign (``-'').  A preceding plus
 sign means ``more than n'', a preceding minus sign means ``less than n''
 and neither means ``exactly n''.
 
 Is this what you are referring to?
 
 -- 
 Glen Barber
State-Changed-From-To: analyzed->patched 
State-Changed-By: gjb 
State-Changed-When: Thu Mar 10 18:01:10 UTC 2011 
State-Changed-Why:  
Patched in HEAD.  MFC in 1 week. 


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

From: dfilter@FreeBSD.ORG (dfilter service)
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/151812: commit references a PR
Date: Thu, 10 Mar 2011 18:01:02 +0000 (UTC)

 Author: gjb (doc committer)
 Date: Thu Mar 10 18:00:47 2011
 New Revision: 219455
 URL: http://svn.freebsd.org/changeset/base/219455
 
 Log:
   Move the explanation of using arguments for the PRIMARIES above
   the list of PRIMARIES.
   
   PR:		151812
   Submitted by:	Jay (jouellette of gmail com)
   Patch by:	eadler
   MFC after:	1 week
 
 Modified:
   head/usr.bin/find/find.1
 
 Modified: head/usr.bin/find/find.1
 ==============================================================================
 --- head/usr.bin/find/find.1	Thu Mar 10 17:26:36 2011	(r219454)
 +++ head/usr.bin/find/find.1	Thu Mar 10 18:00:47 2011	(r219455)
 @@ -177,6 +177,18 @@ This option is equivalent to the depreca
  primary.
  .El
  .Sh PRIMARIES
 +.Pp
 +All primaries which take a numeric argument allow the number to be
 +preceded by a plus sign
 +.Pq Dq Li +
 +or a minus sign
 +.Pq Dq Li - .
 +A preceding plus sign means
 +.Dq more than n ,
 +a preceding minus sign means
 +.Dq less than n
 +and neither means
 +.Dq exactly n .
  .Bl -tag -width indent
  .It Ic -Bmin Ar n
  True if the difference between the time of a file's inode creation
 @@ -815,18 +827,6 @@ The same thing as 
  .Ic -path ,
  for GNU find compatibility.
  .El
 -.Pp
 -All primaries which take a numeric argument allow the number to be
 -preceded by a plus sign
 -.Pq Dq Li +
 -or a minus sign
 -.Pq Dq Li - .
 -A preceding plus sign means
 -.Dq more than n ,
 -a preceding minus sign means
 -.Dq less than n
 -and neither means
 -.Dq exactly n .
  .Sh OPERATORS
  The primaries may be combined using the following operators.
  The operators are listed in order of decreasing precedence.
 _______________________________________________
 svn-src-all@freebsd.org mailing list
 http://lists.freebsd.org/mailman/listinfo/svn-src-all
 To unsubscribe, send any mail to "svn-src-all-unsubscribe@freebsd.org"
 
State-Changed-From-To: patched->closed 
State-Changed-By: gjb 
State-Changed-When: Thu Mar 17 22:37:18 UTC 2011 
State-Changed-Why:  
MFC'd to stable/8 and stable/7.  Thanks! 


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

From: dfilter@FreeBSD.ORG (dfilter service)
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/151812: commit references a PR
Date: Thu, 17 Mar 2011 22:35:42 +0000 (UTC)

 Author: gjb (doc committer)
 Date: Thu Mar 17 22:35:29 2011
 New Revision: 219724
 URL: http://svn.freebsd.org/changeset/base/219724
 
 Log:
   MFC 219455:
   - Move the explanation of using arguments for the PRIMARIES above
     the list of PRIMARIES.
   
   PR:		151812
 
 Modified:
   stable/8/usr.bin/find/find.1
 Directory Properties:
   stable/8/usr.bin/find/   (props changed)
 
 Modified: stable/8/usr.bin/find/find.1
 ==============================================================================
 --- stable/8/usr.bin/find/find.1	Thu Mar 17 22:17:56 2011	(r219723)
 +++ stable/8/usr.bin/find/find.1	Thu Mar 17 22:35:29 2011	(r219724)
 @@ -181,6 +181,18 @@ This option is equivalent to the depreca
  primary.
  .El
  .Sh PRIMARIES
 +.Pp
 +All primaries which take a numeric argument allow the number to be
 +preceded by a plus sign
 +.Pq Dq Li +
 +or a minus sign
 +.Pq Dq Li - .
 +A preceding plus sign means
 +.Dq more than n ,
 +a preceding minus sign means
 +.Dq less than n
 +and neither means
 +.Dq exactly n .
  .Bl -tag -width indent
  .It Ic -Bmin Ar n
  True if the difference between the time of a file's inode creation
 @@ -822,18 +834,6 @@ The same thing as 
  .Ic -path ,
  for GNU find compatibility.
  .El
 -.Pp
 -All primaries which take a numeric argument allow the number to be
 -preceded by a plus sign
 -.Pq Dq Li +
 -or a minus sign
 -.Pq Dq Li - .
 -A preceding plus sign means
 -.Dq more than n ,
 -a preceding minus sign means
 -.Dq less than n
 -and neither means
 -.Dq exactly n .
  .Sh OPERATORS
  The primaries may be combined using the following operators.
  The operators are listed in order of decreasing precedence.
 _______________________________________________
 svn-src-all@freebsd.org mailing list
 http://lists.freebsd.org/mailman/listinfo/svn-src-all
 To unsubscribe, send any mail to "svn-src-all-unsubscribe@freebsd.org"
 

From: dfilter@FreeBSD.ORG (dfilter service)
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/151812: commit references a PR
Date: Thu, 17 Mar 2011 22:36:29 +0000 (UTC)

 Author: gjb (doc committer)
 Date: Thu Mar 17 22:36:21 2011
 New Revision: 219725
 URL: http://svn.freebsd.org/changeset/base/219725
 
 Log:
   MFC 219455:
   - Move the explanation of using arguments for the PRIMARIES above
     the list of PRIMARIES.
   
   PR:		151812
 
 Modified:
   stable/7/usr.bin/find/find.1
 Directory Properties:
   stable/7/usr.bin/find/   (props changed)
 
 Modified: stable/7/usr.bin/find/find.1
 ==============================================================================
 --- stable/7/usr.bin/find/find.1	Thu Mar 17 22:35:29 2011	(r219724)
 +++ stable/7/usr.bin/find/find.1	Thu Mar 17 22:36:21 2011	(r219725)
 @@ -181,6 +181,18 @@ This option is equivalent to the depreca
  primary.
  .El
  .Sh PRIMARIES
 +.Pp
 +All primaries which take a numeric argument allow the number to be
 +preceded by a plus sign
 +.Pq Dq Li +
 +or a minus sign
 +.Pq Dq Li - .
 +A preceding plus sign means
 +.Dq more than n ,
 +a preceding minus sign means
 +.Dq less than n
 +and neither means
 +.Dq exactly n .
  .Bl -tag -width indent
  .It Ic -Bmin Ar n
  True if the difference between the time of a file's inode creation
 @@ -749,18 +761,6 @@ is numeric and there is no such user nam
  .Ar uname
  is treated as a user ID.
  .El
 -.Pp
 -All primaries which take a numeric argument allow the number to be
 -preceded by a plus sign
 -.Pq Dq Li +
 -or a minus sign
 -.Pq Dq Li - .
 -A preceding plus sign means
 -.Dq more than n ,
 -a preceding minus sign means
 -.Dq less than n
 -and neither means
 -.Dq exactly n .
  .Sh OPERATORS
  The primaries may be combined using the following operators.
  The operators are listed in order of decreasing precedence.
 _______________________________________________
 svn-src-all@freebsd.org mailing list
 http://lists.freebsd.org/mailman/listinfo/svn-src-all
 To unsubscribe, send any mail to "svn-src-all-unsubscribe@freebsd.org"
 
>Unformatted:
