docs/173265: improving <a|c|m>min option description for find(1)

[Anton Shterenlikht]

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

From: Anton Shterenlikht <mexas at bristol.ac.uk>
To: bug-followup at freebsd.org
Cc:  
Subject: RE: docs/173265: improving <a|c|m>min option description for find(1)
Date: Fri, 2 Nov 2012 12:41:10 GMT

 See the patch below.
 It seems the find(1) man page
 favours arguments of the form -cmin [-|+]n
 over -cmin -n | +n | n.
 So I made my patch accordingly.
 With the patch the page now renders as:
 
      -amin [-|+]n
              Find files last accessed more than n (+n), less than n (-n), or
              exactly n minutes ago.
      -cmin [-|+]n
              Find files last changed more than n (+n), less than n (-n), or
              exactly n minutes ago.
      -mmin [-|+]n
              Find files last modified more than n (+n), less than n (-n), or
              exactly n minutes ago.
 
 Anton
 
  
 Index: usr.bin/find/find.1
 ===================================================================
 --- usr.bin/find/find.1	(revision 238585)
 +++ usr.bin/find/find.1	(working copy)
 @@ -203,12 +203,16 @@
  See
  .Xr acl 3
  for more information.
 -.It Ic -amin Ar n
 -True if the difference between the file last access time and the time
 -.Nm
 -was started, rounded up to the next full minute, is
 +.It Ic -amin Oo Cm - Ns | Ns Cm + Oc Ns Ar n
 +Find files last accessed more than
  .Ar n
 -minutes.
 +.Pq + Ns Ar n ,
 +less than
 +.Ar n
 +.Pq - Ns Ar n ,
 +or exactly
 +.Ar n
 +minutes ago.
  .It Ic -anewer Ar file
  Same as
  .Ic -neweram .
 @@ -250,13 +254,16 @@
  or
  .Cm -
  modifier.
 -.It Ic -cmin Ar n
 -True if the difference between the time of last change of file status
 -information and the time
 -.Nm
 -was started, rounded up to the next full minute, is
 +.It Ic -cmin Oo Cm - Ns | Ns Cm + Oc Ns Ar n
 +Find files last changed more than
  .Ar n
 -minutes.
 +.Pq + Ns Ar n ,
 +less than
 +.Ar n
 +.Pq - Ns Ar n ,
 +or exactly
 +.Ar n
 +minutes ago.
  .It Ic -cnewer Ar file
  Same as
  .Ic -newercm .
 @@ -538,12 +545,16 @@
  not normally be evaluated.
  .Dq Ic -mindepth Li 1
  processes all but the command line arguments.
 -.It Ic -mmin Ar n
 -True if the difference between the file last modification time and the time
 -.Nm
 -was started, rounded up to the next full minute, is
 +.It Ic -mmin Oo Cm - Ns | Ns Cm + Oc Ns Ar n
 +Find files last modified more than
  .Ar n
 -minutes.
 +.Pq + Ns Ar n ,
 +less than
 +.Ar n
 +.Pq - Ns Ar n ,
 +or exactly
 +.Ar n
 +minutes ago.
  .It Ic -mnewer Ar file
  Same as
  .Ic -newer .