[V3] doc: announce the pipeline legacy API deprecation
Checks
Commit Message
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(+)
Comments
-----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>
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>
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
>
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>
-----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>
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.
@@ -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.