* RE: [PATCH V3] doc: announce the pipeline legacy API deprecation
2023-03-09 20:09 ` [PATCH V3] " Cristian Dumitrescu
@ 2023-03-10 6:02 ` Suresh Narayane, Harshad
2023-03-10 7:25 ` Jangra, Yogesh
` (4 subsequent siblings)
5 siblings, 0 replies; 9+ messages in thread
From: Suresh Narayane, Harshad @ 2023-03-10 6:02 UTC (permalink / raw)
To: Dumitrescu, Cristian, dev; +Cc: R, Kamalakannan, Jangra, Yogesh
-----Original Message-----
From: Dumitrescu, Cristian <cristian.dumitrescu@intel.com>
Sent: Friday, March 10, 2023 1:40 AM
To: dev@dpdk.org
Cc: R, Kamalakannan <kamalakannan.r@intel.com>; Jangra, Yogesh <yogesh.jangra@intel.com>; Suresh Narayane, Harshad <harshad.suresh.narayane@intel.com>
Subject: [PATCH V3] doc: announce the pipeline legacy API deprecation
Announce the deprecation of the legacy pipeline, table and port library API and gradual stabilization of the new API.
Signed-off-by: Cristian Dumitrescu <cristian.dumitrescu@intel.com>
---
doc/guides/rel_notes/deprecation.rst | 18 ++++++++++++++++++
1 file changed, 18 insertions(+)
diff --git a/doc/guides/rel_notes/deprecation.rst b/doc/guides/rel_notes/deprecation.rst
index 872847e938..66f2329b9c 100644
--- a/doc/guides/rel_notes/deprecation.rst
+++ b/doc/guides/rel_notes/deprecation.rst
@@ -135,3 +135,21 @@ Deprecation Notices
Its removal has been postponed to let potential users report interest
in maintaining it.
In the absence of such interest, this library will be removed in DPDK 23.11.
+
+* pipeline: The pipeline library legacy API (functions rte_pipeline_*)
+ will be deprecated in DPDK 23.07 release and removed in DPDK 23.11
+ release. The new pipeline library API (functions rte_swx_pipeline_*)
+ will gradually transition from experimental to stable status
+ starting with DPDK 23.07 release.
+
+* table: The table library legacy API (functions rte_table_*) will be
+ deprecated in DPDK 23.07 release and removed in DPDK 23.11 release.
+ The new table library API (functions rte_swx_table_*) will gradually
+ transition from experimental to stable status starting with DPDK
+ 23.07 release.
+
+* port: The port library legacy API (functions rte_port_*) will be
+ deprecated in DPDK 23.07 release and removed in DPDK 23.11 release.
+ The new port library API (functions rte_swx_port_*) will gradually
+ transition from experimental to stable status starting with DPDK
+ 23.07 release.
--
2.34.1
Acked-by: Harshad Narayane <harshad.suresh.narayane@intel.com>
^ permalink raw reply [flat|nested] 9+ messages in thread* RE: [PATCH V3] doc: announce the pipeline legacy API deprecation
2023-03-09 20:09 ` [PATCH V3] " Cristian Dumitrescu
2023-03-10 6:02 ` Suresh Narayane, Harshad
@ 2023-03-10 7:25 ` Jangra, Yogesh
2023-03-10 9:57 ` Bruce Richardson
` (3 subsequent siblings)
5 siblings, 0 replies; 9+ messages in thread
From: Jangra, Yogesh @ 2023-03-10 7:25 UTC (permalink / raw)
To: Dumitrescu, Cristian, dev; +Cc: R, Kamalakannan, Suresh Narayane, Harshad
Thanks & Regards,
Yogesh Jangra
-----Original Message-----
From: Dumitrescu, Cristian <cristian.dumitrescu@intel.com>
Sent: Friday, March 10, 2023 1:40 AM
To: dev@dpdk.org
Cc: R, Kamalakannan <kamalakannan.r@intel.com>; Jangra, Yogesh <yogesh.jangra@intel.com>; Suresh Narayane, Harshad <harshad.suresh.narayane@intel.com>
Subject: [PATCH V3] doc: announce the pipeline legacy API deprecation
Announce the deprecation of the legacy pipeline, table and port library API and gradual stabilization of the new API.
Signed-off-by: Cristian Dumitrescu <cristian.dumitrescu@intel.com>
---
doc/guides/rel_notes/deprecation.rst | 18 ++++++++++++++++++
1 file changed, 18 insertions(+)
diff --git a/doc/guides/rel_notes/deprecation.rst b/doc/guides/rel_notes/deprecation.rst
index 872847e938..66f2329b9c 100644
--- a/doc/guides/rel_notes/deprecation.rst
+++ b/doc/guides/rel_notes/deprecation.rst
@@ -135,3 +135,21 @@ Deprecation Notices
Its removal has been postponed to let potential users report interest
in maintaining it.
In the absence of such interest, this library will be removed in DPDK 23.11.
+
+* pipeline: The pipeline library legacy API (functions rte_pipeline_*)
+ will be deprecated in DPDK 23.07 release and removed in DPDK 23.11
+ release. The new pipeline library API (functions rte_swx_pipeline_*)
+ will gradually transition from experimental to stable status
+ starting with DPDK 23.07 release.
+
+* table: The table library legacy API (functions rte_table_*) will be
+ deprecated in DPDK 23.07 release and removed in DPDK 23.11 release.
+ The new table library API (functions rte_swx_table_*) will gradually
+ transition from experimental to stable status starting with DPDK
+ 23.07 release.
+
+* port: The port library legacy API (functions rte_port_*) will be
+ deprecated in DPDK 23.07 release and removed in DPDK 23.11 release.
+ The new port library API (functions rte_swx_port_*) will gradually
+ transition from experimental to stable status starting with DPDK
+ 23.07 release.
--
2.34.1
Acked-by: Yogesh Jangra <yogesh.jangra@intel.com>
^ permalink raw reply [flat|nested] 9+ messages in thread* Re: [PATCH V3] doc: announce the pipeline legacy API deprecation
2023-03-09 20:09 ` [PATCH V3] " Cristian Dumitrescu
2023-03-10 6:02 ` Suresh Narayane, Harshad
2023-03-10 7:25 ` Jangra, Yogesh
@ 2023-03-10 9:57 ` Bruce Richardson
2023-03-10 9:58 ` Nicolau, Radu
` (2 subsequent siblings)
5 siblings, 0 replies; 9+ messages in thread
From: Bruce Richardson @ 2023-03-10 9:57 UTC (permalink / raw)
To: Cristian Dumitrescu
Cc: dev, kamalakannan.r, yogesh.jangra, harshad.suresh.narayane
On Thu, Mar 09, 2023 at 08:09:49PM +0000, Cristian Dumitrescu wrote:
> Announce the deprecation of the legacy pipeline, table and port
> library API and gradual stabilization of the new API.
>
> Signed-off-by: Cristian Dumitrescu <cristian.dumitrescu@intel.com>
Presumably the marking the new APIs as stable shouldn't need to be
"grandual", as we need stable replacements before deprecating any old
functions. However, since that seems to be covered here:
Acked-by: Bruce Richardson <bruce.richardson@intel.com>
> ---
> doc/guides/rel_notes/deprecation.rst | 18 ++++++++++++++++++
> 1 file changed, 18 insertions(+)
>
> diff --git a/doc/guides/rel_notes/deprecation.rst b/doc/guides/rel_notes/deprecation.rst
> index 872847e938..66f2329b9c 100644
> --- a/doc/guides/rel_notes/deprecation.rst
> +++ b/doc/guides/rel_notes/deprecation.rst
> @@ -135,3 +135,21 @@ Deprecation Notices
> Its removal has been postponed to let potential users report interest
> in maintaining it.
> In the absence of such interest, this library will be removed in DPDK 23.11.
> +
> +* pipeline: The pipeline library legacy API (functions rte_pipeline_*)
> + will be deprecated in DPDK 23.07 release and removed in DPDK 23.11
> + release. The new pipeline library API (functions rte_swx_pipeline_*)
> + will gradually transition from experimental to stable status
> + starting with DPDK 23.07 release.
> +
> +* table: The table library legacy API (functions rte_table_*) will be
> + deprecated in DPDK 23.07 release and removed in DPDK 23.11 release.
> + The new table library API (functions rte_swx_table_*) will gradually
> + transition from experimental to stable status starting with DPDK
> + 23.07 release.
> +
> +* port: The port library legacy API (functions rte_port_*) will be
> + deprecated in DPDK 23.07 release and removed in DPDK 23.11 release.
> + The new port library API (functions rte_swx_port_*) will gradually
> + transition from experimental to stable status starting with DPDK
> + 23.07 release.
> --
> 2.34.1
>
^ permalink raw reply [flat|nested] 9+ messages in thread* Re: [PATCH V3] doc: announce the pipeline legacy API deprecation
2023-03-09 20:09 ` [PATCH V3] " Cristian Dumitrescu
` (2 preceding siblings ...)
2023-03-10 9:57 ` Bruce Richardson
@ 2023-03-10 9:58 ` Nicolau, Radu
2023-03-10 12:19 ` R, Kamalakannan
2023-03-31 13:20 ` Thomas Monjalon
5 siblings, 0 replies; 9+ messages in thread
From: Nicolau, Radu @ 2023-03-10 9:58 UTC (permalink / raw)
To: Cristian Dumitrescu, dev
Cc: kamalakannan.r, yogesh.jangra, harshad.suresh.narayane
On 3/9/2023 8:09 PM, Cristian Dumitrescu wrote:
> Announce the deprecation of the legacy pipeline, table and port
> library API and gradual stabilization of the new API.
>
> Signed-off-by: Cristian Dumitrescu <cristian.dumitrescu@intel.com>
> ---
> doc/guides/rel_notes/deprecation.rst | 18 ++++++++++++++++++
> 1 file changed, 18 insertions(+)
>
> diff --git a/doc/guides/rel_notes/deprecation.rst b/doc/guides/rel_notes/deprecation.rst
> index 872847e938..66f2329b9c 100644
> --- a/doc/guides/rel_notes/deprecation.rst
> +++ b/doc/guides/rel_notes/deprecation.rst
> @@ -135,3 +135,21 @@ Deprecation Notices
> Its removal has been postponed to let potential users report interest
> in maintaining it.
> In the absence of such interest, this library will be removed in DPDK 23.11.
> +
> +* pipeline: The pipeline library legacy API (functions rte_pipeline_*)
> + will be deprecated in DPDK 23.07 release and removed in DPDK 23.11
> + release. The new pipeline library API (functions rte_swx_pipeline_*)
> + will gradually transition from experimental to stable status
> + starting with DPDK 23.07 release.
> +
> +* table: The table library legacy API (functions rte_table_*) will be
> + deprecated in DPDK 23.07 release and removed in DPDK 23.11 release.
> + The new table library API (functions rte_swx_table_*) will gradually
> + transition from experimental to stable status starting with DPDK
> + 23.07 release.
> +
> +* port: The port library legacy API (functions rte_port_*) will be
> + deprecated in DPDK 23.07 release and removed in DPDK 23.11 release.
> + The new port library API (functions rte_swx_port_*) will gradually
> + transition from experimental to stable status starting with DPDK
> + 23.07 release.
Acked-by: Radu Nicolau <radu.nicolau@intel.com>
^ permalink raw reply [flat|nested] 9+ messages in thread* RE: [PATCH V3] doc: announce the pipeline legacy API deprecation
2023-03-09 20:09 ` [PATCH V3] " Cristian Dumitrescu
` (3 preceding siblings ...)
2023-03-10 9:58 ` Nicolau, Radu
@ 2023-03-10 12:19 ` R, Kamalakannan
2023-03-31 13:20 ` Thomas Monjalon
5 siblings, 0 replies; 9+ messages in thread
From: R, Kamalakannan @ 2023-03-10 12:19 UTC (permalink / raw)
To: Dumitrescu, Cristian, dev; +Cc: Jangra, Yogesh, Suresh Narayane, Harshad
-----Original Message-----
From: Dumitrescu, Cristian <cristian.dumitrescu@intel.com>
Sent: Friday, March 10, 2023 1:40 AM
To: dev@dpdk.org
Cc: R, Kamalakannan <kamalakannan.r@intel.com>; Jangra, Yogesh <yogesh.jangra@intel.com>; Suresh Narayane, Harshad <harshad.suresh.narayane@intel.com>
Subject: [PATCH V3] doc: announce the pipeline legacy API deprecation
Announce the deprecation of the legacy pipeline, table and port library API and gradual stabilization of the new API.
Signed-off-by: Cristian Dumitrescu <cristian.dumitrescu@intel.com>
---
doc/guides/rel_notes/deprecation.rst | 18 ++++++++++++++++++
1 file changed, 18 insertions(+)
diff --git a/doc/guides/rel_notes/deprecation.rst b/doc/guides/rel_notes/deprecation.rst
index 872847e938..66f2329b9c 100644
--- a/doc/guides/rel_notes/deprecation.rst
+++ b/doc/guides/rel_notes/deprecation.rst
@@ -135,3 +135,21 @@ Deprecation Notices
Its removal has been postponed to let potential users report interest
in maintaining it.
In the absence of such interest, this library will be removed in DPDK 23.11.
+
+* pipeline: The pipeline library legacy API (functions rte_pipeline_*)
+ will be deprecated in DPDK 23.07 release and removed in DPDK 23.11
+ release. The new pipeline library API (functions rte_swx_pipeline_*)
+ will gradually transition from experimental to stable status
+ starting with DPDK 23.07 release.
+
+* table: The table library legacy API (functions rte_table_*) will be
+ deprecated in DPDK 23.07 release and removed in DPDK 23.11 release.
+ The new table library API (functions rte_swx_table_*) will gradually
+ transition from experimental to stable status starting with DPDK
+ 23.07 release.
+
+* port: The port library legacy API (functions rte_port_*) will be
+ deprecated in DPDK 23.07 release and removed in DPDK 23.11 release.
+ The new port library API (functions rte_swx_port_*) will gradually
+ transition from experimental to stable status starting with DPDK
+ 23.07 release.
--
2.34.1
Acked-by: Kamalakannan R <kamalakannan.r@intel.com>
^ permalink raw reply [flat|nested] 9+ messages in thread* Re: [PATCH V3] doc: announce the pipeline legacy API deprecation
2023-03-09 20:09 ` [PATCH V3] " Cristian Dumitrescu
` (4 preceding siblings ...)
2023-03-10 12:19 ` R, Kamalakannan
@ 2023-03-31 13:20 ` Thomas Monjalon
5 siblings, 0 replies; 9+ messages in thread
From: Thomas Monjalon @ 2023-03-31 13:20 UTC (permalink / raw)
To: Cristian Dumitrescu
Cc: dev, kamalakannan.r, yogesh.jangra, harshad.suresh.narayane,
bruce.richardson
09/03/2023 21:09, Cristian Dumitrescu:
> Announce the deprecation of the legacy pipeline, table and port
> library API and gradual stabilization of the new API.
>
> Signed-off-by: Cristian Dumitrescu <cristian.dumitrescu@intel.com>
We'll discuss the timeline for promoting the new API,
when reviewing the patches.
As Bruce suggest, I anticipate it should be the first thing to do.
Applied, thanks.
^ permalink raw reply [flat|nested] 9+ messages in thread