Date: Thu, 1 Nov 2012 15:10:50 GMT From: Anton Shterenlikht <mexas@bristol.ac.uk> To: FreeBSD-gnats-submit@FreeBSD.org Subject: docs/173265: improving <a|c|m>min option description for find(1) Message-ID: <201211011510.qA1FAo1u012210@mech-cluster241.men.bris.ac.uk> Resent-Message-ID: <201211011520.qA1FK0w1078300@freefall.freebsd.org>
next in thread | raw e-mail | index | archive | help
>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@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:
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201211011510.qA1FAo1u012210>