path: root/doc
diff options
authorFerruh Yigit <>2019-03-01 17:32:50 +0000
committerThomas Monjalon <>2019-03-27 14:28:51 +0100
commit7abe4a24cc3f0ff011599e2783590564fdff59eb (patch)
tree1d99dc5f208cea3a0fe3745a72d069e1dd13b6c3 /doc
parente17e6d31ca66d977a6a212b1c612c9b8f2cc166b (diff)
doc: add deprecation marker usage
Define '__rte_deprecated' usage process. Suggests keeping old API with '__rte_deprecated' marker including next LTS, they will be removed just after the LTS release. Signed-off-by: Ferruh Yigit <> Acked-by: Luca Boccassi <> Acked-by: Neil Horman <> Acked-by: Kevin Traynor <>
Diffstat (limited to 'doc')
1 files changed, 9 insertions, 0 deletions
diff --git a/doc/guides/contributing/versioning.rst b/doc/guides/contributing/versioning.rst
index 74c73c2..988c1f6 100644
--- a/doc/guides/contributing/versioning.rst
+++ b/doc/guides/contributing/versioning.rst
@@ -125,6 +125,15 @@ 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 non-experimental then the old one is marked with ``__rte_deprecated``.
+Deprecated APIs are removed completely just after the next LTS.
+Reminder that old API should follow deprecation process to be removed.
Experimental APIs