From nobody@FreeBSD.org  Tue Apr 20 12:15:39 2004
Return-Path: <nobody@FreeBSD.org>
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id 5F33F16A4CE
	for <freebsd-gnats-submit@FreeBSD.org>; Tue, 20 Apr 2004 12:15:39 -0700 (PDT)
Received: from www.freebsd.org (www.freebsd.org [216.136.204.117])
	by mx1.FreeBSD.org (Postfix) with ESMTP id 4F9B543D46
	for <freebsd-gnats-submit@FreeBSD.org>; Tue, 20 Apr 2004 12:15:39 -0700 (PDT)
	(envelope-from nobody@FreeBSD.org)
Received: from www.freebsd.org (localhost [127.0.0.1])
	by www.freebsd.org (8.12.10/8.12.10) with ESMTP id i3KJFd72048136
	for <freebsd-gnats-submit@FreeBSD.org>; Tue, 20 Apr 2004 12:15:39 -0700 (PDT)
	(envelope-from nobody@www.freebsd.org)
Received: (from nobody@localhost)
	by www.freebsd.org (8.12.10/8.12.10/Submit) id i3KJFd99048135;
	Tue, 20 Apr 2004 12:15:39 -0700 (PDT)
	(envelope-from nobody)
Message-Id: <200404201915.i3KJFd99048135@www.freebsd.org>
Date: Tue, 20 Apr 2004 12:15:39 -0700 (PDT)
From: Peter Ludemann <ludemann@yahoo-inc.com>
To: freebsd-gnats-submit@FreeBSD.org
Subject: find(1) documentation neglects to describe "-follow" option
X-Send-Pr-Version: www-2.3

>Number:         65822
>Category:       docs
>Synopsis:       find(1) documentation neglects to describe "-follow" option
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Tue Apr 20 12:20:09 PDT 2004
>Closed-Date:    Tue Apr 20 14:28:31 PDT 2004
>Last-Modified:  Tue Apr 20 17:40:03 PDT 2004
>Originator:     Peter Ludemann
>Release:        4.8
>Organization:
Yahoo!
>Environment:
FreeBSD sharks.corp.yahoo.com 4.8-YAHOO-20030619 FreeBSD 4.8-YAHOO-20030619 #0: Thu Apr  8 14:51:24 PDT 2004     root@sharks.corp.yahoo.com:/home/src/sys/compile/YAHOO  i386
>Description:
The "-follow" option to the find(1) command is only mentioned in passing, but not otherwise documented. This is true in both FreeBSD 4.8 and 5.x ( http://www.freebsd.org/cgi/man.cgi?query=find&apropos=0&sektion=0&manpath=FreeBSD+5.2-RELEASE+and+Ports&format=html )

Fortunately, Sun has the information, so I know I didn't just imagine the option: http://docs.sun.com/db/doc/816-0210/6m6nb7m9j?a=view
>How-To-Repeat:
emacs
man find
search for "follow"
>Fix:

>Release-Note:
>Audit-Trail:
State-Changed-From-To: open->closed 
State-Changed-By: des 
State-Changed-When: Tue Apr 20 14:28:30 PDT 2004 
State-Changed-Why:  
Already fixed. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=65822 

From: des@des.no (=?iso-8859-1?q?Dag-Erling_Sm=F8rgrav?=)
To: Peter Ludemann <ludemann@yahoo-inc.com>
Cc: freebsd-gnats-submit@FreeBSD.org
Subject: Re: docs/65822: find(1) documentation neglects to describe
 "-follow" option
Date: Tue, 20 Apr 2004 23:28:13 +0200

 Peter Ludemann <ludemann@yahoo-inc.com> writes:
 > The "-follow" option to the find(1) command is only mentioned in
 > passing, but not otherwise documented.
 
 relevant excerpts from find(1):
 
 DESCRIPTION
 [...]
      -H      Cause the file information and file type (see stat(2)) returned
              for each symbolic link specified on the command line to be tho=
 se
              of the file referenced by the link, not the link itself.  If t=
 he
              referenced file does not exist, the file information and type
              will be for the link itself.  File information of all symbolic
              links not on the command line is that of the link itself.  This
              is a suitable replacement for the archaic -follow option.
 [...]
 COMPATIBILITY
      The -follow option has been deprecated; -H is considered to be a suita=
 ble
      replacement.
 [...]
 STANDARDS
 [...]
      Historically, the -d, -H and -x options were implemented using the pri-
      maries -depth, -follow, and -xdev.  [...]
 
 DES
 --=20
 Dag-Erling Sm=F8rgrav - des@des.no

From: "Peter Ludemann" <ludemann@yahoo-inc.com>
To: <freebsd-gnats-submit@freebsd.org>, <ludemann@yahoo-inc.com>
Cc:  
Subject: Re: docs/65822: find(1) documentation neglects to describe "-follow" option
Date: Tue, 20 Apr 2004 15:08:08 -0700

 Except -H doesn't work (at least, not with FreeBSD 4.8). Here's an example,
 where -H doesn't follow a symlink but -follow does (to find the file
 /tmp/aaa):
 
 sharks 15:02:13 ~ $ cd foo
 sharks 15:02:15 ~/foo $ ln -s /tmp ttt
 sharks 15:02:18 ~/foo $ find -H . -name aaa
 sharks 15:02:25 ~/foo $ find . -follow -name aaa
 ./ttt/aaa
 sharks 15:02:32 ~/foo $
 

From: des@des.no (=?iso-8859-1?q?Dag-Erling_Sm=F8rgrav?=)
To: Peter Ludemann <ludemann@yahoo-inc.com>
Cc: freebsd-doc@FreeBSD.org, freebsd-gnats-submit@freebsd.org
Subject: Re: docs/65822: find(1) documentation neglects to describe
 "-follow" option
Date: Wed, 21 Apr 2004 02:31:53 +0200

 "Peter Ludemann" <ludemann@yahoo-inc.com> writes:
 > Except -H doesn't work (at least, not with FreeBSD 4.8). Here's an exampl=
 e,
 > where -H doesn't follow a symlink but -follow does (to find the file
 > /tmp/aaa):
 
 Ack, bug in man page.  The correct option is -L.
 
 DES
 --=20
 Dag-Erling Sm=F8rgrav - des@des.no
>Unformatted:
