RE: [Intel-wired-lan] [PATCH net-next v2 1/1] idpf: Fix kernel-doc descriptions to avoid warnings
From: Singh, Krishneil K
Date: Fri Jan 02 2026 - 16:03:09 EST
> -----Original Message-----
> From: Intel-wired-lan <intel-wired-lan-bounces@xxxxxxxxxx> On Behalf Of
> Andy Shevchenko
> Sent: Wednesday, November 26, 2025 11:45 PM
> To: Nguyen, Anthony L <anthony.l.nguyen@xxxxxxxxx>; intel-wired-
> lan@xxxxxxxxxxxxxxxx; netdev@xxxxxxxxxxxxxxx; linux-kernel@xxxxxxxxxxxxxxx
> Cc: Kitszel, Przemyslaw <przemyslaw.kitszel@xxxxxxxxx>; Andrew Lunn
> <andrew+netdev@xxxxxxx>; David S. Miller <davem@xxxxxxxxxxxxx>; Eric
> Dumazet <edumazet@xxxxxxxxxx>; Jakub Kicinski <kuba@xxxxxxxxxx>; Paolo
> Abeni <pabeni@xxxxxxxxxx>; Andy Shevchenko
> <andriy.shevchenko@xxxxxxxxxxxxxxx>; Loktionov, Aleksandr
> <aleksandr.loktionov@xxxxxxxxx>
> Subject: [Intel-wired-lan] [PATCH net-next v2 1/1] idpf: Fix kernel-doc
> descriptions to avoid warnings
>
> In many functions the Return section is missing. Fix kernel-doc
> descriptions to address that and other warnings.
>
> Before the change:
>
> $ scripts/kernel-doc -none -Wreturn
> drivers/net/ethernet/intel/idpf/idpf_txrx.c 2>&1 | wc -l
> 85
>
> Reviewed-by: Przemek Kitszel <przemyslaw.kitszel@xxxxxxxxx>
> Reviewed-by: Aleksandr Loktionov <aleksandr.loktionov@xxxxxxxxx>
> Signed-off-by: Andy Shevchenko <andriy.shevchenko@xxxxxxxxxxxxxxx>
> ---
> v2: collected tags
> drivers/net/ethernet/intel/idpf/idpf_txrx.c | 96 +++++++++++++--------
> 1 file changed, 59 insertions(+), 37 deletions(-)
>
> diff --git a/drivers/net/ethernet/intel/idpf/idpf_txrx.c
> b/drivers/net/ethernet/intel/idpf/idpf_txrx.c
> index 828f7c444d30..28eb34c35d57 100644
> --- a/drivers/net/ethernet/intel/idpf/idpf_txrx.c
> +++ b/drivers/net/ethernet/intel/idpf/idpf_txrx.c
> @@ -19,6 +19,8 @@ LIBETH_SQE_CHECK_PRIV(u32);
Tested-by: Krishneil Singh <krishneil.k.singh@xxxxxxxxx>