Re: [net-next PATCH v6 02/15] net: phy: Introduce fwnode_mdio_find_device()

From: Jakub Kicinski
Date: Thu Feb 18 2021 - 14:43:51 EST


On Thu, 18 Feb 2021 10:56:41 +0530 Calvin Johnson wrote:
> +/**
> + * fwnode_mdio_find_device - Given a fwnode, find the mdio_device
> + * @np: pointer to the mdio_device's fwnode
> + *
> + * If successful, returns a pointer to the mdio_device with the embedded
> + * struct device refcount incremented by one, or NULL on failure.
> + * The caller should call put_device() on the mdio_device after its use
> + */
> +struct mdio_device *fwnode_mdio_find_device(struct fwnode_handle *fwnode)

drivers/net/phy/phy_device.c:2834: warning: Function parameter or member 'fwnode' not described in 'fwnode_mdio_find_device'
drivers/net/phy/phy_device.c:2834: warning: Excess function parameter 'np' description in 'fwnode_mdio_find_device'