From mboxrd@z Thu Jan  1 00:00:00 1970
Return-Path: <thomas.monjalon@6wind.com>
Received: from mail-wi0-f174.google.com (mail-wi0-f174.google.com
 [209.85.212.174]) by dpdk.org (Postfix) with ESMTP id 3D4C6C3F8
 for <dev@dpdk.org>; Mon, 29 Jun 2015 17:08:41 +0200 (CEST)
Received: by wibdq8 with SMTP id dq8so75188189wib.1
 for <dev@dpdk.org>; Mon, 29 Jun 2015 08:08:41 -0700 (PDT)
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=db3B9Gnd1+wrdxbhxxO9ofIG5utUDfNdtGQemdJn/Ns=;
 b=IEXtSUUVJpfhhTQmFo/Eo2EZVVmgnQo5QigofdXH806fO0uzTtd3Xm7A5TlDHW6Kxy
 ERMI9b9scVLaaVWvC1/ID//US0iD+toKJDJrfs9ju0Rb1PjZ0aFAbBG+k9j3q9fuWo1d
 vDtjafGJgAq3hc1XqlZr9ZbEj8WKqct4lhEXltYs6Tbe70jnSHhWTHS/l8CCh5eTki3r
 CGhrDGB5v/G/Ywo3mi2pL3ASNEPeaQ5R4OEI4fXheFCC+LOGGlIMKjkaORbTxSbLKlkL
 nsxCBvPj0Td8DCudEAO7o3kpqr/2zbBXQoX8IxMmJ56i/gcea7s/V186G20CjOoPoiLX
 qiEA==
X-Gm-Message-State: ALoCoQm7u+sLyJldkyGtURb81C9T2Ba6lT4mfsJUesViYFNydmPjlC/iH4Lqm+uCbCqguTd3+eLt
X-Received: by 10.194.71.135 with SMTP id v7mr27808343wju.83.1435590521145;
 Mon, 29 Jun 2015 08:08:41 -0700 (PDT)
Received: from xps13.localnet (136-92-190-109.dsl.ovh.fr. [109.190.92.136])
 by mx.google.com with ESMTPSA id q4sm64438741wja.24.2015.06.29.08.08.39
 (version=TLSv1.2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128);
 Mon, 29 Jun 2015 08:08:39 -0700 (PDT)
From: Thomas Monjalon <thomas.monjalon@6wind.com>
To: Neil Horman <nhorman@tuxdriver.com>
Date: Mon, 29 Jun 2015 17:07:31 +0200
Message-ID: <13295974.B6fKNOXleO@xps13>
Organization: 6WIND
User-Agent: KMail/4.14.8 (Linux/4.0.4-2-ARCH; KDE/4.14.8; x86_64; ; )
In-Reply-To: <1435586380-1673-4-git-send-email-nhorman@tuxdriver.com>
References: <1435088014-18973-1-git-send-email-nhorman@tuxdriver.com>
 <1435586380-1673-1-git-send-email-nhorman@tuxdriver.com>
 <1435586380-1673-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] [PATCHv4 4/4] ABI: Add some 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: Mon, 29 Jun 2015 15:08:41 -0000

2015-06-29 09:59, Neil Horman:
> People have been asking for ways to use the ABI macros, heres some docs to
> clarify their use.  Included is:
> 
> * An overview of what ABI is
> * Details of the ABI deprecation process
> * Details of the versioning macros
> * Examples of their use
> * Details of how to use the ABI validator
> 
> Thanks to John Mcnamara, who duplicated much of this effort at Intel while I was
> working on it.  Much of the introductory material was gathered and cleaned up by
> him
> 
> Signed-off-by: Neil Horman <nhorman@tuxdriver.com>
> CC: john.mcnamara@intel.com
> CC: thomas.monjalon@6wind.com
> 
> Change notes:
> 
> v2)
>      * Fixed RST indentations and spelling errors
>      * Rebased to upstream to fix index.rst conflict
> 
> v3)
>      * Fixed in tact -> intact
>      * Added docs to address static linking
>      * Removed duplicate documentation from release notes
> 
> v4)
>      * Fixed more grammatical errors / etc
>      * removed BASE_SYMBOL from documentation

Series applied with minor fixes, thanks

This doc should help to produce patches with new ABI without breaking
the old one.
For cases where the backward compatibility is impossible to achieve,
a patch amending this doc to suggest a NEXT_ABI option can be discussed.