[dpdk-dev] [PATCHv4 5/5] doc: Add ABI __experimental tag documentation
Bruce Richardson
bruce.richardson at intel.com
Wed Dec 13 16:32:09 CET 2017
On Wed, Dec 13, 2017 at 10:17:28AM -0500, Neil Horman wrote:
> Document the need to add the __experimental tag to appropriate functions
>
> Signed-off-by: Neil Horman <nhorman at tuxdriver.com>
> CC: Thomas Monjalon <thomas at monjalon.net>
> CC: "Mcnamara, John" <john.mcnamara at intel.com>
> CC: Bruce Richardson <bruce.richardson at intel.com>
> ---
> doc/guides/contributing/versioning.rst | 9 +++++++++
> 1 file changed, 9 insertions(+)
>
> diff --git a/doc/guides/contributing/versioning.rst b/doc/guides/contributing/versioning.rst
> index 400090628..53f56397e 100644
> --- a/doc/guides/contributing/versioning.rst
> +++ b/doc/guides/contributing/versioning.rst
> @@ -50,6 +50,15 @@ those new APIs and start finding issues with them, new DPDK APIs will be
> automatically marked as ``experimental`` to allow for a period of stabilization
> before they become part of a tracked ABI.
>
> +Note that marking an API as experimental is a two step process. To mark an API
> +as experimental, the symbols which are desired to be exported must be placed in
> +an EXPERIMENTAL version block in the corresponding libraries' version map
> +script. Secondly, the corresponding definitions of those exported functions, and
> +their forward declarations (in the development header files), must be marked
> +with the __experimental tag (see rte_compat.h). The DPDK build makefiles
> +preform a check to ensure that the map file and the C code reflect the same
> +list of symbols.
> +
Minor typo s/preform/perform/
> ABI versions, once released, are available until such time as their
> deprecation has been noted in the Release Notes for at least one major release
> cycle. For example consider the case where the ABI for DPDK 2.0 has been
> --
> 2.14.3
>
More information about the dev
mailing list