From mboxrd@z Thu Jan  1 00:00:00 1970
Return-Path: <dev-bounces@dpdk.org>
Received: from dpdk.org (dpdk.org [92.243.14.124])
	by inbox.dpdk.org (Postfix) with ESMTP id 065B9A04AE;
	Tue,  5 May 2020 10:07:55 +0200 (CEST)
Received: from [92.243.14.124] (localhost [127.0.0.1])
	by dpdk.org (Postfix) with ESMTP id CD4161D588;
	Tue,  5 May 2020 10:07:54 +0200 (CEST)
Received: from mail-pl1-f194.google.com (mail-pl1-f194.google.com
 [209.85.214.194]) by dpdk.org (Postfix) with ESMTP id 93A6F1D528
 for <dev@dpdk.org>; Tue,  5 May 2020 10:07:53 +0200 (CEST)
Received: by mail-pl1-f194.google.com with SMTP id z6so496454plk.10
 for <dev@dpdk.org>; Tue, 05 May 2020 01:07:53 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025;
 h=from:to:cc:subject:date:message-id:in-reply-to:references;
 bh=AKW3XFGS2JfTGRnwTMBQUrJ3ZoxEsBdrEiLG39Bkr2U=;
 b=sc5dxb4qC05jLeZF8xNcrAQEZFC7RVeFBYkvZIAtXCzqBkPraIm+TwUosdKnMwygF0
 YujW6B+uSOjTilecPN93vvzCftl0okmuh0vInFvl9H8Obgb7UnHX3MzGaM0tU3nIUe7k
 8tWJoqH0OZ56vDXRkdruAWAYqHDdTXQtpidP+veIGPSp03UCreDreXjDKIhE4QpEg5tP
 AGWaa2cOg4TaSHhdQJY97/jLVAUiHCeNXfVqOGIxZNspevNh3g2RRHUlp+O32z7kYG16
 WX3B4daulhp1fOs8yQnCl8lgmF+juqNWhPiqgi55CxRywcYRxJxQuwnwNcn47DNfTU7P
 mJ1Q==
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
 d=1e100.net; s=20161025;
 h=x-gm-message-state:from:to:cc:subject:date:message-id:in-reply-to
 :references;
 bh=AKW3XFGS2JfTGRnwTMBQUrJ3ZoxEsBdrEiLG39Bkr2U=;
 b=MWCVRevF7l3vN2E6msTwfKHVhtkXzD/D01DInOPnMYYQ+2qP/XkJPbXNrFfZoKttop
 3h7iCmweduGDVNVGl0ZuZM8+0Unc21+9nBduK40kOENfC+ycxwpazfHeEBKgsd2zMqb+
 xcL1OdbghKUlsT1YxDnhXIDw0eBGkLod/1F5yJbnvea60vg578oaDcQZgWw+CGLCgbST
 GO8yZ90heoMsEy2GBniXC6xqmfs5B1913pq7MpAaWj/q4+at5wAhxYWsaNefTZNzfvQh
 H14Opxun/aJi3w72p9j5Q2MJ3qqytpVpqL4MIn4d0Dkidf6cHBxO89Yp5NCRMbYixCyY
 WEsw==
X-Gm-Message-State: AGi0PuaF4d/NTUhUN2kxQZl2QDdXTRGArFwlLJfALaA85Lc6Nw7w3yyK
 NPnMw664RBlAkbj0RMNcalQ=
X-Google-Smtp-Source: APiQypL8M8rDvMiuBRLP1JHK0giE8dlNOgFPQDUD7fO21MAPx14F6sSyYedc7P3x7jQoEHNXOYj8ZA==
X-Received: by 2002:a17:90b:885:: with SMTP id bj5mr1438462pjb.5.1588666072570; 
 Tue, 05 May 2020 01:07:52 -0700 (PDT)
Received: from hyd1588t430.marvell.com ([115.113.156.2])
 by smtp.gmail.com with ESMTPSA id v1sm1276438pfn.212.2020.05.05.01.07.47
 (version=TLS1_2 cipher=ECDHE-ECDSA-AES128-GCM-SHA256 bits=128/128);
 Tue, 05 May 2020 01:07:51 -0700 (PDT)
From: Nithin Dabilpuram <nithind1988@gmail.com>
To: ferruh.yigit@intel.com, bruce.richardson@intel.com,
 cristian.dumitrescu@intel.com, thomas@monjalon.net, bluca@debian.org,
 jasvinder.singh@intel.com, arybchenko@solarflare.com,
 ray.kinsella@intel.com, nhorman@tuxdriver.com, ktraynor@redhat.com,
 david.marchand@redhat.com, John McNamara <john.mcnamara@intel.com>,
 Marko Kovacevic <marko.kovacevic@intel.com>
Cc: dev@dpdk.org, jerinj@marvell.com, kkanas@marvell.com,
 Nithin Dabilpuram <ndabilpuram@marvell.com>
Date: Tue,  5 May 2020 13:37:33 +0530
Message-Id: <20200505080734.30726-1-nithind1988@gmail.com>
X-Mailer: git-send-email 2.8.4
In-Reply-To: <20200501171622.23410-1-nithind1988@gmail.com>
References: <20200501171622.23410-1-nithind1988@gmail.com>
Subject: [dpdk-dev] [PATCH v2] doc: deprication notice to mark tm spec as
	experimental
X-BeenThere: dev@dpdk.org
X-Mailman-Version: 2.1.15
Precedence: list
List-Id: DPDK patches and discussions <dev.dpdk.org>
List-Unsubscribe: <https://mails.dpdk.org/options/dev>,
 <mailto:dev-request@dpdk.org?subject=unsubscribe>
List-Archive: <http://mails.dpdk.org/archives/dev/>
List-Post: <mailto:dev@dpdk.org>
List-Help: <mailto:dev-request@dpdk.org?subject=help>
List-Subscribe: <https://mails.dpdk.org/listinfo/dev>,
 <mailto:dev-request@dpdk.org?subject=subscribe>
Errors-To: dev-bounces@dpdk.org
Sender: "dev" <dev-bounces@dpdk.org>

From: Nithin Dabilpuram <ndabilpuram@marvell.com>

Based on the discussion in mail thread, it is concluded that
all traffic manager API's (rte_tm.h) need to be marked experimental
till few more releases to support further improvements to spec.

https://mails.dpdk.org/archives/dev/2020-April/164970.html

Adding deprication notice for the same in advance.

Signed-off-by: Nithin Dabilpuram <ndabilpuram@marvell.com>
---
 doc/guides/rel_notes/deprecation.rst | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/doc/guides/rel_notes/deprecation.rst b/doc/guides/rel_notes/deprecation.rst
index 1339f54..2c76f36 100644
--- a/doc/guides/rel_notes/deprecation.rst
+++ b/doc/guides/rel_notes/deprecation.rst
@@ -118,3 +118,10 @@ Deprecation Notices
   Python 2 support will be completely removed in 20.11.
   In 20.08, explicit deprecation warnings will be displayed when running
   scripts with Python 2.
+
+* traffic manager: All traffic manager API's in ``rte_tm.h`` were mistakenly made
+  abi stable in the v19.11 release. The TM maintainer and other contributor's have
+  agreed to keep the TM API's as experimental in expectation of additional spec
+  improvements. Therefore, all API's in ``rte_tm.h`` will be marked back as
+  experimental in v20.11 DPDK release. For more details, please see `the thread
+  <https://mails.dpdk.org/archives/dev/2020-April/164970.html>`_.
-- 
2.8.4