From owner-freebsd-doc@FreeBSD.ORG Fri Nov 2 12:50:02 2012 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52]) by hub.freebsd.org (Postfix) with ESMTP id 09966A84 for ; Fri, 2 Nov 2012 12:50:02 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:1900:2254:206c::16:87]) by mx1.freebsd.org (Postfix) with ESMTP id C97308FC0A for ; Fri, 2 Nov 2012 12:50:01 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.5/8.14.5) with ESMTP id qA2Co1IZ017965 for ; Fri, 2 Nov 2012 12:50:01 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.5/8.14.5/Submit) id qA2Co16o017959; Fri, 2 Nov 2012 12:50:01 GMT (envelope-from gnats) Date: Fri, 2 Nov 2012 12:50:01 GMT Message-Id: <201211021250.qA2Co16o017959@freefall.freebsd.org> To: freebsd-doc@FreeBSD.org Cc: From: Anton Shterenlikht Subject: RE: docs/173265: improving min option description for find(1) X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list Reply-To: Anton Shterenlikht List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 02 Nov 2012 12:50:02 -0000 The following reply was made to PR docs/173265; it has been noted by GNATS. From: Anton Shterenlikht To: bug-followup@freebsd.org Cc: Subject: RE: docs/173265: improving 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 .