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 3D76AA00BE; Tue, 7 Jul 2020 19:08:28 +0200 (CEST) Received: from [92.243.14.124] (localhost [127.0.0.1]) by dpdk.org (Postfix) with ESMTP id 859731DE77; Tue, 7 Jul 2020 19:08:27 +0200 (CEST) Received: from new1-smtp.messagingengine.com (new1-smtp.messagingengine.com [66.111.4.221]) by dpdk.org (Postfix) with ESMTP id 53B1A1DE6E for ; Tue, 7 Jul 2020 19:08:26 +0200 (CEST) Received: from compute7.internal (compute7.nyi.internal [10.202.2.47]) by mailnew.nyi.internal (Postfix) with ESMTP id BD97D580421; Tue, 7 Jul 2020 13:08:25 -0400 (EDT) Received: from mailfrontend2 ([10.202.2.163]) by compute7.internal (MEProxy); Tue, 07 Jul 2020 13:08:25 -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= dYXa5YhOnHBagVMiYJYRhPU7jdq20uXzhhiaTCB9idM=; b=IRs9PbzFDnc6+dbi GNOP1kxviQ8eEpjIkmS/yU9qeLtlOojCEbcMK/lxx17tZ8m1uAVsQWxZQlTKcGYr SvnH5GJ0a/tzZ23ouofGAr0a8uWljgUMz2OF6UTPb1HmgqKmHS3Asw92duXSnfyS mssKgtCRbjwQHdZzjoD7cXA63p9+rYzx/1mV2E1WOFn4upBnUbaxF9BE2UdBGhr5 bMnaMDlb37esUFP1FadEr2U1Y/tsUsmNEiz9i0uQNtNg3x2b2tMm3SHlV0TgzR+x lUhmYgJlc46KmR1HkiuL/rWsQj0ZAba7aVWUYIo/tlrFEQQKSJQJndNJOs+znPis WvZ00w== 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=dYXa5YhOnHBagVMiYJYRhPU7jdq20uXzhhiaTCB9i dM=; b=Ssn163ylheH2sjkUBlTirgm/yAznDJdwg1uoqTmrRZhQYrmA171PUXbV5 N3Dkdsd41wsXME3cx563O88V0ScwpCc1ctEKdnRr7HN8f6eSKnQqOiPbH0SexG3t bjKv0dYzDa4Aw5ibYG/t2nrkhgVyJdIXNQlQTvTdxmMd2opYNWxLstNJcfVFGBzw a6VriRXkWL+BnlTa3+qG5t72d289BFMpOJSTfoHf5awE5aT99qThLwCfDZJd9jLj CznNyTPCuWmzRIZdzUxf0HLqGeCns9PdIUpST3CPgtT3jAe43c1g3xDqCl2Qd7Nv zXwiPDiM5saO9Fhui267ahXpQX5Sg== X-ME-Sender: X-ME-Proxy-Cause: gggruggvucftvghtrhhoucdtuddrgeduiedrudehgddutdefucetufdoteggodetrfdotf 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 B82A230600A6; Tue, 7 Jul 2020 13:08:23 -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 19:08:22 +0200 Message-ID: <3268992.TtKfxP2iOo@thomas> In-Reply-To: References: <1594133126-2518-1-git-send-email-mdr@ashroe.eu> <3753229.KUAPmvbx1T@thomas> 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 19:01, Kinsella, Ray: > On 07/07/2020 17:57, Thomas Monjalon wrote: > > 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. > > It doesn't make _any_ sense to maintain an alias after the new ABI. > > The alias is there to maintain ABI compatibility, > there is no reason to maintain compatibility in the new ABI - so it should be dropped Yes I was wrong, sorry.