From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: <john.mcnamara@intel.com> Received: from mga02.intel.com (mga02.intel.com [134.134.136.20]) by dpdk.org (Postfix) with ESMTP id 17F91E5D for <dev@dpdk.org>; Tue, 12 Dec 2017 15:33:16 +0100 (CET) X-Amp-Result: SKIPPED(no attachment in message) X-Amp-File-Uploaded: False Received: from fmsmga005.fm.intel.com ([10.253.24.32]) by orsmga101.jf.intel.com with ESMTP/TLS/DHE-RSA-AES256-GCM-SHA384; 12 Dec 2017 06:33:15 -0800 X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.45,395,1508828400"; d="scan'208";a="185995437" Received: from irsmsx102.ger.corp.intel.com ([163.33.3.155]) by fmsmga005.fm.intel.com with ESMTP; 12 Dec 2017 06:33:14 -0800 Received: from irsmsx103.ger.corp.intel.com ([169.254.3.49]) by IRSMSX102.ger.corp.intel.com ([169.254.2.180]) with mapi id 14.03.0319.002; Tue, 12 Dec 2017 14:33:14 +0000 From: "Mcnamara, John" <john.mcnamara@intel.com> To: Neil Horman <nhorman@tuxdriver.com>, "dev@dpdk.org" <dev@dpdk.org> CC: "thomas@monjalon.net" <thomas@monjalon.net>, "Richardson, Bruce" <bruce.richardson@intel.com> Thread-Topic: [PATCHv3 0/4] dpdk: enhance EXPERIMENTAL api tagging Thread-Index: AQHTcrd2H2R6r09p4UCz0I3g8pQKPKM/xbyw Date: Tue, 12 Dec 2017 14:33:13 +0000 Message-ID: <B27915DBBA3421428155699D51E4CFE23EE22EEA@IRSMSX103.ger.corp.intel.com> References: <20171201185628.16261-1-nhorman@tuxdriver.com> <20171211193619.21643-1-nhorman@tuxdriver.com> In-Reply-To: <20171211193619.21643-1-nhorman@tuxdriver.com> Accept-Language: en-GB, en-US Content-Language: en-US X-MS-Has-Attach: X-MS-TNEF-Correlator: x-ctpclassification: CTP_IC x-titus-metadata-40: eyJDYXRlZ29yeUxhYmVscyI6IiIsIk1ldGFkYXRhIjp7Im5zIjoiaHR0cDpcL1wvd3d3LnRpdHVzLmNvbVwvbnNcL0ludGVsMyIsImlkIjoiMWE3MTRmZWItMjYwNS00MjU4LWIyMzItM2RhM2I5YWUzMDQxIiwicHJvcHMiOlt7Im4iOiJDVFBDbGFzc2lmaWNhdGlvbiIsInZhbHMiOlt7InZhbHVlIjoiQ1RQX0lDIn1dfV19LCJTdWJqZWN0TGFiZWxzIjpbXSwiVE1DVmVyc2lvbiI6IjE2LjUuOS4zIiwiVHJ1c3RlZExhYmVsSGFzaCI6IlFZTlZKOHJ0dktYallkWUt2dUVhc01HZ3BqaVNcL1hEdUtDa2ZlbGptVW5zPSJ9 dlp-product: dlpe-windows dlp-version: 11.0.0.116 dlp-reaction: no-action x-originating-ip: [163.33.239.181] Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: quoted-printable MIME-Version: 1.0 Subject: Re: [dpdk-dev] [PATCHv3 0/4] dpdk: enhance EXPERIMENTAL api tagging X-BeenThere: dev@dpdk.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: DPDK patches and discussions <dev.dpdk.org> List-Unsubscribe: <http://dpdk.org/ml/options/dev>, <mailto:dev-request@dpdk.org?subject=unsubscribe> List-Archive: <http://dpdk.org/ml/archives/dev/> List-Post: <mailto:dev@dpdk.org> List-Help: <mailto:dev-request@dpdk.org?subject=help> List-Subscribe: <http://dpdk.org/ml/listinfo/dev>, <mailto:dev-request@dpdk.org?subject=subscribe> X-List-Received-Date: Tue, 12 Dec 2017 14:33:17 -0000 > -----Original Message----- > From: Neil Horman [mailto:nhorman@tuxdriver.com] > Sent: Monday, December 11, 2017 7:36 PM > To: dev@dpdk.org > Cc: thomas@monjalon.net; Mcnamara, John <john.mcnamara@intel.com>; > Richardson, Bruce <bruce.richardson@intel.com> > Subject: [PATCHv3 0/4] dpdk: enhance EXPERIMENTAL api tagging >=20 > Hey all- > A few days ago, I was lamenting the fact that, when reviewing > patches I would frequently complain about ABI changes that were actually > considered safe because they were part of the EXPERIMENTAL api set. John > M. asked me then what I might do to improve the situation, and the > following patch set is a proposal that I've come up with. Hi Neil, Thanks for this and apologies in advance for making more work for you but it would be good to have a short section in the Contributors Guide on how to add/check experimental APIs. I think the information in this cover letter could be repurposed along with a few code and shell examples. Probably as a new high level section in the Contributors Guides: http://dpdk.org/doc/guides/contributing/index.html Thanks, John