mbox series

[0/2] baseband: fix drivers API

Message ID 20201002085931.265699-1-maxime.coquelin@redhat.com (mailing list archive)
Headers
Series baseband: fix drivers API |

Message

Maxime Coquelin Oct. 2, 2020, 8:59 a.m. UTC
  The series prefixes drivers APIs with rte_<drv_name>_ in
order to avoid namespace pollution.

These APIs are experimental, so no need to follow the 
deprecation process.

Maxime Coquelin (2):
  baseband/fpga_5gnr_fec: fix API naming
  baseband/fpga_lte_fec: fix API naming

 app/test-bbdev/test_bbdev_perf.c                   | 12 ++++++------
 doc/guides/bbdevs/fpga_5gnr_fec.rst                | 14 +++++++-------
 doc/guides/bbdevs/fpga_lte_fec.rst                 | 14 +++++++-------
 drivers/baseband/fpga_5gnr_fec/rte_fpga_5gnr_fec.c | 10 +++++-----
 .../rte_pmd_bbdev_fpga_5gnr_fec_version.map        |  2 +-
 .../baseband/fpga_5gnr_fec/rte_pmd_fpga_5gnr_fec.h |  6 +++---
 drivers/baseband/fpga_lte_fec/fpga_lte_fec.c       | 10 +++++-----
 drivers/baseband/fpga_lte_fec/fpga_lte_fec.h       |  6 +++---
 .../rte_pmd_bbdev_fpga_lte_fec_version.map         |  2 +-
 9 files changed, 38 insertions(+), 38 deletions(-)
  

Comments

Akhil Goyal Oct. 6, 2020, 7:42 p.m. UTC | #1
> 
> The series prefixes drivers APIs with rte_<drv_name>_ in
> order to avoid namespace pollution.
> 
> These APIs are experimental, so no need to follow the
> deprecation process.
> 
Added Fixes commit in patch description.

Series applied to dpdk-next-crypto

Thanks.
  
Maxime Coquelin Oct. 7, 2020, 8:22 a.m. UTC | #2
Hi Akhil,

Adding Thomas as he pulls your tree.

On 10/6/20 9:42 PM, Akhil Goyal wrote:
> 
>>
>> The series prefixes drivers APIs with rte_<drv_name>_ in
>> order to avoid namespace pollution.
>>
>> These APIs are experimental, so no need to follow the
>> deprecation process.
>>
> Added Fixes commit in patch description.

Thanks for applying it to your tree.

I did not add Fixes tag and Cc'ed stable@dpdk.org on purpose,
because I thought it is was not a good idea to backport API changes,
even if this is experimental it might be annoying for the user.

Thomas, do you confirm?

Thanks,
Maxime
> Series applied to dpdk-next-crypto
> 
> Thanks.
>
  
Thomas Monjalon Oct. 7, 2020, 10:09 a.m. UTC | #3
07/10/2020 10:22, Maxime Coquelin:
> Hi Akhil,
> 
> Adding Thomas as he pulls your tree.
> 
> On 10/6/20 9:42 PM, Akhil Goyal wrote:
> > 
> >>
> >> The series prefixes drivers APIs with rte_<drv_name>_ in
> >> order to avoid namespace pollution.
> >>
> >> These APIs are experimental, so no need to follow the
> >> deprecation process.
> >>
> > Added Fixes commit in patch description.
> 
> Thanks for applying it to your tree.
> 
> I did not add Fixes tag and Cc'ed stable@dpdk.org on purpose,
> because I thought it is was not a good idea to backport API changes,
> even if this is experimental it might be annoying for the user.
> 
> Thomas, do you confirm?

Absolutely: API must not change in a stable branch.

If an API is changed, it must be in the release notes.
But stable branches are not allowed to update such sections
of the release notes.
  
Maxime Coquelin Oct. 7, 2020, 10:12 a.m. UTC | #4
On 10/7/20 12:09 PM, Thomas Monjalon wrote:
> 07/10/2020 10:22, Maxime Coquelin:
>> Hi Akhil,
>>
>> Adding Thomas as he pulls your tree.
>>
>> On 10/6/20 9:42 PM, Akhil Goyal wrote:
>>>
>>>>
>>>> The series prefixes drivers APIs with rte_<drv_name>_ in
>>>> order to avoid namespace pollution.
>>>>
>>>> These APIs are experimental, so no need to follow the
>>>> deprecation process.
>>>>
>>> Added Fixes commit in patch description.
>>
>> Thanks for applying it to your tree.
>>
>> I did not add Fixes tag and Cc'ed stable@dpdk.org on purpose,
>> because I thought it is was not a good idea to backport API changes,
>> even if this is experimental it might be annoying for the user.
>>
>> Thomas, do you confirm?
> 
> Absolutely: API must not change in a stable branch.
> 
> If an API is changed, it must be in the release notes.

Ok, even for experimental APIs? I thought not.

> But stable branches are not allowed to update such sections
> of the release notes.
> 
>
  
Thomas Monjalon Oct. 7, 2020, 10:29 a.m. UTC | #5
07/10/2020 12:12, Maxime Coquelin:
> On 10/7/20 12:09 PM, Thomas Monjalon wrote:
> > 07/10/2020 10:22, Maxime Coquelin:
> >> On 10/6/20 9:42 PM, Akhil Goyal wrote:
> >>>>
> >>>> The series prefixes drivers APIs with rte_<drv_name>_ in
> >>>> order to avoid namespace pollution.
> >>>>
> >>>> These APIs are experimental, so no need to follow the
> >>>> deprecation process.
> >>>>
> >>> Added Fixes commit in patch description.
> >>
> >> Thanks for applying it to your tree.
> >>
> >> I did not add Fixes tag and Cc'ed stable@dpdk.org on purpose,
> >> because I thought it is was not a good idea to backport API changes,
> >> even if this is experimental it might be annoying for the user.
> >>
> >> Thomas, do you confirm?
> > 
> > Absolutely: API must not change in a stable branch.
> > 
> > If an API is changed, it must be in the release notes.
> 
> Ok, even for experimental APIs? I thought not.

Yes, experimental means it can change in the main branch
without prior notice. But it must be noted when it's changed.
  
Maxime Coquelin Oct. 7, 2020, 10:52 a.m. UTC | #6
On 10/7/20 12:29 PM, Thomas Monjalon wrote:
> 07/10/2020 12:12, Maxime Coquelin:
>> On 10/7/20 12:09 PM, Thomas Monjalon wrote:
>>> 07/10/2020 10:22, Maxime Coquelin:
>>>> On 10/6/20 9:42 PM, Akhil Goyal wrote:
>>>>>>
>>>>>> The series prefixes drivers APIs with rte_<drv_name>_ in
>>>>>> order to avoid namespace pollution.
>>>>>>
>>>>>> These APIs are experimental, so no need to follow the
>>>>>> deprecation process.
>>>>>>
>>>>> Added Fixes commit in patch description.
>>>>
>>>> Thanks for applying it to your tree.
>>>>
>>>> I did not add Fixes tag and Cc'ed stable@dpdk.org on purpose,
>>>> because I thought it is was not a good idea to backport API changes,
>>>> even if this is experimental it might be annoying for the user.
>>>>
>>>> Thomas, do you confirm?
>>>
>>> Absolutely: API must not change in a stable branch.
>>>
>>> If an API is changed, it must be in the release notes.
>>
>> Ok, even for experimental APIs? I thought not.
> 
> Yes, experimental means it can change in the main branch
> without prior notice. But it must be noted when it's changed.
> 
> 
> 

Ok, do you want me to send add-on patches that you will squash when
pulling Akhil's branch?
  
Thomas Monjalon Oct. 7, 2020, 11:06 a.m. UTC | #7
07/10/2020 12:52, Maxime Coquelin:
> On 10/7/20 12:29 PM, Thomas Monjalon wrote:
> > 07/10/2020 12:12, Maxime Coquelin:
> >> On 10/7/20 12:09 PM, Thomas Monjalon wrote:
> >>> 07/10/2020 10:22, Maxime Coquelin:
> >>>> On 10/6/20 9:42 PM, Akhil Goyal wrote:
> >>>>>>
> >>>>>> The series prefixes drivers APIs with rte_<drv_name>_ in
> >>>>>> order to avoid namespace pollution.
> >>>>>>
> >>>>>> These APIs are experimental, so no need to follow the
> >>>>>> deprecation process.
> >>>>>>
> >>>>> Added Fixes commit in patch description.
> >>>>
> >>>> Thanks for applying it to your tree.
> >>>>
> >>>> I did not add Fixes tag and Cc'ed stable@dpdk.org on purpose,
> >>>> because I thought it is was not a good idea to backport API changes,
> >>>> even if this is experimental it might be annoying for the user.
> >>>>
> >>>> Thomas, do you confirm?
> >>>
> >>> Absolutely: API must not change in a stable branch.
> >>>
> >>> If an API is changed, it must be in the release notes.
> >>
> >> Ok, even for experimental APIs? I thought not.
> > 
> > Yes, experimental means it can change in the main branch
> > without prior notice. But it must be noted when it's changed.
> 
> Ok, do you want me to send add-on patches that you will squash when
> pulling Akhil's branch?

Yes please
  
Thomas Monjalon Oct. 7, 2020, 11:07 a.m. UTC | #8
07/10/2020 13:06, Thomas Monjalon:
> 07/10/2020 12:52, Maxime Coquelin:
> > On 10/7/20 12:29 PM, Thomas Monjalon wrote:
> > > 07/10/2020 12:12, Maxime Coquelin:
> > >> On 10/7/20 12:09 PM, Thomas Monjalon wrote:
> > >>> 07/10/2020 10:22, Maxime Coquelin:
> > >>>> On 10/6/20 9:42 PM, Akhil Goyal wrote:
> > >>>>>>
> > >>>>>> The series prefixes drivers APIs with rte_<drv_name>_ in
> > >>>>>> order to avoid namespace pollution.
> > >>>>>>
> > >>>>>> These APIs are experimental, so no need to follow the
> > >>>>>> deprecation process.
> > >>>>>>
> > >>>>> Added Fixes commit in patch description.
> > >>>>
> > >>>> Thanks for applying it to your tree.
> > >>>>
> > >>>> I did not add Fixes tag and Cc'ed stable@dpdk.org on purpose,
> > >>>> because I thought it is was not a good idea to backport API changes,
> > >>>> even if this is experimental it might be annoying for the user.
> > >>>>
> > >>>> Thomas, do you confirm?
> > >>>
> > >>> Absolutely: API must not change in a stable branch.
> > >>>
> > >>> If an API is changed, it must be in the release notes.
> > >>
> > >> Ok, even for experimental APIs? I thought not.
> > > 
> > > Yes, experimental means it can change in the main branch
> > > without prior notice. But it must be noted when it's changed.
> > 
> > Ok, do you want me to send add-on patches that you will squash when
> > pulling Akhil's branch?
> 
> Yes please

Better: Akhil can squash in his tree and remove the Cc: stable tag.
  
Maxime Coquelin Oct. 7, 2020, 11:09 a.m. UTC | #9
On 10/7/20 1:06 PM, Thomas Monjalon wrote:
> 07/10/2020 12:52, Maxime Coquelin:
>> On 10/7/20 12:29 PM, Thomas Monjalon wrote:
>>> 07/10/2020 12:12, Maxime Coquelin:
>>>> On 10/7/20 12:09 PM, Thomas Monjalon wrote:
>>>>> 07/10/2020 10:22, Maxime Coquelin:
>>>>>> On 10/6/20 9:42 PM, Akhil Goyal wrote:
>>>>>>>>
>>>>>>>> The series prefixes drivers APIs with rte_<drv_name>_ in
>>>>>>>> order to avoid namespace pollution.
>>>>>>>>
>>>>>>>> These APIs are experimental, so no need to follow the
>>>>>>>> deprecation process.
>>>>>>>>
>>>>>>> Added Fixes commit in patch description.
>>>>>>
>>>>>> Thanks for applying it to your tree.
>>>>>>
>>>>>> I did not add Fixes tag and Cc'ed stable@dpdk.org on purpose,
>>>>>> because I thought it is was not a good idea to backport API changes,
>>>>>> even if this is experimental it might be annoying for the user.
>>>>>>
>>>>>> Thomas, do you confirm?
>>>>>
>>>>> Absolutely: API must not change in a stable branch.
>>>>>
>>>>> If an API is changed, it must be in the release notes.
>>>>
>>>> Ok, even for experimental APIs? I thought not.
>>>
>>> Yes, experimental means it can change in the main branch
>>> without prior notice. But it must be noted when it's changed.
>>
>> Ok, do you want me to send add-on patches that you will squash when
>> pulling Akhil's branch?
> 
> Yes please

OK, will do that later today.

Thanks,
Maxime
  
Akhil Goyal Oct. 7, 2020, 12:05 p.m. UTC | #10
> 07/10/2020 13:06, Thomas Monjalon:
> > 07/10/2020 12:52, Maxime Coquelin:
> > > On 10/7/20 12:29 PM, Thomas Monjalon wrote:
> > > > 07/10/2020 12:12, Maxime Coquelin:
> > > >> On 10/7/20 12:09 PM, Thomas Monjalon wrote:
> > > >>> 07/10/2020 10:22, Maxime Coquelin:
> > > >>>> On 10/6/20 9:42 PM, Akhil Goyal wrote:
> > > >>>>>>
> > > >>>>>> The series prefixes drivers APIs with rte_<drv_name>_ in
> > > >>>>>> order to avoid namespace pollution.
> > > >>>>>>
> > > >>>>>> These APIs are experimental, so no need to follow the
> > > >>>>>> deprecation process.
> > > >>>>>>
> > > >>>>> Added Fixes commit in patch description.
> > > >>>>
> > > >>>> Thanks for applying it to your tree.
> > > >>>>
> > > >>>> I did not add Fixes tag and Cc'ed stable@dpdk.org on purpose,
> > > >>>> because I thought it is was not a good idea to backport API changes,
> > > >>>> even if this is experimental it might be annoying for the user.
> > > >>>>
> > > >>>> Thomas, do you confirm?
> > > >>>
> > > >>> Absolutely: API must not change in a stable branch.
> > > >>>
> > > >>> If an API is changed, it must be in the release notes.
> > > >>
> > > >> Ok, even for experimental APIs? I thought not.
> > > >
> > > > Yes, experimental means it can change in the main branch
> > > > without prior notice. But it must be noted when it's changed.
> > >
> > > Ok, do you want me to send add-on patches that you will squash when
> > > pulling Akhil's branch?
> >
> > Yes please
> 
> Better: Akhil can squash in his tree and remove the Cc: stable tag.

Sure will do that.
  
Maxime Coquelin Oct. 7, 2020, 12:19 p.m. UTC | #11
On 10/7/20 2:05 PM, Akhil Goyal wrote:
>> 07/10/2020 13:06, Thomas Monjalon:
>>> 07/10/2020 12:52, Maxime Coquelin:
>>>> On 10/7/20 12:29 PM, Thomas Monjalon wrote:
>>>>> 07/10/2020 12:12, Maxime Coquelin:
>>>>>> On 10/7/20 12:09 PM, Thomas Monjalon wrote:
>>>>>>> 07/10/2020 10:22, Maxime Coquelin:
>>>>>>>> On 10/6/20 9:42 PM, Akhil Goyal wrote:
>>>>>>>>>>
>>>>>>>>>> The series prefixes drivers APIs with rte_<drv_name>_ in
>>>>>>>>>> order to avoid namespace pollution.
>>>>>>>>>>
>>>>>>>>>> These APIs are experimental, so no need to follow the
>>>>>>>>>> deprecation process.
>>>>>>>>>>
>>>>>>>>> Added Fixes commit in patch description.
>>>>>>>>
>>>>>>>> Thanks for applying it to your tree.
>>>>>>>>
>>>>>>>> I did not add Fixes tag and Cc'ed stable@dpdk.org on purpose,
>>>>>>>> because I thought it is was not a good idea to backport API changes,
>>>>>>>> even if this is experimental it might be annoying for the user.
>>>>>>>>
>>>>>>>> Thomas, do you confirm?
>>>>>>>
>>>>>>> Absolutely: API must not change in a stable branch.
>>>>>>>
>>>>>>> If an API is changed, it must be in the release notes.
>>>>>>
>>>>>> Ok, even for experimental APIs? I thought not.
>>>>>
>>>>> Yes, experimental means it can change in the main branch
>>>>> without prior notice. But it must be noted when it's changed.
>>>>
>>>> Ok, do you want me to send add-on patches that you will squash when
>>>> pulling Akhil's branch?
>>>
>>> Yes please
>>
>> Better: Akhil can squash in his tree and remove the Cc: stable tag.
> 
> Sure will do that.
> 

Thanks Akhil for handling it, I just posted the release note patch.

Maxime