From owner-freebsd-doc@FreeBSD.ORG Thu Nov 1 15:20:01 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 32107566 for ; Thu, 1 Nov 2012 15:20:01 +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 EF5808FC0A for ; Thu, 1 Nov 2012 15:20:00 +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 qA1FK0eV078301 for ; Thu, 1 Nov 2012 15:20:00 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.5/8.14.5/Submit) id qA1FK0w1078300; Thu, 1 Nov 2012 15:20:00 GMT (envelope-from gnats) Resent-Date: Thu, 1 Nov 2012 15:20:00 GMT Resent-Message-Id: <201211011520.qA1FK0w1078300@freefall.freebsd.org> Resent-From: FreeBSD-gnats-submit@FreeBSD.org (GNATS Filer) Resent-To: freebsd-doc@FreeBSD.org Resent-Reply-To: FreeBSD-gnats-submit@FreeBSD.org, Anton Shterenlikht Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52]) by hub.freebsd.org (Postfix) with ESMTP id CA1C4282 for ; Thu, 1 Nov 2012 15:10:56 +0000 (UTC) (envelope-from mexas@bristol.ac.uk) Received: from dirg.bris.ac.uk (dirg.bris.ac.uk [137.222.10.102]) by mx1.freebsd.org (Postfix) with ESMTP id 7F4E58FC15 for ; Thu, 1 Nov 2012 15:10:56 +0000 (UTC) Received: from irix.bris.ac.uk ([137.222.10.39] helo=ncs.bris.ac.uk) by dirg.bris.ac.uk with esmtp (Exim 4.72) (envelope-from ) id 1TTwPz-0007ES-LI for FreeBSD-gnats-submit@freebsd.org; Thu, 01 Nov 2012 15:10:54 +0000 Received: from mech-cluster241.men.bris.ac.uk ([137.222.187.241]) by ncs.bris.ac.uk with esmtpsa (TLSv1:AES256-SHA:256) (Exim 4.72) (envelope-from ) id 1TTwPz-0002jC-G9 for FreeBSD-gnats-submit@freebsd.org; Thu, 01 Nov 2012 15:10:51 +0000 Received: from mech-cluster241.men.bris.ac.uk (localhost [127.0.0.1]) by mech-cluster241.men.bris.ac.uk (8.14.5/8.14.5) with ESMTP id qA1FApMC012211 for ; Thu, 1 Nov 2012 15:10:51 GMT (envelope-from mexas@mech-cluster241.men.bris.ac.uk) Received: (from mexas@localhost) by mech-cluster241.men.bris.ac.uk (8.14.5/8.14.5/Submit) id qA1FAo1u012210; Thu, 1 Nov 2012 15:10:50 GMT (envelope-from mexas) Message-Id: <201211011510.qA1FAo1u012210@mech-cluster241.men.bris.ac.uk> Date: Thu, 1 Nov 2012 15:10:50 GMT From: Anton Shterenlikht To: FreeBSD-gnats-submit@FreeBSD.org X-Send-Pr-Version: 3.113 Subject: 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: Thu, 01 Nov 2012 15:20:01 -0000 >Number: 173265 >Category: docs >Synopsis: improving 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: