From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mga07.intel.com (mga07.intel.com [134.134.136.100]) by dpdk.org (Postfix) with ESMTP id C98F51066 for ; Mon, 23 Apr 2018 13:17:16 +0200 (CEST) X-Amp-Result: SKIPPED(no attachment in message) X-Amp-File-Uploaded: False Received: from fmsmga007.fm.intel.com ([10.253.24.52]) by orsmga105.jf.intel.com with ESMTP/TLS/DHE-RSA-AES256-GCM-SHA384; 23 Apr 2018 04:17:13 -0700 X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.49,318,1520924400"; d="scan'208";a="33946426" Received: from dwdohert-mobl.ger.corp.intel.com (HELO [163.33.228.206]) ([163.33.228.206]) by fmsmga007.fm.intel.com with ESMTP; 23 Apr 2018 04:17:10 -0700 To: Shahaf Shuler , Adrien Mazarguil Cc: "dev@dpdk.org" , Alex Rosenbaum , Ferruh Yigit , Thomas Monjalon , Qi Zhang , Alejandro Lucero , Andrew Rybchenko , Mohammad Abdul Awal , Remy Horton , John McNamara , Rony Efraim , Jingjing Wu , Wenzhuo Lu , Vincent Jardin , Yuanhan Liu , Bruce Richardson , Konstantin Ananyev , Zhihong Wang References: <1523017443-12414-1-git-send-email-declan.doherty@intel.com> <20180418210423.13847-1-declan.doherty@intel.com> <20180418210423.13847-2-declan.doherty@intel.com> <20180419130307.GY4957@6wind.com> From: "Doherty, Declan" Message-ID: <0aff3015-b8f7-2abe-984c-f8f4ff2251d6@intel.com> Date: Mon, 23 Apr 2018 12:17:09 +0100 User-Agent: Mozilla/5.0 (Windows NT 10.0; WOW64; rv:52.0) Gecko/20100101 Thunderbird/52.7.0 MIME-Version: 1.0 In-Reply-To: Content-Type: text/plain; charset=utf-8; format=flowed Content-Language: en-US Content-Transfer-Encoding: 7bit Subject: Re: [dpdk-dev] [PATCH v4 1/6] ethdev: Add tunnel encap/decap actions 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: Mon, 23 Apr 2018 11:17:17 -0000 On 23/04/2018 12:00 PM, Shahaf Shuler wrote: > Thursday, April 19, 2018 4:03 PM, Adrien Mazarguil: >> Subject: Re: [dpdk-dev] [PATCH v4 1/6] ethdev: Add tunnel encap/decap >> actions >> >> On Wed, Apr 18, 2018 at 10:04:18PM +0100, Declan Doherty wrote: > > [...] > >> >> I'm still unsure about the definition involving a list of items. I imagined >> these actions even less generic than that. How about tagging them >> EXPERIMENTAL until sorted out through the first PMD implementation? > > I think every new API should be marked as experimental. At least for one release. > Here in specific, because there is no actual implementation of those APIs in any of the drivers. > On this, since these are just new structures to use with existing APIs is using the following tag in the doxygen comments sufficient? /** * @warning * @b EXPERIMENTAL: this structure may change without prior notice */ >> >> (We could even provide forward declarations only to prevent applications >> from using them in the meantime.) >> >> -- >> Adrien Mazarguil >> 6WIND