From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mail-we0-f178.google.com (mail-we0-f178.google.com [74.125.82.178]) by dpdk.org (Postfix) with ESMTP id EA8965686 for ; Wed, 14 Jan 2015 17:00:15 +0100 (CET) Received: by mail-we0-f178.google.com with SMTP id p10so9581838wes.9 for ; Wed, 14 Jan 2015 08:00:15 -0800 (PST) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20130820; h=x-gm-message-state:from:to:cc:subject:date:message-id:organization :user-agent:in-reply-to:references:mime-version :content-transfer-encoding:content-type; bh=ObuxjQvZB8Sd2ah4qvVWRm6KZSTl01PGrYJJq4VrqOw=; b=VucNSJcFCR7r1FLWCfS8Nbbn/2dhnKqYr+xBt0m3XVTN9z1cO7M1tE+18bsYuA4H9o sfxXjqwFcBff3SOdP48DypaOGh/QXwzBFdcV6MVGhzxDkz0yTCqGwolRgnRB5qawt5mz 1y8MBjyL60oe77SqiKDg9SzFxbl8Off/09S3nWqX4sE8noy9OhP1Dmq5khOxOhF/IcXr acCQ1FQI6C+ripgahXYT0ZoGSmDeRjD5/msqOy5soCZhYAkmGwT+fz/VkoSI54OzgR2B L9ZlGbskrvZWfvhndJ1TkExyIB2HrODAqo3fae9LNHL+rntsGNjNg1KuiLET2pGz9hvK rtFA== X-Gm-Message-State: ALoCoQlW8K48Hi8CNKAjSSsr8ZaLT0P/UM+ItlnIKos6af8TMFIS3dhpD1fiSW2JvtEq9bG5J4kx X-Received: by 10.180.84.134 with SMTP id z6mr52020670wiy.50.1421251214257; Wed, 14 Jan 2015 08:00:14 -0800 (PST) Received: from xps13.localnet (136-92-190-109.dsl.ovh.fr. [109.190.92.136]) by mx.google.com with ESMTPSA id r3sm19193000wic.10.2015.01.14.08.00.13 (version=TLSv1.2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Wed, 14 Jan 2015 08:00:13 -0800 (PST) From: Thomas Monjalon To: Neil Horman Date: Wed, 14 Jan 2015 16:59:51 +0100 Message-ID: <1848767.uzBxV6LKz1@xps13> Organization: 6WIND User-Agent: KMail/4.14.3 (Linux/3.17.6-1-ARCH; KDE/4.14.3; x86_64; ; ) In-Reply-To: <1419349913-21674-4-git-send-email-nhorman@tuxdriver.com> 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> MIME-Version: 1.0 Content-Transfer-Encoding: 7Bit Content-Type: text/plain; charset="us-ascii" 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 16:00:16 -0000 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. > --- /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. Thanks -- Thomas