From owner-freebsd-current@FreeBSD.ORG  Tue Sep 22 16:38:34 2009
Return-Path: <owner-freebsd-current@FreeBSD.ORG>
Delivered-To: current@freebsd.org
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34])
	by hub.freebsd.org (Postfix) with ESMTP id B3293106566C
	for <current@freebsd.org>; Tue, 22 Sep 2009 16:38:34 +0000 (UTC)
	(envelope-from gary.jennejohn@freenet.de)
Received: from mout5.freenet.de (mout5.freenet.de [IPv6:2001:748:100:40::2:7])
	by mx1.freebsd.org (Postfix) with ESMTP id 4FDE58FC17
	for <current@freebsd.org>; Tue, 22 Sep 2009 16:38:34 +0000 (UTC)
Received: from [195.4.92.22] (helo=12.mx.freenet.de)
	by mout5.freenet.de with esmtpa (ID gary.jennejohn@freenet.de) (port
	25) (Exim 4.69 #92)
	id 1Mq8Ns-0004ZD-TW; Tue, 22 Sep 2009 18:38:32 +0200
Received: from tc27e.t.pppool.de ([89.55.194.126]:26461
	helo=ernst.jennejohn.org)
	by 12.mx.freenet.de with esmtpa (ID gary.jennejohn@freenet.de) (port
	25) (Exim 4.69 #94)
	id 1Mq8Ns-0001Hu-Mq; Tue, 22 Sep 2009 18:38:32 +0200
Date: Tue, 22 Sep 2009 18:38:31 +0200
From: Gary Jennejohn <gary.jennejohn@freenet.de>
To: Barney Cordoba <barney_cordoba@yahoo.com>
Message-ID: <20090922183831.4c100672@ernst.jennejohn.org>
In-Reply-To: <917077.59537.qm@web63902.mail.re1.yahoo.com>
References: <20090922171629.418a089b@ernst.jennejohn.org>
	<917077.59537.qm@web63902.mail.re1.yahoo.com>
X-Mailer: Claws Mail 3.7.2 (GTK+ 2.16.2; amd64-portbld-freebsd8.0)
Mime-Version: 1.0
Content-Type: text/plain; charset=US-ASCII
Content-Transfer-Encoding: 7bit
Cc: pluknet <pluknet@gmail.com>, current@freebsd.org
Subject: Re: where is device_get_parent function defined
X-BeenThere: freebsd-current@freebsd.org
X-Mailman-Version: 2.1.5
Precedence: list
Reply-To: gary.jennejohn@freenet.de
List-Id: Discussions about the use of FreeBSD-current
	<freebsd-current.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-current>, 
	<mailto:freebsd-current-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-current>
List-Post: <mailto:freebsd-current@freebsd.org>
List-Help: <mailto:freebsd-current-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-current>,
	<mailto:freebsd-current-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Tue, 22 Sep 2009 16:38:34 -0000

On Tue, 22 Sep 2009 08:37:26 -0700 (PDT)
Barney Cordoba <barney_cordoba@yahoo.com> wrote:

> So all they need now is an open to turn off the recursive directory
> warnings....
> 

I saw no warnings at all when I did the grep.  The only ouput from grep
was the name of the file.

Must be something weird on your machine.

> Of course a section in the man page telling you the source module would
> make way too much sense to be adopted by any of the free software groups...
> 

It generally isn't relevant where a function is located.  Man pages
are supposed to document the required syntax and not the layout of
the source tree, which can change at any time.

FreeBSD has generally excellent man pages for kernel functions.  Linux,
on the other hand, has virtually no kernel documentation at all, so the
only way to figure out how a routine works is to examine the code.

I can speak authoritatively on this because I make my living developing
drivers for Linux.

---
Gary Jennejohn