From owner-svn-src-head@freebsd.org Thu Jun 21 08:20:38 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 ACEC8101498C; Thu, 21 Jun 2018 08:20:38 +0000 (UTC) (envelope-from etnapierala@gmail.com) Received: from mail-wr0-x242.google.com (mail-wr0-x242.google.com [IPv6:2a00:1450:400c:c0c::242]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (Client CN "smtp.gmail.com", Issuer "Google Internet Authority G2" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 1C237729DA; Thu, 21 Jun 2018 08:20:38 +0000 (UTC) (envelope-from etnapierala@gmail.com) Received: by mail-wr0-x242.google.com with SMTP id d2-v6so2151424wrm.10; Thu, 21 Jun 2018 01:20:38 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=sender:date:from:to:cc:subject:message-id:mail-followup-to :references:mime-version:content-disposition :content-transfer-encoding:in-reply-to:user-agent; bh=DVA5aHZ2srgNUpPWyDsTGxWCE/80v148Oe1oYl43AFc=; b=Rfq+XxaVHQLDvY2/9rTPKK6UyeWxFwqWeOcHaWTpx0JMVSj5JDwsPETmQ1hi6fNaa+ bCGdWRDnwX9pPh2Ou/pRZdpByvgG9A4gRUu+Dg62tBxBGKLevuja7ggob540pWmAIYim XyOVvAfHZ6WYwntUt1Ou3rFeB3GM30uVXJp1IKUk7DRX5OWoJ36tFTHFlN3vwiUrAzOL 76kRxC0A9kWZvlXTA4F303iizZvMzN6uwBN3FYXlIRFTy+LXwniV/2RQwiUcyqGAfqvz MX0QsAFrdNg0iDZfZuS4F35f1UWGO/BmYwJPvnIRgQl0NjhnPJKbN4n1CkP4WniGQuoq iekQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:sender:date:from:to:cc:subject:message-id :mail-followup-to:references:mime-version:content-disposition :content-transfer-encoding:in-reply-to:user-agent; bh=DVA5aHZ2srgNUpPWyDsTGxWCE/80v148Oe1oYl43AFc=; b=Xlayz5BlTsXQHPAvdsXpI09BUW/UA2S8sZ81QXsxxufLDzmb8zDLjcIhVHr9Mdf9or uXpXDy3okSL2gSEcy/SBUESOKAXrUlwlm5xhcHH/nVSJWd+B3Jm0UdxOmv+r+TEri8uA exqIRGT5wc8oBYQ8S6180/uxBORsy9fUho2easWztN1PpEXBnOB7Ct+BccCF+qp9d8/y 78xEN55zbDsAHMS+PglKgXYdBp8JqsIjdkF7263CoktqrAE52XskegHlbUdwwUrRpP/b zhBruJGG6iLlG83K0uf7T5MPp/+VZLQUXGG5H6Y5xzhXr+H/RxBwVgnp7KGeWXHMRyca Gx1A== X-Gm-Message-State: APt69E2dAB0yABAlRcO/KSYYZPj+dw2n4e2neQMQ2v9PRD4CRC6nQegB 5Wal+fi34QGQcMEBhdr3L+vT5S0L X-Google-Smtp-Source: ADUXVKKmV7i00rqw4dO73jEmgeQuGyYkPTsbnzAYre5JKz7vawlGKLzPNGCf/Cg+Q8/8z1PttbSYOg== X-Received: by 2002:adf:c892:: with SMTP id k18-v6mr5304009wrh.6.1529569236920; Thu, 21 Jun 2018 01:20:36 -0700 (PDT) Received: from brick (cpc92302-cmbg19-2-0-cust461.5-4.cable.virginm.net. [82.1.209.206]) by smtp.gmail.com with ESMTPSA id m145-v6sm4156185wma.19.2018.06.21.01.20.35 (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Thu, 21 Jun 2018 01:20:36 -0700 (PDT) Sender: =?UTF-8?Q?Edward_Tomasz_Napiera=C5=82a?= Date: Thu, 21 Jun 2018 09:20:33 +0100 From: Edward Tomasz Napierala To: Ian Lepore Cc: Konstantin Belousov , 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: <20180621082033.GA1820@brick> Mail-Followup-To: Ian Lepore , Konstantin Belousov , src-committers@freebsd.org, svn-src-all@freebsd.org, svn-src-head@freebsd.org References: <201806201916.w5KJGpFg048232@repo.freebsd.org> <20180620195407.GS2430@kib.kiev.ua> <1529525332.24573.13.camel@freebsd.org> MIME-Version: 1.0 Content-Type: text/plain; charset=iso-8859-1 Content-Disposition: inline Content-Transfer-Encoding: 8bit In-Reply-To: <1529525332.24573.13.camel@freebsd.org> User-Agent: Mutt/1.10.0 (2018-05-17) 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: Thu, 21 Jun 2018 08:20:38 -0000 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.