From owner-svn-src-head@freebsd.org Wed Jun 20 20:09:02 2018 Return-Path: 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 05BC21009880 for ; Wed, 20 Jun 2018 20:09:01 +0000 (UTC) (envelope-from ian@freebsd.org) Received: from outbound1a.eu.mailhop.org (outbound1a.eu.mailhop.org [52.58.109.202]) (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 0B94A72AED for ; Wed, 20 Jun 2018 20:09:00 +0000 (UTC) (envelope-from ian@freebsd.org) X-MHO-RoutePath: aGlwcGll X-MHO-User: c0f4eda5-74c5-11e8-afd2-4ddcc8249dd4 X-Report-Abuse-To: https://support.duocircle.com/support/solutions/articles/5000540958-duocircle-standard-smtp-abuse-information X-Originating-IP: 67.177.211.60 X-Mail-Handler: DuoCircle Outbound SMTP Received: from ilsoft.org (unknown [67.177.211.60]) by outbound1.eu.mailhop.org (Halon) with ESMTPSA id c0f4eda5-74c5-11e8-afd2-4ddcc8249dd4; Wed, 20 Jun 2018 20:08:54 +0000 (UTC) Received: from rev (rev [172.22.42.240]) by ilsoft.org (8.15.2/8.15.2) with ESMTP id w5KK8qXD082729; Wed, 20 Jun 2018 14:08:52 -0600 (MDT) (envelope-from ian@freebsd.org) Message-ID: <1529525332.24573.13.camel@freebsd.org> Subject: Re: svn commit: r335456 - head/share/man/man7 From: Ian Lepore To: Konstantin Belousov , Edward Tomasz Napierala Cc: src-committers@freebsd.org, svn-src-all@freebsd.org, svn-src-head@freebsd.org Date: Wed, 20 Jun 2018 14:08:52 -0600 In-Reply-To: <20180620195407.GS2430@kib.kiev.ua> References: <201806201916.w5KJGpFg048232@repo.freebsd.org> <20180620195407.GS2430@kib.kiev.ua> Content-Type: text/plain; charset="ISO-8859-1" X-Mailer: Evolution 3.18.5.1 FreeBSD GNOME Team Port Mime-Version: 1.0 Content-Transfer-Encoding: 8bit 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 List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 20 Jun 2018 20:09:02 -0000 On Wed, 2018-06-20 at 22:54 +0300, Konstantin Belousov wrote: > 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. This is the manpage a new developer is going to look at, and if you throw an abbreviation like KPI at them and they search for what it means, they're going to find "Key Performance Indicator" and nothing about kernels. This might be a good place to introduce and define that acronym, maybe something like "Kernel programming interfaces (KPIs) are documented...". -- Ian