From owner-svn-src-head@freebsd.org  Wed Jun 20 19:54:18 2018
Return-Path: <owner-svn-src-head@freebsd.org>
Delivered-To: svn-src-head@mailman.ysv.freebsd.org
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1])
 by mailman.ysv.freebsd.org (Postfix) with ESMTP id 9384E1007B30;
 Wed, 20 Jun 2018 19:54:18 +0000 (UTC)
 (envelope-from kostikbel@gmail.com)
Received: from kib.kiev.ua (kib.kiev.ua [IPv6:2001:470:d5e7:1::1])
 (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits))
 (Client did not present a certificate)
 by mx1.freebsd.org (Postfix) with ESMTPS id D919C71FBE;
 Wed, 20 Jun 2018 19:54:17 +0000 (UTC)
 (envelope-from kostikbel@gmail.com)
Received: from tom.home (kib@localhost [127.0.0.1])
 by kib.kiev.ua (8.15.2/8.15.2) with ESMTP id w5KJs79h070824;
 Wed, 20 Jun 2018 22:54:10 +0300 (EEST)
 (envelope-from kostikbel@gmail.com)
DKIM-Filter: OpenDKIM Filter v2.10.3 kib.kiev.ua w5KJs79h070824
Received: (from kostik@localhost)
 by tom.home (8.15.2/8.15.2/Submit) id w5KJs7ob070823;
 Wed, 20 Jun 2018 22:54:07 +0300 (EEST)
 (envelope-from kostikbel@gmail.com)
X-Authentication-Warning: tom.home: kostik set sender to kostikbel@gmail.com
 using -f
Date: Wed, 20 Jun 2018 22:54:07 +0300
From: Konstantin Belousov <kostikbel@gmail.com>
To: Edward Tomasz Napierala <trasz@FreeBSD.org>
Cc: src-committers@freebsd.org, svn-src-all@freebsd.org,
 svn-src-head@freebsd.org
Subject: Re: svn commit: r335456 - head/share/man/man7
Message-ID: <20180620195407.GS2430@kib.kiev.ua>
References: <201806201916.w5KJGpFg048232@repo.freebsd.org>
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <201806201916.w5KJGpFg048232@repo.freebsd.org>
User-Agent: Mutt/1.10.0 (2018-05-17)
X-Spam-Status: No, score=-2.0 required=5.0 tests=ALL_TRUSTED,BAYES_00,
 DKIM_ADSP_CUSTOM_MED,FREEMAIL_FROM,NML_ADSP_CUSTOM_MED autolearn=no
 autolearn_force=no version=3.4.1
X-Spam-Checker-Version: SpamAssassin 3.4.1 (2015-04-28) on tom.home
X-BeenThere: svn-src-head@freebsd.org
X-Mailman-Version: 2.1.26
Precedence: list
List-Id: SVN commit messages for the src tree for head/-current
 <svn-src-head.freebsd.org>
List-Unsubscribe: <https://lists.freebsd.org/mailman/options/svn-src-head>,
 <mailto:svn-src-head-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/svn-src-head/>
List-Post: <mailto:svn-src-head@freebsd.org>
List-Help: <mailto:svn-src-head-request@freebsd.org?subject=help>
List-Subscribe: <https://lists.freebsd.org/mailman/listinfo/svn-src-head>,
 <mailto:svn-src-head-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Wed, 20 Jun 2018 19:54:18 -0000

On Wed, Jun 20, 2018 at 07:16:51PM +0000, Edward Tomasz Napierala wrote:
> Author: trasz
> Date: Wed Jun 20 19:16:51 2018
> New Revision: 335456
> URL: https://svnweb.freebsd.org/changeset/base/335456
> 
> Log:
>   Improve wording.
>   
>   MFC after:	2 weeks
> 
> Modified:
>   head/share/man/man7/development.7
> 
> Modified: head/share/man/man7/development.7
> ==============================================================================
> --- head/share/man/man7/development.7	Wed Jun 20 18:51:38 2018	(r335455)
> +++ head/share/man/man7/development.7	Wed Jun 20 19:16:51 2018	(r335456)
> @@ -24,7 +24,7 @@
>  .\"
>  .\" $FreeBSD$
>  .\"
> -.Dd May 11, 2018
> +.Dd June 20, 2018
>  .Dt DEVELOPMENT 7
>  .Os
>  .Sh NAME
> @@ -81,7 +81,7 @@ Build instructions can be found in
>  .Xr build 7
>  and
>  .Xr release 7 .
> -Kernel APIs are usually documented, use
> +Kernel APIs are documented in section 9 manual pages; use
Kernel API is an oxymoron.  Section 9 describes Kernel Programming
Interfaces, the A from Application is not needed.  We usually abbreviate
it as KPI.

Kernel API are syscalls, if anything.
>  .Ql "apropos -s 9 ''"
>  for a list.
>  Regression test suite is described in