The first two patches just fixed warnings seen while trying to work on PHY documentation.
The following patches then first fix existing warnings in the kerneldoc for the PHY subsystem, and then extend the kernel documentation for the major structures and functions in the PHY subsystem. Andrew Lunn (5): net: netdevice.h: Document proto_down_reason net: netdevice.h: Document xdp_state net: phy: Fixup kernel doc net: phy: Document core PHY structures net: mdio: Add kerneldoc for main data structures and some functions Documentation/networking/kapi.rst | 24 ++ drivers/net/phy/mdio_bus.c | 37 +++ drivers/net/phy/mdio_device.c | 21 ++ drivers/net/phy/phy-core.c | 30 +++ drivers/net/phy/phy.c | 69 ++++- include/linux/mdio.h | 91 ++++++- include/linux/netdevice.h | 3 + include/linux/phy.h | 414 +++++++++++++++++++++--------- 8 files changed, 554 insertions(+), 135 deletions(-) -- 2.28.0
