[dpdk-dev] [PATCH v2] doc: deprication notice to mark tm spec as experimental

[Jerin Jacob]

On Tue, May 5, 2020 at 2:25 PM Dumitrescu, Cristian
<cristian.dumitrescu at intel.com> wrote:
>
>
>
> > -----Original Message-----
> > From: Nithin Dabilpuram <nithind1988 at gmail.com>
> > Sent: Tuesday, May 5, 2020 9:08 AM
> > To: Yigit, Ferruh <ferruh.yigit at intel.com>; Richardson, Bruce
> > <bruce.richardson at intel.com>; Dumitrescu, Cristian
> > <cristian.dumitrescu at intel.com>; thomas at monjalon.net;
> > bluca at debian.org; Singh, Jasvinder <jasvinder.singh at intel.com>;
> > arybchenko at solarflare.com; Kinsella, Ray <ray.kinsella at intel.com>;
> > nhorman at tuxdriver.com; ktraynor at redhat.com;
> > david.marchand at redhat.com; Mcnamara, John
> > <john.mcnamara at intel.com>; Kovacevic, Marko
> > <marko.kovacevic at intel.com>
> > Cc: dev at dpdk.org; jerinj at marvell.com; kkanas at marvell.com; Nithin
> > Dabilpuram <ndabilpuram at marvell.com>
> > Subject: [PATCH v2] doc: deprication notice to mark tm spec as experimental
> >
> > From: Nithin Dabilpuram <ndabilpuram at 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 at 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
>
> Acked-by: Cristian Dumitrescu <cristian.dumitrescu at intel.com>
Acked-by: Jerin Jacob <jerinj at marvell.com>


>