Define '__rte_deprecated' usage process. Suggests keeping old API with '__rte_deprecated' marker until next LTS.
Signed-off-by: Ferruh Yigit <ferruh.yi...@intel.com> Acked-by: Luca Boccassi <bl...@debian.org> --- Cc: Luca Boccassi <bl...@debian.org> Cc: Kevin Traynor <ktray...@redhat.com> Cc: Yongseok Koh <ys...@mellanox.com> Cc: Neil Horman <nhor...@tuxdriver.com> v2: * Rephrased as commented --- doc/guides/contributing/versioning.rst | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/doc/guides/contributing/versioning.rst b/doc/guides/contributing/versioning.rst index 19af56cd2..360238985 100644 --- a/doc/guides/contributing/versioning.rst +++ b/doc/guides/contributing/versioning.rst @@ -128,6 +128,16 @@ added to the Release Notes: these changes. Binaries using this library built prior to version 2.1 will require updating and recompilation. +New API replacing previous one +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +If a new API proposed functionally replaces an existing one, when the +new API becomes active then the old one is marked with +``__rte_deprecated`` until the next LTS. In the next LTS, the API is +removed completely. + +Reminder that new API should follow deprecation process to become active. + Experimental APIs ----------------- -- 2.17.2