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 2F1D4A04B4; Fri, 8 Nov 2019 18:12:02 +0100 (CET) Received: from [92.243.14.124] (localhost [127.0.0.1]) by dpdk.org (Postfix) with ESMTP id 8BD041C440; Fri, 8 Nov 2019 18:12:01 +0100 (CET) Received: from new1-smtp.messagingengine.com (new1-smtp.messagingengine.com [66.111.4.221]) by dpdk.org (Postfix) with ESMTP id 9E8211C2EE for ; Fri, 8 Nov 2019 18:12:00 +0100 (CET) Received: from compute1.internal (compute1.nyi.internal [10.202.2.41]) by mailnew.nyi.internal (Postfix) with ESMTP id EBE2B4B8C; Fri, 8 Nov 2019 12:11:59 -0500 (EST) Received: from mailfrontend1 ([10.202.2.162]) by compute1.internal (MEProxy); Fri, 08 Nov 2019 12:11:59 -0500 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=mesmtp; bh=szrlvIKedR1TNB4jo5HD2sETNTI8VHHpzvWHDJiuvh4=; b=js/Bnno97mva bzopx3648m9mDsx5V4sNZFJdXdVyZqjAJKO6ImLgVSjfH2LaDAloGfVgRfmHUU0Q OQrJI3EPnm087nv1nS4nyORsrFwmZyJWFnkqfqH6J1treWyeUdaVjh6lqANsutxO wxjSocmOOj3iczaagBYX5K0k68i00Lo= 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=fm1; bh=szrlvIKedR1TNB4jo5HD2sETNTI8VHHpzvWHDJiuv h4=; b=K1eU12122OVuuiAqKCSzFXPh4OMBLTVVkSACR8pU37vpEuZp2/IntweEK +hLGzRVdm2g0pobghEXtuJWgE569CtpAYCdTFrN2BERUu1vtS8IgqcvigrazePkf D/BxgoS6Y8o0bA5vKwBlG4g2lEGq2JJOY8jO2mYauXALtT6AF01HObarf99byyLy AT9X8ONxv1UMuVgtOsvpIDob0z/fmQMPUsRSCKoMDlVcSFGNG8e3SSf10fweflH3 oeJmjok8bvnYINdJ+K+1WNsJGWEkEDDze/RbydwhvHP5B2hHjU3LyHoXsuyPBWzk O0dOPWKvN1D7HjL85vZjl4L7dAwMg== X-ME-Sender: X-ME-Proxy-Cause: gggruggvucftvghtrhhoucdtuddrgedufedruddvuddguddttdcutefuodetggdotefrod ftvfcurfhrohhfihhlvgemucfhrghsthforghilhdpqfgfvfdpuffrtefokffrpgfnqfgh necuuegrihhlohhuthemuceftddtnecunecujfgurhephffvufffkfgjfhgggfgtsehtuf ertddttddvnecuhfhrohhmpefvhhhomhgrshcuofhonhhjrghlohhnuceothhhohhmrghs sehmohhnjhgrlhhonhdrnhgvtheqnecukfhppeejjedrudefgedrvddtfedrudekgeenuc frrghrrghmpehmrghilhhfrhhomhepthhhohhmrghssehmohhnjhgrlhhonhdrnhgvthen ucevlhhushhtvghrufhiiigvpedt 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 E7FAC80060; Fri, 8 Nov 2019 12:11:55 -0500 (EST) From: Thomas Monjalon To: Ray Kinsella Cc: dev@dpdk.org, stephen@networkplumber.org, bruce.richardson@intel.com, ferruh.yigit@intel.com, konstantin.ananyev@intel.com, jerinj@marvell.com, olivier.matz@6wind.com, nhorman@tuxdriver.com, maxime.coquelin@redhat.com, john.mcnamara@intel.com, marko.kovacevic@intel.com, hemant.agrawal@nxp.com, ktraynor@redhat.com, aconole@redhat.com Date: Fri, 08 Nov 2019 18:11:54 +0100 Message-ID: <2317884.hZJoXfvIJl@xps> In-Reply-To: <1573217185-4101-3-git-send-email-mdr@ashroe.eu> References: <1573217185-4101-1-git-send-email-mdr@ashroe.eu> <1573217185-4101-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 v9 2/4] doc: changes to abi policy introducing major abi versions 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" 08/11/2019 13:46, Ray Kinsella: > This policy change introduces major ABI versions, these are > declared every year, typically aligned with the LTS release > and are supported by subsequent releases in the following year. > This change is intended to improve ABI stabilty for those projects > consuming DPDK. > > Signed-off-by: Ray Kinsella > Acked-by: John Mcnamara > Acked-by: Stephen Hemminger Acked-by: Thomas Monjalon > --- > +#. Major ABI versions are declared no more frequently than yearly. Compatibility > + with the major ABI version is mandatory in subsequent releases until a new > + major ABI version is declared. > +#. Major ABI version are usually but not always declared aligned with a > + :ref:`LTS release `. OK thanks > +#. The ABI version is managed at a project level in DPDK, with the ABI version > + reflected in all library's soname. It is not specifying the experimental lib exception. But I can live without it. > +A new major ABI version is declared no more frequently than yearly, with > +declarations usually aligning with a LTS release, e.g. ABI 20 for DPDK 19.11. > +Compatibility with the major ABI version is then mandatory in subsequent > +releases until the next major ABI version is declared, e.g. ABI 21 for DPDK > +20.11. OK thanks > + Note that, this policy details the method by which the ABI may be changed, > + with due regard to preserving compatibility and observing deprecation > + notices. This process however should not be undertaken lightly, as a general > + rule ABI stability is extremely important for downstream consumers of DPDK. > + The API should only be changed for significant reasons, such as performance > + enhancements. API breakages due to changes such as reorganizing public > + structure fields for aesthetic or readability purposes should be avoided. OK thanks > +Libraries marked as ``experimental`` are entirely not considered part of an ABI > +version, and may change without warning at any time. Experimental libraries > +always have a major version of ``0`` to indicate they exist outside of > +ABI Versioning, with the minor version incremented with each ABI change > +to library. OK