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

[Anton Shterenlikht]

>Number:         173265
>Category:       docs
>Synopsis:       improving <a|c|m>min option description for find(1)
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Thu Nov 01 15:20:00 UTC 2012
>Closed-Date:
>Last-Modified:
>Originator:     Anton Shterenlikht
>Release:        FreeBSD 10.0-CURRENT ia64
>Organization:
University of Bristol
>Environment:
System: FreeBSD mech-cluster241.men.bris.ac.uk 10.0-CURRENT FreeBSD 10.0-CURRENT #6 r237134: Mon Jun 18 09:02:17 BST 2012 root at mech-cluster241.men.bris.ac.uk:/usr/obj/usr/src/sys/TZAV ia64


	
>Description:

find(1) man page has:

     -amin n
             True if the difference between the file last access time and the
             time find was started, rounded up to the next full minute, is n
             minutes.

     -cmin n
             True if the difference between the time of last change of file
             status information and the time find was started, rounded up to
             the next full minute, is n minutes.

     -mmin n
             True if the difference between the file last modification time
             and the time find was started, rounded up to the next full
             minute, is n minutes.

The description is not clear enough.
It is not clear that n can be +n, -n or
just n, and that the meaning will change.

In "UNIX in a nutshell" by Arnold Robbins, 4th edition, 2006,
pages 87-88, there is, in my opinion, a more clear description:

*quote*
-amin +n | -n | n
	Find files last accessed more than n (+n),
	less that n (-n), or exactly n minutes ago.

-cmin +n | -n | n
	Find files last changed more than n (+n),
	less that n (-n), or exactly n minutes ago.

-mmin +n | -n | n
	Find files last modified more than n (+n),
	less that n (-n), or exactly n minutes ago.
*end quote*

Does anybody agree/disagree with me?

	
>How-To-Repeat:
	
>Fix:

I'll provide a patch if there is agreement.

	
>Release-Note:
>Audit-Trail:
>Unformatted: