[PATCH] drm/tests: bridge: Document struct fmt_tuple members

[PATCH] drm/tests: bridge: Document struct fmt_tuple members

[Santiago Millán via B4 Relay]

From: Santiago Millán <santimillang@gmail.com>

The kernel-doc comment for struct fmt_tuple does not describe its
in_fmt and out_fmt members, so W=1 builds warn:

  struct member 'in_fmt' not described in 'fmt_tuple'
  struct member 'out_fmt' not described in 'fmt_tuple'

Add descriptions for both members.

Fixes: 082fbc179c01 ("drm/tests: bridge: Add KUnit tests for bridge chain format selection")
Reported-by: kernel test robot <lkp@intel.com>
Closes: https://lore.kernel.org/oe-kbuild-all/202606120201.5E4O2N7N-lkp@intel.com/
Signed-off-by: Santiago Millán <santimillang@gmail.com>
---
 drivers/gpu/drm/tests/drm_bridge_test.c | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/drivers/gpu/drm/tests/drm_bridge_test.c b/drivers/gpu/drm/tests/drm_bridge_test.c
index 15583ade8494..b79d7b8b2d32 100644
--- a/drivers/gpu/drm/tests/drm_bridge_test.c
+++ b/drivers/gpu/drm/tests/drm_bridge_test.c
@@ -123,6 +123,8 @@ static const struct drm_bridge_funcs drm_test_bridge_bus_fmts_funcs = {
 
 /**
  * struct fmt_tuple - a tuple of input/output MEDIA_BUS_FMT_*
+ * @in_fmt: input bus format accepted by the bridge
+ * @out_fmt: output bus format the bridge can produce from @in_fmt
  */
 struct fmt_tuple {
 	u32 in_fmt;

---
base-commit: dfc3c7b84d43e7de918686e5cd7dd49196a5f45e
change-id: 20261014-drm-bridge-test-kdoc-a46e4183b670

Best regards,
--  
Santiago Millán <santimillang@gmail.com>

Re: [PATCH] drm/tests: bridge: Document struct fmt_tuple members

[Nicolas Frattaroli]

On Wednesday, 14 October 2026 12:56:02 Central European Summer Time Santiago Millán via B4 Relay wrote:
> From: Santiago Millán <santimillang@gmail.com>
> 
> The kernel-doc comment for struct fmt_tuple does not describe its
> in_fmt and out_fmt members, so W=1 builds warn:
> 
>   struct member 'in_fmt' not described in 'fmt_tuple'
>   struct member 'out_fmt' not described in 'fmt_tuple'
> 
> Add descriptions for both members.
> 
> Fixes: 082fbc179c01 ("drm/tests: bridge: Add KUnit tests for bridge chain format selection")
> Reported-by: kernel test robot <lkp@intel.com>
> Closes: https://lore.kernel.org/oe-kbuild-all/202606120201.5E4O2N7N-lkp@intel.com/
> Signed-off-by: Santiago Millán <santimillang@gmail.com>
> ---
>  drivers/gpu/drm/tests/drm_bridge_test.c | 2 ++
>  1 file changed, 2 insertions(+)
> 
> diff --git a/drivers/gpu/drm/tests/drm_bridge_test.c b/drivers/gpu/drm/tests/drm_bridge_test.c
> index 15583ade8494..b79d7b8b2d32 100644
> --- a/drivers/gpu/drm/tests/drm_bridge_test.c
> +++ b/drivers/gpu/drm/tests/drm_bridge_test.c
> @@ -123,6 +123,8 @@ static const struct drm_bridge_funcs drm_test_bridge_bus_fmts_funcs = {
>  
>  /**
>   * struct fmt_tuple - a tuple of input/output MEDIA_BUS_FMT_*
> + * @in_fmt: input bus format accepted by the bridge
> + * @out_fmt: output bus format the bridge can produce from @in_fmt
>   */
>  struct fmt_tuple {
>  	u32 in_fmt;
> 
> ---
> base-commit: dfc3c7b84d43e7de918686e5cd7dd49196a5f45e
> change-id: 20261014-drm-bridge-test-kdoc-a46e4183b670
> 
> Best regards,
> --  
> Santiago Millán <santimillang@gmail.com>
> 
> 
> 

Reviewed-by: Nicolas Frattaroli <nicolas.frattaroli@collabora.com>