From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: <dev-bounces@dpdk.org> Received: from dpdk.org (dpdk.org [92.243.14.124]) by inbox.dpdk.org (Postfix) with ESMTP id 3F713A00BE; Tue, 7 Jul 2020 17:26:35 +0200 (CEST) Received: from [92.243.14.124] (localhost [127.0.0.1]) by dpdk.org (Postfix) with ESMTP id 7BBE01DE74; Tue, 7 Jul 2020 17:26:34 +0200 (CEST) Received: from new3-smtp.messagingengine.com (new3-smtp.messagingengine.com [66.111.4.229]) by dpdk.org (Postfix) with ESMTP id 88D251DDD8 for <dev@dpdk.org>; Tue, 7 Jul 2020 17:26:32 +0200 (CEST) Received: from compute7.internal (compute7.nyi.internal [10.202.2.47]) by mailnew.nyi.internal (Postfix) with ESMTP id 1E9C15801D1; Tue, 7 Jul 2020 11:26:32 -0400 (EDT) Received: from mailfrontend2 ([10.202.2.163]) by compute7.internal (MEProxy); Tue, 07 Jul 2020 11:26:32 -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= IxRi00qvbJqnTstC7Yfl+6UCNa3gJUJwLAg3dNHSGYs=; b=JReUnw4WkSo3l/Fr 8tUX2g5KUg6T0PD8UckJ2HguNCc6rNwCB0W/X3ucn2V5JWAYCitF9f6/Aad62gcV PlRZEGMtYIiyv8gRyCL2wpNED9dfsT0vmv4MAUES0/hh6BAeHm2ikyRKMKJaHT0E SIihwkNUaFroan/M/CpAWROMurMmEUaeS873MD2Qw2/s/elvQUPq8ECf8OU+Fuv0 npBFkAjBG+fpbmrEismyVYksxIFVpYOtA3YU4pn+2EpiY90o+ekI2ORa/WbujhPp WKrO8SgGSoOQey9CvJHk+vcqiIvFDGemCigj1XqzfoNy1JyCyDLKT3SvjfGPpfuh oecyAQ== 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=IxRi00qvbJqnTstC7Yfl+6UCNa3gJUJwLAg3dNHSG Ys=; b=tx8TIlFPicqSdud29/fNWuZld/o75iBPHMB/62w9wgDiG1Gf85fKjC6l4 CnPLmjRL66h+zca2qtsfxGAzEQmUwk9+V5HV7pr5nQYs+k2WGeuXDbFNi4Tt+3Eb /J13npxIuxiPfvTTKVXhdXDPIHc3p3cTz+qEWTidHHs9rH5Cdaww6GixfC00oMvq Ro9u+cmzKRVxwEt8jdk8BPvraUR91vmVTKuj0ee0NJzUH8D7HC3KuXxXFczKOaCm 8qVbYEuuMGj9R1smI1JXiAz4crIkCYd0v9VsCzT1jXpNK0tnpkD4/q+j/t5Ns4v0 uf6h3Ngzn2rTKEFW4QPfiHEL86ELg== X-ME-Sender: <xms:J5QEX4uwA6iaI5H5tFpBbbty4qxjaKd1T3E3XppfTWXwj_pd37UM7Q> X-ME-Proxy-Cause: gggruggvucftvghtrhhoucdtuddrgeduiedrudehgdekfecutefuodetggdotefrodftvf curfhrohhfihhlvgemucfhrghsthforghilhdpqfgfvfdpuffrtefokffrpgfnqfghnecu uegrihhlohhuthemuceftddtnecusecvtfgvtghiphhivghnthhsucdlqddutddtmdenuc fjughrpefhvffufffkjghfggfgtgesthfuredttddtvdenucfhrhhomhepvfhhohhmrghs ucfoohhnjhgrlhhonhcuoehthhhomhgrshesmhhonhhjrghlohhnrdhnvghtqeenucggtf frrghtthgvrhhnpedugefgvdefudfftdefgeelgffhueekgfffhfeujedtteeutdejueei iedvffegheenucfkphepjeejrddufeegrddvtdefrddukeegnecuvehluhhsthgvrhfuih iivgeptdenucfrrghrrghmpehmrghilhhfrhhomhepthhhohhmrghssehmohhnjhgrlhho nhdrnhgvth X-ME-Proxy: <xmx:J5QEX1cpSWyhEtWh9_u0QKh7TO-V0kBUuq_o0E2tOJD2kJefUQ49JQ> <xmx:J5QEXzwc31v2YxynkQcozB4yS2-Tea1cN8B8JCwc_nHlWoMVhemUcg> <xmx:J5QEX7NZkOWGOQz0SswUWhP7VeQXNK5k0OJG-nnl1tuEK_gUJpLJmA> <xmx:KJQEXzZNi0wFYKrl1qXr-J-WBXvXDFX7PBlsNyyxR_wT44PpwPy5LQ> Received: from xps.localnet (184.203.134.77.rev.sfr.net [77.134.203.184]) by mail.messagingengine.com (Postfix) with ESMTPA id 4997C30600B1; Tue, 7 Jul 2020 11:26:30 -0400 (EDT) From: Thomas Monjalon <thomas@monjalon.net> To: Ray Kinsella <mdr@ashroe.eu> Cc: dev@dpdk.org, fady@mellanox.com, Honnappa.Nagarahalli@arm.com, Ray Kinsella <mdr@ashroe.eu>, Neil Horman <nhorman@tuxdriver.com>, John McNamara <john.mcnamara@intel.com>, Marko Kovacevic <marko.kovacevic@intel.com>, Harini Ramakrishnan <harini.ramakrishnan@microsoft.com>, Omar Cardona <ocardona@microsoft.com>, Pallavi Kadam <pallavi.kadam@intel.com>, Ranjit Menon <ranjit.menon@intel.com>, david.marchand@redhat.com, nhorman@tuxdriver.com, bruce.richardson@intel.com Date: Tue, 07 Jul 2020 17:26:29 +0200 Message-ID: <2116547.mo2HYodoZD@thomas> In-Reply-To: <1594133126-2518-3-git-send-email-mdr@ashroe.eu> References: <1594133126-2518-1-git-send-email-mdr@ashroe.eu> <1594133126-2518-3-git-send-email-mdr@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 <dev.dpdk.org> List-Unsubscribe: <https://mails.dpdk.org/options/dev>, <mailto:dev-request@dpdk.org?subject=unsubscribe> List-Archive: <http://mails.dpdk.org/archives/dev/> List-Post: <mailto:dev@dpdk.org> List-Help: <mailto:dev-request@dpdk.org?subject=help> List-Subscribe: <https://mails.dpdk.org/listinfo/dev>, <mailto:dev-request@dpdk.org?subject=subscribe> Errors-To: dev-bounces@dpdk.org Sender: "dev" <dev-bounces@dpdk.org> 07/07/2020 16:45, Ray Kinsella: > Clarify retention period for aliases to experimental. > > Signed-off-by: Ray Kinsella <mdr@ashroe.eu> > --- > --- 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. > +alias will then typically be dropped in the next major ABI version. I don't see the need for the time estimation.