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 305C6A00BE; Tue, 7 Jul 2020 18:36:46 +0200 (CEST) Received: from [92.243.14.124] (localhost [127.0.0.1]) by dpdk.org (Postfix) with ESMTP id 05B651DD89; Tue, 7 Jul 2020 18:36:46 +0200 (CEST) Received: from new3-smtp.messagingengine.com (new3-smtp.messagingengine.com [66.111.4.229]) by dpdk.org (Postfix) with ESMTP id 3B2301DD3B for ; Tue, 7 Jul 2020 18:36:44 +0200 (CEST) Received: from compute7.internal (compute7.nyi.internal [10.202.2.47]) by mailnew.nyi.internal (Postfix) with ESMTP id 80566580251; Tue, 7 Jul 2020 12:36:42 -0400 (EDT) Received: from mailfrontend1 ([10.202.2.162]) by compute7.internal (MEProxy); Tue, 07 Jul 2020 12:36:42 -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= fdfMsHdiVc+i8m/ZG4RRecMbZMLc73q52JCh7Iw7Wxk=; b=CPkHitaaSXkGP0hZ MYnURewh3Swx5of13/8JnhCIEr+t1tytlgDlVrBaAqPLNy2pvPUUFnBD1VTSXiKG q7dDWxBMKvhRXlZWYXmpztgZ/RQgFaABdLJEQmAZbEYDgmiiaz/8ehYV9f32z7+o UKl+zsRp7rGfeae88IBpbKgKotPWPU0cA7fw6TU8Dx9xsT5qTzVTLRcAL1c1Y0xS JuVCCnc7juKUAPV+muIzmB0umGB/qpc7pFSJLmZT03ty1ZSkLg0/VbWiXH6aTVLg mPRDt6x7qmLpnzzfd0WIXB9N3utA/8tZjP7RmjZ8vGZRVyo2MCFR0VpuevPZN5oN pd0dbw== 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=fdfMsHdiVc+i8m/ZG4RRecMbZMLc73q52JCh7Iw7W xk=; b=O4tITgYXLJGr1eh98IY/6XEyNCL6jjXLkn0VtdQA3r2tWBzyB9OiXUCyy 1SHrdun62PFr8IeSN/lMtjaE6BZ5c0RgdwyLdHEJQxOlHOB3rWwdVJ99DNNLWzeb VqeXs6Rvjfxd2TLNeoSuBWu2MDCH4FebBFmjiSBHd/vXiCrqLmTFRCg5ycfmLJ0+ N2JcC4u5V1iIAzWbdK9fkSBZWxPyN84m7YYH4n2byiDeyHh9/0LLKF9g9Co+BI66 gL8e+2T6h8ar2sVDnvoofJ7f0Ybib2R39NL3af5qSbgHQiTx2Xb8XKNgosbaZ8L+ Lq3zq+B9wWYggj5IsB+7u+3L66bVw== X-ME-Sender: X-ME-Proxy-Cause: gggruggvucftvghtrhhoucdtuddrgeduiedrudehgdeljecutefuodetggdotefrodftvf curfhrohhfihhlvgemucfhrghsthforghilhdpqfgfvfdpuffrtefokffrpgfnqfghnecu uegrihhlohhuthemuceftddtnecusecvtfgvtghiphhivghnthhsucdlqddutddtmdenuc fjughrpefhvffufffkjghfggfgtgesthfuredttddtvdenucfhrhhomhepvfhhohhmrghs ucfoohhnjhgrlhhonhcuoehthhhomhgrshesmhhonhhjrghlohhnrdhnvghtqeenucggtf frrghtthgvrhhnpedugefgvdefudfftdefgeelgffhueekgfffhfeujedtteeutdejueei iedvffegheenucfkphepjeejrddufeegrddvtdefrddukeegnecuvehluhhsthgvrhfuih iivgeptdenucfrrghrrghmpehmrghilhhfrhhomhepthhhohhmrghssehmohhnjhgrlhho nhdrnhgvth 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 1E7EE3280066; Tue, 7 Jul 2020 12:36:40 -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:36:38 +0200 Message-ID: <3262308.1Tv495sWla@thomas> In-Reply-To: <955b01b8-faad-5c77-24ed-6a96f5c58929@ashroe.eu> References: <1594133126-2518-1-git-send-email-mdr@ashroe.eu> <2116547.mo2HYodoZD@thomas> <955b01b8-faad-5c77-24ed-6a96f5c58929@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: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. > > > > [...] > >> In situations in which an ``experimental`` symbol has been stable for some time, > >> and it becomes a candidate for promotion to the stable ABI. At this time, when > >> -promoting the symbol, maintainer may choose to provide an alias to the > >> -``experimental`` symbol version, so as not to break consuming applications. > >> +promoting the symbol, the maintainer may choose to provide an alias to the > >> +``experimental`` symbol version, so as not to break consuming applications. This > > > > Please start a sentence on a new line. > > ACK > > > > >> +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.