From owner-freebsd-doc@FreeBSD.ORG Tue Oct 23 08:51:38 2012 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52]) by hub.freebsd.org (Postfix) with ESMTP id EBC708A0 for ; Tue, 23 Oct 2012 08:51:38 +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 A5D6C8FC12 for ; Tue, 23 Oct 2012 08:51:38 +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 1TQaD0-0002Rt-OQ for freebsd-doc@freebsd.org; Tue, 23 Oct 2012 09:51:37 +0100 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 1TQaD0-00034t-KO for freebsd-doc@freebsd.org; Tue, 23 Oct 2012 09:51:34 +0100 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 q9N8pYiZ052413 for ; Tue, 23 Oct 2012 09:51:34 +0100 (BST) (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 q9N8pYXg052407 for freebsd-doc@freebsd.org; Tue, 23 Oct 2012 09:51:34 +0100 (BST) (envelope-from mexas) Date: Tue, 23 Oct 2012 09:51:34 +0100 (BST) From: Anton Shterenlikht Message-Id: <201210230851.q9N8pYXg052407@mech-cluster241.men.bris.ac.uk> To: freebsd-doc@freebsd.org Subject: improving find -min option description X-Spam-Score: -0.9 X-Spam-Level: / X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list Reply-To: mexas@bristol.ac.uk List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 23 Oct 2012 08:51:39 -0000 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 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? I'll provide a patch if there is agreement. Anton