From 7728467c086b0288a206a3075b7e0c95ea19801b Mon Sep 17 00:00:00 2001
From: Bernhard Voelker <mail@bernhard-voelker.de>
Date: Sat, 19 Oct 2019 18:30:49 +0200
Subject: [PATCH] doc: enhance description of tests accepting numeric arguments
 in find.1

find/find.1 (TESTS): Improve the description of tests accepting a numeric
argument that they match "less than, more than or exactly" the given 'n',
thus helping the user to remind to use '-n', '+n' or a bare 'n' (as
decribed at the top).

Suggested in https://sv.gnu.org/bugs/?57025 .
---
 find/find.1 | 44 ++++++++++++++++++++++++++++++--------------
 1 file changed, 30 insertions(+), 14 deletions(-)

diff --git a/find/find.1 b/find/find.1
index 20a1c109..b15a134f 100644
--- a/find/find.1
+++ b/find/find.1
@@ -593,7 +593,17 @@ system call fails for it), an error message is issued, and
 .B find
 exits with a nonzero status.
 .P
-Numeric arguments can be specified as
+A numeric argument \fIn\fR can be specified to tests (like
+.BR \-amin ,
+.BR \-mtime ,
+.BR \-gid ,
+.BR \-inum ,
+.BR \-links ,
+.BR \-size ,
+.BR \-uid
+and
+.BR \-used )
+as
 .IP \fI+n\fP
 for greater than
 .IR n ,
@@ -605,8 +615,11 @@ for exactly
 .IR n .
 .P
 
+Supported tests:
+.P
+
 .IP "\-amin \fIn\fR"
-File was last accessed \fIn\fR minutes ago.
+File was last accessed less than, more than or exactly \fIn\fR minutes ago.
 
 .IP "\-anewer \fIreference\fR"
 Time of the last access of the current file is more recent than that
@@ -619,7 +632,7 @@ option is in effect, then the time of the last data modification of the file
 it points to is always used.
 
 .IP "\-atime \fIn\fR"
-File was last accessed
+File was last accessed less than, more than or exactly
 .IR n *24
 hours ago.
 When find figures out how many 24-hour periods ago the file
@@ -631,7 +644,8 @@ a file has to have been accessed at least
 days ago.
 
 .IP "\-cmin \fIn\fR"
-File's status was last changed \fIn\fR minutes ago.
+File's status was last changed less than, more than or exactly \fIn\fR minutes
+ago.
 
 .IP "\-cnewer \fIreference\fR"
 Time of the last status change of the current file is more recent than that
@@ -644,7 +658,7 @@ option is in effect, then the time of the last data modification of the file
 it points to is always used.
 
 .IP "\-ctime \fIn\fR"
-File's status was last changed
+File's status was last changed less than, more than or exactly
 .IR n *24
 hours ago.
 See the comments for
@@ -687,7 +701,7 @@ is: ufs, 4.2, 4.3, nfs, tmp, mfs, S51K, S52K.  You can use
 with the %F directive to see the types of your filesystems.
 
 .IP "\-gid \fIn\fR"
-File's numeric group ID is
+File's numeric group ID is less than, more than or exactly
 .IR n .
 
 .IP "\-group \fIgname\fR"
@@ -714,7 +728,7 @@ patterns `fo*' and `F??' match the file names `Foo', `FOO', `foo',
 The pattern `*foo*` will also match a file called '.foobar'.
 
 .IP "\-inum \fIn\fR"
-File has inode number
+File has inode number smaller than, greater than or exactly
 .IR n .
 It is normally easier to use the
 .B \-samefile
@@ -735,7 +749,7 @@ See \-ipath.  This alternative is less portable than
 .BR \-ipath .
 
 .IP "\-links \fIn\fR"
-File has \fIn\fR hard links.
+File has less than, more than or exactly \fIn\fR hard links.
 
 .IP "\-lname \fIpattern\fR"
 File is a symbolic link whose contents match shell pattern
@@ -749,10 +763,11 @@ option is in effect, this test returns false unless the symbolic link
 is broken.
 
 .IP "\-mmin \fIn\fR"
-File's data was last modified \fIn\fR minutes ago.
+File's data was last modified less than, more than or exactly \fIn\fR minutes
+ago.
 
 .IP "\-mtime \fIn\fR"
-File's data was last modified
+File's data was last modified less than, more than or exactly
 .IR n *24
 hours ago.
 See the comments for
@@ -954,8 +969,8 @@ When
 is in effect, this can include symbolic links.
 
 .IP "\-size \fIn\fR[cwbkMG]"
-File uses \fIn\fP units of space, rounding up.  The following suffixes
-can be used:
+File uses less than, more than or exactly \fIn\fP units of space, rounding up.
+The following suffixes can be used:
 .RS
 .IP `b'
 for 512-byte blocks (this is the default if no suffix is used)
@@ -1028,11 +1043,12 @@ door (Solaris)
 To search for more than one type at once, you can supply the combined list of
 type letters separated by a comma `,' (GNU extension).
 .IP "\-uid \fIn\fR"
-File's numeric user ID is
+File's numeric user ID is less than, more than or exactly
 .IR n .
 
 .IP "\-used \fIn\fR"
-File was last accessed \fIn\fR days after its status was last changed.
+File was last accessed less than, more than or exactly \fIn\fR days after its
+status was last changed.
 
 .IP "\-user \fIuname\fR"
 File is owned by user \fIuname\fR (numeric user ID allowed).
-- 
2.23.0

