From chu@h33.erkki.ton.tut.fi  Thu Jul  4 11:52:01 2002
Return-Path: <chu@h33.erkki.ton.tut.fi>
Received: from mx1.FreeBSD.org (mx1.FreeBSD.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id BCCCB37B400
	for <FreeBSD-gnats-submit@freebsd.org>; Thu,  4 Jul 2002 11:52:01 -0700 (PDT)
Received: from h33.erkki.ton.tut.fi (h33.erkki.ton.tut.fi [193.166.84.86])
	by mx1.FreeBSD.org (Postfix) with ESMTP id 54C8A43E09
	for <FreeBSD-gnats-submit@freebsd.org>; Thu,  4 Jul 2002 11:51:57 -0700 (PDT)
	(envelope-from chu@h33.erkki.ton.tut.fi)
Received: (from chu@localhost)
	by h33.erkki.ton.tut.fi (8.11.6/8.11.6) id g64IpsJ15485;
	Thu, 4 Jul 2002 21:51:54 +0300 (EEST)
	(envelope-from chu)
Message-Id: <200207041851.g64IpsJ15485@h33.erkki.ton.tut.fi>
Date: Thu, 4 Jul 2002 21:51:54 +0300 (EEST)
From: Vladimir Chukharev <chu@gpi.ru>
To: FreeBSD-gnats-submit@freebsd.org
Subject: man find does not describe -follow
X-Send-Pr-Version: 3.113
X-GNATS-Notify:

>Number:         40196
>Category:       docs
>Synopsis:       man find does not describe -follow
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    trhodes
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Thu Jul 04 12:00:10 PDT 2002
>Closed-Date:    Thu Mar 04 04:03:18 PST 2004
>Last-Modified:  Thu Mar 04 04:03:18 PST 2004
>Originator:     Vladimir Chukharev
>Release:        FreeBSD 4.6-STABLE i386
>Organization:
>Environment:
System: FreeBSD svak.h33.erkki.ton.tut.fi 4.6-STABLE FreeBSD 4.6-STABLE #14: Thu Jun 20 23:55:18 EEST 2002     root@svak.h33.erkki.ton.tut.fi:/usr/obj/usr/src/sys/SVAK  i386

>Description:

man find does not describe an option -follow. It only mentions this option 
in STANDARDTS section. Quick check confirm that -follow is implemented, 
thus references to it in usenet are most probably correct.

 $ grep -i -- -follow /usr/src/usr.bin/find/*
/usr/src/usr.bin/find/find.1:.Ic -depth , -follow ,
/usr/src/usr.bin/find/function.c:       ftsoptions |= FTS_PHYSICAL;     /* disable -follow */
/usr/src/usr.bin/find/function.c:       ftsoptions &= ~FTS_LOGICAL;     /* disable -follow */
/usr/src/usr.bin/find/function.c: * -follow functions --
/usr/src/usr.bin/find/option.c: { "-follow",    c_follow,       f_always_true,  0 },

>How-To-Repeat:
>Fix:

Sorry, don't know what it supposed to do, no patch this time.

>Release-Note:
>Audit-Trail:

From: "Peter C. Lai" <sirmoo@cowbert.2y.net>
To: freebsd-gnats-submit@FreeBSD.org, chu@gpi.ru
Cc: freebsd-doc@freebsd.org
Subject: Re: docs/40196: man find does not describe -follow
Date: Mon, 23 Feb 2004 01:54:44 -0500

 find(1) has the -follow option historically on SysV and Solaris.
 
 In IRIX 6.5, the find(1) manpage says: 
 
 -follow		Always true; causes the underlying file of a symbolic link to 
 		be checked rather than the symbolic link itself.
 
 In GNU find(1), the manpage says:
 
 -follow		Dereference symbolic links...
 
 In Solaris 8+ find(1), the manpage says:
 
 -follow		Always true; causes symbolic  links  to  be  followed.
 		When following symbolic links, find keeps track of the
 		directories visited so that  it  can  detect  infinite
 		loops;  for example, such a loop would occur if a sym-
 		bolic link pointed to  an  ancestor.  This  expression
 		should not be used with the -type l expression.
 
 Whereas I'm not sure whether or not FreeBSD's find(1) supports the infinite loop
 detection feature, the Solaris description appears to be the most accurate.
 
 Can someone verify this for me, and submit a diff/patch? This PR's been open
 for over a year.
 
 Thanks,
 Pete
 
 -- 
 Peter C. Lai
 University of Connecticut
 Dept. of Molecular and Cell Biology
 Yale University School of Medicine
 SenseLab | Research Assistant
 http://cowbert.2y.net/
 

From: des@des.no (Dag-Erling =?iso-8859-1?q?Sm=F8rgrav?=)
To: peter.lai@uconn.edu
Cc: freebsd-gnats-submit@FreeBSD.org, chu@gpi.ru,
	freebsd-doc@freebsd.org
Subject: Re: docs/40196: man find does not describe -follow
Date: Mon, 23 Feb 2004 10:05:59 +0100

 "Peter C. Lai" <sirmoo@cowbert.2y.net> writes:
 > find(1) has the -follow option historically on SysV and Solaris.
 > [...]
 > Whereas I'm not sure whether or not FreeBSD's find(1) supports the
 > infinite loop detection feature, the Solaris description appears to
 > be the most accurate.
 
 Have you even read the man page?  Our find(1) uses fts(3) and supports
 the usual -H, -L and -P options.  The -follow option (and one reason
 why we don't support it) is even mentioned in the STANDARDS section,
 though -H is misspelled as -h in that paragraph.
 
 DES
 --=20
 Dag-Erling Sm=F8rgrav - des@des.no

From: "Peter C. Lai" <sirmoo@cowbert.2y.net>
To: Dag-Erling Sm?rgrav <des@des.no>
Cc: peter.lai@uconn.edu, freebsd-gnats-submit@FreeBSD.org,
	chu@gpi.ru, freebsd-doc@FreeBSD.org
Subject: Re: docs/40196: man find does not describe -follow
Date: Mon, 23 Feb 2004 16:24:28 -0500

 -follow works on the command line. Is it just another method to invoke -H?
 I find it strange that the only mention of -follow is in the STANDARDS section,
 since that's not the most intutitive place to look for it (yes, I did read it);
 I guess the misspelling threw me off since there's no -h option (only -H) :)
 Shouldn't we at least put in a line for -follow saying "another name for -H"?
 
 thanks
 
 On Mon, Feb 23, 2004 at 10:05:59AM +0100, Dag-Erling Sm?rgrav wrote:
 > "Peter C. Lai" <sirmoo@cowbert.2y.net> writes:
 > > find(1) has the -follow option historically on SysV and Solaris.
 > > [...]
 > > Whereas I'm not sure whether or not FreeBSD's find(1) supports the
 > > infinite loop detection feature, the Solaris description appears to
 > > be the most accurate.
 > 
 > Have you even read the man page?  Our find(1) uses fts(3) and supports
 > the usual -H, -L and -P options.  The -follow option (and one reason
 > why we don't support it) is even mentioned in the STANDARDS section,
 > though -H is misspelled as -h in that paragraph.
 > 
 > DES
 > -- 
 > Dag-Erling Sm?rgrav - des@des.no
 
 -- 
 Peter C. Lai
 University of Connecticut
 Dept. of Molecular and Cell Biology
 Yale University School of Medicine
 SenseLab | Research Assistant
 http://cowbert.2y.net/
 

From: des@des.no (Dag-Erling =?iso-8859-1?q?Sm=F8rgrav?=)
To: peter.lai@uconn.edu
Cc: freebsd-gnats-submit@FreeBSD.org, chu@gpi.ru,
	freebsd-doc@FreeBSD.org
Subject: Re: docs/40196: man find does not describe -follow
Date: Tue, 24 Feb 2004 07:57:42 +0100

 "Peter C. Lai" <sirmoo@cowbert.2y.net> writes:
 > -follow works on the command line. Is it just another method to
 > invoke -H?  I find it strange that the only mention of -follow is in
 > the STANDARDS section, since that's not the most intutitive place to
 > look for it (yes, I did read it); I guess the misspelling threw me
 > off since there's no -h option (only -H) :) Shouldn't we at least
 > put in a line for -follow saying "another name for -H"?
 
 It isn't "another name for -H", and the reason why is explained in the
 STANDARDS section.  Please read it again.
 
 If you insist on documenting -follow, make sure to
 
  - document it in the correct section (PRIMARIES, not DESCRIPTION)
  - note that it does not behave like other primaries do
  - note that it should not be used except for compatibility reasons
  - also document -depth and -xdev in the same manner
 
 DES
 --=20
 Dag-Erling Sm=F8rgrav - des@des.no

From: Tom Rhodes <trhodes@FreeBSD.org>
To: des@des.no (Dag-Erling =?ISO-8859-1?Q?Sm=F8rgrav?=)
Cc: freebsd-gnats-submit@FreeBSD.org
Subject: Re: docs/40196: man find does not describe -follow
Date: Tue, 24 Feb 2004 10:32:35 -0500

 On Tue, 24 Feb 2004 07:57:42 +0100
 des@des.no (Dag-Erling Sm=F8rgrav) wrote:
 
 > "Peter C. Lai" <sirmoo@cowbert.2y.net> writes:
 > > -follow works on the command line. Is it just another method to
 > > invoke -H?  I find it strange that the only mention of -follow is in
 > > the STANDARDS section, since that's not the most intutitive place to
 > > look for it (yes, I did read it); I guess the misspelling threw me
 > > off since there's no -h option (only -H) :) Shouldn't we at least
 > > put in a line for -follow saying "another name for -H"?
 >=20
 > It isn't "another name for -H", and the reason why is explained in the
 > STANDARDS section.  Please read it again.
 >=20
 > If you insist on documenting -follow, make sure to
 >=20
 >  - document it in the correct section (PRIMARIES, not DESCRIPTION)
 >  - note that it does not behave like other primaries do
 >  - note that it should not be used except for compatibility reasons
 >  - also document -depth and -xdev in the same manner
 
 Wouldn't a note that -follow is supported only for compatibility
 reasons?
 
 --=20
 Tom Rhodes

From: underway@comcast.net (Gary W. Swearingen)
To: des@des.no (=?iso-8859-1?q?Dag-Erling_Sm=F8rgrav?=)
Cc: peter.lai@uconn.edu, freebsd-doc@FreeBSD.org,
	freebsd-gnats-submit@FreeBSD.org, chu@gpi.ru
Subject: Re: docs/40196: man find does not describe -follow
Date: Tue, 24 Feb 2004 11:24:27 -0800

 des@des.no (Dag-Erling Smrgrav) writes:
 
 > If you insist on documenting -follow, make sure to
 >
 >  - document it in the correct section (PRIMARIES, not DESCRIPTION)
 
 From the mdoc(7) manpage's list of section descriptions:
 
      .Sh COMPATIBILITY  Known compatibility issues (e.g. deprecated options or
                         parameters) should be listed here.
State-Changed-From-To: open->patched 
State-Changed-By: trhodes 
State-Changed-When: Fri Feb 27 12:10:00 PST 2004 
State-Changed-Why:  
The -follow option was added under a compatibility section 
and noted with the -H flag. 


Responsible-Changed-From-To: freebsd-doc->trhodes 
Responsible-Changed-By: trhodes 
Responsible-Changed-When: Fri Feb 27 12:10:00 PST 2004 
Responsible-Changed-Why:  
The -follow option was added under a compatibility section 
and noted with the -H flag. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=40196 
State-Changed-From-To: patched->closed 
State-Changed-By: trhodes 
State-Changed-When: Thu Mar 4 04:03:03 PST 2004 
State-Changed-Why:  
MFC Complete! 

http://www.freebsd.org/cgi/query-pr.cgi?pr=40196 
>Unformatted:
