From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from dpdk.org (dpdk.org [92.243.14.124]) by inbox.dpdk.org (Postfix) with ESMTP id 8995CA00BE; Tue, 7 Jul 2020 18:57:15 +0200 (CEST) Received: from [92.243.14.124] (localhost [127.0.0.1]) by dpdk.org (Postfix) with ESMTP id 542511DE23; Tue, 7 Jul 2020 18:57:15 +0200 (CEST) Received: from new1-smtp.messagingengine.com (new1-smtp.messagingengine.com [66.111.4.221]) by dpdk.org (Postfix) with ESMTP id B3B4A1DD9B for ; Tue, 7 Jul 2020 18:57:13 +0200 (CEST) Received: from compute7.internal (compute7.nyi.internal [10.202.2.47]) by mailnew.nyi.internal (Postfix) with ESMTP id EFA8D580451; Tue, 7 Jul 2020 12:57:12 -0400 (EDT) Received: from mailfrontend2 ([10.202.2.163]) by compute7.internal (MEProxy); Tue, 07 Jul 2020 12:57:12 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=monjalon.net; h= from:to:cc:subject:date:message-id:in-reply-to:references :mime-version:content-transfer-encoding:content-type; s=fm1; bh= 6yHOVQjxUhG10sBPyWP1Gcz6g60Do23FIBxQqe48BXo=; b=hBMubwCz2cl/UxVS 52Mk9We70Pms3CeEH0PJ9wRJsn2tXbrRUjIlCAj36igxeZmicUyB8o9O5fjsputc HxPUZ7X35jjUn5daFpZlmpmisfHOhlcFnhc/j9IQW4xdqxZBXzJs58RCSYGCiRq/ LgBuM88qMb1oAmJQI9mGn7bkoguyZIlsfiNwwYeM1gnKVKRWlr7OXJ3TYHw0nj2w VS3M1Nay76xBkunIywCoVprita4RPGb0De4egBtOegC9dejELWw1JMThPSAdpIyl mvXf32N4WSwBj9CZ5YJc1hV7u7LKarhiTWDvS+pZ+oM9qJY/lpOQwct08rC8hUb/ 9LsyBw== DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d= messagingengine.com; h=cc:content-transfer-encoding:content-type :date:from:in-reply-to:message-id:mime-version:references :subject:to:x-me-proxy:x-me-proxy:x-me-sender:x-me-sender :x-sasl-enc; s=fm3; bh=6yHOVQjxUhG10sBPyWP1Gcz6g60Do23FIBxQqe48B Xo=; b=rajVpjZ6oPpExqcFdj/m6+SFmovfUdi+XvLsMC4JGwrxKglRbWOQL4MpH ZkjAcoD4SH7DrIPm4XWJ0z3NqYvSLlumNWF1sppcfkK64/ybYpTxlH6/qozRqwuC Wl5ebCW9mjUjQGYLViKNZKSJtv86KIyMnD5kxRFYG21oHeKtq23UgvIPiecoJ1IZ LR2HgSTf13/OPtjsG58rqu4CkwWgl0qtNSkpUiqppwjQa4wPyZMbjqPiTRU4qAJD T0lvhtYb0XAw/L7R2P5uDCP1ldiSrB8e5IdSKcwoWXpd+yHWGOHreUCGjwAcDAad h2TYySUAMLeuTUdCEpE6G5R+VrYzw== X-ME-Sender: X-ME-Proxy-Cause: gggruggvucftvghtrhhoucdtuddrgeduiedrudehgddutdduucetufdoteggodetrfdotf fvucfrrhhofhhilhgvmecuhfgrshhtofgrihhlpdfqfgfvpdfurfetoffkrfgpnffqhgen uceurghilhhouhhtmecufedttdenucesvcftvggtihhpihgvnhhtshculddquddttddmne cujfgurhephffvufffkfgjfhgggfgtsehtufertddttddvnecuhfhrohhmpefvhhhomhgr shcuofhonhhjrghlohhnuceothhhohhmrghssehmohhnjhgrlhhonhdrnhgvtheqnecugg ftrfgrthhtvghrnhepudeggfdvfeduffdtfeeglefghfeukefgfffhueejtdetuedtjeeu ieeivdffgeehnecukfhppeejjedrudefgedrvddtfedrudekgeenucevlhhushhtvghruf hiiigvpedtnecurfgrrhgrmhepmhgrihhlfhhrohhmpehthhhomhgrshesmhhonhhjrghl ohhnrdhnvght X-ME-Proxy: Received: from xps.localnet (184.203.134.77.rev.sfr.net [77.134.203.184]) by mail.messagingengine.com (Postfix) with ESMTPA id B3A8A30600A6; Tue, 7 Jul 2020 12:57:10 -0400 (EDT) From: Thomas Monjalon To: "Kinsella, Ray" Cc: dev@dpdk.org, fady@mellanox.com, Honnappa.Nagarahalli@arm.com, Neil Horman , John McNamara , Marko Kovacevic , Harini Ramakrishnan , Omar Cardona , Pallavi Kadam , Ranjit Menon , david.marchand@redhat.com, bruce.richardson@intel.com Date: Tue, 07 Jul 2020 18:57:09 +0200 Message-ID: <3753229.KUAPmvbx1T@thomas> In-Reply-To: <97d6e4fb-4fd3-e161-7b95-8ff3d505f2e7@ashroe.eu> References: <1594133126-2518-1-git-send-email-mdr@ashroe.eu> <3262308.1Tv495sWla@thomas> <97d6e4fb-4fd3-e161-7b95-8ff3d505f2e7@ashroe.eu> MIME-Version: 1.0 Content-Transfer-Encoding: 7Bit Content-Type: text/plain; charset="us-ascii" Subject: Re: [dpdk-dev] [PATCH v1 2/2] doc: clarify alias to experimental period 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: , Errors-To: dev-bounces@dpdk.org Sender: "dev" 07/07/2020 18:37, Kinsella, Ray: > > On 07/07/2020 17:36, Thomas Monjalon wrote: > > 07/07/2020 18:35, Kinsella, Ray: > >> On 07/07/2020 16:26, Thomas Monjalon wrote: > >>> 07/07/2020 16:45, Ray Kinsella: > >>>> Clarify retention period for aliases to experimental. > >>>> > >>>> Signed-off-by: Ray Kinsella > >>>> --- > >>>> --- a/doc/guides/contributing/abi_versioning.rst > >>>> +++ b/doc/guides/contributing/abi_versioning.rst > >>>> @@ -158,7 +158,7 @@ The macros exported are: > >>>> * ``VERSION_SYMBOL_EXPERIMENTAL(b, e)``: Creates a symbol version table entry > >>>> binding versioned symbol ``b@EXPERIMENTAL`` to the internal function ``be``. > >>>> The macro is used when a symbol matures to become part of the stable ABI, to > >>>> - provide an alias to experimental for some time. > >>>> + provide an alias to experimental until the next major ABI version. > >>> > >>> Why limiting the period for experimental status? > >>> Some API want to remain experimental longer. > >>> > >>> [...] > >>>> +alias will then typically be dropped in the next major ABI version. > >>> > >>> I don't see the need for the time estimation. > >> > >> Will reword to ... > >> > >> "This alias will then be dropped in the next major ABI version." > > > > It is not addressing my first comment. Please see above. > > Thank you, I don't necessarily agree with the first comment :-) You don't have to agree. But in this case we must discuss :-) > We need to say when the alias should be dropped no? I don't think so. Until now, it is let to the appreciation of the maintainer. If we want to change the rule, especially for experimental period, it must be said clearly and debated.