svn commit: r335456 - head/share/man/man7

[Edward Tomasz Napierala]

On 0620T1408, Ian Lepore wrote:
> 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...".

Thank you both, fixed.