[dpdk-dev] [PATCHv4 5/5] doc: Add ABI __experimental tag documentation
Thomas Monjalon
thomas at monjalon.net
Sun Jan 21 21:14:39 CET 2018
13/12/2017 16:17, Neil Horman:
> --- a/doc/guides/contributing/versioning.rst
> +++ b/doc/guides/contributing/versioning.rst
> +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.
Thanks for this text.
Bruce already commented about the type "preform".
Ferruh already commented about adding a string in doxygen header.
Ferruh already commented about adding sentences for new API.
I add that it would be the right place to explain the effect of the
attribute, and how it can be disabled at compilation.
More information about the dev
mailing list