From owner-freebsd-doc@FreeBSD.ORG Sat Jun 9 11:29:33 2012 Return-Path: Delivered-To: freebsd-doc@FreeBSD.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 13559106566B; Sat, 9 Jun 2012 11:29:33 +0000 (UTC) (envelope-from rfg@tristatelogic.com) Received: from outgoing.tristatelogic.com (segfault.tristatelogic.com [69.62.255.118]) by mx1.freebsd.org (Postfix) with ESMTP id E4C348FC12; Sat, 9 Jun 2012 11:29:32 +0000 (UTC) Received: from segfault-nmh-helo.tristatelogic.com (localhost [127.0.0.1]) by segfault.tristatelogic.com (Postfix) with ESMTP id D0AB45081F; Sat, 9 Jun 2012 04:29:31 -0700 (PDT) To: FreeBSD-gnats-submit@FreeBSD.org, freebsd-doc@FreeBSD.org In-Reply-To: <201206090530.q595UBi7097876@freefall.freebsd.org> Date: Sat, 09 Jun 2012 04:29:31 -0700 Message-ID: <1648.1339241371@tristatelogic.com> From: "Ronald F. Guilmette" Cc: Subject: Re: docs/168885: man page for find(1) fails to describe the -depth option X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sat, 09 Jun 2012 11:29:33 -0000 Regarding this PR: http://www.freebsd.org/cgi/query-pr.cgi?pr=168885 I noticed after I had filed it that actually, the -d option for find(1) is ``documented'' (for some value of ``documented'') in _two_ different locations within the find(1) man page, i.e. under the DESCRIPTION heading, and also under the PRIMARIES heading. In the first location, a full and complete description of the function of the -d option is in fact given. However in the second location, virtually nothing is said about the functionality of -d, and there isn't even a reference telling the reader to look for documentation of the -d option higher up within the man page.