Re: [PATCH net-next v1 1/1] net: phy: Move callback comments from struct to kernel-doc section

[Andrew Lunn]

> +#if 0 /* For kernel-doc purposes only. */
> +
> +/**
> + * soft_reset - Issue a PHY software reset.
> + * @phydev: The PHY device to reset.
> + *
> + * Returns 0 on success or a negative error code on failure.
> + */
> +int soft_reset(struct phy_device *phydev);

We should probably ask the kdoc maintainers about how to do this, or
if they can extend kdoc for this use case.

	Andrew