From owner-svn-src-all@freebsd.org  Thu Aug 20 22:28:58 2015
Return-Path: <owner-svn-src-all@freebsd.org>
Delivered-To: svn-src-all@mailman.ysv.freebsd.org
Received: from mx1.freebsd.org (mx1.freebsd.org
 [IPv6:2001:1900:2254:206a::19:1])
 by mailman.ysv.freebsd.org (Postfix) with ESMTP id 6E9DA9BE8C9;
 Thu, 20 Aug 2015 22:28:58 +0000 (UTC)
 (envelope-from bdrewery@FreeBSD.org)
Received: from freefall.freebsd.org (freefall.freebsd.org
 [IPv6:2001:1900:2254:206c::16:87])
 by mx1.freebsd.org (Postfix) with ESMTP id 523C012FC;
 Thu, 20 Aug 2015 22:28:58 +0000 (UTC)
 (envelope-from bdrewery@FreeBSD.org)
Received: from mail.xzibition.com (localhost [IPv6:::1])
 by freefall.freebsd.org (Postfix) with ESMTP id 4AC681B19;
 Thu, 20 Aug 2015 22:28:58 +0000 (UTC)
 (envelope-from bdrewery@FreeBSD.org)
Received: from mail.xzibition.com (localhost [172.31.3.2])
 by mail.xzibition.com (Postfix) with ESMTP id ED783FC4B;
 Thu, 20 Aug 2015 22:28:57 +0000 (UTC)
X-Virus-Scanned: amavisd-new at mail.xzibition.com
Received: from mail.xzibition.com ([172.31.3.2])
 by mail.xzibition.com (mail.xzibition.com [172.31.3.2]) (amavisd-new,
 port 10026)
 with LMTP id zzPGdHjY5OcY; Thu, 20 Aug 2015 22:28:55 +0000 (UTC)
Subject: Re: svn commit: r286974 - head/share/man/man9
DKIM-Filter: OpenDKIM Filter v2.9.2 mail.xzibition.com E49A1FC44
To: Konstantin Belousov <kostikbel@gmail.com>
References: <201508202214.t7KMEhm5071766@repo.freebsd.org>
 <20150820222618.GY2072@kib.kiev.ua>
Cc: src-committers@freebsd.org, svn-src-all@freebsd.org,
 svn-src-head@freebsd.org
From: Bryan Drewery <bdrewery@FreeBSD.org>
Organization: FreeBSD
Message-ID: <55D654A6.4060300@FreeBSD.org>
Date: Thu, 20 Aug 2015 15:28:54 -0700
User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10.10; rv:38.0)
 Gecko/20100101 Thunderbird/38.2.0
MIME-Version: 1.0
In-Reply-To: <20150820222618.GY2072@kib.kiev.ua>
Content-Type: text/plain; charset=windows-1252
Content-Transfer-Encoding: 7bit
X-BeenThere: svn-src-all@freebsd.org
X-Mailman-Version: 2.1.20
Precedence: list
List-Id: "SVN commit messages for the entire src tree \(except for &quot;
 user&quot; and &quot; projects&quot; \)" <svn-src-all.freebsd.org>
List-Unsubscribe: <https://lists.freebsd.org/mailman/options/svn-src-all>,
 <mailto:svn-src-all-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/svn-src-all/>
List-Post: <mailto:svn-src-all@freebsd.org>
List-Help: <mailto:svn-src-all-request@freebsd.org?subject=help>
List-Subscribe: <https://lists.freebsd.org/mailman/listinfo/svn-src-all>,
 <mailto:svn-src-all-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Thu, 20 Aug 2015 22:28:58 -0000

On 8/20/15 3:26 PM, Konstantin Belousov wrote:
> On Thu, Aug 20, 2015 at 10:14:43PM +0000, Bryan Drewery wrote:
>> Author: bdrewery
>> Date: Thu Aug 20 22:14:43 2015
>> New Revision: 286974
>> URL: https://svnweb.freebsd.org/changeset/base/286974
>>
>> Log:
>>   Remove reference to non-existent kern_openat(9).
> The man page does not exist, but the function is there.  It is the right
> kernel-mode entrance for the high-level open machinery.  As such, it is
> useful reference for a set of functions which needs to be aware of the
> open event.
> 

I agree. However, I don't think this is the right place for it though as
this is typically a man page list. I also think it is similar to
commenting obvious code. The manual page already mentions the open(2)
hook. Finding that code is obviously in sys_open, which chains down into
kern_openat.

-- 
Regards,
Bryan Drewery