Re: [PATCH] docs/driver-api: infrastructure: add property.h and fwnode.h

"Danilo Krummrich" <[email protected]> Mon, 27 Jul 2026 22:29:05 +0200
Newsgroups dev.linux.lists.driver-core,org.kernel.vger.linux-doc,org.kernel.vger.linux-kernel
Message-ID <[email protected]>
On Sun Jul 26, 2026 at 11:12 PM CEST, Randy Dunlap wrote:
> @@ -17,6 +17,10 @@ The Basic Device Driver-Model Structures
>  .. kernel-doc:: include/linux/device/driver.h
>     :identifiers: probe_type device_driver
>  
> +.. kernel-doc:: include/linux/property.h
> +
> +.. kernel-doc:: include/linux/fwnode.h

This introduces new warnings, since some fields of  are not documented:

	WARNING: ./include/linux/fwnode.h:185 struct member 'device_dma_supported' not described in 'fwnode_operations'
	WARNING: ./include/linux/fwnode.h:185 struct member 'device_get_dma_attr' not described in 'fwnode_operations'
	WARNING: ./include/linux/fwnode.h:185 struct member 'iomap' not described in 'fwnode_operations'
	WARNING: ./include/linux/fwnode.h:185 struct member 'irq_get' not described in 'fwnode_operations'

I send a patch [1] to fix those; I will pick this one up once it landed.

Thanks,
Danilo

[1] https://lore.kernel.org/driver-core/[email protected]/