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

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

[Randy Dunlap]

Add more driver core header files to infrastructure.rst for
completeness.

Signed-off-by: Randy Dunlap <rdunlap@infradead.org>
---
Cc: Greg Kroah-Hartman <gregkh@linuxfoundation.org>
Cc: "Rafael J. Wysocki" <rafael@kernel.org>
Cc: Danilo Krummrich <dakr@kernel.org>
Cc: driver-core@lists.linux.dev
Cc: Jonathan Corbet <corbet@lwn.net>
Cc: Shuah Khan <skhan@linuxfoundation.org>
Cc: linux-doc@vger.kernel.org

 Documentation/driver-api/infrastructure.rst |    4 ++++
 1 file changed, 4 insertions(+)

--- linux-next-20260722.orig/Documentation/driver-api/infrastructure.rst
+++ linux-next-20260722/Documentation/driver-api/infrastructure.rst
@@ -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
+
 Device Drivers Base
 -------------------
 

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

[Danilo Krummrich]

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/20260727202748.2232253-1-dakr@kernel.org/

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

[Danilo Krummrich]

On Sun, 26 Jul 2026 14:12:00 -0700, Randy Dunlap wrote:
> [PATCH] docs/driver-api: infrastructure: add property.h and fwnode.h

Applied, thanks!

  Branch: driver-core-testing
  Tree:   git://git.kernel.org/pub/scm/linux/kernel/git/driver-core/driver-core.git

[1/1] docs/driver-api: infrastructure: add property.h and fwnode.h
      commit: f6e6e96d16b8

The patch will appear in the next linux-next integration (typically within 24
hours on weekdays).

The patch is in the driver-core-testing branch and will be promoted to
driver-core-next after validation.