From mboxrd@z Thu Jan 1 00:00:00 1970 From: Ferruh Yigit Subject: [RFC 2/2] doc: add deprecation marker usage Date: Wed, 19 Dec 2018 12:52:53 +0000 Message-ID: <20181219125253.77398-2-ferruh.yigit@intel.com> References: <20181219125253.77398-1-ferruh.yigit@intel.com> Cc: Ferruh Yigit , Luca Boccassi , Kevin Traynor , Yongseok Koh , Neil Horman To: dev@dpdk.org, John McNamara , Marko Kovacevic Return-path: Received: from mga05.intel.com (mga05.intel.com [192.55.52.43]) by dpdk.org (Postfix) with ESMTP id 371A71B92F for ; Wed, 19 Dec 2018 13:53:04 +0100 (CET) In-Reply-To: <20181219125253.77398-1-ferruh.yigit@intel.com> List-Id: DPDK patches and discussions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: dev-bounces@dpdk.org Sender: "dev" Define '__rte_deprecated' usage process. Suggests keeping old API with '__rte_deprecated' marker until next LTS. Signed-off-by: Ferruh Yigit --- Cc: Luca Boccassi Cc: Kevin Traynor Cc: Yongseok Koh Cc: Neil Horman --- 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 19af56cd2..e0edd2e20 100644 --- a/doc/guides/contributing/versioning.rst +++ b/doc/guides/contributing/versioning.rst @@ -128,6 +128,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 new API becomes +active old one marked with ``__rte_deprecated`` until next LTS. In next LTS API +removed completely. + +Reminder that new API should follow deprecation process to become active. + Experimental APIs ----------------- -- 2.17.2