Re: [PATCH net-next] pds_core: Fix some kernel-doc comments

[Brett Creeley]

On 8/20/2023 11:50 PM, patchwork-bot+netdevbpf@xxxxxxxxxx wrote:
> Caution: This message originated from an External Source. Use proper caution when opening attachments, clicking links, or responding.
>
>
> Hello:
>
> This patch was applied to netdev/net-next.git (main)
> by David S. Miller <davem@xxxxxxxxxxxxx>:
>
> On Mon, 21 Aug 2023 09:55:37 +0800 you wrote:
> > Fix some kernel-doc comments to silence the warnings:
> >
> > drivers/net/ethernet/amd/pds_core/auxbus.c:18: warning: Function parameter or member 'pf' not described in 'pds_client_register'
> > drivers/net/ethernet/amd/pds_core/auxbus.c:18: warning: Excess function parameter 'pf_pdev' description in 'pds_client_register'
> > drivers/net/ethernet/amd/pds_core/auxbus.c:58: warning: Function parameter or member 'pf' not described in 'pds_client_unregister'
> > drivers/net/ethernet/amd/pds_core/auxbus.c:58: warning: Excess function parameter 'pf_pdev' description in 'pds_client_unregister'
> >
> > [...]
>
> Here is the summary with links:
>    - [net-next] pds_core: Fix some kernel-doc comments
>      https://git.kernel.org/netdev/net-next/c/cb39c35783f2
>
> You are awesome, thank you!
> --
> Deet-doot-dot, I am a bot.
> https://korg.docs.kernel.org/patchwork/pwbot.html

FYI - there might be some conflicts here as this was already fixed on 
Alex Williamson's vfio next branch. I don't fully understand how all 
things get merged into v6.6, so I just wanted to update here.

On vfio's next branch this was fixed by: 06d220f13b1f ("pds_core: Fix 
function header descriptions"). It also has a pre-requisite patch that 
actually introduced the warning: b021d05e106e ("pds_core: Require 
callers of register/unregister to pass PF drvdata").

Thanks,

Brett