From mboxrd@z Thu Jan  1 00:00:00 1970
Return-Path: <thomas.monjalon@6wind.com>
Received: from mail-we0-f180.google.com (mail-we0-f180.google.com
 [74.125.82.180]) by dpdk.org (Postfix) with ESMTP id 7E0D75A86
 for <dev@dpdk.org>; Fri, 16 Jan 2015 14:34:48 +0100 (CET)
Received: by mail-we0-f180.google.com with SMTP id w62so20260067wes.11
 for <dev@dpdk.org>; Fri, 16 Jan 2015 05:34:48 -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=Gk1/1BFBvdtPYbzaGXRI2CHPGvkcCY0SF5nTp2NTVQU=;
 b=Jm0sMrQWRQTjwfSb29IhYdlKAcgCdiPinBYg5ZIYwQAjSmNEdsAD/CorDdMTwSGi3l
 Dyyouq7zBRrDCKt6fI9s6EUqTJt7Bo2XpiZPNCP5ivZZcDlxm1BVrXqsddwKaSQiR+UH
 lO/n6uf7ThUf5UAb1+5QEdO2yhDMu4fsoMAmPHO3KuG3RcJJvZ46J8ARU9nPsmSnDtjy
 n6HwX/wASWGHSwSPvPWyKwu5z+mfJm4wyaJKQlIAS6mOqe97ldB7icUXxm/NPYQxH+6I
 EHqRqzQ0aWTHkVNqlEjd/oYlt+QFHzLO3fYJRpHFHHVJ/2Cx88Sy1aiTkUMWOrfs/bv5
 uMiA==
X-Gm-Message-State: ALoCoQn3Cig4rqgy5uvmG1R0jjy1LN4ZLZIP0KFcx7lAVN0a5d3NZqKhA+8BAHmOfgQiHtnhIf1E
X-Received: by 10.181.8.98 with SMTP id dj2mr6132543wid.81.1421415286656;
 Fri, 16 Jan 2015 05:34:46 -0800 (PST)
Received: from xps13.localnet (136-92-190-109.dsl.ovh.fr. [109.190.92.136])
 by mx.google.com with ESMTPSA id ep9sm3065789wid.3.2015.01.16.05.34.45
 (version=TLSv1.2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128);
 Fri, 16 Jan 2015 05:34:45 -0800 (PST)
From: Thomas Monjalon <thomas.monjalon@6wind.com>
To: Neil Horman <nhorman@tuxdriver.com>
Date: Fri, 16 Jan 2015 14:34:22 +0100
Message-ID: <1599100.5nxciXRXZN@xps13>
Organization: 6WIND
User-Agent: KMail/4.14.3 (Linux/3.17.6-1-ARCH; KDE/4.14.3; x86_64; ; )
In-Reply-To: <20150114200729.GB28492@hmsreliant.think-freely.org>
References: <1419109299-9603-1-git-send-email-nhorman@tuxdriver.com>
 <1848767.uzBxV6LKz1@xps13>
 <20150114200729.GB28492@hmsreliant.think-freely.org>
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 <dev.dpdk.org>
List-Unsubscribe: <http://dpdk.org/ml/options/dev>,
 <mailto:dev-request@dpdk.org?subject=unsubscribe>
List-Archive: <http://dpdk.org/ml/archives/dev/>
List-Post: <mailto:dev@dpdk.org>
List-Help: <mailto:dev-request@dpdk.org?subject=help>
List-Subscribe: <http://dpdk.org/ml/listinfo/dev>,
 <mailto:dev-request@dpdk.org?subject=subscribe>
X-List-Received-Date: Fri, 16 Jan 2015 13:34:48 -0000

2015-01-14 15:07, Neil Horman:
> 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?

Yes.
In the point number 2, you suggest to skip ABI compatibility (after a
deprecation schedule) for big changes.
In the point 3, you suggest to add new fields at the end of the structure,
even if it's asthetic, with exceptions if performance impact.

Thank you
-- 
Thomas