Bug 151812

Summary: find man page missing stuff
Product: Documentation Reporter: Jay <jouellette>
Component: Books & ArticlesAssignee: Glen Barber <gjb>
Status: Closed FIXED    
Severity: Affects Only Me    
Priority: Normal    
Version: Latest   
Hardware: Any   
OS: Any   

Description Jay 2010-10-29 14:30:13 UTC
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
Comment 1 Glen Barber 2010-10-29 14:38:25 UTC
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
Comment 2 Glen Barber freebsd_committer freebsd_triage 2010-10-29 14:41:46 UTC
State Changed
From-To: open->feedback

Feedback requested. 



Comment 3 Glen Barber freebsd_committer freebsd_triage 2010-10-29 14:41:46 UTC
Responsible Changed
From-To: freebsd-doc->gjb

Feedback requested.
Comment 4 Glen Barber freebsd_committer freebsd_triage 2010-10-29 15:19:48 UTC
State Changed
From-To: feedback->analyzed

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.
Comment 5 dfilter service freebsd_committer freebsd_triage 2011-03-10 18:01:02 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"
Comment 6 Glen Barber freebsd_committer freebsd_triage 2011-03-10 18:01:10 UTC
State Changed
From-To: analyzed->patched

Patched in HEAD.  MFC in 1 week.
Comment 7 dfilter service freebsd_committer freebsd_triage 2011-03-17 22:35:42 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"
Comment 8 dfilter service freebsd_committer freebsd_triage 2011-03-17 22:36:29 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"
Comment 9 Glen Barber freebsd_committer freebsd_triage 2011-03-17 22:37:18 UTC
State Changed
From-To: patched->closed

MFC'd to stable/8 and stable/7.  Thanks!