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

Randy Dunlap posted 1 patch 2 years ago
include/linux/phy.h |    1 -
1 file changed, 1 deletion(-)
[PATCH] net: phy: linux/phy.h: fix Excess kernel-doc description warning
Posted by Randy Dunlap 2 years ago
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 <rdunlap@infradead.org>
Cc: Andrew Lunn <andrew@lunn.ch>
Cc: Heiner Kallweit <hkallweit1@gmail.com>
Cc: Russell King <linux@armlinux.org.uk>
Cc: netdev@vger.kernel.org
---
 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
Re: [PATCH] net: phy: linux/phy.h: fix Excess kernel-doc description warning
Posted by Russell King (Oracle) 1 year, 11 months ago
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 <rdunlap@infradead.org>
> Cc: Andrew Lunn <andrew@lunn.ch>
> Cc: Heiner Kallweit <hkallweit1@gmail.com>
> Cc: Russell King <linux@armlinux.org.uk>
> Cc: netdev@vger.kernel.org
> ---

Reviewed-by: Russell King (Oracle) <rmk+kernel@armlinux.org.uk>

Thanks!

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