[dpdk-dev] [PATCHv4 4/4] ABI: Add some documentation

Thomas Monjalon thomas.monjalon at 6wind.com
Mon Jun 29 17:07:31 CEST 2015


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 at tuxdriver.com>
> CC: john.mcnamara at intel.com
> CC: thomas.monjalon at 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.



More information about the dev mailing list