From owner-freebsd-doc Wed Jun 19 10: 0:26 2002 Delivered-To: freebsd-doc@hub.freebsd.org Received: from freefall.freebsd.org (freefall.FreeBSD.org [216.136.204.21]) by hub.freebsd.org (Postfix) with ESMTP id 3EB1937B415 for ; Wed, 19 Jun 2002 10:00:02 -0700 (PDT) Received: (from gnats@localhost) by freefall.freebsd.org (8.11.6/8.11.6) id g5JH02d44750; Wed, 19 Jun 2002 10:00:02 -0700 (PDT) (envelope-from gnats) Received: from nwww.freebsd.org (www.FreeBSD.org [216.136.204.117]) by hub.freebsd.org (Postfix) with ESMTP id 1E75937B400 for ; Wed, 19 Jun 2002 09:59:11 -0700 (PDT) Received: from www.freebsd.org (localhost [127.0.0.1]) by nwww.freebsd.org (8.12.2/8.12.2) with ESMTP id g5JGxAhG006398 for ; Wed, 19 Jun 2002 09:59:10 -0700 (PDT) (envelope-from nobody@www.freebsd.org) Received: (from nobody@localhost) by www.freebsd.org (8.12.2/8.12.2/Submit) id g5JGxAwU006397; Wed, 19 Jun 2002 09:59:10 -0700 (PDT) Message-Id: <200206191659.g5JGxAwU006397@www.freebsd.org> Date: Wed, 19 Jun 2002 09:59:10 -0700 (PDT) From: Soren Spies To: freebsd-gnats-submit@FreeBSD.org X-Send-Pr-Version: www-1.0 Subject: docs/39532: 'find' man page should Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk List-ID: List-Archive: (Web Archive) List-Help: (List Instructions) List-Subscribe: List-Unsubscribe: X-Loop: FreeBSD.org >Number: 39532 >Category: docs >Synopsis: 'find' man page should >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: Wed Jun 19 10:00:02 PDT 2002 >Closed-Date: >Last-Modified: >Originator: Soren Spies >Release: FreeBSD 4.5 >Organization: Apple Computer, Inc >Environment: bash-2.05$ uname -a FreeBSD freebsd.apple.com 4.5-STABLE FreeBSD 4.5-STABLE #1: Mon Apr 22 17:41:12 PDT 2002 jkh@freebsd.apple.com:/usr/obj/usr/local/src/sys/FREEBSD i386 >Description: One common use of 'find' is with the -exec flag. It's rather tricky to get right for the novice (the \; gets most people the first time) and thus would be an excellent flag to document in the find(1) man page's EXAMPLES section. The current man pages (FreeBSD 4.5 and 4.6) don't show the \; and only obliquely refers to the need for special quoting: "Optional arguments may be passed to the utility. The expression must be terminated by a semicolon (``;'')." >How-To-Repeat: man find *think* "-exec looks cool" try to use it: find . -type f -exec chmod g-w {} ; find: -exec: no terminating ";" wonder why it failed ... eventually resort to finding someone more knowledgable, general sadness, lack of confidence, etc. :) >Fix: add an example to the EXAMPLES section: find . -type d -exec chmod g-w {} \; >Release-Note: >Audit-Trail: >Unformatted: To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message