From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from smtp.tuxdriver.com (charlotte.tuxdriver.com [70.61.120.58]) by dpdk.org (Postfix) with ESMTP id 60CEE58F7 for ; Wed, 14 Jan 2015 21:07:35 +0100 (CET) Received: from hmsreliant.think-freely.org ([2001:470:8:a08:7aac:c0ff:fec2:933b] helo=localhost) by smtp.tuxdriver.com with esmtpsa (TLSv1:AES128-SHA:128) (Exim 4.63) (envelope-from ) id 1YBUDy-0004lT-JM; Wed, 14 Jan 2015 15:07:32 -0500 Date: Wed, 14 Jan 2015 15:07:29 -0500 From: Neil Horman To: Thomas Monjalon Message-ID: <20150114200729.GB28492@hmsreliant.think-freely.org> References: <1419109299-9603-1-git-send-email-nhorman@tuxdriver.com> <1419349913-21674-1-git-send-email-nhorman@tuxdriver.com> <1419349913-21674-4-git-send-email-nhorman@tuxdriver.com> <1848767.uzBxV6LKz1@xps13> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <1848767.uzBxV6LKz1@xps13> User-Agent: Mutt/1.5.23 (2014-03-12) X-Spam-Score: -2.9 (--) X-Spam-Status: No Cc: dev@dpdk.org Subject: Re: [dpdk-dev] [PATCH v3 4/4] docs: Add ABI documentation X-BeenThere: dev@dpdk.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: patches and discussions about DPDK List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 14 Jan 2015 20:07:35 -0000 On Wed, Jan 14, 2015 at 04:59:51PM +0100, Thomas Monjalon wrote: > 2014-12-23 10:51, Neil Horman: > > Adding a document describing rudimentary ABI policy and adding notice space for > > any deprecation announcements > > We had a good discussion about the policy and its impact: > http://thread.gmane.org/gmane.comp.networking.dpdk.devel/8367/focus=8461 > Sadly nobody else discussed it. > I think we should integrate some of the conclusions in this documentation. > I'm certainly open to that. However, I felt like that conversation centered more around the debate for the need for ABI versioning, not the mechanics thereof. Are there specific sections of that conversation that you are looking to incorporate, or specific topics? > > --- /dev/null > > +++ b/doc/abi.txt > > @@ -0,0 +1,17 @@ > > +ABI policy: > > + ABI versions are set at the time of major release labeling, and ABI may > > +change multiple times between the last labeling and the HEAD label of the git > > +tree without warning > > + > > + ABI versions, once released are available until such time as their > > +deprecation has been noted here for at least one major release cycle, after it > > +has been tagged. E.g. the ABI for DPDK 1.8 is shipped, and then the decision to > > +remove it is made during the development of DPDK 1.9. The decision will be > > +recorded here, shipped with the DPDK 1.9 release, and actually removed when DPDK > > +1.10 ships. > > + > > + ABI versions may be deprecated in whole, or in part as needed by a given > > +update. > > + > > +Deprecation Notices: > > + > > You could upgrade your example to 2.0/2.1. > Sure, though I think doing so is rather arbitrary, as its going to be immediately dated as soon as version 2.1 releases. But I can do that if you like when we square up the documentation question above Neil > Thanks > -- > Thomas >