[PATCH] doc: announce some raw/ifpga API removal

[Huang, Wei]

Hi David,

> -----Original Message-----
> From: Xu, Rosen <rosen.xu at intel.com>
> Sent: Friday, July 1, 2022 14:16
> To: David Marchand <david.marchand at redhat.com>; dev at dpdk.org; Zhang,
> Tianfei <tianfei.zhang at intel.com>; Huang, Wei <wei.huang at intel.com>
> Cc: Ray Kinsella <mdr at ashroe.eu>
> Subject: RE: [PATCH] doc: announce some raw/ifpga API removal
> 
> Hi  David,
> 
> Got, thank you so much.
> 
> 
> > -----Original Message-----
> > From: David Marchand <david.marchand at redhat.com>
> > Sent: Thursday, June 30, 2022 17:41
> > To: dev at dpdk.org; Xu, Rosen <rosen.xu at intel.com>; Zhang, Tianfei
> > <tianfei.zhang at intel.com>
> > Cc: Ray Kinsella <mdr at ashroe.eu>
> > Subject: [PATCH] doc: announce some raw/ifpga API removal
> >
> > rte_pmd_ifpga_get_pci_bus() documentation is vague and it is unclear
> > what could be done with it.
> > On the other hand, EAL provides a standard API to retrieve a bus
> > object by name.
> >
Agree, this API is used in an external application, I can use rte_get_bus_by_name() to replace it.
I will submit a patch to remove rte_pmd_ifpga_get_pci_bus() after DPDK22.07 is released.

> > Announce removal of this driver specific API for v22.11.
> >
> > Signed-off-by: David Marchand <david.marchand at redhat.com>
> > ---
> > A RFC series of the intended changes is available at:
> >
> https://patches.dpdk.org/project/dpdk/list/?series=23811&state=%2A&arc
> > h
> > ive=both
> >
> > ---
> >  doc/guides/rel_notes/deprecation.rst | 2 ++
> >  1 file changed, 2 insertions(+)
> >
> > diff --git a/doc/guides/rel_notes/deprecation.rst
> > b/doc/guides/rel_notes/deprecation.rst
> > index 4e5b23c53d..64d649777a 100644
> > --- a/doc/guides/rel_notes/deprecation.rst
> > +++ b/doc/guides/rel_notes/deprecation.rst
> > @@ -119,6 +119,8 @@ Deprecation Notices
> >  * metrics: The function ``rte_metrics_init`` will have a non-void return
> >    in order to notify errors instead of calling ``rte_exit``.
> >
> > +* raw/ifgpa: The ``rte_pmd_ifpga_get_pci_bus`` will be removed in 22.11.
> > +
> >  * raw/ioat: The ``ioat`` rawdev driver has been deprecated, since it's
> >    functionality is provided through the new ``dmadev`` infrastructure.
> >    To continue to use hardware previously supported by the ``ioat``
> > rawdev driver,
> > --
> > 2.36.1