Date: Wed, 19 Jun 2002 09:59:10 -0700 (PDT) From: Soren Spies <sspies@apple.com> To: freebsd-gnats-submit@FreeBSD.org Subject: docs/39532: 'find' man page should Message-ID: <200206191659.g5JGxAwU006397@www.freebsd.org>
next in thread | raw e-mail | index | archive | help
>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
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?200206191659.g5JGxAwU006397>