On 10/27/21 4:34 AM, Russell King (Oracle) wrote:

On Wed, Oct 27, 2021 at 10:07:21PM +1100, Stephen Rothwell wrote:

quoted

Hi all,

After merging the net-next tree, today's linux-next build (htmldocs)
produced this warning:

include/linux/phylink.h:82: warning: Function parameter or member 'DECLARE_PHY_INTERFACE_MASK(supported_interfaces' not described in 'phylink_config'

Introduced by commit

   38c310eb46f5 ("net: phylink: add MAC phy_interface_t bitmap")

Or maybe this is a problem with the tool ...

Hmm. Looks like it is a tooling problem.

  * @supported_interfaces: bitmap describing which PHY_INTERFACE_MODE_xxx
  *                        are supported by the MAC/PCS.

         DECLARE_PHY_INTERFACE_MASK(supported_interfaces);

I'm guessing the tool doesn't use the preprocessed source. I'm not sure
what the solution to this would be.

I just sent a patch to scripts/kernel-doc to support that macro.

-- 
~Randy