From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from EUR01-HE1-obe.outbound.protection.outlook.com (mail-he1eur01on0042.outbound.protection.outlook.com [104.47.0.42]) by dpdk.org (Postfix) with ESMTP id 7D6CB1B7BC for ; Wed, 6 Jun 2018 08:20:13 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=nxp.com; s=selector1; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=8z/rx5Uf+uRm6EXypfMf8VR1RNHa+7lLeANVUz3JvTg=; b=JGCmvvYzjN26Vy4zOMK5LaHuSwHWWTnpiKWByx5eHxZJDPcaRyF0mqkWgPP47IldEccjGBZog782GksuJEWWt0jZ1alhbib/OeBCeXodTfOwaOB/FMd9U6R9vtUA7q6YwSFtIuJvkKc4bG8v6r9a+w6g3lg82xdf1WB4bcv7ROs= Authentication-Results: spf=none (sender IP is ) smtp.mailfrom=shreyansh.jain@nxp.com; Received: from [10.232.40.129] (14.142.187.166) by HE1PR0402MB2777.eurprd04.prod.outlook.com (2603:10a6:3:d4::11) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.820.15; Wed, 6 Jun 2018 06:20:09 +0000 To: Ferruh Yigit Cc: "john.mcnamara@intel.com" , "marko.kovacevic@intel.com" , Hemant Agrawal , Thomas Monjalon , "dev@dpdk.org" References: <20180531211123.25758-1-thomas@monjalon.net> <8b95d8a2-ed37-a9cc-344a-9d769c22ebc1@intel.com> <773e9d8d-cc82-9e85-946d-520ea5ddee54@intel.com> From: Shreyansh Jain Message-ID: <7c69aef2-967c-4f6f-f798-b2c950e43a23@nxp.com> Date: Wed, 6 Jun 2018 11:49:52 +0530 User-Agent: Mozilla/5.0 (Windows NT 10.0; WOW64; rv:52.0) Gecko/20100101 Thunderbird/52.8.0 MIME-Version: 1.0 In-Reply-To: <773e9d8d-cc82-9e85-946d-520ea5ddee54@intel.com> Content-Type: text/plain; charset=utf-8; format=flowed Content-Language: en-US Content-Transfer-Encoding: 8bit X-Originating-IP: [14.142.187.166] X-ClientProxiedBy: SG2PR02CA0008.apcprd02.prod.outlook.com (2603:1096:3:17::20) To HE1PR0402MB2777.eurprd04.prod.outlook.com (2603:10a6:3:d4::11) X-MS-PublicTrafficType: Email X-MS-Office365-Filtering-HT: Tenant X-Microsoft-Antispam: UriScan:; BCL:0; PCL:0; RULEID:(7020095)(4652020)(48565401081)(5600026)(4534165)(7168020)(4627221)(201703031133081)(201702281549075)(2017052603328)(7153060)(7193020); SRVR:HE1PR0402MB2777; X-Microsoft-Exchange-Diagnostics: 1; HE1PR0402MB2777; 3:jbRCTTVf+wLHjBjEPd4PR0a2v2LmmGb2GC83hOKzPBst2oT/PFTX4A1dwix5mqCah6wOYeoLgPbrvNFyhPSGFtc2L8e6VunDfLFL1rrLUbyvmzZy01cJJqosQtRPoE6smJ9Np+7143IRghSAPEmkvtjClpfzFne/+P3KxXpZi8alYXbbAnP7kB7W4fwVzIrHrZ5uhAIwsD1j9GR/xAeoyukwcl8oLFY1dGqIr6HauJukDqwlLDl/WmGkYAZv5+23; 25:cadKj199IpQ2wxgDl4xppvNPrRryPFIi3C5BMIQx8RntG5UqT+Eb3eDp9XUeP5tYEmWT9TOGxyGoIrz32AIoIc9djm1F4v3yso5fOLZJIEcKJUpKcawK1SyE1FKTInD0J0lApIHaKKToEETj3SoqfzCQAHPbsZye9jr+NIk97gkGFVIZ/ZeVzJOlR1+5N8JbE3mDGhkCLfV0OQV6CId+powlOuO5X5KKZ4cUMn+rk4W7CCz+Lr/FdZcx0iinpF1cH+iJYQ9sVv/uG8fgsxmr57h12p+F0kprSg6H9fbrxFidqUvgkkNU5n5KkAFhVl66RoI+iV6YqzCkhMjdnqfMLQ==; 31:zolMX5pq7ko7NOCm3hGlhyV4Hg77V10sZZLSqyKLSltIgW+sEgj1pBeONMbvYz3TZFutIPSUuRH7E/Rxmo7WAu9Yk2DwROZN4sWkewf/Y6GDrDlnaYlDfJz406iNo08PVDTamlARbMuehQbPX7wJTh8ewmSgfEd2VJMnwYNNl7R9qm+1vumYrrzUqG3ETjxFZi8h3D+q6kCx3V42eVp6aOO+AMJH/soL2+6cRJTzV/w= X-MS-TrafficTypeDiagnostic: HE1PR0402MB2777: X-Microsoft-Exchange-Diagnostics: 1; HE1PR0402MB2777; 20:8zdw85CiIRbAG+TPT6JDIbshh3qLiFJGd2jSXulAAA4MdqtTcCvdzHIZIfGZs2vGt+50i1eXJSqkLlvSNlidLy46nETAcGh5CKNgmnx2Qk0jbPQu9wWX4cHgxNVw1BFzndVG5DFKV0sxgeQrNt1Menf2Cl2BHGqxharlAtWOnrZ1XDnliZJCCndf7ILoONiVv6WLfMSX+35ULe+H4hjhZTK59pdANUe+dfPOveljbnPGBQeTMjMVsN81xyukbn64bCgut5Wyv+gpeLrYB/idvLQBwa6oVm6axsKnLJOfLwSNVXfnzld77Fvi5exbiCwx1o4U/ZHKmNJF7RhzNUrKtCOCq9QRlh7zYHGYJ+2s/1OM8fHKJp9dPsdVjytXe/8f+yczo8NOH3vlx9KTKLqKO522HBqOfyYjmGkS7VxNcOB+QmpE8MlEHruDDsq/GzhGPCdDWXCxNyGo8F01F121F7JAKsriZ+xYqHWaHNp2ufmt3FRs/Op9Ywe08vfZ3REg; 4:ZuuX2mQsXWbmHOSFShCRolgq22a1ysUrN05KdWg8NWcXDz474jBNVNVPDFty5yDZHbGSVXApG4cHnzJWhBFy3aGqbQLgfyHxu7SIgTQnpGWR41bPYOrO0Gk+ah/O6dDKeuMswBlKv9BnI8qOuGd32Q9ZBWuh+Av/dyUqgro0lplMvKbO8Hy7zgy/xzbb+wWVkOEmg/4ZZvLm0XDM/sMTt0yCqxm7NwdsiaNdE/kwqrfoJ3JcD7ZsCpvuDvN1xjn8w3+VEy+4Ig6uh1pQ/qu+EMXp5XaXFkkSrp6xt0YucGgcXu9+dP6oGNLFQl8wF9nFvfwCwiAO9VfqxejZmlVlNEEyHLuTXFV13O91GsTUKtQ= X-Microsoft-Antispam-PRVS: X-Exchange-Antispam-Report-Test: UriScan:(185117386973197)(228905959029699); X-MS-Exchange-SenderADCheck: 1 X-Exchange-Antispam-Report-CFA-Test: BCL:0; PCL:0; RULEID:(8211001083)(6040522)(2401047)(5005006)(8121501046)(3002001)(3231254)(944501410)(52105095)(10201501046)(93006095)(93001095)(6055026)(149027)(150027)(6041310)(20161123564045)(20161123558120)(20161123560045)(20161123562045)(201703131423095)(201702281528075)(20161123555045)(201703061421075)(201703061406153)(6072148)(201708071742011)(7699016); SRVR:HE1PR0402MB2777; BCL:0; PCL:0; RULEID:; SRVR:HE1PR0402MB2777; X-Forefront-PRVS: 06952FC175 X-Forefront-Antispam-Report: SFV:NSPM; SFS:(10009020)(6049001)(376002)(396003)(346002)(366004)(39380400002)(39860400002)(13464003)(189003)(199004)(66066001)(229853002)(47776003)(54906003)(52116002)(65956001)(65806001)(6486002)(478600001)(2616005)(26005)(97736004)(81166006)(386003)(16526019)(4326008)(7736002)(76176011)(23676004)(8676002)(59450400001)(77096007)(81156014)(8936002)(3260700006)(305945005)(55236004)(25786009)(3846002)(6116002)(68736007)(186003)(53936002)(52146003)(2870700001)(36756003)(50466002)(6246003)(65826007)(2486003)(105586002)(5660300001)(5009440100003)(106356001)(486006)(16576012)(11346002)(316002)(93886005)(86362001)(64126003)(58126008)(67846002)(6916009)(446003)(2906002)(44832011)(53546011)(956004)(31686004)(476003)(6666003)(31696002)(110426005); DIR:OUT; SFP:1101; SCL:1; SRVR:HE1PR0402MB2777; H:[10.232.40.129]; FPR:; SPF:None; LANG:en; PTR:InfoNoRecords; MX:1; A:1; Received-SPF: None (protection.outlook.com: nxp.com does not designate permitted sender hosts) X-Microsoft-Exchange-Diagnostics: =?utf-8?B?MTtIRTFQUjA0MDJNQjI3Nzc7MjM6L0RJZVRIQkh6ZzZaZXZ2SzBPV1VEMDRl?= =?utf-8?B?SG1aaDNqQWwreDNsRkE3aDNZbUQwSlhQeVBjRC9nTG5udXJ2U1MvNzBCR3hQ?= =?utf-8?B?WkpBYnVMSWU5MVhZcGdZQ0toemRDbFpDOUpRQlkvMnBOcGoycDk2Mm9sVWJ3?= =?utf-8?B?RkhwWnd6SjF4eUpyY3htWEl0WG5rQXZncHF1OHl6TGRmZ0c0Si9Bbm5xcmJ2?= =?utf-8?B?blBtM09pSEt3NTNyMFVYTzY4N2diYVRReWhCZllpTjRNZlFJclRJSXMzY1dj?= =?utf-8?B?QVgvWjRRb2QrWmU3YzVJanYrRkV0U2Q1N2FOQllFa0VVOTY5aWUreGloekRF?= =?utf-8?B?dzMwN3lPU0NMOExPUFBBQXh6dlVnaG9xZ3ZkYmxyRit0dW1hK3pEYlJRRG0y?= =?utf-8?B?S3d3MTBuK2x6ZndFY0NwZEdJTWkxS1M2ZmlqUGhJbXB5R01VMlpWblF0QTlk?= =?utf-8?B?TlllN29kclQwMFJSTVNrczkrbTI2QkdObGFjdUVZcEJ1VmdnNlZSTmx0VnB1?= =?utf-8?B?Qzg3ZDdpM0g3SXEvTHB4SFhlRnluZXEyUFY3TDlIRXBTd3RmVzZ2Z0RWQkl5?= =?utf-8?B?K0tRcWhoaWhQY2xrcmZYK0hMVjhzUjdCdzlEaVd4Q0I2SW83ZzNaQWFsTkhE?= =?utf-8?B?SmVORWR5d0tDaStXNkp5eTFNdzRWZlYwY1pGem1vMVh2MzhEQkhlYkg2TitN?= =?utf-8?B?WHVZU0FSWWR5eURTT2NrK25MalBGOE0vY01LQ2E0RUcyV3JyOWJwTndWbFll?= =?utf-8?B?YzFWZllPZUtUdUovaTAvTFlDcWlRQ3diRHVLNGU0WURNeXBicURMakZKOGpT?= =?utf-8?B?ajNSTjBIVXZIdGlDdkUyRExCRGIyb1ZSRUtONWI5VTZFZzNvNVd4ODZjMzJJ?= =?utf-8?B?d2VNZXRTTkNsVStIRHlUakUxQWw0VzlxM01QMzh4S1V0RVc4UXc1Nm5YcUth?= =?utf-8?B?ZG4rQ3dtckVOK2lHNXNhdzVUSW04YXhoWVRNdzY3WVRvdWVPdkwvaEgzNzV0?= =?utf-8?B?eEpaQTlvZXR4QUxOZXM5MHQxMlF5YnJOTlZ4eHZ2TVhoZThLOEpaV1J1Z2Vq?= =?utf-8?B?cDh3TUtCQWhNdXM1bGtOMkZKUEdTd0FvcFU4TmN2TnpTb3BKZHIyOU5qYnU3?= =?utf-8?B?dFpJSTJGZG05dVV4SEllbmlzMjRvOElOMU5IL0JTdWdSSjl6QlBFOWEzQVZj?= =?utf-8?B?YXNPMlBIWE5uWVc5S1pBUE5oNmhyYXk4T29hSGNHc3N4TXBQeU1NOFIwTlFp?= =?utf-8?B?NktoNEc5dWZ1Y1k1UERVM0VVZGNaenJsNlFqL2pObk04Z1lwR3FlQkNJT1Fi?= =?utf-8?B?cnJGdG9VbCtybUNwNEVNc0FCNUl2Rnd0TDhMbC94V0JaU3JpZ2RZZTBTeld1?= =?utf-8?B?VnVQZmhQRE5FeUFpRE0rbTlTSnZ3V0lCRWZBb2dGSUNHRjh0TmZ3cGJtYjJU?= =?utf-8?B?ajBDdHdvM2ZDbmxDMld1QkNHbnNWemlBK1h5RjZ2YWcyQ1NQdGRkWk9tSENF?= =?utf-8?B?NFZDS0FJKzl1RkE3djA3SVZBRjJnalBsQnUwaTY0Zys2TlBuTVNobWRFMW1Q?= =?utf-8?B?SUYyR1JRNVl2RW1mRUhqZm5wUzVNejY4Y1kxMTJnbCtac3RaM3c2eUJMYVdQ?= =?utf-8?B?YTRFbEVnRElrNk90RWtIRXg2dm9Jb3hPZFpvdTJQQkdiczY2cUVKOURnTmcr?= =?utf-8?B?ZkxmNlJWL2lPcEhac3BXbVduT1JiZnozVmJ6ZHhoNVo1R2Rxd2ZSMUwrTHEz?= =?utf-8?B?UWtsMENWckREd1BsMGNoNXFpNnNiTzdqQkd6ZVczSW9qOFpvTVl5Y0lmMWY0?= =?utf-8?B?OS9BRlBDN2Y5TUxFbVcvYlZ3K0Jid21FdXgyWWl1NGVMYnRvalBQV3BPYnVr?= =?utf-8?B?cWJsRENpaTNZWUM3VGpUejJiUFpFdVpyeUcrcDNXUFIrUGRsdjJ4U2NrQ0Fz?= =?utf-8?B?RDJGbnRwVE9qMm8wSkRBV2trODlzZjFCOHJNYWs1NTdrODdyK3ZCTm5FdjdU?= =?utf-8?B?aE52TGRqYmFyUG1EbElKdjM0WUZpeFEvREk3THBVSmJHcm80aGJ4aENLckl3?= =?utf-8?B?VTdtbkd4Qm5BYzlvVDVMR09xTXhHTCtSRWVJWVVCR1VCVkJnbUp6Q2tXbU9n?= =?utf-8?B?RXU0SjVaenRZZVBDcEhjVE8ySFMrUkJTZW9ZMUkxR3h0TmNsSFIwcVBPK3Rz?= =?utf-8?B?eVNVeGZoaFFibzVNWStzWmpBandWZEdQY3dzOGxRZjJsdm13bWJsRTVMOHhy?= =?utf-8?Q?shAOZElmtSjPFjMgRwC4?= X-Microsoft-Antispam-Message-Info: Jlg2wimuQucHBfS9oDefksh9RA1z5NO4ekJ2oxIoMbmdHLt3bH6HcT8yc5D6LC9An5A2jy7BQJNWdlEBZ6P9EsyH/WdImPCdJLcRajg3r0FCaZ3XKKIEyvCGpG/2o2UWJCmxXs/8L3KIhVpujzk4EOtXnikvQW+CfDk+s/tCG9/FdgiLUW1rcrJa1sDb2LcI X-Microsoft-Exchange-Diagnostics: 1; HE1PR0402MB2777; 6:fnAqDZrbcaDaZssJHtrVn8rXrBUjTLz6zpaYDtrXsZ1RIMAZ0a+n5yFCPzWjDyDGtEnU0Ynk4l+WVihm7+2a8iXdW/wMWzkMybyr2E1tZVHEMdEb6iLYg6qId17A+k4MkjHZFhgHH1L7+yIJyLQiZlL+dW1UIdXSanNBeF9ss5hxUtVl+PbfyUlrSdX9+IDfjMWbGnfKUkJIF/KR7XbOyKRO4pByiIfDH6BR13+4jI22sm/03eiDf6ucu6X5qiIzVmRxc1ivGG29+HddTFSd6Hhu5AcpLVP36v0TltPCyO4XzF/xVXBbtBeHgZKlgWAa+RARSr8RQM5kcJb4cYNVH1NXpAy7YNlcMVcxcogh8RzgOyd6yK3l4MxoVB8VWjFoLl82QrvW2zZongdfoG60YXgSRVSAP8a+hvQcxLsg7CY0idJSb62WJ5MtH9qW9uJJPSducE/tGY0V70PiPmWNwg==; 5:3WRCo00x/22uz/2GmHl6qSkgh+soJ3x5WNFgSZahvbEBy0jNUOI+GDECDUbYsht35r+X3WH4rnqRnQF/V9NAXjIdetsnrHh4HNLx3x08xWtDy35wLVFo4kHCNfJ/ipzXT3DYziLWbo+/AGwG67aPm1KUB+7qf86W9/Fy7rT21ew=; 24:xodiGO9Ue++OV8wIdIlOhaXqaB64u9rFQaRJmPL6+QzyfCbI1pjA5chT1SIcDCJHqikaC5oDPpSTFeRpUxckPhmOFASrXghZO+gAT4ePIKE= SpamDiagnosticOutput: 1:99 SpamDiagnosticMetadata: NSPM X-Microsoft-Exchange-Diagnostics: 1; HE1PR0402MB2777; 7:SVbuJtkYCs6W1N/sHKHyqugYgjXwRhr9JvSekJdLLZHjooRloKb+KIIR+AXrA7wa+k1zaCdHdWwA4l3Xc8cfyJW7i8j8N54Noa0PZOXElQdBVHW4wUq588bv2Jln86UYM79LLwPhWkKpOZ0lMWoYsLGCPmGdd8om2MSQx5DAInTh77MQvraAf4D10CVOYSDjmFO5Ct97JbybAj2VhJEevidmghPXSYqwqfNlYJhkKno/28ra2LxGo7RuOkULnU8C X-MS-Office365-Filtering-Correlation-Id: 7fa85f3a-03a2-4cd8-2cf5-08d5cb758f42 X-OriginatorOrg: nxp.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 06 Jun 2018 06:20:09.3977 (UTC) X-MS-Exchange-CrossTenant-Network-Message-Id: 7fa85f3a-03a2-4cd8-2cf5-08d5cb758f42 X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted X-MS-Exchange-CrossTenant-Id: 686ea1d3-bc2b-4c6f-a92c-d99c5c301635 X-MS-Exchange-Transport-CrossTenantHeadersStamped: HE1PR0402MB2777 Subject: Re: [dpdk-dev] [PATCH] doc: add template release notes for 18.08 X-BeenThere: dev@dpdk.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: DPDK patches and discussions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 06 Jun 2018 06:20:13 -0000 On 6/5/2018 6:58 PM, Ferruh Yigit wrote: > On 6/5/2018 1:36 PM, Shreyansh Jain wrote: >> Hello Ferruh, >> >>> -----Original Message----- >>> From: Ferruh Yigit [mailto:ferruh.yigit@intel.com] >>> Sent: Tuesday, June 5, 2018 2:34 PM >>> To: Thomas Monjalon ; dev@dpdk.org >>> Cc: john.mcnamara@intel.com; marko.kovacevic@intel.com; Hemant Agrawal >>> ; Shreyansh Jain >>> Subject: Re: [dpdk-dev] [PATCH] doc: add template release notes for >>> 18.08 >>> >>> On 5/31/2018 10:11 PM, Thomas Monjalon wrote: >>>> Add template release notes for DPDK 18.08 with inline >>>> comments and explanations of the various sections. >>>> >>>> Signed-off-by: Thomas Monjalon >>> >>> <...> >>> >>>> +Shared Library Versions >>>> +----------------------- >>>> + >>>> +.. Update any library version updated in this release >>>> + and prepend with a ``+`` sign, like this: >>>> + >>>> + librte_acl.so.2 >>>> + + librte_cfgfile.so.2 >>>> + librte_cmdline.so.2 >>>> + >>>> + This section is a comment. Do not overwrite or remove it. >>>> + ========================================================= >>>> + >>>> +The libraries prepended with a plus sign were incremented in this >>> version. >>>> + >>>> +.. code-block:: diff >>>> + >>> <..> >>>> + librte_bus_dpaa.so.1 >>>> + librte_bus_fslmc.so.1 >>>> + librte_bus_pci.so.1 >>>> + librte_bus_vdev.so.1 >>> <..> >>>> + librte_common_octeontx.so.1 >>> <..> >>>> + librte_pmd_dpaa2_cmdif.so.1 >> >> cmdif doesn't expose any APIs for the user. It works through the librawdev APIs. >> >> drivers/raw/dpaa2_cmdif/± cat rte_pmd_dpaa2_cmdif_version.map >> DPDK_18.05 { >> >> local: *; >> }; >> >>>> + librte_pmd_dpaa2_qdma.so.1 >> >> QDMA driver indeed exposes various APIs for the user/application. >> >>> >>> Is above libraries provide any API for user application? >>> >>> It looks like they are for other internal libraries, if so should we >>> document >>> them here in release notes? >> >> You are suggesting that we add a note stating a particular library has no exposed APIs? I can't guess what use that information would be for a release note reader. >> That might be a note for the relevant documentation rst file, though. > > I suggest removing the library from release notes if it is only for internal > interface. Why user should concerned about version updates if the library is > internal only? Are you referring to removing from 18.05 release note (published) as well? Or, you are only referring to removing from template for 18.08? In principle, I have no objections in removing lib_pmd_dpaa2_cmdif from an exposed list of libraries as no application is going to use it directly. - Shreyansh