From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from out1-smtp.messagingengine.com (out1-smtp.messagingengine.com [66.111.4.25]) by dpdk.org (Postfix) with ESMTP id A30F21B479 for ; Thu, 31 Jan 2019 18:17:54 +0100 (CET) Received: from compute1.internal (compute1.nyi.internal [10.202.2.41]) by mailout.nyi.internal (Postfix) with ESMTP id 18310218CA; Thu, 31 Jan 2019 12:17:54 -0500 (EST) Received: from mailfrontend1 ([10.202.2.162]) by compute1.internal (MEProxy); Thu, 31 Jan 2019 12:17:54 -0500 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=monjalon.net; h= from:to:cc:subject:date:message-id:in-reply-to:references :mime-version:content-transfer-encoding:content-type; s=mesmtp; bh=+01IaysFClFwBn+qSk5z04mfOS3T8vea/CvbrCCmdKk=; b=Z/oRxIYIMWVZ FjAqZJF8ZKRbDhEn3QBBbnO3SKPNyTAXI/8sFdGlrSAIocXi/pVCjw1KQtvL/Q1N Yk9GAy07HXw0tn6iXIBQ0NdIBXw5whiD+dz/FQbIA4zGbG1CQVUSN0m0kGjIN/aT RgNyYIb0lpCwY7SSe68sEBk42J9CXvI= DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d= messagingengine.com; h=cc:content-transfer-encoding:content-type :date:from:in-reply-to:message-id:mime-version:references :subject:to:x-me-proxy:x-me-proxy:x-me-sender:x-me-sender :x-sasl-enc; s=fm1; bh=+01IaysFClFwBn+qSk5z04mfOS3T8vea/CvbrCCmd Kk=; b=F4KUg/isSCM8HuTQ1K/uQxLJghY9HYSR0Un8HMUOu94L+aPLLyrpHxodc 7NWNjs9b1z+aAshe+m/GO+SZY3Luu3KddBj7Kb0tDGSFJH5A4mQocGPvDDnywAXC MYXq/2xghNKW0ZWgrINVqi1h2Tn2OyA8T0WZY4FAl/kidf/qlNkTAOWL4RLNHiZe jStBiFacvLJsNhKkf/JyYc91yytb6gsX9wDnArGyPwudowqRHU2G7ya1fyWTQeJK O6pR+suPdSHOr79iuUUcmp8m5LwzIlNnXx7bsahdqCrp6LIQ/OZHH7Qf5eSVwWxq 2KDbSqBQ6RNmXU+jWVWmYaGqIQHVQ== X-ME-Sender: X-ME-Proxy-Cause: gggruggvucftvghtrhhoucdtuddrgedtledrjeeigddutddtucetufdoteggodetrfdotf fvucfrrhhofhhilhgvmecuhfgrshhtofgrihhlpdfquhhtnecuuegrihhlohhuthemucef tddtnecusecvtfgvtghiphhivghnthhsucdlqddutddtmdenucfjughrpefhvffufffkjg hfggfgtgesthfuredttddtvdenucfhrhhomhepvfhhohhmrghsucfoohhnjhgrlhhonhcu oehthhhomhgrshesmhhonhhjrghlohhnrdhnvghtqeenucfkphepjeejrddufeegrddvtd efrddukeegnecurfgrrhgrmhepmhgrihhlfhhrohhmpehthhhomhgrshesmhhonhhjrghl ohhnrdhnvghtnecuvehluhhsthgvrhfuihiivgeptd X-ME-Proxy: Received: from xps.localnet (184.203.134.77.rev.sfr.net [77.134.203.184]) by mail.messagingengine.com (Postfix) with ESMTPA id 043C0E412B; Thu, 31 Jan 2019 12:17:51 -0500 (EST) From: Thomas Monjalon To: Ferruh Yigit Cc: dev@dpdk.org, John McNamara , Marko Kovacevic , Luca Boccassi , Kevin Traynor , Yongseok Koh , Neil Horman Date: Thu, 31 Jan 2019 18:17:50 +0100 Message-ID: <3155698.1yX0fgTuye@xps> In-Reply-To: <20190124181019.17168-3-ferruh.yigit@intel.com> References: <20190122162310.53613-1-ferruh.yigit@intel.com> <20190124181019.17168-1-ferruh.yigit@intel.com> <20190124181019.17168-3-ferruh.yigit@intel.com> MIME-Version: 1.0 Content-Transfer-Encoding: 7Bit Content-Type: text/plain; charset="us-ascii" Subject: Re: [dpdk-dev] [PATCH v4 3/3] doc: add deprecation marker usage X-BeenThere: dev@dpdk.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: DPDK patches and discussions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 31 Jan 2019 17:17:54 -0000 24/01/2019 19:10, Ferruh Yigit: > 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 [...] > +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 removed completely just after the next LTS. APIs removed -> APIs are removed > + > +Reminder that new API should follow deprecation process to be able to replace old API. This last sentence is not clear to me. I think you mean the old API should follow deprecation process to be removed (replaced).