2023-12-23 05:06:50

by Randy Dunlap

[permalink] [raw]
Subject: [PATCH] net: phy: linux/phy.h: fix Excess kernel-doc description warning

Remove the @phy_timer: line to prevent the kernel-doc warning:

include/linux/phy.h:768: warning: Excess struct member 'phy_timer' description in 'phy_device'

Signed-off-by: Randy Dunlap <[email protected]>
Cc: Andrew Lunn <[email protected]>
Cc: Heiner Kallweit <[email protected]>
Cc: Russell King <[email protected]>
Cc: [email protected]
---
include/linux/phy.h | 1 -
1 file changed, 1 deletion(-)

diff -- a/include/linux/phy.h b/include/linux/phy.h
--- a/include/linux/phy.h
+++ b/include/linux/phy.h
@@ -569,7 +569,6 @@ struct macsec_ops;
* - Bits [31:24] are reserved for defining generic
* PHY driver behavior.
* @irq: IRQ number of the PHY's interrupt (-1 if none)
- * @phy_timer: The timer for handling the state machine
* @phylink: Pointer to phylink instance for this PHY
* @sfp_bus_attached: Flag indicating whether the SFP bus has been attached
* @sfp_bus: SFP bus attached to this PHY's fiber port


2024-01-02 11:45:24

by Russell King (Oracle)

[permalink] [raw]
Subject: Re: [PATCH] net: phy: linux/phy.h: fix Excess kernel-doc description warning

On Fri, Dec 22, 2023 at 09:06:13PM -0800, Randy Dunlap wrote:
> Remove the @phy_timer: line to prevent the kernel-doc warning:
>
> include/linux/phy.h:768: warning: Excess struct member 'phy_timer' description in 'phy_device'
>
> Signed-off-by: Randy Dunlap <[email protected]>
> Cc: Andrew Lunn <[email protected]>
> Cc: Heiner Kallweit <[email protected]>
> Cc: Russell King <[email protected]>
> Cc: [email protected]
> ---

Reviewed-by: Russell King (Oracle) <[email protected]>

Thanks!

--
RMK's Patch system: https://www.armlinux.org.uk/developer/patches/
FTTP is here! 80Mbps down 10Mbps up. Decent connectivity at last!

2024-01-02 14:20:50

by patchwork-bot+netdevbpf

[permalink] [raw]
Subject: Re: [PATCH] net: phy: linux/phy.h: fix Excess kernel-doc description warning

Hello:

This patch was applied to netdev/net.git (main)
by David S. Miller <[email protected]>:

On Fri, 22 Dec 2023 21:06:13 -0800 you wrote:
> Remove the @phy_timer: line to prevent the kernel-doc warning:
>
> include/linux/phy.h:768: warning: Excess struct member 'phy_timer' description in 'phy_device'
>
> Signed-off-by: Randy Dunlap <[email protected]>
> Cc: Andrew Lunn <[email protected]>
> Cc: Heiner Kallweit <[email protected]>
> Cc: Russell King <[email protected]>
> Cc: [email protected]
>
> [...]

Here is the summary with links:
- net: phy: linux/phy.h: fix Excess kernel-doc description warning
https://git.kernel.org/netdev/net/c/059d37b718d3

You are awesome, thank you!
--
Deet-doot-dot, I am a bot.
https://korg.docs.kernel.org/patchwork/pwbot.html